GongYuanCaiJi/dsh-obsidian-second-brain

dsh-obsidian-second-brain

简体中文 | English

banner

License
DSH
移植自

一句话：把你的 Obsidian 笔记库变成会自我维护的第二大脑 —— 记下的东西会被重新整理、互相印证，过时的事实会被标出来，而不是越堆越乱。

移植自 eugeniughelbur/obsidian-second-brain（MIT），
pin 上游 main HEAD 4d5b673（2026-08-08；上游自述版本 v0.14.0），
上游的 SKILL.md、46 个命令与全部脚本逐字保留，只适配了 DeepSeek Harness 的插件形态。

注意：上游内容为英文（命令触发词含多语言，含中文），按移植规则未做翻译 —— 这是上游原样。

✨ 功能

- 🧠 自我重写的知识库 —— 新来源会更新既有页面而不是只追加；矛盾自动调和（Karpathy LLM Wiki 模式的演进）
- 🗂️ 46 个命令 —— 记录、日记、项目、人物、任务、看板、决策、复盘、检索、健康检查，覆盖第二大脑的完整工作流（完整清单见下方折叠区）
- 🔍 混合语义检索 —— 标题加权检索 + 检索质量自评（/obsidian-retrieval-eval）
- 🌐 研究工具箱 —— 7 个命令：X / 网页 / YouTube / 播客 / NotebookLM 研究，结果自动存入笔记库
- ⏰ 定时维护 —— 会话结束与后台 agent 自动整理笔记库
- ✅ AI-first 写入规则 —— 每条笔记带结构化 frontmatter、wikilink、来源与置信度，面向未来 Claude 的检索而非人类阅读（规范见 AI-FIRST.md 与 references/ai-first-rules.md）
- 🔗 类型化图谱 —— 笔记间的 supersedes / depends_on / contradicts 等关系可被脚本验证

全部 46 个命令

| 命令 | 用途 |
|---|---|
| /obsidian-save | 把对话整理成互相链接的 AI-first 笔记（人物/项目/决策/任务/看板/日记） |
| /obsidian-capture | 零摩擦记下一个想法 |
| /obsidian-daily | 创建或更新今日日记 |
| /obsidian-calendar | 日历视图与日程 |
| /obsidian-recurring | 周期性任务 |
| /obsidian-log | 记录工作/开发会话 |
| /obsidian-task | 一次性任务 |
| /obsidian-person | 人物笔记 |
| /obsidian-project / /obsidian-projects | 项目笔记 |
| /obsidian-board / /obsidian-board-hygiene | 看板与看板清理 |
| /obsidian-decide | 决策记录（--formal 为正式 ADR） |
| /obsidian-reconcile | 调和笔记库中的矛盾 |
| /obsidian-synthesize | 跨来源模式综合 |
| /obsidian-find | 检索笔记 |
| /obsidian-recap / /obsidian-review | 复盘 / 周月回顾 |
| /obsidian-health | 笔记库健康检查 |
| /obsidian-reindex / /obsidian-retrieval-eval | 检索索引与质量自评 |
| /obsidian-export / /obsidian-visualize | 导出 / 图谱可视化 |
| /obsidian-init / /obsidian-architect | 初始化 / 结构设计 |
| /obsidian-ingest | 摄入 URL/PDF/音频，笔记库自我重写 |
| /obsidian-learn / /obsidian-emerge / /obsidian-graduate | 学习 / 涌现模式 / 毕业归档 |
| /obsidian-brainstorm / /obsidian-challenge | 头脑风暴 / 挑战 |
| /obsidian-connect / /obsidian-world | 知识连接 / 世界观 |
| /obsidian-panel / /obsidian-catchup / /obsidian-distill | 面板 / 追赶 / 蒸馏 |
| /x-read / /x-pulse | X（Twitter）深度阅读 / 脉搏 |
| /research / /research-deep / /vault-deep-synthesis | 研究 / 深度研究 / 笔记库深度综合 |
| /notebooklm / /youtube / /podcast | NotebookLM / YouTube / 播客 |
| /create-command / /idea-discovery | 创建新命令 / 想法发现 |

📸 效果
在一个初始化好的 Obsidian 笔记库里，运行 /obsidian-save 会把一段对话整理成互相链接的 AI-first 笔记（人物、项目、决策、任务、看板卡片、日记各一条），而不是把整段对话原样倒进一个文件。

/obsidian-save

读取 vault 根目录 _CLAUDE.md 的操作规则
为本次对话中的新人建立人物笔记（含来源与日期）
在项目笔记中追加本次决策（记录矛盾并调和）
在今日日记中登记任务与看板卡片
→ 6 条笔记，互相 wikilink，全部符合 AI-first 规则

