yangkghjh/dsh-plugin-dida365

dsh-plugin-dida365

滴答清单 (DIDA365 / TickTick) 插件，用于 DeepSeek Harness (DSH)：

- 在设置中配置鉴权 — 在「设置 → 插件 → 插件配置」中填入滴答清单 API 口令（Bearer Token，以 dp_ 开头，可在滴答清单网页版「头像 → 设置 → 账户与安全 → API 口令」创建）。Token 声明为 secret，仅保存在本机 ~/.dsh/settings.yaml，任何 wire 层都不会回传。
- 每个工作区绑定一个清单 — 在同一设置卡片中，每个工作区一行，从滴答清单清单下拉选择（含 Inbox），可随时解绑。绑定关系持久化在 $DSH_HOME/plugin-data/dida365/bindings.json。
- 绑定后 @ 清单内任务 — 在绑定工作区的会话中，输入 @ 即列出该清单的未完成任务（支持标题过滤），点选后 draft 显示 @任务标题；提交时序列化为模型可见的  引用。
- agent 用 MCP 操作任务 — 插件直连滴答清单官方 MCP 服务（Streamable HTTP + Bearer 鉴权），把服务器全部工具注册为 mcp__dida365__（创建/完成/更新/移动/评论/搜索/清单管理等 50 个）；另有桥接工具 dida365_bound_list 让 agent 随时查看当前会话工作区绑定的清单与未完成任务。

安装

dsh plugin --profile web add dsh-plugin-dida365 && dsh web

这是 DSH（DeepSeek Harness）插件，不要用 npm i 直接安装；必须通过 dsh plugin 安装才会在 profile 中生效。重启后浏览器刷新页面即可。

从本仓库开发安装

dsh plugin --profile web add /path/to/dsh-plugin-dida365   # pnpm link 模式
或先打包再安装：
npm pack && dsh plugin --profile web add dsh-plugin-dida365-0.1.0.tgz

使用

1. 打开「设置 → 插件 → 插件配置」，在「鉴权」输入 API 口令并保存，状态显示「已连接滴答清单 MCP」。
2. 为当前工作区选择要绑定的清单（如 Inbox 或任意清单），点保存。
3. 在该工作区的会话输入框输入 @：出现「滴答清单任务」候选菜单；输入关键字可过滤。选择任务后继续聊天即可。
4. 让 agent 操作任务，例如：「把这个任务标记为完成」「给 @任务 加一条备注」——agent 会通过 mcp__dida365__ 完成操作。

架构

| 层 | 文件 | 说明 |
|---|---|---|
| 宿主 | src/server.js → lib/index.js（esbuild 全量打包，仅 external node:） | settings 命名空间 dida365（apiToken/apiBase）、MCP 连接管理（断线重连、工具注册 mcp__dida365__）、绑定存储、/dida365/ 路由（status / workspaces / projects / bind / tasks）、桥接工具 dida365_bound_list、系统提示上下文 dida365 |
| 浏览器 | src/client-main.js → lib/client.js（ModuleLoader bundle，react external） | settings.plugin.item 设置卡片（key dida365）、@ 触发源（ctx.inputTriggers.registerSource）、引用 codec（提交时序列化 ） |
| 纯函数 | src/parse.js | MCP 服务器「拼接式 JSON」解析器、提及候选裁剪（服务端与测试共用） |

/dida365/ 路由（guarded + same-origin）

- GET /status — 配置/连接状态（含 toolsRegistered，永不含 token）
- GET /workspaces — 工作区列表 + 每工作区绑定
- GET /projects — 滴答清单清单列表（未归档优先，含 Inbox）
- POST /bind / DELETE /bind?workspaceId= — 绑定/解绑
- POST /tasks — 提及候选：{sessionId, query} → 绑定清单未完成任务（30s 缓存，标题过滤，最多 50 条）

测试

DIDA_TOKEN= node tests/server.test.mjs

单元测试（解析器/候选裁剪）+ 线上冒烟（工具清单、未完成任务解析、创建→完成→删除闭环，自清理）。

License

MIT