dsh-siyuan-archive

配置

DSH Web → 设置 → 左侧导航「思源归档」：

1. 连接：填思源地址 → 保存地址 → 测试连接（显示版本号即成功）。
2. API token：粘贴 token → 保存（写入宿主凭据库）。
3. 归档：加载笔记本 → 选目标笔记本、归档路径、默认类型、标题模板 → 保存。
4. 权限：给目标笔记本勾选读/写（归档需「写」）；可展开文档对子路径收紧；未勾的默认全拒 → 保存。
5. 工具开关：默认开 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，正文 = 元数据表 + 内容；同时更新笔记本根的「索引与规范」索引表。