Files
workphone-sdk/开发文档/10、项目管理/02、专项调研/20260728_项目效率优化/known_issue_registry.json

97 lines
4.8 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"version": "2026-07-28.1",
"usage": "执行前先运行 workphone_execution_preflight.py命中 signature 后按 canonical_action 处理,不重复做根因猜测。",
"issues": [
{
"issue_id": "WP-KNOWN-001",
"name": "频控或防封等待",
"conversation_threads": 29,
"signature": ["rate_limited", "retry_after", "频控", "限流"],
"failure_type": "business_guard",
"owner": "阿机",
"canonical_action": "保留原始等待时间,按服务端与微信返回的较大值等待;同批暂停,不修改业务代码。",
"do_not_repeat": "不要把频控当成接口Bug反复重写或连续重试。"
},
{
"issue_id": "WP-KNOWN-002",
"name": "设备离线或同机身份不唯一",
"conversation_threads": 20,
"signature": ["device_offline", "websocket/offline", "设备不在线", "多个在线设备ID"],
"failure_type": "connection",
"owner": "阿服",
"canonical_action": "只查LAN SDK健康、WSS远端、心跳和设备指纹恢复唯一手机WSS后重新生成同窗快照。",
"do_not_repeat": "不要把连接故障派给业务接口不切换USB、ADB或UI路径。"
},
{
"issue_id": "WP-KNOWN-003",
"name": "Frida Hook未就绪",
"conversation_threads": 17,
"signature": ["frida_hook_not_attached", "frida_attach_in_progress", "hook_available_reported=false"],
"failure_type": "capability",
"owner": "阿机×阿服",
"canonical_action": "核主微信PID、session_ready/status、IIFE输出和Agent回报Hook四层就绪后才放行写任务。",
"do_not_repeat": "WSS在线、supports_hook或历史模块状态都不等于当前RPC可写。"
},
{
"issue_id": "WP-KNOWN-004",
"name": "OpenAPI写门禁字段缺失",
"conversation_threads": 16,
"signature": ["fields_missing", "字段缺失", "契约缺口", "OpenAPI"],
"failure_type": "contract",
"owner": "阿桥",
"canonical_action": "先修运行态请求模型至少具备dry_run、confirm、idempotency_key、trace_id重启后重新读取OpenAPI。",
"do_not_repeat": "本地代码模型和旧文档不作为运行态契约通过证据。"
},
{
"issue_id": "WP-KNOWN-005",
"name": "动作未登记或跨层别名漂移",
"conversation_threads": 15,
"signature": ["Unsupported", "no_receiver_registered", "RPC 方法不存在", "alias_unresolved"],
"failure_type": "capability",
"owner": "阿机×阿桥",
"canonical_action": "一次对齐路由、Python动作表、Android动作表、Hook exports和别名接口审计全绿后再部署。",
"do_not_repeat": "不要只补其中一层也不要让u2或Shell接管严格Frida动作。"
},
{
"issue_id": "WP-KNOWN-006",
"name": "源码已改但运行进程未加载",
"conversation_threads": 12,
"signature": ["未热加载", "旧代码", "旧进程", "运行态漂移"],
"failure_type": "environment",
"owner": "阿服",
"canonical_action": "对比源码mtime、进程启动时间和实时响应结构由唯一运行操作者完成一次受控重载。",
"do_not_repeat": "不要反复改已经正确的源码也不要多角色同时重启SDK。"
},
{
"issue_id": "WP-KNOWN-007",
"name": "执行回执存在但业务回读失败",
"conversation_threads": 6,
"signature": ["readback_failed", "business_readback_failed", "回读不一致"],
"failure_type": "business_readback",
"owner": "阿机×阿端",
"canonical_action": "保留原始RPC按同一trace和业务指纹补微信数据库或消息回读回读一致后才记成功。",
"do_not_repeat": "HTTP 200、queued、accepted或RPC success都不升级为业务成功。"
},
{
"issue_id": "WP-KNOWN-008",
"name": "网关502空响应",
"conversation_threads": 4,
"signature": ["gateway_empty_502", "502空响应"],
"failure_type": "gateway",
"owner": "阿桥×阿服",
"canonical_action": "首项失败即停,保存时间、实例、请求摘要和网关响应;交网关主责修外层封装。",
"do_not_repeat": "不要继续后续写操作不用底层RPC历史结果补顶层四证。"
},
{
"issue_id": "WP-KNOWN-009",
"name": "规则和经验向多线程重复广播",
"conversation_threads": 37,
"signature": ["codex_delegation", "规则生效", "经验库生效"],
"failure_type": "process",
"owner": "火炬",
"canonical_action": "规则只写项目Skill和问题台账线程启动读取版本号只有版本变化才推送差量。",
"do_not_repeat": "不要向每个线程重复发送整段规则和已知经验。"
}
]
}