# Changelog

本文件记录源码变更、生产发布与验证结果；每项明确标注完成层级。时间均为中国标准时间（CST，UTC+8）。

## Unreleased

- **2026-08-05，实时陪练业主身份档案与「业主·急躁」下线已发布**：按客户要求删除 `owner-impatient` 人设（`owner-calm` 改名「业主」，id 不变）；新增 `aihr_realtime_owner_profile` 业主身份档案（迁移 `aihr_20260823_realtime_owner_profile_mysql8.sql` 已在生产执行，`(tenant_id, project_code)` 唯一键，画像属内容运营数据、enabled=1 才对员工可见）。管理端训练运营新增「业主身份档案」配置页（moderator 角色门、projectCode 必须命中本租户组织快照、projectName 以快照为准、concerns 限 500 字带内容纪律提示、重复创建 409）；员工端实时陪练新增「业主身份」选择器（默认本小区 `defaultProfileId`、可改选或显式不指定、storage 记忆、接口失败静默隐藏），员工接口只返回 `{profileId, projectCode, communityName, label}` 展示安全字段，画像正文不下发。会话渲染 `{community}/{profile}` 全部由服务端完成，客户端文本无法进入 instructions；显式 profileId 非法/跨租户/未启用 400 拒绝，默认解析 fail-closed 回落无画像模板。实时 Beta 不计分不持久化、工具白名单与三重校验不变。后端 JAR SHA-256 `234888996a82ddc5e7d36ee62f0b5086f32c9a1ac95e51bf7ce83fbb01100e0c` 经定向发布脚本完成备份、原子切换与发布后预检（模块哈希一致），回滚备份 `/opt/wygj/backups/backend-20260805032157-f0d017829a9c`；移动 H5 与管理端静态已同步发布（整站备份 `/opt/wygj/backups/www-pre-owner-profiles-20260805-032337`），根站、`/h5/` 200，`/api/train/practice/realtime/personas` 与 `/api/aihr/practice/realtime/owner-profiles` 均在线且正确鉴权。后端 `1057/1057`、移动端 typecheck 与 H5 构建、管理端构建通过；**管理端尚无真实档案数据、选择器与会话画像渲染未经生产认证态真机复验**。
- **2026-08-05，问模块四来源（知识空间/公网/经验库/有奖征答）已发布**：员工问答在既有知识空间与公网同意闸之外新增两个 REFERENCE 级增强来源——正式经验库（`aihr_case_record`，`已入库+PUBLISHED+生效期+岗位门`，chip「正式经验」）与有奖征答最佳答案（`PUBLISHED+is_best=1` 且问题 `PUBLISHED/CLOSED`，只读 SQL 不含提交人身份，chip「同事经验·有奖征答」）。岗位由服务端按组织身份解析（`AihrEmployeePositionResolver`），经验/案例类硬过滤非适用岗位，形式制度不受影响，解析失败 fail-closed 仅通用可见；两增强源只追加引用、不稀释 FORMAL 答案、失败不打断主链，零文档证据时仲裁从 ROUTE 升为 GUIDANCE。管理端问题榜新增「转为经验候选」（moderator 门、幂等、固定 CANDIDATE 且 source_authorized/deidentified=0，绝不自动发布）；移动端引用 chip 直达案例详情/问题详情，已点「有用」的答案禁用转人工按钮。迁移 `aihr_20260822_case_source_ref_and_best_answer_index_mysql8.sql` 已在生产执行并核验（备份 `/opt/wygj/backups/pre-20260822-four-source-20260805-024645`）。后端 JAR SHA-256 `f0d017829a9c2415a56e185bba2b138c7ccda2017d5d9a95a6d1b2ef070e548d` 经定向发布脚本完成备份、原子切换与发布后预检（schema `83/83`、collation `0/0`、模块哈希一致），回滚备份 `/opt/wygj/backups/backend-20260805024804-f1fe73d8c499`；移动 H5 与管理端静态已同步发布（整站备份 `/opt/wygj/backups/www-pre-four-source-20260805-025018`），根站与 `/h5/` 均 200。后端 `1040/1040`、移动端 typecheck 与 H5 构建、管理端构建通过；**四源链路尚未做生产认证态真机复验**（经验库/最佳答案需存在已发布内容才会命中），`0.1.18` 云打包 APK、签名包验收与受控分发仍未完成。
- **2026-08-05，问模块证据分级、澄清闭环与 ROUTE 出口已发布并完成真机验证**：员工问答从“正式源检索封锁 + 官腔拒答”改为四级证据仲裁（`FULL/PARTIAL/GUIDANCE/ROUTE`）：`AihrEvidenceGradingService` 为唯一仲裁点，`GUIDANCE` 允许参考经验出流程答案但强制标注“非正式制度依据”，政策断言只允许 FORMAL 引用（policyClaims 后置校验 + 金额断言启发式兜底）；程序性问题不再追问金额语义，挂起澄清随 30 分钟会话闭环（已回答/放弃/新话题，同一澄清最多问一轮）；`ROUTE` 给出转人工/直通财务/查全网可执行出口，`aihr_knowledge_answer_feedback.fragment_id` 可空使零引用答案也能走“自动补 down 反馈 + 确认”的幂等转人工链。迁移 `aihr_20260804_pending_clarification_mysql8.sql`、`aihr_20260804_feedback_fragment_nullable_mysql8.sql` 及 `aihr_20260804_unify_all_collations_mysql8.sql` 已在生产执行并核验（执行前备份相关表至 `/opt/wygj/backups/pre-20260804-ask-refactor-20260805-005414`）。后端 JAR SHA-256 `f1fe73d8c499f75bcd44f52893033d21910fec6ba2745598874dd7d73f54735d` 经定向发布脚本备份、原子切换与发布后预检（schema `83/83`、collation `0/0`、模块哈希一致），回滚备份 `/opt/wygj/backups/backend-20260805005921-74d0cd2acc60`；移动 H5 已同步发布（远端备份 `/opt/wygj/backups/h5-pre-ask-refactor-20260805-010119`）。后端 `1014/1014` 测试、移动端 typecheck 与 H5/App 构建通过；vivo V2443A（Android 15）经 HBuilderX 5.23 标准基座完成固定码登录和“单笔500元采购报销”发问、追问放弃澄清、出口按钮组的真实链路验证。`@dcloudio/*` 编译器同步升级为 `3.0.0-alpha-5020320260803001`（对齐 HBuilderX-Alpha 5.23），版本号升至 `0.1.18 (118)`。标准基座验证不算签名包验收：`0.1.18` 云打包 APK、APK 门禁、真机正式验收和受控分发均未完成；非金额类政策断言的分级依赖模型诚实标注（观察项），空片段反馈并发双击可能产生冗余行（有幂等兜底），已点“有用”的答案上转人工会被 409 拒绝（前端待禁用）。
- **2026-08-04，受约束 Grounded Agent 与财务 RAG 证据门禁完成实现并受控发布**：新增 `ResolvedContext/SemanticQueryPlan/ExecutionContext/ToolCall/ToolResult/DocumentEvidence/VerifiedFact/DecisionResult/GroundedAnswer` 契约，接入 `MY_CURRENT_TASKS + KNOWLEDGE_SEARCH` 双工具、服务端授权参数注入、有界工具执行、候选调用去重、受控超时、证据槽位/来源权威/正文蕴含门禁、逐结论引用校验及结构化会话状态。财务金额覆盖 `¥500`、`五百块`、`不到500`、单笔/月累计与口径冲突；知识检索为不生成答案的授权证据工具，并将候选召回、rerank 和最终 evidence/display 截断分层。生产后端以 JAR SHA-256 `74d0cd2acc60ebf52f20eb8bee643f59395ba7cff3583076d671e57406f824ac` 发布，`wygj-aihr.service` 为 `active`，schema `83/83`，公开根站、租户列表和移动首页 HTTP 200；生产 `ACTIVE` 仅覆盖文本 `KNOWLEDGE_QA`/`LIVE_MY_WORK`，其余请求和不合格计划回退旧链路。30 条纯内存黄金场景、RAG/资料治理/Agent 新链路 166 项、旧 Planner/Orchestrator/会话兼容 45 项及 additive MySQL 8 迁移回归通过。认证态用户逐例问答、客户端状态 UI 全量验收、真实模型 + MySQL/Qdrant 的完整召回评测和 100–300 条人工黄金集仍待完成，不能据此宣称生产召回率达标。
- **2026-08-02，功能复核清单首批增量已实现并完成本地验证，未部署**：当前工作树新增大喇叭 `ALL/TARGET_ONLY` 可见性、受控在线查看与动态水印、下载门禁和带原文依据的主题标签；问师傅未解决反馈确认转待审核问题；正式学习任务、审核题库随机组卷及考试关联；案例经验“候选→审核→发布→下线”；原生异常恢复回归和资料暂存盘容量健康门禁。管理端生产构建、移动端类型检查与 `216/216` 单测、后端 `838/838` 测试及迁移静态清单通过；`390×844` 已验证员工主要入口和登录门禁。Docker/MySQL 未运行，四个 `aihr_20260802_*` 迁移尚未执行，管理端认证业务、峰值压测、签名 APK、真机、生产发布和严格试点均未验收。
- **2026-07-31，8 月 1 日受控内部公测门禁收口为 Go**：最新后端 JAR SHA-256 `d5145194024ba3526a869e3270df6d71468931b96ba9aebb93121592e54012eb` 已上线，正式政策模式只允许当前有效、已批准、版本与原文件哈希完整且与问题领域相关的来源进入回答；没有相关制度时失败关闭，不再回退经验萃取或访谈材料。使用生产现有 APP 账号重跑 30 道策略题，11 题只引用已批准正式来源，分期缴费题返回 `NO_EVIDENCE`，其余冲突、无依据和越权题按边界返回，合计 `30/30`；证据不保存手机号、验证码、令牌、问题或答案正文。生产 5 个 `v1.1` 场景及独立审核链、五通道各 2 名有效处理人、本通道正例/跨通道拒绝/一次正式回复 `5/5`、五类负责人委托签认，以及 `0.1.17 (117)` 的 DCloud 测试签名受控分发例外均已回填。严格内容门禁和生产只读就绪门禁均通过；同时修复就绪脚本把含 `|` 的场景快照直接作为 SSH 参数导致远端误解析为管道的问题，改为 Base64 单参数传输。该 Go 仅适用于受控内部公测，不代表应用商店发布、企业正式签名或阶段一严格试点窗口通过。
- **2026-07-30，5 个真实访谈场景已落入生产停用草稿，正式内容门禁保持 No-Go**：从 `D:\20260730` 的 12 份访谈材料中选择 7 份代表性来源，以脱敏主题和 SHA-256 登记到 `aug1-life-advisor-candidate-v0.2`，形成管道漏水责任、物业费争议、维修延期、停车冲突、收费与整改并行五个真实业务场景。已登录生产管理端逐条保存并按编码回查，场景总数从 `100` 增至 `105`，当前启用数保持 `86`，五项均为 `草稿 / 草稿未提交 / 停用`；费用复核作为业务动作和审核职责保留，不把系统不支持的财务部门伪装成住宅训练岗位。候选文件仍为 `publishable=false`，30 道政策题仍无标准答案；严格门禁继续准确保持正式场景 `0/5`、问题证据 `0/30`，本项没有提交业务审核、启用或发布场景，也没有部署代码、重启服务或执行 schema 迁移。
- **2026-07-30，`0.1.17 (117)` Android 技术候选与五通道处理人配置完成收口，正式发布仍为 No-Go**：管理端“直通反馈”五通道处理人配置已在线可用，生产按有效后台用户规则只读复核后，`direct_president`、`direct_finance`、`direct_hr`、`direct_audit`、`direct_operations` 均为 `2/2`；Android 权限 Activity 生命周期修复已进入新的 DCloud 测试签名 APK `mobile-uni/dist/debug/bangdao-0.1.17-dcloud-test.apk`，包体 SHA-256 为 `0A8581D70A5988E4BDCF4BB3F0C88B4608FA8C6785FDCF1569DD56CE88E27F60`，包名 `com.yincheng.wygj`、版本 `0.1.17 (117)`、target SDK 35、禁止明文流量和签名深检均通过。vivo V2443A（Android 15/API 35）已在同一签名包上完成覆盖安装、正式账号登录、员工首页、学习中心、麦克风允许/拒绝/最终恢复、系统音频选择器、App 媒体选择器、生产 ASR、成果投稿确认和五通道入口回归；测试成果形成 `#7 / PENDING` 待审核记录，测试音频与会话已清理，最终无 Crash/ANR。移动端 209 项、后端定向 46 项、管理端定向 4 项、类型检查、App-Plus 构建、发布资源门禁和生产认证态冒烟均通过；认证态 UI 审计改为只从调用参数或环境变量接收手机号/验证码，报告、控制台和默认截图路由不再持久化认证凭据。该 APK 仅安装到已连接真机，未进行受控分发，也未在本项重发 H5、管理端、后端或 schema。严格门禁仍为正式场景 `0/5`、题库证据 `0/30`、通道验收 `0/5`、负责人签认 `0/5`、受控分发 `PENDING`，且同包离线、WebRTC、图片/视频/文档上传、受控下载和主管/候选人角色尚未验收，因此只能作为继续受控验收的技术候选，不能签署 8 月 1 日正式 Go。
- **2026-07-30，学习中心错题列表异常已修复、发布并完成真机验证**：vivo V2443A（Android 15）的线上会话进入“学习”页后显示“发生未知异常”，同页任务、知识引用等请求正常，生产日志将故障收敛到 `GET /api/aihr/mobile/practice/mistakes`；其 SQL 文本中的 JSON `LIKE '%"redFlag":true%'` 被 `String.formatted()` 误当成格式指令，触发 `UnknownFormatConversionException: Conversion = '"'`。当前改为只替换身份 `IN` 参数的专用占位符，保留两个 `LIKE` 通配符原样，并增加 SQL 生成回归测试；`AihrPracticeSeedServiceTest` 103 项、`ruoyi-aihr` 全量 707 项测试和 `ruoyi-admin` 生产包构建均通过。提交 `edb8c825` 的后端 JAR `346687564b38adbba643fc7d94d2faedbb51449198b4eef6c3fa90fb99646c83` 已通过定向发布脚本备份、原子切换、重启和发布后预检，旧包备份在 `/opt/wygj/backups/backend-20260730005606-be16c229cfc2`；远近端整包及内嵌 `ruoyi-aihr-5.6.2.jar` 哈希一致，服务、公开接口、64/64 schema 和生产禁运行时 DDL 均通过。同一真机从“今日”重新进入“学习中心”后不再显示异常，错题、分数和“去再练”入口正常；对应错题接口在 `22ms` 内结束，重启后日志未再出现 `UnknownFormatConversionException`。本次只发布后端，未发布移动 H5、原生 App、管理端或 schema 迁移。
- **2026-07-29，Android 文件选择、麦克风拒绝降级与上传路径修复，源码候选升级为 `0.1.16 (116)`，尚无签名 APK**：真机确认 `0.1.13` 在允许麦克风时可完成原生录音和生产 ASR，但拒绝后的降级误用 App 不支持的 `uni.chooseFile`。Android 非媒体文件现改用系统 `ACTION_OPEN_DOCUMENT`，通过 `ParcelFileDescriptor + FileChannel.transferFrom` 复制到应用专属外部缓存，避免 Native.js `byte[]` 参数兼容问题；图片/视频改走 App `uni.chooseMedia`，页面生命周期会保留系统选择器中的待完成任务，录音前统一检查麦克风权限。vivo Android 15 真机在 HBuilderX 5.22 标准调试基座完成取消、重复打开、`100,542` 字节 WAV 精确复制、multipart 上传和生产 ASR。首次成果投稿验证实际只进入追问态，当时并未出现“确认投稿”，此前“未点击确认投稿”的表述已纠正；继续补充时线上整理请求耗时 `94,965ms`，超过客户端 `45,000ms` 门限。当前源码改为仅首轮调用 AI，后续原话并入当前草稿后交由既有服务端本地复核，真机复验后续整理耗时 `1ms`，确认卡及“确认投稿”按钮均已显示但未点击，未形成正式投稿。移动端 206 项测试、类型检查、App 发布资源预检和 App-Plus 构建通过；调查用 `0.1.14/0.1.15` APK 已删除。DCloud 当日云打包额度耗尽，最终 `0.1.16` 签名 APK、深检和同包真机复验仍未完成，因此当前仍为 No-Go，未发布移动 H5、原生 App、后端、管理端或数据库。
- **2026-07-29，资料处理中心普通文档/图片单文件 500MB 已发布并完成生产验证**：管理端批量导入、后端异步队列、ZIP 子文件和 Tika 输入流统一允许受支持文件 `≤500MiB`，沿用生产 Spring/Undertow `500MB/520MB` 传输层配置；仍保留 ZIP 最多 1000 个子文件、解压总量 ≤2GB、禁止嵌套 ZIP 等安全边界，同步 SOP 上传和公司文件继续保持 100MB。生产实测发现首个候选虽已放宽页面和队列校验，但 Tika 内仍残留独立 `100MiB` 输入流上限，导致首批队列 `1194/1195` 上传成功后加工失败；补齐解析器上限及回归断言后，11 项定向后端测试和后端生产打包通过。管理端发布前备份整站到 `/opt/wygj/backups/www-20260729213203`，线上 `processing-BjvQ3qpr.js` 与本地产物 SHA-256 均为 `6ace59477519d6c53cbfe207a229518a7e2f7568e05961cfea28d669e1eeb305`，移动 H5 树哈希保持 `ba4aa656d64fc301141280357c204a67141d1e6b2e2a26a0be21c0dd48a25712` 未变。最终后端 JAR SHA-256 为 `be16c229cfc255e4cdf5ec32df047994b54d7d2c31b6c729dde6d949e191e53d`，旧包备份在 `/opt/wygj/backups/backend-20260729214901-5ef5dd484b5d`；整包及内嵌 `ruoyi-aihr-5.6.2.jar` 远近端哈希一致，服务、公开接口、64/64 schema 和生产禁运行时 DDL 预检均通过。已登录生产 Chrome 验收批次 `b-c2560e95-0cf7-46e0-9bdc-7690ea86ffd7` 中，`4、巡检表（事业部颗粒归仓专用）.xlsx`（101.6MB，队列 `1196`、附件 `2036`）完成 5 个片段和 5 个向量，`新员工培训-社区发展中心-社区资源.pptx`（147.9MB，队列 `1197`、附件 `2037`）完成 7 个片段和 7 个向量；两项均显示“已完成/已入库”，数据库片段均含 embedding。资料总数从 1032 增至 1034，目标空间从 22 增至 24 个文件，处理中和需处理均为 0。本次只定向发布后端与管理端，未重发移动 H5、未执行 schema 迁移，不代表当前工作树与线上完整包全部匹配。
- **2026-07-29，资料处理媒体任务恢复已发布并完成生产验证**：修复历史图片/视频在视觉输入不兼容或未提取到文字时长期停在“等待解析”的问题；图片在送入视觉模型前会按方向纠正、限制像素和体积并统一编码，异步队列只有生成至少一个片段才进入完成态，零片段会保留为可重试失败。新增 `POST /api/knowledge/doc/processing-tasks/{attachmentId}/retry`，可从当前租户原 OSS 对象重新暂存并入队；正式迁移 `aihr_20260729_media_reprocess_mysql8.sql` 增加 `source_attach_id` 和 `(tenant_id, source_attach_id, id)` 索引。生产已备份 schema、后端和完整站点，发布管理端与后端 JAR `5376b67b33b171b5c85e22cd6a2f20bbb0bc527fc50a223603d0aec3f6587bac`，移动 H5 未重发；发布脚本在重启后等待公开端点真实就绪再执行预检，服务为 `active`，根站、租户和移动首页均返回 HTTP 200。原卡住任务 `1133/1175/1308/1405` 从原文件重试为队列 `1185–1188`，四项均完成、各生成一个片段且向量存在；资料处理页显示“待重试 0”、Tika `1028/1028`、可引用资料 `1028`。该证据证明本次资料恢复和定向发布成功，不代表移动 H5 与当前工作树完整匹配，也不替代 Android 真机或正式试点验收。
- **2026-07-29，新增移动端 UI token 与渲染态审计，未发布静态资源**：`audit:ui-tokens` 以 `mobile-uni/src/styles/base.css` 为源扫描颜色、字阶、间距和圆角，`audit:ui-rendered` 在 390×844 的真实 Chrome 中审计 H5 构建的六个默认路由并保存截图。两项均把报告写入 Git 已忽略的 `output/ui-ux/`；本地实跑覆盖 53 个源码文件和 6 个渲染路由，渲染路由均无横向溢出或控制台错误，同时如实记录现有 palette 外颜色、孤立字号和非 token 圆角，不能把“脚本执行成功”解释为视觉债务已清零。
- **2026-07-29，移动端固定码认证与身份失败关闭收口，候选升级为 `0.1.13 (113)`，未发布生产**：生产验证只选择已存在 `app_user` 且双向唯一的在职组织主体；固定码请求、登录、非空项目范围、认证首页、训练历史/画像、五通道、我的反馈、大喇叭、考试、案例/全网只读入口、退出、旧令牌拒绝、等待防刷窗口后的再次获取和重新登录全部通过，应用日志确认两次验证码请求均命中“未真实发送短信”分支。脚本不输出手机号、固定码或令牌，不触发自动注册，不提交反馈、训练、附件、ASR/TTS 或 Agent 请求。后端 `/api/aihr/mobile/me` 与认证首页遇到身份缺失、组织查询异常、无在职身份或后台账号时改为失败关闭；前端角色和岗位加载失败清空缓存并展示明确错误，不再回退普通员工、陈旧岗位或公开首页。干净提交 `af8af2f6` 的统一 RC 已达到 `releaseEligible=true`：移动端 199 项、`ruoyi-aihr` 700 项、类型检查、H5/App、管理端构建、后端打包和 APK 深检全部通过，证据在 `output/aug1-rc/0.1.13-113-af8af2f6-frozen/`。DCloud 云端证书 APK 大小 `33,921,543` 字节、SHA-256 `FA2D2A6DC84AE759714E6D16D146C1E1552A0F3F53C046069422012361D1D0C0`，API 35、v2 测试签名、禁止明文 HTTP、包内业务资源/登录法务/身份失败关闭和敏感值深检通过；候选后端 JAR SHA-256 为 `93AD272118F6A28F88C2BFA305F5C450E163CBE22577FF5BE3E85B3BD3958DAD`，生产只读发布计划通过，现网仍为 `46C99CFF…`。当前双提交交付包 `bangdao-aug1-0.1.13-113-af8af2f6-ops46f4616b.zip` 大小 `192,948,093` 字节、SHA-256 `F6DF4AB2660A4D3523C7E9785C1F8B572770F1F795A841E2D95C88936A8AE9C0`，20 个条目及内部哈希逐项通过；严格门禁会校验固定码模式、5/5 场景、30/30 问题证据、五类负责人签认、每个直通角色至少两名有效处理人、生产场景版本/哈希、五通道正向授权/越权拒绝/一次正式回复，以及受控分发、法务例外和测试签名接受。包内 Go/No-Go 已指向当前包，旧 `ops9c53668c` ZIP 只作历史追溯。机器签认当前准确保持正式场景 `0/5`、问题证据 `0/30`、通道验收 `0/5`、负责人签认 `0/5`、受控分发 `PENDING`，五个处理角色有效绑定均为 `0`。本项未发布后端、H5、数据库或生产静态资源；固定码、登录和重新登录不再列为功能缺口。
- **2026-07-29，Android 法务交互按企业内测体验收口，候选升级为 `0.1.12 (112)`，未发布生产**：取消启动阶段的 DCloud 原生隐私确认，统一由登录页协议勾选承担同意门槛；协议默认未勾选，服务协议与隐私政策可点击查看，未勾选时发送验证码和登录均在请求前失败关闭。两个公开 HTTPS 地址进入版本化 `.env`，npm 与 HBuilderX 云打包共用；源码、App-Plus 产物和 APK 门禁同时检查 `prompt=none`、登录法务链接、未勾选拦截、网络安全与敏感值。DCloud 独立内测 APK `com.yincheng.wygj 0.1.12 (112)` 大小 `33,921,458` 字节，SHA-256 `DD24E5F20BC7C064F5059E538A1FAB7518DF46CBAB502F59A3629F0B1B1F5EBB`，API 35、v2 测试签名、`usesCleartextTraffic=false`；本机 Android 15/API 35 虚拟机全新安装后确认原生隐私层不可见、四项敏感权限未授权、无 Crash/ANR。干净提交 `b9e08789` 的统一 RC 为 `releaseEligible=true`：移动端 199 项、后端 698 项、类型检查、H5/App、管理端、后端打包和 APK 深检全部通过，证据位于 `output/aug1-rc/0.1.12-112-b9e08789-frozen/`。双提交交付包 `bangdao-aug1-0.1.12-112-b9e08789-ops6bf365d5.zip` 大小 `192,926,061` 字节、SHA-256 `E8014A0C5BD56B66B198710E75E2B8DDEC86002D1E3BC6CAF56FB3454A199C33`，14 个条目及内部哈希逐条通过；新后端 JAR `3F9F4506…` 的生产只读计划也通过目标、服务、公开入口、64/64 schema 和生产禁 DDL 检查，现网 JAR 仍为 `46C99CFF…`，未执行部署。当前 AVD 为 `x86_64`，APK 只含 `arm64-v8a/armeabi-v7a`，DCloud Weex 在跨架构转译时实际报 `spinWaitPeer timeout`、`sender is null` 和 IPC timeout；390×844 Playwright 验证仅作为布局、链接和请求前拦截的补充证据，不替代 App 运行或认证业务验收，也不因此修改发布 ABI、增加降级链或启用兜底内容。证据位于 `output/playwright/aug1-login-consent/`。本项没有发布后端、H5、数据库或新的生产静态资源。
- **2026-07-28 至 2026-07-29，前一版 Android 受控内测候选包与法务链路，历史总体 No-Go**：补齐登录页协议默认不勾选与法务地址失败关闭、App-Plus 原生隐私配置生成/校验、APK 包名/版本/API/签名/哈希/包内资源一致性/敏感值门禁、DCloud 云证书自定义基座和独立测试包流程；《服务协议》《隐私政策》静态页已部署到 `/legal/`，发布前整站备份为 `/opt/wygj/backups/www-20260728224710`。客户端法务校验已移除 App-Plus 不保证支持的浏览器 `URL` 构造器，测试验证码也不再以源码常量进入安装包；五个文件选择服务与九个消费页面进一步统一“用户取消/平台失败”分流，取消后不再残留上传或转写错误；直通车首次弱网加载失败后可原位重试，失败时清空旧通道并禁止提交。当时独立 APK `com.yincheng.wygj 0.1.10 (110)` 的 `targetSdkVersion=35`，SHA-256 为 `20CB16B4E9D024DBF5EEEF577BFBA3B4DF5E5E78B597BABB99CB7450C7AE5034`；Android 原生网络安全配置经 APK 反编译确认 `usesCleartextTraffic=false`、`networkSecurityConfig` 引用和系统证书信任配置均已进入安装包。本机 `Medium_Phone` Android 15/API 35 虚拟机已完成从 `0.1.9` 保留数据覆盖升级和冷启动，真实显示原生隐私弹窗，四项敏感权限保持未授权且未见 FATAL/ANR；`0.1.6` 已在 vivo V2443A（Android 15）完成覆盖安装和冷启动。代码候选提交 `dc20b920` 已在干净工作区通过统一 RC 门禁，`releaseEligible=true`：移动端 198 项测试、类型检查、H5/App 构建、管理端构建、`ruoyi-aihr` 698 项全量测试、后端打包及 APK 强化门禁全部通过；最小交付包 SHA-256 为 `4BAA79B2CA2C4D486B6194288D90022D5F994A4D8C8E05D7C2DDD87F9BF5B3B7`，解压后 9 个文件、其中 8 个载荷逐文件复验通过。只读生产预检确认根站、租户接口、移动首页和 64/64 schema 门禁通过，但生产后端模块、管理端和移动 H5 与本地候选仍不一致；用户隐私选择、权限反例、认证态核心业务和正式内容也未完成，故当时 Go/No-Go 为 **No-Go**。本项没有新增生产发布、服务重启、数据库或静态资源变更。
- **2026-07-29，发布预检支持定向后端/schema 范围和冻结物核验，未发布**：`release-preflight.sh` 不再把远端后端或 schema 核验强制绑定到管理端/H5 静态匹配；定向后端发布可只启用 `RELEASE_VERIFY_REMOTE_BACKEND=true RELEASE_VERIFY_REMOTE_SCHEMA=true`，且只要求本地后端 JAR 新鲜。完整包口径仍必须同时启用远端静态、后端和 schema 三项。新增范围回归脚本，校验缺少 `RELEASE_REMOTE_URL` 时失败关闭、定向模式不回退为静态耦合、完整模式命令仍保留；`feece9bb` 再新增 `RELEASE_ARTIFACT_COMMIT` 与 `RELEASE_LOCAL_BACKEND_PATH`，允许从后续文档提交上安全地核验冻结提交及其实际候选 JAR。提交 `566f222e` 后只重建后端并实跑生产只读定向预检：输出没有管理端/H5 哈希，根站、租户、移动首页、64/64 schema 和生产禁 DDL 门禁通过，最终仅因现网/候选 AIHR 模块哈希 `15f5513a…` / `c93460e8…` 不同而按预期失败。随后以 `dc20b920` 和发布 ZIP 解压 JAR 再跑后端只读预检，确认候选整包哈希 `8c676f2f…`，仍仅在同一模块差异处失败；这证明范围和冻结物选择正确，不代表后端已经发布。本项没有执行生产同步、重启或数据库变更。
- **2026-07-29，Android 人工验收新增只读统一取证**：新增 `capture-android-acceptance.ps1`，只读取指定设备当前包版本、前台 Activity、四项敏感权限、UI 层级、截图和应用退出记录，证据限定写入 Git 已忽略的 `output/`；静态回归拒绝安装、启动、停止、清数据、授权、撤权和输入类命令。脚本已在 `emulator-5554` 实跑，确认 `0.1.10 (110)` / API 35 的原生隐私标题与拒绝/同意按钮可见、手机号登录不可见、四项权限均未授权、退出记录无 Crash/ANR。本项只记录用户选择前状态，未代替用户点击隐私选项。
- **2026-07-29，Android 隐私拒绝取证补齐二次确认与退出态**：只读取证脚本现在按实际原生模板区分首次选择 `first-choice`、二次“确认提示/退出应用” `exit-confirmation` 和弹窗不可见 `not-visible`，并记录 App 进程是否存在、是否前台及当前 UI 是否属于 App。`pidof` 在用户退出后返回非零不再让取证失败，因此可分别留存“暂不同意后的二次确认”和“退出应用后的 Launcher/退出记录”证据；脚本仍不发送点击、启动/停止或权限命令。
- **2026-07-29，定向后端发布/回滚工具与只读计划，未发布**：新增固定 `YCWY:/opt/wygj/app/ruoyi-admin.jar` 和 `wygj-aihr.service` 的 `release-backend.sh`；`plan`/`rollback-plan` 默认只读，`deploy`/`rollback` 必须使用完整 SHA-256 授权串且 Git 工作区干净。执行链包含旧包与清单备份、同目录候选校验、原子切换、systemd 重启、后端 + schema 发布后预检、失败自动恢复、回滚前安全备份和恢复前目标哈希复核；发现并发改包时拒绝自动覆盖，所有备份均保留。离线回归覆盖授权前失败关闭、六段远端 Bash 语法、无删除操作，并在临时目录实跑备份→切换→恢复→并发拒绝→回滚安全备份链。冻结候选实跑只读计划确认候选 JAR `8c676f2f…`、现网 JAR `46c99cff…`、目标/服务/空间、三个公开入口、64/64 schema 和生产禁 DDL 均符合要求；只输出授权串，没有创建远端备份、上传、切换、重启或改库。
- **2026-07-29，8 月 1 日生产 API 无登录探针固化**：新增 GET-only 脚本覆盖 APK 依赖的 20 个入口；实跑得到公开移动首页 `1×200`、鉴权 GET `6×401`、仅 POST 入口 `13×405`。`/api/knowledge/answer-feedback` 因同一路径另有运营 GET，按真实控制器归入鉴权组。回归禁止请求体、表单、授权头、手机号和短信验证码入口；本次未申请验证码、未登录、未上传、未发送业务 POST 或写入数据。该结果证明路由与失败关闭契约，不替代认证态业务闭环。
- **2026-07-29，8 月 1 日双提交交付包取代首个最小包**：新增可复现打包器，分别冻结运行时提交 `dc20b920` 与 operations commit `71f005c2`，重新校验 APK/JAR/内容哈希和提交祖先关系，并将发布、回滚、预检、GET-only API 探针、可识别隐私二次确认/退出态的 Android 只读取证和 Go/No-Go 审计快照纳入 ZIP。当前包 `bangdao-aug1-0.1.10-110-dc20b920-ops71f005c2.zip` 为 `192,926,422` 字节，SHA-256 `4391895420B50EBBD8CB87EA20AF71A70D5DABAD5003F5361A8B034CF7525BCA`；14 个条目及 `SHA256SUMS.txt` 中 13 个载荷逐条通过。旧无 operations 后缀包及中间 `ops861fa0ea`、`ops414af66e` 包仅保留追溯，不再作为当前交付包；运行时 APK/JAR 未重编。
- **2026-07-29，8 月 1 日 APK 生产接口兼容性只读核验，未发布**：线上与候选 `ruoyi-aihr` 均含 819 个非目录/非 Manifest 条目，0 个增删、775 个逐字节相同、44 个不同；短信登录、移动首页、查/练/问、直通车和 ASR/TTS 对应的 9 个关键控制器 class 哈希逐一相同。最新统一无登录 GET 探针得到公开首页业务码 `1×200`、鉴权入口 `6×401`、仅 POST 入口 `13×405`，没有触发短信、登录、业务 POST 或数据写入。44 个差异仅来自 `AihrModelSeedService`、`AihrPracticeSeedService`、`AihrSopSeedService` 及内部类，内容是禁止兜底文案冒充已创建/派发工单、阻止含占位内容或不完整五维评分的场景发布；因此现网接口壳可承接 APK，但候选业务语义红线仍需授权后定向发布后端。管理端/H5 与 schema 不属于该定向后端发布；本次没有执行生产同步、重启或数据库变更。
- **2026-07-26，阿里云百炼 ASR 生产热修复**：`POST /api/ai/asr` 新增 `dashscope/qianwen + qwen3-asr-flash` 的 `/compatible-mode/v1/chat/completions` + Base64 `input_audio` 分支，原 SiliconFlow `/audio/transcriptions` multipart 路径继续兼容，ASR 超时放宽至 30 秒。定向 Maven 测试 10 项通过；后端 JAR（SHA-256 `46c99cff75d21f8536a71c3c058b6437e99dbf9ff4bae3542b44471f3f34ad84`）已发布，生产 ASR 已切换至 `dashscope/qwen3-asr-flash`，旧 `siliconflow/TeleAI/TeleSpeechASR` 已停用。生产接口获得正确转写与受控 `ossId`，Android HBuilderX 标准基座“按住说话”请求成功，线上日志无 403/ASR 异常。回滚目录为 `/opt/wygj/backups/asr-hotfix-20260726210122`；本次未发布静态资源、未变更 schema，也不代表完整包一致性或原生 App 全项验收。
- **2026-07-26，移动端编译链升级与 uni-ui 解析修复，未发布**：本机 HBuilderX GUI 已升级为 `5.22.2026071707`，CLI 为 `5.22.2026072503-alpha`；`mobile-uni` 的 App、App-Plus、H5 与 Vite 编译包统一到对应的 `3.0.0-alpha-5020220260725001` 批次，消除 5.15/5.21 混用产生的两套 `uni-cli-shared` 状态隔离，使登录页 `<uni-forms>`、`<uni-easyinput>` 等组件重新由 `pages.json` easycom 规则正常解析。H5 与 App 均以 `Compiler version: 5.22（vue3）` 构建通过；浏览器和 vivo V2443A（Android 15）真机均确认手机号、验证码标签及输入框正常。HBuilder 5.22 标准基座 `versionName=15.22` 已自动更新并成功运行，测试手机号配合固定验证码登录成功，可进入员工首页并切换“问”页，未出现编译器/SDK 版本不匹配弹窗或组件解析告警。升级后仍须重建并安装 5.22 自定义运行基座完成原生权限全清单；`verify:app-release` 当前因缺少含正式法务 HTTPS 链接的 `androidPrivacy.json` 按预期阻断。本项未发布生产 H5，也未云打包 APK/IPA，手机上的 `com.yincheng.wygj` 正式包未被覆盖。
- **2026-07-26，全网 AI 本地库修复，未发布**：补齐 `reset-dev-db.sh` 遗漏的全网 AI 基表、数据库密钥和千问字段三项正式迁移，并增加迁移顺序及幂等回归，避免重置本地库后再次缺失 `aihr_web_search_provider`；当前本地库为 137 张表，管理端代理下的提供方列表接口验证通过。
- **2026-07-26，本地开发工具链，未发布**：补齐 `reset-dev-db.sh` 的 learning-closure 前置迁移，确保 `content_hash` 在训练成长迁移建索引前存在，并增加顺序回归检查；修复管理端 portless 包装在 Windows/Git Bash 下丢失 Vite 参数的问题。Windows 运行手册改为三个应用进程显式启动，两个 Vite 代理从 `portless list` 读取后端动态端口并直连回环地址，以规避 WSL `bash`、portless `0.15.4` 根目录批量启动差异及代理/TUN 对 Node.js `.localhost` DNS 的干扰。已在本地重建 `ry-vue` 为 130 张表，MySQL/Redis/MinIO/Qdrant、三个 portless 路由和管理端/移动端关键公开接口验证通过；未执行生产发布。
- 2026-07-25 23:56–2026-07-26 02:40 的 App-Plus 批次已提交但**尚未发布**：未构建云打包 App、未发布 H5、未发布后端 JAR、未重启服务。见下两节。

