Session 2026-07-01 — Wiki Vault 搭建与 Obsidian 启用
全流程一句话：从零建 vault → 灌 5 份 HTML → 跑 lint → 装 Obsidian 看图谱。
🪜 操作时间线（11:42 → 13:16）
| 时段 | 事件 | 结果 |
|---|---|---|
| 11:42 | wiki-vault 初始化（Mode E — Research） | 空 vault + CLAUDE.md + 4 个 meta 模板 |
| 11:50 | 第一次 ingest：hvac-rd-knowledge.html（161KB） | +58 页（1 源 + 23 章 + 15 概念 + 19 实体） |
| 12:25 | 第二次 batch ingest：4 份 HTML（autocad / career / roadmap / trends） | +34 页（4 源 + 26 章） |
| ~13:00 | wiki-lint 健康体检 | 1 BLOCKER / 3 HIGH / 5 MEDIUM / 4 LOW，verdict WARN |
| 13:07 | Obsidian 1.12.7 via brew install --cask | /Applications/Obsidian.app + obsidian-cli |
| 13:14 | 注册 wiki-vault 到 Obsidian + 写 .obsidian/workspace.json | Obsidian 启动即见 Graph view |
最终： 92 页 = 5 sources + 49 chapters + 15 concepts + 19 entities + 4 meta
🎯 关键决策
D1: 模式 = Mode E (Research)
源是结构化技术知识库（20 章 + 附录），非商业/B 站/课程记录，故选 Research 而非 C / B / D。
D2: 位置 = ~/wiki-vault/
- 用户 home 目录现有多个 HTML + PDF 分散
- 新建独立 vault 隔离开，不污染
~/Documents/Obsidian Vault - 干净起点（无
.obsidian/）
D3: 章节页命名 = <source-prefix>-<n>.md
k01..k20（hvac-rd-knowledge）+autocad-1..4+career-1..7+roadmap-1..9+trends-1..6- 短文件名 + 数字 → 易打 wikilink
[[k09]] - 不同源不同前缀避免冲突
- 与源
<span class="chapter-num">数字一致
D4: 概念/实体保守策略
只有”跨章节反复出现”才建独立页。一次性提到的（国标 GB 19576、MATLAB、V-Model、AutoCAD 等）不建 stub，仅在章节正文提及。理由：避免 wiki 被 stub 污染，维持内链密度。例外：[[数字孪生]] 概念/实体二合一为概念页；[[基加利修正案]] 作为关键政策被独立为实体页。
D5: Obsidian 集成 = 编辑 obsidian.json + workspace.json
不依赖 obsidian-cli（CLI 需用户在 vault settings 手动启用）。workspace.json 保证重启 Obsidian 直接落到 Graph view + index.md 双 pane 布局。
🩺 当前健康状态（详见 lint-2026-07-01）
✅ 健康项
- 0 孤儿页；91/91 叶子页可达自
[[index]] - 5 份源文件不可变（
.raw/全锁） - 关键概念入链密度高：R32 28 / R290 28 / 数字孪生 25 / 基加利修正案 20
- 单页 80–300 行长度合规
[[ε-NTU法]]Unicode 文件名解析正常
⚠️ 待修问题（Top 5 by ROI）
| 优先级 | 编号 | 内容 |
|---|---|---|
| P0 | B1 | 25 个断链（核心 HVAC 概念如 [[压缩机]] [[热泵]] [[蒸发器]] [[水泵]] [[碳中和]]） |
| P0 | H1 | trends-2 + 基加利修正案 缺 Q6 备注框（EU F-gas 2025 -90% vs 2030 -79%） |
| P1 | H2 | 4 个 meta 文件 frontmatter 不齐 / [[overview]] 用了 type: overview 非 type: meta |
| P1 | H3 | 11 个国标只在正文出现，未建 entity |
| P2 | MED-2 | hot Q1 标记已解决（lint 确认 k01.md 不含 “approximating”） |
🟡 衍生洞见
- vault 目录无
.git/——下次 lint 前可顺手git init+.gitignore，让 wiki 演化有版本控制 obsidian-cli未启用 ——若想 shell 直接控制 Obsidian，需在 vault settings → Core plugins → “Command line interface” 一次 toggle
🔮 开放问题（hot Q1–Q6 + lint 衍生）
| Q | 内容 | 状态 |
|---|---|---|
| Q1 | k1.6 表格尾 “approximating” 孤立文本 | lint 确认已解决（hot.md 待标注） |
| Q2 | 源未含 BOM / 测试报告 / 出货量数据 | 待追加 source |
| Q3 | 安装施工、运维、营销明确 out-of-scope | 永久忽略 |
| Q4 | 国标独立 entity 还是 hub 页？ | 待定 |
| Q5 | autocad-4:71 误链 [[k14]]（sub-domain 违规） | 待修 |
| Q6 | EU F-gas vs 基加利数字基准年不同 | 待加 callout |
| NEW-1 | 是否 git init wiki-vault？ | 待用户决策 |
⏭️ 下一步建议（按 ROI）
- 修 B1 + H1：让 wiki 自洽——所有 wikilink 可达，跨页数字有备注框
- 修 H3 国标：建 1 个 hub 页
wiki/concepts/国标-GB-Standards.md，列 11 个国标为锚点（不建 11 个 entity） - 修 H2 + MED-2：4 个 meta 文件加 frontmatter 几行就完事
- Git init：让 92 页 + 后续演化有轨迹
- 新 source：lint 报告建议 next candidates = GB standards / York-Trane 冷水机拆解 / 行业市场数据（CRAA/CRRA）
📂 关键文件位置
- Vault 根：
/Users/fireworks7/wiki-vault/ - Obsidian 配置：
~/Library/Application Support/obsidian/obsidian.json+<vault>/.obsidian/workspace.json - 健康报告：
[[lint-2026-07-01]] - 元数据：
[[CLAUDE|CLAUDE]](vault root) /[[index]]/[[hot]]/[[log]]/[[overview]]
💡 关键学习（自合成）
- vault 多源命名加前缀比全用统一
k*安全——异源同时存在是常态 - 先 lint 后 ingest比边 ingest 边 lint 好——能一次看清 cross-ref 模式
.obsidian/workspace.json是只写一次的 cheat sheet——绕过 GUI dialog 直接开期望视图- CLI 不能绕过 GUI 一次性 toggle——但
obsidian.json编辑能完成”vault 注册”前置 - macOS
brew install --cask装 Electron 应用很顺手——比 DMG 拖拽少 1 个用户操作