前言¶
在 DeepSeek Harness(DSH)里,会话往往分散在工作区树的不同分组下。想回到「刚才改过的那个任务」,通常要在左侧列表里逐级展开、滚动查找。社区插件 dsh-recent-tasks(维护者 fishcg)在侧边栏工作区上方增加一个可折叠的 最近任务 区域,按最近更新时间列出常用会话,并支持置顶、行内菜单与设置项,减少在树里翻找的成本。
这是什么¶
dsh-recent-tasks 是 DSH 的客户端插件:在侧边栏内容列顶部(紧贴「工作区」上方)渲染一个默认收起的文件夹,展示最近触碰过的任务,单击即可切换会话。包名为 @fishcg/dsh-recent-tasks,当前 README 附带 package.json 中版本为 1.0.0,许可证 MIT。源码与说明见 GitHub 仓库,社区目录页为 skillhub.cn/plugins/fishcg/dsh-recent-tasks(独立社区站点,与 DeepSeek / 幻方无官方从属关系)。
核心功能¶
下面介绍 README 中已列出的能力,均可在安装后于桌面客户端验证。
位置与展示¶
- 文件夹位于工作区区域最上方,默认折叠,右侧有 live 数量徽标;展开时与展开工作区目录行为一致,下方树形内容顺势下移。
- 列表按最近更新时间从新到旧,只显示前 N 条(N 可在 1–100 之间配置,默认 5)。空会话、已归档会话、子智能体会话会被过滤。
置顶¶
可将常开会话置顶;置顶行固定在列表顶部,不参与时间排序。置顶数据保存在本机浏览器配置中(localStorage 键 dsh.recent-tasks.pins.v1),重启应用后仍保留。
行菜单¶
悬停某行会出现 ⋯ 按钮,也可右键同一行打开菜单:
| 菜单项 | 作用 |
|---|---|
| 置顶 / 取消置顶 | 固定或取消固定该任务 |
| 重命名 | 行内编辑,Enter 提交,Esc 取消 |
| 复制会话 ID | 复制 session id |
| 在新会话里接着聊 | 分叉会话并切换到分叉 |
| 归档 | 归档会话;可在 设置 → 归档会话 中恢复 |
按 Esc、点击菜单外区域可关闭;从 ⋯ 打开时,指针离开菜单也会关闭。
运行状态与点击定位¶
正在运行的任务以琥珀色转圈代替状态点;列表中若有运行中任务,文件夹图标也会旋转(遵循系统 prefers-reduced-motion)。
单击某任务会切换到该会话;默认还会在左侧工作区树中展开所属分组、滚动到该行并高亮。若只需切换主面板、不在树里定位,可在设置中关闭(见下文 reveal)。
设置页¶
路径:设置 → 最近任务(与皮肤、归档会话等并列)。可调整历史任务数量、是否点击时在树中定位,以及恢复默认。
配置项(存于 localStorage 键 dsh.recent-tasks.settings.v1):
| Key | 默认值 | 含义 |
|---|---|---|
limit |
5 |
列表显示的任务数(1–100) |
reveal |
true |
点击任务时是否在工作区树中展开并滚动定位 |
界面样式仅使用 --dsw-alias-* 主题变量与应用蓝色 #7aaaff,随浅色/深色及自定义皮肤变化;中英文随应用语言切换。
安装与启用¶
插件以 DSH 客户端模块形式加载,安装命令以 README 原文为准:
dsh plugin --profile desktop add github:fishcg/dsh-recent-tasks
安装后在应用窗口重新加载(macOS 上为 Cmd+R)。成功后「最近任务」文件夹出现在「工作区」上方,并在 设置 → 插件 中显示插件图标、标题与描述。
卸载:
dsh plugin --profile desktop remove @fishcg/dsh-recent-tasks
典型用法¶
- 安装并重载窗口后,展开侧边栏顶部的 最近任务,从列表点选会话即可回到该任务。
- 对需要长期保留的会话,用行菜单 置顶,使其始终排在列表最前。
- 需要改标题时,在行菜单选 重命名,行内编辑后按
Enter保存。 - 想基于当前会话开新分支时,选 在新会话里接着聊;临时清理列表可用 归档,之后到 设置 → 归档会话 恢复。
- 若列表太短或太长,打开 设置 → 最近任务,将数量调到合适区间(1–100);若不需要树内高亮滚动,关闭「点击定位」相关选项(对应
reveal: false)。
适用场景与注意¶
适合:在同一 DSH 桌面配置下频繁切换多个会话的开发者或智能体使用者,希望用「最近更新 + 置顶」代替在工作区树里反复滚动。
注意:
- 插件属于 DSH 客户端扩展,在与你当前 DSH 进程相同的权限与环境中运行;安装前建议浏览 源码仓库 与 MIT 许可证,确认符合你的安全与合规要求。
- 实现上不直接改写官方工作区浏览器 DOM,而是通过官方 slot 注入并在侧边栏内容列顶部用 Portal 挂载 UI,会话操作走公开客户端服务(如
openSession、forkSession、archiveSession等);行为仍依赖当前 DSH 版本提供的 API 与 UI 布局。 - 置顶与插件设置仅存本机
localStorage,换浏览器配置或清站点数据会丢失,需自行备份习惯或重新置顶。
结尾¶
dsh-recent-tasks 把「最近动过的任务」收到侧边栏顶部一个可折叠文件夹里,配合置顶与行菜单,缩短回到历史会话的路径。进一步了解可访问社区目录 https://www.skillhub.cn/plugins/fishcg/dsh-recent-tasks 与 GitHub https://github.com/fishcg/dsh-recent-tasks。