## 2026-07-26 16:41–16:57｜播报音色扩充、时长恢复与 HBuilderX 5.15 对齐

### 功能与修复

- 问模块快捷问题改为完整问句，减少短关键词被 Agent 当成不完整表达后再次澄清。
- “我”模块的 AI 播报音色在原有 4 个基础音色上新增 8 个 Qwen TTS 音色；服务端白名单同步放行，非法音色仍回落默认值。方言继续复用既有 21 项选择，并按租户与账号隔离保存。
- App-Plus 逻辑层没有浏览器 `Audio` 构造器；语音条时长改为直接解析 TTS `data:` URI 内的 MPEG Layer III 帧，支持 ID3v2、MPEG1/2/2.5、VBR 和 padding，远端 URL 仍使用宿主音频 API 兜底。
- App 编译链从 5.21 系列回退到本机 HBuilderX `5.15.2026070915` 内置版本：`@dcloudio/uni-app`、`@dcloudio/uni-app-plus`、`@dcloudio/vite-plugin-uni` 固定为 `3.0.0-alpha-5010220260604001`。`@dcloudio/uni-h5` 保留 5.21 系列，因为 5.15 H5 包缺少项目使用的 `Audio` 导出。

### 发布与验证

- **2026-07-26 16:41**：基于生产后端基线隔离构建并原子发布语音白名单 JAR，发布提交为 `bd196de6`，备份目录为 `/opt/wygj/backups/tts-voices-20260726164118-bd196de6`。服务恢复 `active`，健康检查 `200`，错误级别日志为空；生产 schema 仍为 `64/64`。本次只发布后端，没有覆盖更新中的生产 H5。
- **2026-07-26 16:46**：Android 真机发起新的“催费话术怎么说”请求，后端日志确认实际收到 `qwen-audio-3.0-tts-flash-longluxiaohui`、`dialect=shanghai`，3.503 秒生成 14 秒语音；这证明新音色参数已通过客户端、服务端白名单和模型链路，主观音色是否符合预期仍以人工试听为准。
- **2026-07-26 16:45–16:57**：真机实际复现“编译版本 5.21、手机端 SDK 5.15”弹窗。依赖与 HBuilderX 5.15 标准基座对齐后，App 与 H5 构建均通过，重新下发到同一 Android 设备后弹窗消失。该版本号是 uni-app 编译链/调试基座版本，不是 Android `minSdkVersion`。
- 本节完成层级为：音色后端已部署并完成生产请求链路验证；App 依赖对齐、时长解析和快捷问句已实现并完成本地构建/标准基座真机验证。**未重新云打包签名 APK/IPA，未发布 H5，未完成 Android/iOS 自定义基座全清单或人工音色验收。**

