思源笔记同步 LuoX218/dsh-siyuan

dsh-siyuan

把 DeepSeek Harness 里值得留下的对话挑出来，沉淀成你自己的开发知识库。 右键选中，笔记就进了思源——公式和 mermaid 图表原样保留。

中文 · English

为什么需要它

一次开发对话几千字，真正值得留下的可能就那么几段：一个想通的方案、一个踩了半天的坑、一组调出来的参数。剩下的推演和试错，过一周你也不会重读。

问题是这些碎片都埋在里面。整段存下来懒得翻，什么都不存下次重新踩一遍。

这个插件解决挑选：

- 你决定存什么——完整一轮，或只是某条讲清楚了问题的消息
- 存进来的部分能直接用——代码、公式、图表保持原样
- 慢慢长成知识库——几个月后搜一下「上次那个内存泄漏怎么定的」就有

思源在这里不是备份盘，是组织层：双链、大纲、标签、数据库视图都是现成的。

功能

- 三种同步粒度 —— 单条消息 / 本轮对话 / 整个窗口。助手消息的动作条上有「存」图标，Shift+点存整窗口
- 思源没开也不丢 —— 先进本地队列，每 30 秒探一次，思源启动后自动补写
- 写入前可改 —— 弹预览面板，标题和正文都能编辑
- 公式和图表 —— 行内公式、块级公式渲染成思源原生公式块；流程图、时序图、状态图、甘特图、饼图、类图都识别成图表
- 对话气泡 —— 用户蓝色、助手绿色，一眼分清谁说的
- 自动标签 —— 按内容打 #方案设计#、#问题排查# 这类标签，方便聚合检索
- 回链 —— 每段末尾标明来源的会话、轮次和时间
- 重复检测 —— 同样的内容再同步会提示已存过
- AI 摘要 —— 整窗口同步时可调用当前模型生成结构化摘要，再连同全文一起存入
- 失败重试 —— 自动退避重试，面板里能看到失败原因

效果预览

下面全部是从 DeepSeek Harness 对话框右键同步过去之后，在思源笔记里的原始截图——没有手动排版，没有二次编辑。

对话里写什么，笔记里就是什么：Markdown 语法、LaTeX 公式、mermaid 图表、代码块、表格，全部按思源的块模型重新组织，而不是变成一堆纯文本。

兼容性一览：

| Harness 里的写法 | 同步后成为 | 是否丢格式 |
| 粗体 斜体 删除线 | 思源对应的行内样式 | ✅ 完整保留 |
| $E=mc^2$ | 思源行内公式 NodeMathInline | ✅ 可编辑 |
| $$...$$ | 思源公式块 NodeMathBlock | ✅ 可编辑 |
| | javascript | 思源代码块 + 语法高亮 | ✅ 语言标记都保留 |
| Markdown 表格 | 思源表格块 | ✅ 对齐方式保留 |
| - [x] 任务 | 思源任务列表块 | ✅ 可勾选 |
| 无序/有序列表 | 思源列表块（含嵌套） | ✅ 层级保留 |

文本样式与标题 —— 对话里怎么写，笔记里就怎么显示。粗体、斜体、删除线、行内代码、超链接、中文标点全部原样保留，不是转成纯文本后重新加粗的

标题层级与文本样式

公式 —— 对话里写的 LaTeX 直接变成思源公式块，点一下就能继续编辑。行内、块级、多行对齐、矩阵都支持

公式渲染

流程图 —— 对话里是

流程图

时序图 —— 多方交互和请求响应顺序，同步后保留全部结构

时序图

甘特图与饼图 —— 同一个对话里两种图都能识别，各按各的类型渲染

甘特图与饼图

思维导图 —— 对话里写的 mindmap 层级结构，同步后自动展开成树

思维导图

代码块 —— 语言标记（图里左上角的 javascript）都是同步时自动带过去的，缩进、注释、中文注释全部保留

代码块高亮

表格 —— Markdown 表格转成思源表格块，左中右对齐都能保留

表格与对齐

特殊符号 —— 箭头、数学符号、单位、Emoji、长字符串，同步过程不做任何转义或替换

特殊符号与 Emoji

怎么用

右键任意消息：

