AI 深度阅读实验室系统搭建与环境验证（完整版）

🔵 AI 深度阅读实验室系统搭建与环境验证（完整版）

目标： 一次搭好，后续 11 个模块全部跑通。不跳步骤，不留隐患。

0.1 前置确认清单

在开始安装之前，先确认你的基础环境：

Bash

# 检查 Node.js（必须 18+） node --version # 检查 Git git --version # 检查 npm npm --version

需要的工具版本：

0.2 安装 Claude Code / Codex

方案 A：Claude Code（推荐，与 dbskill 最兼容）

Bash

npm install -g @anthropic-ai/claude-code claude --version # 验证安装成功 claude # 首次运行完成授权

方案 B：Codex CLI

Bash

npm install -g @openai/codex codex --version

方案 C：同时使用两者（进阶）

两者都安装后，dbskill 通过触发词和文件系统状态在 Claude Code、Codex、Cursor、Grok 间共享，无需重复配置。

迁移时使用：

Bash

/dbs-agent-migration # 统一 CLAUDE.md 和 AGENTS.md 配置

0.3 安装三大核心 Skill 包

Step 1：安装 dbskill（商业诊断工具箱）

7 claudemarketplaces.com 上 dontbesilent2025/dbskill 共收录 23 个 skill。

Bash

# 一键全量安装（推荐） npx -y skills add dontbesilent2025/dbskill -g --all # 验证安装 ls ~/.claude/skills/ | grep dbs

预期输出（应看到以下目录）：

text

dbs/ dbs-action/ dbs-agent-migration/ dbs-ai-check/ dbs-benchmark/ dbs-chatroom/ dbs-chatroom-austrian/ dbs-content/ dbs-deconstruct/ dbs-diagnosis/ dbs-goal/ dbs-hook/ dbs-report/ dbs-restore/ dbs-save/ dbs-slowisfast/ dbs-xhs-title/

Step 2：安装 obsidian-skills（Vault 操作能力）

obsidian-skills 教会你的 Agent 使用 Obsidian CLI 以及 Markdown、Bases、JSON Canvas 等开放格式。

Claude Code 安装方式：

Bash

# 克隆到你的 Obsidian Vault 根目录 cd /path/to/your/obsidian-vault git clone https://github.com/kepano/obsidian-skills.git .claude-tmp cp -r .claude-tmp/skills/ .claude/skills/obsidian/ rm -rf .claude-tmp

Codex 安装方式：

将 skills/ 目录复制到 Codex 的 skills 路径（通常是~/.codex/skills）。

Bash

git clone https://github.com/kepano/obsidian-skills.git cp -r obsidian-skills/skills/* ~/.codex/skills/

OpenCode 安装方式：

将完整仓库克隆到 OpenCode skills 目录（~/.opencode/skills/），不要只复制内部的 skills/ 文件夹——要克隆完整仓库以保持目录结构为~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md。OpenCode 会自动发现所有 SKILL.md 文件，无需修改任何配置文件，重启 OpenCode 后 skills 即可生效。

Step 3：安装 book-to-skill（书籍转化工具）

Bash

# 安装到 Claude Code git clone https://github.com/virgiliojr94/book-to-skill.git \ ~/.claude/skills/book-to-skill # 安装到跨 Agent 路径（Amp / 通用） git clone https://github.com/virgiliojr94/book-to-skill.git \ ~/.agents/skills/book-to-skill

运行/book-to-skill your-book.pdf（也支持文件夹、glob 或文件列表），会在 Agent 的 skills 目录中创建完整技能，章节文件按需加载，不占用额外上下文预算。

0.4 搭建 Obsidian Vault 标准目录结构

打开 Obsidian，新建一个专用 Vault（或在现有 Vault 中创建如下结构）：

Bash

cd /path/to/your/obsidian-vault # 一键创建标准目录 mkdir -p \ 00-Inbox \ 01-Books \ 02-Skills/atoms \ 03-Projects \ 04-Outputs \ 05-Archive \ System/Templates \ System/Canvas \ .claude/skills

目录用途说明：

text