## 2026-07-26 02:35–02:40｜恢复 App 端回复语音优先

### 功能与修复

- **2026-07-26 02:38**（`d84ad87c`）：恢复 App 端回复的语音优先形态。`73712994` 用 `!isNativeAppRuntime()` 关掉原生端 TTS 预生成后，App 上每条回复都退化成纯文字气泡加 `播报` 按钮；语音条、`转文字`、`收起全文` 的模板与样式一直在包内但无法到达。现预生成在所有平台生效，消息以 `transcriptOpen: true` 建立，合成期间文字即可读，不必等一次 TTS 往返。

### 取舍与偏离

- **2026-07-26 02:38**：收起文字的触发点定为**开始播放**，不是合成完成。真机实测本地合成 2–6 秒即就绪，若按合成完成收起，文字会在读到一半时被抽走、只闪约 3 秒，与「不必等」的意图相反。新增 `transcriptPinned` 记录手动 `转文字`/`收起`/`收起全文`，自动收起不覆盖读者选择；不播放则文字一直可读。
- **2026-07-26 02:38**：`preparing` 语音条加 20 秒上限（对齐后端 DashScope 上游超时），超时按 `unavailable` 退化成纯文字加 `播报`，避免永久停在占位时长。该上限只结束界面等待态，**不中止**已发出的合成请求。
- **2026-07-26 02:38**：语音条显示 `语音` 而非微信式 `12"`。`measureAudioDuration` 依赖全局 `Audio`，App-Plus 逻辑层无该对象直接返回 `null`。属该形态既有缺口，非本次引入；修法需改走 `uni.createInnerAudioContext` 的 `duration`，因该函数被对练与摘要播报共用，**未改**。
- **2026-07-26 02:38**：`tests/agent.test.mjs` 中原断言以 `!isNativeAppRuntime()` 等源码字符串锁住旧行为，属同义反复，已换为行为断言：语音优先不依赖平台、合成完成不得收起文字、播放才收起、超时有兜底。

