zhaoshang_client_ui

zhaoshang-llm 改动记录

本文件当前只记录按日期的改动。项目概述、技术栈、目录结构、接口说明等内容， 等项目结束时再统一总结。

20260914

• AI 对话迁移到接口 POST /api/chat（SSE）
  • 新增协议适配层 src/components/api-chat-coordinator.ts，把 SSE 事件翻译成既有渲染组件 可识别的内容标记，渲染层无需感知新协议
  • 请求体严格只发 {thread_id, question}；answer 与 result.response 只展示一次； 未收到 done/error 即断流时按连接中断处理，不自动重试
  • 旧协议实现 src/components/stream-message-coordinator.ts 保留未用
• 新增环境变量 VITE_CHAT_API，新增 dev 代理 /chat-api → http://192.168.2.23:8000
• 政策卡片、政策详情、参考资料、公司补问与候选确认接入新协议
• 错误码翻译：把 HTTP 与 SSE 错误码转成中文提示（如 thread_busy → 该问题还在处理中）

20260915

• 修复回答内容顺序：正文 → 政策卡片 → 综合说明 → 参考资料（参考资料移到最下方）
• 修复换行丢失：块级 markdown 下单个换行会被折叠，导致列表后紧跟的说明行被并进上一条列表项
• 修复复制功能：复制结果剔除协议标记，不再把 <scope>、<!-- POLICY_TABLE -->、 <ref_links> 等原始标记一起复制出来
• 修复卡片顺序与「更多」列表不一致：卡片改为按接口 priority.rank 排序
• 「更多」面板的列表改为复用卡片数据，不再拉取与卡片无关的公共政策库
• 部门筛选还原为最初的 15 个固定部门与字面匹配（此前一度改为按接口数据动态生成）
• 新增惠企政策库来源标识（来自惠企政策库的卡片在右上角打标）
• 政策详情面板新增「条件核验 / 匹配依据 / 原文引用」三个区块
• 建立本机开发工作流文件与接口参考目录（按 .gitignore 约定不入库）

20260916

• 打字机速度加快：每次打出字数 2 → 4（61 → 121 字符/秒），积压加速档位同步上调。 基准取主流 AI 的实测输出速度（Claude 3.5 约 60 字符/秒、DeepSeek-R1 约 75， 主流区间 50~120），取区间上沿——因为本项目后端一次返回整段，打字机是纯额外延迟， 同样速度会比主流慢一整段
• 「政策事项列表」统一为一个列表、一个入口：
  • 卡片区「更多 >>」与详情的「返回政策事项列表」走同一条路径、内容相同
  • 列表数据统一来自 public/merchant-agent/policies_public.v1.json （262 条申报事项 / 38 个政策），本轮匹配到的惠企政策置顶
• 「政策事项列表」每次进入都重置筛选（部门 / 分类 / 关键词 / 页码）， 避免上次的筛选残留导致「条目少」或「筛不出东西」
• 政策详情面板的「返回政策事项列表」按惠企政策区分：只有惠企政策才显示该入口； 惠企政策判定优先用接口字段 is_policy_library，缺失时回退到按标题在库中匹配 （已做归一化，容忍《》全半角括号等差异）
• 公司补问改为按 status 字段判定形态（found / not_found / failed / 无 status）， 替掉原先靠"候选数是否为 0"和 input_help 文案正则的猜测式判断
  • failed（查询服务失败）此前会落进 not_found 分支，文案被填成"未查询到匹配的公司"， 等于把失败说成查无公司，已改为独立分支并说明失败原因
  • 无 status（初次询问是否需要公司信息）此前给"跳过公司查询"，改为"不需要公司信息"
• 补问卡片：输入框移到选项上方并常驻（原来在选项之后、需点击才展开）
• 补问卡片：修复选项序号错乱——输入框在最上却拿 B、选项在下面却拿 A，现输入框取 A、选项顺延
• 补问卡片：正文里已展示过的同一段文字不再在卡片内重复
• 「跳过公司查询」由发送 /skip 改为发送选项文本「跳过公司查询」
• 问卷提交：修复只取第一题（多题丢失）、多选只取第一项、以及数字开头选项被静默改写成纯数字

20260917

• 修复切会话时误报「请求已取消」：
  • 根因是两处「内容是否为空」的判空口径不一致——归一化用 content.trim() （<scope> 进度块算作有内容），渲染层用 stripScopeBlocks() （进度块不算内容）。同一段内容，一处认为「有」、一处认为「没有」
  • 新协议的正文要等 done 才写入，处理期间内容只有进度块，把这个缝隙 从偶发放大成「一切会话就出现」：归一化认为有内容 → 不替换文案，却把状态翻成 Finish；渲染层认为没内容 → 显示「请求已取消」，而请求其实还在跑
  • 修法：抽出唯一的判空口径 hasVisibleMessageContent()（utils/interrupted-message.ts）， 归一化与渲染层都改用它
  • 新增回归脚本 harness/tools/verify-empty-content-agreement.mjs， 断言的不变量就是「两处必须一致」，30 项断言
• 删除政策详情面板的「原文引用」板块（条件核验、匹配依据保留）
• 思考中卡片的阶段文案一律不换行：
  • 原因：ScopeContent 按卡片宽度切样式 —— 没撑满容器时标题 nowrap + 省略号， 撑满时切成 pre-wrap。而阶段文案长度不一（新协议的文案比原来的"正在思考中..."长得多）， 切换时表现为「突然换行」且卡片高度跳动
  • 改法：拆开原本同时管标题与正文的规则 —— 正文保持可换行， 标题恒定 nowrap + 省略号
• 政策详情面板的「政策名称」支持点击跳转：由库条目的 data.市级政策id 拼出 https://zwdt.sh.gov.cn/qykj/shell_oc_policy_zq/policy/policy-detail?id=<id>
  • 背景：库里 apply_link 字段 262 条全为空；资源申请备注 里的 URL 是按申报事项 零散对应、且混有内网地址（25 条指向 http://10.235.238.34:7202/imanage/login）， 不能作为来源。市级政策id 有 261/262 条，可靠
  • 没有 id 时不给链接（不猜），宁可没有也不指向打不开的地址
• 查明「政策名称」显示为纯文本的真因，并调整政策库数据源（开发环境改用本地 json）：
  • 政策库其实有两个来源，字段并不一致：
  • 本地 public/merchant-agent/policies_public.v1.json：262 条，data.市级政策id 有 261 条
  • 远端 VITE_DOWNLOAD_URL：327 条，该字段一条都没有（它有的 policy_id 是 40 位、 与条目 id 相同，与 24 位的 市级政策id 是两套 id 体系）
  • 而 index.html 原本是远端优先（远端带 CORS 头，浏览器里确实会赢）， 于是取不到 id → 拼不出详情地址 → 「政策名称」是纯文本。 此前怀疑的「HMR 状态陈旧」「走了兜底路径」均排除
  • 新增环境变量 VITE_POLICY_LOCAL_FIRST：仅开发环境打开（本地优先、远端兜底）， 生产仍远端优先——生产该问题属后端数据缺失，需远端那份补上 data.市级政策id， 前端无法修
  • 新增 harness/tools/check-policy-sources.mjs：对比两个来源的条数与字段覆盖率， 并在「远端也带上 id 了」时提醒可以移除该开关
  • 代价：开发环境用的这份比远端少 65 条申报事项（262 vs 327）
• 会话、问答记录与反馈落地到 DMS 数据管理服务（栏目 1887 助手会话 / 1889 助手问答记录）
  • 提交问题时写入会话（按 c_session_id upsert：没有就新增、有就更新）与问答记录（先写问题）； 回答完成补写回答；停止/断流也补写已生成的内容，避免中断的问答只有问题没有回答
  • 会话列表、历史记录改为从 DMS 读取；会话改名、删除同步到 DMS
  • 点赞/点踩/取消写入 DMS 的问答记录（按 c_record_id 定位那一行）
  • 未登录的访客也写入，以 访客_<访客id> 归属（访客 id 复用埋点的那个）
  • 会话标识用前端的 session.id（它恒等于聊天协议的 thread_id）；问答记录标识用 AI 消息 id（同时是反馈组件用的 record.id，因此从 DMS 读回的历史消息点赞仍能命中原始行）
  • token 只存在于 vite 代理侧（.env.development.local，按约定不入库）， 浏览器产物里没有 token；DMS 不可用时静默降级，聊天与本地历史不受影响
  • 实测踩坑：DMS 的「删除」不是 delContentById（各种传法都返回参数错误）， 而是 POST /content/updateAudit 把状态改成 4（销毁）；addContent 会返回记录 uuid
  • 存储粒度：一个会话一行（不是一问一答一行）——整段对话的消息数组以 JSON 存进 该行，每次以本地消息列表为准整段重写；反馈记在 JSON 里对应那条消息上
