Back to Details

second-brain-lint

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Second Brain — Lint

Second Brain — Lint

Health-check the wiki and report issues with actionable fixes.
对wiki进行健康检查并给出可落地修复方案的问题报告。

Audit Steps

审计步骤

Run all checks below, then present a consolidated report.
运行以下所有检查，然后输出合并后的报告。

1. Broken wikilinks

1. 损坏的wikilink

Scan all wiki pages for 
[[wikilink]]
references. For each link, verify the target page exists. Report any broken links.
bash
undefined
扫描所有wiki页面中的
[[wikilink]]
引用。对每个链接验证目标页面是否存在，上报所有损坏的链接。
bash
undefined

Find all wikilinks across wiki pages

Find all wikilinks across wiki pages

grep -roh '[[[^]]*]]' wiki/ | sort -u

Cross-reference against actual files in `wiki/`.
grep -roh '[[[^]]*]]' wiki/ | sort -u

与`wiki/`目录下的实际文件进行交叉校验。

2. Orphan pages

2. 孤立页面

Find pages with no inbound links — no other page references them via 
[[wikilink]]
.
For each 
.md
file in 
wiki/sources/
, 
wiki/entities/
, 
wiki/concepts/
, 
wiki/synthesis/
:
  • Extract the page name (filename without extension)
  • Search all other wiki pages for 
    [[Page Name]]
  • If no other page links to it, it's an orphan
查找没有入链的页面，即没有其他页面通过
[[wikilink]]
引用它们。
对
wiki/sources/
、
wiki/entities/
、
wiki/concepts/
、
wiki/synthesis/
目录下的每个
.md
文件：
  • 提取页面名称（无扩展名的文件名）
  • 在所有其他wiki页面中搜索
    [[Page Name]]
  • 如果没有其他页面链接到它，即为孤立页面

3. Contradictions

3. 内容矛盾

Read pages that share entities or concepts and look for conflicting claims. Flag when:
  • Two source summaries make opposing claims about the same topic
  • An entity page contains information that conflicts with a source summary
  • Dates, figures, or factual claims differ between pages
阅读涉及相同实体或概念的页面，查找冲突的表述。出现以下情况时标记：
  • 两份来源摘要对同一主题给出相反的表述
  • 实体页面包含的信息与来源摘要冲突
  • 不同页面之间的日期、数据或事实性表述存在差异

4. Stale claims

4. 过时表述

Cross-reference source dates with wiki content. Flag when:
  • A concept page cites only old sources and newer sources exist on the same topic
  • Entity information hasn't been updated despite newer sources mentioning that entity
将来源日期与wiki内容交叉校验，出现以下情况时标记：
  • 某个概念页面仅引用了旧来源，而同一主题存在更新的来源
  • 实体信息久未更新，且有更新的来源提及该实体

5. Missing pages

5. 缺失页面

Scan for 
[[wikilinks]]
that point to pages that don't exist yet. These are topics the wiki mentions but hasn't given their own page. Assess whether they warrant a page.
扫描指向尚未创建页面的
[[wikilinks]]
，这些是wiki提到过但还没有单独页面的主题，评估它们是否需要单独创建页面。

6. Missing cross-references

6. 缺失交叉引用

Find pages that discuss the same topics but don't link to each other. Look for:
  • Entity pages that mention concepts without linking them
  • Concept pages that mention entities without linking them
  • Source summaries that cover the same topic but don't reference each other
查找讨论相同主题但未互相链接的页面，排查以下情况：
  • 实体页面提到了相关概念但没有添加链接
  • 概念页面提到了相关实体但没有添加链接
  • 涉及同一主题的来源摘要没有互相引用

7. Index consistency

7. 索引一致性

Verify 
wiki/index.md
is complete and accurate:
  • Every page in 
    wiki/sources/
    , 
    wiki/entities/
    , 
    wiki/concepts/
    , 
    wiki/synthesis/
    has an index entry
  • No index entries point to deleted pages
  • Entries are under the correct category header
验证
wiki/index.md
的完整性和准确性：
  • wiki/sources/
    、
    wiki/entities/
    、
    wiki/concepts/
    、
    wiki/synthesis/
    目录下的每个页面都在索引中有条目
  • 没有指向已删除页面的索引条目
  • 条目归类在正确的分类标题下

8. Data gaps

8. 数据缺口

Based on the wiki's current coverage, suggest:
  • Topics mentioned frequently but lacking depth
  • Questions the wiki can't answer well
  • Areas where a web search could fill in missing information
基于wiki当前的覆盖范围，给出如下建议：
  • 频繁被提及但内容深度不足的主题
  • wiki无法很好解答的问题
  • 可以通过网页搜索补充缺失信息的领域

Report Format

报告格式

Present findings grouped by severity:
按严重程度分组呈现发现的问题：

Errors (must fix)

错误（必须修复）

  • Broken wikilinks
  • Contradictions between pages
  • Index entries pointing to missing pages
  • 损坏的wikilink
  • 页面间的内容矛盾
  • 指向缺失页面的索引条目

Warnings (should fix)

警告（应该修复）

  • Orphan pages with no inbound links
  • Stale claims from outdated sources
  • Missing pages for frequently referenced topics
  • 无入链的孤立页面
  • 来自过时来源的过时表述
  • 频繁被引用的主题缺少对应页面

Info (nice to fix)

提示（建议修复）

  • Potential cross-references to add
  • Data gaps that could be filled
  • Index entries that could be more descriptive
For each finding, include:
  • What: description of the issue
  • Where: the specific file(s) and line(s)
  • Fix: what to do about it
  • 可新增的潜在交叉引用
  • 可补充的数据缺口
  • 可优化描述的索引条目
每个问题需要包含：
  • 问题： 问题描述
  • 位置： 具体的文件和行号
  • 修复方案： 对应的解决办法

After the Report

报告生成后

Ask the user:
"Found N errors, N warnings, and N info items. Want me to fix any of these?"
If the user agrees, fix issues and report what changed.
询问用户：
"共发现N个错误、N个警告和N个提示项。需要我修复其中的问题吗？"
如果用户同意，修复问题并上报变更内容。

Log the lint pass

记录lint检查过程

Append to 
wiki/log.md
:
## [YYYY-MM-DD] lint | Health check
Found N errors, N warnings, N info items. Fixed: [list of fixes applied].
追加到
wiki/log.md
：
## [YYYY-MM-DD] lint | Health check
Found N errors, N warnings, N info items. Fixed: [list of fixes applied].