前言¶

在 DSH 里查资料、跑 /agent、跟模型讨论方案时，结论往往停在会话里；关掉窗口后，很难按当时的判断再找到那条记录。传统笔记工具又常在「记」之前就要求选笔记本、起标题、打标签，灵感很容易断在这一步。

随记是 DSH 生态里的本地笔记插件：随手写一句先落进今日日记，再由 AI 提议归档到合适的笔记本；素材够了，用 /agent 读已有 Markdown 做合并、复盘或成文。笔记始终是普通 .md 文件，并可通过本机 MCP 让 DSH 或其他 AI 客户端直接读写。下面介绍它的定位、安装方式与典型用法。

这是什么¶

• 仓库与包名：GitHub 为 shallinta/dsh-agentic-notes，npm 包名为 @suiji-ai/dsh-agentic-notes（README 中产品名称为「随记」）。
• 维护者：shallinta；许可证 MIT；当前资料中的包版本为 0.2.3。
• 分类：在社区目录中归类为「记忆」。
• 一句话：DSH 的本地笔记插件，支持随手记录、AI 自动归档、日记、待办与便笺，并通过 MCP 让 AI 会话读写本地 Markdown。

README 注明：当前为不稳定版本，正在进行逻辑重构，请定期备份笔记。

它解决什么问题¶

多数笔记工具把「分类」放在「记录」之前。随记把顺序反过来：

1. 先在顶部输入框记下内容，按 Enter 进入今日日记，无需先选目录。
2. AI 根据已有笔记本生成归档方案，确认后才写入主题笔记本。
3. 归错了可用「修改笔记本」只改归属，不重写正文。
4. 素材积累后，用 /agent 合并、改写或成文。

查资料、对话里得到的结论，也可以通过 MCP 在同一会话里沉淀为笔记，而不是事后凭记忆补记。

核心功能（资料已核实部分）¶

快捷记录与自动归档¶

• 首页顶部输入框：Enter 保存，Shift+Enter 换行；先写当天日记，再异步分类并弹出归档确认。
• 日记条目上显示归档状态（归档中、已归档、待确认、失败）；失败可重试。
• 长记录保留原文细节；短记录允许模型润色，必要时给出整篇改写建议并经审阅后落盘。

日记、主题笔记本、便笺与待办¶

• 日记：按日期分段的 Markdown，新月历跳转；一册约满 5000 行后下一天自动新开一册。
• 主题笔记本：书本卡片式管理，可设隐私笔记本（界面隐藏，不加密文件）；笔记即文件名，支持拖动排序、废纸篓与外部修改冲突提示。
• 便笺：独立文件于 便笺/，首页可拖动、缩放，位置尺寸会记住。
• 待办：首页右上角卡片；内容中含明确时间可生成提醒（一次性、间隔、每天、每周等），支持标签筛选与系统通知。

斜杠命令¶

在顶部输入框可使用：

不同页面下 /agent 可见的上下文不同：首页多为笔记本与标题信息，笔记本页读该本笔记，笔记页读当前篇，日记页读最近几册。

/agent 能做什么¶

除整理正文外，还可新建/移动/删除笔记与笔记本、调整顺序与标签、管理待办与便笺、读取和修改部分设置（如关闭自动归档、隐私模式等）。大批量删除、长篇改写等操作需先确认；改动可整批撤销，冲突时会拒绝覆盖。

示例（咖啡笔记本内）：

/agent 把咖啡这本里关于手冲的笔记合并成一篇《手冲入门》，放到咖啡笔记本

MCP：让 AI 读写随记¶

随记内置本机 HTTP MCP 服务。在设置页「外部连接」可查看 MCP 地址、Token 与「安装 Skill」。默认地址形态类似（以设置页为准）：

http://127.0.0.1:53152/dsh-agentic-notes/mcp

请求需携带：

Authorization: Bearer <Token>

点击「安装 Skill」会将 suiji-note 安装到 ~/.agents/skills/suiji-note/。MCP 支持列出与搜索笔记、读写笔记与 frontmatter、管理待办与便笺；MCP 写入直接落盘，suiji-note 技能要求 Agent 写入前先展示改动并等待你确认。Token 等同写入权限，仅给可信客户端，泄露时在设置页重新生成。

数据与迁移¶

数据目录由你首次使用时选择，结构大致如下：

<你选择的根目录>/
  日记/
  <笔记本名>/
  便笺/
  todo.json
  .dsh-notebooks.json
  .dsh-notebooks/

根目录路径另存于 ~/.dsh/dsh-agentic-notes.json。复制整个 <你选择的根目录> 即可备份或迁移；勿把密钥等敏感内容放进笔记后上传到公开仓库。

安装与启用¶

随记依赖已安装的 DSH 桌面端或 Web 端。

在 DSH 会话里安装（原文指令）：

安装 npm 包：
请安装这个随记插件：@suiji-ai/dsh-agentic-notes

安装 GitHub 仓库：
请帮我安装这个随记插件：https://github.com/shallinta/dsh-agentic-notes

命令行：

dsh plugin add @suiji-ai/dsh-agentic-notes

指定 profile：

dsh plugin --profile desktop add @suiji-ai/dsh-agentic-notes

插件市场：先安装市场插件 dshmarket，再在 DSH 插件页搜索「随记」安装。

装好后左侧栏应出现「随记」；若无，重启 DSH 或让模型检查插件状态。

第一次使用¶

1. 打开随记，选择空目录或已有随记数据目录。
2. 顶部输入框写一句话，按 Enter。
3. 等待右下角归档确认，确认后点「查看」核对位置。
4. 归错则点「修改笔记本」。
5. 试用 AI：打开笔记本，输入 /agent 加具体指令。

典型用法：碎片到文章¶

1. 平时把句子、想法写进输入框，让 AI 归档到主题笔记本。
2. 写作前在 DSH 对话里讨论结构，或打开相关笔记本。
3. 用 /agent 读取素材，生成大纲或初稿。
4. 在随记内阅读、修改后保存。

例如先建大纲：

/agent 读一下这个笔记本里的素材，找三个能串起来的主题，新建笔记《手冲文章大纲》，把大纲写进去

再按大纲成文：

/agent 按《手冲文章大纲》写一篇 1500 字左右的文章，新建笔记《为什么我重新开始手冲》

经 MCP 在一次问答后落笔：

把刚才关于向量数据库选型的结论整理成一篇笔记，
标题叫《向量数据库选型记录》，
写进 Agent 笔记本，并列出你参考过的来源。

适用场景与注意¶

适合谁：希望在 DSH 工作流里「先记后理」、笔记本地可控、并愿意用 /agent 或 MCP 把会话结论写回 Markdown 的开发者或个人用户。

权限与安全：插件以当前 DSH 进程权限运行，安装前建议在 GitHub 查阅源码与 MIT 许可证，确认可接受其访问本机数据目录与 MCP 监听行为。MCP 仅监听本机；Token 不要公开泄露。

生态说明：DSH 奉行「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek、幻方无官方从属关系，并非官方应用商店。

结尾¶

随记把记录动作压到一次 Enter，把分类与成文交给 AI 和本地 Markdown；与 DSH 的 /agent、MCP 组合后，查询和讨论更容易变成可检索的笔记文件。

• 目录页：https://www.skillhub.cn/plugins/shallinta/dsh-agentic-notes
• 源码与文档：https://github.com/shallinta/dsh-agentic-notes