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
