Forráskód Böngészése

按原有改动记录格式精简 README。

保留按日期正序的记录,去掉展开的原因和验证细节。

Co-Authored-By: Cursor <cursoragent@cursor.com>
gongtianxiao 16 órája
szülő
commit
6c867ef9e9
1 módosított fájl, 116 hozzáadás és 20 törlés
  1. 116 20
      README.md

+ 116 - 20
README.md

@@ -1,29 +1,125 @@
-# 青浦区营商智能助手
+# zhaoshang-llm 改动记录
 
-企业政策匹配与办事咨询的前端。Vue 3 + TypeScript + Vite。
+> 本文件当前只记录**按日期的改动**。项目概述、技术栈、目录结构、接口说明等内容,
+> 等项目结束时再统一总结。
 
-用户提问后,对话走 `POST /api/chat`(SSE)。`src/components/api-chat-coordinator.ts` 把事件翻译成内容标记,再交给消息组件渲染正文、政策卡片、参考资料和补问。
+## 20260914
 
-## 本地运行
+- AI 对话迁到 `POST /api/chat`(SSE)。适配层 `api-chat-coordinator.ts` 把事件译成既有内容标记,渲染层不感知协议
+- 请求体只发 `{thread_id, question}`;`answer` 与 `result.response` 只展示一次;未收到 `done`/`error` 即断流时按中断处理,不自动重试
+- 旧协议 `stream-message-coordinator.ts` 当时保留未用(20260924 已删除)
+- 新增 `VITE_CHAT_API` 与 dev 代理 `/chat-api`
+- 政策卡片、详情、参考资料、公司补问接入新协议;HTTP / SSE 错误码译成中文提示
 
-```bash
-npm install
-npm run dev
-```
+## 20260915
 
-开发地址:https://localhost:8083
+- 回答顺序定为:正文 → 政策卡片 → 综合说明 → 参考资料
+- 修复块级 Markdown 单个换行被折叠,说明行并进上一条列表
+- 复制时剔除 `<scope>`、`<!-- POLICY_TABLE -->`、`<ref_links>` 等协议标记
+- 卡片按 `priority.rank` 排序;「更多」复用卡片数据,不再另拉公共政策库
+- 部门筛选当时还原为 15 个固定部门(20260924 改为按政策库现算)
+- 惠企政策库卡片右上角打来源标;详情增加条件核验、匹配依据、原文引用(原文引用于 20260917 删除)
 
-```bash
-npm run build
-npm run preview
-```
+## 20260916
 
-部署后的接口与栏目配置在 `public/config.js`,可直接修改,不必重新打包。
+- 打字机提速到 4 字/次(约 121 字/秒),积压时再加速
+- 政策事项列表统一为一个入口:卡片「更多」与详情返回走同一份数据(`policies_public.v1.json`,本轮惠企政策置顶);每次进入重置筛选
+- 只有惠企政策才显示「返回政策事项列表」;判定优先 `is_policy_library`,否则按标题回库匹配
+- 公司补问按 `status`(`found` / `not_found` / `failed` / 无 status)分支,不再靠候选数或文案猜测
+- 补问输入框常驻在选项上方,序号从 A 起;正文已出现的句子不在卡片里重复
+- 「跳过公司查询」改为发送选项原文,不再发 `/skip`
+- 问卷提交补上多题、多选,以及数字开头选项被改成纯数字的问题
 
-## 目录
+## 20260917
 