### 验证与边界

- **2026-07-26 02:40**：`vue-tsc --noEmit` 通过；前端单测 `168/168` 通过。`build:app` 按产物核验含 `app-service.js`、`app-renderjs.js`、`manifest.json`，不以 `DONE Build complete.` 为准。
- **2026-07-26 02:40**：真机取样（包推 `__UNI__B36D8BE` 后重启基座）：3 秒为 `…` 合成中加红点、文字可读、`收起全文 ▲`；12 秒语音就绪而文字仍在；点播放后文字收起、红点清除；26 秒回到空闲，未复现挂死。
- **2026-07-26 02:40**：**未验证**音频是否真实出声——状态机走完整链路，但设备音频输出无法取证，需人工试听。
- **2026-07-26 02:40**：本节完成层级为「已实现、已本地验证、已提交」。**未构建云打包 App、未发布 H5、未发布后端 JAR、未重启服务**。
- **2026-07-26 02:40**：排障口径修正。`adb exec-out screencap -p` 的 PNG 直接读取会静默返回空内容，若据此描述界面会得出凭空结论；本批已改为先 `sips` 转换/裁剪再读。据此撤回两条当时证据不支持的口头结论：「App 端 TTS 挂死」（实测本次 2–6 秒合成成功）与「该次失败点击由 SDK 弹窗吞掉」（该轮取证画面未显示弹窗，点击落空系启动时序）。16:45 的后续冷启动已独立复现版本弹窗并完成修复，见上文。

