核心用法
SchoolFit 专为香港家庭设计，涵盖中学（441 所）、小学（507 所）、幼儿园（955 所）、国际学校（103 所）及专上教育（37 所）五大数据库。用户通过 https://schoolfit.hk/skill-code 获取授权码后，可调用多层级指令完成升学规划：
| 场景 | 推荐指令 |
|:---|:---|
| 首次使用 | `quick-start` |
| 解析复杂需求 | `parse-parent-request` |
| 综合择校建议 | `advisor-search`（默认）|
| 学校名单搜索 | `search-schools` |
| 模糊校名识别 | `resolve-school` |
| 分级短名单 | `shortlist-builder` |
| 2-4 校深度对比 | `deep-compare` |
| 单校决策评估 | `decision-brief` |
| 学额实时信号 | `vacancies` |
| 招生公告追踪 | `admissions` |
指令执行需通过 python3 scripts/schoolfit_api.py 调用，强制指定 --skill-code 与 --format markdown。
显著优点
数据覆盖全面：覆盖香港超 2,000 间教育机构，含官立、资助、直资及国际学校全谱系。
隐私设计严谨：明确禁止索取学生姓名、HKID、电话、地址、成绩表等敏感信息；授权码仅限当前会话使用，不写入日志或持久存储。
决策导向输出：非简单罗列数据，而是输出「首選 / 穩陣 / 備選 / 暫不建議」分级建议，附带录取风险与下一步行动指引。
时效性信号：提供学额空缺（vacancy）与招生公告（admissions）的时间戳与置信度标注，优于静态数据库查询。
多语言适配：支持繁体中文、简体中文及英文回应，匹配家长用语习惯。
潜在缺点与局限性
地域锁定：仅限香港学校查询，无法处理内地或海外升学需求。
数据非官方性：「Band 参考」明确标注为非官方数据；学额与招生信号为「线索」而非录取保证，需用户向学校二次核实。
授权码门槛：首次使用需外站获取 sfhk_... 授权码，流程增加一步摩擦。
网络依赖：所有查询强制经由 schoolfit.hk/api，离线不可用；API 故障时无本地缓存兜底。
功能边界：只读型工具，无法代填申请表、预约面试或直连学校系统。
适合人群
- 目标用户：香港 K12 学生家长（尤其跨区择校、Band 升/降级、国际/本地路线摇摆者）
- 高频场景：小升中派位策略、插班学额追踪、直资 vs 资助权衡、国际学校筛选
- 不适用：无香港升学需求者、期望一键完成申请自动化者
常规风险
| 风险类别 | 具体表现 | 缓释措施 |
|:---|:---|:---|
| **数据时效风险** | 学额/招生数据存在抓取延迟 | 每条数据附「last-seen」时间戳，建议用户电话确认 |
| **隐私误操作** | 用户可能粘贴含个人信息的查询文本 | 执行 API 前强制披露并提示删除敏感信息；`parse-parent-request` 支持本地预解析 |
| **授权码泄露** | 用户可能截图或转发授权码 | 仅接受一对一聊天粘贴，禁止写入日志或示例 |
| **过度依赖风险** | Band 参考被误读为官方排名 | 所有输出强制标注「非官方 Band 参考」|
| **API 服务中断** | 单点依赖 SchoolFit 服务端 | 用户需保留官方学校联系方式作为 Plan B |
安全等级 S：网络隔离严格（仅 schoolfit.hk），无本地文件/环境变量访问，授权码生命周期可控。