• 去掉开发环境硬编码账号的自动登录：此前开发环境下会无条件用内置账号登录， 表现为「没有登录也进入登录态」。现在默认即访客态，要企业态需显式带 ?access_token= 或 ?credit_code=
• 本机工作流文件（harness/）结构对齐 Learn Harness Engineering 的 OpenAI 高级包： docs/plans/ → docs/exec-plans/（completed/ + tech-debt-tracker.md）， 并新增结构校验脚本 harness/tools/validate-harness.mjs（机械约束优先于口头约定： 可检出假 passing、多个 in_progress、游离的计划文件等）
• harness/、CLAUDE.md、agents.md 纳入版本控制（此前排除）
  • 依据：参考资料的原则是「计划、质量、技术债和代码一起版本化」—— 团队 clone 应当能看到状态、计划与契约文档，而不是只在本机
  • 仍然排除的是带凭据的本机文件（.env.*.local、.claude/settings.local.json）， 以及 esbuild 生成的 harness/tools/_*.mjs（构建产物，入库会与源码漂移）； 产物重新生成的命令写在 harness/tools/README.md
  • 入库前做了凭据扫描（无真实 token），并模拟 fresh clone（删光产物 → 按文档重新生成 → 四个验证脚本全绿）确认别人拿到仓库能跑通
• 修复「同一政策的多个申报事项，点『查看详情』内容一样」：
  • 根因：同一条政策下的多个申报事项会各出一张卡片，但适配层把卡片的 title 与 declaration_item 都取自 card.name.text（只有政策名），而后端不下发 id/policy_id（实测恒为 undefined）——这些卡片在字段上完全无法区分， 原来的反查只要任一条件命中就返回，于是点第二张也跳到第一张
  • 修法：反查逻辑抽成纯函数 resolvePolicyDetailIndex()，对象同一性优先， 退化的字段比对只在唯一命中时采信，多命中时交给「直接展示被点条目」的兜底 —— 宁可走兜底，也不张冠李戴
  • 新增回归脚本 harness/tools/verify-policy-detail-index.mjs（10 项断言， 含「点第 2 张 → 下标 1」这条针对本 bug 的断言）
  • 详情面板的标题改为显示具体申报事项（如「…的通知 - 创业开办费补贴」）： 适配层的 declaration_item 改用后端每条唯一的 data.title，不再与卡片标题同值； 卡片区标题仍是政策名，观感不变（含一处连带的 panelData.title 取值顺序修正—— 否则改详情标题会连带改掉卡片标题）
  • 新增 harness/tools/verify-policy-card-fields.mjs（8 项断言：同政策两条必须可区分、 卡片标题不变、无后缀时退化为政策名）
• 卡片区「更多 >>」改为打开新的「政策列表」侧边栏：
  • 标题「政策列表」，保留搜索框与热门搜索，移除部门/分类筛选
  • 内容为本条回答里出现的政策卡片（去重、按匹配度排序） —— 注：2026-09-18 按需求调整，此前一度做成「本会话内所有消息出现过的卡片」 （跨消息聚合），那套聚合与它的采集函数已随本次调整删除
  • 详情面板的「返回政策事项列表」仍打开原来的惠企政策库列表（两套列表并存， 按要求只换「更多」入口）
  • 面板新增第三种模式 cardList，与旧列表共用同一套模板与样式类，未新增 CSS； 旧列表逻辑靠既有守卫自然短路，openPolicyList 一行未动
  • 新增 harness/tools/verify-policy-card-list.mjs（24 项断言：坏 JSON/空输入不抛错、 首见优先去重、降序+同分稳定、六面关键词过滤） —— 断言数由 31 降为 24：随「收回会话级聚合」删掉了那 7 项聚合断言
• DMS 的问答记录存储粒度改回「一问一答一条」（幂等键 c_record_id， 问题与回答各存一半）。曾一度改成「一个会话一行、整段对话 JSON 塞进 c_answer」， 现按需求改回——更贴近库表原本语义（chat_record 即一行一轮问答），也便于按轮次检索统计。 反馈随之改为写在该轮的 c_feedback_* 列上；会话删除连带清理其名下所有问答行
• 计划归档：harness/docs/exec-plans/completed/ 开始启用， 已实现的两个计划（DMS 落地、政策列表侧边栏）移入并更新状态； 结构校验脚本新增两条检查（active/ 里状态写着已完成、completed/ 里状态仍写进行中）
• 按会话并行生成（改为 ChatGPT 桌面那种模型）：
  • 此前全局只有一个协调器实例 + 一个全局 isGenerating，于是「同一时间只能一个会话在生成」， 并衍生出两个 bug：生成中切到别的会话，发送按钮仍显示「停止」（想发送却停了生成）； 停止时目标会话解析错误（同步事件把它提前清空 → 回落到「当前会话」）， 会把停止打在看的那条会话上、并凭空造出一条空的「请求已取消」消息
  • 现在生成状态按会话隔离（tasks Map + 每轮独立协调器实例 + 监听器闭包捕获会话 id）， 各会话并行、互不干扰；停止只停自己那一轮；新建会话不再打断正在生成的会话
  • 顺带修好了两处静默失败：后端 409 等提示此前无人监听（现接到全局 Toast）、 同会话重复发送此前静默无反应（现提示「该会话已有回答在生成中」）
  • 新增回归脚本：verify-chat-task-utils.mjs（33 项，含把「响应式容器破坏对象同一性」 这个陷阱钉死的断言）、verify-coordinator-multi-instance.mjs （11 项，验证多实例事件隔离——并行化的地基）
• 清理项目（用户要求）：
  • 删掉 5 个无人读取的 env 变量（VITE_STREAM_SERVER / VITE_STREAM_TOKEN / VITE_HUMAN_IDLE_MP4_URL / VITE_PLUGIN_URL / VITE_PLUGIN_ASR）——数字人与插件那条 从未接入本项目前端的链路的遗留；其中两个还是入库的凭据
  • 合并 .env.development 里重复定义的 VITE_ASR / VITE_XF_ASR（后定义的才生效）
  • 删掉无代码使用的 vite /stream/ 代理（/asr/ 保留，是切讯飞 ASR 的退路）
  • 删掉空目录 public/images、public/pencil_exports 与构建分析产物 stats.html
• 恢复上传图片/附件功能（此前因新协议只收两个字段而挂起）：
  • 采用「把 OSS 地址拼进 question 文本」的方案（用户拍板，不需要后端配合）
  • 关键：sendMessage 拆成两个变量——发给后端的 questionForBackend（含附件地址）与 本地用的原文 text（气泡、会话标题、DMS 记录都不显示 URL）
  • 恢复「上传图片 / 上传附件」两个按钮（原先整块注释）；拖拽与粘贴本来就是通的
  • 取签名的地址做成 env VITE_UPLOAD_SIGN_URL（四份 env 均写，值仍为厂商地址）， 将来换自建签名服务只改配置
  • 实测：厂商签名接口 //qingpu-data-api.metamaker.cn/common/qp_signed_url 无需鉴权即可取签名； 文件实际存放在厂商的 OSS bucket heijing-products（杭州）， 外链为 https://prod.heijingai.com/qingpu/<uuid>.<ext>
  • 新增回归脚本 harness/tools/verify-attachment-question.mjs（10 项断言）
