注意事项 · 上岗必读

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