前言¶

在 DeepSeek Harness（DSH）里做智能体开发，笔记、待办、复习卡片和工作区用量往往散落在对话记录、外部 App 或自建表格里。面板和 Agent 各记各的，很难在同一份数据上协作。dsh-quick-note（界面文案为「管理台」）把条目管理、健康记录、用量/价值分析与 Agent 工具接到 DSH Web GUI 左侧栏，数据以本机 Host 为主、浏览器镜像为辅，同一份 items.json 既能在 GUI 里编辑，也能被 quick_note_* 工具读写。

下面介绍插件定位、核心能力、安装方式与典型用法。事实以 TomJerryGit/dsh-quick-note README 与 package.json 为准。

这是什么¶

dsh-quick-note 是 TomJerryGit 维护的 客户端类 DSH 插件（npm 包名 @tomjerrygit/dsh-quick-note）。它在 DSH Web GUI 左侧栏增加「管理台」入口，提供 local-first 的通用管理界面：概览仪表盘、跨模块表格、笔记/任务/闪卡复习/健康/自定义记录，以及「分析」下的工作区价值、Token 用量与系统信息只读页。

为保证与既有安装和数据兼容，插件 id 仍为 dsh-quick-note，Agent 工具名仍为 quick_note_*，主数据文件路径为 $DSH_HOME/quick-note/items.json。package.json 声明运行环境为 dsh >= 0.2.0-rc.2，许可证 MIT。

核心功能（节选）¶

概览与管理台表格¶

默认进入「概览」：KPI 卡片（任务到期/逾期、待复习、近 7 天复习、健康与自定义记录等）、今日简报、快捷新建、最近更新。「全部」页提供跨类型列表，可按笔记/任务/复习/健康/记录筛选，支持排序、分页与批量完成、改优先级、删除。

v1.11.0 起模块合并为：概览、知识（笔记 + 复习）、计划（列表/看板/日历）、健康、记录、分析；可在「设置 → 管理台设置」中隐藏部分模块。

知识与计划¶

• 笔记：统一条目模型（标题、正文、标签等）。
• 复习：闪卡 SM-2 队列，「忘记/模糊/记得」评分，复习日志写入数据文件 reviews。
• 任务：列表/看板/日历；支持优先级、截止、检查清单与重复任务（v1.3.0）；看板支持拖拽改状态与排序。
• 对话捕获：助手消息操作行的速记图标可把回答存为带「对话」标签的笔记（去重）。

健康与自定义记录¶

健康模块支持指标趋势与用药计划（到点提醒、今日简报摘要）。「记录」页可自建类型与字段（文本/数字/日期/复选/单选），保存筛选为类型内视图（types[].views）。

分析：价值、用量、系统¶

「分析」标签含价值、用量、系统三个子页（选择会持久化）：

• 系统：GET /api/quick-note/admin，展示 Profile、DSH 主目录、已装 Bundles 等（只读）。
• 用量：按工作区统计 Token 与估算金额，支持近 14 天曲线等；单价可在设置中修改。
• 价值：GET /api/quick-note/workspace-value 给出工作区价值分（A/B/C/D）、阶段与未来价值等；支持人工评级、趋势快照、导出 CSV/Markdown、归档为笔记。

数据同步、备份与 Agent 工具¶

改动先写浏览器镜像，再同步 Host；不可达时提示「仅保存在本机浏览器」。Host 写入后可滚动备份至 $DSH_HOME/quick-note/backups/（v1.3.0）。支持导出/导入 JSON（含 types、settings、reviews 等）。

Host 半区提供的 Agent 工具包括（名称前缀均为 quick_note_）：

v1.13.0 起还支持斜杠命令（如 /note、/task、/search、/plan、/review），在对话输入框直接录入或查询。

提醒与对话注入¶

应用内可对今日/逾期任务与用药到点提醒；可在设置中开启「每轮对话注入今日待办简报」，让 Agent 每轮收到任务与用药摘要。

安装与启用¶

README 推荐从 npm 安装。按你使用的 DSH Profile 选择一条命令：

dsh plugin --profile web add @tomjerrygit/dsh-quick-note
# desktop profile
dsh plugin --profile desktop add @tomjerrygit/dsh-quick-note

若使用插件市场索引，可将下列地址加入 DSH Plugins → Discover：

https://tomjerrygit.github.io/dsh-quick-note/index.json

SkillHub 目录页（dsh-quick-note）也提供「请安装 DSH 插件 TomJerryGit/dsh-quick-note」的指引，由 Harness 读取安装计划后执行，与社区站点同属第三方索引，并非 DeepSeek 官方应用商店。

本地开发时，可在插件管理页「安装第三方插件」填写目录路径，或通过 Agent 的 plugin_manager install_bundle；修改 index.js（Host 半区）后通常需热重组装或重启 DSH。

典型用法¶

1. 在 GUI 中日常使用¶

安装并打开 DSH Web GUI 后，从左侧栏进入「管理台」。先在概览查看今日任务与复习，再用「计划」看板拖拽改状态，或用 Ctrl/⌘ K 命令面板跳转与新建（v1.2.0）。

2. 让 Agent 创建任务¶

在对话中依赖 Host 注册的 quick_note_create，传入 kind、title 等字段即可（具体参数以 README「Agent 工具」节为准）。也可用斜杠命令，例如：

/task 修复回归用例 --due 明天 --priority high --tag dsh

3. 查询与批量处理¶

quick_note_search 支持 tag、overdue、dueWithinDays 等过滤（v1.3.0）。多条目变更可用 quick_note_batch。

4. 工作区价值报告¶

在「分析 → 价值」中查看自动评分与用量；需要沉淀时可用 quick_note_workspace 的 report 或 archive，或面板内「导出 Markdown 报告」「归档为笔记」。

5. 备份与迁移¶

设置页可「立即备份」或从 $DSH_HOME/quick-note/backups/ 恢复；也可导出完整 JSON 后在另一台机器导入（乐观锁写入）。

适用场景与注意¶

适合谁：希望在 DSH 内统一管理笔记、任务、复习与健康数据，并让 Agent 与面板共用同一份本地数据的开发者；需要粗粒度 Token/工作区价值视图、又不想把数据放到云端控制台的用户。

权限与安全：插件以当前 DSH 进程权限运行，会读写 $DSH_HOME/quick-note/ 下文件，并对外提供需 token 的 API（如 admin、usage、workspace-value）。安装前建议阅读源码与 MIT 许可证，确认备份与清理策略符合你的环境。

版本认知：npm package.json 中列为 1.0.0，README 持续记录 v1.1.x–v1.44.x 等功能迭代；以你实际安装的包/发布说明为准。GitHub 星标数为 0（截至目录抓取），不代表功能完整度，可结合 README 中的回归测试说明自行评估。

结尾¶

dsh-quick-note 把「侧栏管理台 + Host 数据文件 + Agent 工具」接到一条链路上：人在 GUI 里操作，智能体用同一套 quick_note_* 读写条目与分析工作区。需要安装命令与细节时，以 README「安装、更新与卸载」为准。

• 社区目录：SkillHub - dsh-quick-note
• 源码与文档：GitHub - TomJerryGit/dsh-quick-note