• 删除统计埋点的老接口（用户要求）：
  • 删除调用点（BusinessAssistant.vue 的页面浏览、BusinessRecord.vue 的反馈统计） 与整个 src/network/api/assistant-statistics.ts，以及已无人使用的 VITE_ASSISTANT_STATISTICS_BASE_URL
  • 点赞由「双写」变为只写 DMS；运营侧的埋点数据从此不再上报
  • 只保留 getOrCreateAssistantVisitorId（DMS 的 访客_<id> 归属在用），搬进 DMS 模块， localStorage key 保持不变（改了会让已存在的访客换新 id）
• 清理死代码（用户确认直接删除，非注释）：
  • src/network/api/card/index.js 整文件删除（三个函数均无调用方） 及其未使用的 import
  • PolicyListUpdatedMatch.vue 有意保留——老会话历史里可能仍有 <policy-list-updated> 块，删了那些卡片列表会渲染不出来

20260918

• DMS 写入范围收窄为只写问答记录：
  • 1887 助手会话不再写入（用户指示「只传具体的会话记录，另一个接口不传了」）—— 新建会话、改名都不再同步；会话列表退化为纯本地（与接 DMS 之前一致）
  • 1889 问答记录照常写入（含 title = 问题文本）；删除会话仍清理其名下的 1889 记录
  • 调用点按约定注释保留并标 [已停用]，同时在 verify-dms-payload-fields.mjs 里加了源码级断言（不得出现未注释的 upsertDmsSession 调用），防止被顺手改回
• DMS 写入补齐 title 与运营分析字段：
  • 会话（1887）：每次 upsert 都显式带 title = 会话标题 —— DMS 的系统字段 title 原本只在创建时初始化，改 c_title 不会带动它，所以前端改名后 DMS 里看到的标题不变
  • 问答记录（1889）：title 用问题文本（原先库里是字符串 "null"， 在 DMS 列表里看不出是哪一轮）
  • 写入带 title（用户需求）；1887 另有四个 must=true 的运营字段 （summary / qpyszx / qyzt / rzqpyx）——不带就 214 数据错误，四个必须全带， 但只传空值/默认值（取值属业务口径，前端不猜；用户拍板「先传空值」）。 ⚠️ 只在新增时带、更新时一律不带——否则会把后端将来回填的值冲成空
  • 新增 harness/tools/verify-dms-payload-fields.mjs（9 项断言）：打桩 fetch 抓真实请求体， 断言字段集合「不多不少」且 title 的值正确 —— 这条不需要 DMS token 就能跑
• 环境变量整理：地址类配置收进 env，不再写死在代码里
  • 新增 VITE_CHAT_TARGET（聊天后端真实地址）——此前它硬编码在 vite.config.ts 的 代理配置里；现由 vite.config.ts 从 env 读取（保留同值兜底）
• 移动端真机样式修复（用户反馈：夸克上第 3 段建议词被输入框遮住、vivo 上后两段被遮）：
  • 按用户给的方案收紧首页元素：顶栏 64px → 52px、logo 130×88 → 96×65、 标题 28px → 22px 且恒定单行、建议词区内边距与间距收窄 —— 估算内容总高 −17%
  • 再按用户反馈调观感：标题与介绍文案两侧各留 28px、标题 22px → 20px、介绍文案 14px → 13px
  • ⚠️ 根因没动，只是让内容放得下：.home-fixed-input 仍是 position: fixed 悬浮， 给它预留的是写死的 padding-bottom: 180px（与输入框实际高度无关）； 另有 height: 100dvh 无 100vh 兜底、页面无 text-size-adjust: 100% —— 见技术债第 7 条，换台手机仍可能变样
• 首页标题文案：一度按指示去掉「你好」，随即按要求加回（仍为 你好，有什么我可以帮您的？）
• 首页标题字号：几经反复，当前值以这里为准 —— PC 保持 32px 不变；移动端 22px（clamp(17px,5.7vw,22px)，≥386px 的屏恒为 22px， 更窄的屏按比例收缩以免标题被顶出屏幕）。过程：一度整体 −4px（PC 32→28、移动端 20→16） → 用户反馈移动端「太小了」→ 全部还原 → 用户要求移动端调到 22px
• 企业信息分类同步（对话带回 company_info → 分类接口 → DMS 企业两栏目）：
  • 对话 result 事件里的 company_info 非空时，回答完成后自动同步到 DMS 两栏目： 1888 企业基础信息 ← 分类接口（POST /api/company/classify）的六个角度标签， 一行一家企业（幂等键 c_credit_code，字段级 diff，无差异零写入）； 1886 企业荣誉信息 ← company_info.honors.records（逐条真实荣誉），一条荣誉一行
  • 1886 与库里该企业的行按「荣誉名+级别+来源」全量对齐（补新增、更新差异、删多余）， 仅当 honors.complete === true 才删；荣誉名写 c_honor 与系统 title。 —— 数据源曾用分类接口的「资质荣誉」标签，实测宇树科技只给 2 个标签而真实荣誉有 31 条， 按用户要求改为以 honors.records 为准（分类标签仍写进 1888 的 c_tag_honor）
  • 全程 fire-and-forget：任何失败只 warn，不影响聊天；同企业并发走串行链
  • 适配层新增捕获 company_info（原先 result 分支是空的、数据被丢弃）
  • 回归脚本：verify-company-classify-sync.mjs（53 项纯逻辑）、 verify-company-info-passthrough.mjs（10 项，假 SSE 流验证适配层把 company_info 原样带出）、 verify-company-classify-dms.mjs（23 项打真实 DMS）、 verify-company-classify-e2e.mjs（16 项端到端：真实分类接口 + 真实 DMS）
  • ⚠️ 分类接口对「精简/合成」的请求体一律 422（连接口文档里自己的示例片段也被拒）， 换成真实完整的 company_info 就返回 200 —— 是对载荷完整性的校验，不是接口坏了； 已在 api-chat.md 补上 company_info 的契约章节
  • DMS 侧字段已就绪（1888 扩到 47 字段、1886 扩到 12 字段，含 c_tag_* 分类标签字段）； 两栏目都已有数据（DMS 侧 2026-09-17 灌入），所以同步多为「更新已存在的行」， 只动身份三字段与标签字段；1886 靠 c_source 标记所有权，绝不碰灌入的荣誉行
• 移除移动端 @media (max-width: 360px) 里那条 .heading { font-size: 28px }： 它最初与基础值同值（空操作），09-18 基础值改小后变成窄屏把标题放大回 28px 的覆盖， 而标题是 white-space: nowrap —— 360px 屏下标题宽 356px、可用仅 272px，会溢出屏幕 84px； 窄屏收缩已由 .heading 自己的 clamp 负责（已注释保留原文并写明原因）

20260920

• 企业信息同步扩充：company_info 里 DMS 有列的字段现在全部同步
  • 1888 企业基础信息：补上 36 个工商信息字段（企业名/经营状态/注册地址/注册资本/ 经营范围/成立日期/曾用名/行政区划…，逐字段映射、字段级 diff、无差异零写入）
  • 1886 企业荣誉信息：按后端 honors.records 逐条荣誉对齐（一条一行，c_honor 存荣誉名）
  • 三条实现要点：空值一律不写（不清存量）、JSON 列按语义比较（库里是 Python/jsonb 序列化，带空格且键按字母序，直接比字符串会每轮误判成"有差异"而反复写）、 工商与荣誉不依赖分类接口（分类接口慢且偶发失败，拆开后互不牵连）
  • 字段覆盖审计工具 harness/tools/audit-company-info-coverage.mjs：1888 写 43/47 列、 1886 写 12/13 列；未覆盖的 4 列（c_scope_brief/c_phone_number/c_email/c_industry） 后端接口本就没返回
• 政策详情面板的「政策名称 / 政策所属部门」一行拉满整行宽度（与下方两张卡片右对齐）： 原先名称列 max-width: 462px + 部门列写死 110px，整行只有约 520px 宽、右侧空一大块， 部门写全称时还被挤成三行；改为名称列占满剩余空间、部门列可伸展（下限仍 110px）
• CIPA / 出海类问答展示企业微信二维码：后端在 result.data.cipa 给出布尔值， true（问的是 CIPA / 海外服务平台 / 出海服务）时在参考资料之前追加一张二维码图片 （src/assets/qiyeweixin.png，点击可放大）
  • 走适配层翻译成既有的 <image-scope> 内容标记，渲染层零改动（该标记本来就有对应行类型）
  • 复制按钮的剥离规则同步补上 <image-scope>，避免把图片地址复制进剪贴板
  • 适配层 15 项新断言（含 false/缺字段/非布尔值不显示、跨轮不串、补问轮不展示）
  • 位置：参考资料之前；补问轮（等用户补充公司信息／确认候选）不展示——那一轮还没有正文回答
