lessons.json

[
  {
    "id": "TEMPLATE",
    "title": "<English Title: 4-120 chars>",
    "domain": "<domain>",
    "tags": [
      "tag1",
      "tag2",
      "tag3"
    ],
    "summary": "<!-- What went wrong? What was the symptom? Be specific. -->",
    "url": "lessons/TEMPLATE.md",
    "updated": "<YYYY-MM-DD>"
  },
  {
    "id": "context-compaction-earlier-turns-in-this-convers",
    "title": "CONTEXT COMPACTION] Earlier turns in this convers",
    "domain": "rag",
    "tags": [],
    "summary": "[assistant] <think>",
    "url": "lessons/_archive/context-compaction-earlier-turns-in-this-convers.md",
    "updated": "2026-04-01"
  },
  {
    "id": "context-compaction-reference-only-earlier-turn",
    "title": "CONTEXT COMPACTION — REFERENCE ONLY] Earlier turn",
    "domain": "feishu",
    "tags": [],
    "summary": "[assistant] <think>",
    "url": "lessons/_archive/context-compaction-reference-only-earlier-turn.md",
    "updated": "2026-04-01"
  },
  {
    "id": "config-was-last-written-by-a-newer-openclaw-2026",
    "title": "Config was last written by a newer OpenClaw (2026.",
    "domain": "feishu",
    "tags": [],
    "summary": "[assistant] <think>",
    "url": "lessons/_archive/conversation-dumps/config-was-last-written-by-a-newer-openclaw-2026.md",
    "updated": "2026-04-01"
  },
  {
    "id": "cc-haha-acceptEdits-permission-mode",
    "title": "cc-haha 配置 acceptEdits 权限模式减少确认提示",
    "domain": "agent-medici",
    "tags": [
      "project:agent-medici",
      "severity:low",
      "node:cc_haha"
    ],
    "summary": "cc-haha (Claude Code fork) 默认每次文件编辑和 bash 命令都需要用户确认，导致长任务或自动化场景下频繁中断。",
    "url": "lessons/_archive/hook-raw/cc-haha-acceptEdits-permission-mode.md",
    "updated": "2026-05-12"
  },
  {
    "id": "cc-haha-error-hook",
    "title": "cc-haha PostToolUseFailure 钩子 — Bash 失败时提示 lessons",
    "domain": "devops",
    "tags": [],
    "summary": "cc-haha 的 Bash 工具执行失败时，模型不知道去翻共享 lessons，",
    "url": "lessons/_archive/hook-raw/cc-haha-error-hook.md",
    "updated": "2026-04-30 09:30 UTC"
  },
  {
    "id": "skill-harvest-airtable",
    "title": "Airtable",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `airtable` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-airtable.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-arxiv",
    "title": "Arxiv",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `arxiv` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-arxiv.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-ascii-art",
    "title": "Ascii Art",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `ascii-art` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-ascii-art.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-baoyu-comic",
    "title": "Baoyu Comic",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `baoyu-comic` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-baoyu-comic.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-baoyu-infographic",
    "title": "Baoyu Infographic",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `baoyu-infographic` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-baoyu-infographic.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-ccswitch",
    "title": "Ccswitch",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `ccswitch` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-ccswitch.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-claude-code-proxy-troubleshoot",
    "title": "Claude Code Proxy Troubleshoot",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `claude-code-proxy-troubleshoot` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-claude-code-proxy-troubleshoot.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-claude-design",
    "title": "Claude Design",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `claude-design` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-claude-design.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-comfyui",
    "title": "Comfyui",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `comfyui` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-comfyui.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-debugging-python-bytecode-cache",
    "title": "Debugging Python Bytecode Cache",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `debugging-python-bytecode-cache` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-debugging-python-bytecode-cache.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-edoc-pipeline-retrospective",
    "title": "Edoc Pipeline Retrospective",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `edoc-pipeline-retrospective` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-edoc-pipeline-retrospective.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-edoc-rag",
    "title": "Edoc Rag",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `edoc-rag` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-edoc-rag.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-excalidraw",
    "title": "Excalidraw",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `excalidraw` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-excalidraw.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-google-workspace",
    "title": "Google Workspace",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `google-workspace` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-google-workspace.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-gradio-feedback-panel",
    "title": "Gradio Feedback Panel",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `gradio-feedback-panel` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-gradio-feedback-panel.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-heartmula",
    "title": "Heartmula",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `heartmula` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-heartmula.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-himalaya",
    "title": "Himalaya",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `himalaya` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-himalaya.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-humanizer",
    "title": "Humanizer",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `humanizer` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-humanizer.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-jupyter-live-kernel",
    "title": "Jupyter Live Kernel",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `jupyter-live-kernel` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-jupyter-live-kernel.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-knowledge-base-quality-audit",
    "title": "Knowledge Base Quality Audit",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `knowledge-base-quality-audit` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-knowledge-base-quality-audit.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-linear",
    "title": "Linear",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `linear` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-linear.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-llama-cpp",
    "title": "Llama Cpp",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `llama-cpp` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-llama-cpp.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-manim-video",
    "title": "Manim Video",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `manim-video` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-manim-video.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-minecraft-modpack-server",
    "title": "Minecraft Modpack Server",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `minecraft-modpack-server` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-minecraft-modpack-server.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-native-claude-code-bootstrap-fix",
    "title": "Native Claude Code Bootstrap Fix",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `native-claude-code-bootstrap-fix` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-native-claude-code-bootstrap-fix.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-native-claude-code-wsl-bare-fix",
    "title": "Native Claude Code Wsl Bare Fix",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `native-claude-code-wsl-bare-fix` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-native-claude-code-wsl-bare-fix.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-native-claude-code-wsl-proxy-fix",
    "title": "Native Claude Code Wsl Proxy Fix",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `native-claude-code-wsl-proxy-fix` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-native-claude-code-wsl-proxy-fix.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-native-claude-code-wsl",
    "title": "Native Claude Code Wsl",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `native-claude-code-wsl` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-native-claude-code-wsl.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-node-inspect-debugger",
    "title": "Node Inspect Debugger",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `node-inspect-debugger` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-node-inspect-debugger.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-ocr-and-documents",
    "title": "Ocr And Documents",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `ocr-and-documents` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-ocr-and-documents.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-outlines",
    "title": "Outlines",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `outlines` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-outlines.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-p5js",
    "title": "P5Js",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `p5js` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-p5js.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-pixel-art",
    "title": "Pixel Art",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `pixel-art` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-pixel-art.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-powerpoint",
    "title": "Powerpoint",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `powerpoint` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-powerpoint.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-python-debugpy",
    "title": "Python Debugpy",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `python-debugpy` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-python-debugpy.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-requesting-code-review",
    "title": "Requesting Code Review",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `requesting-code-review` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-requesting-code-review.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-self-grow-wiki-code-review",
    "title": "Self Grow Wiki Code Review",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `self-grow-wiki-code-review` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-self-grow-wiki-code-review.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-self-review",
    "title": "Self Review",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `self-review` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-self-review.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-songsee",
    "title": "Songsee",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `songsee` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-songsee.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-systematic-debugging",
    "title": "Systematic Debugging",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `systematic-debugging` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-systematic-debugging.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-test-driven-development",
    "title": "Test Driven Development",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `test-driven-development` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-test-driven-development.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-vllm",
    "title": "Vllm",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `vllm` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-vllm.md",
    "updated": "2026-05-09"
  },
  {
    "id": "skill-harvest-xurl",
    "title": "Xurl",
    "domain": "uncategorized",
    "tags": [],
    "summary": "（此 lesson 从 skill `xurl` 自动提取，待补全）",
    "url": "lessons/_archive/skill-harvest/skill-harvest-xurl.md",
    "updated": "2026-05-09"
  },
  {
    "id": "system-note-your-previous-turn-was-interrupted-b",
    "title": "system note your previous turn was interrupted b",
    "domain": "general",
    "tags": [],
    "summary": "---",
    "url": "lessons/_archive/system-note-your-previous-turn-was-interrupted-b.md",
    "updated": "2026-04-01"
  },
  {
    "id": "README",
    "title": "README",
    "domain": "uncategorized",
    "tags": [],
    "summary": "Community-contributed knowledge. These lessons are **not yet curated** — they are shared by network nodes as-is. Always ...",
    "url": "lessons/contrib/README.md",
    "updated": ""
  },
  {
    "id": "agent-manual-update-timeout",
    "title": "Agent 手动Update步骤（update Timeout Handling）",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"title\": \"Agent 手动Update步骤（update Timeout Handling）\", \"domain\": \"devops\", \"source\": \"bootstrap\", \"status\": \"draft\", ...",
    "url": "lessons/contrib/agent-manual-update-timeout.md",
    "updated": "2026-05-03"
  },
  {
    "id": "agent-state-database-lock-cleanup",
    "title": "Agent State Database Lock Issues — Cleanup Protocol",
    "domain": "devops",
    "tags": [
      "database",
      "lock",
      "state",
      "cleanup",
      "lesson-written"
    ],
    "summary": "1. Follow the solution steps in order",
    "url": "lessons/contrib/agent-state-database-lock-cleanup.md",
    "updated": "2026-05-16 00:00:00 UTC"
  },
  {
    "id": "agent-write-file-sandbox-worktree-path-breakage",
    "title": "Agent Write File 写入不落地 + Worktree Git 链接路径断裂",
    "domain": "devops",
    "tags": [
      "agent-mode",
      "write-file",
      "worktree",
      "wsl",
      "git",
      "lesson-written"
    ],
    "summary": "在对项目进行代码修改的过程中，使用 Agent 模式操作。操作环境为 WSL (Windows Subsystem for Linux)，仓库使用 worktree 管理。",
    "url": "lessons/contrib/agent-write-file-sandbox-worktree-path-breakage.md",
    "updated": "2026-05-13 01:01:52 UTC"
  },
  {
    "id": "ai-agent-project-outreach-guide",
    "title": "AI Agent Project Outreach Guide",
    "domain": "marketing",
    "tags": [
      "outreach",
      "github",
      "awesome-list",
      "pr",
      "promotion",
      "agent",
      "marketing"
    ],
    "summary": "为 AI Agent 项目（御坂网络）做了一次系统性宣发引流，沉淀了完整的实操流程和平台调研数据。",
    "url": "lessons/contrib/ai-agent-project-outreach-guide.md",
    "updated": "2026-05-11"
  },
  {
    "id": "aily-feishu-mcp-pull-only",
    "title": "aily 飞书 MCP 通道：只能拉取不能推送",
    "domain": "feishu",
    "tags": [],
    "summary": "虫群架构设计时，误以为 aily 飞书侧支持 MCP Server 暴露给 Hub 调用。",
    "url": "lessons/contrib/aily-feishu-mcp-pull-only.md",
    "updated": "2026-05-03"
  },
  {
    "id": "anthropic-proxy-internal-gateway",
    "title": "Internal Gateway — Incompatible with Anthropic Format, Requires OpenAI Proxy",
    "domain": "devops",
    "tags": [],
    "summary": "internal-gateway.local API 端点 (`https://api.internal-gateway.local/v1`) 只接受 OpenAI 格式 (`/v1/chat/compositions`)，不支持 Anth...",
    "url": "lessons/contrib/anthropic-proxy-internal-gateway.md",
    "updated": "2026-04-30 09:00 UTC"
  },
  {
    "id": "api-gateway-anthropic-incompatibility",
    "title": "InternalGateway API 网关不兼容 Anthropic 原生格式",
    "domain": "devops",
    "tags": [
      "project:rag",
      "severity:medium",
      "node:hermes_wsl"
    ],
    "summary": "Hermes Agent 配置 Anthropic provider 使用 internal-gateway.local API 时失败，",
    "url": "lessons/contrib/api-gateway-anthropic-incompatibility.md",
    "updated": "2026-05-03"
  },
  {
    "id": "api-rate-limit-handling-best-practices",
    "title": "API限流Handling最佳实践",
    "domain": "devops",
    "tags": [
      "api",
      "rate-limit",
      "backoff",
      "batch"
    ],
    "summary": "---{\"title\": \"API限流Handling最佳实践\", \"domain\": \"devops\", \"tags\": [\"api\", \"rate-limit\", \"backoff\", \"batch\"]}---",
    "url": "lessons/contrib/api-rate-limit-handling-best-practices.md",
    "updated": ""
  },
  {
    "id": "api-rate-limit-handling",
    "title": "API 请求限流 (Rate Limit) Handling方案",
    "domain": "devops",
    "tags": [
      "api",
      "rate-limit",
      "retry",
      "429"
    ],
    "summary": "---{\"title\": \"API 请求限流 (Rate Limit) Handling方案\", \"domain\": \"devops\", \"tags\": [\"api\", \"rate-limit\", \"retry\", \"429\"]}---",
    "url": "lessons/contrib/api-rate-limit-handling.md",
    "updated": ""
  },
  {
    "id": "audit-sampling-stratified-sampling-for-kb-inspection",
    "title": "巡检题库分层抽样策略",
    "domain": "rag",
    "tags": [
      "rag",
      "audit",
      "sampling",
      "quality",
      "test-bank"
    ],
    "summary": "RAG 知识库质量巡检需要每天抽取少量题目进行自动测试。如果随机抽样，容易连续抽到同一类型的问题（如连续三天都是报警代码题），漏掉其他分类的质量退化。",
    "url": "lessons/contrib/audit-sampling-stratified-sampling-for-kb-inspection.md",
    "updated": "2026-05-21"
  },
  {
    "id": "bge-embedding-fallback-crash",
    "title": "BGE embedding 模型需要降级 fallback 避免启动崩溃",
    "domain": "rag",
    "tags": [
      "project:agent-medici",
      "severity:high",
      "node:hermes_wsl"
    ],
    "summary": "HermesHub 启动时如果 BGE-m3 模型未下载到本地路径，SkillIndexer 直接崩溃。",
    "url": "lessons/contrib/bge-embedding-fallback-crash.md",
    "updated": "2026-05-03"
  },
  {
    "id": "browser-harness-cdp-browser-automation",
    "title": "browser-harness — AI 直连 Chrome 的 CDP 浏览器Automation",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"title\": \"browser-harness — AI 直连 Chrome 的 CDP 浏览器Automation\", \"domain\": \"devops\", \"source\": \"skill-harvest\", \"statu...",
    "url": "lessons/contrib/browser-harness-cdp-browser-automation.md",
    "updated": "2026-05-20"
  },
  {
    "id": "cc-connect-feishu-display-optimization",
    "title": "cc-connect 飞书显示Optimization：禁用工具调用和上下文提示",
    "domain": "feishu",
    "tags": [],
    "summary": "---{\"title\": \"cc-connect 飞书显示Optimization：禁用工具调用和上下文提示\", \"domain\": \"feishu\", \"subdomain\": \"cc-connect\", \"source\": \"boots...",
    "url": "lessons/contrib/cc-connect-feishu-display-optimization.md",
    "updated": "2026-05-19"
  },
  {
    "id": "cc-connect-feishu-setup-complete",
    "title": "cc-connect 飞书机器人完整SetupGuide",
    "domain": "feishu",
    "tags": [],
    "summary": "---{\"title\": \"cc-connect 飞书机器人完整SetupGuide\", \"domain\": \"feishu\", \"subdomain\": \"cc-connect\", \"source\": \"bootstrap\", \"stat...",
    "url": "lessons/contrib/cc-connect-feishu-setup-complete.md",
    "updated": "2026-05-19"
  },
  {
    "id": "ccswitch-hermes-switch",
    "title": "ccswitch-hermes-switch 踩坑Notes",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"confidence\": \"0.7\", \"created\": \"2026-05-02\", \"domain\": \"devops\", \"source\": \"bootstrap\", \"status\": \"draft\", \"tags\": ...",
    "url": "lessons/contrib/ccswitch-hermes-switch.md",
    "updated": "2026-05-02"
  },
  {
    "id": "chroma-rebuild-no-checkpoint-cn",
    "title": "Chroma 建库无 Checkpoint — 进程一死全部丢失",
    "domain": "rag",
    "tags": [],
    "summary": "Agent 内跑 BGE-large-zh 建库（约30分钟），Gateway 重启后整个数据库为空，0条向量入库。",
    "url": "lessons/contrib/chroma-rebuild-no-checkpoint-cn.md",
    "updated": "2026-04-01"
  },
  {
    "id": "chroma-rebuild-no-checkpoint",
    "title": "Chroma 建库无 Checkpoint — 进程一死全部丢失",
    "domain": "rag",
    "tags": [],
    "summary": "Agent 内跑 BGE-large-zh 建库（约30分钟），Gateway 重启后整个数据库为空，0条向量入库。",
    "url": "lessons/contrib/chroma-rebuild-no-checkpoint.md",
    "updated": "2026-04-01"
  },
  {
    "id": "chrome-relay-browser-automation",
    "title": "Chrome Relay 浏览器Automation — CDP over WebSocket 控制无头浏览器",
    "domain": "development",
    "tags": [
      "chrome",
      "browser",
      "automation",
      "cdp",
      "websocket",
      "openclaw"
    ],
    "summary": "---{\"title\": \"Chrome Relay 浏览器Automation — CDP over WebSocket 控制无头浏览器\", \"domain\": \"development\", \"tags\": [\"chrome\", \"bro...",
    "url": "lessons/contrib/chrome-relay-browser-automation.md",
    "updated": ""
  },
  {
    "id": "ci-dco-decouple-pythonpath-fork-pr",
    "title": "GitHub Actions CI for AI Agent PRs — DCO decoupling & PYTHONPATH fix",
    "domain": "devops",
    "tags": [
      "github-actions",
      "ci",
      "dco",
      "python",
      "ai-agent",
      "fork-pr",
      "pytest",
      "coverage"
    ],
    "summary": "---{\"title\": \"GitHub Actions CI for AI Agent PRs — DCO decoupling & PYTHONPATH fix\", \"domain\": \"devops\", \"tags\": [\"githu...",
    "url": "lessons/contrib/ci-dco-decouple-pythonpath-fork-pr.md",
    "updated": "2026-06-12 00:00:00 UTC"
  },
  {
    "id": "cloudflare-email-worker-registration-trap",
    "title": "Cloudflare Email Worker 邮件注册踩坑Notes — message.raw、MIME 与 SPF",
    "domain": "devops",
    "tags": [
      "cloudflare",
      "email-worker",
      "kv",
      "turnstile",
      "registration",
      "spf"
    ],
    "summary": "---{\"title\": \"Cloudflare Email Worker 邮件注册踩坑Notes — message.raw、MIME 与 SPF\", \"domain\": \"devops\", \"tags\": [\"cloudflare\", ...",
    "url": "lessons/contrib/cloudflare-email-worker-registration-trap.md",
    "updated": ""
  },
  {
    "id": "codewhale-git-push-yolo-task",
    "title": "CodeWhale 中 git push 的正确方式 — YOLO task + gh CLI",
    "domain": "devops",
    "tags": [
      "codewhale",
      "git",
      "yolo",
      "push",
      "lesson"
    ],
    "summary": "在 CodeWhale 的 Agent 模式中，`exec_shell` 工具不可用。需要执行 `git push` 时，不能直接用 shell 命令。",
    "url": "lessons/contrib/codewhale-git-push-yolo-task.md",
    "updated": ""
  },
  {
    "id": "cron-job-not-running",
    "title": "Cron 作业不执行 / 不生效排障",
    "domain": "devops",
    "tags": [
      "cron",
      "scheduler",
      "not-running",
      "debug"
    ],
    "summary": "`crontab -e` 设置好后，作业从未执行。输出没有、日志没有、进程没有。",
    "url": "lessons/contrib/cron-job-not-running.md",
    "updated": ""
  },
  {
    "id": "curl-request-troubleshoot",
    "title": "curl / wget 请求失败通用Diagnosis",
    "domain": "devops",
    "tags": [
      "network",
      "curl",
      "wget",
      "debug",
      "troubleshoot"
    ],
    "summary": "---{\"title\": \"curl / wget 请求失败通用Diagnosis\", \"domain\": \"devops\", \"tags\": [\"network\", \"curl\", \"wget\", \"debug\", \"troublesho...",
    "url": "lessons/contrib/curl-request-troubleshoot.md",
    "updated": ""
  },
  {
    "id": "deepseek-tui-write-file-sandbox-worktree-git-path",
    "title": "DeepSeek TUI — write_file Sandbox + Worktree Git Path Breakage",
    "domain": "devops",
    "tags": [
      "deepseek-tui",
      "agent-mode",
      "write-file",
      "worktree",
      "wsl",
      "git",
      "lesson-written"
    ],
    "summary": "在 Agent-Medici 项目的 search_knowledge.py v2 升级过程中，使用 DeepSeek TUI Agent 模式进行代码修改。操作环境为 WSL (Windows Subsystem for Linux)，仓...",
    "url": "lessons/contrib/deepseek-tui-write-file-sandbox-worktree-git-path.md",
    "updated": "2026-05-13 01:01:46 UTC"
  },
  {
    "id": "disk-space-cleanup",
    "title": "磁盘空间不足 / chroma_db_v4 CacheCleanup",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"created\": \"2026-05-01 08:00 UTC\", \"domain\": \"devops\", \"source\": \"hermes_wsl\", \"status\": \"published\", \"tags\": \"\", \"t...",
    "url": "lessons/contrib/disk-space-cleanup.md",
    "updated": "2026-05-01 08:00 UTC"
  },
  {
    "id": "fanuc-kl-err-abort-vs-err-pause",
    "title": "FANUC KL: ERR_ABORT vs ERR_PAUSE 行为差异",
    "domain": "fanuc",
    "tags": [],
    "summary": "IPC 通信错误时未区分 ERR_ABORT 和 ERR_PAUSE，导致程序号丢失。",
    "url": "lessons/contrib/fanuc-kl-err-abort-vs-err-pause.md",
    "updated": "2026-05-03"
  },
  {
    "id": "fanuc-kl-mm-module-h-no-routine",
    "title": "FANUC KL: mm_module_h.kl 禁止 ROUTINE 声明",
    "domain": "fanuc",
    "tags": [],
    "summary": "mm_module_h.kl（头文件）末尾有 `ROUTINE Check_Status(params) FROM MM_MODULE`（带参数版），导致 MM_MODULE.kl 中同名 routine 报\"already defined...",
    "url": "lessons/contrib/fanuc-kl-mm-module-h-no-routine.md",
    "updated": "2026-05-03"
  },
  {
    "id": "fanuc-r-2000ic-retrieval-fix",
    "title": "FANUC R-2000iC 检索混淆Fix — 关键词强制召回",
    "domain": "rag",
    "tags": [],
    "summary": "---{\"created\": \"2026-04-30 08:50 UTC\", \"domain\": \"rag\", \"source\": \"hermes_wsl\", \"status\": \"published\", \"tags\": \"\", \"titl...",
    "url": "lessons/contrib/fanuc-r-2000ic-retrieval-fix.md",
    "updated": "2026-04-30 08:50 UTC"
  },
  {
    "id": "feishu-agent-display-settings",
    "title": "飞书 Agent 显示Optimization：禁用工具调用和上下文提示",
    "domain": "feishu",
    "tags": [],
    "summary": "---{\"title\": \"飞书 Agent 显示Optimization：禁用工具调用和上下文提示\", \"domain\": \"feishu\", \"source\": \"bootstrap\", \"status\": \"published\", \"...",
    "url": "lessons/contrib/feishu-agent-display-settings.md",
    "updated": "2026-05-19"
  },
  {
    "id": "feishu-block-api-false-success",
    "title": "飞书 Block API 假成功特征",
    "domain": "feishu",
    "tags": [],
    "summary": "调用飞书 block API 时，限流场景下返回 `code=0` 但 `blocks_created=0`，看似成功实际失败。",
    "url": "lessons/contrib/feishu-block-api-false-success.md",
    "updated": "2026-05-03"
  },
  {
    "id": "feishu-block-batch-limit",
    "title": "飞书 Block Batch写入上限",
    "domain": "feishu",
    "tags": [],
    "summary": "---{\"title\": \"飞书 Block Batch写入上限\", \"domain\": \"feishu\", \"subdomain\": \"block-api\", \"source\": \"bootstrap\", \"status\": \"draft...",
    "url": "lessons/contrib/feishu-block-batch-limit.md",
    "updated": "2026-05-03"
  },
  {
    "id": "feishu-block-type-values-limits",
    "title": "飞书 Block Type 正确值与已知Limit",
    "domain": "feishu",
    "tags": [],
    "summary": "---{\"title\": \"飞书 Block Type 正确值与已知Limit\", \"domain\": \"feishu\", \"subdomain\": \"block-api\", \"source\": \"bootstrap\", \"status\":...",
    "url": "lessons/contrib/feishu-block-type-values-limits.md",
    "updated": "2026-05-03"
  },
  {
    "id": "feishu-bot-setup-complete",
    "title": "飞书机器人完整SetupGuide",
    "domain": "feishu",
    "tags": [],
    "summary": "---{\"title\": \"飞书机器人完整SetupGuide\", \"domain\": \"feishu\", \"source\": \"bootstrap\", \"status\": \"published\", \"confidence\": \"0.95\"...",
    "url": "lessons/contrib/feishu-bot-setup-complete.md",
    "updated": "2026-05-19"
  },
  {
    "id": "feishu-doc-url-use-api-return",
    "title": "Feishu 文档 URL：必须用 API 返回值，不要拼接",
    "domain": "feishu",
    "tags": [],
    "summary": "创建 Feishu 云文档后，猜测 URL 格式为 `https://feishu.cn/document/...`，用户连续3次无法打开文档。",
    "url": "lessons/contrib/feishu-doc-url-use-api-return.md",
    "updated": "2026-03-29"
  },
  {
    "id": "feishu-markdown-table-not-rendered",
    "title": "飞书 post Messaging中 Markdown 表格不渲染",
    "domain": "development",
    "tags": [
      "feishu",
      "markdown",
      "table",
      "post",
      "lark"
    ],
    "summary": "---{\"title\": \"飞书 post Messaging中 Markdown 表格不渲染\", \"domain\": \"development\", \"source\": \"Misaka10019\", \"tags\": [\"feishu\", \"...",
    "url": "lessons/contrib/feishu-markdown-table-not-rendered.md",
    "updated": ""
  },
  {
    "id": "feishu-mcp-server-deepseek-tui-setup",
    "title": "DeepSeek TUI — Feishu MCP Server Setup & Permission Boundaries",
    "domain": "feishu",
    "tags": [
      "feishu",
      "mcp",
      "deepseek",
      "docx-api",
      "permissions"
    ],
    "summary": "需要在 DeepSeek TUI 中在线操作飞书云文档（docx），通过 MCP 协议暴露飞书 API。",
    "url": "lessons/contrib/feishu-mcp-server-deepseek-tui-setup.md",
    "updated": "2026-05-19"
  },
  {
    "id": "feishu-upload-file-type-opus",
    "title": "Feishu 文件上传：file_type 必须用 opus",
    "domain": "feishu",
    "tags": [],
    "summary": "Feishu `im/v1/files` 上传接口调用失败，返回 `234001 Invalid request param`。",
    "url": "lessons/contrib/feishu-upload-file-type-opus.md",
    "updated": "2026-03-29"
  },
  {
    "id": "feishu-webhook-url-env-config",
    "title": "飞书 webhook URL 必须用环境变量或 gitignored 的 config.yaml",
    "domain": "devops",
    "tags": [
      "project:agent-medici",
      "severity:critical",
      "node:hermes_wsl"
    ],
    "summary": "Feishu webhook URL、app_id、app_secret 被误提交到 git 仓库，",
    "url": "lessons/contrib/feishu-webhook-url-env-config.md",
    "updated": "2026-05-03"
  },
  {
    "id": "feishu-websocket-404-error-http-webhook-required",
    "title": "Feishu WebSocket 404 Error - HTTP Webhook Required",
    "domain": "feishu-integration",
    "tags": [],
    "summary": "问题: 飞书 WebSocket 接收消息 API 返回 404 错误。测试端点: wss://open.feishu.cn/open-apis/bot/v3/ws, /bot/v2/ws, /im/v1/ws, /im/v2/ws, /w...",
    "url": "lessons/contrib/feishu-websocket-404-error-http-webhook-required.md",
    "updated": "2026-05-19 01:19:29 UTC"
  },
  {
    "id": "feishu-wiki-batch-download",
    "title": "Feishu WikiBatch Download：文件类型Handling策略",
    "domain": "devops",
    "tags": [
      "feishu, wiki, batch-download, file-type, pdf, docx, safari"
    ],
    "summary": "---{\"title\": \"Feishu WikiBatch Download：文件类型Handling策略\", \"domain\": \"devops\", \"tags\": \"feishu, wiki, batch-download, file...",
    "url": "lessons/contrib/feishu-wiki-batch-download.md",
    "updated": "2026-05-19 15:40:11 UTC"
  },
  {
    "id": "ffmpeg-audio-libopus-not-ogg",
    "title": "FFmpeg 音频转码：必须用 libopus 而非 -format ogg",
    "domain": "audio",
    "tags": [],
    "summary": "FFmpeg 输出 OGG 文件为 0 字节。",
    "url": "lessons/contrib/ffmpeg-audio-libopus-not-ogg.md",
    "updated": "2026-03-29"
  },
  {
    "id": "firewall-port-open-not-public",
    "title": "防火墙端口开放不等于内网穿透",
    "domain": "devops",
    "tags": [
      "project:rag",
      "platform:wsl",
      "node:hermes_wsl",
      "scope:broad"
    ],
    "summary": "为 wcferry 开放 Windows 防火墙端口 10086 时，误以为这是\"内网穿透\"操作，担心安全性。",
    "url": "lessons/contrib/firewall-port-open-not-public.md",
    "updated": "2026-05-03"
  },
  {
    "id": "game-mcp-end-turn-conflict-409",
    "title": "Game MCP: End Turn Returns 409 Conflict",
    "domain": "mcp",
    "tags": [],
    "summary": "When sending an end_turn command via MCP, the game returns a 409 Conflict HTTP status. However, the game state still pro...",
    "url": "lessons/contrib/game-mcp-end-turn-conflict-409.md",
    "updated": ""
  },
  {
    "id": "game-mcp-game-over-restart-flow",
    "title": "Game MCP: GAME OVER Restart Flow",
    "domain": "mcp",
    "tags": [],
    "summary": "After reaching a GAME OVER state, restarting the game via MCP requires a specific sequence of commands. Using the wrong ...",
    "url": "lessons/contrib/game-mcp-game-over-restart-flow.md",
    "updated": ""
  },
  {
    "id": "game-mcp-rare-relic-freeze",
    "title": "Game MCP: Rare Relic Selection Freeze",
    "domain": "mcp",
    "tags": [],
    "summary": "When using MCP to play a turn-based strategy game, selecting a rare relic option causes the game client to freeze or han...",
    "url": "lessons/contrib/game-mcp-rare-relic-freeze.md",
    "updated": ""
  },
  {
    "id": "gateway-hang-watchdog-recovery",
    "title": "Gateway 进程挂死未崩溃 — watchdog 自动Recovery",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"title\": \"Gateway 进程挂死未崩溃 — watchdog 自动Recovery\", \"domain\": \"devops\", \"source\": \"bootstrap\", \"status\": \"published\", ...",
    "url": "lessons/contrib/gateway-hang-watchdog-recovery.md",
    "updated": "2026-04-01"
  },
  {
    "id": "git-credential-helper-gh-path-mismatch",
    "title": "gh credential helper 路径Error导致 git push 静默失败",
    "domain": "devops",
    "tags": [
      "git",
      "github",
      "credential",
      "gh",
      "auth",
      "push"
    ],
    "summary": "---{\"title\": \"gh credential helper 路径Error导致 git push 静默失败\", \"domain\": \"devops\", \"tags\": [\"git\", \"github\", \"credential\",...",
    "url": "lessons/contrib/git-credential-helper-gh-path-mismatch.md",
    "updated": ""
  },
  {
    "id": "git-credentials-and-node-id-setup",
    "title": "Git Credentials 和 Node ID Setup",
    "domain": "devops",
    "tags": [
      "git",
      "credentials",
      "node-id",
      "setup"
    ],
    "summary": "---{\"title\": \"Git Credentials 和 Node ID Setup\", \"domain\": \"devops\", \"source\": \"hermes_wsl2\", \"status\": \"published\", \"tag...",
    "url": "lessons/contrib/git-credentials-and-node-id-setup.md",
    "updated": ""
  },
  {
    "id": "git-credentials-automation",
    "title": "Git 凭证Setup — Automation push 免密码",
    "domain": "devops",
    "tags": [
      "git",
      "credentials",
      "auth",
      "github"
    ],
    "summary": "---{\"title\": \"Git 凭证Setup — Automation push 免密码\", \"domain\": \"devops\", \"tags\": [\"git\", \"credentials\", \"auth\", \"github\"]}-...",
    "url": "lessons/contrib/git-credentials-automation.md",
    "updated": ""
  },
  {
    "id": "git-merge-conflict-resolution",
    "title": "Git 合并ConflictHandling — 手动解决最佳实践",
    "domain": "development",
    "tags": [
      "git",
      "merge",
      "conflict",
      "rebase"
    ],
    "summary": "---{\"title\": \"Git 合并ConflictHandling — 手动解决最佳实践\", \"domain\": \"development\", \"tags\": [\"git\", \"merge\", \"conflict\", \"rebase\"...",
    "url": "lessons/contrib/git-merge-conflict-resolution.md",
    "updated": ""
  },
  {
    "id": "git-push-without-shell-agent",
    "title": "Git Push 的正确方式 — 在受限 Agent 环境中推送代码",
    "domain": "devops",
    "tags": [
      "git",
      "push",
      "agent",
      "gh-cli",
      "lesson"
    ],
    "summary": "在某些 Agent 平台的安全模式下，shell 工具不可用。需要执行 `git push` 时，不能直接用 shell 命令。",
    "url": "lessons/contrib/git-push-without-shell-agent.md",
    "updated": ""
  },
  {
    "id": "git-tls-handshake-failure",
    "title": "GitHub TLS 握手失败 — gnutls_handshake() Error",
    "domain": "devops",
    "tags": [
      "git",
      "github",
      "TLS",
      "SSL",
      "network"
    ],
    "summary": "---{\"title\": \"GitHub TLS 握手失败 — gnutls_handshake() Error\", \"domain\": \"devops\", \"tags\": [\"git\", \"github\", \"TLS\", \"SSL\", \"...",
    "url": "lessons/contrib/git-tls-handshake-failure.md",
    "updated": ""
  },
  {
    "id": "github-401-credential-lookup",
    "title": "GitHub API 401 后本地凭证查找顺序",
    "domain": "devops",
    "tags": [
      "github",
      "api",
      "credential",
      "401",
      "auth",
      "pat"
    ],
    "summary": "调用 GitHub API 时收到 `{\"message\": \"Bad credentials\"}` 或 HTTP 401/403，第一反应是 token 无效要去问用户要新的。但本地往往已经有可用凭证，跳过检查会让用户白跑一趟。",
    "url": "lessons/contrib/github-401-credential-lookup.md",
    "updated": ""
  },
  {
    "id": "github-dns-443-block-hosts-workaround",
    "title": "GitHub DNS 污染/443端口不通 — hosts 备用 IP 方案",
    "domain": "devops",
    "tags": [
      "git",
      "github",
      "TLS",
      "network",
      "DNS",
      "hosts",
      "connectivity"
    ],
    "summary": "`git push` / `git fetch` 持续超时或报 TLS 握手错误：",
    "url": "lessons/contrib/github-dns-443-block-hosts-workaround.md",
    "updated": ""
  },
  {
    "id": "gpt-sovits-hubert-16khz",
    "title": "GPT-SoVITS：HuBERT 必须 16kHz 且 get_model() 返回单体",
    "domain": "tts",
    "tags": [],
    "summary": "HuBERT SSL 特征提取失败，音频克隆效果异常。",
    "url": "lessons/contrib/gpt-sovits-hubert-16khz.md",
    "updated": "2026-04-05"
  },
  {
    "id": "gpt-sovits-name2text-arpabet",
    "title": "GPT-SoVITS 训练：2-name2text 格式必须用 ARPABET 音素而非中文原文",
    "domain": "tts",
    "tags": [],
    "summary": "训练时数据加载器逐字查 phoneme 词典，全部 KeyError。",
    "url": "lessons/contrib/gpt-sovits-name2text-arpabet.md",
    "updated": "2026-04-06"
  },
  {
    "id": "gpt-sovits-ref-free-bug",
    "title": "GPT-SoVITS：ref_free bug——prompt_text 为空时参数被覆盖",
    "domain": "tts",
    "tags": [],
    "summary": "提供了女声样本，生成出来却是男声或通用音色。",
    "url": "lessons/contrib/gpt-sovits-ref-free-bug.md",
    "updated": "2026-04-06"
  },
  {
    "id": "hub-credential-gateway-vs-hub",
    "title": "Hub Hermes 凭证体系 — Gateway vs Hub 各自读哪里",
    "domain": "devops",
    "tags": [],
    "summary": "Hub 有两套配置体系，Gateway 和 Hub 读取不同的凭证位置，容易混淆。",
    "url": "lessons/contrib/hub-credential-gateway-vs-hub.md",
    "updated": "2026-04-01"
  },
  {
    "id": "hub-feishu-wsclient-start-never-called",
    "title": "Hub FeishuWSClient.start() 从未调用 — WebSocket 接收死代码",
    "domain": "feishu",
    "tags": [],
    "summary": "Hub 配置了 `im.message.receive_v1` 和 `p2p_card_action.trigger` 回调，但从未收到飞书消息。",
    "url": "lessons/contrib/hub-feishu-wsclient-start-never-called.md",
    "updated": "2026-04-01"
  },
  {
    "id": "issue-comment-newbie-welcome",
    "title": "Auto-Welcome Newcomers via issue_comment Event",
    "domain": "devops",
    "tags": [
      "github-actions",
      "ci",
      "community",
      "newbie",
      "good-first-issue",
      "automation"
    ],
    "summary": "开源项目设置 Good First Issues 后，新手贡献者往往不知道如何开始。需要一种自动化的方式在贡献者评论 Issue 时立即给予引导。",
    "url": "lessons/contrib/issue-comment-newbie-welcome.md",
    "updated": "2026-06-12 00:00:00 UTC"
  },
  {
    "id": "js-dead-code-chain-break",
    "title": "JavaScript 执行链断裂：一个未捕获 TypeError 如何让整个页面静默失效",
    "domain": "frontend",
    "tags": [
      "js",
      "runtime",
      "typeerror",
      "execution-model",
      "defensive"
    ],
    "summary": "JavaScript 是单线程事件驱动模型。同步执行线程中任何一个未捕获的异常（TypeError、ReferenceError 等）都会导致**整个执行线程中断**，该线程后续所有代码不再执行。常见场景：",
    "url": "lessons/contrib/js-dead-code-chain-break.md",
    "updated": ""
  },
  {
    "id": "json-parse-failure-handling",
    "title": "JSON 解析失败Handling — 截断 / 格式Error",
    "domain": "devops",
    "tags": [
      "json",
      "parse",
      "truncated",
      "llm",
      "output"
    ],
    "summary": "---{\"title\": \"JSON 解析失败Handling — 截断 / 格式Error\", \"domain\": \"devops\", \"tags\": [\"json\", \"parse\", \"truncated\", \"llm\", \"outp...",
    "url": "lessons/contrib/json-parse-failure-handling.md",
    "updated": ""
  },
  {
    "id": "kb-4sigma-quality-audit-pipeline",
    "title": "知识库 4σ 质量审计流水线",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:medium",
      "node:hermes_wsl"
    ],
    "summary": "RAG 知识库在持续导入文档后出现数据污染、版本混乱、来源不一致等问题，",
    "url": "lessons/contrib/kb-4sigma-quality-audit-pipeline.md",
    "updated": "2026-05-03"
  },
  {
    "id": "knowledge-graph-ux-patterns-from-high-star-projects",
    "title": "知识图谱 UX 增强: 从高星项目提炼的 7 个交互模式",
    "domain": "development",
    "tags": [
      "knowledge-graph",
      "d3js",
      "ux",
      "graph-visualization",
      "force-directed"
    ],
    "summary": "知识图谱可视化项目存在典型问题: 节点过多导致信息过载、关系缺乏上下文、无法聚焦局部视图。",
    "url": "lessons/contrib/knowledge-graph-ux-patterns-from-high-star-projects.md",
    "updated": ""
  },
  {
    "id": "lesson-management-standardization",
    "title": "Lesson Management Standardization — Naming, Content Sanitization, and Automated Submission Pipeline",
    "domain": "devops",
    "tags": [
      "lesson",
      "naming-convention",
      "content-sanitization",
      "automation",
      "ci",
      "standardization"
    ],
    "summary": "Over 180 lessons accumulated in the MisakaNet knowledge base with significant quality and consistency issues:",
    "url": "lessons/contrib/lesson-management-standardization.md",
    "updated": "2026-06-14"
  },
  {
    "id": "lesson_file_line_number_corruption",
    "title": "File Content Corrupted by Terminal Line-Number Prefixes",
    "domain": "devops",
    "tags": [
      "terminal",
      "sed",
      "line-number",
      "file-corruption",
      "html",
      "debug"
    ],
    "summary": "You saved a file's content from terminal output (using `cat -n`, `sed -n '...p'`, or `less -N`), but the file won't rend...",
    "url": "lessons/contrib/lesson_file_line_number_corruption.md",
    "updated": "2026-06-20"
  },
  {
    "id": "lessons-md-fix-heading-block-type",
    "title": "lessons.md 修正（4 处） 项目 旧结论 修正后 heading block（type=4",
    "domain": "rag",
    "tags": [],
    "summary": "[assistant] 还有一处需要修正：image block 的描述不准确——它返回了有效的 block_id（blocks_created=1），只是 token 被清空导致图片不显示。",
    "url": "lessons/contrib/lessons-md-fix-heading-block-type.md",
    "updated": "2026-04-01"
  },
  {
    "id": "misakanet-refactor-v2-review",
    "title": "MisakaNet Refactoring复盘 — 从中心协调到 Agent 图书馆",
    "domain": "development",
    "tags": [
      "refactor",
      "architecture",
      "v2",
      "misakanet"
    ],
    "summary": "---{\"title\": \"MisakaNet Refactoring复盘 — 从中心协调到 Agent 图书馆\", \"domain\": \"development\", \"tags\": [\"refactor\", \"architecture\",...",
    "url": "lessons/contrib/misakanet-refactor-v2-review.md",
    "updated": "2026-05-30 02:00:00 UTC"
  },
  {
    "id": "model-output-fix",
    "title": "模型输出截断 / JSON 解析失败Handling",
    "domain": "claude",
    "tags": [],
    "summary": "---{\"created\": \"2026-05-01 08:00 UTC\", \"domain\": \"claude\", \"source\": \"hermes_wsl\", \"status\": \"published\", \"tags\": \"\", \"t...",
    "url": "lessons/contrib/model-output-fix.md",
    "updated": "2026-05-01 08:00 UTC"
  },
  {
    "id": "model-switch-script-pattern",
    "title": "多模型Switch脚本模式 — 双 Agent 模型管理",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"title\": \"多模型Switch脚本模式 — 双 Agent 模型管理\", \"confidence\": \"0.7\", \"created\": \"2026-05-02\", \"domain\": \"devops\", \"source\":...",
    "url": "lessons/contrib/model-switch-script-pattern.md",
    "updated": "2026-05-02"
  },
  {
    "id": "openai-compatible-api-call",
    "title": "OpenAI 兼容 API 的通用调用格式",
    "domain": "development",
    "tags": [
      "api",
      "openai",
      "llm",
      "inference",
      "chat"
    ],
    "summary": "部署了 LLM 服务（vLLM/Ollama/本地推理）后，不知道怎么用 API 调用。各框架接口不一。",
    "url": "lessons/contrib/openai-compatible-api-call.md",
    "updated": ""
  },
  {
    "id": "openclaw-fatal-error-hook-protocol",
    "title": "OPENCLAW_ERROR_HANDLER — Standard protocol for CLI fatal error external hooks",
    "domain": "development",
    "tags": [
      "openclaw",
      "fatal-error",
      "child-process",
      "spawn",
      "argv",
      "shell-injection",
      "fire-and-forget",
      "protocol",
      "heal"
    ],
    "summary": "---{\"title\": \"OPENCLAW_ERROR_HANDLER — Standard protocol for CLI fatal error external hooks\", \"domain\": \"development\", \"...",
    "url": "lessons/contrib/openclaw-fatal-error-hook-protocol.md",
    "updated": "2026-06-16"
  },
  {
    "id": "openclaw-gateway-dynamic-module-missing",
    "title": "OpenClaw Gateway 动态Module Not Found — 飞书Messaging分发失败",
    "domain": "feishu",
    "tags": [
      "node:misaka10004\", \"platform:wsl\", \"severity:critical\", \"project:misakanet"
    ],
    "summary": "---{\"title\": \"OpenClaw Gateway 动态Module Not Found — 飞书Messaging分发失败\", \"domain\": \"feishu\", \"subdomain\": \"openclaw-debug\",...",
    "url": "lessons/contrib/openclaw-gateway-dynamic-module-missing.md",
    "updated": "2026-05-18"
  },
  {
    "id": "openclaw-prefer-cli-and-policy-over-direct-edit",
    "title": "OpenClaw优先CLI和官方策略",
    "domain": "agentops",
    "tags": [
      "openclaw",
      "cli",
      "policy",
      "config"
    ],
    "summary": "直接修改配置文件（临时hack）容易变成默认模型，导致官方路径退化。",
    "url": "lessons/contrib/openclaw-prefer-cli-and-policy-over-direct-edit.md",
    "updated": ""
  },
  {
    "id": "openclaw-reinstall-lesson",
    "title": "OpenClaw 重装教训 — 删除前先停服务清残留",
    "domain": "devops",
    "tags": [],
    "summary": "愚者飞书机器人无反应，尝试重装 OpenClaw。",
    "url": "lessons/contrib/openclaw-reinstall-lesson.md",
    "updated": "2026-04-01"
  },
  {
    "id": "oss-refactor-lessons",
    "title": "开源项目Refactoring复盘 — 从功能堆砌到减法优先",
    "domain": "development",
    "tags": [
      "refactor",
      "architecture",
      "lessons",
      "open-source",
      "cleanup",
      "focus",
      "repository-management"
    ],
    "summary": "---{\"title\": \"开源项目Refactoring复盘 — 从功能堆砌到减法优先\", \"domain\": \"development\", \"tags\": [\"refactor\", \"architecture\", \"lessons\", ...",
    "url": "lessons/contrib/oss-refactor-lessons.md",
    "updated": "2026-06-14 00:00:00 UTC"
  },
  {
    "id": "permission-denied-fix",
    "title": "Permission Denied / WSL NTFS 跨文件系统PermissionFix",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"created\": \"2026-05-01 08:00 UTC\", \"domain\": \"devops\", \"source\": \"hermes_wsl\", \"status\": \"published\", \"tags\": \"\", \"t...",
    "url": "lessons/contrib/permission-denied-fix.md",
    "updated": "2026-05-01 08:00 UTC"
  },
  {
    "id": "phase-0-output-gate",
    "title": "Phase 0 Output Gate — Agent 的硬性知识检索规则",
    "domain": "methodology",
    "tags": [
      "output-gate",
      "knowledge-reuse",
      "methodology",
      "core"
    ],
    "summary": "Agent 在 context 中看到了知识但不一定会用。即使指令写了\"不可跳过\"，Agent 的惯性行为是直接执行任务、跳过检索。",
    "url": "lessons/contrib/phase-0-output-gate.md",
    "updated": ""
  },
  {
    "id": "pip-install-failure-fix",
    "title": "pip install Network Timeout / SSL / 依赖ConflictFix",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"created\": \"2026-05-01 08:00 UTC\", \"domain\": \"devops\", \"source\": \"hermes_wsl\", \"status\": \"published\", \"tags\": \"\", \"t...",
    "url": "lessons/contrib/pip-install-failure-fix.md",
    "updated": "2026-05-01 08:00 UTC"
  },
  {
    "id": "pip-install-timeout-ssl",
    "title": "pip install Network Timeout / SSL ErrorFix",
    "domain": "devops",
    "tags": [
      "pip",
      "network",
      "SSL",
      "timeout",
      "proxy"
    ],
    "summary": "---{\"title\": \"pip install Network Timeout / SSL ErrorFix\", \"domain\": \"devops\", \"tags\": [\"pip\", \"network\", \"SSL\", \"timeou...",
    "url": "lessons/contrib/pip-install-timeout-ssl.md",
    "updated": ""
  },
  {
    "id": "promo-use-real-examples-not-hypotheticals",
    "title": "Promo Copy — Use Real Examples, Don't Fabricate",
    "domain": "marketing",
    "tags": [
      "outreach",
      "content-strategy",
      "awesome-list",
      "reddit",
      "hacker-news"
    ],
    "summary": "写推广帖时用了虚构的 pip install 梗，用户反馈\"换一个\"——因为假例子没有说服力，读者能感觉到是编的。",
    "url": "lessons/contrib/promo-use-real-examples-not-hypotheticals.md",
    "updated": "2026-05-21"
  },
  {
    "id": "python-gbk-encoding-error",
    "title": "Python GBK Encoding Error — Windows/WSL 跨平台",
    "domain": "devops",
    "tags": [
      "python",
      "encoding",
      "gbk",
      "windows",
      "wsl"
    ],
    "summary": "---{\"title\": \"Python GBK Encoding Error — Windows/WSL 跨平台\", \"domain\": \"devops\", \"tags\": [\"python\", \"encoding\", \"gbk\", \"w...",
    "url": "lessons/contrib/python-gbk-encoding-error.md",
    "updated": ""
  },
  {
    "id": "python-pycache-stale",
    "title": "Python 代码修改不生效 — stale .pyc Cache",
    "domain": "devops",
    "tags": [
      "python",
      "pyc",
      "cache",
      "debug"
    ],
    "summary": "---{\"title\": \"Python 代码修改不生效 — stale .pyc Cache\", \"domain\": \"devops\", \"tags\": [\"python\", \"pyc\", \"cache\", \"debug\"]}---",
    "url": "lessons/contrib/python-pycache-stale.md",
    "updated": ""
  },
  {
    "id": "python-sandbox-path-isolation",
    "title": "Python 沙箱/受限环境 — PATH 和 sys.path 隔离",
    "domain": "development",
    "tags": [
      "python",
      "sandbox",
      "path",
      "import",
      "venv"
    ],
    "summary": "在沙箱或受限环境中执行 Python 代码时，`import` 报 `ModuleNotFoundError`，或 import 的是宿主环境的包而非沙箱环境的。",
    "url": "lessons/contrib/python-sandbox-path-isolation.md",
    "updated": ""
  },
  {
    "id": "python-venv-tiktoken-module-not-found",
    "title": "Python venv 中 tiktoken 安装后仍报 ModuleNotFoundError",
    "domain": "development",
    "tags": [
      "python",
      "venv",
      "tiktoken",
      "pip",
      "setuptools"
    ],
    "summary": "在已有 venv 中 `pip install tiktoken`，安装成功但运行时报 `ModuleNotFoundError: cannot import name '_namespace'` 或其他模块找不到的错误。",
    "url": "lessons/contrib/python-venv-tiktoken-module-not-found.md",
    "updated": ""
  },
  {
    "id": "python-venv-troubleshoot",
    "title": "Python venv 激活失败或路径不匹配",
    "domain": "devops",
    "tags": [
      "python",
      "venv",
      "virtualenv",
      "path"
    ],
    "summary": "`source venv/bin/activate` 后 `which python` 还是系统 Python，或 `deactivate` 报错。",
    "url": "lessons/contrib/python-venv-troubleshoot.md",
    "updated": ""
  },
  {
    "id": "rag-alarm-code-mandatory-recall",
    "title": "RAG 报警代码检索需要关键词强制召回",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:high",
      "node:hermes_wsl"
    ],
    "summary": "查询 \"SRVO-023 机器人报警\" 时 RAG 返回了不相关结果，没有返回正确的 FANUC 报警文档。",
    "url": "lessons/contrib/rag-alarm-code-mandatory-recall.md",
    "updated": "2026-05-03"
  },
  {
    "id": "rag-brand-contamination-detection-and-fix",
    "title": "RAG 知识库品牌污染Detection与治理",
    "domain": "rag",
    "tags": [
      "rag",
      "chromadb",
      "brand-contamination",
      "data-quality",
      "metadata"
    ],
    "summary": "---{\"title\": \"RAG 知识库品牌污染Detection与治理\", \"domain\": \"rag\", \"tags\": [\"rag\", \"chromadb\", \"brand-contamination\", \"data-qualit...",
    "url": "lessons/contrib/rag-brand-contamination-detection-and-fix.md",
    "updated": "2026-05-29"
  },
  {
    "id": "rag-brand-filter-three-pitfalls",
    "title": "RAG 品牌Filter三坑：条件触发、文件正则、BM25 Cache",
    "domain": "rag",
    "tags": [
      "rag",
      "brand-filter",
      "architecture",
      "chromadb",
      "bm25",
      "pitfall"
    ],
    "summary": "---{\"title\": \"RAG 品牌Filter三坑：条件触发、文件正则、BM25 Cache\", \"domain\": \"rag\", \"tags\": [\"rag\", \"brand-filter\", \"architecture\", \"ch...",
    "url": "lessons/contrib/rag-brand-filter-three-pitfalls.md",
    "updated": "2026-05-29"
  },
  {
    "id": "rag-build-strategy-batch",
    "title": "RAG 建库策略：不可一次性加载全部数据到显存/内存",
    "domain": "rag",
    "tags": [],
    "summary": "建库（chunks_v3, 34,100 docs）时一次性把所有数据加载到显存/WSL 内存，导致 LM Studio context overflow，后续引发 Summarization 超时 ×4 → LLM timeout → 驱...",
    "url": "lessons/contrib/rag-build-strategy-batch.md",
    "updated": "2026-04-13"
  },
  {
    "id": "rag-chinese-encoding-pymupdf",
    "title": "RAG 检索中文乱码 — pymupdf4llm 默认编码Issue",
    "domain": "rag",
    "tags": [],
    "summary": "---{\"title\": \"RAG 检索中文乱码 — pymupdf4llm 默认编码Issue\", \"domain\": \"rag\", \"source\": \"bootstrap\", \"status\": \"published\", \"confi...",
    "url": "lessons/contrib/rag-chinese-encoding-pymupdf.md",
    "updated": "2026-04-01"
  },
  {
    "id": "rag-chunk-params-800-100",
    "title": "RAG 分块参数：800 字符 + 100 重叠 + 每文件最多 100 分块",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:medium",
      "node:hermes_wsl"
    ],
    "summary": "FANUC PDF 文档导入 RAG 后，检索质量不稳定，长文档召回率低。",
    "url": "lessons/contrib/rag-chunk-params-800-100.md",
    "updated": "2026-05-03"
  },
  {
    "id": "rag-cross-encoder-cpu-bottleneck",
    "title": "RAG Cross-Encoder Reranker CPU Bottleneck与 LLM 确定性调优",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "node:hermes_wsl",
      "scope:broad",
      "severity:high"
    ],
    "summary": "---{\"title\": \"RAG Cross-Encoder Reranker CPU Bottleneck与 LLM 确定性调优\", \"domain\": \"rag\", \"subdomain\": \"performance\", \"sourc...",
    "url": "lessons/contrib/rag-cross-encoder-cpu-bottleneck.md",
    "updated": "2026-05-28"
  },
  {
    "id": "rag-kb-quality-flywheel-self-loop",
    "title": "RAG 知识库质量飞轮：自闭环建设",
    "domain": "rag",
    "tags": [
      "rag",
      "flywheel",
      "quality",
      "audit",
      "feedback",
      "self-learning"
    ],
    "summary": "某个垂直领域 RAG 知识库（190+ PDF，200K+ 向量）已上线运行，支持自然语言问答和每日自动巡检。但巡检发现的问题只能手动处理，整个闭环缺乏自动化：",
    "url": "lessons/contrib/rag-kb-quality-flywheel-self-loop.md",
    "updated": "2026-05-21"
  },
  {
    "id": "rag-three-channel-llm-disaster-recovery",
    "title": "RAG 三通道 LLM 容灾方案",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "node:hermes_wsl",
      "scope:broad"
    ],
    "summary": "RAG 知识库对外服务（Gradio Web UI / 微信机器人）时，单路 LLM API 可能因网络、配额、服务端故障而不可用，导致整个服务不可用。",
    "url": "lessons/contrib/rag-three-channel-llm-disaster-recovery.md",
    "updated": "2026-05-03"
  },
  {
    "id": "readme-seven-traps-fix-checklist",
    "title": "开源项目 README Optimization — 7 个常见Pitfalls与Fix Checklist",
    "domain": "development",
    "tags": [
      "readme",
      "open-source",
      "documentation",
      "marketing",
      "community"
    ],
    "summary": "---{\"title\": \"开源项目 README Optimization — 7 个常见Pitfalls与Fix Checklist\", \"domain\": \"development\", \"tags\": [\"readme\", \"open...",
    "url": "lessons/contrib/readme-seven-traps-fix-checklist.md",
    "updated": "2026-06-04 00:00:00 UTC"
  },
  {
    "id": "regex-greedy-matching",
    "title": "正则表达式 debugging — 贪婪匹配造成的意外结果",
    "domain": "development",
    "tags": [
      "regex",
      "debug",
      "greedy",
      "pattern"
    ],
    "summary": "正则匹配返回了预期之外的大量文本。`<div>.*</div>` 匹配到了文档末尾而不是最近的闭合标签。",
    "url": "lessons/contrib/regex-greedy-matching.md",
    "updated": ""
  },
  {
    "id": "registration-chain-worker-fallback",
    "title": "注册链路设计 — Worker 只创建 Issue，其余交给 Workflow",
    "domain": "devops",
    "tags": [
      "registration",
      "worker",
      "register",
      "github-actions",
      "feishu",
      "fallback"
    ],
    "summary": "MisakaNet 节点注册需要一条对国内外用户都通畅的链路。最初 Worker 既创建 Issue 又读写 counter.json，导致 Worker 和 register.yml 双重自增、竞态、Worker 权限过大等问题。",
    "url": "lessons/contrib/registration-chain-worker-fallback.md",
    "updated": ""
  },
  {
    "id": "shared-json-needs-atomic-write",
    "title": "共享JSON状态需要原子写入",
    "domain": "devops",
    "tags": [
      "json",
      "atomic",
      "race-condition",
      "runtime"
    ],
    "summary": "多个自动化job同时写共享的运行时状态文件（如 latest.json），plain overwrite 会暴露半写状态导致并发读者解析失败。",
    "url": "lessons/contrib/shared-json-needs-atomic-write.md",
    "updated": ""
  },
  {
    "id": "shell-script-debugging",
    "title": "Shell Debugging — set -x 与常见Pitfalls",
    "domain": "development",
    "tags": [
      "shell",
      "bash",
      "debug",
      "script"
    ],
    "summary": "---{\"title\": \"Shell Debugging — set -x 与常见Pitfalls\", \"domain\": \"development\", \"tags\": [\"shell\", \"bash\", \"debug\", \"script...",
    "url": "lessons/contrib/shell-script-debugging.md",
    "updated": ""
  },
  {
    "id": "skill-dogfood",
    "title": "dogfood",
    "domain": "claude",
    "tags": [],
    "summary": "Exploratory QA of web apps: find bugs, evidence, reports.",
    "url": "lessons/contrib/skill-dogfood.md",
    "updated": "2026-05-20"
  },
  {
    "id": "skill-edoc-pipeline-retrospective",
    "title": "edoc-pipeline-retrospective",
    "domain": "rag",
    "tags": [],
    "summary": "使用 edoc-pipeline-retrospective 的实践经验和踩坑记录。",
    "url": "lessons/contrib/skill-edoc-pipeline-retrospective.md",
    "updated": "2026-05-20"
  },
  {
    "id": "skill-edoc-rag",
    "title": "edoc-rag",
    "domain": "rag",
    "tags": [],
    "summary": "FANUC 机器人知识库 RAG 检索 — 向量库 34,100 chunks，BGE-m3 1024维，L2 距离，支持飞书 Bot 自动调用",
    "url": "lessons/contrib/skill-edoc-rag.md",
    "updated": "2026-05-20"
  },
  {
    "id": "skill-feishu-docx",
    "title": "feishu-docx",
    "domain": "feishu",
    "tags": [],
    "summary": "通过 REST API（requests/curl）创建飞书云文档、写入内容块（docx API）、发送消息卡片、访问 Wiki 节点。涵盖 Bot 创建 docx、Bot 写入 Wiki 文档（跨租户权限限制）、纯文本考卷出卷等实战场景。",
    "url": "lessons/contrib/skill-feishu-docx.md",
    "updated": "2026-05-20"
  },
  {
    "id": "skill-feishu-interactive-card",
    "title": "feishu-interactive-card",
    "domain": "feishu",
    "tags": [],
    "summary": "飞书互动卡片发送与回调处理 — 调试 230099/200621 错误，正确构建卡片 JSON，处理按钮点击回调。",
    "url": "lessons/contrib/skill-feishu-interactive-card.md",
    "updated": "2026-05-20"
  },
  {
    "id": "skill-hermes-cli-pty-mode",
    "title": "hermes-cli-pty-mode",
    "domain": "devops",
    "tags": [],
    "summary": "Hermes CLI 在非 TTY 环境下（WSL/远程/脚本）无法启动的问题诊断与解决",
    "url": "lessons/contrib/skill-hermes-cli-pty-mode.md",
    "updated": "2026-05-20"
  },
  {
    "id": "skill-openclaw-multi-instance-config",
    "title": "openclaw-multi-instance-config",
    "domain": "feishu",
    "tags": [],
    "summary": "Navigate and manage multiple OpenClaw instances across WSL and Windows, with different Feishu bot credentials",
    "url": "lessons/contrib/skill-openclaw-multi-instance-config.md",
    "updated": "2026-05-20"
  },
  {
    "id": "skill-rag-audit-question-authoring",
    "title": "rag-audit-question-authoring",
    "domain": "rag",
    "tags": [],
    "summary": "为 RAG 知识库巡检出题的规范和质量标准。当需要生成、审核、补充巡检测试题时使用。",
    "url": "lessons/contrib/skill-rag-audit-question-authoring.md",
    "updated": "2026-05-20"
  },
  {
    "id": "skill-task-board-html-patterns",
    "title": "task-board-html-patterns",
    "domain": "feishu",
    "tags": [],
    "summary": "任务看板 HTML/CSS/JS 可复用模式 — toggle开关、竖列、inline编辑、CSS技巧",
    "url": "lessons/contrib/skill-task-board-html-patterns.md",
    "updated": "2026-05-20"
  },
  {
    "id": "slugify-path-traversal-deep-coverage",
    "title": "Slugify: deep coverage of path traversal, null bytes, and reserved names",
    "domain": "scripts",
    "tags": [
      "slugify",
      "path-traversal",
      "windows-reserved",
      "null-byte",
      "test-coverage",
      "hardening"
    ],
    "summary": "The original 5-test `test_slugify.py` (merged in commit `6912f87` for issue #95) covered the basics: standard titles, sl...",
    "url": "lessons/contrib/slugify-path-traversal-deep-coverage.md",
    "updated": ""
  },
  {
    "id": "slugify-windows-path-sanitation",
    "title": "Slugify filename sanitation crash on Windows and WSL",
    "domain": "scripts",
    "tags": [
      "slugify",
      "windows",
      "wsl",
      "sanitation",
      "path-errors"
    ],
    "summary": "When creating a new lesson using `scripts/new_lesson.py` (either interactively or via batch mode), if the user or agent ...",
    "url": "lessons/contrib/slugify-windows-path-sanitation.md",
    "updated": ""
  },
  {
    "id": "static-page-github-api-403-rate-limit",
    "title": "静态页面调用外部 API 的容错设计原则",
    "domain": "frontend",
    "tags": [
      "api",
      "rate-limit",
      "static-site",
      "error-handling",
      "fault-tolerance"
    ],
    "summary": "纯静态页面（无后端代理，HTML + JS 直接部署在 CDN/GitHub Pages 上）需要通过浏览器端 JavaScript 直接调用第三方 API。这种架构面临几个固有风险：",
    "url": "lessons/contrib/static-page-github-api-403-rate-limit.md",
    "updated": ""
  },
  {
    "id": "static-page-width-consistency",
    "title": "静态页面多组件宽度一致性——各自定义 max-width 导致视觉割裂",
    "domain": "frontend",
    "tags": [
      "css",
      "layout",
      "ux",
      "responsive"
    ],
    "summary": "页面各个功能区块宽度不一致：搜索栏 `max-width: 800px`，内容卡片 `max-width: 600px`，表单 `display: inline-block; min-width: 360px`，而其他区块又是全宽。页面看起...",
    "url": "lessons/contrib/static-page-width-consistency.md",
    "updated": ""
  },
  {
    "id": "swarm-pr-battle-playbook",
    "title": "Swarm PR Battle Playbook — Shipping env-var error hooks through AI-reviewed upstreams",
    "domain": "development",
    "tags": [
      "pr",
      "ai-review",
      "github-actions",
      "fatal-error",
      "spawn",
      "shell-injection",
      "esm",
      "ci",
      "playbook",
      "sop"
    ],
    "summary": "---{\"title\": \"Swarm PR Battle Playbook — Shipping env-var error hooks through AI-reviewed upstreams\", \"domain\": \"develop...",
    "url": "lessons/contrib/swarm-pr-battle-playbook.md",
    "updated": "2026-06-17"
  },
  {
    "id": "tmux-session-management",
    "title": "tmux 终端复用 — 断开不丢失会话",
    "domain": "development",
    "tags": [
      "tmux",
      "terminal",
      "session",
      "background"
    ],
    "summary": "SSH 断开或终端关闭后，正在运行的任务（训练、迁移、部署）中断。重新连接后无法恢复。",
    "url": "lessons/contrib/tmux-session-management.md",
    "updated": ""
  },
  {
    "id": "tts-chinese-encoding-powershell",
    "title": "TTS 中文编码：PowerShell 传参必须用 .txt 文件中转",
    "domain": "tts",
    "tags": [],
    "summary": "中文文本通过 PowerShell 脚本内联传给 mmx CLI，TTS 返回空音频（\"嗯嗯\"声）。",
    "url": "lessons/contrib/tts-chinese-encoding-powershell.md",
    "updated": "2026-04-18"
  },
  {
    "id": "vertical-kb-question-bank-strategy",
    "title": "Vertical KB Question Bank Strategy — FANUC Robot KB Case Study",
    "domain": "rag-knowledge-base",
    "tags": [
      "rag",
      "question-bank",
      "knowledge-base",
      "feishu-doc",
      "review"
    ],
    "summary": "在飞书云文档中维护一个 FANUC 机器人垂直知识库的题库，经历了从第一批到第三批的迭代，发现了一些关键管理策略。",
    "url": "lessons/contrib/vertical-kb-question-bank-strategy.md",
    "updated": "2026-05-19"
  },
  {
    "id": "wcferry-wechat-version-lock",
    "title": "wcferry 微信版本锁定 — 3.9.12.51 才能用",
    "domain": "devops",
    "tags": [
      "project:rag",
      "platform:windows",
      "node:hermes_wsl",
      "scope:narrow"
    ],
    "summary": "wxauto 不够稳定时，考虑切换到 wcferry (WeChatFerry) 方案。但安装后无法 hook 微信进程。",
    "url": "lessons/contrib/wcferry-wechat-version-lock.md",
    "updated": "2026-05-03"
  },
  {
    "id": "wechat-pubacct-fetch-separate-search-from-retrieval",
    "title": "微信公众号抓取失败Handling（搜索与抓取分离）",
    "domain": "wechat",
    "tags": [
      "wechat",
      "fetch",
      "search",
      "crawl"
    ],
    "summary": "---{\"title\": \"微信公众号抓取失败Handling（搜索与抓取分离）\", \"domain\": \"wechat\", \"tags\": [\"wechat\", \"fetch\", \"search\", \"crawl\"]}---",
    "url": "lessons/contrib/wechat-pubacct-fetch-separate-search-from-retrieval.md",
    "updated": ""
  },
  {
    "id": "wecom-robot-long-connect-no-ngrok",
    "title": "企业微信机器人：长连接模式不需要 ngrok",
    "domain": "devops",
    "tags": [
      "project:rag",
      "platform:windows",
      "node:hermes_wsl",
      "scope:narrow"
    ],
    "summary": "配置企业微信机器人回调时，传统方案需要 ngrok/frp 做内网穿透，增加复杂度、暴露端口、需要 HTTPS 证书。",
    "url": "lessons/contrib/wecom-robot-long-connect-no-ngrok.md",
    "updated": "2026-05-03"
  },
  {
    "id": "write-file-sandbox-worktree-git-path",
    "title": "Agent Write File 写入不落地 + Worktree Git 链接路径断裂",
    "domain": "devops",
    "tags": [
      "agent-mode",
      "write-file",
      "worktree",
      "wsl",
      "git",
      "lesson-written"
    ],
    "summary": "在对项目进行代码修改的过程中，使用 Agent 模式操作。操作环境为 WSL (Windows Subsystem for Linux)，仓库使用 worktree 管理。",
    "url": "lessons/contrib/write-file-sandbox-worktree-git-path.md",
    "updated": "2026-05-13 01:01:46 UTC"
  },
  {
    "id": "wsl-permission-ntfs-fix",
    "title": "Permission Denied / WSL NTFS 跨文件系统PermissionFix",
    "domain": "devops",
    "tags": [
      "permission",
      "wsl",
      "ntfs",
      "eacces",
      "filesystem"
    ],
    "summary": "---{\"title\": \"Permission Denied / WSL NTFS 跨文件系统PermissionFix\", \"domain\": \"devops\", \"tags\": [\"permission\", \"wsl\", \"ntfs\"...",
    "url": "lessons/contrib/wsl-permission-ntfs-fix.md",
    "updated": ""
  },
  {
    "id": "wsl-pip-gbk-hub-poller-crash",
    "title": "WSL pip install GBK 编码导致 hub_poller 崩溃",
    "domain": "devops",
    "tags": [
      "project:agent-medici",
      "severity:critical",
      "platform:wsl",
      "node:hermes_wsl"
    ],
    "summary": "Windows Hub 的 hub_poller.py 读取 config.yaml 时崩溃，错误信息为 UnicodeDecodeError。",
    "url": "lessons/contrib/wsl-pip-gbk-hub-poller-crash.md",
    "updated": "2026-05-03"
  },
  {
    "id": "wsl-proxy-huggingface-external",
    "title": "WSL 需要代理Setup才能Access HuggingFace 和外部网络",
    "domain": "devops",
    "tags": [
      "project:self-grow-wiki",
      "severity:high",
      "platform:wsl",
      "node:hermes_wsl"
    ],
    "summary": "---{\"title\": \"WSL 需要代理Setup才能Access HuggingFace 和外部网络\", \"domain\": \"devops\", \"subdomain\": \"wsl\", \"source\": \"bootstrap\", \"...",
    "url": "lessons/contrib/wsl-proxy-huggingface-external.md",
    "updated": "2026-05-03"
  },
  {
    "id": "wsl-proxy-setup",
    "title": "WSL 代理Setup — 通过 Windows 梯子Access外网",
    "domain": "devops",
    "tags": [
      "wsl",
      "proxy",
      "network",
      "windows"
    ],
    "summary": "---{\"title\": \"WSL 代理Setup — 通过 Windows 梯子Access外网\", \"domain\": \"devops\", \"tags\": [\"wsl\", \"proxy\", \"network\", \"windows\"]}-...",
    "url": "lessons/contrib/wsl-proxy-setup.md",
    "updated": ""
  },
  {
    "id": "wsl-terminal-underscore-corruption",
    "title": "WSL 终端编辑Setup危险 — TTy粘贴吞下划线",
    "domain": "devops",
    "tags": [],
    "summary": "---{\"title\": \"WSL 终端编辑Setup危险 — TTy粘贴吞下划线\", \"domain\": \"devops\", \"source\": \"bootstrap\", \"bootstrapped\": true, \"author\": \"...",
    "url": "lessons/contrib/wsl-terminal-underscore-corruption.md",
    "updated": "2026-04-01"
  },
  {
    "id": "wsl-terminal-underscore-missing",
    "title": "WSL Windows 终端复制粘贴吞下划线Issue",
    "domain": "devops",
    "tags": [
      "wsl",
      "terminal",
      "windows",
      "encoding"
    ],
    "summary": "---{\"title\": \"WSL Windows 终端复制粘贴吞下划线Issue\", \"domain\": \"devops\", \"tags\": [\"wsl\", \"terminal\", \"windows\", \"encoding\"]}---",
    "url": "lessons/contrib/wsl-terminal-underscore-missing.md",
    "updated": ""
  },
  {
    "id": "wsl2-memory-leak-fix",
    "title": "WSL2 内存泄漏 / 内存占用过高",
    "domain": "devops",
    "tags": [
      "wsl",
      "memory",
      "leak",
      "performance"
    ],
    "summary": "WSL2 运行几天后吃掉 8GB+ 内存，Windows 变卡。`free -h` 显示已用内存极高。",
    "url": "lessons/contrib/wsl2-memory-leak-fix.md",
    "updated": ""
  },
  {
    "id": "wxauto-im-feedback-collection-jsonl-queue",
    "title": "IM 机器人反馈收集与 JSONL 队列审核模式",
    "domain": "rag",
    "tags": [
      "rag",
      "feedback",
      "queue",
      "jsonl",
      "wechat",
      "wxauto",
      "workflow"
    ],
    "summary": "RAG 知识库的 IM 机器人（wxauto 微信）只提供单向问答能力，用户不满意时无反馈渠道。知识库质量改进完全依赖离线人工审计，无法捕捉真实使用场景中的问题。",
    "url": "lessons/contrib/wxauto-im-feedback-collection-jsonl-queue.md",
    "updated": "2026-05-21"
  },
  {
    "id": "wxauto-windows-python-not-wsl",
    "title": "wxauto 必须在 Windows Python 下安装，不能走 WSL pip",
    "domain": "devops",
    "tags": [
      "project:rag",
      "platform:windows",
      "node:hermes_wsl",
      "scope:narrow"
    ],
    "summary": "在 WSL2 中 `pip install wxauto` 报错 `No matching distribution found`。wxauto 是 Windows-only 库。",
    "url": "lessons/contrib/wxauto-windows-python-not-wsl.md",
    "updated": "2026-05-03"
  },
  {
    "id": "README",
    "title": "README",
    "domain": "uncategorized",
    "tags": [],
    "summary": "Lessons in this directory have passed **curated review** — CI-linted, security-scanned, and verified by trusted nodes. A...",
    "url": "lessons/core/README.md",
    "updated": ""
  },
  {
    "id": "auto-merge-ci-pipeline",
    "title": "Auto-Merge CI Pipeline — DCO, Quality Score, Shadow Branch, Dynamic Deps, Auto-Merge",
    "domain": "devops",
    "tags": [
      "github-actions",
      "ci",
      "auto-merge",
      "shadow-branch",
      "quality-score",
      "ai-agent",
      "fork-pr"
    ],
    "summary": "Manual merge is the bottleneck in zero-bounty open-source workflows. Maintainers must review every PR, click merge, post...",
    "url": "lessons/core/auto-merge-ci-pipeline.md",
    "updated": "2026-06-10 00:00:00 UTC"
  },
  {
    "id": "contributor-engagement-retention",
    "title": "AI Agent Contributor Engagement — Lightweight Retention Strategy",
    "domain": "devops",
    "tags": [
      "open-source",
      "community",
      "contributor-retention",
      "ai-agent",
      "misakanet",
      "social"
    ],
    "summary": "AI Agent 贡献者（尤其是零赏金模式下的）比人类贡献者更容易流失。Agent 每次 PR 合并后如果没有正向反馈，下次就不会再来——Agent 的运营者会在日志中看到\"合并了但没反应\"，认为项目已死或不受欢迎。",
    "url": "lessons/core/contributor-engagement-retention.md",
    "updated": "2026-06-10 00:00:00 UTC"
  },
  {
    "id": "cronjob-one-shot-race-condition-duplicate-execution",
    "title": "Cronjob One-Shot Race Condition - Duplicate Execution",
    "domain": "agent-network",
    "tags": [
      "node:ZKA",
      "project:Hermes-Agent",
      "severity:critical"
    ],
    "summary": "One-shot cronjobs (reminders, .BG, .S, .RS commands) firing 2-4x at once instead of once.",
    "url": "lessons/core/cronjob-one-shot-race-condition-duplicate-execution.md",
    "updated": "2026-06-05 00:48:38 UTC"
  },
  {
    "id": "dco-auto-fix-workflow",
    "title": "DCO Auto-Fix Workflow — /fix-dco Command Design & Implementation",
    "domain": "devops",
    "tags": [
      "github-actions",
      "dco",
      "signoff",
      "issue_comment",
      "auto-fix",
      "fork-pr",
      "plan-b",
      "supply-chain"
    ],
    "summary": "贡献者提交 PR 后 DCO（Signed-off-by）检查失败是最常见的阻塞原因之一。尤其是 AI Agent 自动提交的 PR，经常缺签。需要在 PR 评论区提供一键自动修复能力。",
    "url": "lessons/core/dco-auto-fix-workflow.md",
    "updated": "2026-06-14 00:00:00 UTC"
  },
  {
    "id": "freellmapi-session-context-mixing-cross-thread-delivery",
    "title": "FReeLLMAPI Session Context Mixing - Cross-Thread Delivery",
    "domain": "agent-network",
    "tags": [
      "node:ZKA",
      "project:Hermes-Agent",
      "severity:high"
    ],
    "summary": "Messages appearing in wrong Telegram threads (e.g., Poker topic receiving Main Chat content).",
    "url": "lessons/core/freellmapi-session-context-mixing-cross-thread-delivery.md",
    "updated": "2026-06-05 00:48:54 UTC"
  },
  {
    "id": "github-actions-code-injection",
    "title": "GitHub Actions Script Injection — Use env Variables Instead of Inline Interpolation",
    "domain": "security",
    "tags": [
      "github-actions",
      "security",
      "code-injection",
      "codeql",
      "ci"
    ],
    "summary": "当 GitHub Actions 的 `run:` 脚本中直接使用 `${{ github.event.issue.body }}` 或 `${{ github.event.pull_request.title }}` 等用户可控变量时，攻...",
    "url": "lessons/core/github-actions-code-injection.md",
    "updated": "2026-06-10 00:00:00 UTC"
  },
  {
    "id": "hermes-state-database-lock-issues-cleanup-protocol",
    "title": "Hermes State Database Lock Issues - Cleanup Protocol",
    "domain": "agent-network",
    "tags": [
      "node:ZKA",
      "project:Hermes-Agent",
      "severity:high"
    ],
    "summary": "Hermes agent shows 'database is locked' error on SQLite state.db. Cronjobs stop firing.",
    "url": "lessons/core/hermes-state-database-lock-issues-cleanup-protocol.md",
    "updated": "2026-06-05 00:49:07 UTC"
  },
  {
    "id": "pr-cleanup-sop",
    "title": "PR Cleanup SOP — Stale/Duplicate/Resolved PR Disposition",
    "domain": "devops",
    "tags": [
      "github-actions",
      "pr-management",
      "cleanup",
      "maintenance",
      "sop"
    ],
    "summary": "开放 PR 堆积会消耗维护者心力。AI Agent 提交 PR 的高频场景下，重复/过时/已解决 PR 尤其常见。需要一套系统化的处置策略。",
    "url": "lessons/core/pr-cleanup-sop.md",
    "updated": "2026-06-13 00:00:00 UTC"
  },
  {
    "id": "pull-request-welcome-trigger-trap",
    "title": "PR Welcome Not Triggering — author_association NONE vs FIRST_TIMER Trap",
    "domain": "devops",
    "tags": [
      "github-actions",
      "pull_request_target",
      "author_association",
      "first-time-contributor",
      "welcome",
      "debug"
    ],
    "summary": "首次贡献者提交 PR 后，`pr-welcome.yml`（使用 `pull_request_target` 事件）状态显示 **Skipped**，欢迎评论未发出。",
    "url": "lessons/core/pull-request-welcome-trigger-trap.md",
    "updated": "2026-06-13 00:00:00 UTC"
  },
  {
    "id": "README",
    "title": "README",
    "domain": "uncategorized",
    "tags": [],
    "summary": "New contributions land here first. They have passed basic CI checks but have **not** been reviewed by a human maintainer...",
    "url": "lessons/draft/README.md",
    "updated": ""
  },
  {
    "id": "README",
    "title": "README",
    "domain": "uncategorized",
    "tags": [],
    "summary": "> ⚠️ 此目录下的 lesson 为自动生成或未经审核的草稿。",
    "url": "lessons/drafts/README.md",
    "updated": ""
  },
  {
    "id": "README",
    "title": "README",
    "domain": "uncategorized",
    "tags": [],
    "summary": "MisakaNet supports multi-language lessons. Each lesson file carries a `language` field",
    "url": "lessons/locales/README.md",
    "updated": ""
  },
  {
    "id": "README",
    "title": "README",
    "domain": "uncategorized",
    "tags": [],
    "summary": "Lessons in this directory have been **reviewed by a human maintainer** and confirmed correct.",
    "url": "lessons/verified/README.md",
    "updated": ""
  }
]