airz-uniapp/docs/新会话交接.md

# AI融资项目新会话交接

记录日期：2026-09-28。本文件为接续入口；详细任务状态以[开发进度](开发进度.md)0.20、6.21节为准，设计以[开发文档](开发文档.md)v1.18、[原型页面方案](原型04-10页面改造与跳转方案.md)v1.7为准。历史章节中的“待开发”应结合最新更新阅读。

## 1. 当前停在哪

用户要求界面内容尽可能还原`docs/原型.jpg`。原型08已继续实施：界面、持久会话、固定评估/产品上下文、异步回复、分页、原键重试、共享额度、报告/产品/对比入口及登录返回已完成本地联调；关键代码有中文注释。原型10也已完成本地联调；09 PDF普通H5也已实施；下一步为08真实多轮语义与跨平台/真实产品验收。

| 内容 | 当前状态 |
| --- | --- |
| 04/05 产品匹配详情 | 原型布局与单产品解释保留；咨询AI已接08；产品对比仍可进入 |
| 06 产品详情 | 公共资料和本次评估冻结快照分开读取 |
| 07 产品对比 | 同次2—3产品、补选/移除/刷新保留；可带选择进入08，PRODUCT-005待验收 |
| 08 上下文AI助手 | CHAT-001—003待验收，CHAT-004开发中；70项助手测试与H5、Android/微信编译通过；真实多轮模型语义/真机未验收 |
| 09 报告 | 三栏及本次报告咨询AI入口完成；REPORT-004整体仍开发中；REPORT-005普通H5导出已本地验证，平台/容量待验收 |
| 10 下一步行动 | REPORT-006待验收；四项行动/登录恢复/状态守卫已接通，38项H5检查及Android/微信编译通过 |

当前27个注册页面、63个稳定任务编号。未提交/推送/发布；前后端已有改动均保留。

## 2. 原型08实现与下一步

完整契约见[上下文AI助手开发契约](上下文AI助手开发契约.md)。前端`packages/finance/assistant/assistant.uvue`、`packages/finance/services/assistant.uts`；后端`AssistantChats.php`、v1 `Assistant.php`和`AnalysisWork.php`。旧sendAssistantMessage模拟入口已移除。

- 普通会话scene=assistant、assessment_id/analysis_context=NULL。本轮用户明确授权后已执行后端`database/migrate_assistant_context.py --apply --worker-stopped`，新增两列及归属约束共5项，复跑0项。备份`D:/AAdesk/202609/airz-backups/assistant-context-20260928-154651-271907/`，原2份评估会话/2条日志逐条未改写。恢复优先保留可空列、回退助手代码，不能整表覆盖后续记录。
- GET `/assistant/context`只读预览，GET/POST `/assistant/chats`读取列表/创建，GET `/assistant/chats/:id`恢复并校验URL绑定，GET/POST `/assistant/chats/:id/messages`分页/发送。创建与进入页面均不调用模型，快捷问题只填入文本框。
- 明确发送创建用户行与ast:调用日志，analysis:work持久消费。每条逻辑消息requestId保持不变；回执丢失同retryAttempt重放，明确失败才手动递增0→1→2。每会话100轮、同时一条待处理；每日创建30会话，调用与评估/单产品解释共享每日额度。
- 并发序号/幂等/额度必须保持锁定当前读，不能仅依赖用户锁后普通SELECT；测试发现MySQL可重复读旧快照会造成重复序号。
- 页面每3秒查询、最多60次，可续查；离页清空、Token变化拒绝迟到回包。消息/报告不落本机缓存，H5只保存chatId等ID到URL。登录后只接受白名单助手返回并重新鉴权。
- 后端默认Flash真实适配已接通，本轮测试使用假模型，未新发收费模型调用；不要把假模型回复当作真实DeepSeek多轮语义验收。

原型10及09 PDF已实施；下一步补真实模型/产品与平台验收；并补08真实多轮人工语义、微信内H5/Safari/真机键盘安全区及生产容量验收。供应商与真实产品准备仍可推进，不虚构整体完成率。

## 3. 必须延续的业务约定

