解决方案库(15 条,均有落地物与验证)

UI_VERSION_BADGE |2026-10-27 10:14 |问题→根因→解法→落地物→验证证据 | /api/data/tasks | /api/zt/feature/verify | /api/zt/ui/version | /api/zt/eval/score | /app/m/data/platform-status.json
怎么用
①遇到同类问题先查本表,按「落地物」直接调用脚本/页面 ②新增解法写进本表并同步规范页 ③每条必须有验证证据,没证据不算解法
全部解法
编号问题根因解法落地物验证
SOL-01多进程同时发布,同一目标页被互相覆盖计划任务每分钟起新进程,旧进程不退出,共用预览槽①单实例锁(第二实例启动即退)②全局预览锁(上传→验证→发布串行)③同目标发布锁deliver-watch.py(SINGLE_INSTANCE_V1 / PREVIEW_SLOT_LOCK_V1 / PUBLISH_LOCK_V1)实测第二实例输出 [single-instance] 并退出;17 个并发进程清零;发布恢复正常
SOL-02发布成功了但线上内容不对(md5 不一致)只广播不校验,失败也不重投发布后比对本地/线上 md5,写 publish-md5 台账;不一致下轮重发deliver-watch.py(PUBLISH_MD5_LEDGER_V1)首页发布 md5 d183347d2d 本地=线上
SOL-03设计预览目录里放的是别的页的稿(目录↔内容不符)早前并发串页把内容互相覆盖逐目录核对 TARGET 是否等于自身路径;不符的换为「暂无有效设计稿」占位页,旧内容备份 .stale-*preview-honest.py;台账 gov/preview-audit.jsonl71 个目录:6 个内容匹配保留、55 个置占位;抽查 4/4 匹配
SOL-04设计稿把正式页覆盖了给设计稿写了正式页的 TARGET设计稿护栏:TARGET 不是 /app/design-preview/<页>/ 一律拒绝发布deliver-watch.py(DESIGN_DRAFT_GUARD_V1)已恢复 16 页;此后设计稿只进 design-preview
SOL-05QA 判 FAIL 没人接,问题停在那结论只在群里,责任人看不到,也没人派返工裁决机制:QA FAIL 自动抄送 DP + 入裁决队列(2 分钟)→ DP 裁决成立即建返工单并 @责任人adjudicate.py、/app/judge/、gov/adjudication.jsonl实跑:3 条入队、1 条自动派单(T-REWORK-055711)
SOL-06报修有人提,但没人负责、修好也没人知道缺编号、缺时限、缺回执报修收口:INC 编号 + 自动分诊 + SLA(P0 5/P1 10/P2 30 分钟)+ 超时升级 + 修复广播 + 报告人复验关闭incidents.py、incidents-fix.py、/app/incidents/10 条报修:9 条闭环、误收 8 条已排除(不收自己人公告)
SOL-07Agent 之间说话要经 DP 中转,我一忙就断没有点对点通道,全靠人工转述直连投递:群里 @谁,那句话自动进谁的收件箱(直呼-*.md),每 2 分钟一趟agent-direct.py、DP-Agent直连投递-每2分钟实测投通 72 条;五个收件箱各 1 条
SOL-08成品建好了却没交付(放错目录)Agent 在 .tmp 构建目录里干完就停,不复制到交付目录交付兜底搬运:每 2 分钟扫 .tmp 各构建目录,见 TARGET 标记就复制到对应岗位交付目录并群内提示delivery-sweep.py、DP-交付兜底搬运-每2分钟首跑搬运 4 件(含 Trae 的 70KB 首页与三个资源)
SOL-09群里自动回执把需求队列淹了(31 条里 30 条是回声)回执/播报被当成需求入队队列去噪:回声类自动收口(【回执】【完工】【交接】/值班总管 发送),只留真需求queue-echo-filter.py、DP-队列去噪-每2分钟31 → 4 → 0;手工收口 8 条已办结议题
SOL-10首页 405KB 太大,加载慢样式/脚本全内联资产外置:CSS/JS 放 /app/assets/,HTML 只留结构;旧大版本移出交付目录防回写/app/assets/(home.css/home-app.js/dp-bridge.js)、_hold-正式版不覆盖405KB → 70.6KB(-83%),md5 d183347d2d,verify PASS
SOL-11平台被误判停摆(其实只是没活)只看流水线日志时间,不看是否有待处理交付空闲判定:只有「有待处理交付且长时间无记录」才判 stalledplatform-status.py(STALL_HEURISTIC_V1)状态从 stalled 修正为 ok(空闲)
SOL-12华为云磁盘告警 81%临时文件/系统日志/未使用镜像堆积安全清理:/tmp 两天前文件、journal 压到 100M、docker 未用镜像 pruneserver-cleanup.sh81% → 68%,释放 5G+(日志 364M、镜像 980M)
SOL-13自动生成的页面反复掉门禁临时补丁写在产物里,下次重生成即被覆盖把接口引用/版本徽标写进生成器模板,而不是补产物platform-status.py / adjudicate.py / incidents.py / auto-health.py / done-broadcast.py(GEN_API_REF_V1)status/judge/incidents/autohealth/done 全部稳定 PASS
SOL-14催办催到已完成/已派活的人,打扰又无效只看时间不看状态催办三条件:有在办任务 + 10 分钟无回执 + 无新产出,三条同时成立才催nudge-check.py近 6 小时误催 0 次
SOL-16派单派了但对方看不到(静默失败)投递器某次运行失败不报错;投递间隔 5 分钟过长建卡即投 + 投递改每 1 分钟 + 每 3 分钟投递自检(缺件补投并报警)dispatch-now.py、DP-任务投递-每1分钟、DP-投递自检-每3分钟在办 17 张卡收件箱齐全;缺件会群内报警并附单号
SOL-15简单单页活没人干,卡在人不在线Agent 客户端要人开窗/点继续;平台无法主动调用API 执行体:本地模型(qwen2.5:7b/14b/qwq32b)直接生成单页→preflight→发布;零云端 tokenapi-executor.py、api-executor-loop.py、/app/executor-demo/ /app/executor-demo2/试点 2 页:preflight PASS、verify PASS、md5 一致;7B 17 秒/页,14B 189 秒,32B 498 秒
核心业务页(线上)
104 个
口径以服务器真实目录为准 /app/pages/
在办任务
15 条
已交付累计 93 条 /app/tasks
未闭环报修
2 条
每条有 INC 编号与 SLA /app/incidents/
最近一次发布
10:13 → /app/home/
发布后核 md5,防错版 /app/status/
评测通过率
100.0%
80 条用例回归 /app/score/
计划任务异常数
0
非就绪状态计数 /app/autohealth/
接口真源(P3)
/api/data/tasks | /api/zt/feature/verify | /api/zt/eval/score | /api/zt/params/center | /api/zt/memory/brief | /api/db/messages
相关
下钻:这套解法解决的根本问题
以前:并发覆盖、无编号、无时限、无回执、靠人转述、成品放错地方就丢。
现在:每类问题都有脚本兜底 + 有证据 + 可从页面查到;人的角色从"传话和救火"变成"定方向和拍板"。
首页交流区需求总表需求确认页面清单文档中心接口文档
实时数据读取中… 源 /api/zt/pages/list