焰的知识库

Lint Report 2026-07-01

Properties2
tagsmeta, lint
aliases

15 min read

Wiki Lint Report — 2026-07-01

First full lint pass on the freshly-scaffolded vault (5 sources, 92 pages). Run by: wiki-lint agent. Mode: read-only — no source files modified.

Summary

TierCount
BLOCKER1
HIGH3
MEDIUM5
LOW4
Total13
  • Pages scanned: 92 (5 sources + 49 chapters + 15 concepts + 19 entities + 4 meta)
  • Unique wikilink targets: 195 (in the 92 content pages — the lint report itself adds more)
  • Broken wikilinks (real): 25 — see BLOCKER-1
  • Orphan pages: 0
  • Mean page length: 79.1 lines (median 115, max 205, min 40)
  • Pages >300 lines: 0 (longest is app-c at 205)
  • .raw/ files modified since ingest: 0 (immutable verified)

Overall health verdict: WARN. Vault has structural integrity (no orphans, all meta files present, raw files immutable, all 91 leaf pages reachable from [[index]]) but contains 25 broken wikilinks in chapter content — most are domain-core terms (热泵, 压缩机, 蒸发器, 水泵, etc.) that should either resolve or be replaced with non-link references.

BLOCKER (must fix before any user-facing report)

BLOCKER-1 — 25 broken wikilinks in chapter content (real, not policy omissions)

These are wikilinks [[X]] where target X does NOT correspond to any page in wiki/. They are NOT covered by the “no stubs for tools/methods/standards” policy in hot.md Q3-Q5 — these are domain-core concepts that arguably SHOULD have pages.

Broken targetAppears inNote
roadmap-1`–`roadmap-9meta/overview.md, meta/hot.mdRange syntax (see MEDIUM-1)
trends-1`–`trends-6meta/overview.md, meta/hot.mdRange syntax (see MEDIUM-1)
[[压缩机]]chapters/k04.mdShould link to [[离心压缩机]] / [[螺杆压缩机]] / [[涡旋压缩机]] (existing) — disambiguate
[[热泵]]chapters/k15.mdDomain-core concept — promote to wiki/concepts/ or wiki/entities/?
[[碳中和]]chapters/k20.md, k16.mdDomain-core concept (only k16 exists as “节能与碳中和”) — promote or link to k16
[[蒸发器]](range across k04-k07)Domain-core concept — promote to entity?
[[膨胀阀]]chapters/k04.mdLikely meant [[热力膨胀阀]] or [[电子膨胀阀]] (one of which is policy-omitted) — disambiguate
[[热力膨胀阀]]chapters/k07.mdPromote to entity, or remove brackets
[[热力第一定律]] / [[热力学第一定律]]chapters/k01.mdConcept — k01 is itself about this; consider unlinking
[[热力学第二定律]]chapters/k01.mdSame — k01 is about thermodynamics
[[水泵]]chapters/k03.mdDomain-core concept — promote or remove brackets
[[离心泵]] / [[离心风机]] / [[轴流风机]]chapters/k08.mdAll referenced in k08 (“风机与水泵”) — promote or remove brackets
[[热回收]]chapters/k11.md, k16.mdDomain-core concept
[[水力失调]]chapters/k11.mdConcept — promote or remove brackets
[[蓄能系统]]chapters/k11.mdConcept — promote or remove brackets
[[沿程阻力]]chapters/k03.mdConcept
[[毛细管]]chapters/k07.mdLikely meant the 节流装置 concept — disambiguate or remove brackets
[[满液式蒸发器]]chapters/k05.mdConcept — promote or remove brackets
[[压比]]chapters/k07.md, k06.mdFormula concept — promote or remove brackets
[[润滑油]]chapters/k06.mdMaterial concept
[[美的]]chapters/k20.mdCompany — promote to entity or remove brackets
[[优化设计]]chapters/k17.mdMethod

Recommended fix (BLOCKER):

  • Option A (promote — slower): Create 10-15 new wiki/concepts/ or wiki/entities/ pages for the most-trafficked missing concepts (热泵, 压缩机, 蒸发器, 水泵, 热回收, 蓄能系统, 碳中和, etc.).
  • Option B (de-link — faster): Remove [[ ]] brackets from all 25 targets, leaving the term as plain text. This preserves readability but loses cross-ref functionality.
  • Option C (split): Promote the top 5 (热泵, 压缩机, 蒸发器, 水泵, 碳中和) to concept pages; remove brackets from the other 20.

