dsh-wiki-bridge

WikiBridge：DeepSeek Harness (DSH) 与 Obsidian vault 的知识库桥接插件 —— 会话中沉淀知识、检索旧结论、自动注入上下文，并把 _约定.md 式的归档规范变成可执行的工作流。

📢 声明（Disclaimer）

本插件完全由 AI 编程助手（DeepSeek Harness / DSH）在对话会话中自主设计、编码与维护，仓库持有者仅负责托管与发布，未参与编写。任何代码问题、运行风险或使用后果均与仓库持有者个人无关；请使用者自行评估后使用。

This plugin was entirely designed, coded, and maintained by an AI coding assistant (DeepSeek Harness / DSH) during chat sessions. The repository owner only hosts and publishes it, and is not the author. The owner assumes no responsibility for any issues, risks, or consequences arising from its use — use at your own discretion.

功能

模型工具（Host）

工具	作用
wiki_search	全文检索（相关度排序 + 命中处摘要），排除元文件
wiki_read	读取单篇笔记完整 Markdown
wiki_write	约束写入：自动 frontmatter、标签白名单校验、查重询问、默认写收件箱、confirmed 智能确认
wiki_check	知识库体检：断链 / frontmatter / 双链 / 首页登记 / 标签白名单 / 超长行数
wiki_archive	周维护归档：收件箱 → 分类目录 → 刷新 frontmatter → 自动登记首页

自动词典（主题词门控上下文注入）

• agent/pre-step 监听：对话命中 vault 标题/标签/关键词时自动注入 top-3 笔记摘要（加权匹配：标题 3 / 标签 2 / 正文 1）
• 闲聊零开销（不命中不注入）；同回合只注入一次；按 agent 去重
• 索引缓存按文件 version 失效，vault 变大不重复读取

设置页（Client）

• 设置 → WikiBridge：vault 路径（自动发现 + 手动）、写入确认、常驻指引、自动词典开关
• 零补丁架构：client 通过插件自注册的 HTTP 路由 /api/wiki-bridge/config 通信（webServer.register），host 内部写 settings 持久化 —— 不依赖 settings-not-exposed allowlist，不修改 DSH 主安装，升级安全

写入约束（内建 _约定.md 规范）

• 自动生成 frontmatter（title/created/updated/tags），日期由 host 填写
• 文件名中文短名规范化；标签白名单校验（新标签询问）
• 查重：同名页面询问追加更新 vs 新建；默认只写 收件箱/（铁律护栏）
• 元文件（_约定.md 等）排除出搜索与词典
• 凭据脱敏：写入前自动掩码 API Key/Token/私钥（返回 redactedCount）

知识生命周期（收件箱 → 分类 → 体检 → 遗忘）

① 沉淀（平时）        ② 归档（周维护）        ③ 体检（随时）      ④ 遗忘（衰减）
说"记一下"           说"做周维护"           说"体检一下"         超过阈值
    │                     │                      │                  │
wiki_write           wiki_archive           wiki_check          updated 距今
→ 收件箱/           → 分类目录 + 首页登记    → 7 项规范检查     > decayDays(90天)
（脱敏+白名单+查重）  （一次确认后执行）       （断链/frontmatter/  → 报告"可能过时"
                                            双链/登记/白名单/行数） → 人工裁决移入 归档/