## 2026-07-25 23:56–2026-07-26 00:02｜App-Plus 实时对练与构建链修复

### 构建链修复（本批最重要）

- **2026-07-25 23:56**（`a3a5cf94`）：修复 `npm --prefix mobile-uni run build:app` 长期**假绿**。`@dcloudio/uni-app-plus` 从未被声明为依赖，缺少该编译器时 `uni build -p app` 不报错、退出码 `0`、照样打印 `DONE Build complete.`，但产物只有 `index.html`（仍带 H5 的 `/h5/assets/...` 基路径）、字体和一个 `704` 字节 preload 片段，没有 `app-service.js`、`app-renderjs.js`、`manifest.json`。
- **2026-07-25 23:56**：因 `docs/MOBILE_APP_PACKAGING.md` 把该命令列为本地验证步骤，本批 renderjs 实时对练代码在装上编译器之前**从未经过 App 编译器**，却曾被当作已验证。本次已按同版本 `3.0.0-alpha-5020120260710001` 声明编译器，在 `tests/app-packaging.test.mjs` 加版本对齐闸门，并在打包文档写明：判定 `build:app` 成功只看产物是否含 `app-service.js`、`app-renderjs.js`、`manifest.json`，不看 `DONE Build complete.`。

### 功能与修复

- **2026-07-25 23:58**（`5cf7ce58`）：实时对练支持 App-Plus。媒体与 WebRTC 引擎移入 `realtime-browser-engine.js`，由 `components/practice/RealtimePracticeAppBridge.vue` 的 renderjs 脚本在系统 WebView 内执行；认证的 SDP 交换与 `search_knowledge` 工具调用仍留在逻辑层代理，access token 不下放视图层。H5 路径行为不变。
- **2026-07-25 23:56**（`27f4cdac`）：部分 uni-app 平台忽略 `uni.request` 的 `timeout`，导致 Promise 永挂、页面无错误出口。改为本地驱动超时，单次 `finish` 守卫保证只 settle 一次，超时先 `task.abort()` 再 reject。
- **2026-07-25 23:57**（`3055d2be`）：替换 App-Plus 不支持的两个 API。`URLSearchParams` 在 App-Plus JS core 缺失，`toLocaleDateString('sv-SE', { timeZone: 'Asia/Shanghai' })` 依赖 App 运行时未附带的完整 ICU 数据，二者曾让工作成果页拼出错误查询串或取到设备本地日期。改为 `encodeURIComponent`，业务日统一走 `currentShanghaiDate()` 固定 UTC+8 偏移；Asia/Shanghai 无夏令时，固定偏移是精确值而非近似。
- **2026-07-25 23:58**（`73712994`）：原生 App 不再预生成答案 TTS。此前消息以 `preparing` 建立，文字被卡在等待一次 TTS 往返之后；改为原生端标记 `unavailable` 让文字与引用立即渲染，语音由既有 `unavailable` 分支的播放按钮按需触发，不是取消语音。H5 仍保留预生成。
- **2026-07-25 23:58**（`7b014765`）：Agent 追问不再答成澄清。规划器在无关键词命中且模型规划不可用/不合法时回落 `CLARIFY`，导致「如果我要报销，一般需要查哪几个文件？」这类已有上下文的追问被要求澄清。现非媒体请求带 `conversationId` 且 `contextVersion > 0` 时改走 `KNOWLEDGE_QA` 接地检索。**取舍**：第二轮起对「你看着办」「帮我处理一下」这类刻意模糊表述的主动澄清也一并被抑制，会改为执行知识检索；空输入仍由 `requireQuestion` 提前拒绝。
- **2026-07-25 23:58**（`c9f5271d`）：补记 `30ef6a8f` 已发布的 `/api/aihr/org/sync-changes` 增量同步契约到 `AGENTS.md` 与 `docs/API_INTEGRATION.md`（稳定 `employee.id` 主体键、先 `dryRun=true` 后同起点 `dryRun=false`、全量 `/sync` 对脱敏手机号与重复成员关系 fail-closed）。仅文档，无代码变更。
- **2026-07-25 23:59**（`4fc0c1f5`）：App 版本升至 `0.1.5`（`versionCode 105`）。原生权限与插件未变，属常规云打包重建。