• 回答正文改为真实增量流式输出（后端 F073：answer_start / answer_delta / answer_end / answer_abort，契约见 harness/docs/reference/token-streaming.md）
  • 正文逐片段实时上屏，不再是"整段到达后逐字打字"；思考中卡片在第一个字到达时即退场
  • 为此在适配层加了增量 markdown 规整器（src/components/answer-stream.ts）： 正文块用的规整函数是插入空行的，若不做增量规整，answer_end 的"整块替换"会与已流文本 分歧 → 整段重建 → 思考中卡片每轮闪现重播。规整器保证「已上屏内容恒等于最终全文的逐步前缀」， 正常路径因此退化为纯尾缀追加（零抖动）
  • 实测（真实后端 505 片 delta / 876 字）：concat(deltas) === answer_end.text 成立； answer 事件是正文开头的压缩版，流式轮跳过不重复渲染（仅当与正文公共前缀 < 90% 才保留）
  • 用户主动停止保留已流出文字；后端出错 / 断流撤掉未定稿的草稿
  • 旧后端（不下发流式事件）与 mock 测试按钮仍走原来的打字机（回归重点）
  • 新增 verify-answer-stream.mjs（78 项：纯逻辑 + 协调器级假流）、probe-answer-stream.mjs（真后端探针）

20260921

• 卡片改为「正文开流前」上屏（对齐后端契约 F079）：有入选政策时后端先发完完整的 source/item 才开始 answer_start，而前端此前一直等 done 才显示卡片 —— 只能靠整块重写把卡片插到正文之上， 界面上表现为「正文先渲一遍、又从头再渲一遍」。现在开流前就把卡片上屏，收尾只做纯追加
• 修「同一段回答内容出现两次」：真载荷实测 answer_end.text（1610 字）比增量拼接（1309 字） 多 301 字，导致应用侧记录的"流式正文"不再是上屏内容的后缀 → 重排落兜底分支 → 正文上屏两份。 修法：answer_end 后同步"流式正文"，并加固兜底（对不上时绝不重复插入正文）
• 参考资料改为「正文定稿就上屏」：实测 done 要等 result（375~390KB 的完整快照）， 比正文定稿晚 3~10 秒，而参考资料的数据（source 事件）在正文开流前就发完了 —— 等于白等。 现在正文一定稿就发；二维码（来自 result.cipa、只能等）走定向重排，保住「在参考资料之前」的版式
• 修「文字快渲染完时视图被拽回回答顶部」：流式期间正文是即时渲染的，但最后一行一直被标成 "打字未完成"，收尾时整套打字机机制被重新启用，其中一环会把视图滚到最后一条 AI 消息的顶部。 修法：收尾时把已在屏幕上的行补记为「打字完成」
• 大块内容改为对齐它的顶部（不再滚过它）：卡片/参考资料是一整块插入的（300~900px）， 此前贴底滚动会一步滚过整块 —— 用户刚拿到卡片却看不到卡片
• 「流式草稿被最终文本整段替换」记为已接受行为：契约要求「完整校验后绑定真实链接， 随最终替换出现」「不能用 text 覆盖…不能只保留草稿」。实测草稿与最终文本的公共前缀只有 11.7% （最终版给标题补了序号、把纯文本换成 markdown 链接）
• DMS token 不用再每次手填：token 约 24 小时过期，以前要「改 .env + 重启 dev server」。 现在放在本机单行文件 .dms-token，代理每个请求现读（换 token 不用重启）： npm run dms:token（从剪贴板读）、npm run dms:login（账号密码自动登录）、 npm run dev 前自动续期。顺带发现原来 .env.development.local 里的 token 写在了下一行， dotenv 读出来是空串 —— 等于一直没生效
• 注释掉输入框右侧的测试用 MOCK 按钮组（资料/问卷/流测/回放/打字/Scope/测试输入）

20260922

• 1887 助手会话写入企业相关字段（未登录也写）：企业名称、统一社会信用代码、企业图片、是否登录
  • 规则：登录态的值优先级最高（库里已有值也覆盖）；对话带出的 company_info 值与库里不同就更新； 但已被登录态认领过的行（c_is_login="1"）不许被后来的访客对话改写 —— 否则会把这行改到别的公司名下
  • 企业看不到陌生访客的会话：读「我的会话」时排除访客行（改造前访客标识是随机的、本来也匹配不上， 这里只是保持一致的可见范围）
  • c_title 不写（标题由运营侧生成）；DMS 系统字段 title 只在建行那一刻带上
• 访客归属改用本机 IP：新增取 IP 接口（返回纯文本 IP；走同源代理 —— 它是 HTTP 而页面是 HTTPS， 直连会被浏览器按混合内容拦掉），IP 存进 c_ip，访客身份为 访客_<IP>； 取不到 IP 时退回浏览器随机 id，不影响任何写入
• 复制回答去掉 markdown 语法符号：###、**、反引号、[文字](链接) 的括号语法、无序列表的 - 都不再复制出去；有序列表序号保留（顺序是内容）、链接地址保留（写成「文字（地址）」）
• 排查中撞到一个 DMS 协议坑并记录：payload 里含模型里不存在的列时，addContent 会忽略该列照写， 而 updateContent 会静默丢弃整个更新（返回仍是 {"code":200,"message":"成功"}）—— 新增列时必须先确认 DMS 侧已加

20260923

• 多模态输入：新增 pictures / files 两个请求字段（后端扩展了 /api/chat 的请求体）
  • pictures：图片 URL 列表；files：非图片文件 URL 列表。两者都是字符串数组
  • 截图、文档上传后不再把 OSS 地址拼进问题文本，而是随请求体发出 —— 地址不再被模型当正文读，本地消息、会话标题、DMS 记录也不再被 URL 污染
  • 实测（打真实后端）：元素必须是 URL 字符串，传对象数组会被 422 invalid_request 拒掉； 带上 pictures 问「这张图片里是什么」，模型确实描述了图的内容（不是收下就忽略）； 空数组与不传都接受
  • 没有附件时不发这两个字段 —— 请求体与从前逐字节一致
• 附件改为上传到 DMS 文件服务（用户 2026-09-23）：图片/文件走 POST {DMS}/file/uploadFile（multipart，五个字段全必填：file / type / columnId / contentId / paraName）， 返回相对路径（如 /static/photo/1889-c_question-<uuid>.png），它随请求体发给后端； 原先直传厂商 OSS 的实现整段停用保留
  • 缩略图预览：相对路径本身打不开，拼上 DMS 代理前缀才能取（实测 200）， 所以刷新页面后气泡里的图还在
  • 实测细节：type 决定目录（0 图 → /static/photo/，其余 → /static/file/）； 少任何一个字段都返回 {"code":-1,"message":"缺少必传字段"}