The state summary said “15 concepts + 19 entities” and the policy note in hot.md line 73 says “Conservative on new entities/concepts” — but this is too conservative if it leaves 25 broken links in chapter content. Recommend at least Option B as immediate cleanup; Option C as the proper fix.

PROPOSED FIX — user review required.

HIGH (should fix soon)

HIGH-1 — Q6 contradiction not surfaced via callout

  • Files: /Users/fireworks7/wiki-vault/wiki/chapters/trends-2.md (around line 21), /Users/fireworks7/wiki-vault/wiki/entities/基加利修正案.md (around line 23)
  • Description: hot.md Q6 explicitly flags that “EU F-gas 2025 年起 HFC 削减 90%” (trends-2.md line 21) and “2030 年 HFC 配额 -79%” (基加利修正案.md “相关法规” section) use different denominators (削减 absolute vs 配额 relative to 2014-2016 baseline). The agent’s analysis concluded “not a contradiction, different metrics” but this conclusion is NOT surfaced in either page as a > [!contradiction] or > [!gap] callout. A future reader will see the two numbers and not know the reconciliation was already done.
  • Recommended fix: Add a callout in BOTH locations. Suggested wording:
    • In trends-2.md near the EU F-gas row: > [!note] 口径差异：EU F-gas 用 2015 年实际消费的削减百分比；基加利修正案用 2014-2016 年平均配额的削减百分比。两数字不可直接比较。
    • In 基加利修正案.md “相关法规” section: same note pointing back to trends-2.
  • PROPOSED FIX — user review required.

HIGH-2 — Meta files missing 3 of 5 required frontmatter fields

  • Files: /Users/fireworks7/wiki-vault/wiki/meta/index.md, hot.md, log.md, overview.md
  • Description: CLAUDE.md lists minimum required frontmatter as type, title, created, updated, tags, status. All 4 meta files have type, title, updated only — they lack created, tags, status. overview.md even uses type: overview instead of type: meta (inconsistent with siblings).
  • Recommended fix: Add created: 2026-07-01, tags: [meta], status: developing (or ingested) to all 4. Change overview.md frontmatter type: overview to type: meta. Also meta/index.md does not link to itself — meta/ section at the bottom references [[overview]] [[log]] [[hot]] but omits [[index]]; consider adding.
  • PROPOSED FIX — user review required.

HIGH-3 — Q4 GB standards mentioned but no entity pages exist

  • Files: 11 different GB/GB-T standards appear across multiple chapters (GB 19576 in 5 files, GB/T 18430 in 5 files, GB/T 25127 in 5 files, GB 21454 in 5 files, GB/T 14294 in 4 files, etc.)
  • Description: hot.md Q4 notes “GB 国标条目（GB 25127、GB/T 21362、GB/T 14294 等）在 roadmap/trends 中以行内文本出现，未建独立 entity 页”. Confirmed: 11 unique GB standards are referenced inline but no wiki/entities/ page exists for any of them. They appear without [[ ]] brackets (e.g., plain text “GB 19576”) so they don’t show up as broken wikilinks, but they’re high-traffic domain references (e.g., GB 19576 appears 10× across chapters). The current handling is to inline-mention them, which violates the spirit of “promote important entities” — a reader sees “GB 19576” and has no way to navigate.
  • Recommended fix: Either (a) promote the top 3-5 GB standards (GB 19576 单元式空调, GB/T 18430.1 蒸气压缩循环冷水机组, GB/T 25127 冷水机组能效, GB 21454 冷水机组能效限定值, GB/T 14294 组合式空调) to entity pages; or (b) at minimum add a [[GB 19576]]-style wikilink that points to a single catch-all wiki/entities/GB国标.md hub page.
  • PROPOSED FIX — user review required.

MEDIUM (worth fixing in next clean pass)

