前言¶
在 DeepSeek Harness（DSH）里做智能体或长会话开发时，对话内容往往分散在多轮消息里；若再用外部云笔记或单独开一个编辑器，库路径、来源会话和 Agent 可检索的上下文容易脱节。下面介绍社区插件 dsh-note（维护者 SivanCola）：在 Harness Web UI 内提供三栏笔记库、双栏实时预览，并把会话沉淀、回答保存与 note_* Agent 工具接到同一套本地 Markdown 文件上。数据落在本机目录，不依赖第三方笔记云服务。
这是什么¶
dsh-note 是 DSH 的「记忆」类插件：本地 Markdown 三栏笔记库（导航 / 列表 / 编辑器）、双栏实时预览、标签与待办聚合，以及「把当前会话一键沉淀为笔记」。界面布局参考有道云笔记桌面端，但笔记文件在你自己的文件夹里，可用任意编辑器、git 或 Obsidian 直接打开。
- 目录页：https://www.skillhub.cn/plugins/SivanCola/dsh-note
- 源码与说明：https://github.com/SivanCola/dsh-note
- npm 包名：
@sivancola/dsh-note，当前版本 0.1.0，许可证 MIT
社区目录站点与 DeepSeek / 幻方无官方从属关系；DSH 生态的理念是「一切皆插件」，按需从目录或 GitHub 安装即可。
核心功能¶
笔记库与编辑¶
- 目录式笔记库：窄导航、文件夹树、正文三栏；支持搜索、在当前文件夹内新建笔记与子文件夹、按标题或更新时间排序；目录树支持键盘导航，工具栏可切换摘要列表。
- 筛选状态保持：从最近、收藏、标签或搜索进入笔记时保留筛选；待办来源跳转保留待办页与关键词。
- 收藏与置顶：星标与图钉独立保存；「最近」取最近 15 篇（按更新时间，不受置顶影响）。
- Markdown 编辑 + 实时预览：编辑 / 分栏 / 预览三种模式；工具栏覆盖常用语法；输入约 650ms 防抖自动保存，状态栏显示保存时间。
- 标签与全文搜索：每篇可加标签，标签页按出现次数聚合；
⌘K聚焦搜索，标题与正文即时过滤。
待办中心¶
从所有笔记中抽取 - [ ] 待办集中展示，可按任务文字、来源标题或标签搜索；勾选后回写原文件并同步当前编辑区与预览。已完成项列在下方；笔记变更导致行失效时会刷新并提示重新勾选。
与 Harness 会话联动¶
- 会话沉淀：会话标题栏「存为笔记」，将当前用户/助手对话整理为带日期的笔记，并打「会话沉淀」标签。
- 笔记加入对话：可将整篇快照或选中片段加入现有对话或新开工作区对话；经 Harness 原生输入接口写入草稿，不自动发送；单次最多 12000 个 Unicode 字符，超出会提示截断。
- 保存回答到笔记：从回答操作栏新建或追加笔记，保存前可预览；仅持久助手消息文字，不去保存思考或工具调用；同来源重复保存会去重。
- 来源双向跳转：frontmatter 中的
dsh_sources记录会话与笔记关联；可从笔记回到来源会话，或从会话「关联笔记」打开笔记。
Agent 读写¶
插件注册四个工具：note_list、note_search、note_read、note_write。在对话里用自然语言检索、阅读或写入笔记库中的 Markdown，例如按关键词在本地 vault 中查找接口或活动文档。
设置¶
「设置 → 笔记」显示当前库路径与统计，可修改笔记库目录（保存后插件自动重载）；支持字号切换（小 / 标准 / 大 / 特大），并提供打开笔记面板入口与快捷键说明。
数据存在哪里¶
默认库目录：配置项 rootDir 留空时为「Harness 默认工作目录 / notes」，也可用环境变量 DSH_NOTES_DIR。改目录推荐走 设置 → 笔记 → 笔记库目录（写入 profile 覆盖层）；或修改 cordis.patch.yml 的 config.rootDir 后重装 bundle。
单篇笔记即一个 .md 文件，示例 frontmatter：
---
title: 双十一广告转盘活动 · 接口评审
tags: [活动, 接口]
created: 2026-11-09T03:34:19.511Z
updated: 2026-11-09T03:35:23.241Z
pinned: false
starred: false
---
## 背景
...
笔记 id 为相对库路径（去掉 .md），例如 工作/2026/接口评审。改标题不会重命名文件；目录树对应磁盘子文件夹，不读取符号链接。界面偏好（字号、排序、默认阅读模式等）存在本机 localStorage，键前缀 dsh-note:，不随 vault 同步。
Host 侧提供 POST /api/dsh-note（list / get / create / save / search / todo / deposit 等 action）；路由仅接受本机回环请求并做同源校验。插件依赖 Harness 的 tools、webServer，无第三方 npm 依赖，零构建。
安装与启用¶
从 GitHub 安装（以 README 原文为准）：
dsh plugin add github:SivanCola/dsh-note
本地开发可在 DSH 里用 plugin_manager 将仓库目录装成 bundle（install_bundle）；改代码后可在插件页停用再启用「笔记」以重载，必要时刷新页面。
安装前建议在 GitHub 浏览源码与 MIT 许可证；插件以当前 dsh 进程权限读写本机笔记目录，库路径与 API 仅面向本机，但仍需你信任维护者与仓库内容。
典型用法¶
- 安装并启用插件后，在设置中确认或修改笔记库目录。
- 在三栏界面中创建文件夹与笔记，用分栏模式编写 Markdown，用标签与搜索管理规模稍大的库。
- 长会话结束后，在会话标题栏使用「存为笔记」做一次性沉淀；对单条有用回答用「保存回答到笔记」追加到指定篇目。
- 需要将笔记上下文带入下一轮对话时，用「加入对话」插入草稿，再在 Harness 里编辑后发送。
- 让 Agent 使用
note_search/note_read等工具在本地库中查找 material，再用note_write按你的指令更新笔记（注意 Agent 具备写盘能力，应对重要目录做备份或版本管理）。
仓库内可用 npm run check 做语法检查、npm test 跑 22 个测试；CI 在 Node 22 / 24 上执行相同检查。
适用场景与注意¶
适合：希望在 DSH 同一界面内管理本地 Markdown、把会话与笔记来源互相可追溯、并让 Agent 直接读写笔记文件的开发者。
尚未实现（README 列出的方向）：双链 [[ ]]、知识库、文件夹移动/重命名、网页剪藏、AI 摘要与续写、有道云同步、每日日记模板等。
注意：来源跳转到会话后，Harness 暂无公开的消息滚动定位 API，插件不会自动滚动聊天时间线。删除原始会话、移动笔记文件或更换库目录后，部分来源链接可能失效，界面会报错。外部同时修改同一文件时，保存冲突会保留本地内容，需你明确选择「重新载入」才放弃未保存修改。
结尾¶
dsh-note 把本地优先的 Markdown 笔记库、待办与标签、会话沉淀和 Agent 四工具收进 DSH Web UI，适合把对话产物和长期资料放在同一工作区、同一目录树下维护。安装与详情见社区目录 https://www.skillhub.cn/plugins/SivanCola/dsh-note，源码与完整能力列表见 https://github.com/SivanCola/dsh-note。
