docs: 新增微信智能追问产品需求

开发文档/00、简洁入口/01、产品与需求.md

@@ -5,6 +5,7 @@
 | 优先级 | 文档 | 用途 |
 |---|---|---|
 | P0 | [当前需求真源](../1、需求/修改/工作手机_进行中_20260613.md) | 唯一进行中需求与完成判定 |
+| P0 | [2026-07-26微信产品需求](../1、需求/工作手机微信产品需求_20260726.md) | 近几天对话智能追问与今日优先级 |
 | P0 | [产品总方案](../3、原型/工作手机全产品设计_20260722/产品总方案.md) | 产品定位、范围、版本和研发拆分 |
 | P0 | [可点击原型](../3、原型/工作手机全产品设计_20260722/可浏览高保真原型.html) | 页面评审 |
 | P0 | [SOUL需求文档](../1、需求/SOUL需求文档.md) | 成员登记、欢迎内容、统计与房主关系；主责火炬 |
@@ -22,4 +23,3 @@
 - 新需求只追加到“当前需求真源”。
 - 产品设计有变化时，更新产品总方案和对应附件，不再另建同名方案。
 - 历史需求统一留在 `10、项目管理/已完成/`，不进入本页。
-

开发文档/1、需求/修改/工作手机_进行中_20260613.md

@@ -1,5 +1,23 @@
 # 工作手机 · 进行中（最新真源）
 
+> **2026-07-26 今日产品需求**：[工作手机微信产品需求（智能追问版）](../工作手机微信产品需求_20260726.md)
+> 基于近几天42个项目会话、15832条去重消息形成；今天优先推进真实连接、Hook自愈、消息落库、写后回读、BFF映射和24小时稳定。
+
+## 2026-07-26｜微信产品需求新增
+
+| 优先级 | REQ | 状态 | 产品目标 |
+|:---:|:---|:---:|:---|
+| P0 | WX-P0-01 | ⬜ | 真实无线连接单一真源，彻底排除回环伪在线 |
+| P0 | WX-P0-02 | 🟡 | Hook四层状态与三类故障自动恢复 |
+| P0 | WX-P0-03 | ⬜ | 微信消息统一落库、分页查询和最终状态闭环 |
+| P0 | WX-P0-04 | 🟡 | 写动作统一预检、确认、执行、回读和审计 |
+| P0 | WX-P0-05 | 🟡 | BFF 33/33与三端唯一设备映射 |
+| P0 | WX-P0-06 | 🟡 | 24小时稳定与异常恢复证据 |
+| P1 | WX-P1-01 | ⬜ | 好友与客户批量管理、价值评分、备注和频控 |
+| P1 | WX-P1-02 | 🟡 | 朋友圈真实sns_id、列表回读和幂等闭环 |
+| P1 | WX-P1-03 | ⬜ | 微信消息完整动作矩阵与OpenAPI真实示例 |
+| P1 | WX-P1-04 | 🟡 | 二维码加好友与多轮解封真实状态 |
+
 > 更新时间：2026-07-23 20:35
 > 当前 Release APK：`5.0.9` / `versionCode 14`（已覆盖安装并完成重启冷启动验收）
 > 当前真机：`xgfe65eimrrofyws` · Redmi 2312DRAABC · Android 13
@@ -58,6 +76,13 @@
 | 微信 Hook 注入 | 🔒 | 当前 vivo 无 Root/Frida，必须保持 `hooked=false` |
 | 存客宝读取/控制 | 🟡 | SDK 设备在线；Hook 专属读写能力需 Root 测试机或合规替代通道 |
 
+### 2026-07-25｜设备页状态收敛（前端）
+
+- [x] Android 设备页新增 IMEI/设备标识聚焦展示（优先 `binding.encryptedImei`）。
+- [x] 设备页功能状态块新增微信、SDK、注入引擎、平台连接入口并归一化动作展示。
+- [x] 高级连接维护区去重重复动作，保留运行日志、版本更新和 Agent 重连。
+- [x] 构建校验通过（`npm --prefix sdk/android-ui run build`）。
+
 ### 2026-07-17 真机清机复装结果
 
 - [x] 卸载旧工作手机、奥创三包及自动脚本辅助包；保留微信 `com.tencent.mm`。
@@ -258,3 +283,15 @@
 - [ ] WP-HL-08：全量契约、负例、真机回读与证据总表验收。
 
 详单、责任和验收口径：`开发文档/1、需求/修改/工作手机_微信无界面接口补齐_20260723.md`。
