dsh-todo
DSH 侧边栏待办插件：零 token 的待办面板（sidebar 入口 + 悬浮面板），数据自动保存到工作区 desktop-todo/data/todos.json，AI 可直接读取用于日报/周报。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-todo@0.1.0Todo 以 dsh-todo 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DSH 侧边栏待办插件：零模型 token 消耗的待办面板。
desktop-todo/data/todos.json（原子写，UTF-8）Browser (client.js) Node (index.mjs)
better-sidebar 待办 Tab ──────┐ /dsh-todo 路由（webServer）
（兜底：header 开关 + 抽屉）──┼─ fetch ─▶ 读写 <workspace>/desktop-todo/data/todos.json
零 token，纯浏览器 ↔ 同源 HTTP RPC workspaceRegistry 解析路径
| 依赖 | 类型 | 说明 |
|---|---|---|
| DeepSeek Harness (DSH) | 运行环境 | 需要 dsh web 可运行；建议 DSH ≥ 0.1.0-rc.7（与 dsh-better-sidebar 的版本要求一致） |
dsh-better-sidebar | 可选（推荐） | 已装 → 待办显示为右侧栏 Tab（registerTab + badge 角标）；未装 → 自动兜底为「右侧抽屉 + 右缘红气泡」，功能不缺失，只是入口形态不同 |
| npm 第三方依赖 | 零 | 仅用 node 内置模块（node:fs / node:path）与 DSH 服务（webServer / workspaceRegistry / slots / betterSidebar）—— 无 npm install 负担，GitHub 源安装 / 拷贝目录即用 |
为什么依赖声明为「可选」：兜底模式保证没有 better-sidebar 的机器（如公司内网）也能完整使用列表 / 抽屉 / 气泡 / 提醒。
Browser (client.js) Node (index.mjs)
├─ better-sidebar Tab「待办」────────┐ ├─ /dsh-todo 路由（GET 读 / POST write 原子写）
├─ shell.overlay 红气泡「✓ n」──────┼─fetch──▶├─ 数据：<workspace>/desktop-todo/data/todos.json
├─ favicon 鲸鱼+红角标 / 标题 🔴n │ └─ 缺文件时自动导入同目录 todo_export.json
└─ 浏览器系统通知（逾期/今日/后台新增）┘ 零 token：浏览器 ↔ 同源 HTTP，不经 LLM
state / setState / subscribe / getSnapshot（多组件共享：open 开关、todos、saving/error）load() / save() / mutate()（fetch /dsh-todo；mutate 整表写回）evaluateReminders()（逾期/今日截止/后台新增；notified 去重、lastNotifiedCount 节流）updateTitle()（🔴n）、updateFavicon()（鲸鱼+红角标 canvas 合成）、better-sidebar badge + updateTab 同步TodoTabView（右侧栏 tab）/ TodoPanel（兜底抽屉）/ TodoBubble（红气泡）/ AddForm / TodoRow（备注默认展开、↑↓ 调序）/ 排序 sortMode（原版/优先级/截止/手动）apply(ctx) —— 先探测 ctx.get("betterSidebar")，有则注册 tab，无则抽屉兜底；slots 为必需注入resolveDataFile()：无 config → workspaceRegistry 首个 workspace + desktop-todo/data/todos.jsonreadTodos()：缺文件自动导入 todo_export.json；兼容裸数组writeJson()：临时文件 + rename 原子写（AI 半路读也不会读到半写文件）node:fs / node:path）client.js（UI）或 index.mjs（数据层）node --check client.js && node --check index.mjsdev_reload_package {"packageName": "dsh-todo"}（或重启 dsh web）git add -A && git commit -m "..." && git push开发坑备忘：本机 better-sidebar 的 loader 条目带
disabled标记（聚合双挂载守卫），但 fiber 实际在跑 —— 注册 tab 前必须用ctx.get("betterSidebar")运行时探测，不能假定它一定存在。
desktop-todo/data/todos.json（相对 DSH 首个 workspace 根目录），结构：
{
"version": 1,
"updatedAt": "2026-08-18T22:40:00.000Z",
"todos": [
{
"id": "t...",
"title": "示例待办",
"note": "",
"priority": 1,
"deadline": "2026-08-24 09:00",
"remind_offset_minutes": null,
"remind_sent": false,
"completed": false,
"completed_at": null,
"created_at": "2026-08-18 22:40:00",
"sort_order": 0
}
]
}
优先级：0=P0（红）1=P1（黄）2=P2（蓝）3=P3（灰）。旧字段名与迁移脚本兼容。
dsh plugin --profile web add dsh-todo
独立插件，零第三方依赖。拷贝 dsh-todo-0.1.0.tgz 到目标机后：
dsh plugin --profile web add ./dsh-todo-0.1.0.tgz # 装完重启 dsh web + 硬刷新浏览器
或手动：解压到 ~/.dsh/profiles/web/node_modules/dsh-todo/，在 profile 的 package.json
里 dependencies 加 "dsh-todo": "file:./node_modules/dsh-todo"、dsh.profile.bundles
加 "dsh-todo"，重启生效。详见 安装说明.md。
dev_install_package {"dir": "<本目录绝对路径>"}（热装配，免重启；重启后由 profile bundles 接管）~/.dsh/profiles/web/node_modules/dsh-todo/ 并在 profile 的 bundles 列表加入 dsh-tododev_reload_package {"packageName": "dsh-todo"}；UI 改动改 client.js 后 reload + 刷新浏览器即可desktop-todo/migrate_to_json.py：旧 SQLite → todo_export.jsontodo_export.json 的 todosMIT