dsh-siyuan-archive
Manifest validArchives DSH conversation output into SiYuan notes: a single siyuan_archive call files content under `<archive path>/<year-month>/<type>/<date>_<time>_<topic>_<content>` with a metadata table and auto
dsh-siyuan-archive
DeepSeek Harness(DSH)插件:把 DSH 对话产出的内容归档到思源笔记,带连接 / token / 归档 / 权限设置页。token 存宿主凭据库,权限按「笔记本 → 文档」继承、默认全拒。
直连思源 HTTP API,零运行时依赖,不套 MCP。
功能
- 一条命令归档:按「
<归档路径>/<年-月>/<类型>/<日期>_<时间>_<主题>_<内容>」生成标题与路径写入思源,正文顶部自动附元数据表。 - 自动维护笔记本根的「索引与规范」文档:首次归档创建,之后每次归档重建索引表(标题 / 类型 / 归档时间,标题列可点击跳转)。
- 设置页五卡:连接(地址 + 测试连接)、API token(永不回显)、归档(目标笔记本 / 路径 / 类型 / 标题模板)、权限(笔记本级授予 + 文档级收紧)、工具开关。
- 6 个工具:
siyuan_list_notebooks/siyuan_search/siyuan_read_doc/siyuan_archive/siyuan_delete_block/siyuan_remove_doc。 - 权限模型:未配置的笔记本默认全拒;笔记本级勾选自动继承到其全部子文档;文档级只能收紧、不能放松。
前置条件
- Node ≥ 22,dsh(web profile)。
- 思源笔记已开启 API token(思源 → 设置 → 关于 → API token)。
baseUrl以 dsh 进程所在机器 的视角访问思源(默认http://127.0.0.1:6806)。
安装
# 从 GitHub 安装(推荐;纯 JS 无构建步骤,无需额外授权)
dsh plugin --profile web add github:YYK0402/dsh-siyuan-archive#main
# 本地开发版(link)
dsh plugin --profile web add /path/to/dsh-siyuan
# 发布到 npm 后
dsh plugin --profile web add dsh-siyuan-archive
安装后重启 dsh web 进程(宿主半场 lib/index.js 改动必须重启;客户端半场会热更新)。
配置
DSH Web → 设置 → 左侧导航「思源归档」:
- 连接:填思源地址 → 保存地址 → 测试连接(显示版本号即成功)。
- API token:粘贴 token → 保存(写入宿主凭据库)。
- 归档:加载笔记本 → 选目标笔记本、归档路径、默认类型、标题模板 → 保存。
- 权限:给目标笔记本勾选读/写(归档需「写」);可展开文档对子路径收紧;未勾的默认全拒 → 保存。
- 工具开关:默认开
siyuan_archive;删除类默认关。
页脚会显示「宿主接口前缀」,即设置页调宿主接口用的基址。根目录部署显示「origin 根目录(自动)」。
挂在路径前缀下(https://example.com/dsh/)
设置页会自动定位前缀,正常情况无需任何配置。反代仍需满足两条,否则 DSH 自身(不只是本插件)会挂:
location /dsh/ {
proxy_pass http://127.0.0.1:3080/; # 尾斜杠 = 剥掉 /dsh 前缀
proxy_set_header Host $host; # 必须保留 Host,否则宿主信任围栏返回 403
proxy_set_header X-Forwarded-Proto $scheme;
}
若前缀实在自动定位不出来(页脚显示「origin 根目录」但接口报 403/404),在浏览器控制台指定一次即可:
localStorage.setItem('dsh-siyuan-archive.apiBase', '/dsh')
使用
在对话里直接下指令,模型会自动调用工具:
把下面这段需求归档到思源,主题「合同系统二期」,类型「需求」
生成文档:/<归档路径>/2026-09/需求/2026-09-26_xxxx_合同系统二期_xxx,正文 = 元数据表 + 内容;同时更新笔记本根的「索引与规范」索引表。
工具清单
| 工具 | 分组 | 权限 | 说明 |
|---|---|---|---|
siyuan_list_notebooks | 只读 | 无 | 列出笔记本名与 id |
siyuan_search | 只读 | 读 | 全文检索,无权限命中会被过滤并提示条数 |
siyuan_read_doc | 只读 | 读 | 读文档(text / markdown) |
siyuan_archive | 归档 | 写 | 归档一段内容(附元数据表);同路径已存在则追加;更新「索引与规范」 |
siyuan_delete_block | 危险 | 删 | 删除内容块(需 confirm=true) |
siyuan_remove_doc | 危险 | 删 | 删除整篇文档(需 confirm=true) |
权限模型
- 未显式配置的笔记本:读/写/删全拒。
- 笔记本级勾选 = 授予,自动继承到其全部子文档。
- 文档级开关 = 显式拒绝(收紧):只能关掉继承来的权限,不能凭空放开。
- 判定在每次工具调用发请求前执行;
siyuan_list_notebooks只暴露名/id,不设权限。
开发
npm test # harness(纯函数)+ client(部署前缀定位)+ tools-e2e(对 mock-siyuan 替身全链路)
详见 docs/DEV.md(联调步骤、思源 API 血泪坑、发布清单)。
License
MIT
Comments
Loading…
Similar plugins
by huangfuren
Conversation outline panel for the DSH web surface: user questions as root nodes (index, time, tool count and text volume per turn) with the Markdown headings of assistant replies hanging beneath them
★ 2
MIT
JavaScript
Nov 13, 2026
dsh plugin --profile web add dsh-conversationDSH 工作区长期记忆:索引式简报省 token、轮末相关召回、memory 工具按需读写、版本链与体检、轮次结束自动提炼(可草稿审批),设置面板里可视化查看与管理。
★ 0
dsh plugin --profile web add @bangbang-03/dsh-memoryby wilianyichen
Operate chat.deepseek.com as a programmable agent from inside DeepSeek Harness: sessions, shares, digest. 把 DeepSeek 网页版当作可编程 Agent 的 DSH 插件
★ 2
↓ 83/wk
MIT
TypeScript
Aug 22, 2026
dsh plugin --profile web add @yichenwilian/dsh-deepseek-webby drscrewdriver
DSH Web 插件:会话管理台(原名 dsh-session-steward)—— 活跃/归档会话统一管理(浏览、筛选、收藏、批量归档/取消归档/清理),外加四门会话体检;入口自适应顶栏工具行或底栏。不含搜索/索引、不依赖 DRS(搜索在 dsh-search-index)。
★ 2
MIT
TypeScript
Nov 16, 2026
dsh plugin --profile web add dsh-manage-sessionby Kr-ATG
DSH 对话流增强插件(零 DSH 源码改动,纯插件注入)。回合呈现:思考 chip(实时走秒 + 实时文字滚动)· 工具调用聚合 chip · 对话流卡片(步骤卡/总结卡)· 共享活动抽屉。正文增强:proto-tabs 可交互卡片 · diagram 流程图围栏 · 本地 HTML 内嵌预览(识别正文里的 .html 路径,host 读文件 + 同目录资源,iframe 沙箱隔离,高度自适应,
★ 3
JavaScript
Sep 22, 2026
dsh plugin --profile web add dsh-chat-flowby a1141171521
DSH 自动记忆系统:本地优先、文本可读、失败可见的分层记忆。
★ 3
MIT
JavaScript
Oct 31, 2026
dsh plugin --profile web add dsh-memfuse