• 附件支持格式对齐产品提示，且不支持的格式改为 toast 提示（用户 2026-09-23）：
  • 图片：JPEG、PNG、GIF、WebP；文件：Excel（xls/xlsx）、DOCX、文字 PDF （此前图片漏了 GIF，文件多了 doc/txt/md 却缺 Excel —— 与提示对不上）
  • 不支持的格式：弹 toast 提示 + 不放进输入框（此前是 window.alert； 拖拽路径还会把不支持的文件静默丢弃，用户不知道文件为什么没进去）
  • 顺带修掉一个真 bug：图片校验此前是 file.type.startsWith('image/')， 等于任何 image/* 都放行 —— SVG / BMP / HEIC 全被当图片收下；现改为按扩展名判
• 全局提示改成 Ant Design 的 message（用户 2026-09-23：「现在的 toast 太丑了， 希望是图片中的类型，从顶部弹出，过一段时间消失」）：
  • 原来的 <Toast> 是全屏黑遮罩 + 居中白框（本质是模态框的观感，还会挡住整页）
  • 现在统一走 @/utils/app-message（Ant Design Vue 4.x 的 message，本项目已有该依赖）： 顶部弹出、3 秒自动消失、错误为粉底红感叹号 —— 就是设计稿那种小条
  • 调用方签名不变（showToast(text)）；顺带发现 BusinessRecord.vue 里那份 <Toast> 与 showToast 没有任何调用点、也没有子组件 inject（死代码），一并停用
• 语音输入的 4 处 window.alert 一并换成轻提示（用户 2026-09-23：「另外那几处语音的 window.alert 一同更换」）：PC 1 处（初始化失败）+ Mobile 3 处（麦克风权限 ×2、初始化失败 ×1）
  • 换成 showToast(...) 后与全站提示同一条链路（顶部弹出、自动消失）， 不再有阻塞式弹窗；文案与收尾动作一字未动（仍会释放语音实例、复位状态）
  • PC 端 openMicroPhone 返回 false 时仍是静默 return（无任何提示）—— 与 Mobile 不一致，属已报告的待定项，未擅自补文案
  • 保留项：清空输入框那句 window.confirm("可能会清空之前的文字…") 不换 —— 它是要用户做决定的模态确认，不是轻提示
• 轻提示时长 3s → 2s（工作区改动，随本次一并提交；改 APP_MESSAGE_DURATION 一处即可）
• 修：提交之后气泡里看不到图片（用户 2026-09-23 报）：
  • 根因：附件换成 DMS 之后，上传返回的是相对路径（/static/photo/…）， 而消息附件仍把相对路径当展示地址用 —— <img src="/static/photo/…"> 经 dev server 取回的是 index.html（200 但 text/html），图解不出来。 实测对照：相对路径 → text/html；/dms-api + 相对路径 → image/png ✓
  • 修法：消息附件按上传模块同款分成两个字段 —— url（可显示地址，气泡里 <img> 用）与 fileUrl（相对路径，随请求体 pictures/files 发给后端）， toChatAttachmentUrls 改取 fileUrl（发给后端的地址与从前一致，不受影响）
  • 非图片附件没有展示地址（气泡里本来就是「文件条」，只显示名字/大小）
  • 回归脚本 39 → 51/51（新增【7】12 项钉死这个契约，并用变异测试确认两个方向都会红）
• 附件路径随问答记录落 DMS（c_image / c_file）（用户 2026-09-23：在「助手问答记录」里 新建了这两个字段，要求把对应的路径存进去）：
  • 存的是相对路径（/static/photo/…）—— 与请求体 pictures/files 里发给后端的是 同一个值，库里记的和后端收到的能对上账；不存 /dms-api 展示地址（那是环境相关的拼接结果）
  • 多张图/多个文件用逗号分隔；没有附件的那一轮不写这两列
  • 写入前先拉模型定义确认两列真的存在 —— DMS 的坑：updateContent 遇到模型里没有的列会 静默丢弃整个 patch（返回仍是 200「成功」），所以更新路径只在「真有附件值」时才捎上这两列， 最坏也只影响带附件的轮次，不会连累补 answer
  • 验证：verify-dms-chat-storage.mjs 65 → 78/78（打真实 DMS 的写入-读回-补 answer 全链路）
• 只要对话就在「助手会话」（1887）建行（用户 2026-09-23，推翻 2026-09-18 那条 「访客且没有企业信息就不建行」）：
  • 未登录且本轮没带回企业资料时，行里放能填的那些：c_ip（真实 IP）、c_is_login="0"、 时间戳、系统 title，以及四个必填运营位（summary 空串 + 三个布尔 false，只做空值兜底、 不猜业务值）；c_credit_code 留空（用户拍板：这一列只放真实信用代码，不写访客标签）
  • 建行时机不变：仍只在回答正常完成（totalResponse）时写一次 —— 中断/报错的轮次不建行
  • 运营分析回填列（c_title、c_description、c_focus_points、c_core_needs、 c_contact_clues、c_follow_up_departments、c_settlement_intent_level、jygjbm 等） 前端一律不碰，否则会把分析系统的值冲掉
  • 读侧不受影响：远端会话列表本来就排除 c_is_login="0" 的访客行，且只在登录后拉取
  • 验证：verify-dms-chat-storage.mjs 78 → 89/89（打真实 DMS 新增 11 项，含"后续轮次带回 企业信息时这个纯访客行能正常被填上"）；变异测试注入旧行为 → 断言大面积失败
• 语音识别换阿里云 NLS（第 1~2 步：token 通路）（用户 2026-09-23）：NLS 的 token 要用 AccessKeySecret 签名去换（CreateToken，24h 过期），而 secret 不能进前端产物 —— 所以走 dev 端点 GET /nls-token/（vite.config.ts 的中间件，apply:'serve'）， 由 vite 在 node 侧签名并把 {token, expireAt, appkey} 交给前端；凭据只写在 .env.development.local（gitignored，值不进仓库任何文件）。
  • 签名口径收在 harness/tools/nls-token.mjs（唯一一份），命令行工具 harness/tools/get-nls-token.mjs 与 dev 端点共用；带 5 分钟提前刷新 + 并发去重
  • 验证：端点 200；拿端点发的 token 真调通一次识别（status:20000000 SUCCESS）； npm run build 后产物里搜三个凭据值 0 命中
• 实时语音识别已切到阿里云 NLS（2026-09-23，接管旧厂商 SDK）：
  • 协议层 src/asr/nls-protocol.ts（纯函数：帧构建 / 事件折叠 / 16k PCM 编码）
  • 类 src/asr/nls.ts（2026-09-24 前在 src/three-libs/asr/），对外契约与旧 SDK 一致 → 两个壳组件只改了 import 与一处构造参数（去掉硬编码 appKey），其余一行没动
  • 协议是实测出来的：StartTranscription→TranscriptionStarted→二进制音频帧→ TranscriptionResultChanged(中间结果，会被覆盖)→SentenceEnd(整句定稿)→TranscriptionCompleted； 两条硬约束——每条指令都要带 appkey、task_id 不能是空串（各踩过一次，已写成断言）
  • 拼接全文只用 SentenceEnd；中间结果只用于实时显示
  • 验证：harness/tools/verify-nls-realtime.mjs（39/39，2026-09-24 已长到 44/44）， 含真实识别（Windows TTS 造语音 → 推流给真实网关 → 识别结果与所说话一致）与切线的源码级断言
  • 重采样按实际 audioContext.sampleRate 算（旧实现写死 44100 的隐患不再沿用）
  • 文档：harness/docs/reference/asr-nls.md（旧的 asr-realtime.md 标注为"换之前那套"）
  • ⚠️ 当时生产要由后端/网关做同样形态的 /nls-token/ 端点 —— 2026-09-24 起改为直接调 后端网关的 getALYToken（见本页 ## 20260924 第一条），技术债 #10 已大半还清； 浏览器实测由用户确认（harness 不能替真人说话）
• 实时语音转文字补了一份接口文档（用户 2026-09-23 要求）： harness/docs/reference/asr-realtime.md —— 当时 SDK 就在仓库里（src/three-libs/asr/index.ts，该文件已于 2026-09-24 删除， 文档现在是历史记录），文档逐条对源码核对：构造参数与方法、 transform/error 事件契约、底层 WebSocket 协议（/common/asr_hub?project=qingpu&engine=aliyun_dashscope…、 首帧、16k/16bit 单声道 PCM 的二进制帧、结束帧、服务端 start/stop → mid/fin/breath 的映射）、 两端的生命周期与调用点、以及6 条已知坑（采样率换算写死 44100、"权限被拒绝"文案不可达、 openMicroPhone 只会 throw 或返回 true、非讯飞分支不主动关 socket、硬编码的十年期 JWT、 clear() 会清空所有监听）。只是文档，没改任何代码。
• 🔴 待处理（登记进技术债 #9）：.env.production 没有配 VITE_DMS_API —— 该环境打出来的包里附件传不上去（直接抛「未配置 DMS 接口地址」）、 DMS 会话落库也静默跳过。接生产要先定：DMS 从部署环境是否可达、token 由谁注入 （开发环境是 vite 代理加的，生产得 nginx 做同样的事）

20260924

今天两条主线：语音识别换阿里云 NLS 收尾（token 改由后端网关签发）+ 一次大清理 （死代码、多余环境、走不到的引导链）。清理过程中出过一次回归，已修并补上守护脚本。

• 部门筛选改为「只列 JSON 里实际存在的部门」（用户 2026-09-24）：
  • 删掉硬编码的 15 个部门（DEFAULT_DEPTS），改为从惠企政策库的 政策所属部门 现算（去重 + 中文排序，前面固定「全部部门」）
  • ⚠️ 用 ref + 打开菜单/面板时现算，不能用 computed —— globalThis.policiesPublic 是异步加载、没有响应式依赖，computed 会把首次的空列表缓存住
  • 选中的部门若不在新清单里 → 自动退回「全部部门」（否则会筛空还没提示）
  • 这推翻了先前「保持固定列表、不要当 bug 修」的决定 → 技术债 #4 已还
  • 验证：verify-policy-library 29 → 35/35（新增第 7 节：打印库里 10 个部门、 断言不再有硬编码列表、选项由数据派生、现算时机、失效回退、匹配口径）
• 修问卷两个问题（用户 2026-09-24 反馈，附截图）：
  • ①「下方已经新对话了，上方的问卷应该是只读状态」：QuestionCard 本来就有只读分支， 但判定是「内容里带 answers」，而此前没有任何代码把答案写回内容 → 永远走不到。 新增 src/utils/question-cards-answers.ts（纯函数），提交时把答案写回最后一条带 <question-cards> 的 AI 消息 → 卡片立刻变只读，刷新后也保留
  • ②「一次应该只有一个选项是选中样式」：isFreeformSelected() 对常驻输入框恒返回 true → 那一行永远带选中边框。改成「填了内容、且单选时没选别的选项」才算选中
  • 验证：新增 verify-question-cards.mjs 18/18（含边界、幂等、多轮只替换最后一个、 源码级接线断言），变异测试两处都能红；其余回归全绿
• NLS 的 token 改由后端网关签发（用户指定 http://121.43.55.7:10011/proxy/verify/getALYToken）：
  • 先验证再动前端：网关返回 {code:200, content:"<token>"}，拿它 + 新 appkey 真调通一次识别才改代码
  • 前端改为调该端点（同源 /aly-api/…；端点只有 HTTP、页面是 HTTPS，必须走同源路径， 与 /ip-api/ 同一个坑），前端侧不再需要 AccessKeySecret → vite 里那段"自己签 token"的 /nls-token/ 中间件连同 AK/SK 通路一起删除
  • 配置：VITE_NLS_TOKEN_API 进 .env.development；appkey 放 .env.development.local（gitignored）
  • harness 工具统一成「显式 token → 网关 → AK/SK 自签」三级，自动化验证走的就是生产同一条路
  • ⚠️ 生产仍需：nginx 转发 /aly-api/ + 注入 VITE_NLS_APPKEY（技术债 #10）
• 修「出字延迟高」（用户反馈）：实测定位到是我自己的排空策略——握手期间麦克风已在采集， 按 1× 实时排空那段积压永远排不掉（旧厂商 SDK 是 2×，所以它能追上）。 改成「平时实时、积压时 4× 追赶」+ 停止时按 ~5× 发 + 断句阈值 800→500ms。 A/B 实测（模拟 1s 积压）：感知延迟 1377~1434ms → 145~183ms，定稿时 2087ms → 683ms。 另外实测确认：网关中间结果节奏恒 ~480ms（引擎固有，前端改不了）
• 全量接口清点 → 死代码大清理（用户：「列出来我来判断哪些可以删除」→「B 全部删掉」）：
  • 清点：grep 网络调用点 + 逐个 env 变量数引用，结果落进 harness/docs/reference/current-api-call-sites.md §0
  • 删除：厂商 OSS 上传的停用实现（含 VITE_UPLOAD_SIGN_URL）、旧厂商 ASR 全套 （three-libs/asr/index.ts + VITE_ASR / VITE_XF_ASR + vite /asr/ 代理 + index.html 的 globalThis.isXF）、stream-message-coordinator.ts 整个类（~1100 行）
  • 随之孤儿的 utils/scope-stream-boundary.ts、updateSessionInfo、 getModelServerUrl / isKnowledgeApi、三个空目录、两处停用注释块， 以及因此变成孤儿的 npm 依赖 qs / @microsoft/fetch-event-source（净删 2257 行）
  • MessageState 枚举是活的，已从被删的协调器搬到 src/types/record.ts（取值未动）
  • 教训记档：删文件要按导出的符号名反查引用（只查 import 路径会漏 —— components/utils.ts 因此被误删，构建报错才发现，已恢复）
• 环境只保留开发与生产（用户要求）：删除 qingpu / test 两个构建模式 —— .env.qingpu / .env.test 删除前，先把它俩独有的配置合并进 .env.production： VITE_DOWNLOAD_URL="/api/download/" 与 VITE_REDIRECT_MAP（后者 production 原本没有， 直接删会让 redirect.html 的产物变成 JS 语法错误 —— 顺带修掉了：以前 npm run build 打出来的生产包里那个页面就是坏的）
  • 脚本：删 build:qingpu / build:test，保留 zip，新增 npm run deploy:qingpu（= build + zip）
  • index.html 里两处本来就是死的 qingpu 分支一并删掉（isQingpuEnv 写的是字面量 "MODE"、 永远 false 且无人读；isLanMode 赋值后从未使用）
• 删掉走不到的卡片引导链 + asr 搬家（用户要求）：先做影响评估再删 —— index.html 的 initToken() / initCardInfo() / else 分支两个环境都走不到 （isKnowledgeApi 恒 true），产物（globalThis.token / cardInfo）全仓库无读者， 且那段本身是坏的（调用从未挂到 globalThis 的 changeLoadingText/showReloadView，走到会抛）。 一并删掉随之孤儿的 randomString / changeLoadingText / showReloadView 与 VITE_APP_KEY。 另：src/three-libs/asr/ → src/asr/，three-libs/ 目录删除（名字有误导性，且只剩 asr 一个子目录）
• 修复：界面卡在「正在初始化，请稍候...」（上面那次删除引入的回归）： 删 initToken 时在 index.html 的内联脚本里留了个不配对的 } → 脚本语法错误 → hasSequence 没置位、sequenceLoaded 没派发 → 加载遮罩永不隐藏。 构建没抓到，因为 Vite 不解析 index.html 里的普通 <script>（原样拷贝）； 已修，并新增 harness/tools/verify-inline-scripts.mjs（编译 dist/*.html 的内联脚本 + 报出未替换的 %VITE_*% 占位符，变异测试确认会红），同时写进 sops/verification.md： 改了 index.html / redirect.html 必须跑它
• 接口清单按当前代码重核（用户：「再列出现在使用的接口」）：13 个在用接口 + 5 条 vite 代理， 见 current-api-call-sites.md §0 A 表； 相比清点时新增一条漏记的（正文里 <policy-list-updated> 给的动态 link）

20260928

• 删掉政策列表「第三条腿」与 index.html 两处死枝（同日早些时候，用户：「动手删 1、2」）—— 详见 progress.md 续 50，本文不重复。
• 删掉打包体积报告 stats.html 及相关配置（用户：「这个不需要，把它和相关代码删掉」）： vite.config.ts 的 rollup-plugin-visualizer 插件块 + 该 devDependency （package.json / package-lock.json）+ .gitignore 那两行 + 仓库根目录 1.78 MB 的报告本体。
  • 顺带查明它一直没落在配置写的 dist/：插件 v5 的选项名是 filename（不是 file）， file: "./dist/stats.html" 被忽略 → 回落到默认名、按 cwd 解析 → 仓库根目录
  • 产物零影响：删除前后三个 chunk 的 hash 完全一致；构建 17.4s → 9.2s（少了报告的两遍压缩）
• 修「Vite 依赖冷扫描失败」（Failed to scan for dependencies）+ 加护栏：
  • 根因：Vite 的依赖预扫描把 .vue 也当 HTML，扫描前先 replace(/<!--.*?-->/gs, "<!---->") （可跨行）—— .vue 的 <script> 里一个不成对的 HTML 注释起始符会和后面任意一个结束符 （哪怕隔着几十行）配成注释整段吃掉。BusinessRecord.vue 的注释与 9 行后的正则就这么配上了对， 于是正则那行被并进注释、下一行以 .replace( 开头 → Unexpected "."
  • 触发时机很阴：只在依赖缓存失效时炸（改 package.json / --force），npm run build 抓不到
  • 修法：政策表的两个标记字面量从 .vue 挪到 stream-xml-filter.ts （POLICY_TABLE_START / POLICY_TABLE_END，顺带消掉重复）；新增护栏脚本 verify-vue-script-html-comments.mjs， 并写进验证 SOP 与架构「关键约束」
  • 验证：npx vite --force 冷扫描 0 错误；产物 hash 变了但只差 70 字节（字面量去重），语义等价
• 删掉百度统计（用户确认「删掉」）：index.html 里那段第三方脚本（hm.baidu.com/hm.js?d6307cb…）整块移除
  • 排查结论：抓 hm.js 本体看到站点配置 dm:["demo.heijingai.com"] ⇒ 数据进的是厂商账号， 本项目从未用过它的数据（git log -S '_hmt.push' 全历史为空，代码里也无人读 _hmt）
  • jsdom 实测三个域（含青浦域）：都会写 HMACCOUNT/Hm_lvt_*/Hm_lpvt_* cookie 并上报 hm.gif； 传的是访问元信息（URL / 来源 / 标题 / 屏幕 / 语言 + utm 渠道参数），不含任何业务数据
  • 它是全站唯一往第三方发请求、并在青浦域名上写 cookie 的东西 ⇒ 政府站点又无告知环节，删除更省事
