Procházet zdrojové kódy

docs(harness): 更正 architecture.md 的失实描述——three-libs 里只有 asr,且在用

用户以为 three-libs 是数字人、要删掉。实测核查后这是会误删的前提:
- find src/three-libs -type f → 只有 asr/index.ts 一个文件
- 它正在用:PC 与移动端都 import ASR from '@/three-libs/asr/index',
  点麦克风走的就是它 —— 删了语音识别就没了
- 顺带更正 architecture.md 里「src/three-libs/metamaker 是未被引用的 SDK 包」
  这句失实描述:该目录根本不存在

数字人的实际残留是另外三个没人读的 env(VITE_STREAM_SERVER / VITE_STREAM_TOKEN /
VITE_HUMAN_IDLE_MP4_URL)与 vite 的 /stream/ 代理(target 硬编码),删它们不影响功能。

Co-Authored-By: Claude Code <noreply@anthropic.com>
gongtianxiao před 2 dny
rodič
revize
dc94679a72
2 změnil soubory, kde provedl 28 přidání a 1 odebrání
  1. 4 1
      harness/docs/architecture.md
  2. 24 0
      harness/progress.md

+ 4 - 1
harness/docs/architecture.md

@@ -16,7 +16,10 @@
   `src/components/api-chat-coordinator.ts` 翻译成既有渲染组件可识别的内容标记。
   详见 [`reference/api-chat.md`](reference/api-chat.md)。
 - **没有 3D 虚拟人渲染**。`three` 仅用于粒子背景(`business-assistant-particle.ts`);
-  `src/three-libs/asr` 是**语音识别**;`src/three-libs/metamaker` 是未被引用的 SDK 包。
+  **`src/three-libs/` 下有且只有一个模块:`asr/`,是语音识别,且在用**
+  (PC 与移动端都 `import ASR from '@/three-libs/asr/index'`,点麦克风就走它)。
+  > 注:本文曾写「`src/three-libs/metamaker` 是未被引用的 SDK 包」——**那个目录不存在**,
+  > 2026-09-18 核查时已更正。目录名 `three-libs` 有误导性:它与 three.js 无关。
 - **没有状态管理库**(无 Vuex / Pinia)。对话状态在 `useBusinessAssistantChat` 组合式函数内,
   会话与消息持久化到 `localStorage`。
 - **没有 `src/hooks/` 目录**;也**没有** `stream-message-coordinator-v2.ts`。

+ 24 - 0
harness/progress.md

@@ -1943,3 +1943,27 @@
   - ⚠️ `VITE_XF_ASR` / 讯飞分支整条是死代码(`isXF` 恒 false),但**没删**(不在本轮范围)
 - **下一步最佳动作**:无(本轮为查证 + 改文档)
 
+## Session 047
+
+- **日期**:2026-09-18
+- **本轮目标**:用户认为「three-libs 是数字人,不需要,删掉」,并问语音识别该用厂商的还是独立
+- **⚠️ 先纠正了一个会误删的前提**:`three-libs` **不是数字人**
+  - 实测 `find src/three-libs -type f` → **只有 `asr/index.ts` 一个文件**
+  - 它**正在被使用**:`BusinessAssistantPC.vue:347` 与 `BusinessAssistantMobile.vue:405`
+    都 `import ASR from '@/three-libs/asr/index'` —— **点麦克风走的就是它**
+  - 若按原计划删除,**语音识别功能会直接消失**
+  - 顺带发现并更正了 `architecture.md` 的一句**失实描述**:「`src/three-libs/metamaker`
+    是未被引用的 SDK 包」——**该目录根本不存在**(同日核查)。已改为
+    「three-libs 下只有 asr,且在用;目录名与 three.js 无关,有误导性」
+  - 数字人相关的实际残留是**别的东西**:`VITE_STREAM_SERVER` / `VITE_STREAM_TOKEN` /
+    `VITE_HUMAN_IDLE_MP4_URL` 三个**无人读取的 env** + vite 的 `/stream/` 代理(target 硬编码)
+- **已完成**:更正 `architecture.md` 的失实描述(上)
+- **运行过的验证**:`find` 列出 three-libs 全部文件;grep 反查 import 方;`validate-harness` 通过
+- **已记录证据**:本文件 Session 047;`architecture.md` 的更正
+- **更新过的文件或工件**:`harness/docs/architecture.md`、本文件
+- **已知风险或未解决问题**:
+  - ⚠️ **待用户确认**:要删的到底是哪个?数字人那部分实际只剩三个没人读的 env + 一个 vite 代理,
+    删它们**不影响任何功能**;而 `three-libs/asr` **不能删**
+  - ⚠️ 语音识别「用厂商的还是独立」——本轮只给了建议,未动代码
+- **下一步最佳动作**:等用户确认删除范围;并给 ASR 的去留建议(见对话)
+