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/上下文AI助手开发契约.md
+53
View File
@@ -0,0 +1,53 @@
# 原型08上下文AI助手
版本1.0，2026-09-28。CHAT-001—003完成本地接口和页面联调，待验收；CHAT-004异常与额度本地检查通过，真实DeepSeek多轮语义、移动端真机与商业额度仍待验收。
## 1. 会话与事实边界
- 复用`fa_ai_chat`/`fa_ai_chat_log`，不新增业务表。助手始终`scene=assistant`、`assessment_id=NULL`、`analysis_context=NULL`。
- `context_assessment_id`可空，仅引用本人成功评估；复合外键`(context_assessment_id,user_id)`防跨账户绑定。`context_data`保存版本、创建幂等键、最多3个产品ID和冻结事实摘要，不接收客户端报告正文。
- 普通、报告、单产品、2—3项对比均可进入。服务端读取冻结报告、匹配理由和证据，白名单排除姓名、手机、证件、附件、职业及自由用途说明；产品名称/数字/判定采用评估时版本，不读取当前产品替换历史事实。
- 会话固定上下文。URL指定的评估及产品须与chatId一致；上下文删除、失效或摘要变化则拒绝。后续单产品AI解释和当前上下架状态不参与摘要，不影响会话恢复。
- 模型仅解释，不改变规则结论，不生成匹配率、获批概率或授信承诺。系统约束和输出格式校验不等同于语义完全正确，正式上线仍需真实多轮人工验收。
## 2. 已实现接口
均为会员Bearer、`Cache-Control: no-store`、FastAdmin响应格式。业务成功HTTP200不表示异步模型完成。
| 方法与路径（前缀/api/v1） | 参数 | 返回data |
| --- | --- | --- |
| GET /assistant/context | contextAssessmentId可空字符串、contextProductIds逗号列表 | 上下文标题、产品名/实际状态、快捷问题和说明；不创建会话、不调用模型 |
| GET /assistant/chats | limit字符串1—30，默认20；cursor可空 | 本人普通会话items、hasMore、nextCursor；按创建ID倒序 |
| POST /assistant/chats | requestId；contextAssessmentId字符串或null；contextProductIds字符串数组 | chatId、title、context；只创建会话，不调用模型 |
| GET /assistant/chats/:id | 可选contextAssessmentId/contextProductIds，同preview格式 | chatId、title、context；传入上下文时严格核对一致 |
| GET /assistant/chats/:id/messages | limit字符串1—30，默认20；cursor可空 | chatId、items、hasMore、nextCursor；首屏最新20轮，页内按时间正序 |
| POST /assistant/chats/:id/messages | requestId、message、retryAttempt整数0—2 | chatId、item；queued/running/completed/failed |
requestId为8—64位字母、数字、下划线、短横线。message为1—800字纯文本。拒绝额外参数、无评估产品列表、重复产品或超过3项产品。创建同键不同绑定、发送同键不同正文均409；越权或不存在404，未完成报告409，未配置模型503，超额度429，非法参数422。
每轮DTO为`{id,requestId,message,reply,status,attempt,canRetry,createdAt}`，reply仅成功时非空。消息内部调用行、错误码、凭据、用量不透传页面。加密游标绑定用户及会话，不能跨会话使用。
## 3. 异步、重试与额度
- 用户明确发送后，在用户行锁及会话行锁中保存用户消息并预留assistant调用行。`ast:`前缀调用日志是持久待办，既有`analysis:work`在报告和产品解释队列空闲时消费。
- 每会话最多100轮、同一时间只有一条回复在排队/执行。每用户每天最多新建30个会话。模型调用与报告和产品解释共享`deepseek.daily_calls_per_user`（本地默认20），失败也占预留次数，防止故障重试无限计费。
- 第一次retryAttempt=0。HTTP回执丢失必须原requestId/正文/重试序号重放，不增加调用。已确认失败后，用户手动重试保持requestId、retryAttempt递增，最多3次；只能重试最近一轮，成功和运行中均不能重跑。
- 每次尝试独立assistant日志，reply_id指向同一用户消息。保留所有尝试用量；tokens未知保持null，不把失败当零消耗。MySQL可重复读下关键幂等、序号和额度查询使用锁定当前读，避免旧快照绕过串行用户锁。
- 运行租约`max(180秒,供应商timeout+60秒)`。超时由worker恢复扫描标失败，不自动收费重试；迟到响应只能补原调用用量，不能改成成功或覆盖新尝试。
- 默认Flash，复用既有DeepSeekClient。上下文保留最近6轮成功问答（失败不发送），回复最长1200字，总请求序列化最多96KB；用户主动输入的手机号、身份证及长银行卡号脱敏后才发送模型。不声称自由文本已完全去除所有个人信息。
## 4. 页面与返回
机器人、问候气泡、浅蓝快捷问题及底部输入栏参考原型08，复用现有素材；上下文卡为必要增补。普通模式不假定已有报告。快捷问题按实际判定生成，点击仅填入问题，点击发送才请求模型。
首次发送创建会话并在H5地址中保存chatId，刷新重新鉴权恢复；历史对话入口可恢复普通或上下文会话。消息3秒轮询，最多60次，超限/查询失败提供继续查询。失败明确提示并支持原键重试。消息、报告不落本机持久缓存；离页清理渲染和轮询，Token变化拒绝迟到回包并清除内容。
04/05咨询入口保留产品ID，07保留产品选择，09带本次评估；navigateBack优先保持原页面状态。冷启动的返回产品/对比/报告仅由白名单来源与编号重建；普通模式回首页。登录页只支持白名单助手返回，拒绝任意returnUrl；登录后再次校验归属。
## 5. 迁移与验证
本轮用户明确授权本机迁移后，执行后端`database/migrate_assistant_context.py --apply --worker-stopped`。新增2列、索引、归属外键与场景检查约束共5项；复跑预检0项。备份位于`D:/AAdesk/202609/airz-backups/assistant-context-20260928-154651-271907/`。恢复优先回退助手代码并保留可空列，不整表覆盖后续业务数据，详见后端`database/assistant-context-migration.md`。
后端70项助手检查、51项产品解释、31项任务、36项评估HTTP、70项匹配HTTP/快照检查通过。HBuilderX5.26 Android与微信编译通过。H5 Chromium390×844、1280×900验证普通/上下文、三入口、发送/刷新/失败重试、回执丢失、23轮历史分页、上下文冲突、跨账号及真实密码登录返回；模型输出使用假模型，未新发收费DeepSeek调用。最终正常流程无业务console.error/warn。
临时截图/脚本：`C:/Users/JUN/AppData/Local/Temp/airz-assistant-20260928/`。合成账号/评估/会话/日志/令牌/队列已清理，隔离服务和浏览器已关闭。原有2份评估会话及2条调用记录逐条对照迁移前备份未改写。未验收：真实多轮模型语义、真实产品人工金标准、微信内H5/Safari、真机键盘/安全区以及生产守护/容量。
docs/产品匹配规则开发契约.md
+55
View File
@@ -241,3 +241,58 @@ productSnapshot包含产品ID/版本/名称/机构/类型，amountMinYuan、amou
报告入口携带assessmentId；列表三组统计与分页来自同次结果；卡片只预览最多三条主要理由，详情保留全部不符/待核实理由，已满足项可展开。无评估编号时选择历史或重新评估；非法编号明确错误，绝不读取最近结果。详情无assessmentId只展示公共资料，有assessmentId始终读取本人快照。页面离开清空结果，响应返回时校验当前Token和请求序号，防止旧账户迟到响应恢复界面。
本轮`tests/match_records.php --worker-stopped`62项验证接口身份/方法、三组、游标分页和篡改、快照归属、未知键投影、损坏数据、下架/过期/删除/改价后历史、旧版报告、重复读取无副作用。产品变化只在测试连接事务内发生并回滚，随机账户及队列清理；停止正式worker以避免恢复扫描拾取合成评估。浏览器结果及截图见开发进度6.13。
## 9. 单产品解释任务与原型04/05（2026-09-28已实现，覆盖第7/8节的未接入状态）
### 9.1 接口与状态
`POST /api/v1/assessments/:id/matches/:productId/explanation`要求会员Bearer Token、本人成功且未删除评估及该产品冻结结果，Content-Type为application/json。请求只允许`{"requestId":"explanation_20260928_001"}`；requestId为8—64位ASCII字母/数字/下划线/短横线，无金额或模型参数。重复读取GET不生成解释。
HTTP200沿用`{code:1,msg,time,data}`，data与匹配详情相同，不表示模型已经完成；客户端检查item.aiExplanation.status。queued/running期间轮询原GET匹配详情。例：
```json
{
"status": "completed",
"text": "该项信息来自自填资料，仍需核对证明材料。",
"evidenceRefs": ["product:22:rule:base_amount"],
"reasonExplanations": [{
"reasonId": "product:22:rule:base_amount:reason",
"text": "该项信息来自自填资料，仍需核对证明材料。",
"evidenceRefs": ["product:22:rule:base_amount"]
}],
"generatedAt": "2026-09-28T07:07:00+00:00",
"errorCode": null,
"canRetry": false
}
```
上例只说明结构，不是完整产品样例。text/evidenceRefs兼容已有消费者；逐条渲染使用reasonExplanations，数值/来源仍取确定性证据，不能从模型文本反解析金额。首次not_requested；queued/running保留空文本/数组；失败为failed，errorCode仅固定错误码，canRetry表示未超过三次上限；成功为completed并带生成时间。有效的旧not_requested对象缺新增字段时，前端按空值兼容。
| HTTP/错误 | 含义与行为 |
| --- | --- |
| 401 AUTH_REQUIRED | 会话失效；客户端清理并回登录 |
| 404 ASSESSMENT_NOT_FOUND / MATCH_NOT_FOUND | 非本人、已删记录或产品不在本次快照；不回退公共产品 |
| 409 REPORT_NOT_READY / MATCH_RESULT_UNAVAILABLE | 报告未成功或存储结构损坏，不调用模型 |
| 422 VALIDATION_ERROR | 非法requestId或多余请求字段 |
| 503 ANALYSIS_NOT_CONFIGURED | 模型服务未配置，不预留新调用 |
| 429 AI_DAILY_LIMIT | 与报告共用当日用户预留额度，开发默认二十次 |
| 409 AI_ATTEMPT_LIMIT | 每评估每产品最多三次尝试，不再创建任务 |
模型/网络失败写入状态，不使用供应商异常正文：AI_TIMEOUT、AI_NETWORK、AI_AUTH、AI_CONFIGURATION、AI_BALANCE、AI_RATE_LIMIT、AI_PROVIDER_ERROR、AI_INVALID_RESPONSE、AI_INVALID_REPORT、AI_TASK_INTERRUPTED等。用户可读状态与规则理由仍保留；不自动重新调用收费模型。
### 9.2 持久化、幂等和恢复
- fa_ai_chat.match_result中的单项ai_explanation保存状态、reason_explanations及生成时间；内部还保存task_id/request_keys/attempts/lease_until。只更新这一个对象，不修改冻结参数、证据、判定、排序、报告或评估生命周期。不同产品更新同一JSON时使用会话行锁，防止相互覆盖。
- fa_ai_chat_log使用role=assistant、request_id前缀`pex:`、pending/streaming/completed/failed以及已存在的模型/Token/耗时/错误字段。用户行锁串行预算预留；会话锁串行序号和快照写入。数据库事务原子保存任务和快照状态，不新增业务表/索引/迁移。
- 相同requestId重放返回当前状态；queued/running期间不同键也合并为同一任务；成功后不同键返回历史解释。明确failed后用户使用新键重试，最多三次。次数包含失败和不确定超时，防止无限收费。
- analysis:work继续优先处理既有报告队列，空闲时领取一条持久解释日志；pending任务无需Redis投递，进程重启不会丢失。租约为max(180秒,供应商超时+60秒)，streaming过期改失败；`--recover-only`也回收解释租约，不调用模型。服务停机期间queued保持等待，恢复进程后继续消费。
- 多worker用日志状态和会话锁只允许一次领取。迟到回复不得回写已失效任务，已发生用量仍补记原日志。删除评估/禁用账户后不保存成功解释。运营需关注pending积压、失败错误码和调用用量；当前未实现独立解释后台管理页。
- 分页摘要排除ai_explanation，解释生成不使产品分页失效；其他冻结字段仍参与摘要并校验。部署时已有旧摘要游标可收到一次MATCH_CURSOR_INVALID，重新从首屏读取即可，不改历史报告。
### 9.3 模型边界与页面
使用已配置deepseek-v4-flash-0731，只发该产品规则理由、字段白名单、actual/expected/source/outcome，不发送姓名、电话、证件、附件、机构说明自由文本或完整报告。模型输出仅reasons数组，每项reasonId/text；按ID集合检验恰好覆盖所有理由，无重复、遗漏和外来ID，恢复规则顺序后由服务端附原证据引用。每条最多九十字，数字/金额/期限/HTML/明显授信承诺等拦截。确定性校验不能替代真实产品人工语义金标准，正式机构资料仍待验收。
页面生成期间可离开，重新打开读取保存状态；每三秒查询、最多六十次，断网/轮询结束提供手动查询，不重提任务。页面离开清理个人数据和计时器；迟到回包校验Token/请求序号/可见性。初始依据、AI解释失败、已保存解释可区分；已有数值仍以万元精确展示。布局与有意差异见原型方案第8节。
验证入口：`php tests/product_explanations.php --worker-stopped`（51项，假模型）；可选`--live`额外调用一次真实Flash。`php tests/match_records.php --worker-stopped`更新为70项，含解释POST方法、归属、参数、删除记录和幂等回执。必须先停止worker，测试仅清理其随机账号/日志/评估/队列。真实模型和浏览器验证记录见开发进度6.18。
docs/原型04-10页面改造与跳转方案.md
+26 -12
View File
@@ -1,11 +1,11 @@
# 原型04—10页面改造与跳转方案
版本：1.3。日期：2026-09-28。依据：[原型图](原型.jpg)、[开发文档](开发文档.md)、[数据契约](需求与评估结果数据契约.md)。本轮用户明确要求补齐04—10页面并随后进入产品匹配开发；此前“对比/PDF另行排期”的范围限制，自本方案起由下列正式任务覆盖。
版本：1.7。日期：2026-09-28。依据：[原型图](原型.jpg)、[开发文档](开发文档.md)、[数据契约](需求与评估结果数据契约.md)。本轮用户明确要求补齐04—10页面并随后进入产品匹配开发；此前“对比/PDF另行排期”的范围限制，自本方案起由下列正式任务覆盖。
## 1. 范围与落地原则
- 04、05是同一产品匹配详情的不同判定状态，06是同一详情页的产品信息栏；复用现有product/product，不机械新增三个页面。
- 07产品对比、10下一步行动新增两个融资分包页面。compare已注册，当前pages.json共26页；next-step仍待开发注册，最终目标27页。
- 07产品对比、10下一步行动新增两个融资分包页面。compare与next-step均已注册，当前pages.json共27页。
- 08复用assistant/assistant；09复用report/report并改为“评估概况／匹配结果／改善建议”。03匹配列表作为04—10的必要入口一并改造。
- 保留蓝白主色、卡片、银行标识、正反理由分组和清晰底部行动区。数据必须来自本人本次评估；原型的92%/B+不作为默认值。
- 首版使用既有三态准入：符合已知条件、条件不符、待核实。score=null，不展示匹配百分比；稳定顺序采用productId升序并注明不代表优劣。真实评分、运营优先级另发版本化策略。
@@ -17,13 +17,13 @@
| 原型 | 页面实现 | 页面内容与行为 | 任务 | 当前状态 |
| --- | --- | --- | --- | --- |
| 04 单家银行AI解释 | product/product，tab=explanation，eligible状态 | 银行/产品名、条件判定、已满足条件、注意事项、证据来源、AI解释、对比/准备申请 | PRODUCT-004 | 基础已接规则理由/证据/历史快照及对比；单产品AI解释和行动页待开发 |
| 05 其他银行不推荐解释 | 同一页面，ineligible或unknown状态 | 不符条件与待核实项分组；已满足部分称“已满足条件”；查看资料/询问AI，不建议直接申请 | PRODUCT-004 | 已接不符/待核实及证据；AI咨询待接；服务端判定决定状态 |
| 04 单家银行AI解释 | product/product，tab=explanation，eligible状态 | 银行/产品名、条件判定、已满足条件、注意事项、证据来源、AI解释、对比/准备申请 | PRODUCT-004 | 布局按原型还原；逐条DeepSeek解释/持久任务/失败重试本地验证通过；准备入口已接10，真实产品/平台待验收 |
| 05 其他银行不推荐解释 | 同一页面，ineligible或unknown状态 | 不符条件与待核实项分组；已满足部分称“已满足条件”；查看资料/询问AI，不建议直接申请 | PRODUCT-004 | 已接不符/待核实、逐条解释和证据；AI咨询已接08上下文；服务端判定决定状态 |
| 06 产品详情 | product/product，tab=details或conditions | 额度/期限/年化利率范围、还款方式、材料、渠道、适用对象、来源及版本；独立显示当前可用性 | PRODUCT-003、PRODUCT-004 | 已接三栏、公共/历史双模式及当前可用性；真实机构资料待录入 |
| 07 同类产品对比 | 新增compare/compare | 同一评估2—3个产品列式对比，首列指标固定，移动端横向滚动；条件判定、金额/利率/期限、材料、差异依据 | PRODUCT-005 | 基础完成，本地联调通过；真实产品及平台待验收 |
| 08 AI助手延伸问答 | assistant/assistant | 本次评估及选定产品上下文卡、按实际判定生成快捷问题、持久会话、分页、重试、返回报告/产品 | CHAT-001—004 | 页面已有；真实上下文问答待接 |
| 09 我的融资报告 | report/report | 三栏内容、资料准备状态、完整度、最多三个候选及查看更多、改善项、PDF下载、重新评估、下一步行动 | REPORT-004、REPORT-005 | 三栏/历史候选/改善证据基础已联调；PDF及行动入口待独立任务 |
| 10 下一步行动 | 新增next-step/next-step | 准备申请、查看已保存报告、下载PDF、优化资料、咨询AI、回首页；依结果决定可用行动 | REPORT-006 | 新增任务，未开始 |
| 08 AI助手延伸问答 | assistant/assistant | 本次评估及选定产品上下文卡、按实际判定生成快捷问题、持久会话、分页、重试、返回报告/产品 | CHAT-001—004 | 页面已有；持久上下文/异步问答/分页重试已本地联调，真实语义与真机待验收 |
| 09 我的融资报告 | report/report | 三栏内容、资料准备状态、完整度、最多三个候选及查看更多、改善项、PDF下载、重新评估、下一步行动 | REPORT-004、REPORT-005 | 三栏/历史候选/改善证据基础已联调；行动入口已接10，PDF普通H5基础完成，跨浏览器/真机待验收 |
| 10 下一步行动 | 新增next-step/next-step | 准备申请、查看已保存报告、下载PDF、优化资料、咨询AI、回首页；依结果决定可用行动 | REPORT-006 | 本地联调完成，38项H5检查与Android/微信编译通过；真实产品与平台待验收 |
### 03 匹配列表入口（必要配套）
@@ -41,7 +41,7 @@
产品快照中的额度/利率/期限保持评估时版本。读取时发现当前产品下架/过期，另加状态条并禁用准备申请；查询当前状态失败也不能假定可用。允许查看历史解释、参与带状态标识的历史对比或咨询AI。
金额以万元范围展示，期限以月、年化利率以百分比范围展示。缺还款方式/审批时长/渠道等资料时显示“未提供”，不得采用原型示例值。银行Logo只使用已提供或可合法使用的真实素材；缺失时用文字简称，不生造银行标志。
金额以万元范围展示，期限以月、年化利率以百分比范围展示。缺还款方式/审批时长/渠道等资料时显示“未提供”，不得采用原型示例值。银行Logo只使用已提供或可合法使用的真实素材；缺失时用文字简称或既有通用机构图标，不生造银行标志。
“准备申请”仅当eligible且currentAvailability=available时进入10的准备区域；“查看同类产品对比”进入07并保留当前产品选择；“我有疑问，咨询AI”进入08，展示上下文而不自动发送消息或调用模型。
@@ -58,7 +58,7 @@
- 有assessmentId时，只使用本人已成功报告和指定产品的冻结理由；可不指定产品、指定单项或指定对比的2—3项。
- 快捷问题按实际状态生成，例如“这些条件为什么符合”“哪些条件不满足”“还需要核实哪些资料”“两项产品有哪些差异”；无匹配时不出现“为什么推荐这家银行”。
- 输入问题后由用户发送；仅打开页面不创建模型请求。失败重试保持消息requestId，切换账号清理页面内容。
- 普通会话继续使用scene=assistant，assessment_id=NULL；计划随CHAT-001增量迁移新增context_assessment_id及context_data，前者保存本人评估引用，后者保存产品ID及报告摘要引用。当前库尚无这两列，本轮不迁移；已有普通会话两列为NULL，新增归属索引/约束需先检查历史数据，不复用或覆盖正式评估的analysis_context。
- 普通会话继续使用scene=assistant，assessment_id=NULL；CHAT-001已增量迁移新增context_assessment_id及context_data，前者保存本人评估引用，后者保存产品ID及报告摘要引用。2026-09-28已获用户授权完成两列、归属索引/外键及场景约束迁移；原有记录新增列为NULL，不复用或覆盖正式评估的analysis_context。
- chatId恢复时以服务端已保存上下文为准；URL与会话上下文冲突拒绝，不静默改绑定。失效上下文提示重新选择，不能回答成另一份报告。
### 09 报告三栏与PDF
@@ -136,9 +136,9 @@ flowchart TD
| GET /api/v1/assessments/:id/matches | 已实现 | 03/09，三态分页、默认limit=3；既有契约字段不变 |
| GET /api/v1/assessments/:id/matches/:productId | 已实现 | 04/05/06，以及07每次最多读取三项；本人成功记录、本次冻结产品，404不得回退公共数据 |
| GET /api/v1/products/:id | 已实现，会员Bearer | 06公共模式；不含个人判定及理由，当前资料与历史快照分开 |
| POST /api/v1/assistant/chats | 计划新增 | contextAssessmentId:string或null、contextProductIds:string[]、requestId；服务端校验同一评估和产品快照，不接客户端报告正文 |
| GET/POST /api/v1/assistant/chats/:id/messages | 计划新增 | 08消息分页、提交与幂等；上下文由会话固定 |
| GET /api/v1/assessments/:id/report.pdf | 计划新增，REPORT-005 | Bearer鉴权；成功application/pdf，Content-Disposition安全文件名、no-store；401/404/409/503为JSON错误；失败不生成报告或调用模型 |
| POST /api/v1/assistant/chats | 已实现，见助手契约 | contextAssessmentId:string或null、contextProductIds:string[]、requestId；服务端校验同一评估和产品快照，不接客户端报告正文 |
| GET/POST /api/v1/assistant/chats/:id/messages | 已实现，见助手契约 | 08消息分页、提交与幂等；上下文由会话固定 |
| GET /api/v1/assessments/:id/report.pdf | 已实现，REPORT-005待验收 | Bearer鉴权；成功application/pdf，Content-Disposition安全文件名、no-store；401/404/409/503为JSON错误；失败不生成报告或调用模型 |
PDF接口owner校验先于渲染，未完成返回409 REPORT_NOT_READY，格式不支持409 REPORT_FORMAT_UNAVAILABLE，能力不可用503 REPORT_EXPORT_UNAVAILABLE。仅由受控模板渲染，用户文本转义，禁止任意HTML/外部图片URL触发文件或网络读取。客户端按状态码和Content-Type区分PDF与JSON，不把错误响应另存为PDF。
@@ -205,3 +205,17 @@ report/report的overview/matches/improvements已接现有报告与匹配只读
匹配栏默认eligible前3项，改善栏分别读取ineligible/unknown前3项，各有完整列表和产品详情入口，不把摘要当全部结果。关联产品证据直接展示规则理由、字段值和来源；AI改善文字保留报告中的字段/准备依据标签。读取时核对报告与列表的版本、目录标识及三态统计，异常保留其他可用区块并单独重试。
“重新评估”选择主体后清空流程内存进入空白表单，历史报告不编辑。PDF、下一步行动及上下文问答按钮待对应能力完成后接入。26页、63任务编号和历史估时不变；REPORT-004整体保持开发中，具体验证/剩余边界见[开发进度6.17](开发进度.md)。
## 8. 2026-09-28 原型04/05还原记录
- 已实现：白底、紧凑机构头部、状态标签、三栏蓝色选中线、绿色/橙色编号、理由标题和灰色解释、双按钮底栏。将重复“资料尚需核验”从长标题移至说明和证据，避免窄屏标题折断；全部原始证据仍可展开。
- 数据差异：无匹配百分比；只展示有依据的真实数量，不凑三正三反；不符/未知产品的绿色标题使用“已满足的条件”；机构资料尚为明确标注的演示数据，使用通用图标。
- 操作差异：立即申请暂用“查看资料准备”，只切申请条件栏；05的咨询按钮待08上下文问答完成后接入，当前为可用的产品对比入口。生成AI解释为独立明确点击，成功后逐条补充且重新打开不重复生成。
- 栏目切换替换当前路由，保留assessmentId/productId/productIds/from；刷新停留原栏，退出页面停止轮询并清理个人数据。默认每三秒读状态，最多六十次，失败或停止后可手动重新查询；不发起新模型任务。
- 视觉/功能验证：Chromium 390×844、390×1000、1280×900；参考图原始单页约220×568像素，已查看原图和放大局部，并用接近其纵横比的390×1000屏幕检查。记录见开发进度6.18，不代表微信内浏览器或真机验收。
2026-09-28原型08实施补充：创建/详情/历史/上下文预览和消息API、重试序号及迁移恢复以[上下文AI助手开发契约](上下文AI助手开发契约.md)为准。CHAT-001—003本地联调后待验收，CHAT-004真实语义/生产容量仍开发中。
### 2026-09-28 PDF落地补充
09顶部与10页共用鉴权下载组件，服务端内存生成并输出二进制，无公开文件。Dompdf3.1.6及Noto Sans SC中文字体独立锁定；逐字段脱敏、转义和远程读取禁用。普通H5真实下载，微信内/原生/小程序提示使用普通浏览器。29项模板、20项HTTP、24项受控浏览器检查通过，平台/容量待验收；详见进度6.21。
docs/开发文档.md
+43 -4
View File
@@ -1,9 +1,37 @@
# AI 融资平台开发文档
> 版本：v1.14 · 基线日期：2026-09-22 · 更新日期：2026-09-28 · 状态：匹配分页/详情及公共产品详情已接通；03/04/05/06基础接入，07对比与09报告三栏本地联调通过；08助手、09PDF、10行动待开发
> 版本：v1.18 · 基线日期：2026-09-22 · 更新日期：2026-09-28 · 状态：匹配分页/详情及公共产品详情已接通；04/05按原型还原并接通单产品DeepSeek解释，07对比与09报告三栏本地联调通过；08上下文助手本地联调通过，真实多轮语义/真机待验收；10行动本地联调通过；09PDF普通H5本地验证通过，平台/容量待验收
> 配套台账：[开发进度](开发进度.md)。本文定义范围、接口和验收口径，台账记录实际执行与证据。
> 文档初始规划后已开始开发；以下更新记录优先于原始基线。除明确列为已实现的部分外，计划接口和增量数据仍待开发。
### 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真实多轮语义、真实产品样例及跨浏览器/真机验收，生产导出容量仍需评估。
### 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.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. 2026-09-22 实施更新
- 用户最新决定：删除fa_user_token，会员Token仅存Redis；已备份并删除本地表，当前25张表。fa_user和各业务关系保持不变。运行配置不再依赖MySQL Token驱动。
@@ -176,6 +204,16 @@ 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及真机仍待验收。
## 1. 项目目标与现状
### 1.1 已确认范围
@@ -190,7 +228,7 @@ REPORT-004页面子项完成本地联调：report/report改为评估概况、匹
| 项目 | 当前事实 | 规划用途 |
| --- | --- | --- |
| 前端 | uni-app x / Vue 3 / UTS，26 页，无独立 npm 构建入口 | 沿用 HBuilderX 和现有分包，不重新搭建前端 |
| 前端 | uni-app x / Vue 3 / UTS，27 页，无独立 npm 构建入口 | 沿用 HBuilderX 和现有分包，不重新搭建前端 |
| 后端 | FastAdmin / ThinkPHP 5.0.28 / PHP 7.4 | 复用认证、后台、模型与队列依赖，新增业务 API/服务 |
| 数据库 | MySQL 8.0.44，删除空 Token 表后实际 25 张 InnoDB 表 | 已核对本地库并更新结构快照；恢复点见进度第0节 |
| 当前前端模式 | 开发环境已连接本地 v1 API，模拟请求开关关闭 | 密码账户流程已接入，内容与产品匹配等页面仍有原型数据，不按页面数计算完成度 |
@@ -217,9 +255,9 @@ REPORT-004页面子项完成本地联调：report/report改为评估概况、匹
## 2. 页面与功能覆盖
路由以 [pages.json](../pages.json) 为准。以下覆盖现有全部 26 页；反馈表单、历史列表等优先补入所属现有页面，若交互确需新增页面，在所属分包注册并同步台账。
路由以 [pages.json](../pages.json) 为准。以下覆盖现有全部 27 页；反馈表单、历史列表等优先补入所属现有页面，若交互确需新增页面，在所属分包注册并同步台账。
原型07路由`packages/finance/compare/compare`（PRODUCT-005）已注册，现共26页；`packages/finance/next-step/next-step`（REPORT-006）待开发注册，目标共27页。04/05/06均复用product/product，报告PDF不另加页面。参数与返回矩阵见专项页面方案第3节。
原型07路由`packages/finance/compare/compare`（PRODUCT-005）与10路由`packages/finance/next-step/next-step`（REPORT-006）均已注册，现共27页。04/05/06均复用product/product，报告PDF不另加页面。参数与返回矩阵见专项页面方案第3节。
| 序号 | 页面路由 | 功能职责 | 主要任务 |
| --- | --- | --- | --- |
@@ -249,6 +287,7 @@ REPORT-004页面子项完成本地联调：report/report改为评估概况、匹
| 24 | packages/content/classroom/classroom | 课程分类和推荐 | CONTENT-002 |
| 25 | packages/content/lesson/lesson | 图文章节、学习状态 | CONTENT-001、CONTENT-003 |
| 26 | packages/finance/compare/compare | 同次评估2—3产品冻结结果对比、补选及独立重试 | PRODUCT-005 |
| 27 | packages/finance/next-step/next-step | 材料准备、已存报告、资料优化及同类型新评估、上下文AI与首页 | REPORT-006 |
## 3. 数据与架构约定
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/真机验收；真实模型调用会产生用量，应在具体样例及预算边界明确后执行。
docs/新会话交接.md
+102
View File
@@ -0,0 +1,102 @@
# 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现状，新增迁移仍按具体方案申请授权。
docs/需求与评估结果数据契约.md
+1 -1
View File
@@ -171,7 +171,7 @@ unknown不是建议申请；ineligible不是永久拒绝。展示应为“本次
- 推荐依据 `positiveReasons`、不符条件 `blockingReasons`、待核实/注意事项 `cautions` 分开保存。首页各组最多展示三条；没有证据就不生成，详情可读完整列表。通过部分条件的不适配产品，其positiveReasons不能标成“推荐该产品”。
- 理由 `{reasonId,code,text,evidenceRefs}` 由确定性规则/模板生成，evidenceRefs至少一个且只引用本项证据。失败条件、未知依据全部保存，不能因为只展示三条而丢掉阻断项。产品公共优势不是用户个性化理由。
- 证据 `{evidenceId,ruleId,ruleVersion,kind,fieldRefs,operator,expected,actual,outcome,source,observedAt}` 固定类型、单位和来源。evidenceId在整份报告内唯一且稳定，例如由productId、ruleId和条目序号组成，不能让不同产品的同名规则共用ID。kind=hard/soft，source=self_reported/verified/product_snapshot；expected/actual金额保持元字符串，未知actual=null。规则快照保存requiredSource，复核时能判明证据是否够用。
- 单项 `aiExplanation={status,text,evidenceRefs}`，status=not_requested/completed/failed；只解释服务端已生成的理由，不能新增规则、伪造优势/风险或改判定。模型内容缺证据、含审批承诺或改写数值时拒绝保存该段，保留规则理由并显示解释暂不可用。不存在“必须每家补足三正三反”的生成要求。
- 单项 `aiExplanation={status,text,evidenceRefs,reasonExplanations,generatedAt,errorCode,canRetry}`，status=not_requested/queued/running/completed/failed（2026-09-28已实现）；reasonExplanations为`{reasonId,text,evidenceRefs}[]`，generatedAt为ISO时间或null，errorCode为稳定错误码或null，canRetry为boolean。taskId/leaseUntil/requestKeys/attempts仅内部保存，不通过DTO外发；只解释服务端已生成的理由，不能新增规则、伪造优势/风险或改判定。模型内容缺证据、含审批承诺或改写数值时拒绝保存该段，保留规则理由并显示解释暂不可用。不存在“必须每家补足三正三反”的生成要求。
证据类型增补：source在事实完全缺失/无法确定来源时允许null，不捏造self_reported/verified；observedAt未知也为null。额外提供requiredSource、reasonCode、valueType及unit，现已映射入正式match_result。not_applicable以product_snapshot作为适用范围依据来源。