Files
zyt/artifacts/medical-assistant-feature-plan/automatic-backend-implementation.md
T
2026-11-12 09:07:07 +08:00

5.9 KiB
Raw Blame History

自动分析调度后台实施报告

已完成

  • 新增 server/app/common/service/assistantservice/AssistantServiceAutomation.php,提供 status() 与 tick()。
  • 新增 assistant-service:auto --sleep=60,支持 --once;命令注册于现有 console 配置。调度命令只创建原持久队列任务,不调用模型或同步远程 IM。
  • 原 assistant-service:work 命令仅增加实际轮询前后及异常/退出的安全心跳,未改 Worker/Engine 的认领、租约、生成、来源重验或结果提交逻辑。
  • 配置默认保持 auto_enabled=false、auto_actor_id=0、间隔 60 秒、安静期 300 秒、每批最多 10 条,固定 30 天来源窗口。

来源、权限及重复保护

每轮重新读取显式配置账号,要求账号现存启用、具备 view/analyze 权限,且为 root 或现有管理角色 3/7/8。不会自动查找或借用 root。目标员工使用已有员工域、有效医助角色;目标无需有模块菜单。候选查询和 Context/Logic 入队均沿现有患者域复查。

候选仅来自可靠 IM 账号配对、目标本人登记、本人跟踪备注;不从当前患者负责人猜测历史发言人。IM 归档原有 diagnosis_id 不作为唯一可靠映射,使用可靠患者账号与 patient_id:同患者有多条有效诊单时,仅选择当前操作者可见的最大诊单 ID。人工登记、跟踪备注保留自身诊单绑定;人工记录同时核对 patient_id。纯 IM 分析还按患者检查已有目标快照,防止新建诊单导致同一段聊天重复生成。

安静期检查 Context 全部实际来源的发生时间,也检查手工记录 created_at、跟踪备注 create_time/update_time 与存在时的 IM create_time,因此补录旧日期、追加旧日备注不会立即触发。来源没有文字、删除、越权、资料超限会跳过,后续候选仍继续扫描。

queued/running/needs_reconciliation 会阻止同一目标重复排队;纯 IM 跨诊单也保护同一患者。自动调用 Logic::analyzeAutomatic(),传完整 diagnosis_id/assistant_id/days=30/scenario=followup;Logic 中既有事务权限、来源快照、同人额度锁与自动模式不重置失败的保护继续生效。现有任务来源完全相同或当前仅为旧来源子集时,不因窗口滚动、知识变化或权限哈希变化反复生成。确定终态后有新增或修订来源才允许新快照;未知结果不自动恢复。

持久公平扫描与运行状态

  • 统一使用项目级 server/runtime/assistant_service_automation/,CLI 与 adminapi 不依赖不同的应用 runtime 目录。
  • scan.lock 为真实 OS flock,每轮完整扫描期间持锁;多进程不会同时扫描。不是仅靠时间戳模拟互斥。
  • scan.json 保存三个来源渠道的 (source_id, diagnosis_id) 游标和下次轮换渠道。每轮候选读取总量有界,实际扫描最多 max(30, batch * 10) 条(默认 100),入队最多 10 条;三个渠道轮换,不会持续卡在第一批记录。
  • 游标走到末尾后下一轮重新开始,安静期/新权限/新来源仍会被重检。额度阻塞时保留尚未入队候选之前的游标,下一次允许时继续,不永久遗漏。
  • 对每个候选的活动/历史队列检查分别最多读取 101 条;历史过多而无法安全确认时保守跳过并公开定性“历史任务需人工核对”提示,不把未知历史当成可重发。
  • workers.json 在单独锁下记录最多 64 个实际消费者进程心跳。轮询已完成和正在处理分别使用有界 TTL,退出标记 stopped,异常标记 error。只有调度与消费者心跳均有效才显示 running;缺失/过期显示 waiting,配置/存储故障显示 error。
  • status() 不入队、不调用模型、不写文件;默认 disabled 会直接返回。返回严格为契约的 enabled/state/last_scan_at/next_scan_at/interval_seconds/quiet_seconds/days/reason,不公开账号、患者、来源原文或全域任务数量。超限/来源缺失/安静期等仅给定性原因;无新增来源明确表示继续等待。近期资料问题保留至重新核查或最多一小时,避免游标空页将未解决问题隐藏。

本方案明确面向单机部署,调度与消费进程应共用同一项目本地 runtime;不宣称具备多主机分布式锁能力。未新增数据库表。

验证

以下测试均用合成 SQLite :memory:、临时运行目录和现有真实 Access/Context/Logic/ORM;无应用 initialize、无 .env 读取、无业务库连接、无网络或真实模型调用:

php -d extension=php_pdo_sqlite.dll tests/AssistantServiceAutomationTest.php
ASSISTANT_SERVICE_AUTOMATION assertions=53 PASS sqlite=memory real_access_context_enqueue=1 multiprocess_flock=1 network=0

php -d extension=php_pdo_sqlite.dll tests/AssistantServiceWorkerTest.php
ASSISTANT_SERVICE_WORKER assertions=66 PASS sqlite=memory real_worker_orm=1 network=0

自动调度测试覆盖:默认关闭、禁止隐式 root、管理角色与 analyze 撤回、停用账号、模型未就绪、空来源、扫描/消费者真实心跳、真实第二进程持有 flock、可靠账号配对、历史医助与无菜单目标、历史跟踪备注、跨诊单 IM 去重、失败不重排、未知结果阻止新快照、新来源续排、来源子集不生成、补录和追加安静期、撤权/恢复、删除诊单、40 个候选跨页公平、重启游标复用、日上限后续扫、超限后继续其他候选及持续提示、IM 表缺失时手工来源可用、公开状态脱敏和损坏状态文件。

相关 PHP 文件 php -l 通过;已检查新增 console 行无 diff 空白问题。

本轮未执行

未读写 .env,未连接业务数据库,未调用真实模型,未启动/停止本地服务。未修改 Controller、Validate、Logic、Staff、Access、Context、Engine、Worker service 或前端。绑定本地主管、启用自动配置、重启消费进程加载心跳及真实环境验收由主代理集成阶段执行。