-- `src/components/BusinessAssistantPC.vue`、`BusinessAssistantMobile.vue`:页面主壳
-- `src/components/api-chat-coordinator.ts`:聊天协议适配
-- `src/components/Chat/`:回答渲染
-- `src/asr/`:语音识别
-- `public/merchant-agent/`:惠企政策库
+- 修复切会话误报「请求已取消」:归一化与渲染层统一用 `hasVisibleMessageContent()` 判断内容是否为空
+- 删除政策详情的「原文引用」;思考中卡片标题恒定单行省略,正文仍可换行
+- 政策名称可按 `data.市级政策id` 跳到上海政务网详情;没有 id 不给链接
+- 开发环境政策库改为本地 JSON 优先(`VITE_POLICY_LOCAL_FIRST`),生产仍远端优先
+- 会话、问答与反馈落到 DMS(栏目 1887 / 1889);未登录以 `访客_<id>` 写入;token 只在代理侧
+- DMS 删除改为 `updateAudit` 状态 `4`;存储粒度曾改为「一会话一行」,同日改回「一问一答一行」
+- 去掉开发环境硬编码自动登录,默认访客态
+- `harness/`、`CLAUDE.md`、`agents.md` 当时纳入版本控制(20261120 起 `harness/` 改回不入库)
+- 同政策多张卡片的详情按对象同一性区分,避免点开都是第一条;详情标题显示具体申报事项,卡片标题仍是政策名
+- 卡片「更多」打开本条回答的政策列表侧边栏(搜索保留,部门/分类筛选去掉);详情里的返回仍进惠企政策库
+- 生成改为按会话并行:各会话独立协调器,停止只停当前轮;409 与重复发送改为 Toast 提示
+- 删除未使用的 env、`/stream/` 代理、空目录和 `stats.html`
+- 恢复图片/附件上传:OSS 地址拼进发给后端的问题文本,本地气泡与标题不显示 URL
+- 删除统计埋点;点赞只写 DMS。`PolicyListUpdatedMatch.vue` 当时保留,20260929 已删除
+
+## 20260918
+
+- DMS 只写 1889 问答记录,1887 会话暂停写入(调用点注释保留)
+- 问答 `title` 改为问题文本;1887 四个必填运营字段只在新增时传空值,更新不带,避免冲掉后端回填
+- 聊天后端地址改由 `VITE_CHAT_TARGET` 配置
+- 移动端首页收紧顶栏、logo 与文案间距,避免建议词被输入框挡住;标题仍是「你好,有什么我可以帮您的?」,移动端 22px,PC 32px
+- `company_info` 非空时,回答完成后同步 DMS:1888 写分类标签,1886 按 `honors.records` 逐条对齐;失败不影响聊天
+- 去掉窄屏把标题放大回 28px 的覆盖,窄屏改由 `clamp` 收缩
+
+## 20260920
+
+- 1888 补齐工商字段(空值不写、JSON 按语义比较);荣誉与工商不依赖分类接口
+- 政策详情「名称 / 部门」一行拉满宽度
+- `result.data.cipa === true` 时,在参考资料前展示企业微信二维码;补问轮不展示;复制时去掉 `<image-scope>`
+- 正文改为 `answer_start` / `answer_delta` / `answer_end` 增量上屏。增量 Markdown 规整保证已上屏内容是最终文本的前缀,避免整段重绘
+- 流式轮跳过与正文重复的开场 `answer`;用户停止保留已出文字,出错或断流撤掉未定稿草稿
+
+## 20260921
+
+- 政策卡片在正文开流前上屏,收尾不再整段重排
+- `answer_end` 后同步「已流正文」,避免最终文本更长时正文出现两份
+- 参考资料在正文定稿后立即上屏,不再干等 `result`;二维码仍等 `result.cipa`,并保持在参考资料之前
+- 收尾时把已上屏行标为打字完成,避免视图被拉回回答顶部
+- 大块内容(卡片、参考资料)改为对齐块的顶部,而不是一次滚过整块
+- 流式草稿被最终 Markdown 整段替换,按契约接受
+- DMS token 改存本机 `.dms-token`,代理每次请求现读;`npm run dev` 前可自动续期
+- 注释掉输入框旁的 MOCK 测试按钮
+
+## 20260922
+
+- 1887 写入企业名称、信用代码、图片、是否登录。登录态优先;已被登录认领的行,后续访客对话不能改写
+- 企业查看会话时排除访客行;`c_title` 不写
+- 访客身份改为 `访客_<本机 IP>`,取 IP 走同源代理;取不到则退回随机 id
+- 复制回答去掉 Markdown 语法,有序列表序号和链接地址保留
+- 记录 DMS 协议坑:更新时带上模型里不存在的列,会静默丢掉整次更新
+
+## 20260923
+
+- 请求体新增 `pictures` / `files`(URL 字符串数组)。无附件时不发这两个字段
+- 附件改传 DMS `uploadFile`,存相对路径;气泡预览再拼 DMS 前缀
+- 图片限 JPEG、PNG、GIF、WebP;文件限 Excel、DOCX、文字 PDF。不支持的格式改为顶部轻提示,不再 `alert`
+- 全局提示改为 Ant Design `message`(顶部弹出、自动消失)。语音相关 `alert` 一并更换;清空输入的 `confirm` 保留
+- 轻提示时长改为 2 秒
+- 问答记录把附件相对路径写入 `c_image` / `c_file`,多个用逗号分隔
+- 只要正常完成的对话就在 1887 建行;无企业资料时不填 `c_credit_code`,运营分析列前端不碰
+- 语音识别换阿里云 NLS:token 先由 dev 端点代签,协议与旧 SDK 对齐;中间结果只用于实时显示,全文只用断句结果
+
+## 20260924
+
+- 部门筛选改为只列出政策库里实际存在的部门,打开菜单时现算,不用 computed
+- 问卷提交后把答案写回消息,历史问卷变为只读;常驻输入框不再一直显示选中样式
+- NLS token 改由后端网关 `getALYToken` 签发,前端不再持有 AccessKeySecret
+- 语音积压改为平时实时、积压时 4 倍追赶,降低出字延迟
+- 删除厂商 OSS 上传、旧 ASR、`stream-message-coordinator` 及随之无用的依赖与代理
+- 构建模式只留开发和生产;`redirect.html` 补上生产环境缺失的 `VITE_REDIRECT_MAP`
+- 删除走不到的父页初始化与卡片引导;ASR 目录改到 `src/asr/`
+- 修复删除引导代码时弄坏 `index.html` 内联脚本、加载遮罩不消失的问题
+
+## 20260928
+
+- 删除打包体积报告 `stats.html` 及相关插件
+- 修复 Vite 依赖扫描把 `.vue` 里不成对的 HTML 注释起始符当成注释、导致冷扫描失败
+- 删除百度统计脚本
+- 删除无引用的 `VITE_DOWNLOAD_URL`
+- 两份 env 按同一分区整理;补 `VITE_ALY_TARGET`;删除无调用的 `getApiBaseUrl()`
+- NLS appkey 内置进代码;删除本机 `.env.development.local` 与 `.dms-account`
+- DMS 默认服务账号写入 `dms-login.mjs`(仅 node 侧使用)
+
+## 20260929
+
+- 代理前缀改为与真实路径同名:`/oauth`、`/dms` 直通,`/api` 剥前缀后打语音与 IP 网关,`/chat-api` 保留。代理目标写死在 `vite.config.ts`,不再从 env 读
+- 未登录访客的 DMS token 由前端用内置服务账号换取;代理只在请求没带 token 时注入
+- 确认页面不再被嵌入后,删除父页面消息通道、微信桥监听和 `VITE_PARENT_ORIGIN`
+- 旧协议内容标记清完,解析规则只留 scope、image-scope、ref_links、question-cards;顺带修复「任意文本被当成未闭合标签而挂起」
+- 注释只保留用途和非显而易见的约束
+- HTTP 部署先隐藏麦克风。修复非安全上下文下 `navigator.clipboard` 不存在、复制失败的问题,改为判断后再走 `execCommand` 兜底