b402ad2f33
新增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
185 lines
3.7 KiB
Markdown
185 lines
3.7 KiB
Markdown
# 版本发布说明
|
||
|
||
## 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](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 "首次正式发布"`
|