前言¶

在 DSH 里写 Composer 草稿时，常会有一段文字暂时用不上、又舍不得删掉——切到外部笔记应用会打断上下文，留在输入框里又占视线。DeepSeek Harness 的插件模型允许把这类能力做成独立模块：dsh-quicknote 由社区维护者 dsh-kit 发布，归类为客户端插件，把「从当前草稿捕获一条笔记、挪开视线、集中查看与处理」做成 Composer 工具栏、侧边页和 Agent 工具三条入口。下面按安装、用法和数据存放说明可核对的事实；社区目录见 SkillHub 插件页，源码与 README 见 GitHub。

这是什么¶

dsh-quicknote（npm 包名 dsh-quicknote，当前发布版本 0.1.1，MIT 许可证）的定位是：从 DSH Composer 捕获笔记，不挡当前写作，并在单独一页里搜索、筛选和管理列表。官方简介为：Capture a note from the DSH composer, keep it out of the way, and manage the list on one page.

插件面向 DSH Web 客户端（dsh.client.platform: web），要求 DSH 引擎 >=0.2.1-rc.5。更完整的说明见项目文档：https://dsh-kit.github.io/dsh-quicknote/。

核心功能¶

Composer 工具栏¶

在 Composer 工具栏点击 Quick Note。卡片会带上当前草稿内容；你可以只保存为笔记，或保存并显式清空草稿，把输入框腾出来继续写。

侧边页¶

从侧边栏进入笔记页，可以搜索、按 All / Open / Done 筛选，复制内容、插入到当前活跃草稿，以及标记完成或删除。

Agent 工具¶

智能体可通过以下工具名操作同一套数据（具体参数以插件文档与 AGENTS.md 为准）：

• quicknote_add
• quicknote_list
• quicknote_done
• quicknote_delete

存储与 HTTP API¶

笔记保存在本机文件 ~/.dsh/quicknote/notes.json：本地存储、文件模式 0600、原子写入；README 写明无遥测。

Host 侧提供四条 JSON 路由（供客户端与集成方对照）：

• GET /api/quicknote/notes
• POST /api/quicknote/notes/create， body { text }
• POST /api/quicknote/notes/update， body { id, done }
• POST /api/quicknote/notes/delete， body { id }

安装与启用¶

DSH 生态里常见做法是：CLI/Web 用 profile 安装插件，桌面端用应用内插件页（desktop profile 由应用管理）。以下命令均来自仓库 README，不要自行改成 github:owner/repo 形式。

已发布版本（安装到 CLI/Web profile）：

dsh plugin --profile web add dsh-quicknote

本地开发（把当前工作目录 link 进 profile）：

dsh plugin --profile web add link:$PWD

桌面端请在 DSH 桌面应用的插件页面安装；desktop profile 不由上述命令管理。

安装后可用下面命令确认插件是否出现在配置里：

dsh --profile web --dump-config | grep -A2 "id: dsh-quicknote"

典型用法¶

1. 在 Web 端启用 web profile 并安装 dsh-quicknote。
2. 在 Composer 写草稿时，点 Quick Note，在卡片里保存当前内容（按需选择是否清空草稿）。
3. 打开侧边栏笔记页，用搜索和 Open/Done 筛选处理待办式笔记；需要回填时复制或插入到当前草稿。
4. 若在 Agent 会话里维护笔记，调用 quicknote_add / quicknote_list / quicknote_done / quicknote_delete，与 UI 共用 notes.json。

开发插件本身时，仓库要求 Node >=24，可用 pnpm install 与 pnpm verify（或 npm install && npm run verify）跑格式、lint、类型检查、测试与打包检查。

适用场景与注意¶

适合需要在 DSH 写作流里「先存一句、稍后统一处理」的用户，以及希望 Agent 与 UI 共享同一份本地笔记列表的场景。

插件以当前 DSH 进程的权限读写 ~/.dsh/quicknote/notes.json；安装前应阅读 源码仓库 与 MIT 许可证，自行判断是否满足安全与合规要求。SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，安装来源以你信任的 registry 或 link 路径为准。

结尾¶

dsh-quicknote 把 Composer 草稿、侧边列表和 Agent 工具接到同一本地存储，减少在 DSH 内外来回切换笔记应用的成本。查阅条目与分类：SkillHub — dsh-quicknote；源码、安装说明与 API：github.com/dsh-kit/dsh-quicknote。