MEDIUM-1 — Range-link syntax roadmap-1`–`roadmap-9 / trends-1`–`trends-6 resolves to broken target

  • Files: /Users/fireworks7/wiki-vault/wiki/meta/overview.md (lines 30, 31, 60, 64, 70), /Users/fireworks7/wiki-vault/wiki/meta/hot.md (lines 17, 18, 61)
  • Description: Wikilinks like roadmap-1`–`roadmap-9 and trends-1`–`trends-6 are range notation that Obsidian resolves but vanilla wikilink parsers treat as literal target names (not found in the wiki). The pages themselves link to [[roadmap-1]]..[[roadmap-9]] individually, so this is a meta-file convention problem, not a content one. (These 2 entries are also part of the BLOCKER-1 broken-link list.)
  • Recommended fix: Either (a) keep range syntax in meta files as a convention and document it in CLAUDE.md (preferred — it’s readable), or (b) replace each roadmap-1`–`roadmap-9 with the explicit list [[roadmap-1]] [[roadmap-2]] ... [[roadmap-9]]. The first option preserves readability.

MEDIUM-2 — Q1 (k01 1.6 orphan word) NOT surfaced as resolved in k01

  • File: /Users/fireworks7/wiki-vault/wiki/chapters/k01.md
  • Description: hot.md Q1 notes the raw source hvac-rd-knowledge.html has a stray “approximating” word at line 161 (just before </td></tr>). The current k01.md does NOT contain “approximating” — the ingestion apparently cleaned it. Good. However hot.md still flags Q1 as an open question; it should be marked resolved.
  • Recommended fix: Edit hot.md Q1 line to add (已确认 — k01.md 不含此词，cleaned during ingest), or remove Q1 entirely and add a new “Resolved Questions” section.

MEDIUM-3 — ε-NTU法 filename uses literal Greek letter in filesystem path

  • File: /Users/fireworks7/wiki-vault/wiki/concepts/ε-NTU法.md
  • Description: Filename contains literal Unicode ε (U+03B5). Wikilinks [[ε-NTU法]] resolve correctly because Obsidian matches basenames. However, this filename is fragile for shell-based tools (e.g., grep without UTF-8 locale, sync tools, archive tools). This is a known wiki convention (also used by Chinese characters elsewhere) so flagging as informational.
  • Recommended fix: No fix required. If shell tooling becomes a priority, consider an ASCII alias filename. Note: 18 other non-ASCII filenames exist in the vault (数字孪生, VRF多联机, 冷水机组, 板式换热器, 翅片管换热器, 微通道换热器, 磁悬浮离心压缩机, 螺杆压缩机, 涡旋压缩机, 离心压缩机, 基加利修正案, 湿空气性质, 翅片理论, 强化传热, 总传热方程, 喷气增焓, ε-NTU法, 喘振) — all resolve correctly.