### 验证与边界

- **2026-07-26 00:01**：`vue-tsc --noEmit` 通过；前端单测 `162/162`、后端 `694/694` 通过。后端须显式加 `-DskipTests=false`——`backend/pom.xml` 第 60 行把 `skipTests` 默认设为 `true`，不带该参数的 `mvn test` 是空跑且照样输出 `BUILD SUCCESS`，与上面 `build:app` 是同类假绿。
- **2026-07-26 00:01**：`build:app` 在补齐编译器后产出真实 App 包，并按产物核实分层：`RTCPeerConnection` 与 `getUserMedia` 只出现在 `app-renderjs.js`，`realtime/sdp` 端点只出现在 `app-service.js`，renderjs 侧 `0` 命中。
- **2026-07-26 00:02**：以上仅证明 App 平台可正确编译且分层正确。麦克风授权、实时转写、远端语音播放、前后台切换、断线降级只能在真机 WebView 验证，**未验证**；口径已写入 `docs/MOBILE_APP_PACKAGING.md` 与 `docs/MOBILE_APP_DEVICE_ACCEPTANCE.md`。
- **2026-07-26 00:02**：本批完成层级为「已实现、已本地验证、已提交」。**未构建云打包 App、未发布 H5、未发布后端 JAR、未重启服务、未执行 schema 迁移**；`7b014765` 的 Agent 追问修复需后端 JAR 发布后才在生产生效。

