@baimingtao/lbs-agent 1.0.0

package/extensions/skills/builtin/research/blogwatcher/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: blogwatcher
+description: "通过 blogwatcher-cli 工具监控博客和 RSS/Atom feeds。"
+version: 2.0.0
+author: JulienTant (fork of Hyaxia/blogwatcher)
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [RSS, Blogs, Feed-Reader, Monitoring]
+    homepage: https://github.com/JulienTant/blogwatcher-cli
+prerequisites:
+  commands: [blogwatcher-cli]
+---
+
+# Blogwatcher
+
+使用 `blogwatcher-cli` 工具追踪博客和 RSS/Atom feed 的更新。支持自动发现 feed、回退到 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` 或 volume 挂载来实现持久化：
+
+```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`
+- 指定 feed 添加：`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 feeds。
+- 如果 RSS 失败且配置了 `--scrape-selector`，则回退到 HTML 抓取。
+- 来自 RSS/Atom feeds 的分类会被保存，并可用于过滤文章。
+- 支持从 Feedly、Inoreader、NewsBlur 等导出的 OPML 文件批量导入博客。
+- 数据库默认存储在 `~/.blogwatcher-cli/blogwatcher-cli.db`（使用 `--db` 或 `BLOGWATCHER_DB` 覆盖）。
+- 使用 `blogwatcher-cli <command> --help` 探索所有标志和选项。

package/extensions/skills/builtin/research/llm-wiki/SKILL.md