- 不做草稿；重新评估进入空白表单，不覆盖历史评估。
- fa_user_info一条对应一次评估；fa_ai_chat保存关联报告及匹配结果；fa_ai_chat_log保存消息和调用记录。不新建独立评估/报告/匹配表。
- Token保存在Redis，fa_user_token已删除。
- 金额数据库DECIMAL(11,2)，单位元；API用元十进制字符串；客户端万元，保留精度，例如123456.78元显示12.345678万元。
- 产品稳定条件、额度/期限/利率等使用独立字段，地区/补充规则JSON；沿用冻结产品快照，不用当前产品参数覆盖历史。
- 规则决定eligible/ineligible/unknown，AI只解释；无评分策略则score=null，不使用原型92%、B+或固定三正三反。非候选的正向部分称“已满足条件”。
- 申请仅限资料准备与引导；不提交银行申请、不声称受理成功。真实产品尚未提供，本地6条上架资料是明确标注的演示产品。
- DeepSeek走腾讯TokenHub，已配置Flash/Pro；默认Flash。短信、微信/一键登录、外部查询、客服服务商仍待定。
- 中文交流与关键中文注释；UTF-8无BOM。保留未提交工作，不自行提交/推送/建PR、迁移或覆盖用户改动。凭据只从后端私密配置读取，不在文档、命令输出、日志或客户端复述。

## 4. 04/05实现入口和注意点

前端：`packages/finance/product/product.uvue`、`packages/finance/services/matches.uts`、`packages/finance/services/compare.uts`。

后端：`application/common/library/ProductExplanations.php`、`MatchRecords.php`、`DeepSeekClient.php`、`AnalysisTasks.php`、`application/admin/command/AnalysisWork.php`、`application/api/controller/v1/Assessments.php`、`application/route.php`。

- POST `/api/v1/assessments/:id/matches/:productId/explanation`仅接受requestId；返回HTTP200的匹配详情及异步状态，不能把HTTP200理解为模型完成。
- fa_ai_chat.match_result中单项ai_explanation保存queued/running/completed/failed和逐条解释；首次not_requested。fa_ai_chat_log的`pex:`调用日志作为持久待办，analysis:work在报告队列空闲时消费。
- 成功缓存、并发点击和同键重放不会重复调用。每评估每产品最多三次尝试，与报告共享每日用户调用预留额度。失败新键可重试；租约失效明确失败，迟到仅补用量。
- 模型可能重排理由，按reasonId完整集合校验无重复/遗漏/外来项，再恢复规则顺序，不能再用数组位置强制匹配。
- 更新解释不能使分页失效：游标摘要排除ai_explanation，仍校验其他冻结字段。
- 前端每三秒读状态、最多六十次，可手动续查；离页停止轮询、清理数据并拒绝迟到回包。UTS Android局部函数不支持任意前向引用，声明顺序须注意。

详见[产品匹配规则开发契约](产品匹配规则开发契约.md)第9节及[需求与评估结果数据契约](需求与评估结果数据契约.md)。

## 5. 验证与现场状态

- 51项单产品解释测试、70项匹配HTTP/快照检查通过。真实Flash共6次调用，4次成功、2次因旧顺序校验失败，修复后不符及待核实样例通过；不是6次均成功。
- HBuilderX5.26 Android/微信小程序编译通过；H5 Chromium在390×844、390×1000、1280×900验证，正常最终流程无业务console.error/warn。微信内H5、Safari及真机、真实产品人工金标准未验收。
- 合成测试账号/评估/会话/日志、Token与队列已清理，测试HTTP和浏览器会话已关闭。上次数据库核验为1会员、2成功评估/会话、25张表；原评估161/229未改写。
- 2026-09-28本轮收尾正式analysis:work已重启加载助手代码，PID45420已恢复运行（原型10测试后）；新会话应重新检查进程/任务状态，不能将旧PID视为永久有效。已有模型worker需在代码变更后安全重启。
- 前后端均有未提交改动；本次已实施原型08及10，不清理既有工作树。开始新一轮修改前先git status并保留用户现有改动。

本轮08验证：助手70项、产品解释51项、任务31项、评估HTTP36项、匹配HTTP/快照70项通过；H5 Chromium390×844/1280×900完成发送/刷新/分页/重试/回执丢失/三入口/越权/登录返回验证，Android和微信编译通过。合成数据、令牌、隔离服务、浏览器已清理。截图和无凭据QA脚本在`C:/Users/JUN/AppData/Local/Temp/airz-assistant-20260928/`。共享layout既有H5类型警告保留，正常浏览器运行无业务error/warn。

此前04/05测试与截图目录：`C:/Users/JUN/AppData/Local/Temp/airz-product-explanation-20260928/`。其中flow/retry/states/capture05/edges/final-capture脚本和截图可参考，但临时目录可能被系统清理；fixture.json已删除，不假定旧账号仍可登录。产品对比和报告三栏证据分别在airz-compare-20260928、airz-report-tabs-20260928临时目录。