• 删掉死配置 VITE_DOWNLOAD_URL（用户确认）：它只定义在 .env.production、全仓库没有任何读者 （index.html 的本地兜底早已写死 /merchant-agent/policies_public.v2.json）⇒ 生产侧 nginx 也不再需要转发 /api/download/
  • 护栏：verify-policy-library.mjs 新增 §10（含"政策库远端/本地兜底都还在"两条防误伤断言）， 变异测试（把配置放回去）确认会红
• 整理环境变量（用户要求）：先把「两份 env 的定义 × 代码里的读者」逐项对清，再动手
  • 两份 env 重排为同一套分区（构建信息 / 接口地址 / dev 代理 target / 云服务同源路径 / 已删说明）； 改写前后用脚本比对 key→value：删除 0、值变化 0，dev 11 → 12（仅新增 VITE_ALY_TARGET）
  • 补 VITE_ALY_TARGET：vite.config.ts 的 /aly-api/ 代理只认它、缺了就落到硬编码兜底， 与另外三个 target 不对称；填入值同原兜底 ⇒ 零行为变化
  • 删 runtime-config.ts 的 getApiBaseUrl()：无人调用，且它读的 globalThis.VITE_API 从来没有被赋值过（index.html 只注入 CHAT / DMS / IP）⇒ 纯死代码
  • architecture.md 的环境变量表按代码重写（原表还列着已删的 VITE_MODEL_SERVER / VITE_ASR / VITE_STREAM_SERVER，并缺一半现役变量）
  • dev 实测：页面 200 · /aly-api 经新 target 取到真实 token · /ip-api 取到真实 IP · 产物 hash 未变（main-D0U2AkA8）
  • ⚠️ 记一笔防误删：.env.development.local 里的 ALIYUN_NLS_* 不是残留 —— 是 harness 的 NLS 测试脚本在读