MEDIUM-4 — autocad-4 cross-references k14 (potential out-of-domain breach)

  • File: /Users/fireworks7/wiki-vault/wiki/chapters/autocad-4.md (line 71)
  • Description: autocad-4.md contains a single link to [[k14]] with the explanatory text “行业图纸标准（GB/T 17453 暖通空调图形符号、ISO 128 技术制图）属于暖通规范而非 AutoCAD 教程范畴，参见 k14”. The hot.md and CLAUDE.md policy explicitly states autocad-quickstart is 域外文档 and “不与 k 系 cross-ref”. This is the only [[k##]] link from any of the 4 autocad-* pages.
  • Recommended fix: Either (a) keep the link but soften the policy wording to permit “exclusionary cross-refs” (one-line mention as a non-topic pointer), or (b) replace 参见 [[k14]] with 参见 k14 章节 (plain text, no wikilink) — this preserves the reader direction without violating the no-cross-ref policy.

MEDIUM-5 — Duplicate wikilinks in 6 chapter pages

  • Files:
    • career-5.md (14 duplicates — mostly [[k04]] 3×, [[COP]]/[[k05]]/[[k06]]/[[k09]] 2× each)
    • roadmap-2.md (9 duplicates — [[COP]], [[k12]], [[p-h图]], [[R290]], [[R744]] 2× each)
    • roadmap-9.md (7 duplicates — [[career-5]], [[career-6]], [[R134a]], [[R290]], [[R32]] 2× each)
    • roadmap-6.md (4 duplicates)
    • trends-5.md (4 duplicates)
    • roadmap-8.md (1 duplicate — [[career-7]] 3×)
  • Description: Same [[Page Name]] appears 2-3× in single page body. Most are intentional (one in “X Referenced” footer, one inline reference); a few are pure repetition that could be deduped.
  • Recommended fix: Cosmetic. Lower priority since Obsidian resolves duplicates correctly. If cleaning, dedupe by section: keep in “X Referenced” footer list, remove inline duplicates where the same target is referenced in same paragraph.

LOW (cosmetic / nice-to-have)

LOW-1 — Inconsistent frontmatter type value for overview.md

  • File: /Users/fireworks7/wiki-vault/wiki/meta/overview.md line 1
  • Description: type: overview instead of type: meta (inconsistent with siblings index/hot/log).
  • Recommended fix: Change to type: meta.

LOW-2 — Source status ingested vs chapter/concept/entity status developing (intentional asymmetry)

  • Files: 5 sources use status: ingested, all 83 content pages use status: developing.
  • Description: This asymmetry is consistent with the convention (sources are “done ingesting”; content pages are “still being developed”). Not a bug. Flagged only because it could be flagged in a stricter lint.
  • Recommended fix: Document this convention in CLAUDE.md so future lints don’t flag it.

LOW-3 — No > [!contradiction] callouts anywhere in vault

  • Files: vault-wide
  • Description: Only 5 callouts in the vault (all > [!tip] or > [!note]). No > [!contradiction], > [!gap], > [!warning]. Q6 in hot.md would benefit from one (already flagged as HIGH-1).
  • Recommended fix: Establish callout-type taxonomy in CLAUDE.md conventions (e.g., note/tip/warning/contradiction/gap) and use consistently.

LOW-4 — meta/index.md self-reference missing from Meta section

  • File: /Users/fireworks7/wiki-vault/wiki/meta/index.md lines 135-138
  • Description: Meta section lists [[overview]], [[log]], [[hot]] but not [[index]] itself. Common Obsidian convention.
  • Recommended fix: Add [[index]] to the meta list (or omit intentionally — flagging in case intentional).

Stats

Page inventory

TypeCountLocation
Sources5wiki/sources/
Chapters49wiki/chapters/
Concepts15wiki/concepts/
Entities19wiki/entities/
Meta4wiki/meta/
Total92
  • Unique link targets: 195 (in 92 content pages)
  • Total link occurrences: ~975 (top target [[hvac-rd-knowledge]] appears 74×)
  • Real broken links: 25 — see BLOCKER-1
  • Additional 58 “unlinked targets” are intentional policy omissions (tools/methods/standards/standards-bodies per CLAUDE.md and hot.md Q3-Q5)
  • Orphan pages (no inbound links): 0

Page length statistics

  • Mean: 79.1 lines
  • Median: 115 lines
  • StdDev: 29.4
  • Max: 205 (app-c.md)
  • Min: 40 (meta/overview.md)
  • Pages >300 lines: 0 — within the 80-300 style guideline from hot.md line 70

Top 10 most-linked targets (cross-ref health)

  1. [[hvac-rd-knowledge]] — 74 inbound
  2. [[k20]] — 42 inbound
  3. [[k09]] — 33 inbound
  4. [[R32]] — 28 inbound
  5. [[R290]] — 28 inbound
  6. [[k14]] — 27 inbound
  7. [[k04]] — 27 inbound
  8. [[数字孪生]] — 25 inbound
  9. [[k06]] — 25 inbound
  10. [[R744]] — 24 inbound

All 11 key concept/entity pages checked (COP 18, GWP 15, p-h图 12, LMTD 6, 数字孪生 25, 基加利修正案 20, R32 28, R290 28, R744 24, 磁悬浮离心压缩机 12, 冷水机组 15) have healthy inbound counts (≥6 each).

Frontmatter compliance

  • Pages with full required frontmatter (type/title/created/updated/status/tags): 88 / 92 (95.7%)
  • Pages missing fields: 4 meta files (HIGH-2)

.raw/ integrity

  • All 5 .raw/*.html files last modified at or before 12:06:59 on 2026-07-01
  • Latest wiki edit: 12:18:44 on 2026-07-01
  • No raw mutations detected. Immutability verified.

DragonScale feature adoption

  • scripts/allocate-address.sh: NOT present (ADDR=0)
  • scripts/tiling-check.py: NOT present (TILE=0)
  • No .vault-meta/ directory
  • DragonScale Mechanisms 2 & 3 SKIPPED — vault has not opted in.

Top 5 actionable fixes (by impact / effort)

  1. (BLOCKER-1, 30-90 min effort, HIGH reader impact) Address 25 broken wikilinks. Recommended: promote 5 most-trafficked (热泵, 压缩机, 蒸发器, 水泵, 碳中和) to concept pages; de-link (remove brackets) from the other 20. This fixes the most-visible user-facing issue and brings the vault back to “zero broken links” status.

  2. (HIGH-1, 5 min effort, MEDIUM reader impact) Add > [!note] callout in trends-2.md and 基加利修正案.md reconciling the EU F-gas 90% vs 基加利 79% number-metric mismatch per Q6. One paragraph in each page. Prevents future reader confusion.

  3. (HIGH-2, 5 min effort, MEDIUM impact) Standardize meta file frontmatter — add created, tags, status to all 4 meta files; fix overview.md type: overview to type: meta. Aligns with CLAUDE.md required fields.

  4. (HIGH-3, 60+ min effort, MEDIUM impact) Decide on GB standards policy. Either promote top 3-5 (GB 19576, GB/T 18430, GB/T 25127, GB 21454, GB/T 14294) to entity pages, or create one GB国标.md hub page that wikilinks all standards. The current inline-text approach is the lowest-friction but loses navigability.

  5. (MEDIUM-2, 2 min effort, LOW impact) Resolve Q1 in hot.md — the “approximating” word is cleaned in k01.md; mark Q1 as resolved.

(Honourable mention: MEDIUM-4 — decide autocad→k14 cross-ref policy; LOW-1 — fix overview.md type.)

What’s healthy (positive findings)

  • Zero orphan pages — every leaf page is linked from at least one other page (most from index.md).
  • Zero raw-file mutations — all 5 .raw/*.html files are older than the latest wiki edit; immutability is preserved.
  • All 4 meta files present and non-empty — index.md, log.md, hot.md, overview.md are all readable and substantial (40-142 lines).
  • 91/91 leaf pages reachable from [[index]] — the master catalog is comprehensive.
  • Page length within style guidelines — 80-300 line target from hot.md line 70 is met (mean 79, median 115, max 205). The “should be split” >300 line threshold is not breached.
  • Strong cross-reference density on key concepts/entities — 11 priority targets all have ≥6 inbound links.
  • Only 5 callouts, all valid syntax — no malformed > [!type] lines.
  • No trailing whitespace in any of 92 files.
  • No escaped pipes in tables — markdown table syntax clean.
  • Consistent tag taxonomy — English tag names used throughout (hvac, chapter, refrigerant, etc.).
  • No skipped heading levels across all 92 files — heading hierarchy is well-formed.
  • ε-NTU法 filename with Unicode ε resolves correctly — Obsidian basename matching handles the escape transparently.
  • Conservative entity/concept policy worked — only 15 concepts + 19 entities created, but the 25 broken links show the policy was a touch too conservative. Net positive: the discipline prevented stub-spam, but the trade-off is some broken links.

Notes for next ingest / next lint

  • The 4 source pages use status: ingested while 83 content pages use status: developing. If you want a finer-grain model, consider adding status: stub for thin pages (<10 body lines) and status: complete for pages with all 4 footer sections.
  • The duplicate wikilink density in career-5.md (14) and roadmap-2.md (9) suggests these were heavily cross-referenced during ingest — could be cleaned in a follow-up pass.
  • Q1 (approximating orphan word) appears RESOLVED; Q2-Q5 are intentional policy. Q6 needs the callout (HIGH-1).
  • The BLOCKER-1 broken-link count is a key candidate for the next ingest’s lint-or-fix decision: promote 5 key concepts, de-link the other 20, or add a catch-all stub.

Generated 2026-07-01 by wiki-lint agent. Read-only pass.

Graph View

Backlinks