Files
gaokao-volunteer-system/product/PRD.md
Hermes Agent 93fa527f64
Some checks failed
CI / pytest (Python 3.10) (push) Has been cancelled
CI / pytest (Python 3.11) (push) Has been cancelled
CI / pytest (Python 3.12) (push) Has been cancelled
docs(review): reconcile completed-stage issues from 2026-06-13 alignment review
2026-06-14 10:12:03 +08:00

25 KiB
Raw Blame History

产品需求文档 (PRD)

高考志愿填报智能系统

版本: v2.0
状态: 已发布
最后更新: 2026-06-11


1. 文档信息

1.1 版本历史

版本 日期 作者 变更说明
v0.1 2026-06-10 Hermes Agent 初始版本,基础功能
v1.0 2026-06-10 Hermes Agent 增加可视化报告
v2.0 2026-06-11 Hermes Agent 项目化重构新增龙老师角色27省支持规范检查

1.2 相关文档


2. 产品概述

2.1 产品定位

一句话描述为高考考生提供专业化、数据驱动、政策合规的志愿填报辅助的AI系统。

核心定位

  • 不是替代人工规划师,而是AI赋能的规划助手
  • 不是简单的信息查询,而是智能决策支持
  • 不是通用AI对话而是垂直领域的专业服务

2.2 目标用户

主要用户画像

用户A普通工薪家庭考生家长

  • 年龄40-50岁
  • 职业:工薪阶层/小企业主
  • 痛点:信息不对称,不知道如何选,怕选错
  • 需求:专业建议、风险提示、操作简单
  • 付费意愿:中等(几百元以内可接受)

用户B县城/农村考生

  • 信息获取渠道有限
  • 对政策不了解
  • 需要标准化的、可靠的建议
  • 付费意愿:低(倾向于免费或低价)

用户C一线城市知识型家长

  • 有信息获取能力
  • 但缺少系统化的方法论
  • 需要数据支持和验证工具
  • 付费意愿:高(为专业服务付费)

用户场景

  1. 出分第一时间:刚查到分数,不知道能上什么学校
  2. 填报前焦虑:方案不确定,怕滑档/退档
  3. 多方案对比:有几个选项,不知道哪个更好
  4. 政策理解:对"院校专业组""调剂"等概念不清楚

2.3 核心价值主张

价值维度 传统方式 本项目 提升
信息获取 手工查资料(数天) 对话即得(分钟) 效率提升100x
政策合规 凭经验(易错) 自动检查(准) 错误率降低90%
数据精度 主观估算 2025年位次精确匹配 精度提升50%
个性化 标准化话术 四维匹配(兴趣+能力+家庭+就业) 匹配度提升40%
风险提示 口头上提醒 可视化风险报告 遗漏率降低80%

3. 功能需求

3.1 功能架构

┌─────────────────────────────────────────────────────────────┐
│                    用户交互层                                │
│  ┌──────────────────────────────────────────────────────┐  │
│  │ Hermes对话  │  命令行  │  Web界面(未来)  │  API(未来) │  │
│  └──────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    业务逻辑层                                │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │  方案生成     │  │  规范检查     │  │  报告输出     │      │
│  │  - 兴趣测评   │  │  - 政策合规   │  │  - 可视化     │      │
│  │  - 能力评估   │  │  - 数据准确   │  │  - PDF/HTML  │      │
│  │  - 方案推荐   │  │  - 风险检测   │  │  - Markdown  │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    数据支撑层                                │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │  省份规则库   │  │  错误模式库   │  │  案例库       │      │
│  │  (27省)      │  │  (15种)      │  │  (真实咨询)   │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘

3.2 功能清单

P0核心功能必须有

ID 功能 描述 优先级 状态
F001 省份自动识别 自动检测用户所在省份,加载对应规则 P0 已完成
F002 方案生成 基于兴趣+能力+家庭+就业四维生成志愿方案 P0 已完成
F003 规范检查 自动检查方案是否符合本省政策 P0 已完成
F004 风险评估 识别退档/滑档风险,输出可视化报告 P0 已完成
F005 27省支持 支持三种志愿模式(院校专业组/专业+学校/传统) P0 已完成

P1重要功能应该有