📁 Vault根目录/ │ ├── 📁 00-Inbox/ # 每日输入暂存区（待处理） │ └── _README.md # 规则：超过3天未处理 → 自动移入 Archive │ ├── 📁 01-Books/ # book-to-skill 生成的书籍 Skill │ ├── poor-charlies-almanack/ │ │ ├── SKILL.md │ │ └── chapters/ │ └── _书单追踪.md │ ├── 📁 02-Skills/ # 自己提炼的原子技能卡 │ ├── atoms/ # 知识原子库（atoms.jsonl 格式兼容） │ └── frameworks/ # 框架卡片 │ ├── 📁 03-Projects/ # 项目级诊断空间 │ └── my-project/ │ ├── dbs-sessions/ # dbs-save 存档 │ └── dbs-reports/ # dbs-report 输出 │ ├── 📁 04-Outputs/ # 成品输出（文章/脚本/方案） │ ├── 📁 05-Archive/ # 冷藏归档 │ ├── 📁 System/ │ ├── Templates/ # 笔记模板 │ └── Canvas/ # 知识图谱文件 │ └── 📁 .claude/ └── skills/ ├── obsidian/ # obsidian-skills ├── book-to-skill/ └── dbskill/ # 或软链接到 ~/.claude/skills/dbs*

0.5 初始化 Obsidian 必备插件

在 Obsidian 的设置 → 社区插件中，安装并启用：

安装 Obsidian CLI（关键步骤）：

obsidian-cli skill 支持通过命令行读取、创建、搜索和管理笔记、任务、属性等，还支持插件和主题开发，包括重载插件、运行 JavaScript、捕获错误、截图和检查 DOM 等操作。

Bash

# 在终端验证 obsidian-cli 是否可用 obsidian help # 应列出所有可用命令 obsidian read file="README.md" # 读取 Vault 根目录的文件

⚠️ 注意：使用 obsidian CLI 需要 Obsidian 处于打开状态，Agent 通过 CLI 与正在运行的 Obsidian 实例交互。

0.6 创建标准笔记模板

在 System/Templates/ 下创建以下模板文件：

模板 A：读书笔记模板

Markdown

--- type: book-note book: "{{书名}}" author: "{{作者}}" status: reading # reading / processing / done skill-path: "01-Books/{{slug}}/" date-started: {{date:YYYY-MM-DD}} date-finished: atoms-count: 0 tags: [book, {{主题标签}}] --- # {{书名}} · 读书笔记 ## 核心主题 > 用一句话说清这本书在解决什么问题 ## 章节进度 - [ ] 第一章： - [ ] 第二章： ## 提炼的知识原子 （每章读完后用 `/dbs-deconstruct` 拆解后填入） ## 改变了我哪个判断 （读完后必填，否则这本书白读） ## 关联笔记 （用 [[wikilink]] 连接相关概念卡）

模板 B：知识原子模板

Markdown

--- type: atom id: "{{date:YYYYMM}}_{{序号}}" source: "{{来源书名/作者}}" topics: [{{主题1}}, {{主题2}}] skills: [{{关联skill}}] atom-type: insight # insight / anti-pattern / framework / case confidence: high # high / medium / low date: {{date:YYYY-MM-DD}} tags: [atom] --- # {{原子标题}} ## 核心观点 （一句话，不超过50字） ## 展开说明 （2-3句，解释为什么这个观点成立） ## 反直觉之处 （这个观点颠覆了什么常识？） ## 我的应用场景 （在什么情况下我会用到这个原子？） ## 相关原子 - [[原子-X]] - [[原子-Y]]

模板 C：诊断报告模板

Markdown

--- type: diagnosis-report project: "{{项目名}}" date: {{date:YYYY-MM-DD}} skills-used: [dbs-diagnosis, dbs-benchmark, dbs-report] session-path: "~/.dbs/sessions/{{项目名}}/" status: draft # draft / reviewing / final tags: [diagnosis, project] --- # {{项目名}} · 诊断报告 ## 项目概况 （一段描述：客户是谁，卖什么，怎么赚钱） ## 诊断结论 （dbs-diagnosis 输出的核心结论） ## 对标分析 （dbs-benchmark 的发现） ## 关键问题（未解决） - 问题1： - 问题2： ## 下一步行动 （dbs-action 输出） ## 存档路径 `~/.dbs/sessions/{{项目名}}/`

0.7 初始化 Git 版本控制

Bash

cd /path/to/your/obsidian-vault # 初始化 git 仓库 git init git add . git commit -m "init: 搭建 Skill Stack 知识库基础结构" # 推荐的 .gitignore cat > .gitignore << 'EOF' .obsidian/workspace .obsidian/workspace.json .obsidian/plugins/ *.DS_Store EOF

与 dbs-save 联动的 commit 习惯：

Bash