没有任何内容可记时：

/obsidian-find 这个决策

未找到匹配笔记 —— 已如实说明，未编造任何条目

📦 安装

dsh plugin --profile  add github:GongYuanCaiJi/dsh-obsidian-second-brain

若 pnpm 拦下构建步骤，在 profile 的 pnpm-workspace.yaml 里把本包加进 allowBuilds。

从本地目录安装（需要先自行安装依赖并跑测试）：

git clone https://github.com/GongYuanCaiJi/dsh-obsidian-second-brain.git
cd dsh-obsidian-second-brain && npm install && npm test
dsh plugin --profile  add ../dsh-obsidian-second-brain

🚀 用法

装好后，在 dsh 会话里使用 obsidian-second-brain 技能（会话开始时会出现在可用技能列表里），
它会按你的笔记库情况引导：先读 vault 根目录的 _CLAUDE.md（若有），再按需执行对应的笔记操作。

技能内容与 46 个命令的完整说明在上游 SKILL.md 与 commands/ —— 与上游逐字一致。

研究命令（/research、/x-read 等）依赖上游的 Python 研究工具（pyproject.toml，需 uv），
首次使用会在提示中说明。MCP 桥接（integrations/obsidian-mcp-server/）同样保留在上游原处，按需启用。

上游另提供面向 Claude Code 的一键安装脚本 scripts/quick-install.sh（curl 管道安装，
仅适用于 Claude Code 环境）；本移植保留该文件，但 dsh 安装请使用上面的 dsh plugin add。

✅ 移植保真

逐字保留，npm test 自动验证：SKILL.md、全部 46 个 commands/.md、references/、hooks/、
scripts/、integrations/ 等 321 个上游文件与钉住的 commit 逐字节一致
（THIRD_PARTY_NOTICES.md 钉住了上游 commit、archive integrity 与 SHA-256，
并附可直接复制的比对命令 —— 你可以自己验，不必信我们）。

dsh 适配（只有这些，逐一说明为什么非改不可）：

1. 新增 package.json / cordis.patch.yml —— dsh 插件必须以 npm bundle 形式安装，上游是 Claude Code 插件没有这个文件
2. SKILL.md 以 dsh skill 形式注册 —— 上游是 ~/.claude/skills/ 安装，dsh 通过 skill-filesystem 发现技能；文件本身逐字未动
3. 新增 test/fidelity.test.mjs + fixtures —— 「逐字保留」要可自动验证：npm test 把每个上游文件与钉住的 commit 比对（playbook N4）
4. 新增 THIRD_PARTY_NOTICES.md —— 钉住上游 commit / archive integrity / 逐字文件 SHA-256，附可复制的比对命令（playbook N4）
5. README.md / LICENSE / .gitignore 为移植门面 —— 按移植惯例重写；LICENSE 为双版权（上游 + 本移植），GitHub 可识别为 MIT

上游的 Claude Code 专属文件（.claude-plugin/、hooks.json、install.sh、update.sh）按
「不挑不筛、上游有什么搬什么」规则完整保留，dsh 不使用它们但也不删除。

🛠 开发

npm install      # 安装依赖并触发 prepare（跑保真测试）
npm test         # 验证 321 个上游文件与钉住的 commit 逐字节一致

📄 License

MIT。上游 obsidian-second-brain
Copyright (c) 2026 Eugeniu Ghelbur，本移植 Copyright (c) 2026 GongYuanCaiJi。见 LICENSE。

感谢 eugeniughelbur/obsidian-second-brain
的原作者 —— 如果这个插件对你有用，也请去给上游仓库点个 star。

English

License
DSH
port of

一句话：把你的 Obsidian 仓库变成自我维护的第二大脑——捕获的知识会被重新组织、交叉核对，过时的事实会被标记出来，而不是不断堆积。

这是 eugeniughelbur/obsidian-second-brain
（MIT）到 DeepSeek Harness 的移植版本，锁定到上游
main HEAD 4d5b673（2026-08-08；上游自报 v0.14.0）。上游的
SKILL.md、全部 46 个命令以及每一个脚本都保持逐字节一致；仅对插件形态做了适配。

注意：上游内容为英文（命令触发词为多语言，包括中文）；
根据本移植的逐字保留规则，不对其进行翻译——这就是上游原样内容。

✨ 功能特性

