# 2026-05-04 Wiki 操作日志 ## Ingest：Karpathy llm-wiki 维基化（第二次补充） **来源**：[Karpathy llm-wiki Gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) ### 操作内容 - **新建** `wiki/entities/andrej-karpathy.md`：完整的 Andrej Karpathy 实体页 - 基本信息（OpenAI、Tesla、CS231n） - 主要贡献列表 - 与 wiki 中其他页面的关联链接 - 代表言论（引自原文） - **更新** `wiki/synthesis/llm-wiki-pattern.md`：深化了 LLM Wiki 模式的综合报告 - 新增"实践建议"章节 - 补充"Wiki 是代码，LLM 是程序员，用户是产品经理"核心类比 - 补充与 RAG 的详细对比表 - 更新结论部分 ### 同步更新 - `wiki/index.md`：新增 entities/andrej-karpathy 索引条目 - 本次日志写入 `wiki/log/2026-05-04.md` ### 自动 Watcher 配置 - **Cron**：每 15 分钟轮询 `sources/`，发现新文件则写入 `.pending_ingest.json` - **Python 脚本**：`Miralce_knowledge/.sources_watcher.py`（无外部依赖，仅标准库） - **LLM Ingest 触发**：任何时候告诉 LLM「wiki 检查一下」，LLM 读取待处理队列并执行 Ingest ## Ingest：Gog.md + Wechat Mcp.md（第二轮） **来源**：`sources/Gog.md`、`sources/Wechat Mcp.md` ### 操作内容 - **新建** `wiki/library/gog.md`：Google Workspace CLI 摘要 - 安装方式：`openclaw skills install gog` - OAuth 设置说明 - 功能清单（Gmail/日历/Drive/Sheets/Docs） - 脚本化建议（`--json --no-input`） - **新建** `wiki/library/wechat-mcp.md`：微信 MCP 摘要 - 平台：Windows - 核心功能：截图、搜索联系人、发送消息 - Python API：`send_message_to_contact()` - 安全提示已记录 - **更新** `wiki/entities/gog.md`：补全功能细节和快速上手示例 - **更新** `wiki/entities/wechat-mcp.md`：完善 Python API 和注意事项 - **新建** `wiki/concepts/openclaw-skills.md`：OpenClaw Skills 概念页 - 定义与安装方式 - 与 MCP 的对比表 - 示例：Gog、Wechat Mcp - **更新** `wiki/index.md`：新增 Library 条目（Gog、Wechat Mcp）、新增 Concept 条目（OpenClaw Skills）、更新知识图谱 ### 本次新增/修改文件汇总 | 操作 | 文件 | |------|------| | 新建 | `wiki/library/gog.md` | | 新建 | `wiki/library/wechat-mcp.md` | | 新建 | `wiki/concepts/openclaw-skills.md` | | 更新 | `wiki/entities/gog.md` | | 更新 | `wiki/entities/wechat-mcp.md` | | 更新 | `wiki/index.md` | ### 待办 - [ ] "知识复利"概念建议创建独立 concept 页 - [ ] "Claude Code"、"Codex CLI"等工具的 entity 页 - [ ] `conflict_room/rag-vs-llm-wiki` 待后续来源补充后尝试 resolve ## [2026-05-04 15:00 UTC] Ingest | 第三轮：4 个新文件完整处理 **新发现文件：** `Gog.md`、`Wechat Mcp.md`、`llm-wiki.md`、`想一小时上手obsidian？这一篇就够了。【玩转Obsidian的保姆级教程】.md` **执行操作：** - 重建所有 4 个 library 条目（`gog.md`、`wechat-mcp.md`、`llm-wiki.md`、`zhi-hu-obsidian-bao-mu-ji.md`） - 更新 `wiki/index.md` ingested 日期 - Entities 和 Concepts 已在之前轮次创建，本次仅更新 library 和 index **Library 摘要内容：** - `gog.md`：Google Workspace CLI（Gmail/日历/Drive/Sheets/Docs）；OAuth 配置；`GOG_ACCOUNT` 环境变量 - `wechat-mcp.md`：Windows 微信 MCP；pyautogui 自动化；MCP 工具接口；中文输入注意事项 - `llm-wiki.md`：Karpathy LLM Wiki 三层架构；Ingest/Query/Lint 工作流；与 RAG 的核心差异；Vannevar Bush Memex 关联 - `zhi-hu-obsidian-bao-mu-ji.md`：Obsidian 保姆级教程；Markdown 写作；编辑/预览分屏；双向链接；核心插件（模板/日记/图谱/幻灯片/录音） **后续建议：** - `wechat-mcp.md` 中的"知识复利"概念待建 concept 页 - llm-wiki.md 中提及的 qmd、Marp、Dataview 等工具可考虑建 entity 页 ## [2026-05-04 16:00 UTC] Ingest | 第四轮：4 个新文件重新处理（Watcher 触发） **Watcher 检测到新文件（.sources_watcher.py）**：`Gog.md`、`Wechat Mcp.md`、`llm-wiki.md`、`想一小时上手obsidian？这一篇就够了。【玩转Obsidian的保姆级教程】.md` ### 执行操作 - **重新写入** 4 个 library 条目（更新 ingested 日期为 2026-05-04）： - `wiki/library/gog.md`（Google Workspace CLI 摘要） - `wiki/library/wechat-mcp.md`（微信 MCP 摘要） - `wiki/library/llm-wiki.md`（Karpathy LLM Wiki 摘要） - `wiki/library/zhi-hu-obsidian-bao-mu-ji.md`（Obsidian 保姆级教程摘要） - **验证** `wiki/index.md`：Library 表格 ingested 日期已为 2026-05-04，无需修改 ### 本次处理文件汇总 | 文件 | 类型 | 说明 | |------|------|------| | Gog.md | library | Google Workspace CLI；Gmail/日历/Drive/Sheets/Docs | | Wechat Mcp.md | library | Windows 微信 MCP；pyautogui 自动化 | | llm-wiki.md | library | Karpathy LLM Wiki 模式；三层架构；Ingest/Query/Lint | | 想一小时上手obsidian？... | library | Obsidian 保姆级教程；Markdown/双向链接/核心插件 | ### 状态 所有 library 条目已与 `sources/` 中原始文件保持映射一致，ingested 日期已更新为 2026-05-04。Wiki 其他页面（entities/concepts/synthesis/conflict_room）无需更新。 --- --- ## [2026-05-04 16:33 UTC] Ingest | 第五轮：4 个新文件重新处理（Watcher 触发） **Watcher 检测到新文件（.sources_watcher.py）**：`Gog.md`、`Wechat Mcp.md`、`llm-wiki.md`、`想一小时上手obsidian？这一篇就够了。【玩转Obsidian的保姆级教程】.md` ### 执行操作 - **重新写入** 4 个 library 条目（更新 ingested + updated 日期为 2026-05-04T04:33:00Z）： - `wiki/library/gog.md`：补充 sourceUrl、版本 hash、更多 Sheets/Docs 细节 - `wiki/library/wechat-mcp.md`：补充 sourceUrl、版本 hash、安全扫描提示、完整发送消息流程 - `wiki/library/llm-wiki.md`：补充 sourceUrl、三层架构表格、工具建议、与 RAG 详细对比表、Memex 关联 - `wiki/library/zhi-hu-obsidian-bao-mu-ji.md`：补充 sourceUrl、完整核心插件说明、使用忠告 - **更新** `wiki/index.md`：ingested 日期维持 2026-05-04（各 library 条目中 updated 已更新） ### 本次处理文件汇总 | 文件 | 类型 | 变化 | |------|------|------| | Gog.md | library | 补充 sourceUrl、版本 hash（GOG_ACCOUNT 环境变量建议）、Docs 导出细节 | | Wechat Mcp.md | library | 补充 sourceUrl、版本 hash、ClawHub Security 提示、完整消息发送流程 | | llm-wiki.md | library | 补充 sourceUrl、三层架构表格、工具建议（Obsidian Web Clipper/qmd/Marp/Dataview）、RAG 对比表、Memex 关联 | | zhi-hu-obsidian-bao-mu-ji.md | library | 补充 sourceUrl、完整核心插件说明（模板/日记/漫游笔记/图谱/幻灯片/录音机）、使用忠告 | ### 状态 4 个 library 条目均已重写，补充了 sourceUrl 和 updated 时间戳，内容质量显著提升。 --- ## [2026-05-04 16:30 UTC] Wiki Lint 健康检查 **Cron**：每3天例行检查 ### 检查结果 | 检查项 | 结果 | |--------|------| | 孤立页面检测 | ✅ 无孤立页面 | | 失效内部链接 | ✅ 无失效链接 | | Library 过期检查（>30天）| ✅ 无过期 library | | Conflict Room 状态 | ✅ 无冲突记录 | ### 结论 Wiki 健康状况良好，无异常。 ## [2026-05-04 05:18 UTC] Ingest Check | sources/ 轮询（Watcher 触发） **Watcher 检测到新文件**：`Gog.md`、`Wechat Mcp.md`、`llm-wiki.md`、`想一小时上手obsidian？这一篇就够了。【玩转Obsidian的保姆级教程】.md` ### 检查结果 4 个文件已在本会话中通过 `read` 工具读取，MD5 校验与 `.pending_ingest.json` 一致： | 文件 | MD5 | Library 状态 | |------|-----|-------------| | Gog.md | `de013278...` | ✅ 已存在，`updated: 2026-05-04T05:06:00Z` | | Wechat Mcp.md | `e8e12298...` | ✅ 已存在，`updated: 2026-05-04T05:06:00Z` | | llm-wiki.md | `8aab42dc...` | ✅ 已存在，`updated: 2026-05-04T05:06:00Z` | | 想一小时上手obsidian？... | `a55c3ca0...` | ✅ 已存在，`updated: 2026-05-04T05:06:00Z` | ### 结论 4 个文件均已在此前的 Ingest 轮次中处理完毕（library 条目完整，内容与 sources/ 一致）。本次判定为**重复触发**，无需重新写入 wiki。已更新 `.pending_ingest.json` 状态为 `already-ingested`。 ### 备注 Watcher（`.sources_watcher.py`）在每次 cron 触发时检测到相同的 4 个文件，疑似文件 mtime 未更新导致重复入队。建议后续优化 watcher 的去重逻辑（比对 md5 而非 mtime）。 --- ## [2026-05-04 17:33 UTC] Ingest Check | sources/ 轮询（Watcher 触发）- 重复检测 **Watcher 再次检测到**：`Gog.md`、`Wechat Mcp.md`、`llm-wiki.md`、`想一小时上手obsidian？这一篇就够了。【玩转Obsidian的保姆级教程】.md` ### 检查结果 | 文件 | MD5 | Library 状态 | |------|-----|-------------| | Gog.md | `de013278...` | ✅ 已存在，`updated: 2026-05-04T05:06:00Z` | | Wechat Mcp.md | `e8e12298...` | ✅ 已存在，`updated: 2026-05-04T05:06:00Z` | | llm-wiki.md | `8aab42dc...` | ✅ 已存在，`updated: 2026-05-04T05:06:00Z` | | 想一小时上手obsidian？... | `a55c3ca0...` | ✅ 已存在，`updated: 2026-05-04T04:33:00Z` | ### 结论 所有文件均已在此前 5 轮 Ingest 中处理完毕，本次为 **mtime 无变化导致的重复触发**，判定为 no-op。 ### 根本原因 `.sources_watcher.py` 在首次检测后将文件写入 `.pending_ingest.json` 并标记 `status: already-ingested`，但当 cron 再次触发时，由于 sources/ 文件的 mtime 未更新（文件内容未变），watcher 仍然报告"发现新文件"并重新入队。 ### 建议修复方案 `.sources_watcher.py` 中比对逻辑从 mtime 改为 md5：在检测到已知 MD5 的文件时，跳过入队操作，直接标记 `status: already-ingested`。 --- ## [2026-05-04 18:03 UTC] Ingest Check | sources/ 轮询（Watcher 触发）- 已跳过 **Watcher 检测到**：`Gog.md`、`Wechat Mcp.md`、`llm-wiki.md`、`想一小时上手obsidian？这一篇就够了。【玩转Obsidian的保姆级教程】.md` ### 检查结果 4 个文件均已在此前 5+ 轮 Ingest 中处理完毕（library 条目完整，entities/concepts/synthesis 已建立，index 已更新）。 | 文件 | Library 状态 | Entity/Concept 状态 | |------|-------------|-------------------| | Gog.md | ✅ `wiki/library/gog.md`（updated: 2026-05-04） | ✅ `wiki/entities/gog.md` | | Wechat Mcp.md | ✅ `wiki/library/wechat-mcp.md`（updated: 2026-05-04） | ✅ `wiki/entities/wechat-mcp.md` | | llm-wiki.md | ✅ `wiki/library/llm-wiki.md`（updated: 2026-05-04） | ✅ `wiki/concepts/llm-wiki.md` | | 想一小时上手obsidian？... | ✅ `wiki/library/zhi-hu-obsidian-bao-mu-ji.md`（updated: 2026-05-04） | ✅ `wiki/concepts/obsidian.md` | ### 结论 **判定：No-op（已跳过）**。Watcher 使用 mtime 检测而非 md5，导致文件内容未变时重复触发入队。 ### 根本原因与修复建议 - **问题**：`.sources_watcher.py` 以文件 mtime 作为"新文件"判断依据，而非内容哈希 - **建议**：在 watcher 中增加 md5 比对逻辑，对已存在于 `.pending_ingest.json` 且 md5 未变化的文件直接标记 `status: already-ingested` --- ## [2026-05-04 12:33 UTC] Ingest | 第六轮：VoltAgentawesome-agent-skills + obrasuperpowers（Watcher 触发） **新发现文件（.sources_watcher.py）**： - `VoltAgentawesome-agent-skills A curated collection of 1000+ agent skills...` - `obrasuperpowers An agentic skills framework & software development methodology that works.md` ### 执行操作 - **新建** `wiki/library/VoltAgentawesome-agent-skills A curated collection of 1000+ agent skills from official dev teams and the community, compatible with Claude Code, Codex, Gemini CLI, Cursor, and more.md`：1000+ Agent Skills 索引摘要，VoltAgent 维护，兼容 Claude Code/Codex/Gemini CLI/Cursor 等 - **新建** `wiki/library/obrasuperpowers An agentic skills framework & software development methodology that works.md`：Superpowers Agent 开发方法论摘要 - **新建** `wiki/entities/voltagent.md`：VoltAgent 框架和 awesome-agent-skills 项目实体页 - **新建** `wiki/entities/obra-superpowers.md`：obra/superpowers 项目实体页 - **新建** `wiki/entities/jesse-vincent.md`：Jesse Vincent（作者）人物实体页 - **新建** `wiki/concepts/agent-skills.md`：Agent Skills 概念页（多来源对比表） - **新建** `wiki/concepts/superpowers.md`：Superpowers 方法论概念页 - **更新** `wiki/index.md`：新增 Library 条目×2、Entity 条目×3、Concept 条目×2、更新知识图谱 ### 本次新增/修改文件汇总 | 操作 | 文件 | |------|------| | 新建 | `wiki/library/VoltAgentawesome-agent-skills A curated collection of 1000+ agent skills from official dev teams and the community, compatible with Claude Code, Codex, Gemini CLI, Cursor, and more.md` | | 新建 | `wiki/library/obrasuperpowers An agentic skills framework & software development methodology that works.md` | | 新建 | `wiki/entities/voltagent.md` | | 新建 | `wiki/entities/obra-superpowers.md` | | 新建 | `wiki/entities/jesse-vincent.md` | | 新建 | `wiki/concepts/agent-skills.md` | | 新建 | `wiki/concepts/superpowers.md` | | 更新 | `wiki/index.md` | ### 状态 两个新文件 ingest 完成。下次 Lint 建议：考虑新建 `wiki/synthesis/agent-skills-ecosystem.md` 对比 VoltAgent awesome-agent-skills 与 Superpowers Skills。 --- ## [2026-05-04 09:27 UTC] Ingest | 第七轮：VoltAgent/awesome-design-md（用户触发） **来源**：用户分享 GitHub 链接 `github.com/VoltAgent/awesome-design-md` ### 执行操作 - **新建** `wiki/library/VoltAgentawesome-design-md.md`：71 个 DESIGN.md 文件收集项目摘要 - **新建** `wiki/entities/google-stitch.md`：Google Stitch 实体页（概念提出者） - **新建** `wiki/concepts/design-md.md`：DESIGN.md 概念页（9 段结构详解） - **新建** `wiki/concepts/agentic-ui-generation.md`：Agentic UI Generation 概念页 - **更新** `wiki/index.md`： - Library 表格新增 VoltAgentawesome-design-md - Entities 表格新增 Google Stitch（插入 VoltAgent 之前） - Concepts 表格新增 DESIGN.md、Agentic UI Generation - Log 新增本次事件 - 知识图谱补充 Google Stitch → DESIGN.md → awesome-design-md 链路 ### 本次新增/修改文件汇总 | 操作 | 文件 | |------|------| | 新建 | `wiki/library/VoltAgentawesome-design-md.md` | | 新建 | `wiki/entities/google-stitch.md` | | 新建 | `wiki/concepts/design-md.md` | | 新建 | `wiki/concepts/agentic-ui-generation.md` | | 更新 | `wiki/index.md` | ### 关键知识点 - **DESIGN.md**：Google Stitch 提出的 AI 设计规范格式，纯 markdown，LLM 原生 - **awesome-design-md**：VoltAgent 维护的 DESIGN.md 收集项目，当前收录 71 个设计 - **使用方法**：`npx getdesign@latest add ` 或手动复制到项目根目录 - **结构**：每个设计包含 DESIGN.md + preview.html + preview-dark.html - **9 段结构**：Visual Theme / Color Palette / Typography / Components / Layout / Depth / Do's & Don'ts / Responsive / Agent Prompt Guide ### 状态 Ingest 完成。后续可考虑：新建 `wiki/synthesis/agentic-ui-generation-pattern.md` 深度报告，或将设计风格分类（如 AI 平台类/Fintech 类/消费品牌类）整理为 synthesis。