second-brain-lint

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

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].