- 🧠 自我重写的知识库——新来源会更新现有页面，而不只是追加；矛盾会被调和（Karpathy 的 LLM Wiki 模式的演进）
- 🗂️ 46 个命令——capture、daily、person、project、task、board、decision、recap、search、health——完整的第二大脑工作流
- 🔍 混合语义搜索——标题加权检索，外加自我评估的检索质量（/obsidian-retrieval-eval）
- 🌐 研究工具包——7 个命令：X / 网页 / YouTube / 播客 / NotebookLM 研究，自动保存到仓库中
- ⏰ 定时维护——会话结束和后台代理保持仓库整洁
- ✅ AI 优先的写入规则——每条笔记都带有结构化 frontmatter、wikilinks、来源和置信度，为未来 Claude 的检索而构建，而非供人类阅读
- 🔗 类型化图谱——诸如 supersedes / depends_on / contradicts 之类的关系由脚本验证

📸 效果展示

在已初始化的仓库中，/obsidian-save 会把一段对话转化为交叉链接的 AI 优先笔记
（person、project、decision、task、board card、daily entry），而不是把对话记录倾倒进一个文件：

/obsidian-save

reads _CLAUDE.md operating rules at the vault root
creates person notes for new people (with sources and dates)
appends this decision to the project note (reconciling contradictions)
logs tasks and board cards in today's daily note
→ 6 linked notes, all AI-first compliant

当没有内容可记录时：

/obsidian-find that decision

No matching note found — stated plainly, nothing fabricated

46 个命令

完整名单——上游的每一个命令，列在上面的中文部分
（全部 46 个命令）。每个命令的权威分步说明位于
commands/ 和 SKILL.md，与上游逐字节一致。

📦 安装

dsh plugin --profile  add github:GongYuanCaiJi/dsh-obsidian-second-brain

如果 pnpm 阻止了构建步骤，请将此包添加到该 profile 的 pnpm-workspace.yaml 中的 allowBuilds。
从本地检出开始（先安装依赖并运行保真度测试）：

git clone https://github.com/GongYuanCaiJi/dsh-obsidian-second-brain.git
cd dsh-obsidian-second-brain && npm install && npm test
dsh plugin --profile  add ../dsh-obsidian-second-brain

🚀 用法

安装完成后，在 dsh 会话中使用 obsidian-second-brain 技能（它会在会话启动时出现在可用技能列表中）。它会根据你的 vault 提供指导：如果 vault 根目录下存在 _CLAUDE.md，则先读取它，然后按需执行相关的笔记操作。

技能主体和全部 46 个命令都位于上游的 SKILL.md 和 commands/ 中——与上游逐字节一致。

研究类命令（/research、/x-read 等）依赖上游的 Python 研究工具包
（pyproject.toml，需要 uv）；提示词会在首次使用时进行说明。MCP 桥接
（integrations/obsidian-mcp-server/）同样按上游原样保留，按需启用。

✅ 移植保真度

逐字节一致，由 npm test 自动验证：SKILL.md、全部 46 个 commands/.md、references/、
hooks/、scripts/、integrations/——共 321 个上游文件——均与固定提交匹配
（THIRD_PARTY_NOTICES.md 固定了上游提交、归档完整性以及
SHA-256，并附有可直接复制粘贴的比对命令——你可以自行验证，无需信任我们）。

仅有的 dsh 适配项，每一项都附有原因：

1. 新增 package.json / cordis.patch.yml——dsh 插件必须以 npm 包的形式安装；上游是没有这些文件的 Claude Code 插件
2. 将 SKILL.md 注册为 dsh 技能——上游安装到 ~/.claude/skills/；dsh 通过 skill-filesystem 发现技能；文件本身未做改动
3. 新增 test/fidelity.test.mjs + fixtures——使“逐字节一致”可被机器验证：npm test 会将每个上游文件与固定提交进行比对（playbook N4）
4. 新增 THIRD_PARTY_NOTICES.md——固定上游提交 / 归档完整性 / 逐字文件 SHA-256，并附有可直接复制粘贴的比对命令（playbook N4）
5. README.md / LICENSE / .gitignore 是移植门面——按移植惯例重写；LICENSE 为双重版权（上游 + 本移植），GitHub 仍将其识别为 MIT

Claude Code 特有的上游文件（.claude-plugin/、hooks.json、install.sh、update.sh）按
“全部搬运，不做挑选”的原则逐字保留；dsh 不使用它们，但也不会删除它们。

🛠 开发

npm install      # installs deps and runs prepare (fidelity test)
npm test         # verifies the 321 upstream files match the pinned commit byte-for-byte

📄 许可证

MIT。上游 obsidian-second-brain
Copyright (c) 2026 Eugeniu Ghelbur；本移植 Copyright (c) 2026 GongYuanCaiJi。参见 LICENSE。
感谢 eugeniughelbur/obsidian-second-brain 的作者——
如果这个插件对你有用，也请给
上游仓库 点个 star。