# 限制项
## 并发
同一输出目录**并发运行不被支持**（状态/快照/缓存无锁，最后写入者胜；CI/编辑器集成请串行调用）。v36 起有单实例运行锁（`.state/run.lock`）：并发启动的后到者显式报错（含锁路径与人工删除指引），不再静默互相踩写。
## 语言与成本
- 每种语言都独立生成会线性放大 LLM 成本——当前只输出主语言（`wiki.language`，默认 `zh`）。
- **语言覆盖**：tree-sitter 解析支持 Rust/TypeScript/TSX/Python/Go/JS/JSX/MJS/CJS/C#/Java 11 种；**无 Ruby/PHP 解析器**（rails 等 Ruby 仓库只能解析其 JS/TS 资产；纯非支持语言仓库零源文件会显式报错「未找到任何源文件」——扫描是全量自动识别，无 include 白名单配置）。
## 大仓边界
- 单项目上限 **10 万个源文件**（超出显式报错）。
- 单次变更超过 **1 万行**自动回退全量生成。
- 实测（mock LLM，v30）：cal.com（5048 文件/5.9 万实体）全量约 6.2 分钟；图构建在万级实体仓库是主要耗时（v32 增量索引优化后 287s→20s）；真实 LLM 成本随仓库规模线性放大。
## 评测边界
`bench --judge` 是参考型口径（文档生成质量自评），判定受 LLM-as-judge 稳定性影响（judge 三态 + abstain + tie 升级阈值已缓解，flip 率已知项）；rubrics 全量打分仅作趋势参考，不承诺与人工评审一致。
## 语义搜索降级
embed Key 缺失或运行期失败时自动降级为纯文本搜索，`search`/`status` 显式提示「语义索引已降级」；降级状态持久化到 `semantic_degraded` 标记，下次成功生成自动清除。
## 已知问题（2026-08）
默认 LLM 端点 `https://opencode.ai/zen/go/v1` 当前不可用（网关生成端点 400/500）——见[配置参考的临时方案](config.md#已知问题)。
## 历史形态差异（v37 改名）
- 二进制/命令名：v37 起 `code-repo-wiki`（此前 `repo-wiki`），两者不共存。
- 产物目录：v37 起 `.code-repo-wiki/`（此前 `.repo-wiki/`），改名时不迁移，删除重生成。
- 用户级配置目录：v41 起 `~/.code-repo-wiki`（Windows `%USERPROFILE%\.code-repo-wiki`，自动迁移旧目录内容）；v37–v40 为 `%APPDATA%\code-repo-wiki\`（此前 `%APPDATA%\repo-wiki\`，改名时不迁移，删除重装并重新配置 key）。