@@ -0,0 +1,449 @@
+---
+name: llm-wiki
+description: "Karpathy 的 LLM Wiki：构建/查询相互关联的 markdown 知识库。"
+version: 2.1.0
+author: Hermes Agent
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [wiki, knowledge-base, research, notes, markdown, rag-alternative]
+    category: research
+    related_skills: [obsidian, arxiv]
+---
+
+# Karpathy 的 LLM Wiki
+
+构建并维护一个持久的、不断增值的、由相互关联的 markdown 文件组成的知识库。
+基于 [Andrej Karpathy 的 LLM Wiki 模式](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)。
+
+与传统的 RAG（每次查询都从零开始重新发现知识）不同，wiki 将知识编译一次并保持最新。交叉引用已经存在。矛盾已被标记。综合分析反映了所有已摄入的内容。
+
+**分工：** 人类负责筛选来源并指导分析。Agent 负责总结、交叉引用、归档和维护一致性。
+
+## 何时激活此技能
+
+当用户出现以下情况时使用此技能：
+- 要求创建、构建或启动一个 wiki 或知识库
+- 要求将来源摄入、添加或处理到他们的 wiki 中
+- 提出问题，并且在配置的路径中已存在 wiki
+- 要求对其 wiki 进行 lint、审计或健康检查
+- 在研究环境中提及他们的 wiki、知识库或“笔记”
+
+## Wiki 位置
+
+**位置：** 通过 `WIKI_PATH` 环境变量设置（例如在 `${HERMES_HOME:-~/.hermes}/.env` 中）。
+
+如果未设置，默认为 `~/wiki`。
+
+```bash
+WIKI="${WIKI_PATH:-$HOME/wiki}"
+```
+
+这个 wiki 只是一个由 markdown 文件组成的目录——可以在 Obsidian、VS Code 或任何编辑器中打开它。无需数据库，无需特殊工具。
+
+## 架构：三层结构
+
+```
+wiki/
+├── SCHEMA.md           # 约定、结构规则、领域配置
+├── index.md            # 分区内容目录，带有一行摘要
+├── log.md              # 按时间顺序记录的操作日志（仅追加，按年轮换）
+├── raw/                # 第 1 层：不可变的原始素材
+│   ├── articles/       # 网络文章、剪报
+│   ├── papers/         # PDF、arxiv 论文
+│   ├── transcripts/    # 会议记录、访谈
+│   └── assets/         # 来源引用的图像、图表
+├── entities/           # 第 2 层：实体页面（人物、组织、产品、模型）
+├── concepts/           # 第 2 层：概念/主题页面
+├── comparisons/        # 第 2 层：并排分析
+└── queries/            # 第 2 层：值得保存的已归档查询结果
+```
+
+**第 1 层 — 原始来源：** 不可变。Agent 会读取但绝不修改这些内容。
+**第 2 层 — Wiki：** Agent 拥有的 markdown 文件。由 Agent 创建、更新和交叉引用。
+**第 3 层 — Schema：** `SCHEMA.md` 定义了结构、约定和标签分类法。
+
+## 恢复现有 Wiki（关键步骤 — 每次会话都要执行）
+
+当用户拥有现有的 wiki 时，**在做任何事情之前务必先进行定位导航**：
+
+① **阅读 `SCHEMA.md`** — 了解领域、约定和标签分类法。
+② **阅读 `index.md`` — 了解存在哪些页面及其摘要。
+③ **扫描最近的 `log.md`** — 阅读最后 20-30 条记录，了解最近的活动。
+
+```bash
+WIKI="${WIKI_PATH:-$HOME/wiki}"
+# 会话开始时的定位读取
+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
+[本 wiki 涵盖的内容 — 例如，“AI/ML 研究”、“个人健康”、“初创企业情报”]
+
+## Conventions
+- 文件名：小写、连字符、无空格（例如，`transformer-architecture.md`）
+- 每个 wiki 页面均以 YAML frontmatter 开头（见下文）
+- 使用 `[[wikilinks]]` 在页面之间进行链接（每页至少 2 个出站链接）
+- 更新页面时，务必更新 `updated` 日期
+- 每个新页面必须添加到 `index.md` 的正确部分下
+- 每个操作必须追加到 `log.md` 中
+- **Provenance markers：** 在综合了 3 个以上来源的页面上，如果段落的声明来自于特定来源，请在段落末尾追加 `^[raw/articles/source-file.md]`。这允许读者追溯每个声明，而无需重新阅读整个原始文件。在单来源页面上可选，因为 `sources:` frontmatter 已经足够。
+
+## 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        # 声明的支撑程度
+  contested: true                        # 当页面存在未解决的矛盾时设置
+  contradictions: [other-page-slug]      # 与此页面冲突的页面
+  ---
+  ```
+
+对于观点密集或快速变化的主题，`confidence` 和 `contested` 是可选但推荐的。Lint 会展示 `contested: true` 和 `confidence: low` 的页面以供审查，从而防止薄弱的声明悄然固化为已接受的 wiki 事实。
+
+### raw/ Frontmatter
+
+原始来源也会获得一个小的 frontmatter 块，以便重新摄入时能够检测到内容漂移：
+
+```yaml
+---
+source_url: https://example.com/article   # 原始 URL（如果适用）
+ingested: YYYY-MM-DD
+sha256: <hex digest of the raw content below the frontmatter>
+---
+```
+
+`sha256:` 允许将来对同一 URL 进行重新摄入时，在内容未更改时跳过处理，并在内容已更改时标记漂移。仅针对正文（闭合 `---` 之后的所有内容）进行计算，不包含 frontmatter 本身。
+
+## Tag Taxonomy
+[为该领域定义 10-20 个顶层标签。在使用新标签之前先在此处添加。]
+
+示例 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
+
+规则：页面上的每个标签都必须出现在该分类法中。如果需要新标签，请先在此处添加，然后再使用它。这可以防止标签泛滥。
+
+## Page Thresholds
+- **创建页面** 当一个实体/概念出现在 2 个以上的来源中，或是一个来源的核心时
+- **添加到现有页面** 当来源提及了已被涵盖的内容时
+- **不要创建页面** 用于顺带提及、次要细节或领域之外的事物
+- **拆分页面** 当其超过约 200 行时 — 将其拆分为带有交叉链接的子主题
+- **归档页面** 当其内容被完全取代时 — 移动到 `_archive/`，从 index 中移除
+
+## Entity Pages
+每个重要实体一个页面。包括：
+- 概览 / 它是什么
+- 关键事实和日期
+- 与其他实体的关系（`[[wikilinks]]`）
+- 来源参考
+
+## Concept Pages
+每个概念或主题一个页面。包括：
+- 定义 / 解释
+- 知识现状
+- 开放性问题或争议
+- 相关概念（`[[wikilinks]]`）
+
+## Comparison Pages
+并排分析。包括：
+- 比较的对象及原因
+- 比较维度（首选表格格式）
+- 结论或综合分析
+- 来源
+
+## 更新 Policy
+当新信息与现有内容冲突时：
+1. 检查日期 — 较新的来源通常会取代较旧的来源
+2. 如果确实矛盾，请用日期和来源记录双方立场
+3. 在 frontmatter 中标记矛盾：`contradictions: [page-name]`
+4. 在 lint 报告中标记以供用户审查
+```
+
+### index.md 模板
+
+索引按类型分区。每个条目占一行：wikilink + 摘要。
+
+```markdown
+# Wiki Index
+
+> 内容目录。每个 wiki 页面均按其类型列出，并附有一行摘要。
+> 查找任何查询的相关页面时请先阅读此文件。
+> Last updated: YYYY-MM-DD | Total pages: N
+
+## Entities
+<!-- 在该部分内按字母顺序排列 -->
+
+## Concepts
+
+## Comparisons
+
+## Queries
+```
+
+**扩展规则：** 当任何部分的条目超过 50 个时，按首字母或子领域将其拆分为子部分。当索引总数超过 200 个条目时，创建一个 `_meta/topic-map.md` 按主题对页面进行分组，以便更快地进行导航。
+
+### log.md 模板
+
+```markdown
+# Wiki Log
+
+> 所有 wiki 操作的时间顺序记录。仅追加。
+> 格式：`## [YYYY-MM-DD] action | subject`
+> Actions: ingest, update, query, lint, create, archive, delete
+> 当此文件超过 500 个条目时，进行轮换：重命名为 log-YYYY.md，并重新开始。
+
+## [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 中的 Page Thresholds（2 个以上的来源提及，或为一个来源的核心）时才创建页面
+   - **现有页面：** 添加新信息，更新事实，更新 `updated` 日期。
+     当新信息与现有内容矛盾时，遵循“更新 Policy”。
+   - **交叉引用：** 每个新建或更新的页面必须通过 `[[wikilinks]]` 链接到至少 2 个其他页面。检查现有页面是否反向链接。
+   - **标签：** 仅使用 SCHEMA.md 中分类法里的标签
+   - **Provenance：** 在综合了 3 个以上来源的页面上，将 `^[raw/articles/source.md]`
+     标记追加到其声明可追溯到特定来源的段落中。
+   - **Confidence：** 对于观点密集、快速变化或单一来源的声明，在 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
+
+当用户要求对 wiki 进行 lint、健康检查或审计时：
+
+① **孤立页面：** 查找没有来自其他页面的入站 `[[wikilinks]]` 的页面。
+```python
+# 使用 execute_code 执行此操作 — 跨所有 wiki 页面进行程序化扫描
+import os, re
+from collections import defaultdict
+wiki = "<WIKI_PATH>"
+# 扫描 entities/, concepts/, comparisons/, queries/ 中的所有 .md 文件
+# 提取所有 [[wikilinks]] — 构建入站链接映射
+# 零入站链接的页面即为孤立页面
+```
+
+② **损坏的 wikilinks：** 查找指向不存在页面的 `[[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
+# 按内容查找页面
+search_files "transformer" path="$WIKI" file_glob="*.md"
+
+# 按文件名查找页面
+search_files "*.md" target="files" path="$WIKI"
+
+# 按标签查找页面
+search_files "tags:.*alignment" path="$WIKI" file_glob="*.md"
+
+# 最近的活动
+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 替换为纯文本 + “(archived)”
+5. 记录归档操作
+
+### Obsidian 集成
+
+该 wiki 目录可直接作为 Obsidian vault 使用：
+- `[[wikilinks]]` 渲染为可点击的链接
+- Graph View 可可视化知识网络
+- YAML frontmatter 支持 Dataview 查询
+- `raw/assets/` 文件夹保存通过 `![[image.png]]` 引用的图像
+
+为获得最佳效果：
+- 将 Obsidian 的 attachment folder 设置为 `raw/assets/`
+- 在 Obsidian 设置中启用“Wikilinks”（通常默认开启）
+- 安装 Dataview plugin 以进行如下查询：`TABLE tags FROM "entities" WHERE contains(tags, "company")`
+
+如果在执行此技能的同时使用 Obsidian 技能，请将 `OBSIDIAN_VAULT_PATH` 设置为与 wiki 路径相同的目录。
+
+### Obsidian Headless（服务器和无头机器）
+
+在没有显示器的机器上，请使用 `obsidian-headless` 代替桌面应用程序。它无需 GUI 即可通过 Obsidian Sync 同步 vault — 非常适合在服务器上运行写入 wiki 的 agent，同时在另一台设备上由 Obsidian 桌面端读取它。
+
+**配置:**
+```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 + 最近的 log。跳过此步骤会导致重复和遗漏交叉引用。
+- **务必更新 index.md 和 log.md** — 跳过此步骤会使 wiki 退化。这些是导航主干。
+- **不要为顺带提及创建页面** — 遵循 SCHEMA.md 中的 Page Thresholds。一个名字在脚注中出现一次并不值得为其创建一个实体页面。
+- **不要创建没有交叉引用的页面** — 孤立的页面是不可见的。每个页面必须链接到至少 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 驱动编译管道的用户可以将其指向与此技能维护的同一个 vault。权衡：它拥有页面生成权（取代了 agent 对页面创建的判断），并且针对小型语料库进行了调优。当你需要 agent-in-the-loop 策展时使用此技能；当你想要对来源目录进行批量编译时使用 llmwiki。

