better-dsh 0.2.4 → 0.2.5

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/research/research-blogwatcher.md

@@ -0,0 +1,152 @@
+---
+title: "Blogwatcher — 通过 blogwatcher-cli 工具监控博客和 RSS/Atom 订阅源"
+sidebar_label: "Blogwatcher"
+description: "通过 blogwatcher-cli 工具监控博客和 RSS/Atom 订阅源"
+---
+
+{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
+
+# Blogwatcher
+
+通过 blogwatcher-cli 工具监控博客和 RSS/Atom 订阅源。
+
+## Skill 元数据
+
+| | |
+|---|---|
+| 来源 | 内置（默认安装） |
+| 路径 | `skills/research/blogwatcher` |
+| 版本 | `2.0.0` |
+| 作者 | JulienTant (fork of Hyaxia/blogwatcher) |
+| 许可证 | MIT |
+| 平台 | linux, macos, windows |
+| 标签 | `RSS`, `Blogs`, `Feed-Reader`, `Monitoring` |
+
+## 参考：完整 SKILL.md
+
+:::info
+以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
+:::
+
+# Blogwatcher
+
+使用 `blogwatcher-cli` 工具追踪博客和 RSS/Atom 订阅源的更新。支持自动订阅源发现、HTML 抓取回退、OPML 导入，以及文章已读/未读管理。
+
+## 安装
+
+选择以下任一方式：
+
+- **Go：** `go install github.com/JulienTant/blogwatcher-cli/cmd/blogwatcher-cli@latest`
+- **Docker：** `docker run --rm -v blogwatcher-cli:/data ghcr.io/julientant/blogwatcher-cli`
+- **二进制文件（Linux amd64）：** `curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_linux_amd64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli`
+- **二进制文件（Linux arm64）：** `curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_linux_arm64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli`
+- **二进制文件（macOS Apple Silicon）：** `curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_darwin_arm64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli`
+- **二进制文件（macOS Intel）：** `curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_darwin_amd64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli`
+
+所有发布版本：https://github.com/JulienTant/blogwatcher-cli/releases
+
+### Docker 持久化存储
+
+默认情况下，数据库位于 `~/.blogwatcher-cli/blogwatcher-cli.db`。在 Docker 中，容器重启后数据会丢失。使用 `BLOGWATCHER_DB` 或挂载卷来持久化数据：
+
+```bash
+# 命名卷（最简单）
+docker run --rm -v blogwatcher-cli:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan
+
+# 主机绑定挂载
+docker run --rm -v /path/on/host:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan
+```
+
+### 从原版 blogwatcher 迁移
+
+如果从 `Hyaxia/blogwatcher` 升级，请移动数据库文件：
+
+```bash
+mv ~/.blogwatcher/blogwatcher.db ~/.blogwatcher-cli/blogwatcher-cli.db
+```
+
+二进制文件名已从 `blogwatcher` 更改为 `blogwatcher-cli`。
+
+## 常用命令
+
+### 管理博客
+
+- 添加博客：`blogwatcher-cli add "My Blog" https://example.com`
+- 指定订阅源添加：`blogwatcher-cli add "My Blog" https://example.com --feed-url https://example.com/feed.xml`
+- 使用 HTML 抓取添加：`blogwatcher-cli add "My Blog" https://example.com --scrape-selector "article h2 a"`
+- 列出已追踪博客：`blogwatcher-cli blogs`
+- 移除博客：`blogwatcher-cli remove "My Blog" --yes`
+- 从 OPML 导入：`blogwatcher-cli import subscriptions.opml`
+
+### 扫描与阅读
+
+- 扫描所有博客：`blogwatcher-cli scan`
+- 扫描单个博客：`blogwatcher-cli scan "My Blog"`
+- 列出未读文章：`blogwatcher-cli articles`
+- 列出所有文章：`blogwatcher-cli articles --all`
+- 按博客筛选：`blogwatcher-cli articles --blog "My Blog"`
+- 按分类筛选：`blogwatcher-cli articles --category "Engineering"`
+- 标记文章为已读：`blogwatcher-cli read 1`
+- 标记文章为未读：`blogwatcher-cli unread 1`
+- 全部标记为已读：`blogwatcher-cli read-all`
+- 标记某博客全部已读：`blogwatcher-cli read-all --blog "My Blog" --yes`
+
+## 环境变量
+
+所有标志均可通过带 `BLOGWATCHER_` 前缀的环境变量设置：
+
+| 变量 | 描述 |
+|---|---|
+| `BLOGWATCHER_DB` | SQLite 数据库文件路径 |
+| `BLOGWATCHER_WORKERS` | 并发扫描 worker 数量（默认：8） |
+| `BLOGWATCHER_SILENT` | 扫描时仅输出"scan done" |
+| `BLOGWATCHER_YES` | 跳过确认提示 |
+| `BLOGWATCHER_CATEGORY` | 按分类筛选文章的默认值 |
+
+## 示例输出
+
+```
+$ blogwatcher-cli blogs
+Tracked blogs (1):
+
+  xkcd
+    URL: https://xkcd.com
+    Feed: https://xkcd.com/atom.xml
+    Last scanned: 2026-04-03 10:30
+```
+
+```
+$ blogwatcher-cli scan
+Scanning 1 blog(s)...
+
+  xkcd
+    Source: RSS | Found: 4 | New: 4
+
+Found 4 new article(s) total!
+```
+
+```
+$ blogwatcher-cli articles
+Unread articles (2):
+
+  [1] [new] Barrel - Part 13
+       Blog: xkcd
+       URL: https://xkcd.com/3095/
+       Published: 2026-04-02
+       Categories: Comics, Science
+
+  [2] [new] Volcano Fact
+       Blog: xkcd
+       URL: https://xkcd.com/3094/
+       Published: 2026-04-01
+       Categories: Comics
+```
+
+## 注意事项
+
+- 未提供 `--feed-url` 时，自动从博客主页发现 RSS/Atom 订阅源。
+- 若 RSS 失败且已配置 `--scrape-selector`，则回退至 HTML 抓取。
+- RSS/Atom 订阅源中的分类会被存储，可用于筛选文章。
+- 支持从 Feedly、Inoreader、NewsBlur 等导出的 OPML 文件批量导入博客。
+- 数据库默认存储于 `~/.blogwatcher-cli/blogwatcher-cli.db`（可通过 `--db` 或 `BLOGWATCHER_DB` 覆盖）。
+- 使用 `blogwatcher-cli <command> --help` 查看所有标志和选项。

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/research/research-llm-wiki.md

@@ -0,0 +1,469 @@
+---
+title: "Llm Wiki — Karpathy 的 LLM Wiki：构建/查询互联 Markdown 知识库"
+sidebar_label: "Llm Wiki"
+description: "Karpathy 的 LLM Wiki：构建/查询互联 Markdown 知识库"
+---
+
+{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
+
+# Llm Wiki
+
+Karpathy 的 LLM Wiki：构建/查询互联 Markdown 知识库。
+
+## Skill 元数据
+
+| | |
+|---|---|
+| 来源 | 内置（默认安装） |
+| 路径 | `skills/research/llm-wiki` |
+| 版本 | `2.1.0` |
+| 作者 | Hermes Agent |
+| 许可证 | MIT |
+| 平台 | linux, macos, windows |
+| 标签 | `wiki`, `knowledge-base`, `research`, `notes`, `markdown`, `rag-alternative` |
+| 相关 skill | [`obsidian`](/user-guide/skills/bundled/note-taking/note-taking-obsidian), [`arxiv`](/user-guide/skills/bundled/research/research-arxiv) |
+
+## 参考：完整 SKILL.md
+
+:::info
+以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 agent 看到的指令内容。
+:::
+
+# Karpathy 的 LLM Wiki
+
+将知识库构建并维护为互联 Markdown 文件，持续积累、复利增长。
+基于 [Andrej Karpathy 的 LLM Wiki 模式](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)。
+
+与传统 RAG（每次查询都从头重新发现知识）不同，wiki 只编译一次知识并保持更新。交叉引用已就位，矛盾已被标记，综合分析反映了所有已摄入的内容。
+
+**分工：** 人类负责筛选来源并指导分析。Agent 负责摘要、交叉引用、归档和维护一致性。
+
+## 此 Skill 的激活时机
+
+当用户执行以下操作时使用此 skill：
+- 要求创建、构建或启动 wiki 或知识库
+- 要求将某个来源摄入（ingest）、添加或处理到 wiki 中
+- 提出问题，且配置路径下已存在 wiki
+- 要求对 wiki 进行 lint、审计或健康检查
+- 在研究场景中提及其 wiki、知识库或"笔记"
+
+## Wiki 位置
+
+**位置：** 通过 `WIKI_PATH` 环境变量设置（例如在 `~/.hermes/.env` 中）。
+
+未设置时，默认为 `~/wiki`。
+
+```bash
+WIKI="${WIKI_PATH:-$HOME/wiki}"
+```
+
+Wiki 只是一个 Markdown 文件目录——可在 Obsidian、VS Code 或任意编辑器中打开。无需数据库，无需特殊工具。
+
+## 架构：三层结构
+
+<!-- ascii-guard-ignore -->
+```
+wiki/
+├── SCHEMA.md           # Conventions, structure rules, domain config
+├── index.md            # Sectioned content catalog with one-line summaries
+├── log.md              # Chronological action log (append-only, rotated yearly)
+├── raw/                # Layer 1: Immutable source material
+│   ├── articles/       # Web articles, clippings
+│   ├── papers/         # PDFs, arxiv papers
+│   ├── transcripts/    # Meeting notes, interviews
+│   └── assets/         # Images, diagrams referenced by sources
+├── entities/           # Layer 2: Entity pages (people, orgs, products, models)
+├── concepts/           # Layer 2: Concept/topic pages
+├── comparisons/        # Layer 2: Side-by-side analyses
+└── queries/            # Layer 2: Filed query results worth keeping
+```
+<!-- ascii-guard-ignore-end -->
+
+**第一层——原始来源：** 不可变。Agent 只读，不修改。
+**第二层——Wiki 正文：** Agent 拥有的 Markdown 文件，由 Agent 创建、更新和交叉引用。
+**第三层——Schema：** `SCHEMA.md` 定义结构、约定和标签分类体系。
+
+## 恢复已有 Wiki（关键——每次会话都必须执行）
+
+当用户已有 wiki 时，**在执行任何操作前务必先定位自身**：
+
+① **读取 `SCHEMA.md`** — 了解领域、约定和标签分类体系。
+② **读取 `index.md`** — 了解已有页面及其摘要。
+③ **扫描近期 `log.md`** — 读取最后 20-30 条记录，了解近期活动。
+
+```bash
+WIKI="${WIKI_PATH:-$HOME/wiki}"
+# Orientation reads at session start
+read_file "$WIKI/SCHEMA.md"
+read_file "$WIKI/index.md"
+read_file "$WIKI/log.md" offset=<last 30 lines>
+```
+
+只有完成定位后，才可进行摄入、查询或 lint 操作。这可以防止：
+- 为已存在的实体创建重复页面
+- 遗漏对已有内容的交叉引用
+- 违反 schema 约定
+- 重复已记录的工作
+
+对于大型 wiki（100+ 页），在创建任何新内容前，还需针对当前主题快速执行 `search_files`。
+
+## 初始化新 Wiki
+
+当用户要求创建或启动 wiki 时：
+
+1. 确定 wiki 路径（从 `$WIKI_PATH` 环境变量获取，或询问用户；默认 `~/wiki`）
+2. 创建上述目录结构
+3. 询问用户 wiki 涵盖的领域——要具体
+4. 编写针对该领域定制的 `SCHEMA.md`（见下方模板）
+5. 编写带分节标题的初始 `index.md`
+6. 编写包含创建条目的初始 `log.md`
+7. 确认 wiki 已就绪，并建议首批摄入来源
+
+### SCHEMA.md 模板
+
+根据用户领域进行调整。Schema 约束 Agent 行为并确保一致性：
+
+```markdown
+# Wiki Schema
+
+## Domain
+[What this wiki covers — e.g., "AI/ML research", "personal health", "startup intelligence"]
+
+## Conventions
+- File names: lowercase, hyphens, no spaces (e.g., `transformer-architecture.md`)
+- Every wiki page starts with YAML frontmatter (see below)
+- Use `[[wikilinks]]` to link between pages (minimum 2 outbound links per page)
+- When updating a page, always bump the `updated` date
+- Every new page must be added to `index.md` under the correct section
+- Every action must be appended to `log.md`
+- **Provenance markers:** On pages that synthesize 3+ sources, append `^[raw/articles/source-file.md]`
+  at the end of paragraphs whose claims come from a specific source. This lets a reader trace each
+  claim back without re-reading the whole raw file. Optional on single-source pages where the
+  `sources:` frontmatter is enough.
+
+## Frontmatter
+  ```yaml
+  ---
+  title: Page Title
+  created: YYYY-MM-DD
+  updated: YYYY-MM-DD
+  type: entity | concept | comparison | query | summary
+  tags: [from taxonomy below]
+  sources: [raw/articles/source-name.md]
+  # Optional quality signals:
+  confidence: high | medium | low        # how well-supported the claims are
+  contested: true                        # set when the page has unresolved contradictions
+  contradictions: [other-page-slug]      # pages this one conflicts with
+  ---
+  ```
+
+`confidence` 和 `contested` 是可选字段，但对于观点性强或快速变化的主题建议填写。Lint 会将 `contested: true` 和 `confidence: low` 的页面标记出来供审查，防止薄弱论断悄然固化为公认的 wiki 事实。
+
+### raw/ Frontmatter
+
+原始来源**同样**需要一个小型 frontmatter 块，以便重新摄入时检测内容漂移：
+
+```yaml
+---
+source_url: https://example.com/article   # original URL, if applicable
+ingested: YYYY-MM-DD
+sha256: &lt;hex digest of the raw content below the frontmatter>
+---
+```
+
+`sha256:` 字段允许未来重新摄入同一 URL 时，在内容未变时跳过处理，在内容已变时标记漂移。仅对正文（frontmatter 结束 `---` 之后的所有内容）计算哈希，不含 frontmatter 本身。
+
+## Tag Taxonomy
+[Define 10-20 top-level tags for the domain. Add new tags here BEFORE using them.]
+
+Example for AI/ML:
+- Models: model, architecture, benchmark, training
+- People/Orgs: person, company, lab, open-source
+- Techniques: optimization, fine-tuning, inference, alignment, data
+- Meta: comparison, timeline, controversy, prediction
+
+Rule: every tag on a page must appear in this taxonomy. If a new tag is needed,
+add it here first, then use it. This prevents tag sprawl.
+
+## Page Thresholds
+- **Create a page** when an entity/concept appears in 2+ sources OR is central to one source
+- **Add to existing page** when a source mentions something already covered
+- **DON'T create a page** for passing mentions, minor details, or things outside the domain
+- **Split a page** when it exceeds ~200 lines — break into sub-topics with cross-links
+- **Archive a page** when its content is fully superseded — move to `_archive/`, remove from index
+
+## Entity Pages
+One page per notable entity. Include:
+- Overview / what it is
+- Key facts and dates
+- Relationships to other entities ([[wikilinks]])
+- Source references
+
+## Concept Pages
+One page per concept or topic. Include:
+- Definition / explanation
+- Current state of knowledge
+- Open questions or debates
+- Related concepts ([[wikilinks]])
+
+## Comparison Pages
+Side-by-side analyses. Include:
+- What is being compared and why
+- Dimensions of comparison (table format preferred)
+- Verdict or synthesis
+- Sources
+
+## Update Policy
+When new information conflicts with existing content:
+1. Check the dates — newer sources generally supersede older ones
+2. If genuinely contradictory, note both positions with dates and sources
+3. Mark the contradiction in frontmatter: `contradictions: [page-name]`
+4. Flag for user review in the lint report
+```
+
+### index.md 模板
+
+索引按类型分节。每条记录为一行：wikilink + 摘要。
+
+```markdown
+# Wiki Index
+
+> Content catalog. Every wiki page listed under its type with a one-line summary.
+> Read this first to find relevant pages for any query.
+> Last updated: YYYY-MM-DD | Total pages: N
+
+## Entities
+<!-- Alphabetical within section -->
+
+## Concepts
+
+## Comparisons
+
+## Queries
+```
+
+**扩展规则：** 当任意分节超过 50 条时，按首字母或子领域拆分为子节。当索引总条目超过 200 时，创建 `_meta/topic-map.md`，按主题对页面分组，以加快导航速度。
+
+### log.md 模板
+
+```markdown
+# Wiki Log
+
+> Chronological record of all wiki actions. Append-only.
+> Format: `## [YYYY-MM-DD] action | subject`
+> Actions: ingest, update, query, lint, create, archive, delete
+> When this file exceeds 500 entries, rotate: rename to log-YYYY.md, start fresh.
+
+## [YYYY-MM-DD] create | Wiki initialized
+- Domain: [domain]
+- Structure created with SCHEMA.md, index.md, log.md
+```
+
+## 核心操作
+
+### 1. 摄入（Ingest）
+
+当用户提供来源（URL、文件、粘贴内容）时，将其整合到 wiki 中：
+
+① **捕获原始来源：**
+   - URL → 使用 `web_extract` 获取 Markdown，保存到 `raw/articles/`
+   - PDF → 使用 `web_extract`（支持 PDF），保存到 `raw/papers/`
+   - 粘贴文本 → 保存到对应的 `raw/` 子目录
+   - 文件名应具有描述性：`raw/articles/karpathy-llm-wiki-2026.md`
+   - **添加 raw frontmatter**（`source_url`、`ingested`、正文的 `sha256`）。
+     重新摄入同一 URL 时：重新计算 sha256，与已存储值比较——相同则跳过，不同则标记漂移并更新。此操作成本极低，每次重新摄入都可执行，能捕获静默的来源变更。
+
+② **与用户讨论要点** — 哪些内容有趣，哪些对领域重要。（自动化/cron 场景下跳过此步，直接继续。）
+
+③ **检查已有内容** — 搜索 index.md，并使用 `search_files` 查找已提及实体/概念的现有页面。这是 wiki 持续增长与变成重复堆砌之间的关键区别。
+
+④ **编写或更新 wiki 页面：**
+   - **新实体/概念：** 仅在满足 SCHEMA.md 中页面阈值时创建页面（2+ 来源提及，或在某一来源中处于核心地位）
+   - **已有页面：** 添加新信息，更新事实，更新 `updated` 日期。新信息与已有内容矛盾时，遵循更新策略。
+   - **交叉引用：** 每个新建或更新的页面必须通过 `[[wikilinks]]` 链接到至少 2 个其他页面。检查已有页面是否有反向链接。
+   - **标签：** 只使用 SCHEMA.md 分类体系中的标签
+   - **来源溯源：** 在综合 3+ 来源的页面上，在论断可追溯到特定来源的段落末尾添加 `^[raw/articles/source.md]` 标记。
+   - **置信度：** 对于观点性强、快速变化或单一来源的论断，在 frontmatter 中设置 `confidence: medium` 或 `low`。除非论断在多个来源中有充分支撑，否则不标记 `high`。
+
+⑤ **更新导航：**
+   - 将新页面按字母顺序添加到 `index.md` 对应分节
+   - 更新 index 头部的"Total pages"计数和"Last updated"日期
+   - 追加到 `log.md`：`## [YYYY-MM-DD] ingest | Source Title`
+   - 在日志条目中列出每个创建或更新的文件
+
+⑥ **报告变更内容** — 向用户列出每个创建或更新的文件。
+
+单个来源可能触发 5-15 个 wiki 页面的更新。这是正常且期望的结果——这正是复利效应。
+
+### 2. 查询（Query）
+
+当用户就 wiki 领域提问时：
+
+① **读取 `index.md`** 以识别相关页面。
+② **对于 100+ 页的 wiki**，还需对所有 `.md` 文件执行 `search_files` 搜索关键词——仅靠索引可能遗漏相关内容。
+③ **读取相关页面**，使用 `read_file`。
+④ **从已编译的知识中综合答案**。引用所参考的 wiki 页面："Based on [[page-a]] and [[page-b]]..."
+⑤ **将有价值的答案归档** — 如果答案是实质性的比较、深度分析或新颖综合，在 `queries/` 或 `comparisons/` 中创建页面。不要归档琐碎的查询——只归档重新推导代价高昂的答案。
+⑥ **更新 log.md**，记录查询内容及是否已归档。
+
+### 3. Lint
+
+当用户要求 lint、健康检查或审计 wiki 时：
+
+① **孤立页面：** 查找没有其他页面通过 `[[wikilinks]]` 指向的页面。
+```python
+# Use execute_code for this — programmatic scan across all wiki pages
+import os, re
+from collections import defaultdict
+wiki = "<WIKI_PATH>"
+# Scan all .md files in entities/, concepts/, comparisons/, queries/
+# Extract all [[wikilinks]] — build inbound link map
+# Pages with zero inbound links are orphans
+```
+
+② **断开的 wikilink：** 查找指向不存在页面的 `[[links]]`。
+
+③ **索引完整性：** 每个 wiki 页面都应出现在 `index.md` 中。对比文件系统与索引条目。
+
+④ **Frontmatter 验证：** 每个 wiki 页面必须包含所有必填字段（title、created、updated、type、tags、sources）。标签必须在分类体系中。
+
+⑤ **过时内容：** `updated` 日期比提及相同实体的最新来源早 90 天以上的页面。
+
+⑥ **矛盾：** 涉及同一主题但论断相互冲突的页面。查找共享标签/实体但陈述不同事实的页面。将所有带有 `contested: true` 或 `contradictions:` frontmatter 的页面标记出来供用户审查。
+
+⑦ **质量信号：** 列出 `confidence: low` 的页面，以及仅引用单一来源但未设置 confidence 字段的页面——这些页面是寻找佐证或降级为 `confidence: medium` 的候选。
+
+⑧ **来源漂移：** 对 `raw/` 中每个带有 `sha256:` frontmatter 的文件，重新计算哈希并标记不匹配项。不匹配表明原始文件被编辑（不应发生——`raw/` 是不可变的）或从已变更的 URL 摄入。不是硬性错误，但值得报告。
+
+⑨ **页面大小：** 标记超过 200 行的页面——拆分候选。
+
+⑩ **标签审计：** 列出所有使用中的标签，标记不在 SCHEMA.md 分类体系中的标签。
+
+⑪ **日志轮转：** 如果 log.md 超过 500 条，进行轮转。
+
+⑫ **报告发现结果**，附具体文件路径和建议操作，按严重程度分组（断开链接 > 孤立页面 > 来源漂移 > 有争议页面 > 过时内容 > 样式问题）。
+
+⑬ **追加到 log.md：** `## [YYYY-MM-DD] lint | N issues found`
+
+## Wiki 使用方法
+
+### 搜索
+
+```bash
+# Find pages by content
+search_files "transformer" path="$WIKI" file_glob="*.md"
+
+# Find pages by filename
+search_files "*.md" target="files" path="$WIKI"
+
+# Find pages by tag
+search_files "tags:.*alignment" path="$WIKI" file_glob="*.md"
+
+# Recent activity
+read_file "$WIKI/log.md" offset=<last 20 lines>
+```
+
+### 批量摄入
+
+同时摄入多个来源时，批量处理更新：
+1. 先读取所有来源
+2. 识别所有来源中的所有实体和概念
+3. 一次性检查所有实体的已有页面（一次搜索，而非 N 次）
+4. 一次性创建/更新页面（避免冗余更新）
+5. 最后统一更新 index.md
+6. 写一条涵盖整批操作的日志条目
+
+### 归档
+
+当内容完全被取代或领域范围发生变化时：
+1. 如不存在则创建 `_archive/` 目录
+2. 将页面移至 `_archive/`，保留原始路径（例如 `_archive/entities/old-page.md`）
+3. 从 `index.md` 中移除
+4. 更新所有链接到该页面的页面——将 wikilink 替换为纯文本 + "（已归档）"
+5. 记录归档操作
+
+### Obsidian 集成
+
+Wiki 目录开箱即用作为 Obsidian vault：
+- `[[wikilinks]]` 渲染为可点击链接
+- 图谱视图可视化知识网络
+- YAML frontmatter 支持 Dataview 查询
+- `raw/assets/` 文件夹存放通过 `![[image.png]]` 引用的图片
+
+最佳实践：
+- 将 Obsidian 的附件文件夹设置为 `raw/assets/`
+- 在 Obsidian 设置中启用"Wikilinks"（通常默认开启）
+- 安装 Dataview 插件，支持如 `TABLE tags FROM "entities" WHERE contains(tags, "company")` 的查询
+
+如果同时使用 Obsidian skill，将 `OBSIDIAN_VAULT_PATH` 设置为与 wiki 路径相同的目录。
+
+### Obsidian 无头模式（服务器和无显示器机器）
+
+在没有显示器的机器上，使用 `obsidian-headless` 代替桌面应用。它通过 Obsidian Sync 同步 vault，无需 GUI——非常适合在服务器上运行、向 wiki 写入内容，同时在另一台设备上用 Obsidian 桌面端读取的 Agent。
+
+**设置：**
+```bash
+# Requires Node.js 22+
+npm install -g obsidian-headless
+
+# Login (requires Obsidian account with Sync subscription)
+ob login --email <email> --password '<password>'
+
+# Create a remote vault for the wiki
+ob sync-create-remote --name "LLM Wiki"
+
+# Connect the wiki directory to the vault
+cd ~/wiki
+ob sync-setup --vault "<vault-id>"
+
+# Initial sync
+ob sync
+
+# Continuous sync (foreground — use systemd for background)
+ob sync --continuous
+```
+
+**通过 systemd 实现持续后台同步：**
+```ini
+# ~/.config/systemd/user/obsidian-wiki-sync.service
+[Unit]
+Description=Obsidian LLM Wiki Sync
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+ExecStart=/path/to/ob sync --continuous
+WorkingDirectory=/home/user/wiki
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=default.target
+```
+
+```bash
+systemctl --user daemon-reload
+systemctl --user enable --now obsidian-wiki-sync
+# Enable linger so sync survives logout:
+sudo loginctl enable-linger $USER
+```
+
+这样 Agent 可以在服务器上向 `~/wiki` 写入内容，同时你在笔记本/手机上的 Obsidian 中浏览同一 vault——变更在数秒内即可同步。
+
+## 注意事项
+
+- **永远不要修改 `raw/` 中的文件** — 来源是不可变的。更正内容写入 wiki 页面。
+- **始终先定位自身** — 在新会话中执行任何操作前，先读取 SCHEMA + index + 近期日志。跳过此步会导致重复和遗漏交叉引用。
+- **始终更新 index.md 和 log.md** — 跳过此步会导致 wiki 退化。这两个文件是导航骨架。
+- **不要为一笔带过的提及创建页面** — 遵循 SCHEMA.md 中的页面阈值。某个名称在脚注中出现一次，不足以创建实体页面。
+- **不要创建没有交叉引用的页面** — 孤立页面是不可见的。每个页面必须链接到至少 2 个其他页面。
+- **Frontmatter 是必填的** — 它支持搜索、过滤和过时检测。
+- **标签必须来自分类体系** — 自由形式的标签会退化为噪音。先在 SCHEMA.md 中添加新标签，再使用。
+- **保持页面可扫描** — wiki 页面应在 30 秒内可读完。超过 200 行的页面应拆分。将详细分析移至专用深度分析页面。
+- **批量更新前先确认** — 如果一次摄入会影响 10+ 个已有页面，先与用户确认范围。
+- **轮转日志** — 当 log.md 超过 500 条时，将其重命名为 `log-YYYY.md` 并重新开始。Agent 应在 lint 期间检查日志大小。
+- **显式处理矛盾** — 不要静默覆盖。注明两种论断及其日期，在 frontmatter 中标记，标记供用户审查。
+
+## 相关工具
+
+[llm-wiki-compiler](https://github.com/atomicmemory/llm-wiki-compiler) 是一个 Node.js CLI，基于相同的 Karpathy 灵感将来源编译为概念 wiki。它兼容 Obsidian，因此希望使用定时/CLI 驱动编译流水线的用户可以将其指向此 skill 维护的同一 vault。权衡：它拥有页面生成的控制权（取代 Agent 在页面创建上的判断），并针对小型语料库进行了调优。当你希望 Agent 参与策划时使用此 skill；当你希望批量编译来源目录时使用 llmwiki。