| 菜单项 | 作用 |
| 复制 | 复制这条消息的纯文本（插件接管右键后补回的原生功能） |
| 同步这条消息到思源 | 只存这一条 |
| 同步本轮对话 | 这一轮问答 |
| 同步整个窗口的全部对话 | 窗口里所有已加载的对话 |
| 思源笔记设置… | 打开控制面板 |

用成知识库的几个习惯

1. 按主题建笔记本 —— 别堆在默认的 deepseek对话 里，改成 架构决策、问题排查、性能优化
2. 按价值选粒度 —— 一句话结论存单条，讲清一个问题存本轮，长推演存整窗口 + 摘要
3. 摘要当索引 —— 整窗口生成的摘要把结论和关键参数摘在前面，日常看摘要就够
4. 标签和双链串联 —— 把「当时定的方案」和「后来踩的坑」连起来
5. 定期整理 —— 散的合并成整篇，过时的删掉

安装

两种方式，任选其一。装完都要重启 Harness。

方式一：npm（推荐，最省事）

不依赖 Git，一条命令搞定： sh
dsh plugin --profile desktop add dsh-siyuan-sync

需要机器上已装 pnpm。如果提示 pnpm was not found，先装：npm i -g pnpm

方式二：从 GitHub 克隆

适合想改代码、或者 npm 装不上的情况。

macOS / Linux
sh
git clone https://github.com/LuoX218/dsh-siyuan.git
cd dsh-siyuan
chmod +x install.sh
./install.sh

Windows（PowerShell） powershell
git clone https://github.com/LuoX218/dsh-siyuan.git
cd dsh-siyuan
.\install.ps1

PowerShell 若提示「禁止运行脚本」，先执行一次： Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Windows 脚本用目录联接（Junction）代替符号链接，不需要管理员权限。

安装脚本做了什么

三个改动，都在 ~/.dsh/profiles/desktop/ 下：

1. 把插件目录链接到 node_modules/
2. 写进 package.json 的 dependencies
3. 追加到 dsh.profile.bundles

第 2、3 步是插件能出现在「设置 → 插件 → 第三方插件」列表里的关键。脚本会自动备份 package.json。

其他 profile 用 --profile <名字> 指定（Windows 用 -Profile <名字>）。

装完确认

必须完全退出 DSH 再启动——托盘图标右键 → 退出。只关窗口只是缩到托盘，代码不会重新加载（Node 按 URL 缓存 ESM 模块，重载插件补丁不会重新 import）。

重启后：

- 设置 → 插件 → 第三方插件 里能看到 dsh-siyuan，可以启用/停用
- 右键任意对话消息，菜单里出现「同步这条消息到思源」

卸载

macOS / Linux
sh
./uninstall.sh

Windows
powershell
.\uninstall.ps1

更新

npm 方式：
sh
dsh plugin --profile desktop add dsh-siyuan-sync@latest

克隆方式： sh
cd dsh-siyuan
git pull
./uninstall.sh && ./install.sh

前置条件

思源必须开着——插件通过思源内核 API 写入，token 从 conf/conf.json 自动读取（macOS / Windows / Linux 路径都已适配）。

平台支持

| 系统 | 状态 | 说明 |
| macOS | ✅ | 已充分测试 |
| Windows | ✅ | 安装脚本已提供，代码路径全平台适配 |
| Linux | ✅ | 使用 ~/.config/siyuan/conf/conf.json |

代码只用 Node 内置模块，路径拼接统一走 path.join，不调用任何 shell 命令。

设置面板

入口：设置 → 插件 → 第三方插件 → dsh-siyuan，点「配置」。

面板顶部显示连接状态（思源是否可达、版本号），下面是四组设置。

存放规则

决定内容写到哪、怎么组织。

| 设置项 | 选项 | 说明 |
| 目标笔记本 | 任意名字 | 填不存在的名字会自动创建。想按主题分类就填 架构决策、问题排查 |
| 日期格式 | 2026-10-20 / 2026/10/20 / 2026年10月20日 | 只影响文档标题和存放路径 |
| 归类方式 | 同一天追加一篇 / 每次新建文档 | 前者适合日记式归档，后者适合每次同步都是独立主题 |
| 每段时间标题 | 不添加 / 二级 / 三级 / 四级 | 每段内容开头那个时间戳的标题级别。三级适中，不添加则不显示时间 |

