8815f85ec4
- 27 省全部达到 usable 及以上（7 high + 20 usable + 0 skeleton） - high 白名单: 湖南/广东/江苏/山东/河北/浙江/福建 - 可信来源元数据补齐: 湖南/四川 province_official URL 修复 - 共享测试同步: test_provenance_query.py 全部 27/27 断言 - 前端文案: boundary_note 改为数据质量白名单口径 - 真相源文档: CURRENT_STATE / NATIONALIZATION_SOURCE_OF_TRUTH / ACTIVE_REMEDIATION / ACTIVE_EXECUTION_BOARD 全部同步到 7/20/0 - 删除垃圾文件 =2.0.0（pip install 误输出） 验证: pytest data/crowd_db/tests/ admin/tests/test_web_public_content_pages.py → 57 passed
225 lines
13 KiB
Markdown
225 lines
13 KiB
Markdown
# 文档导航
|
||
|
||
项目完整文档索引，便于快速查找。
|
||
|
||
---
|
||
|
||
## 📖 必读文档（按阅读顺序）
|
||
|
||
### 1. 新用户入门
|
||
|
||
1. [README.md](../README.md) - **项目总览，先看这个**
|
||
2. [INSTALL.md](../INSTALL.md) - 安装指南
|
||
3. [docs/TUTORIAL.md](TUTORIAL.md) - 使用教程
|
||
|
||
### 2. 开发者必读
|
||
|
||
1. [docs/DEVELOPMENT.md](DEVELOPMENT.md) - 开发指南
|
||
2. [docs/ARCHITECTURE.md](ARCHITECTURE.md) - 架构设计
|
||
3. [CONTRIBUTING.md](../CONTRIBUTING.md) - 贡献指南
|
||
|
||
### 3. 用户必读
|
||
|
||
1. [FAQ.md](../FAQ.md) - 常见问题
|
||
2. [LICENSE.md](../LICENSE.md) - 许可证/免责声明
|
||
|
||
---
|
||
|
||
## 📚 完整文档列表
|
||
|
||
### 🎯 项目文档（根目录）
|
||
|
||
| 文档 | 用途 | 优先级 |
|
||
| ------------------------------------- | ------------------ | ------ |
|
||
| [README.md](../README.md) | 项目总览、快速开始 | ⭐⭐⭐ |
|
||
| [CHANGELOG.md](../CHANGELOG.md) | 版本变更历史 | ⭐⭐ |
|
||
| [INSTALL.md](../INSTALL.md) | 安装指南 | ⭐⭐⭐ |
|
||
| [CONTRIBUTING.md](../CONTRIBUTING.md) | 贡献指南 | ⭐⭐ |
|
||
| [FAQ.md](../FAQ.md) | 常见问题解答 | ⭐⭐ |
|
||
| [LICENSE.md](../LICENSE.md) | 许可证与免责声明 | ⭐⭐ |
|
||
| [.gitignore](../.gitignore) | Git忽略规则 | ⭐ |
|
||
|
||
### 📘 核心文档（docs/）
|
||
|
||
| 文档 | 用途 |
|
||
| ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
|
||
| [TUTORIAL.md](TUTORIAL.md) | 使用教程、API参考 |
|
||
| [DEVELOPMENT.md](DEVELOPMENT.md) | 开发规范、贡献流程 |
|
||
| [ARCHITECTURE.md](ARCHITECTURE.md) | 系统架构、设计原则 |
|
||
| [API.md](API.md) | API接口文档 |
|
||
| [RELEASE.md](RELEASE.md) | 版本发布说明 |
|
||
| [AUTHORS.md](AUTHORS.md) | 作者与贡献者 |
|
||
| [NAVIGATION.md](NAVIGATION.md) | 文档导航索引 |
|
||
| [UX_DESIGN.md](UX_DESIGN.md) | 用户体验设计 |
|
||
| [SHARING_DESIGN.md](SHARING_DESIGN.md) | 分享功能设计 |
|
||
| [ADMIN_DESIGN.md](ADMIN_DESIGN.md) | 管理后台设计 |
|
||
| [BUSINESS_SCENE.md](BUSINESS_SCENE.md) | 业务场景与推广 |
|
||
| [COMPETITIVE_ANALYSIS.md](COMPETITIVE_ANALYSIS.md) | 竞品分析(大厂AI) |
|
||
| [TECH_ARCHITECTURE.md](TECH_ARCHITECTURE.md) | 技术架构设计 🆕 |
|
||
| [CURRENT_STATE.md](CURRENT_STATE.md) | 当前真相源 🆕 |
|
||
| [STRICT_SYSTEM_REVIEW_2026-06-24.md](../reports/STRICT_SYSTEM_REVIEW_2026-06-24.md) | 最新严格系统审查汇总版 🆕 |
|
||
| [ACTIVE_REMEDIATION_2026-06-13.md](ACTIVE_REMEDIATION_2026-06-13.md) | 当前仍有效问题清单 🆕 |
|
||
| [ACTIVE_EXECUTION_BOARD_2026-06-13.md](ACTIVE_EXECUTION_BOARD_2026-06-13.md) | 历史执行板（6/13快照） |
|
||
| [ACTIVE_EXECUTION_BOARD_2026-06-17.md](ACTIVE_EXECUTION_BOARD_2026-06-17.md) | 当前执行板（6/17口径） 🆕 |
|
||
| [UPGRADE_EXECUTION_BOARD_2026-06-22.md](UPGRADE_EXECUTION_BOARD_2026-06-22.md) | 升级优化执行板（P0/P1/P2） 🆕 |
|
||
| [REPORT_PROFILE_VERSION_RELATION_2026-06-22.md](REPORT_PROFILE_VERSION_RELATION_2026-06-22.md) | 报告/档案/复核版本关系 🆕 |
|
||
| [PAGE_REDESIGN_CHECKLIST_2026-06-21.md](PAGE_REDESIGN_CHECKLIST_2026-06-21.md) | 用户端页面重构验收清单 🆕 |
|
||
| [P0_P1_P2_REMEDIATION_PLAN_2026-06-14.md](P0_P1_P2_REMEDIATION_PLAN_2026-06-14.md) | 历史整改板（以 CURRENT_STATE 为准） |
|
||
| [PRODUCTION_DEPLOYMENT_CHECKLIST_2026-06-15.md](PRODUCTION_DEPLOYMENT_CHECKLIST_2026-06-15.md) | 线上部署与真实配置注入清单 🆕 |
|
||
| [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md) | v2.1实施计划 v1.0 |
|
||
| [IMPLEMENTATION_PLAN_v2.md](IMPLEMENTATION_PLAN_v2.md) | v2.1实施计划 v2.0（修订版）🆕 |
|
||
| [plans/2026-06-23-national-high-trust-crowd-db-plan.md](plans/2026-06-23-national-high-trust-crowd-db-plan.md) | crowd_db 全国高信任建设详细计划 🆕 |
|
||
| [plans/2026-06-24-crowd-db-national-high-trust-subagent-work-orders.md](plans/2026-06-24-crowd-db-national-high-trust-subagent-work-orders.md) | crowd_db 全国高信任子代理派工单 🆕 |
|
||
| [plans/](plans/) | 详细任务计划 🆕 |
|
||
|
||
### 🗃️ 历史归档（docs/archive/）
|
||
|
||
| 文档 | 用途 |
|
||
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
|
||
| [archive/README.md](archive/README.md) | 历史归档总索引 |
|
||
| [archive/2026-06-historical-snapshots/README.md](archive/2026-06-historical-snapshots/README.md) | 6 月历史快照索引 |
|
||
| [archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md](archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md) | 历史审核报告（6/11快照） |
|
||
| [archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md](archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md) | 历史修复任务板（6/11快照） |
|
||
| [archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md](archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md) | 历史完成报告（6/13口径） |
|
||
| [archive/2026-06-18-rules-cleanup/README.md](archive/2026-06-18-rules-cleanup/README.md) | 417 文件整理与规则清理记录 |
|
||
|
||
### 🔍 规则文档（rules/）
|
||
|
||
| 文档 | 用途 |
|
||
| --------------------------------------------------- | ---------------------------------- |
|
||
| [provinces/README.md](../rules/provinces/README.md) | 省份规则目录入口 |
|
||
| [provinces.md](../rules/provinces.md) | 省份规则索引与 truth/evidence 入口 |
|
||
| [errors/ERRORS.md](../rules/errors/ERRORS.md) | 错误模式库 |
|
||
|
||
### 📖 案例文档（docs/case-studies/）
|
||
|
||
| 文档 | 用途 |
|
||
| --------------------------------------- | ------------ |
|
||
| [TEMPLATE.md](case-studies/TEMPLATE.md) | 案例编写模板 |
|
||
| （未来添加更多案例） | ... |
|
||
|
||
### 📋 优化日志（docs/optimization-log/）
|
||
|
||
| 文档 | 用途 |
|
||
| ----------------------------------------------------------------------------------- | --------------------------------- |
|
||
| [LOG.md](optimization-log/LOG.md) | 优化过程记录 |
|
||
| [TEST_CLIENT_COVERAGE_2026-06-23.md](../reports/TEST_CLIENT_COVERAGE_2026-06-23.md) | 用户端真实 TestClient 覆盖现状 🆕 |
|
||
| [STRICT_SYSTEM_REVIEW_2026-06-24.md](../reports/STRICT_SYSTEM_REVIEW_2026-06-24.md) | 最新严格系统审查汇总版 🆕 |
|
||
| [future-plan.md](optimization-log/future-plan.md) | 未来规划 |
|
||
|
||
### 📄 Skill文档
|
||
|
||
| Skill | 文档位置 |
|
||
| -------------------------- | --------------------------------------------------------------- |
|
||
| **gaokao-college-advisor** | [skills/../SKILL.md](../skills/gaokao-college-advisor/SKILL.md) |
|
||
| **gaokao-spec-checker** | [skills/../SKILL.md](../skills/gaokao-spec-checker/SKILL.md) |
|
||
| **zhangxuefeng-skillset** | [skills/../SKILL.md](../skills/zhangxuefeng-skillset/SKILL.md) |
|
||
| **gaokao-counselor-long** | [skills/../SKILL.md](../skills/gaokao-counselor-long/SKILL.md) |
|
||
|
||
---
|
||
|
||
## 🎯 按场景查找
|
||
|
||
### 场景1：我想快速上手
|
||
|
||
→ [README.md](../README.md) → [INSTALL.md](../INSTALL.md) → [TUTORIAL.md](TUTORIAL.md)
|
||
|
||
### 场景2：我想了解全貌
|
||
|
||
→ [README.md](../README.md) → [ARCHITECTURE.md](ARCHITECTURE.md) → [CHANGELOG.md](../CHANGELOG.md)
|
||
|
||
### 场景3：我想贡献代码
|
||
|
||
→ [CONTRIBUTING.md](../CONTRIBUTING.md) → [DEVELOPMENT.md](DEVELOPMENT.md) → [FAQ.md](../FAQ.md)
|
||
|
||
### 场景4：我遇到问题
|
||
|
||
→ [FAQ.md](../FAQ.md) → [TUTORIAL.md](TUTORIAL.md) → 各Skill文档
|
||
|
||
### 场景5：我想了解规则
|
||
|
||
→ [rules/provinces.md](../rules/provinces.md) → `rules/_truth/province/*.yaml` / `rules/_evidence/` → [rules/errors/ERRORS.md](../rules/errors/ERRORS.md)
|
||
|
||
### 场景6：我想查看案例
|
||
|
||
→ [docs/case-studies/](case-studies/) → [tests/cases/](../tests/cases/)
|
||
|
||
---
|
||
|
||
## 📊 文档统计
|
||
|
||
| 类别 | 数量 | 总字数 |
|
||
| --------- | ------- | ---------- |
|
||
| 项目文档 | 7 | ~50KB |
|
||
| 核心文档 | 6 | ~40KB |
|
||
| 规则文档 | 3 | ~15KB |
|
||
| 案例文档 | 1+ | ~5KB |
|
||
| 优化日志 | 2 | ~5KB |
|
||
| Skill文档 | 4 | ~30KB |
|
||
| **总计** | **23+** | **~145KB** |
|
||
|
||
---
|
||
|
||
## 🔗 快速链接
|
||
|
||
### 开始使用
|
||
|
||
- [安装 →](../INSTALL.md)
|
||
- [教程 →](TUTORIAL.md)
|
||
|
||
### 开发贡献
|
||
|
||
- [贡献指南 →](../CONTRIBUTING.md)
|
||
- [API文档 →](API.md)
|
||
|
||
### 规则参考
|
||
|
||
- [省份规则 →](../rules/provinces.md)
|
||
- [错误模式 →](../rules/errors/ERRORS.md)
|
||
|
||
### 测试验证
|
||
|
||
- [测试目录 →](../tests/)
|
||
- [测试用例 →](../tests/cases/)
|
||
|
||
---
|
||
|
||
## 📝 文档更新
|
||
|
||
### 更新频率
|
||
|
||
- **重要文档**（README、TUTORIAL）：每次发布更新
|
||
- **技术文档**（API、ARCHITECTURE）：功能变更时更新
|
||
- **案例文档**：发现新案例时更新
|
||
- **优化日志**：每次优化时更新
|
||
|
||
### 更新记录
|
||
|
||
参见 [CHANGELOG.md](../CHANGELOG.md)
|
||
|
||
---
|
||
|
||
## 💡 文档建议
|
||
|
||
### 发现文档问题？
|
||
|
||
1. 查看现有文档是否已覆盖
|
||
2. 如未覆盖，请记录到 [docs/optimization-log/LOG.md](optimization-log/LOG.md)
|
||
3. 提交更新（见 [CONTRIBUTING.md](../CONTRIBUTING.md)）
|
||
|
||
### 想要补充文档？
|
||
|
||
1. 复制现有文档格式
|
||
2. 遵循命名规范
|
||
3. 更新本导航
|
||
4. 提交PR
|
||
|
||
---
|
||
|
||
**找不到？查看 [FAQ.md](../FAQ.md) 或直接询问。**
|
||
|
||
---
|
||
|
||
**版本**: v2.0
|
||
**最后更新**: 2026-06-11
|