前言¶
在 DSH 里开发或日常使用智能体时，待办往往散落在聊天窗口、记事本或浏览器标签里。要写成「有时间、地点、事项和要求」的结构化条目，通常得自己拆句，或再开一个带独立 API key 的解析服务。 dsh-todo-note（仓库 Ivan-unb/Ivan-nb）把一张贴在 Windows 桌面上的便签卡片和 DSH 宿主侧的模型解析接在一起：粘贴一整段文字、回车，由你已在 Harness 里配置好的模型拆成多条待办，数据落在本机 JSON，不依赖云端账号。下面介绍它是什么、怎么装、怎么用，以及和 DSH 进程之间的协作方式。
这是什么¶
dsh-todo-note 是维护者 Ivan-unb 发布的 DeepSeek Harness 插件（package.json 中版本 0.1.0，许可证 MIT）。定位是：Windows 上的便签式待办应用；解析步骤使用 DSH 中已配置的模型（README 说明只需 agentDefaultModel 能取到即可），无需额外 API key，也不会把文字发往插件作者以外的第三方服务（若你用的是完全本地模型，则拆句也不出本机）。
界面由独立的 PowerShell + WPF 进程承载，与 DSH 主进程无父子关系；插件侧在 DSH 宿主里负责读写在数据目录中的交接文件并调用模型，桌面卡片负责展示与编辑 todos.json。
社区目录页：skillhub.cn/plugins/Ivan-unb/Ivan-nb。DSH 生态强调「一切皆插件」；该目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
界面与核心能力¶
折叠态为宽约 300 像素的桌面卡片，无需点开系统菜单即可使用：
- 顶部输入框：粘贴一整段文字，回车提交；
- 未完成项按时间排序展示，最多 6 条，超出显示「还有 N 条」；
- 左侧勾选表示完成（灰显、划线并沉底），右侧
×删除； - 「要求 · …」与「还有 N 条要求」可展开查看全部要求。
点右上角 ▦ 可展开大面板，提供「列表 / 月历」两种视图；月历中可按日查看或添加安排。提交后会先出现确认条，点保存才写入数据库，拆句有误可在该步取消，避免污染列表。
其他已文档化的能力包括：展开列表中点击标题就地修改；拖标题栏记住位置；右键更换背景配色（carbon / ocean / forest / dusk / paper）；右键导出 JSON。
与 DSH 如何协作¶
卡片与 DSH 通过数据目录中的文件交接，互不改写对方文件，因此无需文件锁：
卡片 ──写 request.json──▶ 数据目录 ◀──读── DSH 宿主（调模型拆句）
卡片 ◀──读 result.json─── 数据目录 ◀──写── DSH 宿主
DSH 未运行时仍可记录待办，但无法拆句：文字会排队，待 DSH 启动后自动补拆。待办本体保存在 todos.json，为普通 JSON，便于其他程序读取。
环境与前提¶
- Windows 10 / 11；
- PowerShell 5.1（系统自带）；
- 已安装 DeepSeek Harness，并配置过可用模型。
插件以当前 dsh 进程权限 运行；安装前建议通读仓库源码并确认 MIT 许可证是否符合你的合规要求。
安装与启用¶
1. 安装插件本体¶
在终端执行（命令来自仓库 README）：
dsh plugin --profile <你的 profile> add git+https://github.com/Ivan-unb/Ivan-nb.git
安装后需 重启 DSH，宿主侧不支持热更新。
2. 安装桌面卡片¶
在仓库根目录执行：
powershell -ExecutionPolicy Bypass -File install.ps1
脚本会注册登录时自动运行的计划任务、在桌面创建快捷方式，并立即启动卡片；重复执行是安全的。README 说明：从其他进程拉起的窗口可能被作业对象绑定，DSH 退出时窗口会被回收，故桌面端由任务计划程序启动，与 DSH 生命周期解耦。
典型用法¶
| 想做什么 | 怎么做 |
|---|---|
| 加一条 | 粘贴一整段，回车；在确认条中勾选要保留的项、改正文字，保存 |
| 做完 | 点左侧勾选框 |
| 删掉 | 点最右侧 × |
| 改标题 | 展开列表后点标题就地编辑，回车或点别处保存 |
| 换位置 | 拖标题栏 |
| 换配色 | 右键 → 背景色 → 选择主题 |
| 导出 | 右键 → 导出为 JSON |
| 看月历 | 展开面板，切换到「月历」，点选日期查看或添加 |
数据目录与隐私¶
默认路径为 %USERPROFILE%\.dsh\todo-note\；若设置了环境变量 DSH_HOME，则为 %DSH_HOME%\todo-note\。
| 文件 | 内容 |
|---|---|
todos.json |
待办本体 |
window.json |
窗口位置、配色 |
request.json / result.json |
卡片与 DSH 之间的交接 |
run.log / diag.log |
排障时优先查看 |
待办仅存本机上述目录；无账号与云端同步。仅用户粘贴的那段文字会送入 DSH 内配置的模型进行拆句。
卸载¶
桌面端：
powershell -ExecutionPolicy Bypass -File uninstall.ps1
脚本会停止卡片、移除计划任务与快捷方式，默认保留数据；脚本末尾会给出彻底删除数据的命令说明。
插件本体：
dsh plugin --profile <profile> remove dsh-todo-note
适用场景与限制¶
适合需要在 Windows 桌面上常驻待办、又希望复用 DSH 已有模型做中文拆句的用户。README 记载的 已知限制 包括：仅支持 Windows（WPF）；主要保证中文识别，中英混排不承诺准确；无提醒/通知；无跨设备同步；DSH 未开启时新粘贴内容需排队等待拆句。
维护者还在 README 中提示修改脚本时的编码问题：.ps1 须带 UTF-8 BOM（PowerShell 5.1 无 BOM 时中文注释可能导致语法错误）；.vbs 中不宜使用中文注释。
结尾¶
dsh-todo-note 把桌面便签与 DSH 模型拆句并用文件目录解耦，在本机完成「一段话 → 多条结构化待办」的闭环。进一步了解可从社区目录 skillhub.cn/plugins/Ivan-unb/Ivan-nb 进入，源码与完整说明见 github.com/Ivan-unb/Ivan-nb。
