前言¶
DeepSeek Harness (DSH) 的核心设计理念是插件化。对于习惯使用 Obsidian 进行知识管理（PKM）的开发者而言，将其笔记库接入 DSH 的智能体工作流是一个常见需求。dsh-obsidian-second-brain 插件移植自 obsidian-second-brain 项目，适配了 DSH 的插件形态，旨在让 Obsidian vault 变成一个能够自我维护、自动整理且具备自我校验能力的第二大脑。
插件概览¶
该插件由 GongYuanCaiJi 维护，采用 MIT 许可证。它的核心目标是将手动整理笔记的过程自动化：新来源的信息会更新既有页面而非简单追加，笔记间的矛盾会被自动调和，过时的事实会被标记，避免知识库越堆越乱。
核心功能¶
-
自我重写的知识库
新输入的信息会尝试更新现有的笔记条目，而非仅仅在底部追加。插件会自动调和笔记库中的矛盾信息。 -
46 个命令覆盖完整工作流
插件提供了 46 个命令，覆盖记录、日记、项目、人物、任务、看板、决策、复盘、检索、健康检查等第二大脑的各个环节。 -
混合语义检索
采用标题加权检索的方式，并支持检索质量自评，确保信息的准确性。 -
研究工具箱
提供 7 个研究命令（包括 X/网页/YouTube/播客/NotebookLM），研究的结果会自动保存到笔记库中。 -
定时维护
插件支持在会话结束以及后台 agent 运行时自动整理笔记库。 -
AI-first 写入规则
每条生成的笔记都会包含结构化的 frontmatter、wikilink、来源信息与置信度，专门面向未来 AI 的检索而非仅为了人类阅读。 -
类型化图谱
笔记之间定义了supersedes（覆盖）、depends_on（依赖）、contradicts（矛盾）等关系，这些关系可以通过脚本进行验证。
安装¶
在 DSH 环境中安装该插件，请使用以下命令：
dsh plugin --profile <你的 profile> add github:GongYuanCaiJi/dsh-obsidian-second-brain
若 pnpm 拦截了构建步骤，需在 profile 的 pnpm-workspace.yaml 文件中将本包加入 allowBuilds。
使用方法¶
安装完成后，在 DSH 的会话中即可使用 obsidian-second-brain 技能。该技能会根据你的笔记库情况引导操作：
- 技能引导：会话开始时，
obsidian-second-brain技能会出现在可用技能列表中。 - 读取规则：插件会优先读取 vault 根目录下的
_CLAUDE.md文件（若存在），作为本次操作的操作规则。 - 保存对话：使用
/obsidian-save命令，可以将当前的对话内容整理成互相链接的 AI-first 笔记（包含人物、项目、决策、任务等条目）。 - 检索笔记：使用
/obsidian-find命令在库中检索笔记。
注意：研究命令（如 /research、/x-read 等）依赖于上游的 Python 研究工具（pyproject.toml），首次使用时会提示安装 uv。
注意事项与依赖¶
- 语言环境：上游内容为英文，命令触发词包含多语言（含中文），按移植规则未做翻译，保留原样。
- Python 依赖：研究功能依赖 Python 及
uv包管理器。 - MCP 桥接：MCP 桥接文件（
integrations/obsidian-mcp-server/）保留在上游原处，按需启用。 - 文件保真：插件逐字保留了上游 321 个文件，并钉住了 commit
4d5b673。所有命令定义与脚本均与上游保持一致。
总结¶
dsh-obsidian-second-brain 是一个面向 AI-first 知识管理的 Obsidian 插件适配。它通过结构化的写入规则和自动化的维护机制，帮助 DSH 用户在智能体会话中高效地与 Obsidian 交互，实现知识的持续沉淀与更新。
- 目录页: https://www.skillhub.cn/plugins/GongYuanCaiJi/dsh-obsidian-second-brain
- GitHub: https://github.com/GongYuanCaiJi/dsh-obsidian-second-brain