## 2026-07-25 15:40–16:15｜组织姓名与考试发布修复

### 生产数据修复

- **2026-07-25 15:40**：在 `/opt/wygj/backups/org-name-sync-20260725-1540/org-data.sql` 备份生产组织数据；备份大小 `711248` 字节，SHA-256 为 `9e298bf5e6ac88b6d0e105f510cad3fb9838ed1cf0324a23ee15453a54e3c9dd`。
- **2026-07-25 15:40–15:48**：刷新开放组织目录并将租户 `000000` 绑定到集团根节点 `G:1`。仅按稳定 `employee_id` 精确匹配，补齐 `aihr_org_snapshot.person_name` 共 `3417` 行；未改手机号、项目、岗位和在职状态。
- **2026-07-25 15:48**：生产复核为组织快照 `3417` 行、在职 `2938` 人、在职有姓名 `2938` 人、手机号映射 `3392` 个。使用既有生产主管账号调用团队接口返回 `2316` 名成员，姓名完整 `2316` 名、编号兜底 `0` 名；账号、手机号、验证码和 Token 未写入仓库、截图或本记录。
- **2026-07-25 15:48**：未执行全量组织覆盖。只读预检发现上游 `3424` 名员工中 `3398` 个手机号已脱敏、存在 `1` 条重复项目成员关系，并且当前 `employee_number` 仅能匹配生产既有主体 `7/3417`，稳定 `employee_id` 可匹配 `3417/3417`。在身份字段契约和手机号通道修复前，禁止用 `allowPartialReplace=true` 绕过后执行覆盖同步。

### 考试发布修复

- **2026-07-25 15:55**：移除客户端“考试名称至少 4 个字”的无依据限制，改为仅要求名称非空；同时保留及格分 `1–100`、至少一道题、总分 `100`、题干/选项/答案完整和至少选择一名员工的发布校验。备份当时生产 H5 到 `/opt/wygj/backups/h5-exam-title-20260725-1555/` 后完成首次静态发布。
- **2026-07-25 16:09**：复核发现 `16:01` 的后续 H5 发布重新带入旧 `length>=4` 校验；该次覆盖被识别为生产回退，未将 `15:55` 的短暂上线状态作为最终完成。
- **2026-07-25 16:12**：基于当前主线 `75469b85` 重新构建 H5，保留已发布的陪练“建议回复”功能并叠加考试修复；发布前备份到 `/opt/wygj/backups/h5-exam-restore-20260725-1612/`。生产入口更新为 `/h5/assets/index-QQ2kC1xm.js`，考试页资源为 `/h5/assets/pages-supervisor-exams-edit.B-v9k7L-.js`。