# 每次诊断存档后，同步 commit /dbs-save project="my-project" git add . git commit -m "diag: my-project 第一轮诊断存档 $(date +%Y%m%d)"

每次 dbs-save 都新增一份存档，不会覆盖，一个项目下可以攒很多份存档，记录诊断从开始到收尾的全过程，诊断的存档默认放在~/.dbs/sessions/{项目名}/，报告放在~/.dbs/reports/{项目名}/。

0.8 完整连通性测试（全部通过才算搭建成功）

按顺序执行以下测试，每一项都要看到正确输出：

测试 1：dbskill 路由器

Bash

# 在 Claude Code / Codex 中输入 /dbs

✅ 预期结果： 返回功能菜单，不执行任何诊断，只询问需求

测试 2：dbs 子 skill 直接调用

Bash

/dbs-deconstruct 「私域」是什么意思？

✅ 预期结果： 开始拆解"私域"概念，输出最小化定义

测试 3：obsidian-skills 读写能力

Bash

# 读取文件 obsidian read file="System/Templates/读书笔记模板.md" # 创建文件 obsidian create name="00-Inbox/测试笔记" content="# 测试\n这是连通性测试" # 搜索 obsidian search query="测试"

✅ 预期结果： 三条命令均返回正确内容

测试 4：book-to-skill 基础调用

Bash

# 准备一个任意 PDF（哪怕只有几页） /book-to-skill test-document.pdf

✅ 预期结果： 在 skills 目录生成对应的 SKILL.md + 章节文件

测试 5：存档 + 恢复闭环

Bash

mkdir ~/projects/test-project && cd ~/projects/test-project /dbs-save project="test-project" # 关闭会话，重新打开 /dbs-restore

✅ 预期结果： 能正确拉回上一次的存档状态

测试 6：obsidian-skills Skill 集合完整性

完整的 Obsidian skill 集合包括：openclaw-obsidian、kepano-obsidian-skills-obsidian-markdown、kepano-obsidian-skills-obsidian-cli、kepano-obsidian-skills-json-canvas、kepano-obsidian-skills-obsidian-bases、kepano-obsidian-skills-defuddle 等，安装后需读取每个 SKILL.md 并完成必要的设置。

Bash

# 验证所有 obsidian skill 均已加载 ls ~/.claude/skills/obsidian/

✅ 预期结果： 看到 obsidian-cli、obsidian-markdown、json-canvas、obsidian-bases 等目录

0.9 测试通过后：创建你的系统基准文档

所有测试通过后，在 Obsidian 中创建一个"系统基准文档"，作为这套系统的"说明书"：

Bash

obsidian create name="System/Skill-Stack-系统说明书" content=""" --- type: system-doc created: $(date +%Y-%m-%d) version: 1.0 --- # Skill Stack 系统说明书 ## 已安装 Skills - [x] dbskill (全量 23 个 skill) - [x] obsidian-skills - [x] book-to-skill ## 触发命令速查 | 命令 | 功能 | |------|------| | /dbs | 商业工具箱入口路由 | | /dbs-deconstruct | 概念拆解 | | /dbs-diagnosis | 商业模式诊断 | | /dbs-benchmark | 对标分析 | | /dbs-content | 内容诊断 | | /dbs-hook | 开头优化 | | /dbs-action | 执行力诊断 | | /dbs-goal | 目标追踪系统 | | /dbs-slowisfast | 防贪快决策 | | /dbs-save | 存档当前诊断 | | /dbs-restore | 恢复上次诊断 | | /book-to-skill [file] | 书籍转 Skill | | obsidian read | 读取 Vault 文件 | | obsidian create | 新建笔记 | | obsidian search | 语义搜索 | ## 存档路径 - 诊断存档：~/.dbs/sessions/ - 诊断报告：~/.dbs/reports/ - Skills：~/.claude/skills/ ## 最近更新 - $(date +%Y-%m-%d)：系统初始化完成 """

0.10 模块 0 完成确认

验收标准： 以下全部打勾，才能进入模块 1

text

□ Claude Code / Codex 安装并授权完成 □ dbskill 全量 skill 安装，/dbs 路由测试通过 □ obsidian-skills 安装，obsidian read / create / search 均可用 □ book-to-skill 安装，基础调用测试通过 □ Vault 标准目录结构创建完成 □ 三个核心模板创建完成 □ Git 初始化并完成首次 commit □ dbs-save / dbs-restore 闭环测试通过 □ 系统说明书创建并存入 Vault

📌 模块 0 常见问题排查