+
+## 2026-07-24 v5.0.10 扫码绑定与注入引擎
+
+- [x] 未绑定首次打开只显示扫码绑定页，不再展示联网检查、保活步骤、下一步或局域网搜索。
+- [x] 设备页“重新绑定”进入同一个极简扫码页。
+- [x] 局域网自动发现只在 Agent 断线后台运行，不在界面展示搜索按钮或开关。
+- [x] “注入引擎服务”接通原生 `restart_frida` 动作，Root 环境可一键恢复。
+- [x] 注入引擎显示按 frida-server 真实就绪状态；微信 Hook 注入继续单独判定，避免混淆。
+- [x] APK 内置 Frida 16.5.6 arm64 ELF，版本 `5.0.10/code15`，Release 与 LintVital 构建通过。
+- [ ] 当前 ADB 设备 0 台；手机回连后覆盖安装并补扫码页截图、引擎运行状态和 Hook 回读。
+- 正式包：`sdk/releases/20260724/workphone-agent-v5.0.10-release.apk`
+- SHA-256：`64afcbe4e02c70de965a33bb9eeab80cc35d6345625a8457a021e179b5bd4a9c`

开发文档/1、需求/工作手机微信产品需求_20260726.md

@@ -0,0 +1,144 @@
+# 工作手机微信产品需求（2026-07-26 · 智能追问版）
+
+> 信息来源：2026-07-23～2026-07-26 本项目 42 个 Codex 会话文件、15832 条去重消息，以及当前需求真源、开发进度总表、功能迭代记录。
+
+## 一、今天的产品结论
+
+工作手机的核心不是在 APK 里堆微信业务页面，而是提供一套**稳定、真实、可审计的微信执行底座**：
+
+1. APK 继续保持“工作台、Agent、设备”三页，突出扫码绑定、设备身份、连接、保活、自愈和运行日志。
+2. 微信好友、聊天、群发、朋友圈等业务细节放在存客宝/触客宝管理端，通过统一 API 调用。
+3. 任何动作只有同时具备“真实无线通道、原始回执、业务回读、证据归档”才算成功。
+4. 先解决连接真实性、Hook 附着和消息落库，再扩大批量写操作。
+
+## 二、现有能力与真实问题
+
+| 领域 | 已有能力 | 当前问题 |
+|---|---|---|
+| APK | React三页、扫码绑定、设备身份、Agent配置、自愈开关 | 状态仍可能因设备别名和旧探测结果漂移 |
+| 连接 | WSS Agent、局域网/公网候选、心跳、重连 | 曾出现ADB reverse/127回环伪在线；WLAN隔离与公网鉴权造成掉线 |
+| Hook | Frida RPC、模块探测、部分读写动作 | `frida_hook_not_attached`仍是223动作批测的主要失败原因 |
+| 消息 | 发送、拉取、转发等接口和事件日志 | 当前Mongo缺少正式消息集合，聊天正文和最终送达状态未形成查询闭环 |
+| 好友 | 联系人读取、画像、备注、批量动作契约 | 群加10人实测10/10失败；缺专用测试对象、频控和最终好友关系回读 |
+| 朋友圈 | 发布、列表、点赞、评论接口 | 曾出现假/空`sns_id`、queued代替成功、发布后列表为空 |
+| BFF | Fleet、实时状态、SDK代理、错误透传 | 33/33复跑受JWT/403阻塞，跨端映射仍需现场核对 |
+| 稳定性 | 保活、重连、自愈和长期采样 | 24小时验收、自愈三重启和唯一PID证据尚未完整关单 |
+
+## 三、智能追问与默认决策
+
+| 追问 | 从聊天记录得到的答案 | 产品决策 |
+|---|---|---|
+| 工作手机APK要不要展示所有微信功能？ | 多次要求删除无关微信细节页，以Agent和设备稳定为主 | APK只保留三页；微信业务进入管理端 |
+| 什么叫设备在线？ | 127回环曾制造伪在线 | 只认非回环来源的WSS会话，展示来源IP、通道、心跳和会话ID |
+| 什么叫动作成功？ | HTTP 200、accepted、queued多次被误当成功 | 必须原始回执成功＋业务对象回读成功 |
+| Hook可用如何判断？ | Frida端口可连不等于微信已附着 | 分开显示Frida服务、微信attach、RPC ping和业务能力 |
+| 消息能不能查？ | commands和事件日志存在，但正式消息集合缺失 | 新建统一消息模型，收发、状态、回执、正文均可查询 |
+| 批量加好友何时开放？ | 10次群加均失败，且需要备注、估值分和去重 | 先dry-run、频控、专用测试对象，再小批量放量 |
+| 朋友圈成功依据是什么？ | 页面未出现、空sns_id、queued等问题反复出现 | 非零真实sns_id＋列表回读＋内容指纹一致 |
+| 网络选择局域网还是公网？ | LAN有客户端隔离，公网可达但有鉴权 | Agent自动发现；同网可达用LAN，不可达自动切公网WSS |
+| BFF失败如何呈现？ | 403/JWT、设备离线、Hook未附着混在一起 | 统一错误分层：鉴权、连接、能力、执行、回读 |
+| 功能优先级怎么排？ | 绝大多数失败最终都归因连接/Hook/回读 | 底座P0优先，业务扩展P1/P2后置 |
+
+## 四、P0需求（今天进入开发）
+
+### WX-P0-01 真实连接单一真源
+
+- Hub拒绝127/localhost/ADB reverse作为业务在线来源。
+- 每台设备只保留一个当前会话，设备别名映射到唯一设备ID。
+- 管理端显示：连接类型、来源IP、服务器、心跳年龄、鉴权状态、最近断线原因。
+- LAN不可达时自动切换公网WSS；恢复后按策略回切，不产生双在线。
+
+**验收**：拔掉USB、ADB=0，连续30分钟在线；切换网络后120秒内恢复；全程没有回环连接。
+
+### WX-P0-02 Hook四层状态与自愈
+
+- 状态拆为：Frida服务、微信进程、Session attach、业务RPC。
+- `supports_hook=true`必须来自当次RPC ping，不能复用过期模块探测结果。
+- Frida停止、微信重启、Agent重启后自动重新attach，并生成结构化恢复事件。
+
+**验收**：三种故障各执行3轮，60秒内恢复；恢复后`ping/get_profile/get_messages/send_message`真实通过。
+
+### WX-P0-03 微信消息统一落库
+
+- 新增统一消息集合：`device_id/wxid/talker/msg_svr_id/local_id/direction/type/content/status/timestamps/raw_receipt`。
+- 接收事件、主动拉取和发送回执统一幂等入库。
+- 状态至少包含：queued、sent、delivered、failed、recalled、unknown。
+- 提供会话列表、消息分页、按`msg_svr_id`查询、失败重试和事件订阅。
+
+**验收**：指定测试会话收发各10条，数据库20条可查；正文、方向、时间、最终状态和微信回读一致；重复同步不重复入库。
+
+### WX-P0-04 写动作统一闭环
+
+- 所有写动作采用：`dry_run → confirm → execute → raw_receipt → readback → audit`。
+- 返回统一字段：`trace_id/channel_used/device_id/action/status/error_code/raw_rpc_receipt/readback`。
+- accepted/queued不得转译为success；超时后保持unknown并允许按trace查询。
+
+**验收**：发送消息、转发、备注、群发、朋友圈发布五类动作全部通过同一状态机和错误模型。
+
+### WX-P0-05 BFF与设备映射闭环
+
+- 完成33/33 BFF接口有效JWT复跑。
+- 存客宝、触客宝、超管共享唯一`device_id ↔ Agent ID ↔ wxid`映射。
+- BFF原样透传鉴权、离线、未附着、执行失败和回读失败。
+
+**验收**：三端看到同一在线状态；同一trace可从BFF追踪到Agent、Hook和回读。
+
+### WX-P0-06 24小时稳定与可观测
+
+- 每60秒采样SDK、WSS、Agent、微信、Hook、网络、电量和前台服务。
+- 记录断线开始、恢复时间、根因、自动处理动作和人工介入。
+- 禁止验收脚本主动`kickstart -k`或重启共享SDK制造状态漂移。
+
+**验收**：连续24小时；网络切换、熄屏、微信重启、Agent重启各至少1次并自动恢复。
+
+## 五、P1需求（P0全绿后开放）
+
+### WX-P1-01 好友与客户批量管理
+
+- 支持手机号/群成员/二维码三种来源。
+- 自动去重、风险预检、分批间隔、申请语、负责人、标签和备注模板。
+- 支持客户价值评分；可筛选最有价值客户并将评分写入备注扩展字段。
+- 删除好友只允许专用可恢复测试对象，先预览再确认。
+
+### WX-P1-02 朋友圈真实闭环
+
+- 支持文本、图片、链接三种发布；内容指纹防重复。
+- 发布成功必须返回非零真实`sns_id`，并由列表回读确认内容一致。
+- 点赞、评论、删除均使用真实朋友圈ID并读取最终状态。
+
+### WX-P1-03 消息完整动作矩阵
+
+- 文本、图片、文件、名片、语音、链接、转发、撤回、接收/拒绝转账分别维护支持状态。
+- 涉及支付的动作只做能力探测、明确状态与人工确认门禁，不与普通消息混用。
+- 每个动作在OpenAPI提供请求、响应、错误码和真实示例。
+
+### WX-P1-04 二维码加好友与自动解封
+
+- 二维码选图、识别、申请、好友关系回读形成闭环。
+- 解封保留多轮客服原文、AI回复、发送状态和final_status，禁止用流程走完代替成功。
+
+## 六、页面要求
+
+### APK
+
+- 继续保持工作台、Agent、设备三页。
+- 工作台只显示设备健康、Agent、平台、微信基础状态和异常摘要。
+- 设备页负责扫码绑定、唯一设备编号、连接详情、高级维护和运行日志。
+- 不新增聊天、好友、朋友圈、群发详情页。
+
+### 存客宝/触客宝管理端
+
+- 微信号页：设备、wxid、好友数、Hook能力、最后活跃。
+- 客户页：标签、价值分、负责人、最近互动和好友状态。
+- 聊天页：会话列表、消息状态、失败原因和trace追踪。
+- 任务页：群发、好友、朋友圈的dry-run、确认、进度、回执和重试。
+- 风险页：频控、失败聚类、异常账号、离线设备和人工确认。
+
+## 七、产品验收总门禁
+
+1. 真机执行，不使用旧截图、模拟回执或ADB回环作为通过证据。
+2. 每项必须具备请求、响应、trace、原始回执、业务回读和时间戳。
+3. UI状态与API状态一致，离线、未附着、未知不得显示成功。
+4. 写动作只在测试账号、测试群、测试朋友圈和专用对象执行。
+5. P0六项全部通过后，才扩大好友、群发和朋友圈批量规模。
+