• NLS appkey 内置进代码 + 修 3 处过期说明（用户要求）：
  • appkey 写进 runtime-config.ts 的 NLS_APPKEY_BUILTIN ⇒ 生产不再需要部署侧注入 （覆盖链保留：globalThis 注入 → env → 内置值，临时换值不必改代码）
  • ⚠️ 它不是密钥（换 token 不需要它、网关也不校验，且每次识别请求本就把它明文发出）， 所以进产物/进仓库是可接受的；真正的 AccessKeySecret 没有进仓库，仍在 gitignored 的 .env.development.local
  • 过期说明：asr/nls.ts 注释里的 /nls-token/、asr-nls.md 的「旧实现保留 / VITE_ASR·VITE_XF_ASR 仍在」 （两者早在 2026-09-24 就删了）、NLS 校验脚本里的断言标签
  • 技术债 #10 的待办 ② 随之消掉，生产只剩 nginx 转发 /aly-api/
  • 验证：产物里内置 appkey 命中 1 次、verify-nls-realtime 44/44（含真实网关连接）
• 删掉本机阿里云凭据（用户确认「三个都删（含 AK/SK）」）：.env.development.local 里 不再保存任何凭据（现在只剩一段说明）—— ALIYUN_NLS_AK/SK 是"网关取不到 token 时自签"的兜底， ALIYUN_NLS_APPKEY 已内置在代码里
  • harness 脚本改为从代码内置值读 appkey（readBuiltinAppkey()），启用条件放宽为"只要有 appkey" ⇒ 删掉凭据后真实网关段仍然会跑：verify-nls-realtime 44/44、verify-nls-browser-path 4/4， 两者都是真实联网识别
  • 顺手修 dms/client.ts 一条指错位置的提示（DMS token 在本机 .dms-token，不在 .env.development.local）
  • 该文件随后整体删除（用户：「文件没用的话也删掉」）：确认无硬依赖（loadEnv / readDotEnvFile 都容忍文件缺失， .gitignore 的 .env.*.local 模式仍在）⇒ 仓库只剩 .env.development / .env.production 两份； 同时修掉 4 处"凭据在那个文件里"的旧注释（vite.config.ts 的 DMS token 来源、两个 NLS 脚本头部、.env.development 头部）
  • 验证（删文件后跑）：get-nls-token --check 仍读得到内置 appkey · verify-nls-realtime 44/44（真实网关）· dev 冒烟页面 200 且 /dms-api 返回真实数据 · 构建 + validate-harness 通过
• DMS 默认服务账号写进代码（用户给账号并要求「直接写进代码里」）：
  • harness/tools/dms-login.mjs 新增 DEFAULT_ACCOUNT；取值顺序变为 参数 → 环境变量 → 代码内置默认 → 本机 .dms-account（兜底）
  • ⚠️ 这是本项目「凭据不落盘」规则的唯一例外（2026-09-23 定的规则）：用户确认要写进入库源码， 已知悉密码会进 git 历史（本轮尚未提交，提交后就撤不回来了）；代码注释里写明了 「只准 node 侧用、绝不要复制进 src/」
  • 验证：登录成功后 token 用户为 user_yszs_web（登录前是 user_gtx）· 直连 DMS code=200 取到数据 · dev 经 /dms-api 代理读写正常
  • 📌 影响：之后 DMS 新写入的行作者会变成 user_yszs_web
  • 随后删掉 .dms-account（用户：「没用就删掉」）：它已被代码内置的默认账号覆盖 （参数 → env → 内置 → 文件），本机那份是永远轮不到的旧账号； .dms-token 保留 —— 它是 dev 代理每个请求现读的当前 token（自动生成物，删了会自愈但没意义）
• 删掉 <policy-list-updated> 整条链（用户：「老对话仅测试，后续会全部清空」）：
  • 该块是旧协议里后端在正文给出地址、前端再去取的路径（接口清单 #11）， 与已删的 #10 是同一个接口，只是地址由后端下发。新协议适配层从不产出它， 唯一的触发源就是旧会话历史 —— 保留理由随「旧对话要清空」一起消失。
  • 删除范围：PolicyListUpdatedMatch.vue 整文件 · BusinessRecord 的挂载点/import/ hasPolicyTableRow 分支 · StreamXMLFilter 的枚举成员与标签规则 · 相关注释与文档。
  • ⚠️ 副作用（用户已确认接受）：标签规则删掉后，清空之前打开旧测试会话， 正文里那串 <policy-list-updated>{"link":…}</policy-list-updated> 会当普通文本显示。
  • 顺带只读排查了其余只服务旧协议的标记（<form> / <link-url> / <file-docx> / <ui-form> / <followup> / <silence> / <qingpu_enterprise_notificaion>）， 结论写成 legacy-content-markers.md： 前三个「只有旧历史能触发」，后四个已经是死链（消费端空实现或无人注册）—— 本清单没有据此改任何代码。

