V-Reason/dsh-study-buddy ↗★ 3

dsh-study-buddy

集成Obsidian的多根检索与进度记忆学习助手。 适合使用Obsidian做笔记、需要AI结合本地知识库进行深度学习和规划的用户。

包名
dsh-study-buddy
兼容性
待验证
版本
1.2.0
许可证
MIT
最近更新
2026年9月29日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:V-Reason/dsh-study-buddy

最小配置

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 根下);读取路径、门禁签名与回显都用它
planTtlHours24规划凭据有效期,超期要重新提案

其余键(stateDir / fallbackDir / domainFolders / skipDirs / searchRoots / includeSessionCwd / linkIntoNotes / lint.* / indexTtlMs / maxWalkFiles)见 用户指南 §4 配置参考(含"来源与优先级"一节)。