lessons.json

[
  {
    "id": "api-rate-limit-handling",
    "title": "API 请求限流 (Rate Limit) 处理方案",
    "domain": "devops",
    "tags": [
      "api",
      "rate-limit",
      "retry",
      "429"
    ],
    "summary": "调用第三方 API 时返回 HTTP 429（Too Many Requests）或 403（被限流）。自动化脚本因未处理限流而中断。",
    "url": "lessons/api-rate-limit-handling.md",
    "updated": ""
  },
  {
    "id": "cron-job-not-running",
    "title": "Cron 作业不执行 / 不生效排障",
    "domain": "devops",
    "tags": [
      "cron",
      "scheduler",
      "not-running",
      "debug"
    ],
    "summary": "`crontab -e` 设置好后，作业从未执行。输出没有、日志没有、进程没有。",
    "url": "lessons/cron-job-not-running.md",
    "updated": ""
  },
  {
    "id": "curl-request-troubleshoot",
    "title": "curl / wget 请求失败通用排查",
    "domain": "devops",
    "tags": [
      "network",
      "curl",
      "wget",
      "debug",
      "troubleshoot"
    ],
    "summary": "`curl https://example.com` 返回空、报错或超时。不知道是 DNS、代理、证书还是目标服务的问题。",
    "url": "lessons/curl-request-troubleshoot.md",
    "updated": ""
  },
  {
    "id": "disk-space-cleanup",
    "title": "磁盘空间不足 / 缓存清理方案",
    "domain": "devops",
    "tags": [
      "disk-space",
      "cleanup",
      "docker",
      "pip-cache"
    ],
    "summary": "写入文件或构建时报 `No space left on device` / `ENOSPC`，进程崩溃。",
    "url": "lessons/disk-space-cleanup.md",
    "updated": ""
  },
  {
    "id": "git-credentials-automation",
    "title": "Git 凭证配置 — 自动化 push 免密码",
    "domain": "devops",
    "tags": [
      "git",
      "credentials",
      "auth",
      "github"
    ],
    "summary": "脚本自动执行 `git push` 时弹出用户名密码输入框，导致自动化流程卡住。",
    "url": "lessons/git-credentials-automation.md",
    "updated": ""
  },
  {
    "id": "git-merge-conflict-resolution",
    "title": "Git 合并冲突处理 — 手动解决最佳实践",
    "domain": "development",
    "tags": [
      "git",
      "merge",
      "conflict",
      "rebase"
    ],
    "summary": "`git pull` 或 `git merge` 时报 `CONFLICT`，文件里出现 `<<<<<<<` 标记。不知如何选择。",
    "url": "lessons/git-merge-conflict-resolution.md",
    "updated": ""
  },
  {
    "id": "git-tls-handshake-failure",
    "title": "GitHub TLS 握手失败 — gnutls_handshake() 错误",
    "domain": "devops",
    "tags": [
      "git",
      "github",
      "TLS",
      "SSL",
      "network"
    ],
    "summary": "`git pull` 或 `git push` 时报：",
    "url": "lessons/git-tls-handshake-failure.md",
    "updated": ""
  },
  {
    "id": "json-parse-failure-handling",
    "title": "JSON 解析失败处理 — 截断 / 格式错误",
    "domain": "devops",
    "tags": [
      "json",
      "parse",
      "truncated",
      "llm",
      "output"
    ],
    "summary": "从 LLM 输出或 API 返回中解析 JSON 时报 `json.decoder.JSONDecodeError`。常见于模型输出被截断、前后有多余字符。",
    "url": "lessons/json-parse-failure-handling.md",
    "updated": ""
  },
  {
    "id": "openai-compatible-api-call",
    "title": "OpenAI 兼容 API 的通用调用格式",
    "domain": "development",
    "tags": [
      "api",
      "openai",
      "llm",
      "inference",
      "chat"
    ],
    "summary": "部署了 LLM 服务（vLLM/Ollama/本地推理）后，不知道怎么用 API 调用。各框架接口不一。",
    "url": "lessons/openai-compatible-api-call.md",
    "updated": ""
  },
  {
    "id": "phase-0-output-gate",
    "title": "Phase 0 Output Gate — Agent 的硬性知识检索规则",
    "domain": "methodology",
    "tags": [
      "output-gate",
      "knowledge-reuse",
      "methodology",
      "core"
    ],
    "summary": "Agent 在 context 中看到了知识但不一定会用。即使指令写了\"不可跳过\"，Agent 的惯性行为是直接执行任务、跳过检索。",
    "url": "lessons/phase-0-output-gate.md",
    "updated": ""
  },
  {
    "id": "pip-install-timeout-ssl",
    "title": "pip install 网络超时 / SSL 错误修复",
    "domain": "devops",
    "tags": [
      "pip",
      "network",
      "SSL",
      "timeout",
      "proxy"
    ],
    "summary": "`pip install` 失败，报 `timeout`、`SSL: CERTIFICATE_VERIFY_FAILED`、或 `Connection broken` 错误。",
    "url": "lessons/pip-install-timeout-ssl.md",
    "updated": ""
  },
  {
    "id": "python-gbk-encoding-error",
    "title": "Python GBK 编码错误 — Windows/WSL 跨平台",
    "domain": "devops",
    "tags": [
      "python",
      "encoding",
      "gbk",
      "windows",
      "wsl"
    ],
    "summary": "在 WSL 中运行 Python 脚本，读取或写入文件时报：",
    "url": "lessons/python-gbk-encoding-error.md",
    "updated": ""
  },
  {
    "id": "python-pycache-stale",
    "title": "Python 代码修改不生效 — stale .pyc 缓存",
    "domain": "devops",
    "tags": [
      "python",
      "pyc",
      "cache",
      "debug"
    ],
    "summary": "改了 Python 文件后运行，行为还是旧的。函数返回值、错误信息、path 等都没有改变。",
    "url": "lessons/python-pycache-stale.md",
    "updated": ""
  },
  {
    "id": "python-sandbox-path-isolation",
    "title": "Python 沙箱/受限环境 — PATH 和 sys.path 隔离",
    "domain": "development",
    "tags": [
      "python",
      "sandbox",
      "path",
      "import",
      "venv"
    ],
    "summary": "在沙箱或受限环境中执行 Python 代码时，`import` 报 `ModuleNotFoundError`，或 import 的是宿主环境的包而非沙箱环境的。",
    "url": "lessons/python-sandbox-path-isolation.md",
    "updated": ""
  },
  {
    "id": "python-venv-troubleshoot",
    "title": "Python venv 激活失败或路径不匹配",
    "domain": "devops",
    "tags": [
      "python",
      "venv",
      "virtualenv",
      "path"
    ],
    "summary": "`source venv/bin/activate` 后 `which python` 还是系统 Python，或 `deactivate` 报错。",
    "url": "lessons/python-venv-troubleshoot.md",
    "updated": ""
  },
  {
    "id": "regex-greedy-matching",
    "title": "正则表达式 debugging — 贪婪匹配造成的意外结果",
    "domain": "development",
    "tags": [
      "regex",
      "debug",
      "greedy",
      "pattern"
    ],
    "summary": "正则匹配返回了预期之外的大量文本。`<div>.*</div>` 匹配到了文档末尾而不是最近的闭合标签。",
    "url": "lessons/regex-greedy-matching.md",
    "updated": ""
  },
  {
    "id": "shell-script-debugging",
    "title": "Shell 脚本调试 — set -x 与常见陷阱",
    "domain": "development",
    "tags": [
      "shell",
      "bash",
      "debug",
      "script"
    ],
    "summary": "Shell 脚本报错但不显示问题行，或变量展开后不是预期值。",
    "url": "lessons/shell-script-debugging.md",
    "updated": ""
  },
  {
    "id": "tmux-session-management",
    "title": "tmux 终端复用 — 断开不丢失会话",
    "domain": "development",
    "tags": [
      "tmux",
      "terminal",
      "session",
      "background"
    ],
    "summary": "SSH 断开或终端关闭后，正在运行的任务（训练、迁移、部署）中断。重新连接后无法恢复。",
    "url": "lessons/tmux-session-management.md",
    "updated": ""
  },
  {
    "id": "wsl-permission-ntfs-fix",
    "title": "Permission Denied / WSL NTFS 跨文件系统权限修复",
    "domain": "devops",
    "tags": [
      "permission",
      "wsl",
      "ntfs",
      "eacces",
      "filesystem"
    ],
    "summary": "操作 `/mnt/c/` 下的文件时报 `Permission denied` 或 `EACCES`；或 `git` 在 `/mnt/c/` 下报错。",
    "url": "lessons/wsl-permission-ntfs-fix.md",
    "updated": ""
  },
  {
    "id": "wsl-proxy-setup",
    "title": "WSL 代理配置 — 通过 Windows 梯子访问外网",
    "domain": "devops",
    "tags": [
      "wsl",
      "proxy",
      "network",
      "windows"
    ],
    "summary": "WSL 内 `curl google.com` 失败，但 Windows 能正常访问外网。WSL 默认不走 Windows 的代理。",
    "url": "lessons/wsl-proxy-setup.md",
    "updated": ""
  },
  {
    "id": "wsl-terminal-underscore-missing",
    "title": "WSL Windows 终端复制粘贴吞下划线问题",
    "domain": "devops",
    "tags": [
      "wsl",
      "terminal",
      "windows",
      "encoding"
    ],
    "summary": "从 Windows 复制文本粘贴到 WSL 终端时，下划线 `_` 字符消失。配置文件、命令中的下划线名全部错误。",
    "url": "lessons/wsl-terminal-underscore-missing.md",
    "updated": ""
  },
  {
    "id": "wsl2-memory-leak-fix",
    "title": "WSL2 内存泄漏 / 内存占用过高",
    "domain": "devops",
    "tags": [
      "wsl",
      "memory",
      "leak",
      "performance"
    ],
    "summary": "WSL2 运行几天后吃掉 8GB+ 内存，Windows 变卡。`free -h` 显示已用内存极高。",
    "url": "lessons/wsl2-memory-leak-fix.md",
    "updated": ""
  }
]