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

docs(harness): 接口清单按当前代码重核(用户要求「再列出现在使用的接口」)

今天改动很大(删旧 ASR / 删 qingpu+test 环境 / 删 openid 引导链 / asr 移出 three-libs),
所以按现在的代码重新抓了一遍网络调用点与 env 引用,更新 current-api-call-sites.md §0:
- 在用 13 项:/api/chat、/api/company/classify、DMS content/*、DMS file/uploadFile、
  NLS token 网关、NLS 实时识别 wss、本机 IP、enterprise/login + enterprise_info、
  政策库 json(download + 本地兜底)、{VITE_MODEL_SERVER}/v1/policies、
  **新增**「正文里 <policy-list-updated> 给的 link」(原先漏了)、postMessage(parentOrigin)、
  redirect.html 的跳转映射
- 删掉两行过时项:openid_to_token / VITE_APP_KEY(§6 已改成「已删除」);
  §0 D 的 env 清单同步(已删:VITE_ASR / VITE_XF_ASR / VITE_APP_KEY)
- 保留「只 grep src/ 会误判」的两条更正(VITE_APP_KEY、VITE_USE_KNOWLEDGE_API)

无代码改动;validate-harness 通过。

Co-Authored-By: Claude Code <noreply@anthropic.com>
gongtianxiao 1 hónapja
szülő
commit
40dc19c2ee
1 módosított fájl, 18 hozzáadás és 18 törlés
  1. 18 18
      harness/docs/reference/current-api-call-sites.md

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

@@ -20,14 +20,16 @@
 | 6 | `wss://nls-gateway-cn-shanghai.aliyuncs.com/ws/v1` | 实时语音识别(阿里云 NLS) | `src/asr/nls.ts` |
 | 7 | `GET {VITE_IP_API}/proxy/verify/getIPByBrowser`(→ 同上 10011) | 取本机 IP(DMS 访客归属) | `src/utils/client-ip.ts` |
 | 8 | `POST {VITE_API}/enterprise/login`、`GET {VITE_API}/fta_ent_policy/enterprise_info` | 企业登录换码 / 拉企业信息(**老接口**) | `src/network/api/enterprise.ts` |
-| 9 | `POST {modelServer}/open/openid_to_token`(带 `app_key=VITE_APP_KEY`)+ 助手卡片信息 | 免登引导、卡片配置 | `index.html`(脚本段) |
-| 10 | `GET {VITE_DOWNLOAD_URL}merchant-agent/policies_public.v1.json` | 惠企政策库(本地 `/merchant-agent/…` 兜底;`VITE_POLICY_LOCAL_FIRST` 决定远端/本地优先级) | `index.html` + `Chat/PolicyMatch.vue` |
-| 11 | `GET {VITE_MODEL_SERVER}/v1/policies?…` | 政策「更多」面板列表(远端优先,取不到退本地库) | `Chat/PolicyMatch.vue` |
+| 9 | `GET {VITE_DOWNLOAD_URL}merchant-agent/policies_public.v1.json` | 惠企政策库(本地 `/merchant-agent/…` 兜底;`VITE_POLICY_LOCAL_FIRST` 决定远端/本地优先级) | `index.html` + `Chat/PolicyMatch.vue` |
+| 10 | `GET {VITE_MODEL_SERVER}/v1/policies?…` | 政策「更多」面板列表(远端优先,取不到退本地库) | `Chat/PolicyMatch.vue` |
+| 11 | `GET <后端在正文里给的 link>` | 「政策列表(更新版)」:正文里 `<policy-list-updated>{link,payload}</policy-list-updated>` 由后端给出地址,前端照着取 json | `Chat/PolicyListUpdatedMatch.vue` |
 | 12 | `postMessage(…, VITE_PARENT_ORIGIN)` | 与父页面通信(嵌 iframe 场景) | `index.html` |
-| 13 | `VITE_REDIRECT_MAP` | 跳转映射页 | `redirect.html` |
+| 13 | `VITE_REDIRECT_MAP` | 跳转映射页(纯本地,不发请求) | `redirect.html` |
 
-> 📌 **更正一条旧说法**:`VITE_APP_KEY` **不是死配置** —— `index.html` 的 `openid_to_token` 在用。
-> (`asr-realtime.md` §8 曾写它是死配置,因为只 grep 了 `src/`,没看 `index.html`。)
+> 📌 **2026-09-24 的两处更正**(都因为只 grep `src/` 会误判):
+> ① `VITE_APP_KEY` 曾被我写成"死配置",其实 `index.html` 的 `openid_to_token` 在用 ——
+> **后来那条 `openid` 引导链整段删除**(两个环境都走不到,见 §6),`VITE_APP_KEY` 随之删除;
+> ② `VITE_USE_KNOWLEDGE_API` 也不是死配置 —— `index.html` 在用它切「政策解读」卡片。
 
 ### B. 已停用 / 死代码 —— **✅ 2026-09-24 已按用户要求全部删除**
 
@@ -66,11 +68,10 @@
 
 `VITE_API`(#8 + index.html 的 modelServer)· `VITE_CHAT_API` · `VITE_DMS_API` · `VITE_IP_API` ·
 `VITE_NLS_TOKEN_API` · `VITE_NLS_APPKEY` · `VITE_DOWNLOAD_URL` · `VITE_POLICY_LOCAL_FIRST` ·
-`VITE_MODEL_SERVER` · `VITE_PARENT_ORIGIN` · `VITE_REDIRECT_MAP` · `VITE_VERSION` ·
+`VITE_MODEL_SERVER` · `VITE_PARENT_ORIGIN` · `VITE_REDIRECT_MAP`(`redirect.html` 用)· `VITE_VERSION` ·
 四个 `*_TARGET`(vite 代理用)· `VITE_USE_KNOWLEDGE_API`(经 `globalThis.isKnowledgeApi`,
-**`index.html` 在用它切「政策解读」卡片** —— 2026-09-24 更正:只 grep `src/` 会把它误判成死配置)。
-(`VITE_ASR` / `VITE_XF_ASR` 已随旧 ASR 删除;`VITE_APP_KEY` 只在 §6 那条**已走不到**的
-`openid` 路径里用 —— 见 §6。)
+**`index.html` 在用它切「政策解读」卡片**)。
+已删:`VITE_ASR` / `VITE_XF_ASR`(随旧 ASR)、`VITE_APP_KEY`(随 §6 的 `openid` 链)。
 
 **环境只剩两份(2026-09-24 用户要求)**:`.env.development` + `.env.development.local`(本机凭据,
 gitignored)+ `.env.production`。`qingpu` / `test` 两个模式已删除,脚本也随之调整
@@ -197,15 +198,14 @@ wss://{VITE_XF_ASR}/api/human_asr/v2/asr?Authorization=...
 - 现状:`fetchPolicyList` 里前面两档(惠企政策库 262 条 / 本轮卡片兜底)**几乎总能命中**,
   第三档基本走不到
 
-### 6. `openid` 换 token —— **⚠️ 现在走不到了(2026-09-24 起)**
+### 6. ~~`openid` 换 token~~ —— **✅ 2026-09-24 已删除**
 
-- 触发:`index.html` 的 `initToken()`(`POST {modelServer}/open/openid_to_token`,带 `app_key=VITE_APP_KEY`)
-- 现状:它挂在 `if (globalThis.isKnowledgeApi) {…} else { initToken(); }` 的 **else** 上,
-  而 `isKnowledgeApi` 来自 `VITE_USE_KNOWLEDGE_API` —— **开发与生产两个 env 都是 `true`**。
-  原先唯一为 `false` 的是 `.env.test`,该环境已按用户要求删除 → **这条路径在两个环境里都执行不到**。
-- **待用户决定**:`initToken()` / `VITE_APP_KEY` / 那段 `openid` 引导可以删(删前要确认
-  `cardInfo` 的另一条来源足够 —— `isKnowledgeApi` 分支里是写死的「政策解读」卡片,
-  生产实际用的是 `initCardInfo()` 拉回来的卡片,两者关系需先理清)。
+用户要求「判断删除后是否会对现用功能造成影响,没有影响就删掉」。评估结论:**无影响** ——
+它挂在 `if (isKnowledgeApi) {…} else { initToken(); }` 的 else 上,而两个环境都是
+`VITE_USE_KNOWLEDGE_API=true`;产物 `globalThis.token` / `cardInfo` 全仓库无读者;
+那段本身还是坏的(调用从未挂到 globalThis 的 `changeLoadingText` / `showReloadView`)。
+删除范围:`initToken` / `initCardInfo` / else 分支 + `randomString` / `changeLoadingText` /
+`showReloadView` + `VITE_APP_KEY`。详见 `progress.md` 续 39/40。
 
 ### 6b. 附件上传 —— **已改走 DMS 文件服务(2026-09-23)**