2026-09-28 17:50:46 +08:00
# AI融资项目新会话交接
2026-09-30 19:11:44 +08:00
记录日期：2026-09-30。本文件为接续入口；当前存储与流程以[评估版本与最新资料 ](评估版本与最新资料.md )、[开发进度 ](开发进度.md )0.36节及[开发文档 ](开发文档.md )v1.30为准。历史章节中的“待开发”应结合最新更新阅读。
## 最新产品展示：2026-09-30 正式数据及三文件PHP已部署
用户要求当前测试数据采用正常业务文案，不显示“演示、非真实”等环境标签。正式`111.230.144.231:3306/airz` 现有6条产品ID22—27已精确更新为个人灵活消费贷、个人小额周转贷、个人优享信用贷、企业经营周转贷、企业成长经营贷、普惠基础融资贷，机构显示名及材料/条件/建议同步调整。所有金额、利率、期限、地区、准入条件及有效期保持，内部`demo:airz-` source reference保留。产品与来源规则版本由1增至2；未新增重复产品、未改写会话/历史报告，其他24表逐行摘要一致，0次模型调用。
新增后端`database/update_product_display.php` 与[恢复说明 ](D:/AAdesk/202609/airz/database/product-display-update.md )：显式目标、锁定六行、参数保护、写入前完整行备份、事务复验、重复执行无变更；隔离库已演练精确恢复。正式备份`D:/AAdesk/202609/airz-backups/product-display-20260930/product-display-20260930-180754-a4d94caa.json` 。不得重新导入产生重复或整表恢复。
前端匹配/详情/报告/对比/行动/助手已移除环境标签，内部来源引用显示为“产品规则档案”；后端报告消息、PDF与助手提示词同步调整，继续按已配置参数及事实解释。已清理上一阶段未完成的前端内存模拟入口和登录绕过，走原真实接口。605项PHP检查与242项Playwright检查通过；390× `airz-product-editor-20260930/qa-display-ui.json` 及`display-*.png` 。
**正式产品数据及本轮三文件PHP已部署，小程序/H5未发行。** 用户授权“先做第1项”后，经宝塔上传部署`AssessmentNeedsReport.php` 、`AssistantChats.php` 、`ReportPdf.php` ，备份并停空闲worker后仅替换3文件、重启PHP-FPM。76项服务器本机HTTPS/FPM及假模型检查通过，覆盖个人/企业报告、匹配、实际PDF、助手提示词和权限；4次显式假客户端、0次收费调用。临时对象已精确清理，25表原有数据逐行摘要、其他application源码、生产.env和数据库全局参数保持。原nginx恢复、三服务active，worker消费不存在的合成评估任务后队列为空；最终PID944033/NRestarts0，后续须重查。
服务器备份`/root/airz-product-display-20260930/` ，12个备份/验收文件已下载到本机受限目录`D:/AAdesk/202609/airz-backups/product-display-deploy-20260930/` ，原源码和完整数据库备份摘要一致；详细部署与三文件恢复边界见上述后端恢复说明。无数据库迁移，不重跑维护阶段、不整库回退。本次未发布产品编辑器/公共目录的其他本地改动，前端仍需重新发行。本机5173 H5、8097隔离PHP及3309隔离MySQL沿用上一轮状态，继续先核对监听；不要启动默认本机worker。公网HTTPS阻塞未复测，本机TLS通过不表示公网恢复。下节关于强制显示环境标签的表述为已被用户最新要求覆盖的历史记录。
## 历史产品联调：2026-09-30 正式库演示数据核对
用户确认正式库也使用当前演示数据，且暂时没有用户。已只读核对正式`111.230.144.231:3306/airz` ： `database/demo_products.json` 逐字段一致，正式产品ID为22—27；没有新增重复记录、没有改写会话或报告。产品名称、机构和来源均明确为演示/非真实金融资料，只供功能开发与验收，不代表银行政策或授信承诺。
本机隔离库`127.0.0.1:3309/airz_product_test_20260930` 已通过`database/seed_demo_products.php --env <隔离配置> --apply` 补齐同一批6条，原4条银行材料草稿保持不变；重复运行返回`kept_existing` 。新增v3匹配回归151项、发布编译153项、产品目录45项、材料复核38项通过。正式库不需要再次导入这批数据；本机默认`.env` 仍指向正式库，任何本地种子/测试必须显式使用隔离配置。
后续继续评估→匹配→报告链路联调时，个人/企业均可使用这些演示产品覆盖符合、条件不符和待核实三态；真实银行四条草稿仍不可上架，收到确认后另建材料版本。
## 最新产品编辑改进：2026-09-30 待核实与发布检查
用户同意实施下一步第1项，本机开发已完成：新增默认“待核实”地区，保存SQL NULL；明确全国才保存[]，指定城市非空列表。NULL地区不再误判旧规则，四条公开材料来源正常显示；真正旧规则的已有来源仍可只读查看，未明确重建时普通保存保留原JSON。发布前检查一次返回data.issues字段/问题列表，覆盖独立字段缺失/错误、范围倒置、日期、用途及逐条条件；可选经营月数空值不误报必填。诊断候选仅在内存中使用，真实保存/模型或后台上架仍走严格完整校验，未知地区不能上架。版本冲突及规则版本上限保持。
450项PHP、89项HTTP/Playwright（含7项只读首屏检查）、7项清理/完整性检查通过，1280×900及390×
PHP8097/MySQL3309隔离服务仍运行，监听127.0.0.1，模型关闭、未启动worker；预览入口沿用下节，下次先复查监听及临时bootstrap。项目.env仍是正式库，不能直接启动默认服务或旧集成测试。不要运行旧cleanup.php/reset-products.php删除四条材料。下一步仍需受理银行确认当前参数/地区/有效期/完整硬条件，再做人工匹配验收；本轮代码未部署。
## 最新材料复核：2026-09-30
已新增只读材料复核命令`D:/AAdesk/202609/airz/database/review_product_materials.php` 和`tests/product_materials.php` 。复核首批隔离草稿不连接数据库、不读取.env、不访问来源网址、不调用模型，并输出[银行核实与验收表 ](产品材料/首批产品银行核实与验收-20260930.md )及[复核清单 ](产品材料/首批产品复核清单-20260930.json )。四条仍为草稿：工银融e借8项、闪电贷7项、农银微捷贷5项、税易贷7项格式缺项；0条格式完整、0条银行确认、0条可发布。个人/企业profileOnly面对当前草稿目录均返回`unavailable/PRODUCT_CATALOG_UNAVAILABLE` ，不虚构匹配候选。38项材料/匹配准备检查通过。收到银行回复前不能把公开参数改成当前政策、扩充南京城市或上架；真实材料需另建确认版本，保留本次公开基线。
本轮未重新查阅官网或取得银行回复；目前目标城市及当前银行政策材料仍待用户补充。核实表给出每产品特殊问题、可填写的统一回复表及规则表达能力差距；真实银行样例期望尚待签核，合成收入8000元门槛只用于技术测试，不能套用于四条产品。未改应用运行逻辑、数据库或UTS，未部署或调用模型。
## 最新产品材料：2026-09-30 本机草稿
用户要求准备几个产品材料录入。本轮查阅银行官网，整理工银融e借、闪电贷线上公开材料、农银微捷贷、建行税易贷四条，在127.0.0.1:3309/airz_product_test_20260930保存草稿ID1—4；没有改写正式库、既有演示产品或历史报告，没有上架、部署、模型调用或源码改动。材料、原文依据、准备建议和待核实事项见[首批产品材料 ](产品材料/首批产品材料-20260930.md )，结构化元字符串见同目录JSON。
所有未知最低额度、最短期限和有效期保留NULL；微捷贷官网长图的3.5%起只记录下限，上限未知。官网全国通用栏目仅支持微捷贷regions=[]；其余三条地区NULL，闪电贷南京分行材料不能外推全国，南京也不在现有城市字典内。后续编辑器已支持“待核实”，NULL地区不再需要重建，来源正常显示；未核实地区前不要改成全国。四条均缺发布参数，模型发布检查全部阻止上架。信用良好等非量化条件、年龄例外、共同借款及连带保证保留说明，不补造机器规则。正式匹配前还需银行确认当前政策与完整硬条件，并验证系统表达能力。
本机MySQL/PHP原进程已停止，本轮用原my.ini及router/bootstrap恢复3309/8097，均监听127.0.0.1，分析模型禁用，未启动worker。后台列表显示四条草稿，微捷贷编辑页来源及空值正常；重复执行只核对已有记录，不产生重复，会员/资料/会话/日志/用量表计数未变。录入脚本及无凭据回执public-materials-import.json、四个官网来源截图和public-materials-catalog.png位于C:/Users/JUN/AppData/Local/Temp/airz-product-editor-20260930。旧cleanup.php/reset-products.php会删除本机产品，不要再用于本批材料。继续仍先检查监听，不假定旧PID有效；后台地址和测试管理员沿用下节。
## 最新功能开发：2026-09-30 产品后台
用户暂不处理公网HTTPS，转而继续PRODUCT-003。本轮完成本地产品结构化编辑、来源/用途/城市控件、动态准入条件、只读发布检查、版本冲突和上架/下架工具栏；补GET /api/v1/products会员公共目录并复用详情DTO。不新增数据库字段/权限节点，不改UTS，不重写历史匹配结果。旧规则默认保存原JSON，明确重建才替换及清除旧年龄条件；发布资料完整性不等于来源真实性。
入口：后端ProductEditor.php/ProductCatalog.php、admin Product控制器/模型、product/form.html及backend/product.js、API v1 Products与路由。保存时锁定最新行检查_base_version，后台入口固定走结构化映射，删除客户端标记不能绕过；source/purposes/conditions变化才增加规则版本。匹配v3不采集金额/期限/用途的约定保持，产品自身范围仍需真实录入。
326项PHP检查与89项真实隔离HTTP/浏览器检查通过；Playwright桌面1280× × ， ， ；
本轮未进行线上写入或部署，也未收到真实产品材料；PRODUCT-003仅工具与接口完成，真实产品发布/业务金标准仍待验收。继续时优先准备真实材料并核对录入草稿，不能把演示产品改名当成真实产品，不得延用旧生产迁移授权发布本轮代码。
收尾额外10项关闭调试/生产静态资源模式检查通过，企业默认条件、金额输入、响应式布局和资源加载正常。合成产品、会员、日志与Token已清理，业务六表为0；仅保留一个本机测试管理员便于预览，登录信息在临时fixture.private.json，不含生产凭据或会员令牌。8097隔离PHP及3309临时MySQL保留运行，模型禁用、监听127.0.0.1；预览地址http://127.0.0.1:8097/ZYurKboadX.php/index/login?url=product%2Findex。这些进程会随终端/任务环境变化停止，下次先复查端口；不得用项目默认.env替代临时bootstrap。临时目录可能被系统清理，仓库中的代码/测试/契约才是持久交付。
## 最新线上维护：2026-09-30 已完成
本轮后续维护已完成：`fa_ai_chat.context_data` 后由17列精简为8列，迁移前已阻断入口、停worker、完整备份；独立脚本同步当前输入JSON状态后删9列，普通助手/历史结果保留。MySQL5.7隔离迁移与恢复演练通过；线上4个PHP文件部署，71项本机HTTPS/FPM假模型检查通过，23张无关表、原数据和私密环境逐行一致，worker实际消费失效合成任务后恢复，0次收费调用。服务器备份：`/root/airz-backups/assessment-chat-compact-20260930-131231-873749/` ，恢复说明见后端`database/assessment-chat-compact.md` 。维护末尾探针已复查线上为8列；外网HTTPS仍连接重置，小程序/H5未发行。
用户本轮授权继续迁移与恢复方案，已完成111.230.144.231:3306/airz（服务器.env连接127.0.0.1）的评估版本正式迁移、21个配套源码文件部署、维护验收并恢复服务。MySQL5.7.44-log、PHP7.4.33；
63项真实服务器本机HTTPS/FPM和假模型检查通过：新建独立会话、修改复用并保存新JSON版本、失败保留旧报告、历史报告/匹配/助手/PDF、最新个人企业资料上限、鉴权/越权及Token撤销。www恢复扫描为0，systemd实际消费已不存在的合成任务通过；无storage error、队列为空，0次收费模型调用。合成用户/资料/会话/日志/Token/任务已清理。维护前无评估资料和报告，原普通助手449及两日志按旧列逐行摘要一致；22张无关表一致，仍1会员、6产品。
完整数据库、代码/.env/nginx及验收备份：`/root/airz-revisions-20260930/` ；三表迁移备份：`/root/airz-backups/assessment-revisions-20260930-115301-810221/` 。详细过程与恢复边界见后端`database/assessment-revisions.md` 。正式写入已恢复，禁止整表恢复旧备份或换回旧PHP丢失新增数据，不得重跑迁移或旧测试。本机worker仍不要连接活动库。
完整备份及验收摘要10个文件已下载到本机受限目录`D:/AAdesk/202609/airz-backups/assessment-revisions-production-20260930/` ，数据库gzip和代码tar.gz的SHA256均与服务器一致。无凭据final-summary.json保存实际结构、服务和63项检查结果；完整备份含私密环境和身份信息，不对外分享。临时运维脚本/截图在`C:/Users/JUN/AppData/Local/Temp/airz-maintenance-20260930/` ，不是公开应用代码。
前端原型09及版本流程此前已编译通过，**小程序/H5尚未发布**。体验版配置已有https://aitest.ychysg.cn/api/v1。外网本次HTTP301跳转正确HTTPS，但HTTPS仍Connection reset；此前备案阻断是历史证据，尚未确认当前外网重置原因。下一步排查外网访问、核对微信request合法域名，恢复后发行体验版并完成真机流程；服务器本机TLS通过不代表外网可用。
## 最新界面调整：2026-09-30 原型09还原
用户反馈报告与原型09差异较大，已重新对照原型图实施：白底、顶栏下载PDF、三栏、浅绿准备状态区（需补充时浅黄）、摘要正文、橙红编号重点改善项、固定底部“重新评估”。完整度/逐项事实/状态依据/核验边界移到“查看完整报告”，建议证据可展开，报告信息/独立新建/历史入口弱化。使用真实状态和实际建议，不补造B+或固定三条。重新评估仍修改同记录，报告版本/导出绑定及旧版失败提示保留；本轮仅前端显示调整，未迁移/部署。
页面验证使用现有Playwright CLI（ `C:/Users/JUN/AppData/Local/Temp/airz-revisions-20260929/report09-after-390.png` 等。微信/Android本地编译通过，微信胶囊和底部安全区已做布局处理，真机未验收。PHP/数据库/结果计算不变，正式发布状态仍见下节。
## 2026-09-30 评估版本与最新资料实现记录
已完成：fa_user_info每用户个人/企业各最多一条最新资料，保留企业名称/信用代码/经营月数，city_code在city前，delete_time末列；业务身份明文保存。新建评估新增fa_ai_chat，修改重评复用原会话并在fa_ai_chat_log.input_data增加JSON输入版本；最新成功匹配仍存fa_ai_chat.match_result数组。任务状态移到会话，历史输入/报告/匹配冻结在日志。无新业务表。
前端已接本人完整回填、提交版本冲突保护、档案版本分页、历史报告/匹配/对比/助手/行动/PDF及登录恢复。处理中或失败保留上次成功结果；历史解释只读，旧助手不切换上下文。关键代码已加中文注释。
验证：MySQL5.7.26和MySQL8隔离库各51项版本集成检查通过（含两个独立连接并发新建/修改）；5.7真实建表、合成迁移及备份恢复演练通过；微信/Android编译通过。H5在localhost:5173通过真实隔离后端8097联调修改回填、旧输入/报告/PDF/匹配/助手；假模型，不收费。未覆盖真机与正式模型语义。前轮历史验证数仅代表当时版本，旧任务测试依赖旧表结构不可对新版库直接运行。
本地阶段当时未发布；本轮用户授权后，正式迁移与PHP部署现已完成，详见顶端线上维护记录，小程序尚未上传。当前后端.env仍指远程正式库，不要直接启动本机worker或运行旧集成测试。迁移脚本和完整恢复方案位于 `D:/AAdesk/202609/airz/database/migrate_assessment_revisions.py` 、`database/assessment-revisions.md` ，本轮迁移不得重跑。
以下2026-09-29部署/表单恢复均为历史和本次迁移前基线；本轮结构是否上线以上方最新维护记录为准。正式域名外网HTTPS仍连接重置，本机联调不代表外网恢复。
收尾补测：390×844和1280×900下历史报告→匹配→对比→助手、行动页→修改回填、退出重进通过，最终console/pageerror均无新增错误；修复修改页onHide创建提示文本引起的attachVmProps错误。截图与临时脚本保留在 `C:/Users/JUN/AppData/Local/Temp/airz-revisions-20260929/` 。合成UI用户/Token/队列已清理，8097临时PHP及3309临时MySQL5.7已停止，隔离库文件和恢复备份保留。自动审批策略拦截了清理Python缓存的命令，后端未跟踪 `database/__pycache__/` 保留，不属于交付代码。
## 最新优先状态：2026-09-29 恢复原资料表单
个人／企业信用融资恢复至2026-09-23 19:04需求扩展之前的采集范围：删除融资金额、融资期限、资金用途、其他用途说明；保留经营月数和原有身份／经营收入／资产负债／资料授权。提交使用inputVersion=3，结果仍为resultVersion=2，保留报告三栏、产品匹配、助手、PDF与行动入口。v3不生成需求事实或匹配规则，不把取消采集的字段列为“未提供／待核实”、补填项或完整度扣分项；产品自身额度、期限、利率和用途资料保留。其他真实缺失或来源未核验仍按既有规则处理。
已按用户授权在111.230.144.231/airz执行：删除报告161/229、关联会话151/219及2条日志；普通助手449及其2条日志保留，会员1个、产品6个保留。fa_user_info删除requested_amount、requested_term_months、purpose_code、purpose_detail四列；input_version、analysis_context属于必要版本和快照元数据，继续保留。两个触发器同步移除需求列校验，输入版本允许1/2/3，接口新建最低3。22张不相关表摘要一致，log_bin_trust_function_creators临时开启后恢复0。备份：D:/AAdesk/202609/airz-backups/restore-profile-20260929-180938/。
PHP十个生产文件已通过宝塔文件页面部署，php-fpm/Redis/airz-analysis恢复active，最后worker PID604113、NRestarts0（后续须重查）。站点仍/www/wwwroot/xctai.cn；代码与nginx备份及临时验收包已归档/root/airz-profile-20260929/。前端改动尚需重新发行并上传微信体验版，H5未发布。
当前外网阻塞：aitest.ychysg.cn已被腾讯云备案检查拦截，HTTP跳转dnspod.qcloud.com/static/webblock.html，外网HTTPS连接重置。服务器本机TLS与应用接口通过，不等于外网可用；体验版联网前需完成域名备案／接入并复测。此前“外网正常”的记录仅代表早先验收时间。
验证：53项资料表单专项、51项匹配兼容、29项PDF、18项助手回复、29项助手金额检查通过；服务器维护窗口22项实际HTTPS与假模型流程通过，测试用户／Token／任务已清理，无收费AI调用。微信最终编译通过；Android编译通过，未覆盖真机。H5通过Playwright受控响应检查个人／企业表单及v3提交、报告和对比；仅用于页面验证，不能代替外网或真实模型验收。
恢复与旧脚本禁用说明见后端database/restore-profile-form.md。以下部署、历史报告保留及旧输入版本记录仅作历史追溯，与本节冲突时以本节为准。
2026-09-28 17:50:46 +08:00
## 1. 当前停在哪
2026-09-29 17:27:25 +08:00
最新部署（2026-09-29，优先于下文历史PID）：PHP后端已通过宝塔网站页面部署到 **https://aitest.ychysg.cn** ，
最新数据库切换（2026-09-29）：已完成用户授权的远程MySQL5.7.44迁移与后端连接切换，当前使用111.230.144.231:3306/airz及用户指定root账号。25表184行、2份历史报告内容摘要一致；20个CHECK用8个触发器保留，51项约束与24项应用/真实HTTP检查通过。log_bin_trust_function_creators临时设1后已恢复0，当时Web入口及本机worker已恢复；后续宝塔部署已停止本机worker并由远程接管。.env仅改database段，其余加密/Redis/Token配置保持；无真实AI调用。本机MySQL8保留回退，正式写入恢复后不能直接回切旧库丢弃新数据。最终备份D:/AAdesk/202609/airz-backups/mysql57-switch-20260929/prepared-20260929-144304/；后端database/mysql57-switch.md含完整记录，凭据不输出。后端schema.sql现为5.7含触发器结构，历史本机迁移脚本不得直接重跑远程。
最新（2026-09-29）：用户限定的07/08/09首屏调整已完成。08上下文一行摘要点击展开，历史入口弱化，其余助手界面保留；07核心参数三列同屏、完整依据可展开；09紧凑元信息/导出入口和浅色准备状态卡，改善内容更早出现。H5受控响应在360/390/1280px通过交互与截图验证，最终console无错误；Android/微信编译通过，详见进度6.25。无数据库/后端改动、无真实AI调用；下一步仍是真机/微信内H5/Safari验收。
用户要求界面内容尽可能还原`docs/原型.jpg` 。原型08已继续实施：界面、持久会话、固定评估/产品上下文、异步回复、分页、原键重试、共享额度、报告/产品/对比入口及登录返回已完成本地联调；关键代码有中文注释。原型10也已完成本地联调；09 PDF普通H5也已实施；08累计13次真实调用，新增连续三轮金额精度专项已通过；下一步为移动端、跨平台与真实产品验收。
2026-09-28 17:50:46 +08:00
| 内容 | 当前状态 |
| --- | --- |
| 04/05 产品匹配详情 | 原型布局与单产品解释保留；咨询AI已接08；产品对比仍可进入 |
| 06 产品详情 | 公共资料和本次评估冻结快照分开读取 |
| 07 产品对比 | 同次2—3产品、补选/移除/刷新保留；可带选择进入08，PRODUCT-005待验收 |
2026-09-29 17:27:25 +08:00
| 08 上下文AI助手 | CHAT-001—003待验收，CHAT-004开发中；76项助手回归通过，H5及平台编译为前轮结果；演示边界与金额精度真实三轮专项通过，真机/跨平台待验收 |
2026-09-28 17:50:46 +08:00
| 09 报告 | 三栏及本次报告咨询AI入口完成；REPORT-004整体仍开发中；REPORT-005普通H5导出已本地验证，平台/容量待验收 |
| 10 下一步行动 | REPORT-006待验收；四项行动/登录恢复/状态守卫已接通，38项H5检查及Android/微信编译通过 |
2026-09-29 17:27:25 +08:00
当前27个注册页面、63个稳定任务编号。本轮承接上一轮前后端未提交改动并保留；未提交/推送。PHP后端已部署，H5尚未发布。
2026-09-28 17:50:46 +08:00
## 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。登录后只接受白名单助手返回并重新鉴权。
2026-09-29 17:27:25 +08:00
- 2026-09-29在首轮6次、边界4次之后，追加同一对比会话3轮真实Flash金额复测，全部成功落库，持续保持123456.78元＝12.345678万元，口头修改不影响冻结报告和三态。本轮输入16582/输出971 token，累计13次、输入51709/输出3391 token；无自动重试。第1项金额专项限定样例通过，不能外推为全量真实产品或所有输出格式通过。见[真实语义验收记录 ](AI助手真实语义验收.md )。
2026-09-28 17:50:46 +08:00
2026-09-29 17:27:25 +08:00
tests/assistant_semantics.php支持--boundaries定向4例、--money-precision同会话3例，默认只读计划，显式--fake/--live；
原型10及09 PDF已实施；下一步做移动端键盘／安全区／长回复滚动／返回恢复／失败重试，再补微信内H5/Safari、真实产品人工样例及生产容量验收。供应商与真实产品准备仍可推进，不虚构整体完成率。
2026-09-28 17:50:46 +08:00
## 3. 必须延续的业务约定
2026-09-30 19:11:44 +08:00
- 不做草稿；新建评估进入空白表单并新增会话，修改评估回填本评估最新提交并复用会话、增加版本。
- fa_user_info每用户每类型仅存最新资料；fa_ai_chat保存独立评估及最新成功报告/匹配数组；fa_ai_chat_log.input_data保存历史输入与该版结果，原消息和调用日志保留。不新建独立评估/报告/匹配表。
2026-09-28 17:50:46 +08:00
- Token保存在Redis，
- 金额数据库DECIMAL(11,2)，单位元；API用元十进制字符串；客户端万元，保留精度，例如123456.78元显示12.345678万元。
- 产品稳定条件、额度/期限/利率等使用独立字段，地区/补充规则JSON；沿用冻结产品快照，不用当前产品参数覆盖历史。
- 规则决定eligible/ineligible/unknown，
- 申请仅限资料准备与引导；不提交银行申请、不声称受理成功。真实产品尚未提供，本地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× × ×
- 合成测试账号/评估/会话/日志、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× × `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， `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：
本轮曾被自动审批拒绝组合UI夹具启动，改以受控响应验证浏览器，不声称完整真实浏览器联调。真实HTTP检查独立通过。全部真实合成账号/Token/队列已清理；原两份报告摘要相同。worker现PID34324， `C:/Users/JUN/AppData/Local/Temp/airz-report-pdf-20260928/` 。
## 6. 环境与验证命令
前端目录：`D:/WorkSpace/cyun/ai融资` ， `D:/AAdesk/202609/airz` ，
```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
2026-09-29 17:27:25 +08:00
& 'D:/Develop/phpstudy_pro/Extensions/php/php7.4.3nts/php.exe' tests / assistant_reply . php
& 'D:/Develop/phpstudy_pro/Extensions/php/php7.4.3nts/php.exe' tests / assistant_money . php
# 默认仅输出计划；--fake --worker-stopped才执行合成流程。
& 'D:/Develop/phpstudy_pro/Extensions/php/php7.4.3nts/php.exe' tests / assistant_semantics . php - -money-precision
2026-09-28 17:50:46 +08:00
# --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. 新会话可以直接发送
2026-09-29 17:27:25 +08:00
> 请先阅读docs/新会话交接.md、开发进度0.23/6.24和原型04-10页面方案，继续原型08移动端及跨平台验收，先阅读AI助手真实语义验收记录：金额精度三轮真实专项已通过，无需重复收费调用；核对可用浏览器和真机环境，清楚区分模拟与真机结果。界面尽量还原docs/原型.jpg，关键代码加中文注释；保留已有04/05解释、07对比、08上下文助手、09报告及10行动成果。只做材料准备与引导，不提交银行申请；PDF未完成时不做假下载。先检查工作树与数据库/worker现状，新增迁移仍按具体方案申请授权。
