前言¶
在 DeepSeek Harness(DSH)里长时间开多个会话时,手头要跟进的事项往往散在笔记、聊天或外部工具里,切回 DSH 界面时不一定立刻看到「下一件该做什么」。常见做法是在浏览器另开 Tab 记待办,或依赖会话外的任务应用,与当前 DSH Web UI 是两套上下文。
下面介绍社区插件 dsh-todo(维护者 OverToWind,分类为客户端):在会话标题栏增加一个待办按钮,背后挂浮动面板;未完成项在按钮上轮播,并按截止时间整钮着色。数据存在浏览器 localStorage,不注册宿主侧服务,适合只想在 DSH 界面内轻量记任务、又不想单独开应用的开发者。
这是什么¶
dsh-todo 是面向 DSH Web UI 的 Cordis bundle 插件:会话 header 里一个按钮,点击后展开浮动面板,用于新增、编辑、勾选和删除待办。简介可概括为:header 轮播未完成项、按紧急度着色、面板常驻可操作。
- 目录页:https://www.skillhub.cn/plugins/OverToWind/dsh-todo
- 源码与说明:https://github.com/OverToWind/dsh-todo
- 许可证:MIT(README 与
package.json一致) package.json中版本为 1.0.0
DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。安装前请自行阅读源码与许可证——插件随当前 DSH 进程 / 浏览器上下文运行,权限与宿主一致。
核心功能¶
以下能力均来自项目 README 与中文说明,可直接对照仓库验证。
标题栏轮播(Header ticker)¶
未完成事项每 4 秒在按钮文案上切换一条;鼠标悬停按钮,或浮动面板打开时,轮播暂停。已完成项不参与轮播。
紧急度着色(Urgency tinting)¶
整颗按钮按截止时间着色:逾期为红,24 小时内为琥珀色,更晚为绿,全部完成时为中性色。面板内每一行使用同一套规则。
常驻面板(Persistent panel)¶
支持新增;编辑文字与截止时间;勾选完成;删除;清除已完成。列表按紧急度排序,已完成项收进 Done (n) /「已完成 n 项」折叠区。
快捷截止时间¶
提供 Today / Tomorrow 快捷 chip:分别为当天 18:00 与次日 09:00;也可用手选 datetime,或不限截止时间。
本地持久化¶
条目保存在 localStorage,键名为 dsh-todo.items.v1,刷新页面后仍保留。
主题与语言¶
颜色仅使用 DSH 的 --dsw-alias-* token,亮暗主题随 DSH。界面文案随宿主 locale 为英文或中文(locale/en.json、locale/zh.json)。
挂载点¶
| 用途 | Slot | id | order |
|---|---|---|---|
| 标题栏按钮 | conversation.session.header.utilities |
dsh-todo:button |
-20 |
| 浮动面板 | shell.overlay |
dsh-todo:panel |
900 |
shell.overlay 默认可穿透点击;面板卡片会显式恢复指针事件,以便交互。
安装与启用¶
官方 README 给出的从 GitHub 安装方式如下(请将 <profile> 换成你的 DSH profile 名):
# from GitHub
dsh plugin --profile <profile> add github:OverToWind/dsh-todo
若已在本地有一份插件目录(非本文要求的 git clone 步骤,仅指你已有路径),可在 DSH 会话内安装 bundle:
plugin_manager action=install_bundle target=<path to a local clone>
安装后需要 重启或刷新 DSH。该插件不注册 host 侧服务,渲染与状态均由 client 半部承担(client.js;index.js 的 host 半部为空)。
典型用法¶
- 按上一节命令为指定 profile 安装插件并刷新 Web UI。
- 在任意会话标题栏 utilities 区域找到 dsh-todo 按钮;观察未完成项轮播与按钮着色。
- 打开面板:添加任务,用 Today / Tomorrow 或 datetime 设截止,或选不限时间。
- 勾选完成、编辑、删除或「清除已完成」;已完成区在折叠段中查看。
- 刷新浏览器,确认
localStorage键dsh-todo.items.v1下数据仍在(开发者工具 → Application → Local Storage)。
维护者在仓库中提供无浏览器校验(stub window / document / localStorage 与最小 React,断言渲染树):
node --check client.js
node scripts/verify-render.mjs # 40 checks
适用场景与注意¶
适合:在 DSH Web UI 内做会话级轻量待办;需要截止时间与视觉优先级提示;希望数据只留在本机浏览器、不依赖后端任务服务。
注意:
- 数据仅存当前浏览器 profile 的
localStorage,换设备或清站点数据会丢失,重要事项请另有备份策略。 - 插件为纯客户端 bundle(
dsh.client.platform:web,immediately: true),依赖@deepseek-ai/dsh-client-ui-conversation注入。 - 安装前请阅读 https://github.com/OverToWind/dsh-todo 源码与 MIT 许可证;勿在未审阅的情况下在生产环境盲目启用第三方插件。
结尾¶
dsh-todo 把待办收进 DSH 会话标题栏:轮播提醒未完成项、按截止着色,并用浮动面板完成增删改查与本地持久化。需要详情与 issue 请访问 GitHub;在 SkillHub 目录页可查看插件元信息与分类(客户端)。