| layout | default |
|---|---|
| title | Troubleshooting Hub 故障排查 |
| parent | Developer 开发者 |
| nav_order | 95 |
本节为英文摘要导读，便于国际协作与检索。
This document provides a centralized troubleshooting index for onboarding, workspace setup, contribution flow, and documentation quality checks.
doc_id: TROUBLESHOOTING
path: troubleshooting.md
lang_primary: zh-CN
lang_secondary: en
audience: [developer, contributor, user, operator]
agent_ready: true
source_of_truth: narrative-docs- 先匹配你当前所处阶段（启动/协作/提交/发布）。
- 找到对应症状并按“检查 -> 修复 -> 验证”顺序处理。
- 若问题仍存在，在 PR 或 issue 中附上执行日志和已尝试步骤。
- 检查：执行 developer/setup/README.md 的环境自检命令
- 修复：补装缺失运行时并重开终端
- 验证：四项命令均可输出版本
- 检查：是否存在多个版本管理器同时接管 PATH
- 修复：固定默认版本并刷新 shell 初始化
- 验证：
which node/python3/rustc与预期一致
- 检查：是否以 workspace 文件打开
- 修复：按 developer/workspace/README.md 重新打开多仓工作区
- 验证：跨仓搜索
RULE-01能返回多仓结果
- 检查：当前根目录是否为 NarrativeOS workspace
- 修复：从仓根重新打开并刷新文档
- 验证：README 导航可跳转到目标文档
- 检查：是否阅读 contributing.md
- 修复：按“单主题变更”选择一个目标页面
- 验证：变更可在 PR 模板中完整填写目标与验收
- 检查：是否提供了输入、步骤、验收、排障
- 修复：补齐可复现步骤与预期输出
- 验证：Reviewer 可在本地重走路径
- 检查：白皮书状态是否附有证据路径
- 修复：在映射表和检查清单中补齐证据链接
- 验证：每个“完成”条目均可追溯到权威文档
- 检查：是否满足“目标/步骤/验收/排障”最小结构
- 修复：按治理标准补齐缺失段落
- 验证：页面可支持新成员完成首个任务