bigfurma-bot/dsh-todos

dsh-todos

一个为 DeepSeek Harness (DSH) 提供的持久化共享待办事项列表，
双方均可写入：

- 所有者 — Web GUI 中的“待办事项”标签页：添加任务、内联修改状态/优先级、
删除。活动任务优先显示，已处理的任务分组并置灰。
- 智能体 — 模型工具 todos_list / todos_add / todos_update /
todos_remove，让你的智能体可以读取并维护同一个列表。

存储是一个 JSON 文件，通过单个进程内写入队列重写；
人工 HTTP 请求和智能体工具调用永远不会发生竞态。重启后依然保留。

DSH Web GUI 中的待办事项标签页

模型

| 字段 | 取值 |
|---|---|
| 状态 | pending · frozen · cancelled · done |
| 优先级 | low · normal · high · urgent （最高 — 以粗体红色显示） |

done 和 cancelled 行会显示删除线；排序规则为状态 → 优先级 → 时间。

安装

cd ~/.dsh/profiles/web
rm -rf node_modules/@deepseek-ai/dsh-todos          # drop any stale copy
pnpm add --force "file:/path/to/this/repo"

将组合行添加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: dsh-todos
name: '@deepseek-ai/dsh-todos'

重启 DSH web。验证：

curl -s http://127.0.0.1:3080/todos        # -> {"ok":true,"tasks":[...]}
curl -sI http://127.0.0.1:3080/plugins/@deepseek-ai/dsh-todos/client.js   # 200

启动顺序说明：宿主端声明了 inject: ['fs','webServer','tools']。
如果你 fork 此项目，请将 webServer 保留在注入列表中，否则你的 HTTP 路由会在启动时
被静默跳过。

配置

| 键 | 默认值 | 含义 |
|---|---|---|
| todosPath | /home//documents/todos.json* | JSON 存储的绝对路径 |
| workspaceRoot | /home//documents* | 用于写入策略作用域的工作区根目录 |

\* host.js 中的默认值是作者的路径 — 请通过你的 profile 组合中插件的 config
为你的机器设置这两个覆盖项。

HTTP API

| 路由 | 请求体 | 用途 |
|---|---|---|
| GET /todos | — | 完整任务列表 + 未完成/总数计数 |
| POST /todos/add | {text, status?, priority?} | 创建 |
| POST /todos/update | {id, text?, status?, priority?} | 修补单个任务 |
| POST /todos/remove | {id} | 删除 |

损坏的存储文件永远不会被覆盖 — 请手动修复或删除它们。

许可证

MIT — 参见 LICENSE。