# Trove —— 泛计算机问题的确定性方案库

> 只收录「网上已有确定性解法」的内容：每条带验证三态（已验证 / 推断 / 共识）、验证日期与证据；四类形态 = 问题 / 经验 / 工具 / 组合包，命令可复制执行，Agent 可直接消费。
> Updated: 2026-09-24 · 工具 29 · 组合包 16 · 问题 146 · 经验 13（数据为生成时快照，长期使用请回源站检查更新）

## Agent Routing
- 人类入口（人读）：https://trove.xin/
- 英文站（English）：https://trove.xin/en/
- Agent 入口（机器可读索引页）：https://trove.xin/agent/
- Agent 全量结构化数据（每个字的机器可读形态，JSON）：https://trove.xin/agent/trove.json
- 本文件（llms.txt）为轻量索引；完整数据以 trove.json 为准。

## Solutions

- [agent-framework: Python framework from Microsoft for building, orchestrating and deploying multi-agent systems.](https://trove.xin/solutions/agent-framework) — verified 2026-08-31 · v1.16.0~1.16.0 · conflicts: oh-my-claudecode(inferred), agent-governance-toolkit(inferred), deepcode(inferred)
- [agent-skills: 24 engineering skills covering define/plan/build/test/review/ship, with 8 slash commands.](https://trove.xin/solutions/agent-skills) — verified 2026-08-28 · v0.6.7~0.6.7
- [agentshield: Scans Claude Code configuration for secrets, permissions, hooks, MCP and prompt-injection surfaces.](https://trove.xin/solutions/agentshield) — verified 2026-08-28 · v1.4.0~1.4.0
- [agent-governance-toolkit: Governance toolkit for AI agents: policy enforcement, zero-trust identity and sandboxed execution.](https://trove.xin/solutions/agent-governance-toolkit) — verified 2026-08-27 · v4.1.0~4.1.0 · conflicts: oh-my-claudecode(inferred)
- [cc-switch: Switch sessions and providers across Claude Code, Codex, Gemini and OpenCode from one UI.](https://trove.xin/solutions/cc-switch) — verified 2026-08-31 · v3.20.1~3.20.1 · conflicts: oh-my-claudecode(inferred), claude-code-router(inferred), claude-mem(inferred)
- [claude-code-router: Route across models and manage providers locally for Claude Code and other agents.](https://trove.xin/solutions/claude-code-router) — verified 2026-08-28 · v3.0.22~3.0.22 · conflicts: oh-my-claudecode(inferred), agent-governance-toolkit(inferred), deepcode(inferred)
- [claude-mem: Captures sessions, compresses with AI and injects relevant context across sessions (MCP + worker).](https://trove.xin/solutions/claude-mem) — verified 2026-08-28 · v13.18.0~13.18.0 · conflicts: oh-my-claudecode(inferred), ruflo(inferred), code-review-graph(inferred)
- [code-review-graph: Lets AI review only the relevant code by building a local code knowledge graph; for large codebases.](https://trove.xin/solutions/code-review-graph) — verified 2026-08-28 · v2.3.8~2.3.8 · conflicts: oh-my-claudecode(inferred), agent-governance-toolkit(inferred), deepcode(inferred)
- [deepcode: Headless multi-agent coding system on the command line; init, provider, exec for agentic coding tasks.](https://trove.xin/solutions/deepcode) — verified 2026-08-28 · v2.1.0~2.1.0 · conflicts: oh-my-claudecode(inferred), agent-governance-toolkit(inferred)
- [frp: Expose LAN services without a public IP via frps/frpc; SSH home, HTTP serving, remote debugging.](https://trove.xin/solutions/frp) — verified 2026-08-31 · v0.52.0~0.71.0
- [herdr: Persistent multi-session manager for agent CLIs: sessions, workspaces, worktrees, tabs, notifications.](https://trove.xin/solutions/herdr) — verified 2026-08-28 · v0.8.2~0.8.2
- [hoop: Zero-trust access gateway: identity-based access to databases, infrastructure and services via one CLI.](https://trove.xin/solutions/hoop) — verified 2026-08-28 · v0.3.2~0.3.2
- [litellm: One OpenAI-compatible endpoint for 100+ LLM providers; unified model access, keys and cost tracking.](https://trove.xin/solutions/litellm) — verified 2026-08-29 · v1.98.0~1.98.0 · conflicts: logfire(inferred), claude-code-router(inferred)
- [logfire: OpenTelemetry-native observability for AI/LLM systems and Python apps: logs, traces and metrics in one place.](https://trove.xin/solutions/logfire) — verified 2026-08-28 · v4.41.0~4.41.0 · conflicts: oh-my-claudecode(inferred), agent-governance-toolkit(inferred), deepcode(inferred)
- [moltis: Self-hosted agent gateway: one server for AI agents across web, Telegram and WhatsApp channels.](https://trove.xin/solutions/moltis) — verified 2026-08-28 · v20260830.01~20260830.01 · conflicts: oh-my-claudecode(inferred), agent-governance-toolkit(inferred), deepcode(inferred)
- [oh-my-pi: IDE coding agent (CLI + VS Code extension): Claude Code/Codex-style workflows, profiles and subagents.](https://trove.xin/solutions/oh-my-pi) — verified 2026-08-31 · v18.0.11~18.0.11
- [ollama: Run open-weight LLMs locally with an OpenAI-compatible API; one command downloads and serves models.](https://trove.xin/solutions/ollama) — verified 2026-08-29 · v0.33.2~0.33.2 · conflicts: open-webui(inferred), llama-factory(inferred)
- [oh-my-claudecode: Team-first multi-agent orchestration as a Claude Code plugin: roles, delegation and shared team workflows.](https://trove.xin/solutions/oh-my-claudecode) — verified 2026-08-28 · v5.1.0~5.1.0 · conflicts: agent-governance-toolkit(inferred), ruflo(inferred), code-review-graph(inferred)
- [open-webui: Browser chat UI on top of Ollama: chat, switch models, keep session history and use local RAG knowledge.](https://trove.xin/solutions/open-webui) — verified 2026-09-01 · v0.11.1~0.11.3 · conflicts: ollama(inferred)
- [openclaw: Self-hosted personal AI assistant: local Gateway, chat channels, cron automations and browser automation.](https://trove.xin/solutions/openclaw) — verified 2026-09-01 · v2026.8.1~2026.8.1
- [playwright-mcp: Give AI agents real browser control: navigate, click, assert and extract via an MCP server.](https://trove.xin/solutions/playwright-mcp) — verified 2026-08-29 · v0.0.79~0.0.79 · conflicts: vite-deploy(inferred), repomix(inferred)
- [repomix: Pack an entire repository into a single file for LLM context; token budgets, includes, compression.](https://trove.xin/solutions/repomix) — verified 2026-08-29 · v1.18.0~1.18.0 · conflicts: code-review-graph(inferred), swe-rex(inferred)
- [ruflo: Orchestrate Claude Code and other agents: swarms, agents, memory, MCP, hooks, daemon.](https://trove.xin/solutions/ruflo) — verified 2026-08-27 · v3.38.20~3.38.20 · conflicts: oh-my-claudecode(inferred), agent-governance-toolkit(inferred), deepcode(inferred)
- [skilldock: Install, organize and git-sync AI skills for Claude Code, Cursor and Codex from one desktop app.](https://trove.xin/solutions/skilldock) — verified 2026-08-28 · v1.0.15~1.0.15
- [skillspector: Scans skills before install for vulnerabilities, malicious patterns and unsafe configurations.](https://trove.xin/solutions/skillspector) — verified 2026-08-28 · v2.10.0~2.10.0
- [superpowers: 14 composable skills plus a software development methodology for structured, AI-driven coding workflows.](https://trove.xin/solutions/superpowers) — verified 2026-08-27 · v6.3.0~6.3.0 · conflicts: oh-my-claudecode(inferred), agent-governance-toolkit(inferred), deepcode(inferred)
- [swe-rex: Sandboxed code execution for coding agents: run commands and tests safely locally or in the cloud, in parallel.](https://trove.xin/solutions/swe-rex) — verified 2026-08-28 · v1.4.0~1.4.0
- [uptime-kuma: Self-hosted uptime monitoring with HTTP/TCP/Ping heartbeats, status pages and alerts; Docker one-command setup.](https://trove.xin/solutions/uptime-kuma) — verified 2026-09-01 · v2.5.3~2.5.3 · conflicts: open-webui(measured), ollama(measured)
- [vite-deploy: Zero-config frontend build with content-hashed assets; diagnose post-deploy white screens (ChunkLoadError).](https://trove.xin/solutions/vite-deploy) — verified 2026-08-31 · v5.0~8.2
## Combos

- [AI 代码审查工作流（repomix + code-review-graph + swe-rex）](https://trove.xin/combos/combo-ai-code-review) — 想让 AI 审查/理解自己的代码库，但仓库大、上下文窗口有限，喂不进去也喂不全 · members: repomix, code-review-graph, swe-rex · status: partial · install-script: https://trove.xin/combos/combo-ai-code-review.sh
- [自动化测试闭环（静态分析 → 沙箱执行 → 浏览器 E2E）](https://trove.xin/combos/combo-auto-test) — 改了代码想自动验证不回归——静态分析先拦、沙箱里跑得起来、浏览器里断言真实页面；三个环节各自有工具但没有成套编排 · members: deepcode, swe-rex, playwright-mcp · status: partial · install-script: https://trove.xin/combos/combo-auto-test.sh
- [CI/CD 质量门禁（swe-rex + deepcode + code-review-graph）](https://trove.xin/combos/combo-cicd-quality) — 用户想在 CI/CD 里加一道「质量门禁」——代码安全跑、提交前查问题、审查时看影响面，三个工具一次装齐不打架。 · members: swe-rex, deepcode, code-review-graph · status: verified · install-script: https://trove.xin/combos/combo-cicd-quality.sh
- [docker-compose 开发环境](https://trove.xin/combos/combo-docker-compose-dev) — 想用 docker-compose 一键起全套开发环境（MySQL/Redis/Nginx 等），不知道 compose 怎么写、镜像怎么拉、数据怎么留 · members: docker compose, MySQL 8.0 镜像, Redis 7 镜像 · status: verified · install-script: https://trove.xin/combos/combo-docker-compose-dev.sh
- [容器与 WSL 环境成套配置与排查](https://trove.xin/combos/combo-docker-wsl-env) — Docker 和 WSL 装了但"用不起来"——daemon 连不上、端口冲突、exec 报 TTY、容器访问不了宿主机、WSL 输出乱码、报磁盘满、WSL 里找不到 node；每篇教程各讲一个坑，本组合包按「先 WSL 后 Docker」顺序成套解决 · members: WSL, Docker Engine · status: partial · install-script: https://trove.xin/combos/combo-docker-wsl-env.sh
- [Agent 开发环境一键初始化](https://trove.xin/combos/combo-env-init) — 新机器/新仓库想让 AI 立刻能干活——读代码、记上下文、跑会话、带技能；每个工具单独装单独配，顺序与组合没人讲清 · members: agent-framework, agent-skills, superpowers, herdr, ruflo, claude-mem · status: partial · install-script: https://trove.xin/combos/combo-env-init.sh
- [开发链路治理栈（agent-governance-toolkit + code-review-graph + herdr）](https://trove.xin/combos/combo-governance-stack) — 用户想让 Agent 在开发链路里「先守规矩、再写代码、再管会话」——策略门禁、代码审查图谱、会话/工作区监督三件套一次装齐。 · members: agent-governance-toolkit, code-review-graph, herdr · status: verified · install-script: https://trove.xin/combos/combo-governance-stack.sh
- [本地大模型微调/推理环境（ollama + open-webui + LLaMA-Factory）](https://trove.xin/combos/combo-local-llm-finetune) — 用户想做本地大模型（微调/推理），网上教程零散、环境装不起来——一包装齐：模型下载与运行底座 + 网页界面 + 微调工具。 · members: ollama, open-webui, LLaMA-Factory, nomic-embed-text · status: verified · install-script: https://trove.xin/combos/combo-local-llm-finetune.sh
- [本地知识库问答（ollama + MaxKB）](https://trove.xin/combos/combo-local-rag) — 用户想把笔记/文档变成「能问答的私人知识库」，不知道用什么工具——一包装齐：模型底座 + 知识库问答界面，国内网络适配。 · members: ollama, MaxKB · status: verified · install-script: https://trove.xin/combos/combo-local-rag.sh
- [单会话记忆治理栈（claude-mem + deepcode + code-review-graph）](https://trove.xin/combos/combo-memory-session) — 用户想要「记得住 + 查得准 + 看得全」的单会话开发闭环——跨会话记忆、提交前静态分析、改动影响面图谱一次装齐。 · members: claude-mem, deepcode, code-review-graph · status: verified · install-script: https://trove.xin/combos/combo-memory-session.sh
- [国内网络一键配源](https://trove.xin/combos/combo-mirror-setup) — 新装一台机器，pip/npm/go/docker 全要配国内源；每篇教程各讲各的，容易配错、配完不知道有没有生效 · members: pip, npm, Go, Docker · status: partial · install-script: https://trove.xin/combos/combo-mirror-setup.sh
- [多模型接入与成本可观测](https://trove.xin/combos/combo-model-access) — 项目接了多个模型供应商（OpenAI/Anthropic/国产模型），客户端各配各的 key、成本没人说得清，切换与限流全靠手改 · members: litellm, logfire · status: partial · install-script: https://trove.xin/combos/combo-model-access.sh
- [多 Agent 工作流编排](https://trove.xin/combos/combo-multi-agent-workflow) — 想让多个 Agent 自动协作完成多步任务（并行跑 / 分步走 / 结果汇总），不知道用什么工具 · members: ruflo, claude-mem, claude-code-router · status: partial · install-script: https://trove.xin/combos/combo-multi-agent-workflow.sh
- [权限与安全排查（Permission denied / EACCES / 属主不一致）](https://trove.xin/combos/combo-permission-security) — 工具装好了但一跑就报权限错——Docker 容器读写挂载目录被拒、git 报 dubious ownership、npm 全局安装 EACCES、SSH 私钥权限过宽、Codex 沙盒 setup refresh 报错 · members: 通用定位, Docker 容器, Git, npm, SSH, Codex 沙盒 · status: partial · install-script: https://trove.xin/combos/combo-permission-security.sh
- [安全前置（agentshield + skillspector）](https://trove.xin/combos/combo-security-preflight) — 用户在装任何插件/技能/仓库之前想先跑一遍安检——配置面攻击面审计 + 技能/内容面扫描，两个只读扫描器一次装齐。 · members: skillspector, agentshield · status: verified · install-script: https://trove.xin/combos/combo-security-preflight.sh
- [网页部署验证](https://trove.xin/combos/combo-web-deploy-verify) — 网站部署/更新后无法确认「网页真实可访问」——部署脚本说成功，但页面白屏、路由 404、样式没加载，只能靠人打开浏览器看 · members: vite-deploy, playwright-mcp · status: verified · install-script: https://trove.xin/combos/combo-web-deploy-verify.sh

## Problems

- [Python 3.14 装 agent-framework 全量卡死：resolution-too-deep（依赖图过深）](https://trove.xin/problems/agent-framework-2) — applies_to: agent-framework · domain: multi-agent
- [MCP 连接只显示 Cancelled via...（真实 401 认证错误被掩盖）](https://trove.xin/problems/agent-framework-3) — applies_to: agent-framework · domain: multi-agent
- [agent hooks 装不上/不生效（仓库 setup 只做 git hooks）](https://trove.xin/problems/agent-framework-4) — applies_to: agent-framework · domain: multi-agent
- [官方 CLI 安装失败：GitHub clone 被重置/卡死（国内高频）](https://trove.xin/problems/agent-skills-1) — applies_to: agent-skills · domain: skills
- [安装失败排查：Node 版本 / pnpm / npm 缓存](https://trove.xin/problems/agent-skills-2) — applies_to: agent-skills · domain: skills
- [同名项目污染：pip 装到 ivanzwb / 国外多个同名 repo](https://trove.xin/problems/agent-skills-3) — applies_to: agent-skills · domain: skills
- [装完看不到技能 / document-skills 安装问答](https://trove.xin/problems/agent-skills-4) — applies_to: agent-skills · domain: skills
- [Agent 工具链全家桶能一起装吗？（17 工具 57 对实测兼容清单）](https://trove.xin/problems/agent-toolchain-coexist) — applies_to: agent-framework, agent-governance-toolkit, agent-skills, agentshield, deepcode, code-review-graph, claude-code-router, logfire, moltis, oh-my-claudecode, herdr, skillspector, oh-my-pi, hoop, swe-rex, superpowers, claude-mem · domain: multi-agent
- [apt-get update 报 404 Not Found / 源失效（Err:1 ... 404）](https://trove.xin/problems/apt-404-broken) — applies_to: apt · domain: coding
- [dpkg -i 依赖缺失：libwebkit2gtk 等（Linux 安装/启动失败）](https://trove.xin/problems/cc-switch-1) — applies_to: cc-switch · domain: session
- [GitHub Release 下载 TLS 断连 / 超时](https://trove.xin/problems/cc-switch-2) — applies_to: cc-switch · domain: session
- [架构不匹配（香橙派等 ARM 设备）](https://trove.xin/problems/cc-switch-3) — applies_to: cc-switch · domain: session
- [启动失败 / 白屏排查](https://trove.xin/problems/cc-switch-4) — applies_to: cc-switch · domain: session
- [安装来源混淆：npm 同名包 / 其它 cc-switch 项目](https://trove.xin/problems/cc-switch-5) — applies_to: cc-switch · domain: session
- [EBADENGINE：Node 版本不满足 engines](https://trove.xin/problems/claude-code-router-1) — applies_to: claude-code-router · domain: gateway
- [WSL 里 node: not found（npm 来自 Windows 侧）](https://trove.xin/problems/claude-code-router-2) — applies_to: claude-code-router · domain: gateway
- [首次运行 No available models / 网关起不来](https://trove.xin/problems/claude-code-router-3) — applies_to: claude-code-router · domain: gateway
- [本地模型 api_base_url 配置错误（Ollama 等）](https://trove.xin/problems/claude-code-router-4) — applies_to: claude-code-router · domain: gateway
- [Docker 部署：端口 / volume / 权限](https://trove.xin/problems/claude-code-router-5) — applies_to: claude-code-router · domain: gateway
- [JSON / API 配置错误导致服务启动失败](https://trove.xin/problems/claude-code-router-6) — applies_to: claude-code-router · domain: gateway
- [多个工具都写 ~/.claude.json，一起装会冲突吗？（实测兼容）](https://trove.xin/problems/claude-json-multi-tool) — applies_to: agent-governance-toolkit, deepcode, code-review-graph · domain: multi-agent
- [marketplace 克隆失败：SSH 认证失败 / 克隆卡死](https://trove.xin/problems/claude-mem-1) — applies_to: claude-mem · domain: session
- [worker/UI 端口占用："Is port 37777 in use?"](https://trove.xin/problems/claude-mem-2) — applies_to: claude-mem · domain: session
- [首会话重复 SessionStart hook 错误（worker 竞态）](https://trove.xin/problems/claude-mem-3) — applies_to: claude-mem · domain: session
- [npm 依赖安装失败](https://trove.xin/problems/claude-mem-4) — applies_to: claude-mem · domain: session
- [Chroma 进程泄漏 / zombie 链](https://trove.xin/problems/claude-mem-5) — applies_to: claude-mem · domain: session
- [第三方模型鉴权切换后 "No previous sessions found"](https://trove.xin/problems/claude-mem-6) — applies_to: claude-mem · domain: session
- [opencode 安装 API 不匹配](https://trove.xin/problems/claude-mem-7) — applies_to: claude-mem · domain: session
- [名称混淆：juspay/code-review-graph-rescript 同名变体](https://trove.xin/problems/code-review-graph-2) — applies_to: code-review-graph · domain: review
- [安装后「我的配置被改了」/ 与 omc、agt 疑似冲突](https://trove.xin/problems/code-review-graph-3) — applies_to: code-review-graph · domain: review
- [GitHub 直连慢/失败（依赖 GitHub 的场景）](https://trove.xin/problems/code-review-graph-4) — applies_to: code-review-graph · domain: review
- [ChatGPT Windows 客户端打不开：Unable to locate the Codex CLI binary / 找不到 Codex CLI](https://trove.xin/problems/codex-cli-chatgpt-not-found) — applies_to: codex · domain: coding
- [Codex 沙盒报错 helper_unknown_error: setup refresh had errors（写权限/ACL）](https://trove.xin/problems/codex-sandbox-setup-error) — applies_to: codex · domain: security
- [Codex 桌面应用更新失败（应用内更新报错 / MSIX 手动安装）](https://trove.xin/problems/codex-update-msix) — applies_to: codex · domain: coding
- [bash 脚本报 $'\r': command not found / bad interpreter: /bin/bash^M——Windows 换行符（CRLF）混入](https://trove.xin/problems/crlf-command-not-found) — applies_to: bash · domain: coding
- [crontab 任务报 command not found / 环境变量缺失（nvm、conda 装的东西跑不了）](https://trove.xin/problems/crontab-env-path) — applies_to: cron · domain: coding
- [CSS 样式加载失败（页面无样式/布局错乱，控制台可能无报错）](https://trove.xin/problems/css-load-failure) — applies_to: nginx, vite-deploy · domain: deploy
- [大文件下载中断后无法续传（curl: (33) HTTP server does not seem to support byte ranges）](https://trove.xin/problems/curl-resume-break) — applies_to: curl · domain: coding
- [git clone 连接被重置（源码安装路径）](https://trove.xin/problems/deepcode-2) — applies_to: deepcode · domain: multi-agent
- [curl 证书报错（--ssl-no-revoke）](https://trove.xin/problems/deepcode-3) — applies_to: deepcode · domain: multi-agent
- [旧 Python 装不上（requires-python）](https://trove.xin/problems/deepcode-4) — applies_to: deepcode · domain: multi-agent
- [MCP client 起不来（Brave MCP WinError 2 / npx 未跑起来）](https://trove.xin/problems/deepcode-5) — applies_to: deepcode · domain: multi-agent
- [装完跑 agent 无响应（需 init + provider 配置）](https://trove.xin/problems/deepcode-6) — applies_to: deepcode · domain: multi-agent
- [Docker build 缓存不生效（每次改代码都重跑安装层）—— COPY 顺序与 .dockerignore](https://trove.xin/problems/docker-build-cache) — applies_to: docker · domain: coding
- [docker-compose / docker compose 报 command not found（Compose 没装或没接线）](https://trove.xin/problems/docker-compose-command-not-found) — applies_to: docker · domain: coding
- [docker compose 起栈失败——依赖服务没就绪（Connection refused / unhealthy / depends_on 不生效）](https://trove.xin/problems/docker-compose-depends-not-ready) — applies_to: docker · domain: coding
- [Docker 容器内域名解析失败（wget: bad address / Temporary failure in name resolution / Could not resolve host）](https://trove.xin/problems/docker-container-dns) — applies_to: docker · domain: coding
- [docker 报 Conflict. The container name "/xxx" is already in use（容器名被占用）](https://trove.xin/problems/docker-container-name-conflict) — applies_to: docker · domain: coding
- [容器进程突然被杀（OOMKilled / exit code 137）——内存限制与排查](https://trove.xin/problems/docker-container-oom-killed) — applies_to: docker · domain: coding
- [容器里时间差 8 小时（date 显示 UTC）/ 中文乱码（UnicodeEncodeError）](https://trove.xin/problems/docker-container-timezone-locale) — applies_to: docker · domain: coding
- [docker 命令报 Cannot connect to the Docker daemon at unix:///var/run/docker.sock / failed to connect to the docker API（连不上 daemon）](https://trove.xin/problems/docker-daemon-connect) — applies_to: docker · domain: coding
- [Docker Desktop 启动失败：The file cannot be accessed by the system / 孤儿 AF_UNIX socket](https://trove.xin/problems/docker-desktop-orphan-socket) — applies_to: docker · domain: coding
- [docker exec 报 the input device is not a TTY / container is not running / executable file not found](https://trove.xin/problems/docker-exec-tty) — applies_to: docker · domain: coding
- [Docker 容器内连不上宿主机服务（localhost 是容器自己，不是宿主机）](https://trove.xin/problems/docker-host-access) — applies_to: docker · domain: coding
- [docker pull 报 ERROR: Get "https://registry-1.docker.io/v2/" ... connection reset by peer / 拉取镜像失败](https://trove.xin/problems/docker-hub-pull-fail) — applies_to: docker · domain: coding
- [docker 报 invalid reference format / repository name must be lowercase（镜像引用格式非法）](https://trove.xin/problems/docker-invalid-reference-format) — applies_to: docker · domain: coding
- [docker pull 报 manifest for "xxx:latest" not found（镜像或标签不存在）](https://trove.xin/problems/docker-manifest-not-found) — applies_to: docker · domain: coding
- [docker run / compose up 报 port is already allocated / address already in use（端口被占用）](https://trove.xin/problems/docker-port-already-allocated) — applies_to: docker · domain: coding
- [docker system prune 到底删什么？容器/镜像/卷/缓存清理边界速查](https://trove.xin/problems/docker-prune-scope) — applies_to: docker · domain: coding
- [Docker bind mount / volume 权限报错（Permission denied）：容器进程无法读写挂载目录](https://trove.xin/problems/docker-volume-permission) — applies_to: docker · domain: coding
- [powershell 运行 .ps1 报「禁止运行脚本」——执行策略（ExecutionPolicy）限制](https://trove.xin/problems/execpolicy-restricted) — applies_to: powershell · domain: coding
- [程序偶发 SIGSEGV 崩溃，gdb 显示 best=DBL_MAX 且指针为空——浮点比较"恒不成立"时哨兵从未被覆盖](https://trove.xin/problems/float-crash) — applies_to: gcc · domain: coding
- [LLM Function Calling 不可控？AI 建议的危险调用必须过白名单（本地 qwen 实测）](https://trove.xin/problems/function-calling-guard) — applies_to: ollama, python · domain: local-llm
- [git 换行符混乱——diff 全部文件显示修改 / warning: LF will be replaced by CRLF / CRLF will be replaced by LF](https://trove.xin/problems/git-crlf) — applies_to: git · domain: coding
- [git 报 fatal: detected dubious ownership in repository at（仓库属主与当前用户不一致）](https://trove.xin/problems/git-dubious-ownership) — applies_to: git · domain: coding
- [git clone 公开仓库报 fatal: Could not read from remote repository / Please make sure you have the correct access rights and the repository exists（网络正常）](https://trove.xin/problems/github-clone-fail) — applies_to: git · domain: coding
- [GitHub 直连慢/失败（clone 被重置、443 连不上、SSH 认证、Release 下载中断）](https://trove.xin/problems/github-direct-connect-fail) — applies_to: git · domain: coding
- [go get/go mod download 超时（dial tcp ... i/o timeout）→ 换 GOPROXY 国内代理](https://trove.xin/problems/go-proxy-cn) — applies_to: go · domain: coding
- [`herdr server start` 无效 / 后台 server 未拉起（v0.8.2 没有 server start 子命令）](https://trove.xin/problems/herdr-1) — applies_to: herdr · domain: coding
- [Windows 上 herdr 用 PowerShell 安装失败（下载被重置；改直下二进制）](https://trove.xin/problems/herdr-2) — applies_to: herdr · domain: coding
- [SSH 远程用 herdr 中文显示乱码/输入无效（终端编码与 locale）](https://trove.xin/problems/herdr-3) — applies_to: herdr · domain: coding
- [Hugging Face 模型下载卡住/超时（国内）——HF_ENDPOINT 切 hf-mirror，代码零改动](https://trove.xin/problems/hf-model-download) — applies_to: python · domain: coding
- [Java OOM 六种报错签名速查：heap space / Metaspace / StackOverflowError / native thread / GC Overhead](https://trove.xin/problems/java-oom-classify) — applies_to: jdk · domain: coding
- [训练时 loss 突然尖峰（spike）/ 数值发散（NaN、inf）怎么办](https://trove.xin/problems/llm-training-loss-spike) — applies_to: python · domain: local-llm
- [FastAPI+SQLModel 测试报 sqlalchemy.exc.NoInspectionAvailable](https://trove.xin/problems/logfire-1) — applies_to: logfire · domain: observability
- [升级后刷 Invalid type NoneType for attribute 'http.port' value 警告](https://trove.xin/problems/logfire-2) — applies_to: logfire · domain: observability
- [MinIO 社区版停更归档，Docker 部署的文件服务怎么办（迁移 RustFS 数据零丢失）](https://trove.xin/problems/minio-to-rustfs-migration) — applies_to: minio, rustfs, docker · domain: deploy
- [MySQL 误删数据后如何恢复（binlog 闪回）](https://trove.xin/problems/mysql-binlog-flashback) — applies_to: mysql · domain: deploy
- [Netty 直接内存 OOM：OutOfDirectMemoryError / Direct buffer memory（ByteBuf 泄漏 + MaxDirectMemorySize 未设）](https://trove.xin/problems/netty-direct-memory-oom) — applies_to: jdk · domain: coding
- [Node 构建/打包报 FATAL ERROR ... JavaScript heap out of memory（内存溢出）](https://trove.xin/problems/node-heap-oom) — applies_to: node, npm · domain: coding
- [npm run 报 Error: error:0308010C:digital envelope routines::unsupported（Node 新版本 + 老 webpack）](https://trove.xin/problems/npm-digital-envelope-unsupported) — applies_to: node, npm · domain: coding
- [npm install 报 npm ERR! code ERESOLVE / ERESOLVE unable to resolve dependency tree（peer 依赖冲突）](https://trove.xin/problems/npm-eresolve-peer-conflict) — applies_to: node, npm · domain: coding
- [npm install -g 报 npm ERR! code EACCES permission denied（全局安装权限）](https://trove.xin/problems/npm-global-eacces) — applies_to: npm · domain: coding
- [npm install 慢/随机挂起/网络错误（ETIMEDOUT / ECONNRESET / hang forever）](https://trove.xin/problems/npm-mirror-registry) — applies_to: node, npm · domain: coding
- [命令未找到（omc: command not found）](https://trove.xin/problems/oh-my-claudecode-1) — applies_to: oh-my-claudecode · domain: multi-agent
- [钩子未执行（hook 不触发 / Windows hook 报错）](https://trove.xin/problems/oh-my-claudecode-2) — applies_to: oh-my-claudecode · domain: multi-agent
- [智能体未自动委托（任务没被分发）](https://trove.xin/problems/oh-my-claudecode-3) — applies_to: oh-my-claudecode · domain: multi-agent
- [更新 / 配置异常（omc-doctor 诊断）](https://trove.xin/problems/oh-my-claudecode-4) — applies_to: oh-my-claudecode · domain: multi-agent
- [包名 / 插件名 / 命令名不一致](https://trove.xin/problems/oh-my-claudecode-5) — applies_to: oh-my-claudecode · domain: multi-agent
- [Claude Code 本体环境类报错（OOM / Homebrew 冲突 / PowerShell 执行策略）](https://trove.xin/problems/oh-my-claudecode-6) — applies_to: oh-my-claudecode · domain: multi-agent
- [同名 fork 项目混淆](https://trove.xin/problems/oh-my-claudecode-7) — applies_to: oh-my-claudecode · domain: multi-agent
- [安装成功但 omp --version 报 SyntaxError（旧版 bun）](https://trove.xin/problems/oh-my-pi-1) — applies_to: oh-my-pi · domain: coding
- [命令混淆：omp install 与 omp plugin install](https://trove.xin/problems/oh-my-pi-2) — applies_to: oh-my-pi · domain: coding
- [Windows/ARM release 二进制加载外部扩展失败](https://trove.xin/problems/oh-my-pi-3) — applies_to: oh-my-pi · domain: coding
- [名称混淆：oh-my-pi（omp）vs pi-mono（pi）](https://trove.xin/problems/oh-my-pi-4) — applies_to: oh-my-pi · domain: coding
- [ollama 命令报 "could not connect to a running Ollama instance"（服务没启动）](https://trove.xin/problems/ollama-connect-failed) — applies_to: ollama · domain: local-llm
- [ollama 装不上/官方安装脚本国内拉不动（下载慢、超时）](https://trove.xin/problems/ollama-install-slow) — applies_to: ollama · domain: local-llm
- [模型都下到 C 盘/系统盘了，怎么把 Ollama 模型目录换到别的盘](https://trove.xin/problems/ollama-models-migration) — applies_to: ollama, docker · domain: local-llm
- [ollama pull 卡住/超时（官方 registry 国内直连不稳定）](https://trove.xin/problems/ollama-pull-timeout) — applies_to: ollama · domain: local-llm
- [Open WebUI 用 Docker 起不来（镜像拉不动、端口被占、页面打不开、数据丢）](https://trove.xin/problems/open-webui-deploy-fail) — applies_to: open-webui, docker · domain: local-llm
- [Open WebUI 忘记管理员密码 / 登录不进去怎么办](https://trove.xin/problems/open-webui-forgot-password) — applies_to: docker, open-webui · domain: local-llm
- [Docker 里跑 Open WebUI 连不上 Ollama（页面显示 Ollama 未连接 / 模型列表为空）](https://trove.xin/problems/open-webui-ollama-connect) — applies_to: open-webui, docker · domain: local-llm
- [Open WebUI 知识库检索不生效 / embedding 配置错（上传文件报 Ollama embed 404）](https://trove.xin/problems/open-webui-rag-embedding) — applies_to: open-webui, ollama · domain: local-llm
- [Ubuntu/Debian pip install 报 error: externally-managed-environment（PEP 668）](https://trove.xin/problems/pep668-externally-managed) — applies_to: python, pip · domain: coding
- [pip 安装超时/下载慢（ReadTimeoutError / WARNING: Retrying ... Read timed out）](https://trove.xin/problems/pip-mirror-source) — applies_to: python, pip, deepcode, code-review-graph, logfire, agent-framework · domain: coding
- [pip install 报 SSL 证书错误（CERTIFICATE_VERIFY_FAILED）——信任链断了，别急着 --trusted-host](https://trove.xin/problems/pip-ssl-cert) — applies_to: pip · domain: coding
- [设置了代理环境变量却不生效——有的命令走代理有的不走（HTTP_PROXY 大小写坑）](https://trove.xin/problems/proxy-env-var) — applies_to: curl · domain: coding
- [python: command not found——Ubuntu 只有 python3，没有 python 命令](https://trove.xin/problems/python-command-not-found) — applies_to: python · domain: coding
- [Python 3.12+ 报 ModuleNotFoundError: No module named 'distutils'](https://trove.xin/problems/python-distutils-removed) — applies_to: python, pip · domain: coding
- [Python 读文件报 UnicodeDecodeError（utf-8/gbk codec can't decode byte）——文件编码与默认编码不匹配](https://trove.xin/problems/python-unicode-decode) — applies_to: python · domain: coding
- [venv 移动/复制目录后失效（bad interpreter: No such file or directory / venv/bin/activate: No such file or directory）](https://trove.xin/problems/python-venv-move) — applies_to: python · domain: coding
- [`ruflo plugins install` 命令不存在（正确技能入口是 npx skills add）](https://trove.xin/problems/ruflo-1) — applies_to: ruflo · domain: multi-agent
- [ruflo 安装被未发布依赖 pin 卡住（@claude-flow/mcp alpha 未发布）](https://trove.xin/problems/ruflo-2) — applies_to: ruflo · domain: multi-agent
- [Windows 上 `hive-mind spawn --claude` 检测不到 claude CLI（PATH 检测失败）](https://trove.xin/problems/ruflo-3) — applies_to: ruflo · domain: multi-agent
- [首次 npx ruflo init 很慢、npx 缓存约 2GB（磁盘敏感环境）](https://trove.xin/problems/ruflo-4) — applies_to: ruflo · domain: multi-agent
- [bash: ./script.sh: Permission denied——脚本缺执行权限](https://trove.xin/problems/script-permission-denied) — applies_to: bash · domain: coding
- [只有个别网站打不开（其他网站都正常）——从 curl 超时到分层定位](https://trove.xin/problems/site-open-fail-others-ok) — applies_to: curl · domain: coding
- [pip install skillspector 找不到包（No matching distribution）](https://trove.xin/problems/skillspector-1) — applies_to: skillspector · domain: security
- [Failed building wheel for yara-python（构建依赖缺失）](https://trove.xin/problems/skillspector-2) — applies_to: skillspector · domain: security
- [MCP 模式 stdio 挂起（可选依赖缺失）](https://trove.xin/problems/skillspector-3) — applies_to: skillspector · domain: security
- [依赖版本冲突警告](https://trove.xin/problems/skillspector-4) — applies_to: skillspector · domain: security
- [风险评分 >50 输出 DO NOT INSTALL](https://trove.xin/problems/skillspector-5) — applies_to: skillspector · domain: security
- [semantic_* 分析器警告（缺 API key）](https://trove.xin/problems/skillspector-6) — applies_to: skillspector · domain: security
- [短信接口被狂刷（短信费用飙升/接口被打垮，怎么限流止损）](https://trove.xin/problems/sms-api-rate-limit) — applies_to: nginx · domain: security
- [SSH 报 UNPROTECTED PRIVATE KEY FILE / Permissions ... are too open（私钥权限过宽）](https://trove.xin/problems/ssh-key-permissions) — applies_to: ssh · domain: coding
- [/plugin install 报 fatal: Failed to connect to github.com port 443](https://trove.xin/problems/superpowers-1) — applies_to: superpowers · domain: skills
- [ZIP / tarball 下载超时或中断](https://trove.xin/problems/superpowers-2) — applies_to: superpowers · domain: skills
- [Plugin not found](https://trove.xin/problems/superpowers-3) — applies_to: superpowers · domain: skills
- [安装后 hook error（Windows SessionStart hook fails）](https://trove.xin/problems/superpowers-4) — applies_to: superpowers · domain: skills
- [装完看不到技能](https://trove.xin/problems/superpowers-5) — applies_to: superpowers · domain: skills
- [本地/离线部署后插件显示不可用（感叹号）](https://trove.xin/problems/superpowers-6) — applies_to: superpowers · domain: skills
- [无本地文件读取权限 / 渠道不一致](https://trove.xin/problems/superpowers-7) — applies_to: superpowers · domain: skills
- [解压 tar 包多出顶层目录 / 文件散落一地 —— --strip-components 用法（macOS 报 Option not supported）](https://trove.xin/problems/tar-strip-components) — applies_to: tar · domain: coding
- [JDK 老项目升级 TLS 握手失败：Received fatal alert: protocol_version / No appropriate protocol](https://trove.xin/problems/tls-jdk-upgrade) — applies_to: jdk, openssl · domain: security
- [卸载后残留——共享配置不还原 / 命令仍在](https://trove.xin/problems/uninstall-leftover) — applies_to: cc-switch, claude-code-router · domain: coding
- [前端发布后偶发白屏（ChunkLoadError / 版本错位）](https://trove.xin/problems/vite-chunkloaderror) — applies_to: vite-deploy, nginx · domain: deploy
- [Vue3 + Vite history 路由部署后刷新白屏（404）](https://trove.xin/problems/vite-history-fallback) — applies_to: vite-deploy, nginx · domain: deploy
- [wsl --import 迁移/重装后默认用户变成 root，whoami 变了、权限全乱](https://trove.xin/problems/wsl-default-user-root-after-import) — applies_to: wsl · domain: coding
- [WSL 里报 Temporary failure in name resolution / 连不上网，VPN 一连上 WSL 就断网](https://trove.xin/problems/wsl-dns-resolution-failure) — applies_to: wsl · domain: coding
- [WSL 里运行 notepad.exe / cmd.exe 报 command not found（interop 失效）](https://trove.xin/problems/wsl-interop-disabled) — applies_to: wsl · domain: coding
- [WSL 里报 No space left on device，但 df 显示还有大量空间](https://trove.xin/problems/wsl-no-space-left) — applies_to: wsl · domain: coding
- [PowerShell 里调 wsl 输出乱码（每字符带空字节 / 每字符一行 / 中文变 �）](https://trove.xin/problems/wsl-pipe-encoding) — applies_to: wsl · domain: coding
- [WSL 启动发行版报 WslRegisterDistribution failed（0x800701bc / 0x80370102）](https://trove.xin/problems/wsl-register-failed) — applies_to: wsl · domain: coding
- [WSL 里 systemctl 报 System has not been booted with systemd / 服务起不来](https://trove.xin/problems/wsl-systemd-not-running) — applies_to: wsl · domain: coding
- [yfinance history 一直超时（Cookie/crumb fetch failed / curl 28）](https://trove.xin/problems/yfinance-history-timeout) — applies_to: yfinance · domain: gateway
- [zip 解压后中文文件名乱码（Windows/360 压缩的文件在 Linux 上乱码）](https://trove.xin/problems/zip-gbk-filename) — applies_to: zip · domain: coding

## Experience

- [用 AI 编程越用越累？你的问题不是模型，是把「生成」和「验证」搞反了](https://trove.xin/problems/ai-coding-fatigue-consensus) — domain: experience · recorded: 2026-08-30（经验域试点第二条，共识型经验）
- [AI Coding 蜜月期之后——代码生成不是瓶颈了，那瓶颈在哪？](https://trove.xin/problems/ai-coding-honeymoon-consensus) — domain: experience · recorded: 2026-09-01（经验域第十二条，共识型经验；素材：AI Coding 蜜月期之后（企业级落地复盘）/面试 AI Coding 只看你是不是驾驶员/给 AI 编程代理做减法：Token 经济学/我每天指挥十几个 Agent——4 篇同主题）
- [Code Review 变成了形式主义，还拖慢迭代——怎么让它真正有用？](https://trove.xin/problems/code-review-consensus) — domain: experience · recorded: 2026-09-01（经验域第四条，共识型经验；素材：Worktile/掘金/阿里云/GOTO 播客/RAKUS/tsecurity 等 8 篇同主题）
- [诡异 Bug 查不出来？不是运气差——把排障从「猜」变成「证据链」](https://trove.xin/problems/debugging-methodology-consensus) — domain: experience · recorded: 2026-09-01（经验域第十一条，共识型经验；素材：DNS 故障证据链排查/生产事故 OOM 复盘/异地多活限流排查/网关直接内存泄漏/SOCKS5 代理下载调试，5 篇同主题）
- [写文档到底图什么？——从"写文档累、看文档更累"到"文档是给未来自己、队友和 AI 的资产"](https://trove.xin/problems/doc-culture-consensus) — domain: experience · recorded: 2026-09-01（经验域第十条，共识型经验；素材：掘金腾讯 AI 编程上瘾总结/掘金 AI 辅助到 AI 主导/博客园字节飞书异步协同调研/博客园 11.10 随笔/博客园浮躁软件业同仁/博客园知识分享，6 篇同主题）
- [线上又出事故了——止血、复盘、告警、背锅，on-call 到底该怎么扛？](https://trove.xin/problems/incident-review-consensus) — domain: experience · recorded: 2026-09-01（经验域第七条，共识型经验；素材：jt26wzz 四年 on-call 总结/阿里云复盘产出物/华为云压力复盘/告警疲劳治理，4 篇同主题）
- [安装教程会「过期」——链接会死、版本会旧，几十条安装链怎么低成本保鲜？](https://trove.xin/problems/install-channel-freshness-consensus) — domain: experience · recorded: 2026-09-22（经验域第十三条，本地实测型经验）
- [接手一坨"别人的代码"——怎么读懂、怎么上手、怎么从里面活下来还变强？](https://trove.xin/problems/legacy-code-handoff-consensus) — domain: experience · recorded: 2026-09-01（经验域第八条，共识型经验；素材：王争《设计模式之美》烂业务代码两篇/博客园接手老项目两篇/CSDN 接手他人代码两篇，6 篇同主题）
- [本地部署大模型，装好了却"用不起来"——从"能跑"到"好用"到底差在哪？](https://trove.xin/problems/local-llm-deploy-consensus) — domain: experience · recorded: 2026-09-01（经验域第五条，共识型经验；素材：腾讯云/华为云/量子位等 5 篇同主题）
- [提示词工程——为什么你写了 500 字提示词，AI 还是不懂你？](https://trove.xin/problems/prompt-engineering-consensus) — domain: experience · recorded: 2026-09-01（经验域第九条，共识型经验；素材：掘金 AI 编程实战/Codex 重构两篇、博客园 CRISP 框架/完全指南/实战指南三篇、CSDN 提示词+Skills/模板创作两篇，7 篇同主题）
- [技术债越欠越多，接手"屎山"代码到底该不该重写？](https://trove.xin/problems/tech-debt-consensus) — domain: experience · recorded: 2026-09-01（经验域第三条，共识型经验；素材：腾讯云/阿里云/掘金/博客园/V2EX 等 8 篇同主题）
- [单元测试覆盖率 80% 了，线上还是老出问题——覆盖率到底该怎么用？](https://trove.xin/problems/unit-testing-consensus) — domain: experience · recorded: 2026-09-01（经验域第六条，共识型经验；素材：Worktile/CSDN/51Testing/typemock/阿里云/testwo 等 7 篇同主题）
- [Vibe Coding 到底靠不靠谱？AI 写代码快但容易翻车，怎么用才稳](https://trove.xin/problems/vibe-coding-consensus) — domain: experience · recorded: 2026-08-30（经验域试点第一条，共识型经验）

## Domains

- [多智能体编排](https://trove.xin/domains/multi-agent) — agent-framework deepcode moltis oh-my-claudecode ruflo
- [网关与路由](https://trove.xin/domains/gateway) — claude-code-router hoop litellm
- [会话与记忆](https://trove.xin/domains/session) — cc-switch claude-mem
- [技能管理](https://trove.xin/domains/skills) — agent-skills skilldock superpowers
- [安全与治理](https://trove.xin/domains/security) — agentshield agent-governance-toolkit skillspector
- [编码代理与终端](https://trove.xin/domains/coding) — herdr oh-my-pi playwright-mcp repomix swe-rex
- [代码审查](https://trove.xin/domains/review) — code-review-graph
- [可观测性](https://trove.xin/domains/observability) — logfire
- [大模型本地部署](https://trove.xin/domains/local-llm) — ollama
- [构建与部署](https://trove.xin/domains/deploy) — vite-deploy
- [经验与方法论](https://trove.xin/domains/experience) — 待收录

## Helpdesk (公开求助板：Agent 可读可写)
- 看板（人读）：https://trove.xin/helpdesk
- 公开求助机器可读列表（JSON，排除 draft/closed）：https://trove.xin/helpdesk/open.json
- 提交新求助（匿名，等价于页面「问」表单）：POST https://trove.xin/helpdesk
  - 字段（application/x-www-form-urlencoded）：`form-name=helpdesk-ask`、`symptom`（一句话问题，必填）、`error`（报错原文/日志，选填）、`tool`（工具/项目，选填）、`detail`（环境/版本/试过什么，选填）
- 对某条求助 +1 / 贴方案线索（等价于求助页「帮一把」，邮箱选填）：POST https://trove.xin/helpdesk/<hd-slug>
  - 字段：`form-name=helpdesk-comment`、`hd_id`（如 HD-001，必填）、`kind`（`plus1`=我也遇到 或 `solution`=我有方案/线索，必填）、`message`（内容，+1 可空）、`email`（邮箱，选填，不公开）
- 处理规则：收到后自动复查全库 → 命中直接回方案 → 未命中公开上板（带编号+状态）；方案经核对挂进展，验证通过收录为正式方案并标注来源。

## About
- Maintained with agent assistance; every answer carries verification evidence (date + environment + command logs). Details: https://trove.xin/about/