Ver Fonte

docs(harness): 更新接口清单——1887 会话写入已停用

用户问「当前有哪些接口在使用」。重扫所有网络调用点并逐个确认调用方后更新文档:

- 第一节改为表格并写明:**1887 助手会话不再写入**(2026-09-18 用户指示),
  会话列表退化为纯本地;在用的是 `POST /api/chat` + DMS 1889(记录写入/读取、反馈、删除清理)
- 复查死代码:card/index.js 仍无调用方,唯一残留引用是 useBusinessAssistantChat.ts:2
  那个未使用的 import(仍在)

验证:validate-harness 通过;每条与代码核对。

Co-Authored-By: Claude Code <noreply@anthropic.com>
gongtianxiao há 2 dias atrás
pai
commit
fbc936d0c4
2 ficheiros alterados com 38 adições e 3 exclusões
  1. 14 3
      harness/docs/reference/current-api-call-sites.md
  2. 24 0
      harness/progress.md

+ 14 - 3
harness/docs/reference/current-api-call-sites.md

@@ -8,8 +8,19 @@
 
 ## 一、已经迁到新接口的(不用管)
 
-对话(`POST /api/chat`,SSE)、会话列表 / 历史 / 改名 / 删除、点赞点踩的**落库**(DMS 1887/1889)、
-政策卡片与协议内容(随 `/api/chat` 下发)、惠企政策库数据(静态 json)。
+| 功能 | 接口 | 备注 |
+|---|---|---|
+| 对话(SSE) | `POST {VITE_CHAT_API}/api/chat` | |
+| 问答记录(历史)**写入 + 读取** | DMS 栏目 **1889** | 一问一答一条;`title` = 问题文本 |
+| 点赞/点踩/取消 | DMS 1889 的 `c_feedback_*` | |
+| 删除会话 | DMS(清 1889 记录 + 1887 旧行) | |
+| 政策卡片与协议内容 | 随 `/api/chat` 下发 | |
+| 惠企政策库数据 | 静态 json `policies_public.v1.json` | |
+
+> ⚠️ **2026-09-18 起:1887 助手会话不再写入**(用户指示「只传具体的会话记录,另一个接口不传了」)。
+> 新建会话、改名都不再同步;**前端会话列表退化为纯本地**
+> (`mergeRemoteSessions` 拿到空数组无害,行为与接 DMS 之前一致)。
+> 停用的调用点按约定注释保留在 `useBusinessAssistantChat.ts`,并有源码级断言防改回。
 
 ## 二、还在用老接口的功能
 
@@ -78,7 +89,7 @@
 | `src/network/api/card/index.js` 的 `getMediaList` | 卡片里的媒体文件信息(图片/附件的展示) | 无调用方 |
 | 同上的 `giveFeedback` | 点赞点踩**落库**(旧接口版) | 反馈改走 DMS 后,最后一个调用点消失 |
 | 同上的 `appendHistory` | 把每轮问答追加到服务端历史 | 早就注释掉了,历史改由接口的 `enable_history` 控制 |
-| `useBusinessAssistantChat.ts:2` 的 `import cardAPI` | — | **未使用的 import**,是上面这个模块唯一的引用 |
+| `useBusinessAssistantChat.ts:2` 的 `import cardAPI` | — | **未使用的 import**,是上面这个模块**唯一**的引用(2026-09-18 复查仍在) |
 | `PolicyListUpdatedMatch.vue` | 旧协议 `<policy-list-updated>` 卡片列表 | 仍被 `BusinessRecord` 挂载,但**新协议不再产出这种块**,只有旧历史内容可能触发 |
 
 > 清理这些要另开一轮,并先确认没有旧数据依赖。

+ 24 - 0
harness/progress.md

@@ -1850,3 +1850,27 @@
     将来若恢复 1887 写入可直接复用
 - **下一步最佳动作**:浏览器确认「问答记录仍正常写入、会话列表走本地」;业务口径定了再议 1887
 
+## Session 044
+
+- **日期**:2026-09-18
+- **本轮目标**:用户问「当前有哪些接口在使用」——重新清点并更新参考文档
+- **已完成**:
+  - 全仓库重扫所有网络调用点(排除注释行),逐个确认调用方是否还活着
+  - 更新 `docs/reference/current-api-call-sites.md`:
+    - 第一节改为表格,并写明 **1887 会话写入已停用**、会话列表退化为纯本地
+    - 复查死代码:`card/index.js` 仍无调用方,**唯一残留引用是
+      `useBusinessAssistantChat.ts:2` 那个未使用的 import**(仍在)
+- **当前在用的接口**(详见文档):
+  - **新接口**:`POST /api/chat`(对话)、DMS **1889**(问答记录写入+读取、反馈、删除清理)
+  - **老接口**:企业登录 `/enterprise/login`、企业信息 `/fta_ent_policy/enterprise_info`、
+    统计埋点(page_view / feedback,与 DMS **双写**)、ASR、OSS 上传(入口被注释)
+  - **几乎不可达**:`{VITE_MODEL_SERVER}/v1/policies`
+  - **仅 test 构建**:`openid_to_token`
+- **运行过的验证**:`validate-harness` 通过;每条与代码核对过
+- **已记录证据**:本文件 Session 044;`docs/reference/current-api-call-sites.md`
+- **更新过的文件或工件**:`harness/docs/reference/current-api-call-sites.md`、本文件
+- **已知风险或未解决问题**:
+  - ⚠️ `useBusinessAssistantChat.ts:2` 那个未使用的 `import cardAPI` 还在(是死模块 card/index.js
+    的唯一引用)——**要清理另说**,属独立的小清理
+- **下一步最佳动作**:无(本轮为清点)
+