dsh-study-buddy
DSH 通用学习 Agent「学习伙伴」：文档式笔记插件——Obsidian vault 多根检索、文件夹规划与硬门禁落盘、微目录与覆盖度、学习进度与跨会话记忆 适合使用Obsidian做笔记、需要AI结合本地知识库进行深度学习和规划的用户。
インストール
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:V-Reason/dsh-study-buddyドキュメント
README 全文を読む ↗最小配置
vaultRoot 是唯一必填项，而且它不在包里（包开源、多机共用）。三种给法按优先级：
| 序 | 给法 | 例子 |
|---|---|---|
| 1 | 预设声明行 presets/study.patch.yml 的 study 行 config.vaultRoot | 部署侧精调（会随包更新被覆盖的注意点见 用户指南 §3） |
| 2 | 环境变量 DSH_STUDY_VAULT（别名 DSH_VAULT_ROOT） | setx DSH_STUDY_VAULT "D:\vault"，重启 DSH |
| 3 | /study-buddy.json | {"vaultRoot":"D:\\vault","skipDirs":["资源"],"searchRoots":[]} |
三者都没有 → 挂载失败（fail-loud），错误里会列出这三种给法。挂载时日志会打印一行
[dsh-study-buddy] vaultRoot ← ：，排障第一问不必翻配置。
| 键 | 默认 | 说明 |
|---|---|---|
vaultRoot | — | Obsidian vault 绝对路径；为空或文件系统根会挂载失败（fail-loud） |
expectFile | 笔记期望.md | 期望文件名（vault 根下）；读取路径、门禁签名与回显都用它 |
planTtlHours | 24 | 规划凭据有效期，超期要重新提案 |
其余键（stateDir / fallbackDir / domainFolders / skipDirs / searchRoots / includeSessionCwd / linkIntoNotes / lint.* / indexTtlMs / maxWalkFiles）见 用户指南 §4 配置参考（含"来源与优先级"一节）。