dsh-agent-todo
329604421/dsh-agent-todo
A multi-project todo board inside DSH: capture notes in a global capsule overlay, group them into projects and mind maps, and export a todo into the composer as a task for the agent. Notes and todos are read and written on the author's hosted service (todo.memorymap.cn) after you sign in; set config.apiBase to point it at your own backend. Its HTTP routes have no DSH access check.
설치
dsh plugin --profile web add github:329604421/dsh-agent-todoREADME
Agent-ToDo，装进 DeepSeek Harness
四个入口。不用离开会话，也不用切窗口
安装：dsh plugin --profile desktop add dsh-agent-todo（desktop 换成你正在用的 profile 名，见「安装」）
Agent-ToDo 是给 FDE（Forward Deployed Engineer，前沿部署工程师）做的多项目工作台：把现场记下的一句话收进闪念胶囊，归到项目、拆成脑图，最后连上下文一起交给 Agent。这个插件把它装进 DeepSeek Harness（下称 DSH）——装好后 DSH 里多出四个入口，每一处都能把一句话、一段想法、一份交付物直接变成待办。
设计前提只有一条：不搬应用，只把能力送到手边。四个入口里后三个都长在会话里，不用切窗口。
想法 → 胶囊 → 待办 → 会话 → 做完 → 回到清单，一圈都不用出 DSH。
社区插件，非 DeepSeek 官方出品，与 DeepSeek AI 无隶属关系。
安装
需要 Node.js 22.19+ 或 24+。
先分清两个「web」，它们不是一回事：
| 概念 | 是什么 | 谁来定 |
|---|---|---|
dsh.client.platform: web | 包声明里的客户端表面类型，DSH 只认字面量 web；桌面应用和 dsh web 命令行版共用这一套浏览器表面 | 插件作者写死，用户不用改 |
--profile <名字> | 安装目标，即 ~/.dsh/profiles/ 下哪个配置子树接收这个插件 | 用户按自己正在用的 profile 填 |
所以命令里的 profile 名要用你当前实际在用的那个，不是照抄声明里的 web。先查一下：
ls ~/.dsh/profiles/ # 已有的 profile，目录名就是可用值
echo $DSH_PROFILE # 在 DSH 的运行环境里看当前 profile
桌面应用通常是 desktop，dsh web 命令行版通常是 web：
# DeepSeek Harness 桌面应用
dsh plugin --profile desktop add dsh-agent-todo
# dsh web 命令行版
dsh plugin --profile web add dsh-agent-todo
源码安装把包名换成仓库地址：
dsh plugin --profile desktop add github:329604421/dsh-agent-todo
⚠️ profile 名别猜：
dsh plugin没有「当前 profile」的概念——不给--profile会直接报required option '--profile <name>' not specified；给一个不存在的名字则会静默新建空 profile 并把插件装进去（stderr 只有一行initialized profile ...）。那个 profile 不会被你正在用的 DSH 启动，表现就是「装上了，界面里却看不见」。装完看一眼~/.dsh/profiles/<名字>/里是否真的出现插件条目。若已装进误建的 profile，清理前先确认该目录里只有这次安装产生的文件、没有会话或工作区数据，再按上表重装。
安装完成后重启 DSH：桌面应用直接 Ctrl+R 刷新，dsh web 命令行版重启该进程。仓库已提交构建产物 client.js，源码安装不需要 prepare 脚本，也不需要用户放开 allowBuilds 构建授权。
分类：工作流与自动化 · 许可证：MIT
四个入口
| # | 位置 | 能做什么 |
|---|---|---|
| 1 | 左侧主菜单 Agent ToDo | 完整五模块工作台，梳理和回顾都在这 |
| 2 | 全局悬浮 logo | 任意会话里点一下，对话区浮出胶囊列表 |
| 3 | 输入框左侧 Agent ToDo | 把未完成待办直接导出成一条任务 |
| 4 | 会话结尾「闪念」 | Agent 刚交付完，顺手记下一步 |
后三个都不离开会话。此外还有全局快捷键 Alt+Space（或 ⌘/Ctrl+Shift+Space）直接打开快速捕获。
扫码加六位码，十秒登录
第一次打开要登录，没有账号密码，三步走完：
- 微信扫一扫，打开 Agent-ToDo 小程序
- 「我的」→「DeepSeek Harness 登录」→「生成验证码」，拿到 6 位数字
- 粘回插件登录弹窗，点「登录」完成
验证码 10 分钟内有效、用一次就作废、最多 5 次尝试，服务端只存 SHA-256 哈希，换取 365 天有效的设备凭证。它是一张临时通行证，不是长期密码。
不想登录也能完整体验：弹窗底部点「先看看演示数据」，未登录状态一切可点，用的是本地演示数据，不写库、不发请求、不调用模型，界面上有明确的「演示数据」提示。
小程序里有的，插件里都有
概览、项目、待办、脑图、我的，五个模块全在，与微信小程序端共用一套数据。登录后看到的就是手机里那份：这周的活跃度、今天创建与完成了多少、每个项目还剩几件事。
| 模块 | 内容 |
|---|---|
| 概览 | 30 周活跃度日历、今日数据、项目待办统计、Agent 概况 |
| 项目 | 页内列表 + 详情三块，归档而不删除，四档紧急度汇总 |
| 待办 | 页内列表 + 筛选浮层 + 详情六区块；正文、图片、脑图、关联胶囊一起导出为 Markdown Handoff |
| 脑图 | 六种格式、拖拽改父子、撤销重做、缩放平移、节点语音改字、导出 Markdown |
| 我的 | 个人资料、Agent 概况、Token API、应用提示 |
| 闪念胶囊 | DSH 全局浮层，语音 / 文字 / 图片记录，单条或多条转待办、转脑图，多选整理 |
插件面板只有几百像素宽，PC 端「列表 + 详情」并排放不下，所以项目、待办、脑图三页都改成「一栏内嵌列表 + 主区域详情」。宽度窄了，层级没丢：一个屏幕里同时看得到「有哪些」和「正在看哪一个」。
原生触点还包括助手消息里的「闪念」动作、输入框的待办导出与「增强导出」，以及供 Agent 调用的 agent_todo 工具（18 个 action）。样式跟随 DSH 主题令牌，浅色 / 深色都可用，不引入 iframe、不复刻小程序 runtime、不打包第二份 React。
贴着会话的三件事
胶囊，浮在所有会话上
在小程序里，胶囊是应用内的一个功能，得先进去才能记；在 DSH 里它是全局的。任意会话点一下悬浮的黄色 logo，胶囊列表就在对话区浮出来，文字 / 语音 / 图片都能记。不用判断「这条值不值得记」，先扔进去，整理是之后的事。
输入框里，一键把待办交给 Agent
点输入框左侧的「Agent ToDo」弹出导出框，默认按当前会话所在的项目筛选，没有匹配就不硬塞，也能一键看全部。只列未完成，每条两颗按钮：
- 导出：标题和关联闪念整理成文本，直接落到输入框
- 增强导出：先调用后端
/ai/enhance让模型把这条待办整理成更完整的任务描述，再写入输入框
左下角还有「导出同时完成」开关。点发送，就是一条任务交给 Agent，同时清单里这条待办变成已完成。
会话结尾，记下一条
工具条上的「闪念」长在 Agent 刚交付完附件的位置，点开时输入框已经预填了交付物的文件名。一个会话把方案聊定、产出交接文档，再新开几个会话分头实现——胶囊里带着文件名，新会话就知道下一步干什么、依据在哪。上下文太长会掉信息，上下文断掉更贵。
数据与凭证
⚠️ 数据去向：默认后端是作者托管的正式服务 https://todo.memorymap.cn/api/v1，登录后所有读写都发生在那里。想接自己的后端，在 profile 的 bundle 配置里给 agent-todo 条目设置 config.apiBase（见 cordis.patch.yml 的 config 段），插件 Host 会把 /agent-todo/api/* 转发到该地址。请勿把生产凭证提交到任何仓库。
设备凭证只写在本机 ~/.dsh/agent-todo/auth.json（best effort 0600），由插件 Host 半的代理使用，不写日志，随时可「退出登录」清除。
「增强导出」会把待办标题、正文与关联闪念发给上述后端的 /ai/enhance；普通「导出」不调用模型。未登录演示态两者都不发请求。
同源的产品界面
下面是 Agent-ToDo 小程序 / PC 端界面，与插件共用同一套组件规范和设计令牌：
权限与外部服务
| 类别 | 说明 |
|---|---|
| 网络 | 仅访问 apiBase 下由插件发起的业务接口（含 /ai/enhance、/asr、/files）；未登录时零请求，所有写操作都在用户输入或点击后发生 |
| 模型调用 | 仅「增强导出」触发，走后端 /ai/enhance；语音识别优先用 DSH 自带的 ctx.remote.speech，未就绪才降级到后端 POST /asr |
| 麦克风 | 语音胶囊用 getUserMedia + MediaRecorder 采集，重采样为 16 kHz / 单声道 / PCM16 WAV |
| 本机文件 | 只写 ~/.dsh/agent-todo/auth.json 一个凭证文件 |
| 宿主能力 | 注册 /agent-todo/* Web 路由、5 类槽位 occupant、一个 agent_todo 工具；卸载时全部注销 |
| 不做的 | 不读工作区文件、不上报使用数据、不写日志、不注入宿主 head |
麦克风权限由 DSH 主进程放行，被拒绝时只给明确文案，不写库。
兼容与已知限制
- 目标为 DSH 的浏览器客户端表面，包声明
dsh.client.platform: web（DSH 只认字面量web，桌面应用与dsh web命令行版共用）；使用宿主提供的 React 18，无第三方运行时依赖；engines.node要求>=22.19 - 未锁定
engines.dsh版本范围：作者本机 DSH 桌面版已加载验证，但还没有跨版本兼容矩阵，写死范围反而可能让启动时被误拒绝 - 真实 DSH GUI 的全量视觉复验（样式标准 §9 共 21 条）尚未完成；语音链路也还未做真机验收
- 判据脚本里的跨端审计会对照主仓库的小程序源码，独立 clone 本仓库后跑
npm run check需要同时具备329604421/agent-todo的工作区结构；node --check与 smoke 判据不依赖它
开发
npm run build # 由 src/client/*.js 生成 client.js
npm run check # 语法 + smoke + 包级 / 桌面 / 样式一致性判据
npm run verify # 只跑包级判据
client.js 是构建产物，请勿手工编辑；唯一真源是 src/client/ 下按文件名顺序拼接的 18 个零依赖模块。模块全部手写 React.createElement，没有 JSX、没有 import/export，index.js 导出 apply(ctx, config) 并注册 Host 半的代理、静态资源与工具。
关联
- npm 包：https://www.npmjs.com/package/dsh-agent-todo
- 插件仓库：https://github.com/329604421/dsh-agent-todo
- 主仓库（小程序 + 后端）：https://github.com/329604421/agent-todo
- 官网：https://todo.memorymap.cn
- 社区插件目录：https://dsh-plugin.org
许可证
MIT © 2026 杜春生。详见 LICENSE。