面板里会实时显示「存放位置：xxx / xxx」，改完立刻能看到最终路径。

排版

控制同步过去的 Markdown 长什么样。

| 设置项 | 选项 | 说明 |
| 段落之间的分隔线 | 显示（推荐）/ 不显示 | 每次同步之间插一条 ---，多次同步视觉上分得开 |
| 每段显示时间戳 | 显示 / 不显示 | 关掉后只保留正文，适合连续记录同一主题 |
| 流程图 / 图表配色 | 跟随思源 / 强制浅色 / 强制深色 / 高对比 | mermaid 的配色方案。夜间看不清时改「强制深色」或「高对比」 |
| 自动标签 | 按内容自动加标签 / 不加标签 | 命中关键词时在正文前插 #方案设计# 这类标签 |

摘要

只在同步整个窗口时生效。

| 设置项 | 选项 / 说明 |
| 整窗口同步时 | 「先问是否提取摘要」会弹选择框；「直接存全文」跳过提问 |
| 提取摘要的提示词 | 多行文本框，可完全自定义。留空则用内置模板（概览 / 时间线 / 主要工作 / 关键信息 / 问题与解决 / 图文 / 后续，并要求配 gantt、flowchart、pie 等图表） |

提示词失焦自动保存。想强制某种输出格式，直接在里面写就行，比如「每次都要有饼图」。

行为

| 设置项 | 选项 | 说明 |
| 写入前预览 | 先预览再写入 / 直接写入 | 预览面板里可以改标题和正文，确认后才写。觉得多余就关掉 |
| 重复内容提醒 | 已存过时提示我 / 不检查直接存 | 按内容指纹判断，避免同一段内容反复堆积 |

队列管理

面板下半部分是待写入队列，每条显示标题、字数、相对时间、重试次数和失败原因。

- 重试 —— 单独补写这一条
- 删除 —— 不要了
- 立即写入 N 条 —— 队列整体补写
- 重新检测 —— 重新探测思源地址

失败原因分四类：offline（思源没开）、auth（token 失效）、missing（目标文档被删，会自动重建）、other（其他错误，附原始信息）。

已知限制

| 限制 | 原因 |
| 思源必须运行才能写入 | 写入只能走内核 API |
| 思维导图不能直接生成 | 思源的脑图是原生块，需从列表右键转换 |
| 已有内容不会自动更新 | 改了排版设置只影响新同步的内容 |
| 摘要需要先选模型 | 会话没选模型时无法生成 |

License

MIT

挑出 DeepSeek Harness 里值得留下的内容，把它养成你自己的开发知识库。 右键即可存入思源；公式和 mermaid 图原样保留。

为什么

一场开发对话动辄几千字。真正值得留下的可能就几段：一个想通了的设计、一个耗掉一下午的 bug、一组调好的参数。剩下的你不会再读。

这个插件做的是筛选——你决定留什么，留下的内容保持可用，慢慢积累成可检索的知识库。

思源在这里不是备份盘，而是组织层：反向链接、大纲、标签、数据库视图。

功能

- 三种同步范围——单条消息 / 当前轮次 / 整个窗口。助手行带保存图标；Shift+点击保存整个窗口
- 思源没开也不丢内容——本地队列，每 30s 探测一次，恢复后自动补写
- 可编辑预览——写入前可以改标题和正文
- 公式与图表——行内和块级数学公式变成思源原生数学块；flowchart、sequence、state、gantt、pie、class 图渲染为图表
- 说话人气泡——用户在蓝色气泡，助手在绿色气泡
- 自动标签——#design#、#troubleshooting# 之类，方便聚合
- 反向链接——每段都记下所属会话、轮次和时间戳
- 重复检测——同一段内容存第二次前会提示
- AI 摘要——整窗同步时，调用你当前选的模型，在对话记录之外再生成一份结构化摘要
- 退避重试——失败原因直接显示在面板里

截图

下面每张图都是 DeepSeek Harness 对话里右键同步之后，思源里的原始截图——没有手动排版，没有二次编辑。

你在聊天里写什么，落到笔记里就是什么：Markdown、LaTeX、mermaid、代码围栏、表格——全部重建为思源原生块，而不是压成纯文本。

