这些都是**今天真实发生过并修过**的问题。上岗必须看:每一条都对应一次事故或一次返工。
数据来自 PG
数据来自 PG
rules.pitfalls,改这里就是改唯一真源;上岗包会自动带上重点条目。| 现象 | 根因 | 正确做法 |
|---|---|---|
| 交付没有结构,目录/命名各一套(179 个预览目录) | 没有契约,也没有人负责结构 | 架构契约(TARGET/TASK/ROLE 标签 + 目录规范)+ 门禁校验 |
| 任务没人接、催办没人回 | 岗位客户端不在跑;信号生成了没人拉 | 1 分钟拉活读三样;收件箱+群@我;无回执即升级 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 页面互相覆盖 / md5 对不上 / 标题串页 | 多进程同时发布、共用预览槽 | 单实例锁 + 全局预览锁 + 同目标发布锁 + 发布后 md5 校验 |
| 设计稿把正式页覆盖,标题变「XX·中台设计稿」 | 设计稿写了正式页 TARGET | 设计稿 TARGET 必须 /app/design-preview/;发布前校验 TARGET |
| 首页被旧版本反复回写(70KB→405KB) | 服务器遗留 cron 同步、交付目录留多个同 TARGET 大文件 | 删遗留 cron + 首页体积上限 150KB + 交付目录同 TARGET 只留一份 |
| 改了 JS/CSS 线上不生效 | 发布器只推 *.html,assets 推不上去 | assets 独立发布器(每 2 分钟):目标 /app/assets/,md5 校验,失败回滚 |
| 整站返回兜底页 6299B 却显示 200 | nginx 对未部署路径回落首页;只看状态码以为成功 | 验收看内容特征(TARGET/标题/关键词)+ verify,不只看 200 |
| 发布器被锁卡住,吞吐掉到 0 | 全局锁 TTL 过长/僵尸锁未释放;单轮处理过多 | 锁 TTL 90 秒 + 僵尸锁回收(每 5 分钟)+ 单轮上限 + 按 agent 轮转 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 有回执但状态不动 / 有 PASS 但没交付 | ack 不带 result;或只发 RUNNING 就当完成 | ack 必须 result+evidence;运行回执≠交付;交付认产物(prodVerify/md5/线上页) |
| 做完没人知道 | 只 ack 不汇报,或只汇报不 ack | 两样都要:交流区「已完成:<单号>|结果|证据」+ ack PASS |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 任务被脚本自动搬到别人名下(后端单跑到前端岗) | role-lock 按任务名关键词判归属;escalate-reassign 静置 45 分钟就改派 | 两个脚本已停用;只有老板或调度岗能改归属;脚本只催办不改派 |
| 改 owner 时被 403 拒绝 | 越权改派拦截生效:actor 不是 DP/角色锁/系统 | 用 actor=调度岗·ORCH(或原 DP)身份改;这是护栏在正常工作 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 调用 params/apply 后整站假死(进程在、端口不通) | HTTP 处理器里同步跑 schtasks,阻塞事件循环 | 接口只登记请求返回 202,后台任务执行;禁止在热路径跑外部进程 |
| chat-svc 僵尸态:端口 listening 但不响应 | 进程卡死;看护只测端口能连,误判正常 | 探活要 200+JSON;失败→红色告警+台账+一键修复(不自动杀进程) |
| PG 隧道断连但看护说正常 | 只看端口 socket,没真连库 | 改为真连库 SELECT 1;不通则重建隧道 |
| 服务进程莫名消失(无日志) | 疑似被 360 拦/外部清理误杀 | 扫描器白名单 + 服务看护告警;出现即上报老板 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 单子永远不逾期、催办永不升级 | deadline-20min 每 5 分钟把期限重算成 now+20min;P0 看板脚本每 2 分钟重建单 | 期限建卡时定,禁止脚本重算/顺延;到点只提示、逾期升级 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 岗位越界写别人目录/页面 | 没有路径权限校验 | 发布口按岗位矩阵校验;越界拒收+台账+待老板确认才放行 |
| 危险文件被改却没人发现 | 没有哈希监控 | 技术闸监控危险文件;变更需授权码;无码⇒告警+待确认 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 中文身份/页面显示乱码,回执认不出人(如 ??-???、鍗冮棶) | 客户端以 GBK 发中文,服务端按 UTF-8 解析,产生替换符 | 所有脚本/文件统一 UTF-8;服务端有 fixIdentity 反解;VBS 启动器只写 ASCII + slug 参数 |
| 改脚本时插入位置错,把 import 行拆坏,服务直接崩 | 按字符串锚点插入,没核对行上下文 | 改动前快照;插入后立刻 py_compile;出错立即回滚(risk-register --rollback) |
| VBS 启动器报「无效字符 800A0408」 | 中文参数被写成 \u 转义或非 ASCII | 启动器只写 ASCII,参数传 slug(qwen/trae/qa…),不要传中文 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 发言被 428 拒绝:记忆增强未达标 / 未出示令牌 | 没先调 /api/zt/memory/brief,或令牌过期(>10分钟) | 发言前先调 brief 取 memoryToken → 请求头带 x-memory-token;脚本用 gov/scripts/mem_token.py 自动取 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 改了岗位名后,门禁卡挂在旧实例名上,两个名字都过不了关 | 姓名/门禁卡/名册/岗位卡 四处不同步 | 改名必须同步四处;加身份一致性巡检(每 3 分钟),不一致即报 |
| 新身份发言被 428 拒绝 | 未过 C8 记忆门禁 + 未加载 agent brief | 先 GET /api/zt/memory/brief 再 GET /api/zt/agent/brief,再发言 |
| 脚本代签「已读」造成假证据 | Python 列完收件箱就写 .seen 当已读 | Python 只写 inbox.listed;已读只认模型 ack RUNNING(evidence 写已读文件名) |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 我发的消息别人看不到、别人发的我看不到 | 两个房间并存(交流区/总群),各看各的 | 只用一个交流区;总群取消;读写都归并到交流区 |
| 假体冒充岗位发言(「已写入…待本体处理」) | 客户端自动应答模板混进群 | 禁模板腔;只认实质结论+证据;假体消息清理守卫每 3 分钟跑 |
| 现象 | 根因 | 正确做法 |
|---|---|---|
| 配置散落在代码里,改一次要改代码、必出错 | 12 类配置硬编码 | 统一到参数中心(唯一真源),脚本读配置+默认值兜底 |
交接
发布
回执
归属
服务
期限
下钻:怎么新增注意事项
每修完一个事故 → 在 PG rules.pitfalls 加一条(分类/现象/根因/正确做法/证据),本页与上岗包自动更新。