obsidian-inbox
English / 英文: README.en.md
· dsh-obsidian-inbox · GitHub
把 DeepSeek Harness（DSH）对话里值得长期保存的结论、解释、错题、想法，按一套确定性的流程整理进 Obsidian 知识库的 DSH 技能（skill）。
这是什么
一个面向 DSH 的 SKILL.md 技能，规定了「整理入库」的七步标准流程，核心原则：
- 检索优先于归档：写库前先按文件名 / aliases / 链接 / frontmatter / MOC 检索，已存在的就直接合并。
- 合并优先于新建：只做局部编辑、只更新
updated，不整篇覆盖、不生成副本。
- 只提炼长期价值：不保存完整聊天、密码令牌、临时噪音。
- 一个主归属：每个知识只进一个主目录，跨领域用链接和标签表达。
- 两级确定性校验：公式（
$/$$、拒绝 \(/\[）+ 结构与 Wiki 链接（.obsidian JSON、[[Link]] 目标、同名歧义），校验不通过不宣布「已入库」。
目录结构
这是一个 DSH 插件（dsh.bundle skill-pack），可安装进任意 profile：
dsh-obsidian-inbox/
├── package.json # dsh.bundle → cordis.patch.yml；main → lib/index.js
├── lib/
│ ├── index.js # 插件本体：注册 bundled 技能 + obsidian_validate_vault 工具
│ └── validate.js # 两级确定性校验逻辑（插件所有，工具/复用同一实现）
├── cordis.patch.yml # 激活该插件（insert 一行）
├── skills/obsidian-inbox/
│ └── SKILL.md # 技能说明（DSH 加载的入口）
├── README.md / README.en.md
├── LICENSE
└── .gitignore
一切能力都由插件提供：技能经 ctx.skills 注册为 bundled provider，校验经 ctx.tools 注册为模型工具 obsidian_validate_vault，vault 路径由插件 Config.defaultVault 声明式配置——没有散落的裸脚本或硬编码路径。
在 DSH 里使用
方式 A：npm 安装（推荐，已发布到 npm）
dsh plugin --profile web add dsh-obsidian-inbox
# 或按你的实际 profile 名调整：dsh plugin --profile <name> add dsh-obsidian-inbox
方式 B：GitHub 源码安装（备选）
dsh plugin --profile web add https://github.com/Leo3-7/dsh-obsidian-inbox
方式 C：直接把技能目录拷进 DSH 的技能目录
# 把 skills/obsidian-inbox/ 放到 $DSH_HOME/skills/ 下，或加到
# skill-filesystem 的 customSkillDirs
任一种安装后，插件都会把 skills/obsidian-inbox/ 注册为 bundled 技能，模型目录里即可看到；库校验走 obsidian_validate_vault 工具。
在会话里说触发词即可触发，例如：「整理入库」「保存这个结论」「记录为错题」「记录为项目」「更新已有笔记」。
配置 / 个性化
本技能是作者个人的整理流程，有环境相关的两处需要按你自己的库修改：
- vault 路径：由插件
Config.defaultVault 决定（默认空，需设为你的库路径）；用 obsidian_validate_vault 校验时可传 vault 参数覆盖。
- 主目录分类：
00_收件箱 / 01_考研 / 02_AI与编程 / 03_智能制造 / 04_项目 / 05_想法 / 06_错题 / 07_对话精华 —— 换成你自己的目录结构。
校验（插件工具）
校验是插件暴露的模型工具 obsidian_validate_vault（不是 shell 脚本），在对话里调用即可：
obsidian_validate_vault # 用插件配置 defaultVault（需先设为你的库路径）
obsidian_validate_vault (vault: "...") # 校验指定 vault
返回 { ok, noteCount, problems }，ok=false 时逐条列出公式 / JSON / Wiki 链接 / 同名歧义问题。实现集中在 lib/validate.js，工具与（可选）CLI 复用同一份逻辑。
退出码：0 = 通过；1 = 发现问题（会逐条列出公式 / JSON / Wiki 链接 / 同名歧义问题）。
依赖
- Node.js
>= 18（node:fs、node:path 为内置模块，无第三方依赖）。
- 目标为一个 Obsidian vault（含
.obsidian 配置目录，walk 会跳过 .obsidian / .dsh / node_modules / .git）。
许可证
MIT © Leo3-7
