前言¶
在 DeepSeek Harness 里做开发，一轮对话往往几千字：方案推演、报错堆栈、调参记录混在一起。整段复制到笔记里，过一周很难翻到那几句真正有用的结论；什么都不存，同类问题又要重踩一遍。
常见做法是手动挑段落贴进笔记工具，或整窗导出后再整理。前者费时间，后者格式经常在粘贴过程中丢光——公式变成纯文本、mermaid 只剩代码块。
下面介绍社区插件 dsh-siyuan（npm 包名 dsh-siyuan-sync，仓库 LuoX218/dsh-siyuan）。它在 Harness 里用右键或动作条选定粒度，把内容写成思源块结构，并支持本地队列、预览编辑和可选 AI 摘要。
这是什么¶
dsh-siyuan 由维护者 LuoX218 发布，在 SkillHub 目录中归类为「记忆」。定位是：从 Harness 对话里挑选值得留下的片段，写入思源笔记（SiYuan），借助笔记本、双链、标签等在思源侧组织成可检索的知识库。
插件通过思源内核 API 写入；token 从思源配置 conf/conf.json 自动读取（README 写明 macOS、Windows、Linux 路径均已适配）。当前 package 版本为 1.0.2，许可证 MIT，要求 Node >= 20。package.json 中标注与 DSH 0.2.1-rc.2 兼容。
核心功能¶
三种同步粒度¶
- 单条消息：只存当前这一条。
- 本轮对话：当前这一轮问答。
- 整个窗口：窗口内已加载的全部对话。
助手消息动作条上有「存」图标；Shift + 点击可存整窗口。右键菜单同样提供「同步这条消息到思源」「同步本轮对话」「同步整个窗口的全部对话」等项（并补回「复制」等原生项）。
格式与排版¶
对话中的 Markdown 会映射为思源对应块类型，README 中的兼容性表包括：粗体/斜体/删除线、行内与块级 LaTeX（NodeMathInline / NodeMathBlock）、mermaid（flowchart、sequence、state、gantt、pie、class 等）、带语言标记的代码块、表格、任务列表与嵌套列表。用户与助手内容以气泡区分（用户蓝、助手绿）。
写入前可在预览面板修改标题和正文；可配置段落分隔线、时间戳、图表配色、自动标签（如 #方案设计#、#问题排查#）等。每段可带会话、轮次、时间的回链信息；重复内容可按指纹提示是否已存过。
思源未运行时的队列¶
思源未启动时内容进入本地队列，约每 30 秒探测一次；思源可用后自动补写。设置面板可查看队列、单条重试或批量写入，失败原因分为 offline、auth、missing、other 等类型，并支持自动退避重试。
AI 摘要（整窗口）¶
整窗口同步时，可在设置中选择「先问是否提取摘要」或「直接存全文」；摘要使用当前会话所选模型，提示词可自定义，留空则用内置模板。README 注明：会话未选模型时无法生成摘要。
安装与启用¶
推荐用 npm 方式，不依赖 Git。机器需已安装 pnpm；若提示 pnpm was not found，可先执行：
npm i -g pnpm
在 desktop profile 下安装：
dsh plugin --profile desktop add dsh-siyuan-sync
安装后须完全退出 DSH 再启动（托盘图标右键退出；仅关窗口不会重新加载插件）。重启后在 设置 → 插件 → 第三方插件 中应能看到 dsh-siyuan，启用后右键对话消息会出现同步相关菜单。
更新（npm）：
dsh plugin --profile desktop add dsh-siyuan-sync@latest
README 还提供从 GitHub 克隆后执行 install.sh / install.ps1 的方式，以及对应卸载、更新步骤；其他 profile 可用 --profile <名字>（Windows 为 -Profile <名字>）指定。
配置入口：设置 → 插件 → 第三方插件 → dsh-siyuan → 配置。面板显示思源连接状态，并可设置目标笔记本、日期格式、同日追加或每次新建文档、写入前预览、重复检测、摘要行为等；下半部为队列管理。
前置条件：写入时思源需处于运行状态。
典型用法¶
- 确认思源已启动，插件配置中目标笔记本名称符合你的分类习惯（不存在会自动创建）。
- 在 Harness 对话中，对需要留存的消息右键，按价值选粒度：一句结论用「同步这条消息」，一个问题用「同步本轮对话」，长推演用「同步整个窗口的全部对话」。
- 若开启「写入前预览」，在面板中改好标题和正文后确认写入。
- 整窗口同步且开启摘要时，按提示选择是否生成结构化摘要再一并存入。
README 建议的习惯包括：按主题建笔记本（如「架构决策」「问题排查」）、用摘要作整窗内容的索引、用标签与双链串联相关笔记。
适用场景与注意¶
适合：已在用思源、希望把 Harness 里筛出的方案、踩坑记录、参数结论落到块笔记里，并保留公式与 mermaid 的开发者。
已知限制（来自 README）：思源必须运行才能最终写入；思维导图需用户在思源侧从列表转换，插件不直接生成脑图块；排版类设置只影响新同步内容；摘要依赖当前会话已选模型。
安全与权限：第三方插件随当前 DSH 进程与用户权限运行，安装前请阅读仓库源码与 MIT 许可证，自行评估是否满足环境要求。DeepSeek Harness 采用「一切皆插件」的扩展方式；SkillHub（插件目录页）为社区收录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-siyuan 解决的是「挑什么存」和「存进去还能不能用」：粒度可选、格式按思源块保留、离线排队与预览编辑降低漏写和脏数据概率。需要安装说明与配置细节时，以 GitHub README 为准。
- 目录页：https://www.skillhub.cn/plugins/LuoX218/dsh-siyuan
- 仓库：https://github.com/LuoX218/dsh-siyuan