原型10最新验证见开发进度6.20：38项H5检查（真实API主流程＋边界响应注入）、Android/微信27页编译通过。测试已清理，原161/229报告会话摘要未改变，数据库恢复1用户、2评估/会话、2日志。H5最新5173/PID51832，worker PID45420；新会话先检查当前状态。截图与无凭据脚本在`C:/Users/JUN/AppData/Local/Temp/airz-next-step-20260928/`。

原型10代码：`packages/finance/next-step/next-step.uvue`、`services/next-step-route.uts`。只读status/report/matches接口，核对成功归属与快照元数据；eligible且available才开放准备。重新评估按status.type进入空白表单；登录白名单恢复；onHide清空个人数据、generation/token拒绝迟到请求。未修改后端业务或迁移。不要把模拟不可用/旧版响应测试说成真实产品/旧数据验收。

原型09 PDF最新见进度0.20/6.21：29项PDF、20项真实HTTP、24项受控浏览器检查通过，最终Android/微信编译通过。引擎Dompdf3.1.6在后端extend/report-pdf独立composer.lock，字体Noto Sans SC含许可与哈希；部署须在该目录composer install，详见其README。后端ReportPdf与report.pdf路由、MatchRecords::exportSnapshot；前端ReportExport组件/report-export.uts，登录report-route白名单。无迁移，无收费模型调用。仅普通H5开放下载，其余端给操作提示；不能把编译通过说成原生下载验收。

本轮曾被自动审批拒绝组合UI夹具启动，改以受控响应验证浏览器，不声称完整真实浏览器联调。真实HTTP检查独立通过。全部真实合成账号/Token/队列已清理；原两份报告摘要相同。worker现PID34324，H5仍5173/PID51832；每次重查。PDF/截图证据在`C:/Users/JUN/AppData/Local/Temp/airz-report-pdf-20260928/`。

## 6. 环境与验证命令

前端目录：`D:/WorkSpace/cyun/ai融资`，uni-app x/Vue3/UTS、HBuilderX5.26 VDOM，无npm构建入口。后端目录：`D:/AAdesk/202609/airz`，FastAdmin/ThinkPHP、PHP7.4、MySQL/Redis。

```powershell
# 在对应项目目录执行；后端合成任务测试前先核对并停止全部分析worker，结束清理后恢复。
& 'D:/Develop/phpstudy_pro/Extensions/php/php7.4.3nts/php.exe' tests/product_explanations.php --worker-stopped
& 'D:/Develop/phpstudy_pro/Extensions/php/php7.4.3nts/php.exe' tests/match_records.php --worker-stopped
& 'D:/Develop/phpstudy_pro/Extensions/php/php7.4.3nts/php.exe' tests/assistant_chats.php --worker-stopped
# --live会真实调用并产生用量，日常回归不加。
& 'D:/Develop/phpstudy_pro/Extensions/php/php7.4.3nts/php.exe' think analysis:work

& 'D:/Develop/HBuilderX/cli.exe' launch app-android --project 'D:/WorkSpace/cyun/ai融资' --compile true --continue-on-error false
& 'D:/Develop/HBuilderX/cli.exe' launch mp-weixin --project 'D:/WorkSpace/cyun/ai融资' --compile true --continue-on-error false
```

H5已清理旧开发服务器并以最新代码恢复`http://localhost:5173/`，新会话先核对监听。注意HBuilder多次launch可能保留旧端口产物，新增代码未加载时先重启正确服务，不把旧包误判为业务错误。可用Python为`D:/Develop/Python311/python.exe`。已有Playwright CLI使用`npx --no-install @playwright/cli`，从临时QA目录运行避免向项目写入日志；工具可用性按新会话实际环境选择，无需安装全局依赖。

本地PHP测试服务需指定`-t D:/AAdesk/202609/airz/public`，否则可能返回首页HTML。UI测试使用随机合成账号，不输出密码/Token；原有真实用户账号无需改动。恢复扫描可能拾取测试任务，仅换Redis队列不足以隔离，故测试前要检查worker。

## 7. 新会话可以直接发送

> 请先阅读docs/新会话交接.md、开发进度0.20/6.21和原型04-10页面方案，继续原型08真实多轮语义及跨平台验收准备，先核对可执行样例和用量边界。界面尽量还原docs/原型.jpg，关键代码加中文注释；保留已有04/05解释、07对比、08上下文助手、09报告及10行动成果。只做材料准备与引导，不提交银行申请；PDF未完成时不做假下载。先检查工作树与数据库/worker现状，新增迁移仍按具体方案申请授权。