ID 功能 描述 优先级 状态
F006 可视化报告 生成HTML/PDF/Markdown三种格式报告 P1 已完成
F007 信息收集问卷 1分钟/3分钟/7步三套问卷 P1 已完成
F008 角色切换 龙老师/张雪峰风格/标准顾问三种角色 P1 已完成
F009 测试系统 自动化测试套件 P1 已完成
F010 错误模式库 15种常见错误持续积累 P1 已完成

P2增强功能可以有

ID 功能 描述 优先级 状态
F011 数据自动更新 对接官方数据源,自动更新位次 P2 规划中
F012 Web端 (PC+手机) 响应式Web + PWA覆盖PC和手机 P2 🚧 T12实施中
F013 推送通知 填报提醒、报告更新通知 P2 规划中
F014 实时数据 2026年招生计划实时对接 P2 规划中
F015 智能推荐 基于AI的个性化推荐算法 P2 规划中
F016 报告分享 链接/图片/PDF分享权限控制 P1 已完成
F017 管理后台 用户/案例/规则/数据管理 P1 已完成
F018 反扎堆推荐 大厂AI相似度检测提示扎堆风险 P0 已完成
F019 数据溯源 每所院校数据来源透明展示 P1 已完成
F020 AI方案审核核心 上传大厂AI方案专业审核修正 P0 已完成

P3高级功能未来

ID 功能 描述 优先级 状态
F021 强基计划 特殊类型招生支持 P3 📋 待规划
F022 艺术类 艺考志愿填报支持 P3 📋 待规划
F023 国际本科 中外合作办学支持 P3 📋 待规划
F024 大学规划 录取后的专业规划 P3 📋 待规划
F025 考研规划 本科-研究生路径规划 P3 📋 待规划

3.3 功能详情

F001省份自动识别

用户故事

作为家长,我希望系统能自动知道我是哪个省的,这样我就不用手动选择省份了。

