前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。在长期对话中，模型会产出结论、解释或想法，这些信息若不整理，很容易被淹没或丢失。本插件提供了一个确定的流程，将 DSH 对话中值得长期保存的内容直接整理进 Obsidian 知识库。
这是什么¶
dsh-obsidian-inbox 是一个面向 DSH 的 SKILL.md 技能，由开发者 Leo3-7 维护。它定义了一套整理入库的标准流程，旨在解决知识碎片化的问题，将对话中的高价值信息结构化地存入 Obsidian。
核心功能¶
插件运行时，会按照以下原则处理内容：
- 检索优先于归档：在写入知识库前，先按文件名、aliases、链接、frontmatter 或 MOC 进行检索。如果目标已存在，则进行合并。
- 合并优先于新建：只做局部编辑，仅更新
updated时间戳，不整篇覆盖，也不生成副本。 - 只提炼长期价值：不保存完整的聊天记录、密码、令牌或临时的噪音信息。
- 一个主归属：每个知识条目只进入一个主目录，跨领域的关系通过链接和标签表达。
- 两级确定性校验：校验包含两个层级。第一层是公式级，识别
$$或$的数学公式，拒绝非法字符；第二层是结构级，检查 Wiki 链接（[[Link]]）的有效性、.obsidianJSON 配置的合法性以及同名歧义。校验不通过时，不会宣布「已入库」。
安装¶
插件已发布至 npm，可以通过以下命令安装：
dsh plugin --profile web add dsh-obsidian-inbox
如果你的 DSH 使用的是其他 profile，请将 --profile web 替换为实际名称。
配置¶
使用前需配置两个关键项：
- Vault 路径：由插件的
Config.defaultVault决定。默认为空，需手动设置为你的 Obsidian 库路径。在调用校验工具时，也可以通过参数覆盖。 - 主目录分类：默认结构包含
00_收件箱 / 01_考研 / 02_AI与编程 / 03_智能制造 / 04_项目 / 05_想法 / 06_错题 / 07_对话精华。请根据实际需求调整目录结构。
校验工具¶
插件暴露了一个模型工具 obsidian_validate_vault，用于在校验前检查知识库的健康状态。这并非 shell 脚本，而是在对话中直接调用的工具。
调用示例：
obsidian_validate_vault
obsidian_validate_vault (vault: "...")
工具会返回 { ok, noteCount, problems }。当 ok=false 时，会逐条列出公式、JSON、Wiki 链接或同名歧义问题。退出码为 0 表示通过，1 表示发现问题。
依赖与环境¶
- Node.js：版本需
>= 18。 - 目标环境：一个标准的 Obsidian vault，必须包含
.obsidian配置目录。
总结¶
本插件通过 ctx.skills 注册为 bundled provider，将 DeepSeek Harness 与 Obsidian 的知识管理能力连接起来。它通过严格的校验和合并逻辑，确保知识库的整洁与一致性。
