最近任务夹 fishcg/dsh-recent-tasks

dsh-recent-tasks

中文 · English

在 DeepSeek Harness 侧边栏顶部放一个可折叠的 最近任务 文件夹：最近碰过的任务，点一下就能打开，不用再翻工作区树去找「一小时前那个会话」。

侧边栏里的最近任务文件夹

功能

- 文件夹位于工作区区域顶部。 就在 工作区 正上方，默认折叠，带实时数量徽标。展开后把树往下推，和展开工作区文件夹的效果完全一样。
- 最近的排最前。 显示最近更新的 N 个任务（1–100，默认 5）；空白、已归档和子代理会话会被过滤掉。
- 置顶 / 收藏。 把常回访的任务置顶——置顶行固定在最上面，不受最近顺序影响。置顶按浏览器配置档保存。
- 行菜单。 悬停某一行会出现 ⋯ 按钮，也可以右键点它：

行菜单

| 菜单项 | 作用 |
| 置顶 / 取消置顶 | 置顶或取消置顶该任务 |
| 重命名 | 行内编辑，Enter 提交，Esc 取消 |
| 复制会话 ID | 复制会话 id |
| 在新会话里接着聊 | 分叉会话并切换到分叉 |
| 归档 | 归档会话（可从 Settings → 归档会话 恢复） |

按 Esc、点击外部都会关闭菜单；从 ⋯ 打开时，指针一离开菜单就关闭。
- 运行状态。 运行中的任务用琥珀色转圈代替状态圆点；列表里只要有任务在跑，文件夹图标本身也会转。旋转动画遵循 prefers-reduced-motion。
- 点击定位。 点击任务会切换到它，同时 在工作区树里定位到它：所属分组展开，该行滚动到可见位置并高亮。在设置里关掉后，就只切换主面板。
- 设置页。 Settings → 最近任务（在 皮肤 / 归档会话 旁边）：

设置

历史数量（1–100）、点击定位开关，以及 恢复默认。
- 跟随主题。 只用 --dsw-alias- 主题 token 和应用自带的蓝色（#7aaaff，发送按钮的强调色），所以能跟随浅色/深色和自定义皮肤。中英文界面跟随应用语言。

安装

dsh plugin --profile desktop add github:fishcg/dsh-recent-tasks

然后重载应用窗口（macOS 上按 Cmd+R）。文件夹会出现在 工作区 上方，插件也会带着图标、标题和描述出现在 Settings → 插件 里。

卸载：

dsh plugin --profile desktop remove @fishcg/dsh-recent-tasks

设置

| 键 | 默认值 | 含义 |
| limit | 5 | 文件夹列出多少个任务（1–100） |
| reveal | true | 点击时是否也在工作区树里展开并滚动到该任务 |

设置存在 localStorage 的 dsh.recent-tasks.settings.v1；置顶存在 dsh.recent-tasks.pins.v1。

工作原理

侧边栏的工作区区域是一个单占位槽，归内置的工作区浏览器所有，没有给额外分组留位置。与其覆盖那套 UI（那会弄坏所有接入它的插件），这个插件换了个做法：

1. 在官方 sidebar.footer.action 列表槽里挂一个零视觉的 React 组件，
2. 在侧边栏内容列（[class="_regionArea"]）下创建 div 作为第一个子节点，再用 ReactDOM.createPortal 把文件夹渲染进去 —— 这样文件夹就落在真实的 flex 列里，位于 工作区 上方，展开时内联展开，
3. 从槽的 useSessions 快照读取会话数据，通过公开的客户端服务执行操作（uiWorkspace.openSession / forkSession / archiveSession、sessions.retain(...).rename()）。

除了那个容器，不往别处写 DOM，不引入任何 Harness 客户端包，所有注册都走 ctx.slots.inject(...)，因此能干净地拆除。

Development

纯 JavaScript，没有构建步骤 —— 客户端部分由 DSH 的模块加载器以 ES module 加载。

client.js the whole UI (folder, rows, menu, settings page, CSS, dictionaries)
index.js Host half, intentionally empty: there is nothing to serve
cordis.patch.yml inserts the recent-tasks row into the profile
icon.svg plugin icon (also rendered to assets/icon-180.png)
locale/{zh,en}.json plugin-card title / description
docs/ README screenshots

改完 client.js，在应用里按 Cmd+R 重新加载客户端 bundle。

License

MIT © 2026 fishcg

侧边栏顶部多一个可折叠的 最近任务 文件夹：最近改动过的任务排在最前，点一下就回到那个会话，不用再在工作区列表里翻。

- 位置：紧贴「工作区」上方，默认收起、右侧带数量徽标；展开时和展开一个工作区目录一样，下方内容顺势下移。
- 排序：按更新时间从新到旧，只显示前 N 个（默认 5，可在 1–100 之间调），空会话、已归档、子智能体会话会被过滤掉。
- 置顶：常用会话钉在最上面，不参与时间排序；置顶状态存在本机，重启后仍在。
- 行菜单：鼠标悬停出现 ⋯（右键同样可以），菜单项为 置顶/取消置顶、重命名（行内编辑，Enter 提交 / Esc 取消）、复制会话 ID、在新会话里接着聊（分叉并切换过去）、归档（可在 设置 → 归档会话 里恢复）。
- 运行状态：正在运行的任务用琥珀色转圈代替状态点，文件夹图标在有条目运行时也会转（尊重系统的减少动态效果设置）。
- 点一下就定位：切换会话的同时，在左侧展开它所属的分组、滚动到该行并高亮；不需要的话可以在设置里关掉，关掉后只切主面板。
- 设置：设置 → 最近任务，可调历史任务数量、点任务是否定位到工作区、恢复默认。
- 主题：只用 --dsw-alias-* 主题变量和应用自己的蓝色（#7aaaff），浅色/深色/第三方皮肤都会跟着变；中英文跟随应用语言。

安装：

dsh plugin --profile desktop add github:fishcg/dsh-recent-tasks

然后在窗口里按 Cmd+R 重新加载。卸载：dsh plugin --profile desktop remove @fishcg/dsh-recent-tasks。