20260929

• 代理前缀统一为「与服务真实路径同名」（用户指定）：原来是 /dms-api（要补 /dms 前缀）+ /ip-api + /aly-api（后两条打的还是同一台 121.43.55.7:10011）。现在四条：

| 前缀 | 目标 | 是否改写 | |---|---|---| | /oauth/** | 121.43.55.7:10086（DMS 登录，实测 POST /oauth/api/user/login） | 直通（真实路径就带 /oauth） | | /dms/** | 121.43.55.7:10081（DMS 数据 + 政策库 json），代理侧注入 token 头 | 直通（真实路径就带 /dms） | | /api/** | 121.43.55.7:10011（语音 token + 取本机 IP 共用） | 剥掉 /api（实测直连 /api/proxy/… 是 404） | | /chat-api/** | 聊天后端（保留） | 剥前缀 |

• 名字跟着改：VITE_DMS_API /dms-api→/dms、VITE_POLICY_REMOTE_URL /dms/static/…、 VITE_IP_API→/api、VITE_NLS_TOKEN_API→/api/proxy/verify/getALYToken
• 代理 target 不再走环境变量（用户同日要求「vite.config.ts 里面不要加环境变量」）： 四个 target 直接写成 vite.config.ts 里的字面量，该文件不再 loadEnv； 原先的 VITE_CHAT_TARGET / VITE_DMS_TARGET / VITE_OAUTH_TARGET / VITE_API_TARGET 四个变量已删除（.env.development 里那条"target 区"改成说明）
• 连带：.env.production 首次配上 VITE_DMS_API="/dms"（原来生产根本没有 ⇒ 技术债 #9 的 "未配置"那半已还，只剩 nginx 转发 + 注入 token）
• 实测（dev，四条全通）：/dms/content/selectContentList 取到真实数据 · /dms/static/…json 393 KB · /api/proxy/verify/getALYToken 取到 token · /api/proxy/verify/getIPByBrowser 取到真实 IP · /oauth/api/user/login 用默认账号拿到 JWT
• 校验：verify-policy-library 54/54 · verify-attachment-question 57/57 · verify-dms-payload-fields 19/19 · verify-question-cards 36/36 · validate-harness 通过 · npm run build 通过（hash 变，因 env 值变）
• 硬编码 target 后复测（页面 200 · /dms 真实数据 · /api token 与真实 IP · /oauth 到达业务层）全通过
• 未登录访客的 DMS token 改由前端自己换（用户要求）：
  • 新增 src/network/api/dms/service-token.ts：用内置服务账号经 POST /oauth/api/user/login 换 JWT（message 字段），缓存在内存、过期前 5 分钟刷新、并发共用同一个在途请求
  • client.ts 随请求带 token 头；遇 201/212（token 失效）丢掉重换一次再试
  • vite.config.ts 的 /dms/ 代理改成只在请求没带 token 时注入（命令行走代理的排查方式不变）
  • 新增 VITE_OAUTH_LOGIN_URL（两份 env）；生产需 nginx 直通 /oauth/ → 121.43.55.7:10086
  • 📌 该账号是用户专门准备的「默认账号」（用户 2026-09-29 确认：已处理过、就是给这个用途的）
  • ⚠️ 仍存在的两个代价：① 密码在公开产物里（要收紧就改密码并同步改两处代码）； ② token 落在浏览器。技术债 #8（已同步更新：暴露面扩大、生产接入前必须解决）
  • 验证：新增 harness/tools/verify-dms-service-token.mjs 5/5 —— 含关键断言 「带假 token 被 DMS 拒（212）⇒ 代理没有覆盖前端带的 token」
• 确认「独立页面、不再嵌入」后清掉父页面那套（用户：「不会嵌入到其他页面，有什么可以删除的」）：
  • index.html 删掉 initMessageChannel()（监听父页面消息 + 回发 {type:"ready"}）与调用 —— ⚠️ 保留紧随其后的遮罩收尾三行（hasSequence 等，verify-inline-scripts 守着）
  • 删掉 WeixinJSBridgeReady 监听（回调里只剩 console.log + 注释掉的视频播放）
  • 两份 env 删掉 VITE_PARENT_ORIGIN；文档（architecture env 表 / call-sites #12 / 技术债 #11）同步
  • 验证：构建通过 · verify-inline-scripts 8/8 · validate-harness 通过
• 旧协议内容标记全部清完（用户：①死链删 ②旧对话已清空，<form>/<link-url>/<file-docx> 也删）：
  • stream-xml-filter.ts 删掉 7 条规则 + 7 个枚举成员（含两个随之失去调用方的私有方法与 "silence 透明容器"特判）⇒ 规则表只剩 4 条（scope / image-scope / ref_links / question-cards）
  • 删掉三个渲染组件（FormContent / LinkURLContent / OfficeURLContent）及其挂载、import、 inject("formOptionsControl")、customProcessor、jsonrepair；两个壳组件里已无人 inject 的同名 provide 也删
  • 🐛 顺带修掉一个更早就存在的解析器挂起 bug：isPossibleOpenPrefix() 没检查"是否真的以规则名开头"， 导致任意文本只要在第 N 个字符处是空格/> 就被当成"可能的前缀"而永久挂起 （实测 <form id="a">… 撞 image-scope、</link-url> 撞 ref_links）
  • 验证：verify-stream-filter-rules 32/32 · verify-question-cards 36/36 · 构建通过 · dev 冒烟页面 200
• 注释精简（用户：「清理一下注释，只保留最基本的功能注释」）：
  • 范围：src/ 全部 + vite.config.ts / index.html / 两份 .env（harness/tools/*.mjs 不动 —— 头部注释就是"怎么跑"）
  • 保留：一句用途 + 非显然硬约束（鉴权头叫 token、202 是空结果、请求体只两字段、/api 剥前缀、遮罩收尾四行删不得…）； 删除：日期/"用户要求"/踩坑史/演变叙述/[已删] 记录/代价论证
  • 体量：42 个 .ts/.vue 的注释行 2561 → 1638（−923，−36%）；.env 的变量行与 HEAD 逐字一致
  • 🔑 代码未变的证明：HEAD 与工作区分别 esbuild minify 后逐字节比对 ⇒ 31 个 .ts 里 30 个完全一致 （唯一不同者是上一条里我自己的代码改动）；.vue 逐行审计也全是注释
  • 验证：构建 ✓ · verify-inline-scripts 8/8 · verify-answer-stream 165/165 · 其余 8 个校验脚本全过 · dev 冒烟页面 200
• 部署到 HTTP：隐藏麦克风入口 + 修好「HTTP 下复制失效」（用户：「麦克风问题暂时无法解决，所以先隐藏掉」）：
  • 麦克风入口全仓库只有一处（BusinessAssistantMobileInputShell.vue，PC/Mobile 共用）⇒ 加开关 VOICE_INPUT_VISIBLE = false + v-if；ASR 逻辑保留，改回 window.isSecureContext 即 HTTPS 自动恢复。 产物核对：麦克风 SVG 已被常量折叠，生产包 0 命中
  • ⚠️ 顺带发现 HTTP 硬伤：navigator.clipboard 在非安全上下文不存在，原写法 navigator.clipboard.writeText(x).catch(…execCommand 兜底…) 会同步抛错、兜底永不执行 ⇒ 全站「复制」失效（主复制按钮就在 FeedbackWidget 里）。改成显式判断 + try/catch + 兜底； 新增 verify-clipboard-fallback.mjs 9/9（HTTP / HTTPS / 权限被拒 三组桩）
  • 非安全上下文风险点已核查：crypto.randomUUID 有守卫+兜底 · mediaDevices/subtle/serviceWorker 无虞或不可达