Files

Hermes Agent b402ad2f33 docs: 补充项目完整文档体系

新增8份核心文档，完善项目文档体系：

新增文档:
- INSTALL.md - 详细安装指南（含常见问题）
- CONTRIBUTING.md - 贡献指南（流程+规范+测试）
- FAQ.md - 30个常见问题解答
- LICENSE.md - MIT许可证+中文免责条款
- docs/API.md - API接口文档（规范检查器API）
- docs/AUTHORS.md - 作者与贡献者
- docs/RELEASE.md - 版本发布说明(v2.0)
- docs/NAVIGATION.md - 文档导航索引

文档体系现已完整:
- 项目入门：README + INSTALL + TUTORIAL
- 规则参考：provinces + ERRORS
- 开发指南：DEVELOPMENT + ARCHITECTURE + API
- 用户支持：FAQ + NAVIGATION
- 项目管理：CHANGELOG + CONTRIBUTING + LICENSE
- 版本信息：RELEASE + AUTHORS

总计23+份文档，约145KB

2026-06-11 20:03:25 +08:00

3.7 KiB

Raw Blame History

版本发布说明

v2.0 (2026-06-11)

🎉 新功能

新增角色：龙老师

✨ 全新的 gaokao-counselor-long Skill
✨ 定位为"张雪峰思路 + AI技术"融合体
✨ 标准化咨询流程
✨ 自动规范检查集成

多省份支持

✨ 支持27个省份自动识别
✨ 区分三种模式：院校专业组 / 专业+学校 / 传统
✨ 自动匹配合规规则

自动化测试

✨ 完整的测试套件
✨ 6个测试用例全通过
✨ 覆盖省份简称识别、方案检查

项目化

✨ 完整项目目录结构
✨ Git版本控制
✨ 完整文档体系

🔧 改进

数据精度

基于2025年实际录取位次
明确标注数据来源
2026年待官方公布提示

规范检查

致命/严重/警告三级分类
15种错误模式库
自动检测和修正建议

可视化报告

HTML / PDF / Markdown三格式
雷达图、热力图、对比表
风险检测红绿灯

🐛 已修复

致命错误

❌ "45个学校" → ✅ "45个院校专业组"
❌ "退到下个志愿" → ✅ "进入征集志愿"
❌ "全校调剂" → ✅ "组内专业调剂"

严重错误

❌ 主观概率 → ✅ 位次参考
❌ 选科一刀切 → ✅ 逐校核实
❌ 数据年份混乱 → ✅ 明确2025年

📚 新增文档

✅ README.md - 项目总览
✅ CHANGELOG.md - 变更日志
✅ INSTALL.md - 安装指南
✅ CONTRIBUTING.md - 贡献指南
✅ FAQ.md - 常见问题
✅ LICENSE.md - 许可证
✅ docs/API.md - API参考
✅ docs/TUTORIAL.md - 使用教程
✅ docs/DEVELOPMENT.md - 开发指南
✅ docs/ARCHITECTURE.md - 架构设计
✅ docs/case-studies/ - 真实案例
✅ docs/optimization-log/ - 优化日志
✅ tests/test_all.py - 自动化测试

⚠️ 已知限制

27省中的部分数据可能需更新
2026年招生计划待官方公布
特殊类型（强基/艺术/体育）未完全覆盖
算法精度有待进一步提高

📊 统计

项目	数量
支持省份	27个
Skills	4个
当前脚本	5个
错误模式	15种
测试用例	6个
文档	15份
Git提交	3次

🎯 适用人群

2026届高考考生和家长
数据敏感型决策者
普通工薪家庭
Hermes用户

📞 使用方式

/skill gaokao-counselor-long
或
/skill gaokao-college-advisor

历史版本

v1.0 (2026-06-10 → 2026-06-11)

初始版本

gaokao-college-advisor Skill
可视化报告脚本
1分钟/3分钟/7步三套问卷

已知问题

政策理解停留在2024年水平
数据主观化严重
缺乏规范检查机制
不符合本省规范

触发改进

用户质疑："允许填报这么多吗？是否符合规范？" → 触发v2.0开发

版本对比

维度	v1.0	v2.0
省份支持	湖南	27省
检查机制	无	自动检查
角色数量	2	4
错误模式库	无	15种
数据精度	主观	位次精确
测试覆盖	无	完整
项目结构	散落	标准化
文档	简单	完整

下一步规划

详见 docs/optimization-log/future-plan.md

v2.1 (计划)

添加剩余省份（覆盖30+省）
完善每校选科要求数据
2026年实际位次匹配

v3.0 (计划)

数据自动化对接
真实录取概率算法
Web工具/桌面App
微信小程序

致谢

感谢每一位贡献者、测试者和用户的支持！

发布日期: 2026-06-11
版本号: v2.0
Git标签: (如有) git tag -a v2.0 -m "首次正式发布"

3.7 KiB Raw Blame History Unescape Escape