root/airz-uniapp
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

feat: 完成原型04-10全链路功能开发，包括AI助手、PDF导出等

Browse Source
This commit is contained in:
hujun
2026-09-28 17:50:46 +08:00
parent 7c252fc730
commit 79feb03b19
27 changed files with 1083 additions and 180 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/开发进度.md
+125 -18
View File
@@ -1,6 +1,8 @@
# AI 融资平台开发进度
基线日期：2026-09-22。文档版本：1.14。最新规划及实施见0.16节与6.17节；此前章节保留阶段记录。技术方案和接口说明见[开发文档](./开发文档.md)。本台账现有63项任务，编号与开发文档保持一致。
基线日期：2026-09-22。文档版本：1.18。最新规划及实施见0.20节与6.21节；此前章节保留阶段记录。技术方案和接口说明见[开发文档](./开发文档.md)。本台账现有63项任务，编号与开发文档保持一致。
会话交接（2026-09-28）：已整理[新会话交接](新会话交接.md)，包含当前成果、验证边界、业务约定、代码入口和环境状态。原型08、10及09 PDF已完成本地实施，当前边界见0.18—0.20与6.19—6.21节；下一步为真实模型语义、产品与跨平台验收。
## 0. 2026-09-22 首轮实施更新（优先于初始基线）
@@ -175,6 +177,46 @@ REPORT-004页面子项完成本地联调：report/report改为评估概况、匹
继续无草稿。“重新评估”选择个人/企业并清空当前流程内存，进入空白填写页；只有再次正式提交才创建新assessmentId。页面仍26个，未改后端业务、未迁移、未调用收费模型。PDF（REPORT-005）、下一步行动（REPORT-006）与上下文助手按独立任务推进，未展示虚假可用按钮。REPORT-004整体仍开发中，真实产品/外部渠道与微信内H5、真机尚未验收；证据见开发进度6.17。
### 0.17 2026-09-28 原型04/05与单产品AI解释
本轮优先完成04、05，复用product/product的eligible/ineligible/unknown三种状态。按原型恢复紧凑机构信息、AI解释/产品详情/申请条件三栏、绿色序号理由、橙色注意事项和底部双按钮；额度/年化/期限移入产品详情。每组默认最多三条，可展开全部和逐条依据。非候选的绿色区域称“已满足的条件”，不把部分满足理解为推荐。无真实Logo时沿用通用机构图标，演示产品保留标记。
新增已实现POST `/api/v1/assessments/:id/matches/:productId/explanation`，Bearer鉴权，JSON体仅`requestId:string`（8—64位字母/数字/下划线/短横线）；HTTP200回传与GET匹配详情相同的data，异步状态为queued/running/completed/failed，首次未请求为not_requested。GET只读；仅点击生成/重试调用POST，不自动重跑评估。状态和逐条解释保存在fa_ai_chat.match_result，fa_ai_chat_log预留并记录调用，无新表和迁移。完整接口与故障边界见[产品匹配契约第9节](产品匹配规则开发契约.md)。
复用analysis:work消费持久调用日志；同产品并发/成功缓存/相同请求键重放不重复调用，每评估每产品最多三次尝试，与报告共用每日用户调用额度。租约失效明确失败，手动新键重试；旧回复只补用量，不覆盖新任务。DeepSeek仅解释该产品冻结理由，逐条引用由服务端绑定；模型输出允许调整顺序，按理由ID校验无缺失/重复/外来项后恢复规则顺序。禁止模型输出数值与授信承诺。
已完成本地验证，PRODUCT-004整体仍开发中；原工时/依赖与63个任务编号不变。原型08上下文咨询和10行动页未完成，当前底部为产品对比、产品详情及资料准备说明，不提供假咨询/假申请。真实产品/人工业务金标准、微信内H5/Safari及真机仍待验收。
### 0.18 2026-09-28 原型08上下文AI助手
CHAT-001—003已实现持久会话、消息分页、固定评估/产品上下文、异步回复、原键重试和页面接入，状态待验收；CHAT-004本地异常/额度检查通过，整体仍开发中。普通问答及04/05产品、07对比、09报告入口已接通，进入页面不调用模型，快捷问题只填入输入框。关键实现增加中文注释，保留26个页面和63项任务。
经本轮用户明确授权，后端fa_ai_chat新增context_assessment_id/context_data及归属约束，正式assessment_id/analysis_context和已有报告不改写。模型调用默认Flash，复用analysis:work，助手/报告/产品解释共用每日预留额度。完整接口、重试、迁移恢复和验证见[上下文AI助手开发契约](上下文AI助手开发契约.md)。下一步为原型10及09 PDF；08真实多轮语义/真机与生产容量仍需验收。
### 0.19 2026-09-28 原型10下一步行动
REPORT-006页面与入口已完成本地联调，状态待验收。新增`packages/finance/next-step/next-step`，当前27个页面、63项稳定任务。界面按原型采用白底、蓝色图标、四个行动行、重要提示和首页按钮；关键守卫与业务边界有中文注释。
本人成功报告与冻结产品只读展示；仅eligible且当前available展示申请准备材料，进入/返回/刷新重新读取状态，快照不一致时关闭准备。未选产品回本次匹配，不符/待核实/不可用可查看报告、优化资料与咨询。材料与来源使用冻结数据，渠道未提供时明确说明，不提交银行申请、不增加PDF假操作。
优化资料先展示待补/待核实项与已存建议，再清空流程内存进入同类型空白表单；不覆盖历史。AI咨询携带评估和可选产品，进入不发送。支持白名单登录返回、归属复验、离页清空及迟到响应隔离；冷启动返回本次报告，首页reLaunch。
H5 Chromium手机/桌面38项检查与最终Android/微信编译通过；详见进度6.20。复用已有API，未改后端业务、未迁移、未调用收费模型。下一步为09 PDF；08真实多轮语义、真实产品、微信内H5/Safari和真机仍未验收。
### 0.20 2026-09-28 原型09报告PDF导出
REPORT-005完成本地实施，状态待验收。09报告顶部与10行动页接入同一下载组件；用户点击后才以Bearer请求`GET /api/v1/assessments/:id/report.pdf`，不提供永久公开链接、不重跑模型、不修改已存报告或产品。27页、63项任务不变。
后端复用本人成功报告与全部冻结匹配快照，模板包含需求、概况、结构化事实、完整度/准备状态、匹配三态/产品理由、建议、版本、时间和免责声明；旧v1不补造v2指标。排除身份、联系方式、企业名和自由填写内容，纯文本转义；引擎禁止远程资源、脚本和任意文件读取。精确元字符串转万元，PDF中文字体嵌入，页脚编号、长理由分页。
导出引擎Dompdf3.1.6及传递依赖单独锁定在后端extend/report-pdf，中文Noto Sans SC Sans2.004固定400字重、字体来源/哈希/许可入库；根依赖不变，无迁移。成功响应application/pdf、no-store/private、安全文件名；401/404/409/503为JSON。引擎缺失/关闭明确503，不生成空文件。
H5检查状态、MIME及PDF首尾标识后创建Blob下载；失败可重试且保留报告，离页取消、换账号拒绝迟到文件并清空旧报告，401白名单回登录。首版普通H5开放；微信内浏览器提示“在浏览器打开并重新登录下载”，App/小程序明确未开放，不假报成功。真实Safari/微信/原生下载未验收。
29项PDF检查、20项真实HTTP检查、24项浏览器检查及Android/微信编译通过，样本渲染和文字提取通过；证据与局限见开发进度6.21。下一步为08真实多轮语义、真实产品样例及跨浏览器/真机验收，生产导出容量仍需评估。
## 1. 项目状态与维护规则
当前已具备25个页面原型、部分本机交互、优化后的数据库结构和评估内部生命周期服务；密码账户基础已完成本地前后端联调，短信、评估、报告、匹配等完整业务仍待完成。AI供应商确定为DeepSeek，模型已确定为deepseek-v4-pro-0813和deepseek-v4-flash-0731，两个模型权限及自填报告已真实验证，商业预算、余额及生产容量仍待核验；其他服务商待定。
@@ -244,9 +286,9 @@ P0 表示核心流程、安全、首发外部能力或发布门槛；P1 表示
| 编译与页面金额检查 | 上一轮 Web 与 Android 编译通过；手机 390×844、桌面 1280×900 浏览器检查金额输入、超限、确认、模拟提交和产品显示 | [前端 README](../README.md)、[页面注册](../pages.json)；前序任务会话验证记录 | 不是短信/AI/上传真实联调；无 iOS/Xcode 或 Android 真机上线结论；独立历史日志路径未留档，后续回归须新增证据 |
| 迁移与恢复基础 | 本机迁移及仓库外备份已完成 | [数据库迁移说明](D:/AAdesk/202609/airz/database/README.md) | 旧迁移限定业务空表，不得直接用于已有业务数据环境；未完成通用部署和恢复演练 |
### 2.2 全部 26 个页面的验收归属
### 2.2 全部 27 个页面的验收归属
页面路径以[pages.json](../pages.json)为准。下表记录页面真实业务的主要收口任务；其内部依赖仍需全部完成。当前 26 页均未通过一期真实业务验收。
页面路径以[pages.json](../pages.json)为准。下表记录页面真实业务的主要收口任务；其内部依赖仍需全部完成。当前 27 页均未通过一期真实业务验收。
| 页面 | 注册路径 | 主要任务 | 当前状态 |
| --- | --- | --- | --- |
@@ -257,9 +299,10 @@ P0 表示核心流程、安全、首发外部能力或发布门槛；P1 表示
| 分析中 | packages/finance/analyzing/analyzing | REPORT-004 | 按assessmentId轮询状态、失败重试、成功后打开真实报告 |
| 评估报告 | packages/finance/report/report | REPORT-004 | 三栏已接本人冻结报告、匹配候选与改善证据；真实业务及平台验收未完成 |
| 匹配结果 | packages/finance/matches/matches | PRODUCT-004、REPORT-004 | 已接本人冻结结果、三态/分页及对比选择；演示产品联调 |
| 产品详情 | packages/finance/product/product | PRODUCT-004 | 已接历史理由/证据和参数、对比入口；单产品AI解释待开发 |
| 产品详情 | packages/finance/product/product | PRODUCT-004 | 已接原型04/05、历史理由/参数、逐条DeepSeek解释与失败重试；08咨询待接 |
| 产品对比 | packages/finance/compare/compare | PRODUCT-005 | 2—3项冻结对比本地联调通过，真实产品与平台待验收 |
| AI 助手 | packages/finance/assistant/assistant | CHAT-004 | 模拟对话 |
| 下一步行动 | packages/finance/next-step/next-step | REPORT-006 | 四项行动与上下文/返回本地联调通过，真实产品及平台待验收 |
| AI 助手 | packages/finance/assistant/assistant | CHAT-004 | 持久上下文对话已本地联调，真实语义/真机待验收 |
| 融资档案 | packages/finance/archive/archive | ASSESS-004、REPORT-004 | 本人历史分页、脱敏只读详情、刷新恢复 |
| 启动引导 | packages/account/index/index | BASE-003、AUTH-002 | 原型/本机引导 |
| 登录 | packages/account/login/login | AUTH-002、LOGIN-004 | 未完成真实认证 |
@@ -432,7 +475,7 @@ DEC-DEMAND已确认并发布，需求录入/提交/历史子范围已实现；
| PRODUCT-001 | 全栈开发（待指定） | 发布规则与人工样例可审阅；非法字段/操作符阻止发布；fail优先于unknown，匹配指标不作为审批概率。 | 首版字段/操作符/来源门槛已形成规则契约；64项内存测试；真实产品发布依据与业务样例待验收 | 2026-09-24 |
| PRODUCT-002 | 全栈开发（待指定） | 同输入/快照结果稳定；未知不当满足，配置错误不归咎用户；需求不拆额、不改期；未运行与零候选区分。 | 目录冻结/排序/理由已接正式worker；51项内存和19项任务测试通过；真实产品金标准、规模/生产验收仍待完成 | 2026-09-24 |
| PRODUCT-003 | 全栈开发（待指定） | 产品用途/地区/额度/期限有真实依据；规则可配置并启停，版本变化留依据；公共详情无个人分数。 | 发布预检及模型保存已实现；本地6条演示产品已授权上架，重复录入不覆盖；公共详情已接；真实资料/发布验收、结构化编辑和公共列表待完成 | 2026-09-24 |
| PRODUCT-004 | 全栈开发（待指定） | 每条解释可追溯且不凑三正三反；当前产品变化不改历史；跨账户拒绝；unavailable/零候选/failed不混淆。 | 匹配分页/详情和03/04/05/06基础已接；62项HTTP/快照检查及H5验证见6.13；单产品AI解释、真实业务验收待完成 | 2026-09-24 |
| PRODUCT-004 | 全栈开发（待指定） | 每条解释可追溯且不凑三正三反；当前产品变化不改历史；跨账户拒绝；unavailable/零候选/failed不混淆。 | 原型04/05和逐条DeepSeek解释本地完成；51项任务/输出检查、70项HTTP/快照检查与浏览器验证见6.18；真实机构资料及平台验收待完成 | 2026-09-28 |
| PRODUCT-005 | 全栈开发（待指定） | 不跨评估/混用现价；缺值不同于0；手机横向表格可读，单项失败明确；不重跑模型。 | compare页面及6.16本地编译/真实读取与异常注入证据；真实机构产品和微信内H5/真机待验收 | 2026-09-28 |
剩余门槛：DEC-MATCH开发口径已采用既有契约，真实产品规则/金标准业务签收待完成；PRODUCT-003真实发布仍依赖DEC-PRODUCT。纯规则、后台模型预检及字段编译已实施，未解除整模块验收依赖。
@@ -447,8 +490,8 @@ DEC-DEMAND已确认并发布，需求录入/提交/历史子范围已实现；
| REPORT-002 | 异步任务与补偿 | 保留Redis派发、补投、租约和taskId隔离；沿用提交时input_snapshot，一次性补入execution_snapshot并在重试时复用，支持跨部署v1/v2任务。 | P0 | ASSESS-003、REPORT-001 | 2.5–4 | 开发中 |
| REPORT-003 | 报告生成与持久化 | 保留v1自填报告；补v2需求、完整度/准备等级、规则证据及定性AI区块；版本快照和正式结果原子落库。 | P0 | REPORT-002、DATA-004、PRODUCT-002、PRODUCT-003、DEC-MATCH、DEC-READINESS | 2–3 | 阻塞 |
| REPORT-004 | 分析报告历史联调 | 保留轮询/重试和v1历史；接v2需求、完整度、准备等级、三态匹配及证据解释，不显示无规则分数/雷达。 | P0 | REPORT-003、PRODUCT-004、ASSESS-004 | 2–3 | 开发中 |
| REPORT-005 | 报告PDF导出 | 鉴权流式下载、受控中文模板、报告与产品冻结快照、H5保存与失败提示。 | P1 | REPORT-004 | 2.5–4 | 未开始 |
| REPORT-006 | 下一步行动 | 新增next-step页，准备材料、查看已存报告、优化资料、新评估、咨询及首页导航。 | P1 | PRODUCT-004、REPORT-004、CHAT-003 | 1–2 | 未开始 |
| REPORT-005 | 报告PDF导出 | 鉴权流式下载、受控中文模板、报告与产品冻结快照、H5保存与失败提示。 | P1 | REPORT-004 | 2.5–4 | 待验收 |
| REPORT-006 | 下一步行动 | 新增next-step页，准备材料、查看已存报告、优化资料、新评估、咨询及首页导航。 | P1 | PRODUCT-004、REPORT-004、CHAT-003 | 1–2 | 待验收 |
| 任务编号 | 负责人 | 验收条件 | 证据 | 更新时间 |
| --- | --- | --- | --- | --- |
@@ -456,8 +499,8 @@ DEC-DEMAND已确认并发布，需求录入/提交/历史子范围已实现；
| REPORT-002 | 全栈开发（待指定） | 漏投/中断可恢复或明确失败；旧任务不可回写；输入/目标结果/策略/产品快照重试不隐式变化。 | 54项报告检查覆盖目标版本冻结、超时重试快照不变、旧v2输入仍v1、损坏快照先于模型失败；产品快照/生产守护未完成，旧29项任务证据保留 | 2026-09-24 |
| REPORT-003 | 全栈开发（待指定） | 完整度按发布字段集复算，等级有依据且非审批；null rank/score按状态验证；格式错误不成功，产品/规则更新不改旧报告。 | v2自填支线已实现；本轮58项回归及Flash3例/Pro1例真实样例通过；真实产品/外部查询、生产与业务人工签收待完成 | 2026-09-24 |
| REPORT-004 | 全栈开发（待指定） | 个人/企业真实链路按版本展示；未发布无分或等级，100%不等于授信；旧报告不重算；新复评新assessmentId。 | 6.17三栏/局部重试/旧版/权限及生命周期验证；真实产品与外部渠道仍待验收 | 2026-09-28 |
| REPORT-005 | 全栈开发（待指定） | 本人成功报告可导出；金额/理由与历史一致；不重跑模型/泄露身份；中文分页可读，JSON错误不保存成PDF。 | 04—10方案定义导出接口与失败/隐私边界；PDF引擎及中文字体待选型锁定，未生成样本 | 2026-09-24 |
| REPORT-006 | 全栈开发（待指定） | 根据判定及当前可用性开放行动；无银行申请提交；新评估不改历史、无草稿；上下文和返回正确。 | 04—10方案已定义全部按钮去向和条件，尚未注册路由/实施页面 | 2026-09-24 |
| REPORT-005 | 全栈开发（待指定） | 本人成功报告可导出；金额/理由与历史一致；不重跑模型/泄露身份；中文分页可读，JSON错误不保存成PDF。 | 鉴权接口/H5导出已实施，29项PDF＋20项HTTP＋24项浏览器检查通过；跨浏览器/真机和生产容量待验收，见6.21 | 2026-09-28 |
| REPORT-006 | 全栈开发（待指定） | 根据判定及当前可用性开放行动；无银行申请提交；新评估不改历史、无草稿；上下文和返回正确。 | 27页已注册；38项H5流程/边界检查、Android/微信编译通过，真实产品与平台待验收，见6.20 | 2026-09-28 |
剩余依赖：REPORT-001商业预算/生产额度待DEC-AI；REPORT-003完整报告仍依赖DATA、PRODUCT、DEC-MATCH；DEC-READINESS首版开发策略已发布，人工业务验收待完成。模型真实权限已验证。
@@ -467,17 +510,17 @@ DEC-DEMAND已确认并发布，需求录入/提交/历史子范围已实现；
| 任务编号 | 任务 | 范围 | 优先级 | 直接依赖 | 预计人日 | 状态 |
| --- | --- | --- | --- | --- | --- | --- |
| CHAT-001 | 会话与消息API | 普通会话创建/列表/消息分页/归属；明确可引用评估上下文且不占用正式assessment_id。 | P1 | AUTH-002、BASE-001 | 1–1.5 | 未开始 |
| CHAT-002 | DeepSeek对话调用 | 上下文裁剪、敏感信息最小化、消息幂等、异步回复与本地配额记录。 | P1 | CHAT-001、REPORT-001、REPORT-002 | 1–2 | 未开始 |
| CHAT-003 | 助手页面接入 | chatId/requestId、历史加载、发送状态、失败重试、由报告进入解释上下文。 | P1 | CHAT-002、REPORT-004 | 1–2 | 未开始 |
| CHAT-004 | 对话异常与额度验收 | 并发消息、重复点击、额度耗尽、供应商超时及失效会话。 | P1 | CHAT-003 | 1–1.5 | 未开始 |
| CHAT-001 | 会话与消息API | 普通会话创建/列表/消息分页/归属；明确可引用评估上下文且不占用正式assessment_id。 | P1 | AUTH-002、BASE-001 | 1–1.5 | 待验收 |
| CHAT-002 | DeepSeek对话调用 | 上下文裁剪、敏感信息最小化、消息幂等、异步回复与本地配额记录。 | P1 | CHAT-001、REPORT-001、REPORT-002 | 1–2 | 待验收 |
| CHAT-003 | 助手页面接入 | chatId/requestId、历史加载、发送状态、失败重试、由报告进入解释上下文。 | P1 | CHAT-002、REPORT-004 | 1–2 | 待验收 |
| CHAT-004 | 对话异常与额度验收 | 并发消息、重复点击、额度耗尽、供应商超时及失效会话。 | P1 | CHAT-003 | 1–1.5 | 开发中 |
| 任务编号 | 负责人 | 验收条件 | 证据 | 更新时间 |
| --- | --- | --- | --- | --- |
| CHAT-001 | 全栈开发（待指定） | 用户只能读自身会话；评估会话与普通会话分离；重进恢复历史。 | 未验收；无真实业务验收证据 | 2026-09-22 |
| CHAT-002 | 全栈开发（待指定） | 同请求不重复建消息或记本地消耗；错误回复不标成功；不会发送无关证件资料。 | 未验收；无真实业务验收证据 | 2026-09-22 |
| CHAT-003 | 全栈开发（待指定） | 切换会话不串上下文；超时保留可重试消息；重进页面能继续。 | 未验收；无真实业务验收证据 | 2026-09-22 |
| CHAT-004 | 全栈开发（待指定） | 配额并发不超扣；供应商计费不明可对账；仅真实成功回复显示完成。 | 未验收；无真实业务验收证据 | 2026-09-22 |
| CHAT-001 | 全栈开发（待指定） | 用户只能读自身会话；评估会话与普通会话分离；重进恢复历史。 | 本地70项助手及H5联调通过；真实语义/真机待验收，见6.19 | 2026-09-28 |
| CHAT-002 | 全栈开发（待指定） | 同请求不重复建消息或记本地消耗；错误回复不标成功；不会发送无关证件资料。 | 本地70项助手及H5联调通过；真实语义/真机待验收，见6.19 | 2026-09-28 |
| CHAT-003 | 全栈开发（待指定） | 切换会话不串上下文；超时保留可重试消息；重进页面能继续。 | 本地70项助手及H5联调通过；真实语义/真机待验收，见6.19 | 2026-09-28 |
| CHAT-004 | 全栈开发（待指定） | 配额并发不超扣；供应商计费不明可对账；仅真实成功回复显示完成。 | 并发额度/超时/迟到/重试本地通过；供应商真实语义与生产容量待验收，见6.19 | 2026-09-28 |
直接外部/业务阻塞：无；仍须满足前置任务。
@@ -1017,3 +1060,67 @@ REPORT-004三栏页面子项完成本地联调，整体仍开发中。改动repo
后续建议按页面方案推进08上下文AI助手（CHAT模块），再衔接10行动页与09 PDF独立任务。真实产品/人工金标准、外部渠道、微信内H5及真机均仍待验收，不标整体验收完成。
收尾：随机合成账户、3条评估/会话、Token和隔离队列已清理，测试HTTP服务和浏览器会话已关闭；原1会员、2条成功评估/会话、25张表保持，syntheticUsers=0。本轮开始时未发现运行中的analysis:work，清理后已启动正式worker（PID33796），错误日志为空。文本编码、diff检查、63任务一致性与26条路由检查通过；未提交、推送或发布。
### 6.18 2026-09-28 原型04/05还原与单产品AI解释
本轮优先实现PRODUCT-004的04、05子范围。页面按原型还原机构头部、状态标签、三栏栏目、绿色推荐依据、橙色不推荐/注意事项、底部双按钮；真实匹配仍使用符合已知条件/条件不符/待核实三态，不展示原型中的匹配百分比、审批概率或虚构银行优势。额度、年化、期限移入产品详情；证据和来源保持可展开查看。
| 检查 | 结果与证据 | 验证边界 |
| --- | --- | --- |
| 后端回归 | `php tests/product_explanations.php --worker-stopped`通过51项；`php tests/match_records.php --worker-stopped`通过70项。覆盖鉴权、归属、POST参数、并发幂等、成功缓存、失败三次边界、用量记录、超时回收、迟到结果、快照/游标和删除记录 | 使用随机合成账户与假模型，测试前停止worker，结束自动清理；无迁移/新表 |
| 真实模型 | DeepSeek `deepseek-v4-flash-0731`调用成功，输入911—1087 tokens、输出235—315 tokens，耗时约2.9—4.5秒；保存逐条reasonId/text/evidenceRefs | 共6次真实Flash调用，4次成功、2次因理由顺序被旧校验拒绝；按ID集合校验修复后不符与待核实样例通过。未声称真实机构业务准确性，不记录密钥 |
| 前端主流程 | Chromium，H5 `http://localhost:5173/`；390×844、390×1000、1280×900。已保存解释读取、证据展开、产品详情/申请条件切换、失败重试、刷新保留queued、三态页面和底部操作通过 | Browser plugin不可用，使用Playwright CLI；未做微信内置浏览器、Safari、Android/iOS真机 |
| 故障与安全 | 轮询断网后规则理由仍保留并可手动查询；迟到响应不切回旧栏；下架保留历史参数且禁用资料准备；公共模式不显示AI栏；非法评估ID不发请求；越权不回退公共产品；401回登录；读取已保存结果不发POST | 故障为本地路由注入；未做多设备压力测试 |
| 视觉对照 | 已查看`docs/原型.jpg`原图及04/05放大局部；对照机构头部、绿色/橙色编号、三栏、底部按钮、白底密度五类要素。保存截图于`C:/Users/JUN/AppData/Local/Temp/airz-product-explanation-20260928/` | 原型中的真实银行Logo、92%匹配度、立即申请和咨询AI无已确认数据/接口，因此使用通用图标、状态标签、资料准备/对比入口并在页面说明 |
本轮新增接口和状态契约见`docs/产品匹配规则开发契约.md`第9节；不新增业务表或数据库迁移。analysis:work已恢复运行。下一步为原型08上下文助手，随后10行动页和09 PDF；真实产品资料与人工金标准提供后再做正式匹配验收。
6.18收尾补记：HBuilderX5.26 Android与微信小程序最终编译通过；H5运行页面身份正确、非空、无框架错误遮罩，最终三态读取流程无console.error/warn，不发POST。首次Android暴露UTS局部函数前向引用限制，调整声明顺序和轮询回调后修复。临时HTTP服务首次未指定public目录导致首页HTML响应，修正启动参数后重跑；早期脚本误用不存在的按钮文案和CLI环境未定义setTimeout，修正定位/等待后通过，不将脚本失败算作业务通过。
最终对照检查了机构头部、栏目文字/选中线、理由顺序和编号、字体与行距、底部按钮及桌面容器；原型单页小图不适合按原始像素直接作为可读手机界面，使用390×1000接近纵横比并同时检查390×844。长规则标题缩短重复核验模板，原始依据仍完整可展开。首屏有意差异为演示标记/通用图标、三态替代百分比、真实理由数量、资料准备和对比替代尚未接通的申请/咨询；说明见原型方案第8节。
截图：[04手机](<C:/Users/JUN/AppData/Local/Temp/airz-product-explanation-20260928/product04-mobile.png>)、[05手机](<C:/Users/JUN/AppData/Local/Temp/airz-product-explanation-20260928/product05-mobile.png>)、[04/05并排](<C:/Users/JUN/AppData/Local/Temp/airz-product-explanation-20260928/prototype04-05-result.png>)、[待核实](<C:/Users/JUN/AppData/Local/Temp/airz-product-explanation-20260928/product-unknown-mobile.png>)。测试脚本flow.js/retry.js/states.js/capture05.js/edges.js/final-capture.js均在同一临时目录；界面已保存输出来自真实Flash，基础评估报告由假模型生成。
合成账号及其评估/会话/日志、Token和隔离队列已清理，测试HTTP服务关闭，正式analysis:work恢复（PID50752）；数据库仍为1会员、2成功评估/会话、25张表。63项编号/依赖/工时一致且无环、26路由、UTF-8无BOM、链接及diff检查通过；本轮没有执行git提交、推送或发布。
### 6.19 2026-09-28 原型08上下文助手实施与验证
- 界面按原型恢复机器人问候、快捷问题、聊天气泡和输入栏，新增紧凑上下文卡与历史对话。报告/单产品/对比入口、登录返回及H5 chatId刷新已接通。
- 后端AssistantChats/Assistant控制器、四组助手API、持久日志任务已实现。普通会话不占正式assessment_id；服务端冻结事实、同键幂等、三次重试、租约恢复、迟到只补用量、六轮历史裁剪及共享每日额度均已接入。API与边界见[助手契约](上下文AI助手开发契约.md)。
- 经本轮用户授权，停止空闲worker并备份后完成5项增量迁移，复跑0项；备份为后端相邻airz-backups/assistant-context-20260928-154651-271907。逐条对照确认原2份会话/2条日志未改写，原评估保留。数据库仍25表、1会员、2份评估/会话。
| 验证 | 结果 | 边界 |
| --- | --- | --- |
| 后端 | 助手70项、产品解释51项、分析任务31项、评估HTTP36项、匹配HTTP/快照70项通过 | 合成账户/假模型；无本轮收费模型调用 |
| 并发及故障 | 双进程发送串行；跨会话仅剩一次额度不会超扣；同键重放、三次重试、租约失效、迟到用量、归属及上下文冲突通过 | 修复MySQL旧快照导致序号竞争，关键查询使用锁定当前读 |
| H5 | Chromium390×844及1280×900；普通/评估/产品/对比、23轮分页、刷新、回执丢失、额度错误、失败重试、跨账号清理、真实密码登录返回通过 | Browser plugin not available，使用现有Playwright CLI；无安装依赖 |
| 编译及视觉 | HBuilderX5.26 Android、微信编译通过；最终页面非空、无框架遮罩，正常流程console.error/warn为0 | 原生端百分比max-width已修正；旧开发服务器未载入新登录代码，重启后复测通过；H5编译器仍提示共享layout既有类型声明警告，不是浏览器运行错误 |
| 清理 | 合成账号、评估、会话、日志、Token及队列已清理，隔离HTTP服务与浏览器关闭 | 截图及无凭据QA脚本保留临时目录，不提交仓库 |
截图：[普通助手](<C:/Users/JUN/AppData/Local/Temp/airz-assistant-20260928/assistant-normal-mobile-final.png>)、[上下文助手](<C:/Users/JUN/AppData/Local/Temp/airz-assistant-20260928/assistant-context-mobile-final.png>)、[桌面](<C:/Users/JUN/AppData/Local/Temp/airz-assistant-20260928/assistant-context-desktop-final.png>)。真实DeepSeek多轮语义、真实产品人工样例、微信内H5/Safari、真机键盘/安全区及生产容量未验收，不能将假模型联调描述成真实回复验收。CHAT-001—003待验收、CHAT-004开发中；原型10及09 PDF仍未开始。保留用户已有改动，未提交、推送或发布。
### 6.20 2026-09-28 原型10实施与验证
- 新增next-step页、主包白名单路由帮助函数和四个SVG图标；报告/产品/助手/登录入口增量接通。63项编号及依赖保持不变，REPORT-006待验收；无提交、推送或发布。
- H5 Chromium 390×844、1280×900：主流程14项、边界21项、导航及本机缓存3项，共38项通过。覆盖报告/产品入口、无产品选择、准备刷新、AI上下文往返、个人/企业空白重评、首页清栈、冷启动返回、越权、错误产品、参数、账户切换迟到响应及真实密码登录恢复。正常主流程无业务console.error/warn，无POST或模型请求。
- 主流程使用临时合成个人/企业成功报告和真实只读API；不符/待核实及跨账户拒绝也来自真实API。不可用、快照不一致、503、无匹配、旧版、未完成、迟到响应采用可控响应注入，未修改正式产品。登录验证单独发送登录POST，不能把只读页面测试说成无任何写入。
- 最终HBuilderX5.26 Android（17:04:58）及微信小程序（17:05:58）27页编译成功。共享layout既有H5类型警告保留，未做无关重构。真机、微信内H5/Safari、真实产品渠道未验收；08真实多轮语义仍待验收。
- 测试前确认worker空闲并停止，结束清理全部合成账号/评估/会话/日志/令牌/队列，关闭隔离HTTP和浏览器。恢复1会员、2评估/会话、2日志；原评估161/229会话摘要前后相同。正式worker恢复PID45420，H5最新服务5173（PID51832），新会话须重新检查PID。
- 证据目录：`C:/Users/JUN/AppData/Local/Temp/airz-next-step-20260928/`，包含无凭据QA脚本与verification.md；脚本中的__QA_FIXTURE__需由新合成数据注入。截图：[行动页手机](<C:/Users/JUN/AppData/Local/Temp/airz-next-step-20260928/actions-mobile.png>)、[材料准备手机](<C:/Users/JUN/AppData/Local/Temp/airz-next-step-20260928/prepare-mobile.png>)、[行动页桌面](<C:/Users/JUN/AppData/Local/Temp/airz-next-step-20260928/actions-desktop.png>)。
下一步实施REPORT-005 PDF导出；当前无下载按钮或虚假成功提示，不包含银行受理/授信/放款。
### 6.21 2026-09-28 PDF导出实施与验证
- 后端ReportPdf、Assessments::pdf、MatchRecords::exportSnapshot及report.pdf路由；前端ReportExport组件、report-export.uts下载器与report-route.uts登录白名单。只读本人成功报告，无迁移/新表/收费模型调用。依赖和部署见后端extend/report-pdf/README.md。
- `php tests/report_pdf.php`29项：精度、零值、最大金额、隐私字段与文本遮蔽、HTML转义、v1、未匹配/零候选、企业、关闭引擎503、真实PDF。样本通过Poppler逐页渲染、pdfplumber中文提取/隐私/页面边界检查，末尾版本说明整体分页，避免只剩免责声明的尾页。
- `php tests/report_pdf_http.php --worker-stopped`20项真实HTTP：401/404/409 JSON、no-store、合法二进制/MIME/安全文件名、重复下载不改报告与调用日志、不查询当前产品目录、损坏/撤销会话拒绝。合成账号/评估/日志/Token/队列及隔离服务已清理；没有真实模型调用。
- 浏览器使用Playwright CLI（Browser plugin not available），Chromium390×844/1280×900，24项检查通过：普通流程6项、边界18项。页面身份/非空/无框架浮层、正常流程console.error/warn为空；实际download事件文件可解析。API响应采用合成报告及后端生成的真实PDF注入；错误页、损坏、断网、503、401、离页、账号切换、微信UA提示均验证。不能把受控UI响应检查描述为浏览器完整真实后端联调；真实HTTP另由上项覆盖。真实密码登录回跳本轮未重跑。
- 最终HBuilderX5.26 Android17:34:03、微信小程序17:36:09编译通过。原生/小程序仅提示普通H5下载，不宣称原生保存可用；微信内H5/Safari/真机、生产并发容量仍未验收。共享layout既有H5类型警告保留。
- 自动审批曾拒绝一条“创建合成UI账号＋启动隔离服务＋浏览器”的组合命令，仅返回blocked by policy，未给具体理由；没有重试该组合或规避限制。已恢复worker，并采用无服务器凭据的受控浏览器响应完成UI检查。其他工具路径/定位问题修正后验证通过。
- 当前数据库1用户、2成功评估/会话、2日志、0待处理；原161/229报告会话摘要与执行前一致。worker PID34324、H5 5173/PID51832已核对运行，后续勿硬编码PID。无提交/推送/发布。
- 证据目录`C:/Users/JUN/AppData/Local/Temp/airz-report-pdf-20260928/`：personal/enterprise/legacy/unmatched/zero-candidates/long.pdf、http-personal.pdf、browser-report.pdf及对应渲染图；ui-flow.js/ui-edges.js只含不能访问服务器的合成会话标识。截图：[手机报告](<C:/Users/JUN/AppData/Local/Temp/airz-report-pdf-20260928/report-pdf-mobile.png>)、[桌面报告](<C:/Users/JUN/AppData/Local/Temp/airz-report-pdf-20260928/report-pdf-desktop.png>)；[合成PDF样本](<C:/Users/JUN/AppData/Local/Temp/airz-report-pdf-20260928/personal.pdf>)。
REPORT-005待验收。下一步08真实DeepSeek多轮语义、真实产品人工样例与微信内H5/Safari/真机验收；真实模型调用会产生用量，应在具体样例及预算边界明确后执行。