开发文档/功能迭代记录.md

@@ -1346,3 +1346,32 @@ flowchart LR
 - 原“成员运营需求”和“本机材料调研”合并为`开发文档/1、需求/SOUL需求文档.md`。
 - SOUL后续功能、调研、验收和火炬开发任务只在该文档持续追加。
 - 删除两个子目录SOUL需求副本，避免功能分散和多真源。
+
+## 2026-07-26｜公司 NAS 最新 SDK 与接口文档部署
+
+- 同步最新 SDK 至 `/volume1/docker/workphone-sdk`。
+- 同步接口文档 201 个文件至 `/volume1/docker/workphone-docs/开发文档/5、接口`。
+- 完成 Docker 镜像构建并启动 SDK、MongoDB、Redis。
+- 验证 `/health`、`/docs`、`/openapi.json`、`/hub` 均返回 HTTP 200。
+- 部署验收：`开发文档/8、部署/05-测试验收/20260726_NAS最新SDK与接口文档部署.md`。
+
+## 2026-07-26｜工作手机微信智能追问与今日产品需求
+
+### 信息来源
+
+- 扫描2026-07-23至2026-07-26本项目42个Codex会话文件、15832条去重消息。
+- 对照当前需求真源、开发进度总表和近期功能迭代记录。
+- 按连接、Hook、消息、好友、朋友圈、设备、安全、BFF、稳定性、产品十个主题聚类。
+
+### 产品结论
+
+- APK继续保持“工作台、Agent、设备”三页，不堆微信业务详情。
+- 微信业务通过存客宝/触客宝管理端和统一API执行。
+- P0顺序固定为：真实连接→Hook自愈→消息落库→写后回读→BFF映射→24小时稳定。
+- P0全绿后再扩大批量好友、消息动作和朋友圈规模。
+
+### 新增需求
+
+- P0：WX-P0-01～WX-P0-06，共6项。
+- P1：WX-P1-01～WX-P1-04，共4项。
+- 详细需求：`开发文档/1、需求/工作手机微信产品需求_20260726.md`。