package/extensions/skills/builtin/research/polymarket/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: polymarket
+description: "查询 Polymarket：市场、价格、订单簿、历史记录。"
+version: 1.0.0
+author: Hermes Agent + Teknium
+tags: [polymarket, prediction-markets, market-data, trading]
+platforms: [linux, macos, windows]
+---
+
+# Polymarket — 预测市场数据
+
+通过 Polymarket 的公共 REST API 查询预测市场数据。
+所有端点均为只读，且无需身份验证。
+
+有关包含 curl 示例的完整端点参考，请参阅 `references/api-endpoints.md`。
+
+## 何时使用
+
+- 用户询问有关预测市场、投注赔率或事件概率的信息
+- 用户想知道“发生 X 的概率是多少？”
+- 用户明确询问 Polymarket
+- 用户想要获取市场价格、订单簿数据或价格历史
+- 用户要求监控或追踪预测市场的动态
+
+## 核心概念
+
+- **Events** 包含一个或多个 **Markets**（一对多关系）
+- **Markets** 是具有 Yes/No 价格（介于 0.00 和 1.00 之间）的二元结果
+- 价格即概率：价格 0.65 意味着市场认为可能性为 65%
+- `outcomePrices` 字段：JSON 编码的数组，例如 `["0.80", "0.20"]`
+- `clobTokenIds` 字段：包含两个代币 ID [Yes, No] 的 JSON 编码数组，用于价格/订单簿查询
+- `conditionId` 字段：用于价格历史查询的十六进制字符串
+- 交易量以 USDC（美元）计价
+
+## 三大公共 API
+
+1. **Gamma API**（位于 `gamma-api.polymarket.com`）— 发现、搜索、浏览
+2. **CLOB API**（位于 `clob.polymarket.com`）— 实时价格、订单簿、历史记录
+3. **Data API**（位于 `data-api.polymarket.com`）— 交易、未平仓量
+
+## 典型工作流
+
+当用户询问预测市场赔率时：
+
+1. 使用 Gamma API 的 public-search 端点根据用户的查询进行**搜索**
+2. **解析**响应 —— 提取 events 及其嵌套的 markets
+3. **展示**市场问题、以百分比表示的当前价格以及交易量
+4. 如有需要，进行**深入分析** —— 使用 clobTokenIds 查询订单簿，使用 conditionId 查询历史记录
+
+## 展示结果
+
+为了提高可读性，将价格格式化为百分比：
+- outcomePrices `["0.652", "0.348"]` 显示为 "Yes: 65.2%, No: 34.8%"
+- 始终展示市场问题和概率
+- 如果有交易量数据，一并展示
+
+示例：`"Will X happen?" — 65.2% Yes ($1.2M volume)`
+
+## 解析双重编码字段
+
+Gamma API 在 JSON 响应中以 JSON 字符串的形式返回 `outcomePrices`、`outcomes` 和 `clobTokenIds`（双重编码）。当使用 Python 处理时，请使用 `json.loads(market['outcomePrices'])` 解析以获取实际数组。
+
+## 速率限制
+
+限制非常宽泛 —— 正常使用情况下不太可能触及限制：
+- Gamma：每 10 秒 4,000 次请求（通用）
+- CLOB：每 10 秒 9,000 次请求（通用）
+- Data：每 10 秒 1,000 次请求（通用）
+
+## 限制
+
+- 此技能为只读 —— 不支持下单交易
+- 交易需要基于钱包的加密身份验证（EIP-712 签名）
+- 部分新市场可能没有价格历史数据
+- 交易受地理限制，但只读数据可在全球范围内访问