dsh-siyuan

dsh-siyuan

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

中文 · English

---

中文

为什么需要它

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

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

这个插件解决挑选：

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

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

功能

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

效果预览

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

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

兼容性一览：

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

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

流程图 —— 对话里是 ```mermaid 代码块，同步后思源自动识别并渲染成图形，不是一段代码

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

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

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

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

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

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

怎么用

右键任意消息：

用成知识库的几个习惯

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

安装

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

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

不依赖 Git，一条命令搞定：

dsh plugin --profile desktop add dsh-siyuan-sync

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

方式二：从 GitHub 克隆

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

macOS / Linux

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

Windows（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

./uninstall.sh

Windows

.\uninstall.ps1

更新

npm 方式：

dsh plugin --profile desktop add dsh-siyuan-sync@latest

克隆方式：

cd dsh-siyuan
git pull
./uninstall.sh && ./install.sh

前置条件

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

平台支持

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

设置面板

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

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

存放规则

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

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

排版

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

摘要

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

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

行为

队列管理

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

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

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

已知限制

License

MIT

---

English

Pick out what's worth keeping from DeepSeek Harness and grow it into your own development knowledge base. Right-click to save into SiYuan; formulas and mermaid diagrams come through intact.

Why

A development conversation runs thousands of words. What's actually worth keeping might be a few paragraphs: a design that clicked, a bug that ate an afternoon, a set of tuned parameters. The rest you won't reread.

This plugin is about selection — you decide what's kept, what's kept stays usable, and it compounds into a searchable knowledge base.

SiYuan isn't a backup drive here; it's the organization layer: backlinks, outlining, tags, database views.

Features

• Three sync scopes — single message / current turn / whole window. Assistant rows carry a save icon; Shift+click saves the whole window
• Nothing lost when SiYuan is down — local queue, probed every 30s, flushed automatically
• Editable preview — tweak the title and body before writing
• Formulas and diagrams — inline and block math become native SiYuan math blocks; flowchart, sequence, state, gantt, pie, and class diagrams render as diagrams
• Speaker bubbles — user in blue, assistant in green
• Auto tags — #design#, #troubleshooting# and friends, for aggregation
• Backlinks — each segment notes its session, turn, and timestamp
• Duplicate detection — the same content prompts before being saved twice
• AI summary — for whole-window syncs, call your current model for a structured summary alongside the transcript
• Retry with backoff — failure reasons surface in the panel

Screenshots

Every image below is a raw screenshot of SiYuan after right-clicking sync in a DeepSeek Harness conversation — no manual formatting, no re-editing.

What you type in the chat is what lands in the note: Markdown, LaTeX, mermaid, code fences, tables — all rebuilt as SiYuan's native blocks instead of flattened into plain text.

See the Chinese section for the full gallery.

Usage

Right-click any message:

Install

Two options. Either way, restart Harness afterwards.

Option 1: npm (recommended)

No Git needed, one command:

dsh plugin --profile desktop add dsh-siyuan-sync

Requires pnpm. If you see pnpm was not found, install it first: npm i -g pnpm

Option 2: clone from GitHub

For hacking on the code, or when npm isn't an option.

macOS / Linux

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

Windows (PowerShell)

git clone https://github.com/LuoX218/dsh-siyuan.git
cd dsh-siyuan
.\install.ps1

If PowerShell refuses to run the script: Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

The Windows script uses a directory junction instead of a symlink, so no admin rights are needed.

What the script does

Three changes, all under ~/.dsh/profiles/desktop/:

1. Links the plugin directory into node_modules/
2. Adds it to package.json → dependencies
3. Appends it to dsh.profile.bundles

Steps 2 and 3 are what make the plugin show up under Settings → Plugins → Third-party plugins. Your package.json is backed up automatically.

For another profile, pass --profile <name> (Windows: -Profile <name>).

Verifying

After restarting Harness:

• The plugin appears under Settings → Plugins → Third-party plugins, with an enable/disable toggle
• Right-clicking any conversation message shows "Sync this message"

Uninstall

macOS / Linux

./uninstall.sh

Windows

.\uninstall.ps1

Updating

npm install:

dsh plugin --profile desktop add dsh-siyuan-sync@latest

Clone install:

cd dsh-siyuan
git pull
./uninstall.sh && ./install.sh

Requirement

SiYuan must be running — the plugin writes through its kernel API, reading the token from conf/conf.json (macOS / Windows / Linux paths all handled).

Settings

Open via Settings → Plugins → Third-party plugins → dsh-siyuan → Configure. The panel header shows connection status; four groups follow.

Storage — target notebook (created on demand), date format, grouping mode (one note per day vs. one per sync), timestamp heading level.

Layout — separator between segments, timestamp visibility, mermaid color scheme (follow theme / force light / force dark / high contrast), auto-tagging on or off.

Summary — whether whole-window syncs ask before summarizing, and a fully customizable summary prompt (leave empty for the built-in archival template).

Behavior — preview before writing, duplicate detection.

The queue section at the bottom lists pending entries with retry counts and failure reasons, each individually retryable or removable.

Known limitations

License

MIT