| 在 Harness 里写 | 在思源里变成 | 保真度 |
| bold italic strike | 对应的行内样式 | ✅ |
| $E=mc^2$ | 行内数学 NodeMathInline | ✅ 可编辑 |
| $$...$$ | 数学块 NodeMathBlock | ✅ 可编辑 |
| mermaid flowchart | 图表块 | ✅ 可交互 |
| | Markdown 表格 | 表格块 | ✅ 保留对齐 |
| - [x] task | 任务列表块 | ✅ 可勾选 |

行内公式和块级公式会转成思源原生数学块

Mermaid 流程图渲染为可交互图表

甘特图看排期，饼图看占比

表格保留对齐方式和状态标记

完整图集见 中文部分。

用法

右键任意消息：

| 菜单项 | 作用 |
| 复制 | 把消息复制为纯文本（插件替换掉的原生操作） |
| 同步这条消息 | 只同步这一条 |
| 同步这一轮 | 一问一答这一对 |
| 同步整个窗口 | 已加载的全部内容 |
| 思源设置… | 打开设置面板 |

安装

两种方式，任选其一。装完都要重启 Harness。

方式一：npm（推荐）

不用 Git，一条命令： sh
dsh plugin --profile desktop add dsh-siyuan-sync

需要 pnpm。如果提示 pnpm was not found，先装：npm i -g pnpm

方式二：从 GitHub 克隆

想改代码，或者用不了 npm 时选这个。

macOS / Linux
sh
git clone https://github.com/LuoX218/dsh-siyuan.git
cd dsh-siyuan
chmod +x install.sh
./install.sh

Windows（PowerShell） powershell
git clone https://github.com/LuoX218/dsh-siyuan.git
cd dsh-siyuan
.\install.ps1

PowerShell 拒绝执行脚本时： Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Windows 脚本用目录联接代替符号链接，所以不需要管理员权限。

脚本做了什么

三处改动，都在 ~/.dsh/profiles/desktop/ 下：

1. 把插件目录链接进 node_modules/
2. 加进 package.json 的 dependencies
3. 追加到 dsh.profile.bundles

第 2、3 步决定插件能否出现在设置 → 插件 → 第三方插件里。package.json 会自动备份。

换别的配置档，传 --profile <name>（Windows 用 -Profile <name>）。

验证

重启 Harness 后：

- 插件出现在设置 → 插件 → 第三方插件，带启用/停用开关
- 右键任意会话消息，能看到「同步这条消息」

卸载

macOS / Linux
sh
./uninstall.sh

Windows
powershell
.\uninstall.ps1

更新

npm 安装的：
sh
dsh plugin --profile desktop add dsh-siyuan-sync@latest
克隆安装： sh
cd dsh-siyuan
git pull
./uninstall.sh && ./install.sh

前置要求

SiYuan 必须处于运行状态 —— 插件通过内核 API 写入，从 conf/conf.json 读取 token（macOS / Windows / Linux 路径均已处理）。

| 平台 | 状态 | 说明 |
| macOS | ✅ | 已完整测试 |
| Windows | ✅ | 提供安装脚本；所有代码路径均已适配 |
| Linux | ✅ | 使用 ~/.config/siyuan/conf/conf.json |

设置

通过 Settings → Plugins → Third-party plugins → dsh-siyuan → Configure 打开。面板顶部显示连接状态，下面分四组。

存储 —— 目标笔记本（按需创建）、日期格式、分组模式（每天一篇笔记，还是每次同步一篇）、时间戳标题级别。

布局 —— 分段之间的分隔符、时间戳是否可见、mermaid 配色方案（跟随主题 / 强制浅色 / 强制深色 / 高对比度）、自动打标签开关。

摘要 —— 整窗同步时是否先询问再生成摘要，以及完全可自定义的摘要提示词（留空则使用内置归档模板）。

行为 —— 写入前预览、重复检测。

底部的队列区列出待处理条目，附重试次数和失败原因，每条都可单独重试或删除。

已知限制

| 限制 | 原因 |
| SiYuan 必须处于运行状态 | 内核 API 是唯一的写入路径 |
| 不能直接生成思维导图 | SiYuan 思维导图是原生块；请从列表转换 |
| 已有内容不会更新 | 布局变更只影响新的同步 |
| 摘要需要选定模型 | 使用当前会话的模型 |

许可证

MIT