### 验证与边界

- **2026-07-25 16:12**：目标回归 `5/5`、`vue-tsc --noEmit` 和 `npm --prefix mobile-uni run build:h5` 通过；生产考试资源包含“请填写考试名称”和“发布前请至少选择 1 名员工”，不再包含旧 `length>=4` 校验。
- **2026-07-25 16:14**：在生产 H5 `390×844` 视口使用隔离浏览器会话和两名模拟员工完成无写入验收；考试名“测试”可通过名称校验，员工姓名正常显示，“发布给 2 人”按钮启用，未调用保存或发布接口。
- **2026-07-25 16:15**：本次结论为：姓名数据修复已生产验证，考试校验已实现、已本地验证、已重新部署并完成生产 H5 浏览器验证；未执行后端 JAR 发布、服务重启、schema 迁移或全量组织覆盖。对应两处考试源码改动仍在工作区，尚未提交。

## 2026-07-25 15:44–16:05｜陪练建议回复

### 功能更新

- **2026-07-25 15:44:45**：完成常规陪练“建议回复”（提交 `acd5fd3a`）。“用这句话回复”改为由 LLM 根据当前会话、回合和老师傅提示生成一条员工可直接回复的新话术，不再复制指导语。
- **2026-07-25 15:44:45**：移动端将 LLM 生成结果只填入输入框，由员工修改后主动发送；生成期间禁用重复点击，接口失败时显示明确错误。
- **2026-07-25 15:44:45**：服务端在既有训练会话归属和身份校验内生成建议回复，不推进训练回合、不改写训练证据；普通训练回合继续保留模型失败时的 seed 降级。
- **2026-07-25 15:44:45**：训练 `/turn` 接口新增 `suggestReply` 请求参数和 `suggestedReply` 响应字段，并保留旧请求、旧响应构造方式兼容。

### 生产发布

- **2026-07-25 15:52:03**：备份生产后端 JAR 与完整移动端 H5，备份目录为 `/opt/wygj/backups/practice-reply-20260725155203-acd5fd3a`。
- **2026-07-25 15:52:45**：将提交 `acd5fd3a` 构建的后端 JAR 原子切换到 `/opt/wygj/app/ruoyi-admin.jar`；本次功能不涉及数据库结构变更。
- **2026-07-25 15:53:16**：重启 `wygj-aihr.service`；Spring Boot 于 `15:53:35` 完成启动。
- **2026-07-25 16:01:13**：将隔离工作树构建的移动端 H5 最终同步到 `/opt/wygj/www/h5`，生产入口固定为 `/h5/assets/index-BDNPeJuO.js`。
- **2026-07-25 16:01–16:02**：完整生产预检通过，确认管理端与移动端静态资源匹配、AIHR 后端模块匹配、schema `64/64`、运行时 schema bootstrap 关闭。

### 线上验证

- **2026-07-25 16:02–16:04**：从生产组织快照只读选择手机号与外部 ID 双向唯一的在职保洁员工，先请求短信验证码再登录；账号值未写入终端输出、截图、报告或仓库。
- **2026-07-25 16:04:03**：在 `390×844` 视口走完场景启动、员工回复、老师傅提示和“用这句话回复”主路径；LLM 生成新的员工话术并填入输入框，没有自动发送，也没有复制老师傅提示，输入框和发送按钮显示完整。
- **2026-07-25 16:04**：发布后复核 `wygj-aihr.service` 为 `active`，自 `15:52:00` 起错误级别日志为 `0`，生产 H5 仍返回 `/h5/assets/index-BDNPeJuO.js`。

### 验收边界

- **2026-07-25 16:04**：本次结论为：**已实现、已部署、已完成生产 H5 浏览器验证**。
- **2026-07-25 16:04**：本次验证不替代 Android/iOS 真机验收，也不代表正式试点窗口、业务内容审核或严格试点指标已经通过。

## 2026-07-25 15:18–15:42｜公司文件多岗位解读

### 功能更新

- **2026-07-25 15:18:58**：完成公司文件多岗位解读代码收口（提交 `230dfb4d`）。管理端上传文件并完成正文提炼后，异步生成有原文依据的岗位视角；单个视角包含岗位名称、解读内容、行动建议和原文短引用。
- **2026-07-25 15:18:58**：管理端增加解读状态展示，明确区分“正在生成、已完成、部分完成、生成失败”，并展示已经生成的岗位名称。解读失败不阻断文件摘要、原文件下载、消息发布或消息追问。
- **2026-07-25 15:18:58**：员工端消息详情增加“多岗位解读”。系统优先展示与认证员工岗位匹配的视角；员工可切换查看其他已生成视角，并展开对应的原文依据。
- **2026-07-25 15:18:58**：服务端重新校验租户、登录身份、在职身份、消息状态和附件归属。消息撤回后，员工列表、详情、原文件和后续追问均不再允许访问。

### 数据库更新

- **2026-07-25 15:25–15:26**：生产表 `aihr_broadcast_attachment` 新增 `insight_status`、`insights_json`、`insight_version` 三个字段，并新增 `(insight_status, status, update_time)` 异步队列索引。
- **2026-07-25 15:25–15:26**：迁移仅新增多岗位解读字段和队列索引，不回填历史文件、不修改既有文件 `READY` 状态，也不改变历史消息的发布或撤回状态。

### 生产发布

- **2026-07-25 15:24:06**：完成生产数据库、后端 JAR、管理端和移动端 H5 备份，备份目录为 `/opt/wygj/backups/broadcast-insights-20260725152349`。
- **2026-07-25 15:26:32**：部署新后端 JAR、管理端静态资源和移动端 H5。
- **2026-07-25 15:26:33**：`wygj-aihr.service` 重启并恢复为 `active`。
- **2026-07-25 15:27–15:30**：完整发布预检通过。管理端与移动端静态资源、生产后端 JAR 和 `ruoyi-aihr` 模块哈希均与本地构建一致；生产 schema 为 `64/64`，公司文件附件契约为 `15/15`。

### 线上验证

- **2026-07-25 15:31:52**：管理端上传生产验收 TXT 文件，文件提炼状态进入 `READY`。
- **2026-07-25 15:32:15**：多岗位解读生成完成，共生成“生活顾问/客服、人力、审计/风控、管理层”四个视角，结果状态为 `READY`，规则版本为 `role-perspective-v1`。
- **2026-07-25 15:32:34**：发布全员可见的生产验收消息。
- **2026-07-25 15:38–15:39**：使用生产数据库中的在职员工手机号完成员工端登录验证。在 390×844 视口下验证消息列表、消息详情、四视角切换、行动建议和原文依据展开，未发现横向溢出、内容遮挡或核心入口下沉。
- **2026-07-25 15:39:33**：通过员工端受控入口下载原文件，下载文件 SHA-256 与管理端上传文件完全一致。
- **2026-07-25 15:40:04**：验收完成后撤回测试消息并保留审计原因。
- **2026-07-25 15:40:13–15:40:41**：复核员工端列表不再展示该消息，原详情地址返回“消息不存在或已撤回”。
- **2026-07-25 15:42:11**：更新生产事实文档（提交 `9a34a267`），源码与发布记录已同步至远端 `main`。

### 验收边界

- **2026-07-25 15:42:11**：本次结论为：**已实现、已部署、已完成生产 H5 浏览器验证**。
- **2026-07-25 15:42:11**：本次验证不替代 Android/iOS 真机验收，也不代表正式试点窗口、业务内容审核或严格试点指标已经通过。
- **2026-07-25 15:42:11**：生产验收消息已经撤回；仅保留发布、阅读、下载和撤回审计记录。