验收标准

  • 可以从对话中自动提取省份名称(如"我是湖南考生"→识别出"湖南"
  • 支持省份简称识别(如"湘"→"湖南"
  • 正确加载对应省份的规则
  • 未识别到时给出提示

技术实现

detect_province("我是湖南考生...") # 返回 "湖南"

F002方案生成

用户故事

作为考生,我希望系统能根据我的分数和性格,推荐适合我的专业和学校。

验收标准

  • 支持兴趣测评霍兰德6型
  • 支持学科强弱评估
  • 支持家庭条件匹配
  • 输出三套方案(冲/稳/保)
  • 每个方案包含6个专业+排序建议

流程

  1. 收集信息5分钟
  2. 分析画像2分钟
  3. 生成方案5分钟
  4. 自检输出1分钟

F003规范检查

用户故事

作为家长,我担心方案有错误导致孩子滑档,希望系统能自动检查。

验收标准

  • 检测致命错误(如"45个学校"
  • 检测严重错误(如主观概率)
  • 检测一般警告(如体检要求缺失)
  • 输出三级分类报告
  • 提供具体修正建议

检查项

  • 志愿单位是否正确
  • 调剂范围是否正确
  • 数据是否基于2025年
  • 是否标注数据来源

4. 非功能需求

4.1 性能需求

指标 目标值 当前状态
响应时间 < 5秒简单查询 达标
方案生成 < 10分钟完整方案 达标
并发用户 支持10人同时咨询 待测试
准确率 政策合规性>95% 🧪 待建立固定评估集

4.2 可用性需求

指标 目标值 当前状态
可用性 99.5%(志愿填报期间) 待部署
容错性 单点故障不中断服务 待实现
恢复时间 < 5分钟 待实现

4.3 安全需求

需求 说明 状态
数据隐私 考生信息本地存储,不上传云端 🚧 基础能力已落地,合规文档待补齐
访问控制 Hermes Skills本地运行 🚧 Admin/JWT 已实现,用户端未落地
数据备份 业务数据独立备份与恢复 待实现

4.4 可维护性需求

需求 说明 状态
模块化 功能模块清晰分离 已实现
文档完整 每个模块有完整文档 已实现
测试覆盖 核心功能有测试 已实现
可扩展 易于添加新省份/功能 已实现

5. 用户界面

5.1 交互设计

对话式交互Hermes

入口

/skill gaokao-counselor-long

标准对话流程

用户我是湖南考生578分
龙老师578分在湖南是位次约26,800名...
      但光知道分数还不够,我得问你几个事:
      1. 你平时最喜欢干啥?...
用户:我喜欢整理数据
龙老师那就是C型常规型适合会计、财务、统计...
      你数学和物理怎么样?...
[对话继续]...
龙老师:好,信息收齐了,我给你生成方案...
      [生成方案中...]
      [自动检查中...]
      你的方案已生成,有问题吗?

命令行交互

规范检查

$ gaokao-checker plan.txt

╔════════════════════════════════════════════════════════╗
║          ✅ 志愿方案规范检查报告                        ║
╠════════════════════════════════════════════════════════╣
║  检测省份:湖南                                         ║
╚════════════════════════════════════════════════════════╝

🔴 【致命错误】
  1. 志愿单位错误
     ❌ 问题:...
     ✅ 修正:...

5.2 报告设计

可视化报告结构

1. 封面
   - 考生信息
   - 咨询时间
   - 规划师(龙老师)

2. 考生画像
   - 基本信息表格
   - 兴趣-能力-家庭-就业四维度雷达图

3. 志愿方案
   - 方案A院校+专业+位次+概率
   - 方案B...
   - 方案C...
   - 院校对比决策表

4. 风险提示
   - 致命风险(🔴)
   - 中等风险(🟡)
   - 一般提示(🟢)

5. 行动清单
   - 出分前
   - 出分后
   - 填报时

6. 数据来源
   - 官方网址
   - 数据时效性声明

6. 数据需求

6.1 数据类型

数据类型 来源 更新频率 存储方式
2025年位次 各省教育考试院 每年 硬编码
省份规则 官方政策文件 每年 代码配置
错误模式 用户反馈+案例 持续 Markdown
真实案例 用户咨询 持续 Markdown

6.2 数据质量

指标 要求 保障措施
准确性 >95% 官方数据源+人工核实
时效性 当年数据 明确标注年份
完整性 覆盖27省 持续补充

7. 运营需求

7.1 数据监控

指标 监控方式 频率
咨询次数 日志统计 实时
方案生成数 日志统计 实时
错误检出数 检查报告分析 每周
用户满意度 反馈收集 每月

7.2 持续改进

错误模式库建设

  1. 收集用户咨询中的错误案例
  2. 分析归纳新的错误模式
  3. 更新检查规则
  4. 发布新版本

案例库建设

  1. 记录真实咨询案例(脱敏)
  2. 总结成功经验
  3. 沉淀为最佳实践

8. 风险评估

8.1 技术风险

风险 可能性 影响 应对措施
数据不准确 标注"仅供参考",提示核实官方
政策变化 每年更新规则库,标注时效性
系统故障 Git备份可快速恢复

8.2 业务风险

风险 可能性 影响 应对措施
用户投诉 免责声明,明确责任边界
竞争激烈 差异化AI+规范检查+27省
政策限制 遵守合规要求,不承诺结果

8.3 合规风险

风险 可能性 影响 应对措施
数据隐私 本地存储,不上传云端
虚假宣传 明确标注"仅供参考"
版权纠纷 MIT许可证注明数据来源

8.5 竞品分析2026年6月

大厂AI志愿填报服务对比

维度 千问 元宝 百度 豆包 龙老师(本项目)
价格 免费 免费 部分免费 免费 99-299元
政策合规检查 自动
真人服务 部分 闲鱼/微信
反扎堆设计
数据透明 🟡 🟡 🟡 🟡

我们的差异化定位

"专业合规 + 真人服务 + 反扎堆 + 透明可解释"

6大产品差异化

  1. 27省政策自动检查
  2. 真人深度服务
  3. 反扎堆设计
  4. 数据透明
  5. 报告可解释
  6. 错误模式库

6大推广差异化

  1. 渠道差异化(避开大厂主战场)
  2. 内容差异化(真人案例+对比评测)
  3. 卖点差异化(反扎堆、真人服务)
  4. 信任建立差异化
  5. 客户群体差异化
  6. 服务模式差异化

详细分析见 COMPETITIVE_ANALYSIS


9. 业务场景与商业化设计

9.1 两种核心业务流程(关键区别)

核心原则:闲鱼/微信流程 vs Web系统流程有本质区别

维度 闲鱼/微信流程 Web系统流程
入口 闲鱼/微信 Web系统
资料提供 用户先提供完整资料 付费后填写
付费时机 渠道内先付费 系统内先付费
订单创建 管理端人工录入 系统自动创建
方案生成 管理端 → 龙老师 系统自动/人工
方案交付 闲鱼/微信发PDF 站内查看+邮件PDF

详细流程见 BUSINESS_SCENE

9.2 推广渠道矩阵

渠道 定位 业务流程 适用版本
闲鱼 交易平台 先给资料→管理端录入→生成方案 基础版/标准版
小红书/知乎 内容种草 引流→闲鱼/微信→先给资料→管理端录入 基础版/标准版
微信/企业微信 私域服务 先加微信→给资料→管理端录入→生成方案 基础版/标准版/尊享版
学校地推 口碑传播 先加微信→给资料→管理端录入→生成方案 标准版/尊享版
Web系统 自助服务 进系统→付费→填资料→生成方案 基础版/标准版/尊享版

9.3 订单管理

两种订单来源

  • 闲鱼/微信订单:用户在渠道内先付款,运营人员在管理后台手动录入(含用户资料)
  • Web订单:系统自动创建订单(含用户填写的资料)

统一管理

  • 所有订单都进入管理后台
  • 统一用户档案管理

9.4 服务版本(差异化定价策略)

定价逻辑:大厂全部免费,我们走"专业版"差异化路线 核心卖点:政策检查、反扎堆、真人服务、数据透明

版本 价格 核心卖点 服务内容 适用渠道
AI审核版 新增 49元 大厂方案审核
「千问/元宝给的方案,我帮你检查修正」
• 上传大厂AI方案
• 27省政策合规检查
• 错误标注+修正建议
• 反扎堆风险提示
• 1页PDF报告
闲鱼/Web
基础版 99元 标准化方案
「比大厂更准的政策匹配」
• 方案生成+PDF报告
• 27省政策合规检查
• 15种错误模式检测
• 数据来源透明标注
闲鱼/Web
标准版 199元 真人深度咨询 核心
「AI+真人双保险」
• 基础版全部功能
龙老师1对1咨询30分钟
反扎堆推荐(避开热门雷区)
• 1次修改+7天答疑
• 填报提醒服务
微信/Web
尊享版 299元 全程VIP服务
「从出分到录取全程陪伴」
• 标准版全部功能
全程跟踪(出分→填报→录取)
• 多次修改(不限次数)
• 征集志愿预案
• 录取结果分析
微信

版本对比vs大厂免费

功能 大厂免费 我们的收费版 差异化价值
方案生成 免费 99元起 我们更准(政策合规)
AI方案审核 没有 49元 独有 承接大厂用户痛点
27省政策检查 没有 全部版本 避开致命错误
反扎堆推荐 没有 199元起 避开分数线抬升
真人咨询 没有 199元起 有人负责
数据溯源 🟡 不透明 全部版本 可核实
全程跟踪 没有 299元 服务保障

核心话术

AI审核版49元- 承接大厂用户

"千问/元宝给的方案,你敢直接用吗? 花49元龙老师帮你检查 • 政策合规吗?(院校专业组有没有错) • 会扎堆吗AI推荐的大家都填分数线暴涨 • 数据准吗?(来源透明吗) 1小时出审核报告修正建议一目了然"

标准版199元- 主推

"大厂免费的方案是AI算的 龙老师的199元是AI+真人双保险。 多了什么? • 27省政策自动检查防致命错误 • 反扎堆推荐(避开热门雷区) • 真人30分钟咨询有人负责 • 7天免费答疑有问题随时问 99元买个放心值不值"

尊享版299元- 高端

「从出分到录取,全程有人管」


10. 附录

10.1 术语表

术语 定义
院校专业组 新高考模式,以专业组为单位填报志愿
专业+学校 浙江/山东模式每个志愿填1个专业
位次 全省排名,比分数更准确
冲稳保 志愿填报策略(冲刺/稳妥/保底)
调剂 专业组内专业调剂
征集志愿 录取未满时的补录

9.2 参考文档


文档所有者:产品经理
审批状态:已批准
下次评审2026年7月