最后更新: 2026-05-21 01:28:18 UTC | 来源: lessons_cleanup.py
每条 lesson 包含踩坑记录、修复方法和验证方式，跨节点自动同步。
| Lesson | Domain | Tags | Source |
|---|
- FFmpeg 音频转码：必须用 libopus 而非 -format ogg | audio | | hanged-man
- dogfood | claude | | skill-harvest
- mify-model-gateway | claude | | skill-harvest
- 模型输出截断 / JSON 解析失败处理 | claude | | hermes_wsl
- Gateway 进程挂死未崩溃 — watchdog 自动恢复 | devops | | bootstrap
- Git 凭证和 Node ID — Node2 加网后必须设置 | devops | | bootstrap
- Hermes Agent 手动更新步骤（update 超时） | devops | "project:agent-medici", "severity:medium", "node:hermes_wsl" | bootstrap
- Hub Hermes 凭证体系 — Gateway vs Hub 各自读哪里 | devops | | bootstrap
- InternalGateway API 网关不兼容 Anthropic 原生格式 | devops | "project:rag", "severity:medium", "node:hermes_wsl" | bootstrap
- Node2 配置完成 — git credentials 和 NODE_ID 设置 | devops | | hermes_wsl2
- OpenClaw 重装教训 — 删除前先停服务清残留 | devops | | bootstrap
- Permission Denied / WSL NTFS 跨文件系统权限修复 | devops | | hermes_wsl
- WSL pip install GBK 编码导致 hub_poller 崩溃 | devops | "project:agent-medici", "severity:critical", "platform:wsl", "node:hermes_wsl" | bootstrap
- WSL 终端编辑配置危险 — TTy粘贴吞下划线 | devops | | bootstrap
- WSL 终端编辑配置危险 — TTy粘贴吞下划线 | devops | | bootstrap
- WSL 需要代理配置才能访问 HuggingFace 和外部网络 | devops | "project:self-grow-wiki", "severity:high", "platform:wsl", "node:hermes_wsl" | bootstrap
- browser-harness — AI 直连 Chrome 的 CDP 浏览器自动化 | devops | | skill-harvest
- ccswitch-hermes-switch 踩坑记录 | devops | | bootstrap
- hermes-cli-pty-mode | devops | | skill-harvest
- internal-gateway.local 不兼容 Anthropic 格式 — 需 OpenAI 代理转换 | devops | | hermes_wsl
- pip install 网络超时 / SSL / 依赖冲突修复 | devops | | hermes_wsl
- wcferry 微信版本锁定 — 3.9.12.51 才能用 | devops | "project:rag", "platform:windows", "node:hermes_wsl", "scope:narrow" | bootstrap
- wxauto 必须在 Windows Python 下安装，不能走 WSL pip | devops | "project:rag", "platform:windows", "node:hermes_wsl", "scope:narrow" | bootstrap
- 企业微信机器人：长连接模式不需要 ngrok | devops | "project:rag", "platform:windows", "node:hermes_wsl", "scope:narrow" | bootstrap
- 磁盘空间不足 / chroma_db_v4 缓存清理 | devops | | hermes_wsl
- 防火墙端口开放不等于内网穿透 | devops | "project:rag", "platform:wsl", "node:hermes_wsl", "scope:broad" | bootstrap
- 飞书 webhook URL 必须用环境变量或 gitignored 的 config.yaml | devops | "project:agent-medici", "severity:critical", "node:hermes_wsl" | bootstrap
- FANUC KL: 1086 是代码行号而非错误码 | fanuc | | bootstrap
- FANUC KL: BYTES_AHEAD 是 Karel 内置 Procedure | fanuc | | bootstrap
- FANUC KL: ERR_ABORT vs ERR_PAUSE 行为差异 | fanuc | | bootstrap
- FANUC KL: mm_module_h.kl 禁止 ROUTINE 声明 | fanuc | | bootstrap
- Feishu 凭证轮换后 Gateway 必须重启 | feishu | | bootstrap
- Feishu 文件上传：file_type 必须用 opus | feishu | | hanged-man
- Feishu 文档 URL：必须用 API 返回值，不要拼接 | feishu | | hanged-man
- Hub FeishuWSClient.start() 从未调用 — WebSocket 接收死代码 | feishu | | bootstrap
- OpenClaw Gateway 动态模块缺失 — 飞书消息分发失败 | feishu | node:misaka10004", "platform:wsl", "severity:critical", "project:misakanet | bootstrap
- aily 飞书 MCP 通道：只能拉取不能推送 | feishu | | bootstrap
- cc-connect 飞书显示优化：禁用工具调用和上下文提示 | feishu | | bootstrap
- cc-connect 飞书机器人完整配置指南 | feishu | | bootstrap
- feishu-docx | feishu | | skill-harvest
- feishu-interactive-card | feishu | | skill-harvest
- openclaw-multi-instance-config | feishu | | skill-harvest
- task-board-html-patterns | feishu | | skill-harvest
- 飞书 Block API 假成功特征 | feishu | | bootstrap
- 飞书 Block Type 正确值与已知限制 | feishu | | bootstrap
- 飞书 Block 批量写入上限 | feishu | | bootstrap
- AI Agent 项目宣发引流指南 | marketing | "outreach", "github", "awesome-list", "pr", "promotion", "agent", "marketing" | Misaka10004
- 引流文案用真实案例不要编造 | marketing | "outreach", "content-strategy", "awesome-list", "reddit", "hacker-news" | Misaka10004
- ST2 MCP：end_turn 返回 409 Conflict 但游戏正常推进 | mcp | | hanged-man
- ST2 MCP：从 GAME_OVER 重开必须走特定流程 | mcp | | hanged-man
- ST2 danielstarman MCP：选 Rare Relic 会卡死 | mcp | | hanged-man
- BGE embedding 模型需要降级 fallback 避免启动崩溃 | rag | "project:agent-medici", "severity:high", "node:hermes_wsl" | bootstrap
- Chroma 建库无 Checkpoint — 进程一死全部丢失 | rag | | bootstrap
- Chroma 建库无 Checkpoint — 进程一死全部丢失 | rag | | bootstrap
- ChromaDB 不能放在 NTFS 文件系统 | rag | "project:self-grow-wiki", "severity:critical", "platform:wsl", "node:hermes_wsl" | bootstrap
- FANUC R-2000iC 检索混淆修复 — 关键词强制召回 | rag | | hermes_wsl
- RAG 三通道 LLM 容灾方案 | rag | "project:self-grow-wiki", "node:hermes_wsl", "scope:broad" | bootstrap
- RAG 分块参数：800 字符 + 100 重叠 + 每文件最多 100 分块 | rag | "project:self-grow-wiki", "severity:medium", "node:hermes_wsl" | bootstrap
- RAG 建库策略：不可一次性加载全部数据到显存/内存 | rag | | hanged-man
- RAG 报警代码检索需要关键词强制召回 | rag | "project:self-grow-wiki", "severity:high", "node:hermes_wsl" | bootstrap
- RAG Cross-Encoder Reranker CPU 瓶颈与 LLM 确定性调优 | rag | "project:self-grow-wiki", "node:hermes_wsl", "scope:broad", "severity:high" | bootstrap
- RAG 检索中文乱码 — pymupdf4llm 默认编码问题 | rag | | bootstrap
- edoc-pipeline-retrospective | rag | | skill-harvest
- edoc-rag | rag | | skill-harvest
- lessons.md 修正（4 处） 项目 旧结论 修正后 heading block（type=4 | rag | | bootstrap
- rag-audit-question-authoring | rag | | skill-harvest
- 知识库 4σ 质量审计流水线 | rag | "project:self-grow-wiki", "severity:medium", "node:hermes_wsl" | bootstrap
- GPT-SoVITS 训练：2-name2text 格式必须用 ARPABET 音素而非中文原文 | tts | | hanged-man
- GPT-SoVITS：HuBERT 必须 16kHz 且 get_model() 返回单体 | tts | | hanged-man
- GPT-SoVITS：ref_free bug——prompt_text 为空时参数被覆盖 | tts | | hanged-man
- TTS 中文编码：PowerShell 传参必须用 .txt 文件中转 | tts | | hanged-man
- api-rate-limit-handling | uncategorized | |
- api-rate-limit-handling-best-practices | uncategorized | |
- cc-connect-飞书机器人完整配置指南 | uncategorized | |
- chrome-relay-browser-automation | uncategorized | |
- cron-job-not-running | uncategorized | |
- curl-request-troubleshoot | uncategorized | |
- deepseek-tui-agent-模式下-write-file-写入不落地-worktree-git-链接路径断裂 | uncategorized | |
- deepseek-tui-write-file-sandbox-worktree-git-path | uncategorized | |
- feishu-markdown-table-not-rendered | uncategorized | |
- feishu-mcp-server-deepseek-tui-setup | uncategorized | |
- feishu-websocket-404-error-http-webhook-required | uncategorized | |
- feishu-wiki批量下载-文件类型处理策略 | uncategorized | |
- git-credentials-automation | uncategorized | |
- git-merge-conflict-resolution | uncategorized | |
- git-tls-handshake-failure | uncategorized | |
- github-401-credential-lookup | uncategorized | |
- json-parse-failure-handling | uncategorized | |
- openai-compatible-api-call | uncategorized | |
- openclaw-prefer-cli-and-policy-over-direct-edit | uncategorized | |
- phase-0-output-gate | uncategorized | |
- pip-install-timeout-ssl | uncategorized | |
- python-gbk-encoding-error | uncategorized | |
- python-pycache-stale | uncategorized | |
- python-sandbox-path-isolation | uncategorized | |
- python-venv-tiktoken-module-not-found | uncategorized | |
- python-venv-troubleshoot | uncategorized | |
- regex-greedy-matching | uncategorized | |
- shared-json-needs-atomic-write | uncategorized | |
- shell-script-debugging | uncategorized | |
- tmux-session-management | uncategorized | |
- vertical-kb-question-bank-strategy | uncategorized | |
- wechat-pubacct-fetch-separate-search-from-retrieval | uncategorized | |
- wsl-permission-ntfs-fix | uncategorized | |
- wsl-proxy-setup | uncategorized | |
- wsl-terminal-underscore-missing | uncategorized | |
- wsl2-memory-leak-fix | uncategorized | |