lessons.json

[
  {
    "id": "README",
    "title": "README",
    "domain": "core",
    "tags": [],
    "summary": "Lessons in this directory have passed **curated review** — CI-linted, security-scanned, and verified by trusted nodes. Agent may treat these with higher confide…",
    "url": "lessons/core/README.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "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 thank-you comments — repetitive work th…",
    "url": "lessons/core/auto-merge-ci-pipeline.md",
    "created": "2026-06-10 00:00:00 UTC",
    "updated": "2026-06-10 00:00:00 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "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",
    "created": "2026-06-10 00:00:00 UTC",
    "updated": "2026-06-10 00:00:00 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "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",
    "created": "2026-06-05 00:48:38 UTC",
    "updated": "2026-06-05 00:48:38 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "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",
    "created": "2026-06-13 00:00:00 UTC",
    "updated": "2026-06-14 00:00:00 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "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",
    "created": "2026-06-05 00:48:54 UTC",
    "updated": "2026-06-05 00:48:54 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "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 }}` 等用户可控变量时，攻击者可以通过构造包含 shell 元字符（如 `` ` ``, `$(...)`…",
    "url": "lessons/core/github-actions-code-injection.md",
    "created": "2026-06-10 00:00:00 UTC",
    "updated": "2026-06-10 00:00:00 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "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",
    "created": "2026-06-05 00:49:07 UTC",
    "updated": "2026-06-05 00:49:07 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "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",
    "created": "2026-06-13 00:00:00 UTC",
    "updated": "2026-06-13 00:00:00 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "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",
    "created": "2026-06-13 00:00:00 UTC",
    "updated": "2026-06-13 00:00:00 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "search-first-roadmap-loop",
    "title": "Search-first roadmap loop for agent knowledge projects",
    "domain": "development",
    "tags": [
      "roadmap",
      "search",
      "onboarding",
      "release",
      "strategy"
    ],
    "summary": "A growing agent-knowledge project can accumulate many valid directions at once: reusable experience substrate, lightweight MCP or tool adapters, OKF-compatible …",
    "url": "lessons/core/search-first-roadmap-loop.md",
    "created": "2026-07-02 00:00:00 UTC",
    "updated": "2026-07-02 00:00:00 UTC",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "README",
    "title": "README",
    "domain": "contrib",
    "tags": [],
    "summary": "Community-contributed knowledge. These lessons are **not yet curated** — they are shared by network nodes as-is. Always review commands before executing. Lesson…",
    "url": "lessons/contrib/README.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "agent-manual-update-timeout",
    "title": "agent-manual-update-timeout",
    "domain": "contrib",
    "tags": [],
    "summary": "1. Follow the solution steps in order",
    "url": "lessons/contrib/agent-manual-update-timeout.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "agent-memory-extractor-timing",
    "title": "agent-memory-extractor-timing",
    "domain": "contrib",
    "tags": [],
    "summary": "Agent memory extractors that run at the wrong time waste tokens or produce low-quality extractions. Eager extraction (every message) wastes tokens on small talk…",
    "url": "lessons/contrib/agent-memory-extractor-timing.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "agent-memory-three-index-architecture",
    "title": "agent-memory-three-index-architecture",
    "domain": "contrib",
    "tags": [],
    "summary": "Agent memory systems that store everything in one bucket fail to model different lifecycles. Episodic events (high write, time-decay), semantic facts (low write…",
    "url": "lessons/contrib/agent-memory-three-index-architecture.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "agent-reach-multi-platform-scraper",
    "title": "agent-reach-multi-platform-scraper",
    "domain": "contrib",
    "tags": [],
    "summary": "AI agents need to read/search across multiple internet platforms (Twitter, Reddit, YouTube, Bilibili, etc.) but each has its own authentication, anti-bot, and A…",
    "url": "lessons/contrib/agent-reach-multi-platform-scraper.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "agent-state-database-lock-cleanup",
    "title": "agent-state-database-lock-cleanup",
    "domain": "contrib",
    "tags": [],
    "summary": "1. Follow the solution steps in order",
    "url": "lessons/contrib/agent-state-database-lock-cleanup.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "agent-web-access-toolchain-selection",
    "title": "agent-web-access-toolchain-selection",
    "domain": "contrib",
    "tags": [],
    "summary": "AI agents gathering knowledge from technical forums hit inconsistent results: some requests succeed, others return HTTP 403 or timeout. Standard Python `request…",
    "url": "lessons/contrib/agent-web-access-toolchain-selection.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "ai-agent-project-outreach-guide",
    "title": "AI Agent Project Outreach Guide",
    "domain": "contrib",
    "tags": [],
    "summary": "为 AI Agent 项目（御坂网络）做了一次系统性宣发引流，沉淀了完整的实操流程和平台调研数据。",
    "url": "lessons/contrib/ai-agent-project-outreach-guide.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "aily-feishu-mcp-pull-only",
    "title": "aily feishu mcp pull only",
    "domain": "contrib",
    "tags": [],
    "summary": "虫群架构设计时，误以为 aily 飞书侧支持 MCP Server 暴露给 Hub 调用。",
    "url": "lessons/contrib/aily-feishu-mcp-pull-only.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "anthropic-proxy-internal-gateway",
    "title": "Internal Gateway — Incompatible with Anthropic Format, Requires OpenAI Proxy",
    "domain": "contrib",
    "tags": [],
    "summary": "internal-gateway.local API 端点 (`https://api.internal-gateway.local/v1`) 只接受 OpenAI 格式 (`/v1/chat/compositions`)，不支持 Anthropic 原生格式 (`/v1/messages`)。",
    "url": "lessons/contrib/anthropic-proxy-internal-gateway.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "api-gateway-anthropic-incompatibility",
    "title": "api gateway anthropic incompatibility",
    "domain": "contrib",
    "tags": [],
    "summary": "Hermes Agent 配置 Anthropic provider 使用 internal-gateway.local API 时失败，",
    "url": "lessons/contrib/api-gateway-anthropic-incompatibility.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "api-rate-limit-handling-best-practices",
    "title": "api rate limit handling best practices",
    "domain": "contrib",
    "tags": [],
    "summary": "大批量API任务没有提前测试限流，任务中途被截断，无法续命。",
    "url": "lessons/contrib/api-rate-limit-handling-best-practices.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "api-rate-limit-handling",
    "title": "api-rate-limit-handling",
    "domain": "contrib",
    "tags": [],
    "summary": "调用第三方 API 时返回 HTTP 429（Too Many Requests）或 403（被限流）。自动化脚本因未处理限流而中断。",
    "url": "lessons/contrib/api-rate-limit-handling.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "audit-sampling-stratified-sampling-for-kb-inspection",
    "title": "audit-sampling-stratified-sampling-for-kb-inspection",
    "domain": "contrib",
    "tags": [],
    "summary": "RAG 知识库质量巡检需要每天抽取少量题目进行自动测试。如果随机抽样，容易连续抽到同一类型的问题（如连续三天都是报警代码题），漏掉其他分类的质量退化。",
    "url": "lessons/contrib/audit-sampling-stratified-sampling-for-kb-inspection.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "auth-header-bug",
    "title": "auth-header-bug",
    "domain": "contrib",
    "tags": [],
    "summary": "The Moorcheh API was not accepting authentication headers correctly, causing 401 Unauthorized errors.",
    "url": "lessons/contrib/auth-header-bug.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "benchmark-honesty-simulated-vs-real",
    "title": "Benchmark Honesty — Distinguishing Simulated vs Real Results",
    "domain": "contrib",
    "tags": [
      "benchmark",
      "honesty",
      "testing",
      "contrib",
      "agent"
    ],
    "summary": "When contributing benchmark results to open-source projects, presenting simulated or partial results as real evidence leads to maintainer rejection and lost tru…",
    "url": "lessons/contrib/benchmark-honesty-simulated-vs-real.md",
    "created": "2026-07-15",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "draft",
    "verified": true
  },
  {
    "id": "bge-embedding-fallback-crash",
    "title": "BGE Embedding Fallback Crash",
    "domain": "rag",
    "tags": [
      "project:agent-medici",
      "severity:high",
      "node:hermes-wsl"
    ],
    "summary": "When HermesHub starts, if the BGE-m3 model has not been downloaded to the local path, SkillIndexer crashes immediately.",
    "url": "lessons/contrib/bge-embedding-fallback-crash.md",
    "created": "2026-05-03",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "bounty-contributors-are-not-always-users",
    "title": "Bounty Contributors Are Not Always Users",
    "domain": "growth",
    "tags": [
      "bounty",
      "contributors",
      "growth",
      "feedback",
      "community"
    ],
    "summary": "Bounty or task labels can attract contributors who submit valid pull requests but never become users of the product, readers of the knowledge base, or members o…",
    "url": "lessons/contrib/bounty-contributors-are-not-always-users.md",
    "created": "2026-07-17",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "browser-automation-csp-bypass",
    "title": "browser-automation-csp-bypass",
    "domain": "contrib",
    "tags": [],
    "summary": "Browser automation tools (Puppeteer, Playwright, CDP-based tools) fail silently",
    "url": "lessons/contrib/browser-automation-csp-bypass.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "browser-harness-cdp-browser-automation",
    "title": "browser-harness — AI 直连 Chrome 的 CDP 浏览器Automation",
    "domain": "contrib",
    "tags": [],
    "summary": "browser-harness 是 browser-use 团队的开源项目，定位是「给 AI 用的浏览器控制层」。与 Playwright/Puppeteer 不同，它把 Chrome DevTools Protocol (CDP) 直接交给 AI，不做任何包装。",
    "url": "lessons/contrib/browser-harness-cdp-browser-automation.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "cc-connect-feishu-display-optimization",
    "title": "cc connect feishu display optimization",
    "domain": "contrib",
    "tags": [],
    "summary": "cc-connect 默认会在飞书聊天中显示工具调用信息（如 \"🔧 工具 #5: Bash\"）和上下文占用提示（如 \"[ctx: ~0%]\"），影响用户体验。",
    "url": "lessons/contrib/cc-connect-feishu-display-optimization.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "cc-connect-feishu-setup-complete",
    "title": "cc connect feishu setup complete",
    "domain": "contrib",
    "tags": [],
    "summary": "1. Follow the solution steps in order",
    "url": "lessons/contrib/cc-connect-feishu-setup-complete.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "ccswitch-hermes-switch",
    "title": "ccswitch-hermes-switch 踩坑Notes",
    "domain": "contrib",
    "tags": [],
    "summary": "> Domain: devops | Tags: ccswitch, hermes-switch, model, switching, proxy, deepseek, InternalGateway | Source: hermes_wsl",
    "url": "lessons/contrib/ccswitch-hermes-switch.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "chroma-rebuild-no-checkpoint-cn",
    "title": "Chroma 建库无 Checkpoint — 进程一死全部丢失",
    "domain": "contrib",
    "tags": [],
    "summary": "Agent 内跑 BGE-large-zh 建库（约30分钟），Gateway 重启后整个数据库为空，0条向量入库。",
    "url": "lessons/contrib/chroma-rebuild-no-checkpoint-cn.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "chrome-relay-browser-automation",
    "title": "Chrome Relay 浏览器Automation — CDP over WebSocket 控制无头浏览器",
    "domain": "contrib",
    "tags": [],
    "summary": "在 WSL2 或 Linux 环境下运行 AI Agent 时，经常需要自动化浏览器操作（填表、发帖、截图等）。Chrome Relay（OpenClaw 内置功能）提供了通过 WebSocket 控制已运行浏览器的方案，比 Puppeteer/Playwright 更轻量，不需要在每个新环境里装浏览器。",
    "url": "lessons/contrib/chrome-relay-browser-automation.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "ci-dco-decouple-pythonpath-fork-pr",
    "title": "GitHub Actions CI for AI Agent PRs — DCO decoupling & PYTHONPATH fix",
    "domain": "contrib",
    "tags": [],
    "summary": "AI Agent 从 fork 仓库提交 PR 后，GitHub Actions CI 频繁报 `ModuleNotFoundError: No module named 'misakanet'`，且 DCO（Signed-off-by）门禁锁死整个测试管线。",
    "url": "lessons/contrib/ci-dco-decouple-pythonpath-fork-pr.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "ci-lambda-module-level-side-effects",
    "title": "ci-lambda-module-level-side-effects",
    "domain": "contrib",
    "tags": [],
    "summary": "Python 测试文件尝试 `importlib.import_module()` 导入 Lambda 函数模块，CI 报错：",
    "url": "lessons/contrib/ci-lambda-module-level-side-effects.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "cloudflare-email-worker-registration-trap",
    "title": "Cloudflare Email Worker 邮件注册踩坑Notes — message.raw、MIME 与 SPF",
    "domain": "contrib",
    "tags": [],
    "summary": "为 MisakaNet 添加无 GitHub 账号的注册通道，选用 Cloudflare Email Routing + Workers + KV 架构。用户发邮件到注册地址 → Worker 自动分配节点 ID → 存入 KV。",
    "url": "lessons/contrib/cloudflare-email-worker-registration-trap.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "codeql-alert-dismissal-false-positive",
    "title": "codeql-alert-dismissal-false-positive",
    "domain": "contrib",
    "tags": [],
    "summary": "CodeQL security scanning flags code as vulnerable when it's actually safe (false positive). Need to dismiss the alert with proper documentation.",
    "url": "lessons/contrib/codeql-alert-dismissal-false-positive.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "codewhale-git-push-yolo-task",
    "title": "CodeWhale 中 git push 的正确方式 — YOLO task + gh CLI",
    "domain": "contrib",
    "tags": [],
    "summary": "在 CodeWhale 的 Agent 模式中，`exec_shell` 工具不可用。需要执行 `git push` 时，不能直接用 shell 命令。",
    "url": "lessons/contrib/codewhale-git-push-yolo-task.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "cron-job-not-running",
    "title": "Cron 作业不执行 / 不生效排障",
    "domain": "contrib",
    "tags": [],
    "summary": "`crontab -e` 设置好后，作业从未执行。输出没有、日志没有、进程没有。",
    "url": "lessons/contrib/cron-job-not-running.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "cross-repo-contribution-strategy",
    "title": "Cross-Repo Contribution Strategy — Finding and Contributing to New Repos",
    "domain": "contrib",
    "tags": [
      "contrib",
      "strategy",
      "github",
      "open-source",
      "agent"
    ],
    "summary": "Agents and developers often get stuck contributing to the same repos. Finding new repos to contribute to requires systematic exploration.",
    "url": "lessons/contrib/cross-repo-contribution-strategy.md",
    "created": "2026-07-15",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "draft",
    "verified": true
  },
  {
    "id": "cross-sheet-name-merge-data-chaos",
    "title": "cross-sheet-name-merge-data-chaos",
    "domain": "contrib",
    "tags": [],
    "summary": "不同 Excel Sheet（如区域A/区域B）都有同名机器人（如 `R01`），直接按 `robotName` 字段聚合会把不同工位的机器人合并成一台，导致工序序列混乱、统计数据错误。",
    "url": "lessons/contrib/cross-sheet-name-merge-data-chaos.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "curl-request-troubleshoot",
    "title": "curl / wget 请求失败通用Diagnosis",
    "domain": "contrib",
    "tags": [],
    "summary": "`curl https://example.com` 返回空、报错或超时。不知道是 DNS、代理、证书还是目标服务的问题。",
    "url": "lessons/contrib/curl-request-troubleshoot.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "data-capping-equals-forging-data",
    "title": "data-capping-equals-forging-data",
    "domain": "contrib",
    "tags": [],
    "summary": "数据分析中，当数据超出阈值（如实际节拍超过工位节拍），把超出部分\"封顶\"到阈值值（如写成 100%），本质上是伪造满负荷数据。后续计算基于伪造数据得出错误结论。",
    "url": "lessons/contrib/data-capping-equals-forging-data.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "deepseek-tui-write-file-sandbox-worktree-git-path",
    "title": "deepseek tui write file sandbox worktree git path",
    "domain": "contrib",
    "tags": [],
    "summary": "在 Agent-Medici 项目的 search_knowledge.py v2 升级过程中，使用 DeepSeek TUI Agent 模式进行代码修改。操作环境为 WSL (Windows Subsystem for Linux)，仓库使用 Hydra worktree 管理。",
    "url": "lessons/contrib/deepseek-tui-write-file-sandbox-worktree-git-path.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "disk-space-cleanup",
    "title": "磁盘空间不足 / chroma_db_v4 CacheCleanup",
    "domain": "contrib",
    "tags": [],
    "summary": "写入文件或构建向量库时报 `No space left on device` / `ENOSPC`，hermes-hub 进程崩溃。",
    "url": "lessons/contrib/disk-space-cleanup.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-alarm-code-reference",
    "title": "fanuc-alarm-code-reference",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC 机器人在运行过程中会产生各类报警代码，现场工程师需要快速查询报警含义并采取正确的处理措施。本文整理 FANUC 常见报警代码的分类体系和处理要点。",
    "url": "lessons/contrib/fanuc-alarm-code-reference.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-alarm-severity-guide",
    "title": "fanuc-alarm-severity-guide",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC controllers display alarms with different severity levels, but engineers don't always understand the implications of each level — which ones stop the robo…",
    "url": "lessons/contrib/fanuc-alarm-severity-guide.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-auto-abort-on-fault-restart",
    "title": "fanuc-auto-abort-on-fault-restart",
    "domain": "contrib",
    "tags": [],
    "summary": "When enabling the teach pendant during auto mode, the robot faults and pauses the program. The user wants the robot to automatically abort and restart the main …",
    "url": "lessons/contrib/fanuc-auto-abort-on-fault-restart.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-backup-payload-extraction",
    "title": "fanuc-backup-payload-extraction",
    "domain": "contrib",
    "tags": [],
    "summary": "Given a FANUC robot backup directory, extract the payload (load mass, center of gravity, inertia) configuration. The backup contains 300+ files in proprietary b…",
    "url": "lessons/contrib/fanuc-backup-payload-extraction.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-backup-restore-guide",
    "title": "fanuc-backup-restore-guide",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC robot controllers support multiple backup types (full backup, mirror/image backup, auto backup) with different contents, restore procedures, and use cases…",
    "url": "lessons/contrib/fanuc-backup-restore-guide.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-communication-protocol-socket",
    "title": "fanuc-communication-protocol-socket",
    "domain": "contrib",
    "tags": [],
    "summary": "\"id\": \"fanuc-communication-protocol-socket\",",
    "url": "lessons/contrib/fanuc-communication-protocol-socket.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-dcs-safety-configuration",
    "title": "fanuc-dcs-safety-configuration",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC DCS (Dual Check Safety) is a critical safety system that uses independent dual CPUs to monitor robot position and speed. Misconfiguration can lead to safe…",
    "url": "lessons/contrib/fanuc-dcs-safety-configuration.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-do-not-found-in-program-reference-position",
    "title": "fanuc-do-not-found-in-program-reference-position",
    "domain": "contrib",
    "tags": [],
    "summary": "A digital output (e.g., DO[66]) is confirmed active on the robot, but searching all TP programs for \"DO[66]\" or \"DO[\" returns zero results. The output is being …",
    "url": "lessons/contrib/fanuc-do-not-found-in-program-reference-position.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-eip-omron-plc-connection",
    "title": "fanuc-eip-omron-plc-connection",
    "domain": "contrib",
    "tags": [],
    "summary": "在工业自动化项目中，需要将 **OMRON PLC** 与 **FANUC 机器人** 建立通讯连接。常见通讯方案（PROFINET、DeviceNet）通常需要为 FANUC 机器人额外购买专用通讯硬件卡，增加了系统成本。",
    "url": "lessons/contrib/fanuc-eip-omron-plc-connection.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-handling-robot-auto-drop-diagnosis",
    "title": "fanuc-handling-robot-auto-drop-diagnosis",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC 搬运机器人负责搬运车顶零件。零件到位后，销式快换耦合器（pin-type quick-change coupler）断开；点焊完成后重新连接。在此过程中，机器人**偶尔掉出自动模式**，需要手动按下电气控制面板上的复位和启动按钮才能恢复。",
    "url": "lessons/contrib/fanuc-handling-robot-auto-drop-diagnosis.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-intp-102-detect-joint-olp-whitespace",
    "title": "fanuc-intp-102-detect-joint-olp-whitespace",
    "domain": "contrib",
    "tags": [],
    "summary": "OLP tool (RoboDK) generates programs with `DETECT JOINT[3,22]` that throw INTP-102 (\"Code format is not valid\") on the controller. Manually typing the same comm…",
    "url": "lessons/contrib/fanuc-intp-102-detect-joint-olp-whitespace.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-io-marker-m-instruction",
    "title": "fanuc-io-marker-m-instruction",
    "domain": "contrib",
    "tags": [],
    "summary": "The M[] option appears in the I/O replace menu but is undocumented in standard TP programming guides. Users don't know what it does or when to use it.",
    "url": "lessons/contrib/fanuc-io-marker-m-instruction.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-karel-core-utility-modules",
    "title": "fanuc-karel-core-utility-modules",
    "domain": "contrib",
    "tags": [],
    "summary": "\"id\": \"fanuc-karel-core-utility-modules\",",
    "url": "lessons/contrib/fanuc-karel-core-utility-modules.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-karel-geometry-kinematics-layer",
    "title": "fanuc-karel-geometry-kinematics-layer",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC KAREL标准库缺少面向机器人应用的3D几何计算能力：",
    "url": "lessons/contrib/fanuc-karel-geometry-kinematics-layer.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-karel-http-api-webcontrol",
    "title": "fanuc-karel-http-api-webcontrol",
    "domain": "contrib",
    "tags": [],
    "summary": "需要通过HTTP接口远程控制FANUC机器人：",
    "url": "lessons/contrib/fanuc-karel-http-api-webcontrol.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-karel-ik-fk-quaternion-guide",
    "title": "fanuc-karel-ik-fk-quaternion-guide",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC KAREL机器人编程中，运动学和坐标变换操作容易出现以下问题：",
    "url": "lessons/contrib/fanuc-karel-ik-fk-quaternion-guide.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-karel-intp-316-call-error-motion-lock",
    "title": "fanuc-karel-intp-316-call-error-motion-lock",
    "domain": "contrib",
    "tags": [],
    "summary": "\"id\": \"fanuc-karel-intp-316-call-error-motion-lock\",",
    "url": "lessons/contrib/fanuc-karel-intp-316-call-error-motion-lock.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-karel-ka-boost-architecture",
    "title": "fanuc-karel-ka-boost-architecture",
    "domain": "contrib",
    "tags": [],
    "summary": "\"id\": \"fanuc-karel-ka-boost-architecture\",",
    "url": "lessons/contrib/fanuc-karel-ka-boost-architecture.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-karel-kl-pose-api-reference",
    "title": "fanuc-karel-kl-pose-api-reference",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC KAREL标准库仅提供基础的PR读写和简单位姿操作，缺少以下关键能力：",
    "url": "lessons/contrib/fanuc-karel-kl-pose-api-reference.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-karel-unit-testing-kunit",
    "title": "fanuc-karel-unit-testing-kunit",
    "domain": "contrib",
    "tags": [],
    "summary": "\"id\": \"fanuc-karel-unit-testing-kunit\",",
    "url": "lessons/contrib/fanuc-karel-unit-testing-kunit.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-karel-uv-to-xyzwpr-pipeline",
    "title": "fanuc-karel-uv-to-xyzwpr-pipeline",
    "domain": "contrib",
    "tags": [],
    "summary": "5轴DLP 3D打印切片器需要将2D切片几何(从SVG/DXF文件导入)转换为机器人可执行的XYZWPR运动指令。整个流程涉及多个阶段：2D几何处理、路径规划排序、坐标系转换、运动插值、多层迭代、硬件控制。每个阶段需要不同的算法和数据结构。",
    "url": "lessons/contrib/fanuc-karel-uv-to-xyzwpr-pipeline.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-kl-1086-is-line-number-not-error-code",
    "title": "fanuc-kl-1086-is-line-number-not-error-code",
    "domain": "contrib",
    "tags": [],
    "summary": "\"id\": \"fanuc-kl-1086-is-line-number-not-error-code\",",
    "url": "lessons/contrib/fanuc-kl-1086-is-line-number-not-error-code.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-kl-bytes-ahead-is-builtin-procedure",
    "title": "fanuc-kl-bytes-ahead-is-builtin-procedure",
    "domain": "contrib",
    "tags": [],
    "summary": "KL 编译报错时，误认为 BYTES_AHEAD 是禁用标识符或非法调用，将其从 MM_RCV_NTFY.kl 中删除。",
    "url": "lessons/contrib/fanuc-kl-bytes-ahead-is-builtin-procedure.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-kl-err-abort-vs-err-pause",
    "title": "fanuc-kl-err-abort-vs-err-pause",
    "domain": "contrib",
    "tags": [],
    "summary": "IPC 通信错误时未区分 ERR_ABORT 和 ERR_PAUSE，导致程序号丢失。",
    "url": "lessons/contrib/fanuc-kl-err-abort-vs-err-pause.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-kl-mm-module-h-no-routine",
    "title": "fanuc-kl-mm-module-h-no-routine",
    "domain": "contrib",
    "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",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-mi-standard-software-instructions",
    "title": "fanuc-mi-standard-software-instructions",
    "domain": "contrib",
    "tags": [],
    "summary": "MI Standard Software is a comprehensive instruction library for automotive FANUC robots, covering PLC communication, tool change, spot welding, gluing, SPR rive…",
    "url": "lessons/contrib/fanuc-mi-standard-software-instructions.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-payload-estimation",
    "title": "fanuc-payload-estimation",
    "domain": "contrib",
    "tags": [],
    "summary": "FANUC robots require accurate payload (load) configuration for safe and precise motion. Incorrect payload settings cause poor motion accuracy, excessive motor l…",
    "url": "lessons/contrib/fanuc-payload-estimation.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-profinet-32bit-real-value-transfer",
    "title": "fanuc-profinet-32bit-real-value-transfer",
    "domain": "contrib",
    "tags": [],
    "summary": "SCARA 12iA + R-30iB Compact Plus needs to send/receive 32-bit real values via Profinet, but GI/GO are limited to 16-bit integer groups. KAREL is not available.",
    "url": "lessons/contrib/fanuc-profinet-32bit-real-value-transfer.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-profinet-io-software-config",
    "title": "fanuc-profinet-io-software-config",
    "domain": "contrib",
    "tags": [],
    "summary": "\"id\": \"fanuc-profinet-io-software-config\",",
    "url": "lessons/contrib/fanuc-profinet-io-software-config.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-profinet-s7-1200-external-startup",
    "title": "fanuc-profinet-s7-1200-external-startup",
    "domain": "contrib",
    "tags": [],
    "summary": "在汽车焊装产线中，需要将 FANUC 机器人与 Siemens S7-1200 PLC 通过 **PROFINET** 协议建立通讯，并配置外部启动功能，使 PLC 能够远程触发机器人程序执行。这是工业自动化中常见的集成场景：S7-1200 作为 PROFINET Controller，FANUC 机器人（配备 PRO…",
    "url": "lessons/contrib/fanuc-profinet-s7-1200-external-startup.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-program-inspection-methodology",
    "title": "fanuc-program-inspection-methodology",
    "domain": "contrib",
    "tags": [],
    "summary": "Robot programs need systematic inspection before production to catch signal mapping errors, safety violations, and logic bugs. Without a structured methodology,…",
    "url": "lessons/contrib/fanuc-program-inspection-methodology.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-python-interface-fanucpy",
    "title": "fanuc-python-interface-fanucpy",
    "domain": "contrib",
    "tags": [],
    "summary": "\"id\": \"fanuc-python-interface-fanucpy\",",
    "url": "lessons/contrib/fanuc-python-interface-fanucpy.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-r-2000ic-retrieval-fix",
    "title": "fanuc-r-2000ic-retrieval-fix",
    "domain": "contrib",
    "tags": [],
    "summary": "访问者问\"fanuc r-2000ic 系列所有机器人的最大速度\"，RAG 返回了 KUKA Series 2000 的数据。",
    "url": "lessons/contrib/fanuc-r-2000ic-retrieval-fix.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-rsr-program-select-logic",
    "title": "fanuc-rsr-program-select-logic",
    "domain": "contrib",
    "tags": [],
    "summary": "以 FANUC R-2000IB 机器人为例，分享一个使用 **RSR 启动模式** 的搬运程序示例。程序综合运用了运动指令、寄存器索引、OFFSET 偏移和 SELECT 分支逻辑，是 FANUC TP 编程的典型实践。",
    "url": "lessons/contrib/fanuc-rsr-program-select-logic.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "fanuc-spot-wear-max-lookup",
    "title": "fanuc-spot-wear-max-lookup",
    "domain": "contrib",
    "tags": [],
    "summary": "Need to find the maximum electrode tip wear amount (最大磨损量) for a FANUC spot welding robot. The value is stored in the `sysspot.sv` system variable file, which u…",
    "url": "lessons/contrib/fanuc-spot-wear-max-lookup.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "fanuc-tcp-tool-configuration-standards",
    "title": "fanuc-tcp-tool-configuration-standards",
    "domain": "contrib",
    "tags": [],
    "summary": "In automotive robot applications, TCP (Tool Center Point) and tool configuration must follow specific standards for each process type (spot welding, gluing, SPR…",
    "url": "lessons/contrib/fanuc-tcp-tool-configuration-standards.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-agent-display-settings",
    "title": "feishu agent display settings",
    "domain": "contrib",
    "tags": [],
    "summary": "某些 Agent 默认会在飞书聊天中显示工具调用信息（如 \"🔧 工具 #5: Bash\"）和上下文占用提示（如 \"[ctx: ~0%]\"），影响用户体验。",
    "url": "lessons/contrib/feishu-agent-display-settings.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "feishu-block-api-false-success",
    "title": "feishu-block-api-false-success",
    "domain": "contrib",
    "tags": [],
    "summary": "\"title\": \"Feishu Block API returns code=0 but creates zero blocks under rate limiting\",",
    "url": "lessons/contrib/feishu-block-api-false-success.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-block-batch-limit",
    "title": "feishu block batch limit",
    "domain": "contrib",
    "tags": [],
    "summary": "批量创建 block 时，每次超过约 20 个触发限流或静默截断。",
    "url": "lessons/contrib/feishu-block-batch-limit.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-block-type-values-limits",
    "title": "feishu block type values limits",
    "domain": "contrib",
    "tags": [],
    "summary": "飞书 block API 的 type 字段使用数字 ID，错误值导致静默失败或 400。",
    "url": "lessons/contrib/feishu-block-type-values-limits.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-bot-setup-complete",
    "title": "feishu bot setup complete",
    "domain": "contrib",
    "tags": [],
    "summary": "1. Follow the solution steps in order",
    "url": "lessons/contrib/feishu-bot-setup-complete.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-doc-delete-blocks-by-range-pitfall",
    "title": "feishu-doc-delete-blocks-by-range-pitfall",
    "domain": "contrib",
    "tags": [],
    "summary": "调用飞书 `doc_delete_blocks_by_range` 时只传了 `start=0` 没传 `end`，想删5行残留旧内容，结果工具从 start 一直删到文档末尾，**删掉 172 个块，整篇文档被清空**（含标题、阶段性汇报、backup 全部内容）。用户靠飞书历史版本才恢复。",
    "url": "lessons/contrib/feishu-doc-delete-blocks-by-range-pitfall.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-doc-url-use-api-return",
    "title": "feishu doc url use api return",
    "domain": "contrib",
    "tags": [],
    "summary": "创建 Feishu 云文档后，猜测 URL 格式为 `https://feishu.cn/document/...`，用户连续3次无法打开文档。",
    "url": "lessons/contrib/feishu-doc-url-use-api-return.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-markdown-table-not-rendered",
    "title": "feishu markdown table not rendered",
    "domain": "contrib",
    "tags": [],
    "summary": "在飞书 IM 消息中使用 `post` 类型的富文本消息发送 Markdown 表格，表格显示为空白或原始分隔线（`|------|`），而不是渲染后的表格。",
    "url": "lessons/contrib/feishu-markdown-table-not-rendered.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "feishu-mcp-server-deepseek-tui-setup",
    "title": "DeepSeek TUI — Feishu MCP Server Setup & Permission Boundaries",
    "domain": "contrib",
    "tags": [],
    "summary": "需要在 DeepSeek TUI 中在线操作飞书云文档（docx），通过 MCP 协议暴露飞书 API。",
    "url": "lessons/contrib/feishu-mcp-server-deepseek-tui-setup.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-upload-file-type-opus",
    "title": "feishu upload file type opus",
    "domain": "contrib",
    "tags": [],
    "summary": "Feishu `im/v1/files` 上传接口调用失败，返回 `234001 Invalid request param`。",
    "url": "lessons/contrib/feishu-upload-file-type-opus.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-webhook-url-env-config",
    "title": "feishu webhook url env config",
    "domain": "contrib",
    "tags": [],
    "summary": "Feishu webhook URL、app_id、app_secret 被误提交到 git 仓库，",
    "url": "lessons/contrib/feishu-webhook-url-env-config.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-websocket-404-error-http-webhook-required",
    "title": "feishu websocket 404 error http webhook required",
    "domain": "contrib",
    "tags": [],
    "summary": "问题: 飞书 WebSocket 接收消息 API 返回 404 错误。测试端点: wss://open.feishu.cn/open-apis/bot/v3/ws, /bot/v2/ws, /im/v1/ws, /im/v2/ws, /webhook/v1/ws。所有端点均返回 404。修复: 消息发送功能正常 (通…",
    "url": "lessons/contrib/feishu-websocket-404-error-http-webhook-required.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "feishu-wiki-batch-download",
    "title": "Feishu WikiBatch Download：文件类型Handling策略",
    "domain": "contrib",
    "tags": [],
    "summary": "从企业知识库批量下载文件时，不同文件类型需要不同的提取策略。直接API调用无法处理所有类型。",
    "url": "lessons/contrib/feishu-wiki-batch-download.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "ffmpeg-audio-libopus-not-ogg",
    "title": "ffmpeg audio libopus not ogg",
    "domain": "contrib",
    "tags": [],
    "summary": "FFmpeg 输出 OGG 文件为 0 字节。",
    "url": "lessons/contrib/ffmpeg-audio-libopus-not-ogg.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "firewall-port-open-not-public",
    "title": "firewall port open not public",
    "domain": "contrib",
    "tags": [],
    "summary": "为 wcferry 开放 Windows 防火墙端口 10086 时，误以为这是\"内网穿透\"操作，担心安全性。",
    "url": "lessons/contrib/firewall-port-open-not-public.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "frontmatter-parsing-edge-cases",
    "title": "frontmatter-parsing-edge-cases",
    "domain": "contrib",
    "tags": [],
    "summary": "1. Create a test file with missing frontmatter: `echo \"# Test\" > /tmp/test.md`",
    "url": "lessons/contrib/frontmatter-parsing-edge-cases.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "game-mcp-end-turn-conflict-409",
    "title": "Game MCP: End Turn Returns 409 Conflict",
    "domain": "contrib",
    "tags": [],
    "summary": "When sending an end_turn command via MCP, the game returns a 409 Conflict HTTP status. However, the game state still progresses normally.",
    "url": "lessons/contrib/game-mcp-end-turn-conflict-409.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "game-mcp-game-over-restart-flow",
    "title": "Game MCP: GAME OVER Restart Flow",
    "domain": "contrib",
    "tags": [],
    "summary": "After reaching a GAME OVER state, restarting the game via MCP requires a specific sequence of commands. Using the wrong flow leads to errors or stale game state…",
    "url": "lessons/contrib/game-mcp-game-over-restart-flow.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "game-mcp-rare-relic-freeze",
    "title": "game mcp rare relic freeze",
    "domain": "contrib",
    "tags": [],
    "summary": "When using MCP to play a turn-based strategy game, selecting a rare relic option causes the game client to freeze or hang indefinitely.",
    "url": "lessons/contrib/game-mcp-rare-relic-freeze.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "gateway-hang-watchdog-recovery",
    "title": "Gateway 进程挂死未崩溃 — watchdog 自动Recovery",
    "domain": "contrib",
    "tags": [],
    "summary": "Hermes Agent 频繁崩溃，用户反映\"卡死\"。实际调查发现是 **WSL PTY 断连**导致 CLI 崩溃，而非 Gateway 本身问题。",
    "url": "lessons/contrib/gateway-hang-watchdog-recovery.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "gfw-tls-sni-block-pattern",
    "title": "gfw-tls-sni-block-pattern",
    "domain": "contrib",
    "tags": [],
    "summary": "Web scraping tools (curl, Playwright, scrapling, Safari MCP) all fail to connect to certain domains (e.g., reddit.com, stackoverflow.com) from networks behind t…",
    "url": "lessons/contrib/gfw-tls-sni-block-pattern.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "gfw-tls-sni-blocking-tool-layer-ineffective",
    "title": "gfw-tls-sni-blocking-tool-layer-ineffective",
    "domain": "contrib",
    "tags": [],
    "summary": "从中国大陆抓取 Reddit/StackOverflow 等站点时，所有工具层方案（curl、Playwright、scrapling、Safari MCP、WebFetch、Agent-Reach Jina Reader）全部超时失败。Agent 误判为\"工具配置问题\"，反复尝试不同工具浪费大量时间。",
    "url": "lessons/contrib/gfw-tls-sni-blocking-tool-layer-ineffective.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "ghidra-mcp-server-reverse-engineering",
    "title": "ghidra-mcp-server-reverse-engineering",
    "domain": "contrib",
    "tags": [],
    "summary": "Reverse engineering binaries is manual, time-consuming work. Ghidra is powerful but requires deep expertise. LLMs can reason about code but can't interact with …",
    "url": "lessons/contrib/ghidra-mcp-server-reverse-engineering.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "git-credential-helper-gh-path-mismatch",
    "title": "gh credential helper 路径Error导致 git push 静默失败",
    "domain": "contrib",
    "tags": [],
    "summary": "执行 `git push` 时卡住或报错：",
    "url": "lessons/contrib/git-credential-helper-gh-path-mismatch.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "git-credentials-and-node-id-setup",
    "title": "Git Credentials 和 Node ID Setup",
    "domain": "contrib",
    "tags": [],
    "summary": "在新环境中使用 git 操作时，如果没有正确配置凭证和节点标识，会遇到：",
    "url": "lessons/contrib/git-credentials-and-node-id-setup.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "git-credentials-automation",
    "title": "Git 凭证Setup — Automation push 免密码",
    "domain": "contrib",
    "tags": [],
    "summary": "脚本自动执行 `git push` 时弹出用户名密码输入框，导致自动化流程卡住。",
    "url": "lessons/contrib/git-credentials-automation.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "git-merge-conflict-resolution",
    "title": "Git 合并ConflictHandling — 手动解决最佳实践",
    "domain": "contrib",
    "tags": [],
    "summary": "`git pull` 或 `git merge` 时报 `CONFLICT`，文件里出现 `<<<<<<<` 标记。不知如何选择。",
    "url": "lessons/contrib/git-merge-conflict-resolution.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "git-push-without-shell-agent",
    "title": "Git Push 的正确方式 — 在受限 Agent 环境中推送代码",
    "domain": "contrib",
    "tags": [],
    "summary": "在某些 Agent 平台的安全模式下，shell 工具不可用。需要执行 `git push` 时，不能直接用 shell 命令。",
    "url": "lessons/contrib/git-push-without-shell-agent.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "git-tls-handshake-failure",
    "title": "GitHub TLS 握手失败 — gnutls_handshake() Error",
    "domain": "contrib",
    "tags": [],
    "summary": "`git pull` 或 `git push` 时报：",
    "url": "lessons/contrib/git-tls-handshake-failure.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "github-401-credential-lookup",
    "title": "GitHub API 401 后本地凭证查找顺序",
    "domain": "contrib",
    "tags": [],
    "summary": "调用 GitHub API 时收到 `{\"message\": \"Bad credentials\"}` 或 HTTP 401/403，第一反应是 token 无效要去问用户要新的。但本地往往已经有可用凭证，跳过检查会让用户白跑一趟。",
    "url": "lessons/contrib/github-401-credential-lookup.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "github-api-pr-issue-management",
    "title": "github-api-pr-issue-management",
    "domain": "contrib",
    "tags": [],
    "summary": "Need to manage PRs and issues programmatically via GitHub API when `gh` CLI is not authenticated or unavailable.",
    "url": "lessons/contrib/github-api-pr-issue-management.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "github-dns-443-block-hosts-workaround",
    "title": "GitHub DNS 污染/443端口不通 — hosts 备用 IP 方案",
    "domain": "contrib",
    "tags": [],
    "summary": "`git push` / `git fetch` 持续超时或报 TLS 握手错误：",
    "url": "lessons/contrib/github-dns-443-block-hosts-workaround.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "gpt-sovits-hubert-16khz",
    "title": "gpt sovits hubert 16khz",
    "domain": "contrib",
    "tags": [],
    "summary": "HuBERT SSL 特征提取失败，音频克隆效果异常。",
    "url": "lessons/contrib/gpt-sovits-hubert-16khz.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "gpt-sovits-name2text-arpabet",
    "title": "gpt sovits name2text arpabet",
    "domain": "contrib",
    "tags": [],
    "summary": "训练时数据加载器逐字查 phoneme 词典，全部 KeyError。",
    "url": "lessons/contrib/gpt-sovits-name2text-arpabet.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "gpt-sovits-ref-free-bug",
    "title": "gpt sovits ref free bug",
    "domain": "contrib",
    "tags": [],
    "summary": "提供了女声样本，生成出来却是男声或通用音色。",
    "url": "lessons/contrib/gpt-sovits-ref-free-bug.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "hub-credential-gateway-vs-hub",
    "title": "Hub Hermes 凭证体系 — Gateway vs Hub 各自读哪里",
    "domain": "contrib",
    "tags": [],
    "summary": "Hub 有两套配置体系，Gateway 和 Hub 读取不同的凭证位置，容易混淆。",
    "url": "lessons/contrib/hub-credential-gateway-vs-hub.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "hub-feishu-wsclient-start-never-called",
    "title": "hub feishu wsclient start never called",
    "domain": "contrib",
    "tags": [],
    "summary": "Hub 配置了 `im.message.receive_v1` 和 `p2p_card_action.trigger` 回调，但从未收到飞书消息。",
    "url": "lessons/contrib/hub-feishu-wsclient-start-never-called.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "issue-comment-newbie-welcome",
    "title": "Auto-Welcome Newcomers via issue_comment Event",
    "domain": "contrib",
    "tags": [],
    "summary": "开源项目设置 Good First Issues 后，新手贡献者往往不知道如何开始。需要一种自动化的方式在贡献者评论 Issue 时立即给予引导。",
    "url": "lessons/contrib/issue-comment-newbie-welcome.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "js-dead-code-chain-break",
    "title": "js dead code chain break",
    "domain": "contrib",
    "tags": [],
    "summary": "JavaScript 是单线程事件驱动模型。同步执行线程中任何一个未捕获的异常（TypeError、ReferenceError 等）都会导致**整个执行线程中断**，该线程后续所有代码不再执行。常见场景：",
    "url": "lessons/contrib/js-dead-code-chain-break.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "json-parse-failure-handling",
    "title": "JSON 解析失败Handling — 截断 / 格式Error",
    "domain": "contrib",
    "tags": [],
    "summary": "从 LLM 输出或 API 返回中解析 JSON 时报 `json.decoder.JSONDecodeError`。常见于模型输出被截断、前后有多余字符。",
    "url": "lessons/contrib/json-parse-failure-handling.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "kb-4sigma-quality-audit-pipeline",
    "title": "Knowledge Base 4-Sigma Quality Audit Pipeline",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:medium",
      "node:hermes-wsl"
    ],
    "summary": "After continuous document imports, the RAG knowledge base developed data contamination, version confusion, inconsistent sources, and other issues that affected …",
    "url": "lessons/contrib/kb-4sigma-quality-audit-pipeline.md",
    "created": "2026-05-03",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "knowledge-graph-ux-patterns-from-high-star-projects",
    "title": "knowledge graph ux patterns from high star projects",
    "domain": "contrib",
    "tags": [],
    "summary": "知识图谱可视化项目存在典型问题: 节点过多导致信息过载、关系缺乏上下文、无法聚焦局部视图。",
    "url": "lessons/contrib/knowledge-graph-ux-patterns-from-high-star-projects.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "lesson-06-git-push-credential-helper-403",
    "title": "Git Push to Fork Repo: 'Permission Denied to Other User' — Wrong PAT Selected by Helper",
    "domain": "devops",
    "tags": [],
    "summary": "> Author: 太阳 (Misaka10004)",
    "url": "lessons/contrib/lesson-06-git-push-credential-helper-403.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-07-uv-venv-seed-fix-no-pip",
    "title": "Ubuntu WSL Python venv Missing pip — uv venv --seed Fixes Without sudo",
    "domain": "devops",
    "tags": [],
    "summary": "> Author: 太阳 (Misaka10004)",
    "url": "lessons/contrib/lesson-07-uv-venv-seed-fix-no-pip.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-08-pip-https-proxy-clash",
    "title": "pip install HTTPS Timeout from WSL — Prepend HTTPS_PROXY=http://172.19.128.1:7890",
    "domain": "devops",
    "tags": [],
    "summary": "> Author: 太阳 (Misaka10004)",
    "url": "lessons/contrib/lesson-08-pip-https-proxy-clash.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-09-v2ex-api-show-endpoint-unstable",
    "title": "V2EX API /api/topics/show.json Unstable — Use r.jina.ai Instead",
    "domain": "scraping",
    "tags": [],
    "summary": "> Author: 太阳 (Misaka10004)",
    "url": "lessons/contrib/lesson-09-v2ex-api-show-endpoint-unstable.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-10-agent-reach-doctor-baseline",
    "title": "Agent-Reach v1.5.0 doctor Baseline: 4/15 Channels Available Without Login",
    "domain": "tooling",
    "tags": [],
    "summary": "> Author: 太阳 (Misaka10004)",
    "url": "lessons/contrib/lesson-10-agent-reach-doctor-baseline.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-10-microservices-latency-math",
    "title": "lesson-10-microservices-latency-math",
    "domain": "contrib",
    "tags": [],
    "summary": "微服务的承诺：可扩展、可维护、快速。现实：对大多数系统，微服务只增加了延迟、复杂度和故障点。",
    "url": "lessons/contrib/lesson-10-microservices-latency-math.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-11-github-commit-signing",
    "title": "lesson-11-github-commit-signing",
    "domain": "contrib",
    "tags": [],
    "summary": "任何人都可以用你的名字和邮箱设置 git config，推送提交，在 GitHub 上显示为你的作品。唯一的区别：没有 \"Verified\" 徽章。",
    "url": "lessons/contrib/lesson-11-github-commit-signing.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-13-aws-lambda-microvms",
    "title": "lesson-13-aws-lambda-microvms",
    "domain": "contrib",
    "tags": [],
    "summary": "AI 编码助手、交互式代码环境、漏洞扫描器等需要为每个用户提供隔离的执行环境。VM 隔离强但启动慢（分钟级），容器快但共享内核需要大量加固。",
    "url": "lessons/contrib/lesson-13-aws-lambda-microvms.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-14-api-pagination-design",
    "title": "lesson-14-api-pagination-design",
    "domain": "contrib",
    "tags": [],
    "summary": "API 分页设计选择不当会导致性能问题（OFFSET 大偏移量慢）、数据重复/遗漏（并发写入时）、用户体验差。",
    "url": "lessons/contrib/lesson-14-api-pagination-design.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-15-cloudflare-workflows-durable",
    "title": "lesson-15-cloudflare-workflows-durable",
    "domain": "contrib",
    "tags": [],
    "summary": "Serverless 函数是无状态的。多步骤流程（审批、数据处理、编排）需要跨步骤持久化状态，传统方式需要外部数据库或消息队列。",
    "url": "lessons/contrib/lesson-15-cloudflare-workflows-durable.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-16-aws-ecs-high-resolution-metrics",
    "title": "lesson-16-aws-ecs-high-resolution-metrics",
    "domain": "contrib",
    "tags": [],
    "summary": "ECS 默认 CloudWatch 指标 1 分钟粒度，自动扩缩容响应慢。流量突增时，1 分钟才能触发扩容，用户体验下降。",
    "url": "lessons/contrib/lesson-16-aws-ecs-high-resolution-metrics.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-17-segmentfault-mcp-standardization",
    "title": "lesson-17-segmentfault-mcp-standardization",
    "domain": "contrib",
    "tags": [],
    "summary": "AI Agent 调用外部工具时，每个 LLM 提供商的 function calling 格式不同，每个工具需要单独适配。工具越多，维护成本越高。",
    "url": "lessons/contrib/lesson-17-segmentfault-mcp-standardization.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-18-database-performance-indexing",
    "title": "lesson-18-database-performance-indexing",
    "domain": "contrib",
    "tags": [],
    "summary": "慢查询是大多数 Web 应用的性能瓶颈。缺少索引、全表扫描、N+1 查询是最常见的原因。",
    "url": "lessons/contrib/lesson-18-database-performance-indexing.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-19-grpc-openapi-rest-comparison",
    "title": "lesson-19-grpc-openapi-rest-comparison",
    "domain": "contrib",
    "tags": [],
    "summary": "选择 API 协议时，REST、OpenAPI、gRPC 各有优劣，没有清晰的选择指南。",
    "url": "lessons/contrib/lesson-19-grpc-openapi-rest-comparison.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-20-api-design-principles",
    "title": "lesson-20-api-design-principles",
    "domain": "contrib",
    "tags": [],
    "summary": "API 设计不一致导致开发者困惑：有些端点用 POST 创建，有些用 PUT；有些返回 201，有些返回 200；有些用 camelCase，有些用 snake_case。",
    "url": "lessons/contrib/lesson-20-api-design-principles.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-9-redis-postgresql-replacement",
    "title": "lesson-9-redis-postgresql-replacement",
    "domain": "contrib",
    "tags": [],
    "summary": "典型 Web 应用同时用 PostgreSQL（持久化）+ Redis（缓存/PubSub/队列），两个数据库 = 两个备份点、两个监控、两个故障点。Redis 用 RAM（贵），持久化复杂。",
    "url": "lessons/contrib/lesson-9-redis-postgresql-replacement.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-management-standardization",
    "title": "lesson-management-standardization",
    "domain": "contrib",
    "tags": [],
    "summary": "Over 180 lessons accumulated in the MisakaNet knowledge base with significant quality and consistency issues:",
    "url": "lessons/contrib/lesson-management-standardization.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-pep668-homebrew-externally-managed",
    "title": "macOS Homebrew Python: pip install Blocked by PEP 668 externally-managed-environment",
    "domain": "devops",
    "tags": [
      "python",
      "pip",
      "homebrew",
      "macos",
      "pep-668",
      "venv",
      "pyyaml"
    ],
    "summary": "> Author: zsxh1990",
    "url": "lessons/contrib/lesson-pep668-homebrew-externally-managed.md",
    "created": "2026-07-09",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "draft",
    "verified": false
  },
  {
    "id": "lesson-quality-requirements",
    "title": "lesson-quality-requirements",
    "domain": "contrib",
    "tags": [],
    "summary": "\"title\": \"Lesson Quality Requirements: SKP Format\",",
    "url": "lessons/contrib/lesson-quality-requirements.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-review-3-devops-platform-engineering",
    "title": "lesson-review-3-devops-platform-engineering",
    "domain": "contrib",
    "tags": [],
    "summary": "The \"DevOps hero\" approach — trying to master every tool (Docker, K8s, Terraform, Ansible, Jenkins, ArgoCD, Prometheus, Grafana) — leads to burnout. 80% of time…",
    "url": "lessons/contrib/lesson-review-3-devops-platform-engineering.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-review-4-mcp-bedrock-integration",
    "title": "lesson-review-4-mcp-bedrock-integration",
    "domain": "contrib",
    "tags": [],
    "summary": "AI Agent 调用外部工具（S3、DynamoDB、内部 API）时，每个工具都要写 function calling schema 和调用逻辑。工具一多，维护成本很高，没有标准化方案。",
    "url": "lessons/contrib/lesson-review-4-mcp-bedrock-integration.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-review-5-eks-version-rollback",
    "title": "lesson-review-5-eks-version-rollback",
    "domain": "contrib",
    "tags": [],
    "summary": "升级 Kubernetes 控制平面是单向操作——开源 K8s 不支持控制平面回滚。团队因此延迟升级，错过安全补丁。",
    "url": "lessons/contrib/lesson-review-5-eks-version-rollback.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-review-6-cloudflare-x402-monetization",
    "title": "lesson-review-6-cloudflare-x402-monetization",
    "domain": "contrib",
    "tags": [],
    "summary": "Web 30 年来的经济模式是\"内容换注意力\"（广告/订阅/电商）。AI Agent 时代，Agent 不看广告、不订阅、不浏览——传统变现模式失效。",
    "url": "lessons/contrib/lesson-review-6-cloudflare-x402-monetization.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-review-7-cloudflare-saga-rollbacks",
    "title": "lesson-review-7-cloudflare-saga-rollbacks",
    "domain": "contrib",
    "tags": [],
    "summary": "Durable multi-step workflows (e.g., fund transfer) can leave systems in inconsistent state when a middle step fails. Step 1 succeeds (debit), Step 2 fails (cred…",
    "url": "lessons/contrib/lesson-review-7-cloudflare-saga-rollbacks.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-review-8-cloudflare-ai-traffic-options",
    "title": "lesson-review-8-cloudflare-ai-traffic-options",
    "domain": "contrib",
    "tags": [],
    "summary": "AI crawlers take content and send nothing back. Small sites face a Faustian bargain: show up in search and let AI train on you, or risk losing discoverability.",
    "url": "lessons/contrib/lesson-review-8-cloudflare-ai-traffic-options.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lesson-template-network",
    "title": "Network Domain Lesson Template",
    "domain": "network",
    "tags": [
      "http",
      "dns",
      "proxy",
      "ssl",
      "websocket",
      "timeout",
      "template"
    ],
    "summary": "Describe the network-related issue encountered.",
    "url": "lessons/contrib/lesson-template-network.md",
    "created": "2026-07-13",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "lesson_file_line_number_corruption",
    "title": "Before — inspect raw first line",
    "domain": "contrib",
    "tags": [],
    "summary": "You saved a file's content from terminal output (using `cat -n`, `sed -n '...p'`, or `less -N`), but the file won't render/compile/run correctly. HTML pages sho…",
    "url": "lessons/contrib/lesson_file_line_number_corruption.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "lessons-md-fix-heading-block-type",
    "title": "lessons md fix heading block type",
    "domain": "contrib",
    "tags": [],
    "summary": "[assistant] 还有一处需要修正：image block 的描述不准确——它返回了有效的 block_id（blocks_created=1），只是 token 被清空导致图片不显示。",
    "url": "lessons/contrib/lessons-md-fix-heading-block-type.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "maintainer-feedback-iteration",
    "title": "Maintainer Feedback Iteration — Address Blockers, Not Just Comments",
    "domain": "contrib",
    "tags": [
      "contrib",
      "maintainer",
      "feedback",
      "iteration",
      "pr"
    ],
    "summary": "When maintainers provide feedback on PRs, contributors often address surface-level comments while missing the core blockers. This leads to multiple review cycle…",
    "url": "lessons/contrib/maintainer-feedback-iteration.md",
    "created": "2026-07-15",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "draft",
    "verified": true
  },
  {
    "id": "mcp-context-mode-98-reduction",
    "title": "mcp-context-mode-98-reduction",
    "domain": "contrib",
    "tags": [],
    "summary": "Every MCP tool call in Claude Code dumps raw data into the 200K context window. A Playwright snapshot costs 56 KB. Twenty GitHub issues cost 59 KB. One access l…",
    "url": "lessons/contrib/mcp-context-mode-98-reduction.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "mcp-registry-readiness-requires-qa-before-promotion",
    "title": "MCP Registry Readiness Requires QA Before Promotion",
    "domain": "mcp",
    "tags": [
      "mcp",
      "registry",
      "qa",
      "glama",
      "tooling"
    ],
    "summary": "Submitting an MCP server to a public registry before its smoke tests, tool descriptions, and user-facing install path are ready can waste the first discovery wa…",
    "url": "lessons/contrib/mcp-registry-readiness-requires-qa-before-promotion.md",
    "created": "2026-07-17",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "mcp-server-direct-handler-testing",
    "title": "mcp-server-direct-handler-testing",
    "domain": "contrib",
    "tags": [],
    "summary": "MCP Server 使用 stdio 传输（stdin/stdout JSON-RPC），测试时需要启动子进程、写入 stdin、解析 stdout。这种方式：",
    "url": "lessons/contrib/mcp-server-direct-handler-testing.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "misakanet-heal-engine-bootstrap-workflow",
    "title": "MisakaNet --heal Engine Bootstrap Workflow",
    "domain": "contrib",
    "tags": [],
    "summary": "MisakaNet's `search_knowledge.py --heal` is the **end-to-end** error triage pipeline that turns a CLI fatal error into a search against the swarm's shared lesso…",
    "url": "lessons/contrib/misakanet-heal-engine-bootstrap-workflow.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "misakanet-heal-ux-gap-queue-lesson-flag-mismatch",
    "title": "MisakaNet --heal UX Gap — Suggested queue_lesson.py Command Uses Wrong Flag",
    "domain": "contrib",
    "tags": [],
    "summary": "`search_knowledge.py --heal` (line 188-194) prints suggested `queue_lesson.py` commands to help agents submit a lesson for an unmatched signature. The suggested…",
    "url": "lessons/contrib/misakanet-heal-ux-gap-queue-lesson-flag-mismatch.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "misakanet-refactor-v2-review",
    "title": "misakanet refactor v2 review",
    "domain": "contrib",
    "tags": [],
    "summary": "MisakaNet 早期架构照搬了\"中心协调网络\"的设计——A2A 实时通信、飞书 WebSocket 长连接、交互式卡片仲裁、中心化 Hub。这些功能听起来高级，但实际使用中暴露了三个问题：",
    "url": "lessons/contrib/misakanet-refactor-v2-review.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "model-output-fix",
    "title": "模型输出截断 / JSON 解析失败Handling",
    "domain": "contrib",
    "tags": [],
    "summary": "模型返回的内容不完整（truncated），或者 JSON 解析失败（`json.decoder.JSONDecodeError`），导致后续处理流程中断。",
    "url": "lessons/contrib/model-output-fix.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "model-switch-script-pattern",
    "title": "多模型Switch脚本模式 — 双 Agent 模型管理",
    "domain": "contrib",
    "tags": [],
    "summary": "> Domain: devops | Tags: model-switching, proxy, config-management",
    "url": "lessons/contrib/model-switch-script-pattern.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "multi-forum-scraping-architecture",
    "title": "multi-forum-scraping-architecture",
    "domain": "contrib",
    "tags": [],
    "summary": "Scraping multiple technical forums requires different approaches per site. Some have APIs, some require browser automation, some are behind anti-bot protection.…",
    "url": "lessons/contrib/multi-forum-scraping-architecture.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "openai-compatible-api-call",
    "title": "OpenAI 兼容 API 的通用调用格式",
    "domain": "contrib",
    "tags": [],
    "summary": "部署了 LLM 服务（vLLM/Ollama/本地推理）后，不知道怎么用 API 调用。各框架接口不一。",
    "url": "lessons/contrib/openai-compatible-api-call.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "openclaw-fatal-error-hook-protocol",
    "title": "OPENCLAW_ERROR_HANDLER — Standard protocol for CLI fatal error external hooks",
    "domain": "contrib",
    "tags": [],
    "summary": "CLI tools and AI agents (OpenClaw, Hermes, etc.) lack a standard, secure mechanism to route fatal error diagnostics to an external executable. Existing approach…",
    "url": "lessons/contrib/openclaw-fatal-error-hook-protocol.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "openclaw-gateway-dynamic-module-missing",
    "title": "openclaw gateway dynamic module missing",
    "domain": "contrib",
    "tags": [],
    "summary": "飞书单聊和群聊均无回应。飞书长连接正常（WebSocket 显示 ON · OK），消息能收到，但 Bot 不回复。",
    "url": "lessons/contrib/openclaw-gateway-dynamic-module-missing.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "openclaw-playwright-wsl-libnss3-libnspr4-snap-chromium",
    "title": "Playwright Chromium launch fails on WSL2 with missing libnss3 / libnspr4",
    "domain": "contrib",
    "tags": [],
    "summary": "Running `playwright install chromium` (Playwright 1.60.0) inside a WSL2 Ubuntu 24.04 image succeeds in downloading the browser binary, but launching it via `Bro…",
    "url": "lessons/contrib/openclaw-playwright-wsl-libnss3-libnspr4-snap-chromium.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "openclaw-prefer-cli-and-policy-over-direct-edit",
    "title": "openclaw prefer cli and policy over direct edit",
    "domain": "contrib",
    "tags": [],
    "summary": "直接修改配置文件（临时hack）容易变成默认模型，导致官方路径退化。",
    "url": "lessons/contrib/openclaw-prefer-cli-and-policy-over-direct-edit.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "openclaw-reinstall-lesson",
    "title": "OpenClaw 重装教训 — 删除前先停服务清残留",
    "domain": "contrib",
    "tags": [],
    "summary": "愚者飞书机器人无反应，尝试重装 OpenClaw。",
    "url": "lessons/contrib/openclaw-reinstall-lesson.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "oss-refactor-lessons",
    "title": "oss refactor lessons",
    "domain": "contrib",
    "tags": [],
    "summary": "一个开源的 Agent 知识共享项目，早期架构照搬了\"中心协调网络\"设计，堆了 A2A 实时通信、WebSocket 长连接、交互式卡片仲裁、中心化 Hub 等功能。功能多但实际体验差。",
    "url": "lessons/contrib/oss-refactor-lessons.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "permission-denied-fix",
    "title": "Permission Denied / WSL NTFS 跨文件系统PermissionFix",
    "domain": "contrib",
    "tags": [],
    "summary": "操作 ~/.hermes/ 下的文件时报 `Permission denied` 或 `EACCES`，或者 WSL 访问 /mnt/c 时报 `crossmnt` 错误。",
    "url": "lessons/contrib/permission-denied-fix.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "phase-0-output-gate",
    "title": "phase 0 output gate",
    "domain": "contrib",
    "tags": [],
    "summary": "Agent 在 context 中看到了知识但不一定会用。即使指令写了\"不可跳过\"，Agent 的惯性行为是直接执行任务、跳过检索。",
    "url": "lessons/contrib/phase-0-output-gate.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "pip-install-timeout-ssl",
    "title": "pip install Network Timeout / SSL ErrorFix",
    "domain": "contrib",
    "tags": [],
    "summary": "`pip install` 失败，报 `timeout`、`SSL: CERTIFICATE_VERIFY_FAILED`、或 `Connection broken` 错误。",
    "url": "lessons/contrib/pip-install-timeout-ssl.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "pr-strategy",
    "title": "pr-strategy",
    "domain": "contrib",
    "tags": [],
    "summary": "For repository-specific PR profiles, maintainer response patterns, and PR round evidence, query the pr-genius federation peer.",
    "url": "lessons/contrib/pr-strategy.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "private-agent-memory-fallacy",
    "title": "private-agent-memory-fallacy",
    "domain": "contrib",
    "tags": [],
    "summary": "The idea of a portable \"memory wallet\" — like Plaid for AI, where your context travels between agents — sounds compelling but faces fundamental challenges.",
    "url": "lessons/contrib/private-agent-memory-fallacy.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "process-card-sequence-extraction-rules",
    "title": "process-card-sequence-extraction-rules",
    "domain": "contrib",
    "tags": [],
    "summary": "从工艺卡 Time Chart 提取机器人步序时，三种常见错误：",
    "url": "lessons/contrib/process-card-sequence-extraction-rules.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "promo-use-real-examples-not-hypotheticals",
    "title": "promo use real examples not hypotheticals",
    "domain": "contrib",
    "tags": [],
    "summary": "写推广帖时用了虚构的 pip install 梗，用户反馈\"换一个\"——因为假例子没有说服力，读者能感觉到是编的。",
    "url": "lessons/contrib/promo-use-real-examples-not-hypotheticals.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "python-gbk-encoding-error",
    "title": "Python GBK Encoding Error — Windows/WSL 跨平台",
    "domain": "contrib",
    "tags": [],
    "summary": "在 WSL 中运行 Python 脚本，读取或写入文件时报：",
    "url": "lessons/contrib/python-gbk-encoding-error.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "python-pycache-stale",
    "title": "Python 代码修改不生效 — stale .pyc Cache",
    "domain": "contrib",
    "tags": [],
    "summary": "改了 Python 文件后运行，行为还是旧的。函数返回值、错误信息、path 等都没有改变。",
    "url": "lessons/contrib/python-pycache-stale.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "python-sandbox-path-isolation",
    "title": "Python 沙箱/受限环境 — PATH 和 sys.path 隔离",
    "domain": "contrib",
    "tags": [],
    "summary": "在沙箱或受限环境中执行 Python 代码时，`import` 报 `ModuleNotFoundError`，或 import 的是宿主环境的包而非沙箱环境的。",
    "url": "lessons/contrib/python-sandbox-path-isolation.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "python-venv-tiktoken-module-not-found",
    "title": "Python venv 中 tiktoken 安装后仍报 ModuleNotFoundError",
    "domain": "contrib",
    "tags": [],
    "summary": "在已有 venv 中 `pip install tiktoken`，安装成功但运行时报 `ModuleNotFoundError: cannot import name '_namespace'` 或其他模块找不到的错误。",
    "url": "lessons/contrib/python-venv-tiktoken-module-not-found.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "python-venv-troubleshoot",
    "title": "Python venv 激活失败或路径不匹配",
    "domain": "contrib",
    "tags": [],
    "summary": "`source venv/bin/activate` 后 `which python` 还是系统 Python，或 `deactivate` 报错。",
    "url": "lessons/contrib/python-venv-troubleshoot.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "rag-alarm-code-mandatory-recall",
    "title": "RAG Alarm Code Retrieval Needs Mandatory Keyword Recall",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:high",
      "node:hermes-wsl"
    ],
    "summary": "When querying \"SRVO-023 robot alarm\", RAG returned unrelated results instead of the correct FANUC alarm documentation.",
    "url": "lessons/contrib/rag-alarm-code-mandatory-recall.md",
    "created": "2026-05-03",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "rag-brand-contamination-detection-and-fix",
    "title": "RAG 知识库品牌污染Detection与治理",
    "domain": "contrib",
    "tags": [],
    "summary": "一个面向特定品牌的垂直 RAG 知识库（200K+ 向量），在每日巡检中发现部分查询答案混入了竞品品牌技术内容。例如：",
    "url": "lessons/contrib/rag-brand-contamination-detection-and-fix.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "rag-brand-filter-three-pitfalls",
    "title": "RAG Brand Filter Three Pitfalls",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:medium",
      "node:hermes-wsl"
    ],
    "summary": "During a quality inspection of a FANUC robot RAG knowledge base, the team found three design flaws in the brand-filtering strategy that allowed competitor docum…",
    "url": "lessons/contrib/rag-brand-filter-three-pitfalls.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "rag-build-strategy-batch",
    "title": "RAG Build Strategy Batch",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:medium",
      "node:hermes-wsl"
    ],
    "summary": "During knowledge-base construction (chunks_v3, 34,100 docs), all data was loaded into VRAM/WSL memory at once. This caused an LM Studio context overflow, which …",
    "url": "lessons/contrib/rag-build-strategy-batch.md",
    "created": "2026-04-13",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "rag-chinese-encoding-pymupdf",
    "title": "RAG Chinese Encoding with PyMuPDF",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:medium",
      "node:hermes-wsl"
    ],
    "summary": "When building a FANUC knowledge-base RAG system, retrieved Chinese alarm codes appeared garbled.",
    "url": "lessons/contrib/rag-chinese-encoding-pymupdf.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "rag-chunk-params-800-100",
    "title": "RAG Chunk Parameters 800 Characters and 100 Overlap",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "severity:medium",
      "node:hermes-wsl"
    ],
    "summary": "After importing FANUC PDF documents into RAG, retrieval quality was unstable and recall was low for long documents.",
    "url": "lessons/contrib/rag-chunk-params-800-100.md",
    "created": "2026-05-03",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "rag-cross-encoder-cpu-bottleneck",
    "title": "rag-cross-encoder-cpu-bottleneck",
    "domain": "contrib",
    "tags": [],
    "summary": "RAG knowledge-base queries take 40-60 seconds on CPU-only infrastructure.",
    "url": "lessons/contrib/rag-cross-encoder-cpu-bottleneck.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "rag-kb-quality-flywheel-self-loop",
    "title": "RAG Knowledge Base Quality Flywheel Self Loop",
    "domain": "rag",
    "tags": [
      "rag",
      "flywheel",
      "quality",
      "audit",
      "feedback",
      "self-learning"
    ],
    "summary": "A vertical-domain RAG knowledge base (190+ PDFs, 200K+ vectors) was already online, supporting natural-language Q&A and daily automated inspections. However, is…",
    "url": "lessons/contrib/rag-kb-quality-flywheel-self-loop.md",
    "created": "2026-05-21",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "rag-three-channel-llm-disaster-recovery",
    "title": "RAG Three-Channel LLM Disaster Recovery",
    "domain": "rag",
    "tags": [
      "project:self-grow-wiki",
      "node:hermes-wsl",
      "scope:broad"
    ],
    "summary": "When serving a RAG knowledge base externally (Gradio Web UI / WeChat bot), a single LLM API path may become unavailable due to network issues, quota limits, or …",
    "url": "lessons/contrib/rag-three-channel-llm-disaster-recovery.md",
    "created": "2026-05-03",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "rdt-cli-reddit-terminal",
    "title": "rdt-cli-reddit-terminal",
    "domain": "contrib",
    "tags": [],
    "summary": "Reddit's official API closed self-service registration in 2025-11. Anonymous .json endpoints are blocked (403). Need a way to access Reddit programmatically.",
    "url": "lessons/contrib/rdt-cli-reddit-terminal.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "readme-seven-traps-fix-checklist",
    "title": "开源项目 README Optimization — 7 个常见Pitfalls与Fix Checklist",
    "domain": "contrib",
    "tags": [],
    "summary": "开源项目 README 是潜在用户和贡献者的第一触点。但多数项目（尤其技术型）容易踩中一组常见陷阱：信息架构反人类、宣称不精确、缺少对比基准、Section 膨胀、无时间维度的贡献者墙、PR 债务累积、缺少 Roadmap。",
    "url": "lessons/contrib/readme-seven-traps-fix-checklist.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "regex-escaped-quotes-source-parsing",
    "title": "regex-escaped-quotes-source-parsing",
    "domain": "contrib",
    "tags": [],
    "summary": "用正则从 Python 源码中提取 `os.environ.get(\"KEY\", \"default_value\")` 的默认值时，提取结果被截断：",
    "url": "lessons/contrib/regex-escaped-quotes-source-parsing.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "regex-greedy-matching",
    "title": "正则表达式 debugging — 贪婪匹配造成的意外结果",
    "domain": "contrib",
    "tags": [],
    "summary": "正则匹配返回了预期之外的大量文本。`<div>.*</div>` 匹配到了文档末尾而不是最近的闭合标签。",
    "url": "lessons/contrib/regex-greedy-matching.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "registration-chain-worker-fallback",
    "title": "注册链路设计 — Worker 只创建 Issue，其余交给 Workflow",
    "domain": "contrib",
    "tags": [],
    "summary": "MisakaNet 节点注册需要一条对国内外用户都通畅的链路。最初 Worker 既创建 Issue 又读写 counter.json，导致 Worker 和 register.yml 双重自增、竞态、Worker 权限过大等问题。",
    "url": "lessons/contrib/registration-chain-worker-fallback.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "repository-traffic-is-not-lesson-use",
    "title": "Repository Traffic Is Not Lesson Use",
    "domain": "growth",
    "tags": [
      "analytics",
      "growth",
      "feedback",
      "lessons",
      "metrics"
    ],
    "summary": "A repository can show strong clone, star, fork, issue, and pull-request activity while still having no evidence that users are reading or applying the knowledge…",
    "url": "lessons/contrib/repository-traffic-is-not-lesson-use.md",
    "created": "2026-07-17",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "rescue-cards-for-non-github-users",
    "title": "When Lessons Are Too Heavy, Use Rescue Cards",
    "domain": "ux",
    "tags": [
      "ux",
      "support",
      "lessons",
      "rescue",
      "feedback"
    ],
    "summary": "Not every real user can read a full technical lesson, open a GitHub issue, or write a structured report. Some users only know that a zip file will not open, a P…",
    "url": "lessons/contrib/rescue-cards-for-non-github-users.md",
    "created": "2026-07-17",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "sag-lite-data-quality-cleaning",
    "title": "sag-lite-data-quality-cleaning",
    "domain": "contrib",
    "tags": [],
    "summary": "SAG-Lite search results show raw frontmatter in description field, making results unreadable:",
    "url": "lessons/contrib/sag-lite-data-quality-cleaning.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "scrapling-installation-and-usage",
    "title": "scrapling-installation-and-usage",
    "domain": "contrib",
    "tags": [],
    "summary": "Standard scraping tools (requests, curl) are easily detected and blocked by anti-bot systems. Need a library that combines multiple fetching backends with anti-…",
    "url": "lessons/contrib/scrapling-installation-and-usage.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "search-quota-exhaustion-false-zero",
    "title": "search-quota-exhaustion-false-zero",
    "domain": "contrib",
    "tags": [],
    "summary": "1. Run `python3 search_knowledge.py \"test query\"` 5 times",
    "url": "lessons/contrib/search-quota-exhaustion-false-zero.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "search-smart-fallback-implementation",
    "title": "search-smart-fallback-implementation",
    "domain": "contrib",
    "tags": [],
    "summary": "1. Run a query with no exact match: `python3 search_knowledge.py \"xylophone purple elephant dancing\"`",
    "url": "lessons/contrib/search-smart-fallback-implementation.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "search-ssot-data-source-pollution-fix",
    "title": "search-ssot-data-source-pollution-fix",
    "domain": "contrib",
    "tags": [],
    "summary": "A static site deployed via GitHub Pages used a Worker API (`/api/lessons`) as the data source for its search feature. The Worker fetched from a stale branch, re…",
    "url": "lessons/contrib/search-ssot-data-source-pollution-fix.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "session-lesson-1-content-quality-scoring",
    "title": "session-lesson-1-content-quality-scoring",
    "domain": "contrib",
    "tags": [],
    "summary": "批量生成的内容质量参差不齐。人工审核效率低，无法规模化。需要自动化评估系统筛选合格内容。",
    "url": "lessons/contrib/session-lesson-1-content-quality-scoring.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "session-lesson-2-forum-accessibility-testing",
    "title": "session-lesson-2-forum-accessibility-testing",
    "domain": "contrib",
    "tags": [],
    "summary": "批量抓取前不知道哪些论坛可达。盲目尝试浪费时间，需要系统化的可达性测试。",
    "url": "lessons/contrib/session-lesson-2-forum-accessibility-testing.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "session-lesson-3-lobsters-json-api",
    "title": "session-lesson-3-lobsters-json-api",
    "domain": "contrib",
    "tags": [],
    "summary": "Lobste.rs 是高质量技术论坛（安全/Rust/系统），但没有搜索 API。需要通过 JSON 端点获取内容。",
    "url": "lessons/contrib/session-lesson-3-lobsters-json-api.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "session-lesson-4-playwright-forum-selectors",
    "title": "session-lesson-4-playwright-forum-selectors",
    "domain": "contrib",
    "tags": [],
    "summary": "不同论坛使用不同的 CMS（WoltLab、IPS Community、Discourse），HTML 结构各异。写选择器需要逐个分析。",
    "url": "lessons/contrib/session-lesson-4-playwright-forum-selectors.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "shared-json-needs-atomic-write",
    "title": "shared json needs atomic write",
    "domain": "contrib",
    "tags": [],
    "summary": "多个自动化job同时写共享的运行时状态文件（如 latest.json），plain overwrite 会暴露半写状态导致并发读者解析失败。",
    "url": "lessons/contrib/shared-json-needs-atomic-write.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "shell-script-debugging",
    "title": "Shell Debugging — set -x 与常见Pitfalls",
    "domain": "contrib",
    "tags": [],
    "summary": "Shell 脚本报错但不显示问题行，或变量展开后不是预期值。",
    "url": "lessons/contrib/shell-script-debugging.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "slugify-path-traversal-deep-coverage",
    "title": "slugify path traversal deep coverage",
    "domain": "contrib",
    "tags": [],
    "summary": "The original 5-test `test_slugify.py` (merged in commit `6912f87` for issue #95) covered the basics: standard titles, slashes, emojis, reserved names, and lengt…",
    "url": "lessons/contrib/slugify-path-traversal-deep-coverage.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "slugify-windows-path-sanitation",
    "title": "slugify windows path sanitation",
    "domain": "contrib",
    "tags": [],
    "summary": "When creating a new lesson using `scripts/new_lesson.py` (either interactively or via batch mode), if the user or agent supplies a title with special characters…",
    "url": "lessons/contrib/slugify-windows-path-sanitation.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "static-page-github-api-403-rate-limit",
    "title": "static page github api 403 rate limit",
    "domain": "contrib",
    "tags": [],
    "summary": "纯静态页面（无后端代理，HTML + JS 直接部署在 CDN/GitHub Pages 上）需要通过浏览器端 JavaScript 直接调用第三方 API。这种架构面临几个固有风险：",
    "url": "lessons/contrib/static-page-github-api-403-rate-limit.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "static-page-width-consistency",
    "title": "static page width consistency",
    "domain": "contrib",
    "tags": [],
    "summary": "页面各个功能区块宽度不一致：搜索栏 `max-width: 800px`，内容卡片 `max-width: 600px`，表单 `display: inline-block; min-width: 360px`，而其他区块又是全宽。页面看起来像拼凑的，没有统一感。",
    "url": "lessons/contrib/static-page-width-consistency.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "supabase-capacity-constraints-project-operations",
    "title": "Supabase capacity constraints caused project operation failures",
    "domain": "database",
    "tags": [
      "incident",
      "postmortem",
      "capacity",
      "supabase",
      "database",
      "operations"
    ],
    "summary": "On 2026-06-30, Supabase reported an incident titled **\"Project status change failures in multiple regions\"**. Users could see repeated failures when trying to c…",
    "url": "lessons/contrib/supabase-capacity-constraints-project-operations.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "swarm-pr-battle-playbook",
    "title": "Swarm PR Battle Playbook — Shipping env-var error hooks through AI-reviewed upstreams",
    "domain": "contrib",
    "tags": [],
    "summary": "> Cross-project SOP for shipping `_ERROR_HANDLER` env-var fatal error hooks through AI-reviewed upstreams.",
    "url": "lessons/contrib/swarm-pr-battle-playbook.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "testimonio-misakanet",
    "title": "testimonio-misakanet",
    "domain": "contrib",
    "tags": [],
    "summary": "��#\u0000 \u0000T\u0000e\u0000s\u0000t\u0000i\u0000m\u0000o\u0000n\u0000i\u0000o\u0000:\u0000 \u0000M\u0000i\u0000s\u0000a\u0000k\u0000a\u0000N\u0000e\u0000t\u0000 \u0000m\u0000e\u0000 \u0000a\u0000y\u0000u\u0000d\u0000o\u0000 \u0000a\u0000 \u0000r\u0000e\u0000s\u0000o\u0000l\u0000v\u0000e\u0000r\u0000 \u0000M\u0000o\u0000d\u0000u\u0000l\u0000e\u0000N\u0000o\u0000t\u0000F\u0000o\u0000u\u0000n\u0000d\u0000E\u0000r\u0000r\u0000o\u0000r\u0000",
    "url": "lessons/contrib/testimonio-misakanet.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "tmux-session-management",
    "title": "tmux 终端复用 — 断开不丢失会话",
    "domain": "contrib",
    "tags": [],
    "summary": "SSH 断开或终端关闭后，正在运行的任务（训练、迁移、部署）中断。重新连接后无法恢复。",
    "url": "lessons/contrib/tmux-session-management.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "tts-chinese-encoding-powershell",
    "title": "tts chinese encoding powershell",
    "domain": "contrib",
    "tags": [],
    "summary": "中文文本通过 PowerShell 脚本内联传给 mmx CLI，TTS 返回空音频（\"嗯嗯\"声）。",
    "url": "lessons/contrib/tts-chinese-encoding-powershell.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "two-evidence-loops-for-failure-lessons",
    "title": "Two Evidence Loops for Failure Lessons",
    "domain": "growth",
    "tags": [
      "evidence",
      "lessons",
      "reuse",
      "growth",
      "feedback"
    ],
    "summary": "A failure-lesson project can undercount real value if it only treats public feedback signals as proof of reuse. Helpful votes, feedback issues, and usage report…",
    "url": "lessons/contrib/two-evidence-loops-for-failure-lessons.md",
    "created": "2026-07-17",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "version-management-multiple-files",
    "title": "Version Management Across Multiple Files",
    "domain": "devops",
    "tags": [
      "version",
      "release",
      "changelog",
      "documentation",
      "metrics",
      "ssot",
      "frontend"
    ],
    "summary": "Version number appears in multiple files that need to be updated together:",
    "url": "lessons/contrib/version-management-multiple-files.md",
    "created": "2026-07-02",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "published",
    "verified": true
  },
  {
    "id": "vertical-kb-question-bank-strategy",
    "title": "Vertical KB Question Bank Strategy — FANUC Robot KB Case Study",
    "domain": "contrib",
    "tags": [],
    "summary": "在飞书云文档中维护一个 FANUC 机器人垂直知识库的题库，经历了从第一批到第三批的迭代，发现了一些关键管理策略。",
    "url": "lessons/contrib/vertical-kb-question-bank-strategy.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "wcferry-wechat-version-lock",
    "title": "wcferry wechat version lock",
    "domain": "contrib",
    "tags": [],
    "summary": "wxauto 不够稳定时，考虑切换到 wcferry (WeChatFerry) 方案。但安装后无法 hook 微信进程。",
    "url": "lessons/contrib/wcferry-wechat-version-lock.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "webmcp-chrome-ai-agent-protocol",
    "title": "webmcp-chrome-ai-agent-protocol",
    "domain": "contrib",
    "tags": [],
    "summary": "Websites are designed for humans. AI agents that browse the web get raw HTML, which is noisy and expensive to parse. There's no standard way for a website to ex…",
    "url": "lessons/contrib/webmcp-chrome-ai-agent-protocol.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "wechat-pubacct-fetch-separate-search-from-retrieval",
    "title": "wechat pubacct fetch separate search from retrieval",
    "domain": "contrib",
    "tags": [],
    "summary": "微信公众号文章抓取时，把\"找文章URL\"和\"抓取正文\"混在一起，失败模式不清晰，难以诊断。",
    "url": "lessons/contrib/wechat-pubacct-fetch-separate-search-from-retrieval.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "wecom-robot-long-connect-no-ngrok",
    "title": "wecom robot long connect no ngrok",
    "domain": "contrib",
    "tags": [],
    "summary": "配置企业微信机器人回调时，传统方案需要 ngrok/frp 做内网穿透，增加复杂度、暴露端口、需要 HTTPS 证书。",
    "url": "lessons/contrib/wecom-robot-long-connect-no-ngrok.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "wsl-pip-gbk-hub-poller-crash",
    "title": "wsl pip gbk hub poller crash",
    "domain": "contrib",
    "tags": [],
    "summary": "Windows Hub 的 hub_poller.py 读取 config.yaml 时崩溃，错误信息为 UnicodeDecodeError。",
    "url": "lessons/contrib/wsl-pip-gbk-hub-poller-crash.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "wsl-proxy-huggingface-external",
    "title": "wsl proxy huggingface external",
    "domain": "contrib",
    "tags": [],
    "summary": "WSL 内 Python 脚本无法下载 HuggingFace 模型（sentence-transformers/BGE），",
    "url": "lessons/contrib/wsl-proxy-huggingface-external.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "wsl-proxy-setup",
    "title": "WSL 代理Setup — 通过 Windows 梯子Access外网",
    "domain": "contrib",
    "tags": [],
    "summary": "WSL 内 `curl google.com` 失败，但 Windows 能正常访问外网。WSL 默认不走 Windows 的代理。",
    "url": "lessons/contrib/wsl-proxy-setup.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "wsl-terminal-underscore-corruption",
    "title": "WSL 终端编辑Setup危险 — TTy粘贴吞下划线",
    "domain": "contrib",
    "tags": [],
    "summary": "需要修改 WSL 中的配置文件（如 `.env`、`config.yaml`），通过 Windows Terminal 粘贴时出现神秘失败。",
    "url": "lessons/contrib/wsl-terminal-underscore-corruption.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "wsl-terminal-underscore-missing",
    "title": "WSL Windows 终端复制粘贴吞下划线Issue",
    "domain": "contrib",
    "tags": [],
    "summary": "从 Windows 复制文本粘贴到 WSL 终端时，下划线 `_` 字符消失。配置文件、命令中的下划线名全部错误。",
    "url": "lessons/contrib/wsl-terminal-underscore-missing.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "wsl2-memory-leak-fix",
    "title": "WSL2 内存泄漏 / 内存占用过高",
    "domain": "contrib",
    "tags": [],
    "summary": "WSL2 运行几天后吃掉 8GB+ 内存，Windows 变卡。`free -h` 显示已用内存极高。",
    "url": "lessons/contrib/wsl2-memory-leak-fix.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "wxauto-im-feedback-collection-jsonl-queue",
    "title": "IM 机器人反馈收集与 JSONL 队列审核模式",
    "domain": "contrib",
    "tags": [],
    "summary": "RAG 知识库的 IM 机器人（wxauto 微信）只提供单向问答能力，用户不满意时无反馈渠道。知识库质量改进完全依赖离线人工审计，无法捕捉真实使用场景中的问题。",
    "url": "lessons/contrib/wxauto-im-feedback-collection-jsonl-queue.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": false
  },
  {
    "id": "wxauto-windows-python-not-wsl",
    "title": "wxauto 必须在 Windows Python 下安装，不能走 WSL pip",
    "domain": "contrib",
    "tags": [],
    "summary": "在 WSL2 中 `pip install wxauto` 报错 `No matching distribution found`。wxauto 是 Windows-only 库。",
    "url": "lessons/contrib/wxauto-windows-python-not-wsl.md",
    "created": "2026-07-06",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  },
  {
    "id": "zero-bounty-agent-competition-flywheel",
    "title": "zero-bounty-agent-competition-flywheel",
    "domain": "contrib",
    "tags": [],
    "summary": "Open-source projects want to attract AI agent crawlers and automated PR contributors, but traditional bounty models require funding. How do you design issues th…",
    "url": "lessons/contrib/zero-bounty-agent-competition-flywheel.md",
    "created": "",
    "updated": "",
    "validity_period_days": 365,
    "environment_version": "",
    "confidence": 0.5,
    "status": "active",
    "verified": true
  }
]