基于 ego lite 的跨平台、跨 AI 编程助手（Harness）规培轮转手册自动化辅助工具。覆盖口腔各科室，零基础医师也能在 1 分钟内极速上手。
我们开发这个项目的核心，绝非为了提倡或鼓励填写虚假临床数据，而是源于规培临床一线一个极为普遍却又普遍无奈的客观现实。
在部分专科的实际轮转过程中，受限于医院收治病种结构、患者分流机制及带教排班，规培大纲或考核系统上硬性规定的许多特定病种与疑难操作，学员在短短几个月的轮转期内往往根本没有机会见到，更遑论获得亲自动手操作的机会。
然而，教培系统对这些偶发病种设置了一刀切的刚性数量考核门槛——只要数字不达标，便无法顺利出科或参加结业考核。面对这种“培养大纲指标”与“临床客观收治”严重脱节的体制困局，规培医生为了正常完成学业，往往只能在疲惫的值班深夜对着电脑，逐项手动去捏造、编造符合要求的记录。
既然“系统规定必须填满，但实际中又客观见不到”，手动逐条去编同样也是无可奈何的形式主义，那为何不把青年医生宝贵的休息时间与临床学习精力解放出来，交由 AI 自动化工具来兜底填补那些“未曾见过的病种缺口”？
这就是本项目诞生的真正初衷：用技术手段帮助同学们解决体制脱节带来的填报困境，向形式主义苦力要回属于医生的精力与睡眠。
为明确各方权利义务并规避潜在法律与行政合规风险，所有使用者在使用本软件前，必须仔细阅读并无保留接受以下免责声明：
- 技术中立与学术性质：本软件仅作为个人针对现代 Web 浏览器自动化（Ego-Browser）、跨 Harness 智能体编排的技术验证、学术交流与开源工具，不构成任何商业服务或教学违规指引。
- 本地运行与零监控：本软件为完全运行在使用者本地设备上的单机开源脚本，开发者与开源贡献者不提供任何云端代理服务，无法、无权也从未监控或干预任何使用者在本地的具体运行行为。
- 责任自负与作者脱钩原则：
- 本工具仅作为通用的表单辅助填写技术框架，对填报数据的真实性、合法性与合规性不做任何承诺或背书；
- 规培医生在自身电脑上运行本工具时，究竟将其用于何种科室、录入何种病种（无论是客观未见病种的兜底补录，还是用于日常常规项目填写），完全属于使用者个人的独立自主民事行为，概与本项目作者及开源贡献者无关；
- 使用者须对其账号下所有数据的填报行为、提交结果、审核流程及教学诚信负全部法律、行政与职业道德责任。
- 免除连带责任：作者不对任何使用者因安装、运行、配置本软件或提交相关数据而直接、间接导致的任何教学处分、通报批评、证书影响、行政追责或民事纠纷承担任何形式的法律责任。下载、克隆或运行本项目代码，即视为自愿、无条件接受本声明的所有约束。
gspb-AI 是一款专为住院医师规范化培训学员打造的手册自动补录工具。它能够自动连接并驱动真实浏览器，全量扫描轮转手册中的病种与手术操作缺口，生成完整对账表交由你审阅，并在你确认放行后全自动完成录入。
- 从数小时手工复制粘贴缩短至 2 分钟：全自动逐行填表与提交；
- 智能时间窗保护：自动过滤尚未开始轮转的未来科室，锁定当前在转科室，绝不越界提前填报；
- 每条数据必经你审阅：填什么、何时填、填谁的名字，全表一目了然；
- 智能名称清洗：自动剔除主表中的科室与定额尾缀（如
牙体缺损（25）（口腔修复科）自动提纯为牙体缺损），同时完整保护临床分类细节。
- 操作系统：macOS（Apple Silicon 与 Intel 均支持）。
📌 关于 Windows：目前暂不支持 Windows，原因是底层浏览器驱动
ego lite官方即将发布 Windows 版，届时本项目将第一时间跟进适配更新，敬请期待！ - 浏览器驱动：无需手动下载配置！（一键安装脚本若检测到未安装，会自动从官方高速 CDN 静默下载并部署，无需医生手动折腾）。
- 环境依赖：无需手动安装 Node.js 或 Python！（工具完全内嵌运行在 ego 运行时底座中，零环境依赖，开箱即用）。
无论你是刚刚打开 WorkBuddy、Claude Code 还是系统终端，只需两步：
在终端（或 WorkBuddy 内置终端）中粘贴这一行并回车：
国内网络强烈推荐（腾讯云 CNB 极速源，无需翻墙，医院内网秒级下载安装）：
git clone https://cnb.cool/tensor-core/gspb-AI.git ~/Projects/gspb-AI && ~/Projects/gspb-AI/install.sh(海外备用 GitHub 源：git clone https://github.com/yaping-pro/gspb-AI.git ~/Projects/gspb-AI && ~/Projects/gspb-AI/install.sh)
💡 懒人小妙招：在 WorkBuddy 对话框里，你甚至可以直接把上面这行命令发给 AI 助手，让 AI 在后台替你执行完成！
在你的 AI 编程助手（WorkBuddy、Claude Code、Cursor 等）对话框里直接发送一句话：
“帮我补录轮转手册”
接下来助手会全自动处理：
- 智能时间窗识别：自动比对手册列表中所有科室的轮转时间：
- 自动排除尚未开始轮转的未来科室（绝不提前乱填违规数据）；
- 自动选定当前正在轮转的科室；若发现之前已出科但手册仍待提交的历史科室，会一并友好提醒；
- 安全引导登录：引导你在弹出的浏览器窗口中登录医院系统（保护账号密码安全）；
- 出具预审对账表：扫描当前科室缺口，在对话中打印完整的配额统计与明细表；
- 门禁放行写入：你审阅回复
yes放行后，助手开始全自动安全写入并实时播报进度。
在得到你的明确许可之前，本工具绝不会向系统写入任何一条数据。 执行流程遵循双阶段强隔离：
- 计划阶段（只读）：扫描缺口，生成
plan.json与plan.csv，并在对话中完整打印待填数据明细； - 确认门禁：AI 助手停下等待你的确认。只有当你明确回复
yes/确认时，才会启动写入阶段；如果你想调整，可随时中止。
- 系统入口：
https://kygl.pkuszh.com.cn/_jp/ - 安全与防护说明：由于医院教培系统具备防自动化安全防护（WAF），AI 工具绝不会要求你提供账号密码，也无法代填登录表单。
- 如何登录：首次运行时，浏览器会自动停留在登录页，请你在浏览器窗口内手动输入「用户名」+「密码」+「验证码」并点击登录；如果你没有或忘记了密码，可以直接点击页面上的「手机号登录」，使用短信验证码快捷登录。登录成功进入系统后，回到对话告诉 AI「已登录」即可。
- 绝不越权：程序全程仅通过点击
手动录入、提交、退出完成表单填写，严禁且绝不触碰撤回、提交审批、删除等任何可能破坏既有数据的按钮。 - 临床合规底线：绝不提前填报未来尚未轮转的科室，保障教学培训数据真实合规。
- 本地留痕：所有的执行计划与填报断点记录均保存在本地目录
~/.cache/gspb-AI/<工号>/<记录id>/下，绝不上传任何外部服务器。 - 脱敏合规模型：住院号与患者姓名基于统计聚合号段模型加权生成，不发布也不包含任何真实患者样本号码；支持通过
~/.config/gspb-AI/blacklist.csv注入个人防碰撞黑名单。
A: 请检查浏览器窗口是否已成功登录并停留在教培系统首页。确认可以看到右上角显示的本人姓名与工号（如 张三【G1234】），然后重新对 AI 说「我已登录，继续」。
A: 系统会智能提醒你存在哪些已出科待补录科室。只需指明科室名字对 AI 说即可，例如：
“帮我补录儿牙” 或 “帮我补录牙体牙髓科”
A: 这是为了保护你的规培数据合规。系统检测到该科室的轮转起始时间晚于今天，按照医院要求不得提前代填未来科室数据。
A: 本工具仅允许对「待提交」状态的手册进行补录。如果手册已被撤回、已提交审批或已出科归档，系统将自动拒绝写入以保护数据一致性。
A: 直接对 AI 说「继续补录」，程序具备断点续填能力，会自动跳过已标记完成（completed: true）的项，继续补齐剩余缺口。
本项目基于 MIT License 开源。