夜雨聆风学习资料网

ARTICLE · 1105276

告别手动归档!DSH 思源笔记归档插件,一键沉淀 AI 对话内容

告别手动归档!DSH 思源笔记归档插件,一键沉淀 AI 对话内容
告别手动归档!DSH 思源笔记归档插件,一键沉淀 AI 对话内容
在日常使用 DeepSeek Harness(DSH)做 AI 创作、需求梳理、方案撰写时,我们总能快速产出大量高质量内容。
但绝大多数人都会遇到同一个痛点:AI 生成内容很快,但沉淀成知识极其麻烦。
聊天记录刷新即丢失、重要内容需要手动复制粘贴、新建文档、归类文件夹、整理目录……整套操作重复且低效。
今天给大家推荐一款开源神器:dsh-siyuan-archive,一键将 DSH 对话内容全自动归档到思源笔记,自动建目录、自动生成标题、自动维护全局索引,真正实现 AI 内容「产出即沉淀」。

一、插件核心定位

这款插件是直连思源原生 HTTP API的轻量化归档工具,不依赖 MCP、无中间层、零运行时依赖,架构简单、稳定性极高。
同时搭载「默认全拒、逐级继承、可收紧不可放开」的精细化权限模型,兼顾易用性与数据安全,非常适合个人和团队长期使用。

核心亮点一览

极简架构:直连思源 API,无代理、无冗余,部署即用
全自动归档:一句指令完成分类、建文档、写元数据、更新索引
智能索引管理:自动生成可跳转知识库索引,告别杂乱笔记
双层权限管控:笔记本级授权 + 文档级收紧,杜绝误删误改
可视化配置:全图形化面板,无需改代码,小白零门槛上手

二、核心功能详细解读

1. 一键智能归档,自动规范排版

无需手动新建文档、整理格式。你只需要在 DSH 对话下达归档指令,插件会自动按照固定规范生成目录 + 标题 + 时间戳。
归档路径规则:归档路径/年-月/内容类型/日期_时间_主题
所有归档文档顶部自动附带元数据表,记录归档时间、主题、类型、来源,内容有据可查;支持同文档追加更新,非常适合需求迭代、方案迭代、复盘记录。

2. 全自动全局索引维护

首次归档自动在笔记本根目录创建「索引与规范」文档,每一次归档都会自动重建索引表。
索引表包含:文档标题、内容类型、归档时间,且标题支持点击跳转。长期使用可直接沉淀一套结构化、可检索、可追溯的个人/团队知识库。

3. 五合一可视化配置面板

插件内置完整后台配置页,五大模块覆盖全部使用场景:
连接配置:填写思源地址、一键测试连通性
Token 管理:安全存储 API Token,不回显、不泄露
归档配置:自定义笔记本、路径、类型、标题模板
权限配置:批量授权 + 子文档精细化收紧
工具开关:自由启停功能,高危删除工具默认关闭

4. 六大内置工具,覆盖全场景操作

插件原生集成 6 个工具,支持 AI 自动调用,无需手动操作思源客户端:

工具名称

权限

功能说明

siyuan_list_notebooks

无

列出所有笔记本,用于配置校验

siyuan_search

只读

全文检索,自动过滤无权限内容

siyuan_read_doc

只读

读取文档文本/Markdown 内容

siyuan_archive

写入

核心归档、追加内容、更新索引

siyuan_delete_block

高危删除

精准删除指定内容块(需确认)

siyuan_remove_doc

高危删除

删除整篇文档(需确认、默认关闭)

5. 安全双层权限模型

为防止误操作、越权修改,插件采用严格权限策略:
默认全拒:未手动配置的笔记本,读写删全部禁止
上级授权继承:笔记本开启权限,自动同步所有子文档
只能收紧、不能放开:子文档仅可关闭权限,无法越级开启,绝对安全
实时校验:每次工具调用前校验权限,拦截非法操作

三、前置条件与安装教程

1. 环境要求

Node ≥ 22,正常运行 DSH Web 服务
思源笔记已开启并复制好API Token(设置 → 关于)
DSH 进程可正常访问思源地址:http://127.0.0.1:6806

2. 安装命令(三选一)

✅ 正式推荐:GitHub 在线安装
dsh plugin --profile web add github:YYK0402/dsh-siyuan-archive#main
💻 本地开发调试
dsh plugin --profile web add /path/to/dsh-siyuan
📦 NPM 安装(后续版本)
dsh plugin --profile web add dsh-siyuan-archive
⚠️ 重要步骤:安装完成必须重启 DSH Web 进程,核心配置方可生效。

四、手把手配置流程

重启服务后,在 DSH Web 左侧打开「思源归档」,按顺序配置即可:

1. 连接配置

填写思源访问地址(本地默认 http://127.0.0.1:6806),保存并测试连接,返回版本号即为成功。

2. Token 配置

粘贴思源 API Token 并保存,密钥加密存入凭据库,全程不展示。

3. 归档规则配置

加载笔记本列表,选择目标归档目录,自定义路径、默认类型、标题模板。

4. 权限配置

目标笔记本务必勾选「读、写权限」(归档需要写入权限),可对私密子文档单独收紧权限。

5. 工具开关

默认开启归档核心能力,删除类高危工具默认关闭,日常无需改动。

五、反向代理部署避坑方案

如果你使用域名反代部署 DSH(路径如 xxx.com/dsh/),配置不当会出现 403/404 接口错误。
直接使用这份 Nginx 配置:
location /dsh/ {
proxy_pass http://127.0.0.1:3080/;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
}
若前缀自动识别失败,浏览器控制台执行修复代码:
localStorage.setItem('dsh-siyuan-archive.apiBase', '/dsh')

六、日常使用方式

配置完成后,使用方式极简,直接在对话下发自然语言指令即可:
示例指令:
把上面这段需求文档归档到思源,主题「合同系统二期迭代方案」,类型「技术需求」
插件会自动完成:
自动按年月、类型分层建目录
生成规范带时间戳的文档标题
插入元数据 + 完整对话内容
自动更新全局索引表

七、总结

dsh-siyuan-archive彻底解决了「AI 高产、知识难沉淀」的痛点,用极简、稳定、安全的方案,打通AI 创作 → 自动归档 → 结构化知识库的完整闭环。
不管是个人日常笔记沉淀、技术方案归档,还是团队知识库搭建,都能极大降低重复劳动,让每一次 AI 对话产出,都变成可复用、可检索、可沉淀的核心知识。

开源说明

本项目基于 MIT 协议开源,免费学习、使用与二次开发,欢迎 Star、Fork 共建!

相关学习资料