Kaynağa Gözat

revert(env): 回退与 /data/dms/dms_upload/yszs 有关的改动

用户指示「不改了,修改都回退」(已问清范围:只针对这个路径,不是今天全部改动)。

- 四份 .env.*:删掉 VITE_CHAT_SESSION_JSON_DIR 变量及其 6 行注释块
- docs/architecture.md:删掉该变量的表格行
- docs/reference/DMS_API.md:删掉 §8「浏览服务器文件目录」(为查这个路径而写)
- 根 README.md:删掉该变量的记录

有意保留 VITE_CHAT_TARGET(聊天后端真实地址)——与 yszs 路径无关,
是「把硬编码在 vite.config.ts 里的后端地址收进 env」的独立改进。

过程小插曲(已修正):第一版回退脚本顺带把四份 env 转成了 CRLF、
并误删了 .env.development 的 3 个空行,导致 diff 里整份文件都在变动。
已逐项还原,最终四份 env **各只删 7 行**,diff 只剩该删的内容。

验证:残留检查无 dms_upload / VITE_CHAT_SESSION_JSON_DIR 引用;
npm run build 通过;validate-harness 通过。

Co-Authored-By: Claude Code <noreply@anthropic.com>
gongtianxiao 3 gün önce
ebeveyn
işleme
59b93059db

+ 0 - 7
.env.development

@@ -41,13 +41,6 @@ VITE_CHAT_API="/chat-api"
 # 聊天后端真实地址。dev 走同源代理(VITE_CHAT_API 是代理前缀,见 vite.config.ts),
 # 代理的 target 从**这个变量**读,不再硬编码在 vite.config.ts 里
 VITE_CHAT_TARGET="http://192.168.2.23:8000"
-# DMS 服务器上「营商助手」专用的文件目录(绝对路径)。
-# ⚠️ 实测(2026-09-17):**它不是 URL** —— 两台机器上按 URL 访问全部 404
-#    (192.168.2.23:8000 不提供任何静态文件;121.43.55.7:10081 返回 Tomcat 404)。
-#    能取到数据的途径是 DMS 接口 POST /dms/file/getFiles(参数 path),
-#    且 path 是**相对 Tomcat 工作目录**的,要写成 ../../../../data/dms/dms_upload/yszs
-# ⚠️ 该目录**目前为空**(同级 photo 有 7027 项、file 6324 项、video 3 项,yszs 无内容)
-VITE_CHAT_SESSION_JSON_DIR="/data/dms/dms_upload/yszs"
 
 # DMS 数据管理服务(会话/问答记录/反馈的落地库)
 # 走 vite 同源代理:HTTPS 页面直连 http:// 的 DMS 会被浏览器按混合内容拦截,

+ 0 - 7
.env.production

@@ -15,10 +15,3 @@ VITE_USE_KNOWLEDGE_API=true
 # 生产部署时请改为实际后端地址(当前为内网测试地址)
 VITE_CHAT_API="http://192.168.2.23:8000"
 
-# DMS 服务器上「营商助手」专用的文件目录(绝对路径)。
-# ⚠️ 实测(2026-09-17):**它不是 URL** —— 两台机器上按 URL 访问全部 404
-#    (192.168.2.23:8000 不提供任何静态文件;121.43.55.7:10081 返回 Tomcat 404)。
-#    能取到数据的途径是 DMS 接口 POST /dms/file/getFiles(参数 path),
-#    且 path 是**相对 Tomcat 工作目录**的,要写成 ../../../../data/dms/dms_upload/yszs
-# ⚠️ 该目录**目前为空**(同级 photo 有 7027 项、file 6324 项、video 3 项,yszs 无内容)
-VITE_CHAT_SESSION_JSON_DIR="/data/dms/dms_upload/yszs"

+ 0 - 7
.env.qingpu

@@ -15,11 +15,4 @@ VITE_USE_KNOWLEDGE_API=true
 VITE_ASSISTANT_STATISTICS_BASE_URL=https://qingpu-data-api.metamaker.cn/
 VITE_CHAT_API="http://192.168.2.23:8000"
 
-# DMS 服务器上「营商助手」专用的文件目录(绝对路径)。
-# ⚠️ 实测(2026-09-17):**它不是 URL** —— 两台机器上按 URL 访问全部 404
-#    (192.168.2.23:8000 不提供任何静态文件;121.43.55.7:10081 返回 Tomcat 404)。
-#    能取到数据的途径是 DMS 接口 POST /dms/file/getFiles(参数 path),
-#    且 path 是**相对 Tomcat 工作目录**的,要写成 ../../../../data/dms/dms_upload/yszs
-# ⚠️ 该目录**目前为空**(同级 photo 有 7027 项、file 6324 项、video 3 项,yszs 无内容)
-VITE_CHAT_SESSION_JSON_DIR="/data/dms/dms_upload/yszs"
 VITE_REDIRECT_MAP={"demo":"https://demo.heijingai.com/FTA-c2p/%23/overview","zhaoshang":"https://demo.heijingai.com/policy-application/%23/"}

+ 0 - 7
.env.test

@@ -12,10 +12,3 @@ VITE_POLICY_LOCAL_FIRST="false"
 # 新版聊天协议后端(POST /api/chat,SSE),直连模式
 VITE_CHAT_API="http://192.168.2.23:8000"
 
-# DMS 服务器上「营商助手」专用的文件目录(绝对路径)。
-# ⚠️ 实测(2026-09-17):**它不是 URL** —— 两台机器上按 URL 访问全部 404
-#    (192.168.2.23:8000 不提供任何静态文件;121.43.55.7:10081 返回 Tomcat 404)。
-#    能取到数据的途径是 DMS 接口 POST /dms/file/getFiles(参数 path),
-#    且 path 是**相对 Tomcat 工作目录**的,要写成 ../../../../data/dms/dms_upload/yszs
-# ⚠️ 该目录**目前为空**(同级 photo 有 7027 项、file 6324 项、video 3 项,yszs 无内容)
-VITE_CHAT_SESSION_JSON_DIR="/data/dms/dms_upload/yszs"

+ 0 - 3
README.md

@@ -172,6 +172,3 @@
 - 环境变量整理:**地址类配置收进 env,不再写死在代码里**
   - 新增 `VITE_CHAT_TARGET`(聊天后端真实地址)——此前它硬编码在 `vite.config.ts` 的
     代理配置里;现由 `vite.config.ts` 从 env 读取(保留同值兜底)
-  - 新增 `VITE_CHAT_SESSION_JSON_DIR`(后端存放会话信息 JSON 的目录,
-    `/data/dms/dms_upload/yszs`,挂在聊天后端地址之后)。**目前仅作约定记录,
-    前端尚无消费方**,将来对接时从这里取

+ 0 - 1
harness/docs/architecture.md

@@ -108,7 +108,6 @@ src/
 | `VITE_API` | 主业务 API 网关 |
 | `VITE_CHAT_API` | 对话接口。服务前缀(`/chat-api`、`http://host:8000`)会自动追加 `/api/chat`;已是完整地址则原样使用 |
 | `VITE_CHAT_TARGET` | **聊天后端真实地址**(仅 dev 用)。`VITE_CHAT_API` 在开发环境是代理前缀 `/chat-api`,代理的 target 从本变量读(见 `vite.config.ts`),**不再硬编码在配置文件里** |
-| `VITE_CHAT_SESSION_JSON_DIR` | **DMS 服务器上**「营商助手」专用文件目录 `/data/dms/dms_upload/yszs`。⚠️ 实测(2026-09-17):**它不是 URL**(两台机器按 URL 访问全 404),前端拼不出地址;读取只能走 DMS 的 `POST /dms/file/getFiles`(相对 Tomcat 工作目录的路径,见 `reference/DMS_API.md` §8)。该目录**目前为空**。前端**尚无消费方** |
 | `VITE_DMS_API` / `VITE_DMS_TARGET` | DMS 数据服务(会话/问答记录/反馈落地)。dev 走 `/dms-api` 代理、token 由代理注入,见 `vite.config.ts` |
 | `VITE_MODEL_SERVER` | 模型服务 |
 | `VITE_ASR` / `VITE_STREAM_SERVER` | 语音识别 / 流媒体 |

+ 0 - 59
harness/docs/reference/DMS_API.md

@@ -477,62 +477,3 @@ curl -s -X POST "http://${DMS_HOST}/dms/content/selectContentList" \
 | [`apifox-dms.md`](F:/yysk/AI_zhaoshang/DMS_Data_Migration/2.%20DMS-Manage/cursor-skill-dms/apifox-dms.md) | Apifox 干净版 |
 | [`DMS_MAPPING.md`](DMS_MAPPING.md) | 本项目表→栏目映射 + 踩坑记录 |
 | [`RUNBOOK.md`](F:/yysk/AI_zhaoshang/DMS_Data_Migration/harness/docs/RUNBOOK.md) | 操作手册 |
-
----
-
-## 8. 浏览服务器文件目录:`POST /file/getFiles` ✅
-
-**用途**:列服务器上某个目录的内容。查「后端把文件存哪了」时用它 ——
-**这些路径不是 URL,用浏览器/curl 直接访问一律 404**(实测)。
-
-### 8.1 参数只有一个:`path`(form body)
-
-```bash
-curl -s -X POST "http://121.43.55.7:10081/dms/file/getFiles"   -H "token: ${DMS_TOKEN}"   --data-urlencode "path=../../../../data/dms/dms_upload/yszs"
-```
-
-> ⚠️ **`path` 是相对 DMS 进程工作目录(Tomcat 的 bin)的**,不是文件系统绝对路径。
-> 传绝对路径(`/data/...`)不会报错,但会返回「当前文件不是文件夹,无子文件」——
-> 因为那是相对拼接后并不存在的路径。**这是最容易踩的一点。**
-
-### 8.2 相对路径换算(实测)
-
-| 想要的位置 | 写成 |
-|---|---|
-| Tomcat bin(工作目录) | `.` |
-| Tomcat 根(有 `webapps*`、`conf`、`logs`、`uploads`…) | `..` |
-| `/usr/local` | `../..` |
-| `/`(根) | `../../../..` |
-| `/data` | `../../../../data` |
-| **`/data/dms/dms_upload`** | `../../../../data/dms/dms_upload` |
-| `/data/dms/dms_upload/yszs` | `../../../../data/dms/dms_upload/yszs` |
-
-### 8.3 返回形态
-
-```json
-{"code":200,"message":"成功!","content":["../webapps_dms","../logs", ...]}
-```
-
-| 情况 | 返回 |
-|---|---|
-| 目录**有**内容 | `content` 是数组,元素是「带前缀的相对路径」 |
-| 目录**为空** | **没有 `content` 字段**(只有 `code`/`message`)—— 别把「字段缺失」当成出错 |
-| 传的是**文件**路径 | `content: ["当前文件不是文件夹,无子文件"]`(说明它只能列目录,**读不了文件内容**) |
-| 参数名写错(`dir`/`directory`/`filePath`…) | HTTP 500 |
-
-### 8.4 实测到的目录布局(2026-09-17)
-
-```
-/data/dms/
-├── dms_upload/          ← DMS 上传根目录
-│   ├── photo/    7027 项
-│   ├── file/     6324 项
-│   ├── video/       3 项
-│   ├── other/       1 项
-│   ├── yszs/        **空**(营商助手专用,新建未写入)
-│   └── *.json    7 个 uuid 命名的 json
-└── down_files/
-```
-
-> 📌 结论:`/data/dms/dms_upload/yszs` 是**DMS 服务器上的真实目录**,
-> 目前**没有数据**;它既不是 URL,也不能通过 `getFiles` 读文件内容(只能列目录)。

+ 28 - 0
harness/progress.md

@@ -28,6 +28,34 @@
 
 ## 会话记录
 
+## Session 034
+
+- **日期**:2026-09-17
+- **本轮目标**:用户指示「不改了,修改都回退」——**回退与 `/data/dms/dms_upload/yszs` 有关的改动**
+  (问清过范围:只针对这个路径,不是今天全部改动)
+- **已完成(回退清单)**:
+  - 四份 `.env.*`:删掉 `VITE_CHAT_SESSION_JSON_DIR` 变量及其 6 行注释块
+  - `docs/architecture.md`:删掉该变量的表格行
+  - `docs/reference/DMS_API.md`:删掉 **§8「浏览服务器文件目录」**(它是为查这个路径写的)
+  - 根 `README.md`:删掉该变量的那条记录
+- **有意保留**:`VITE_CHAT_TARGET`(聊天后端真实地址)——它与 yszs 路径无关,
+  是「把硬编码在 vite.config.ts 里的后端地址收进 env」的独立改进。若也要一并回退,说一声即可
+- **运行过的验证**:
+  - 残留检查:`.env.*`、`architecture.md`、`DMS_API.md` 里已无 `dms_upload` /
+    `VITE_CHAT_SESSION_JSON_DIR` 的任何引用
+  - `npm run build` 通过;`node harness/tools/validate-harness.mjs` 通过
+- **已记录证据**:本文件 Session 034;回退后的 git 提交
+- **更新过的文件或工件**:`.env.development`、`.env.production`、`.env.qingpu`、`.env.test`、
+  `harness/docs/architecture.md`、`harness/docs/reference/DMS_API.md`、根 `README.md`、本文件
+- **已知风险或未解决问题**:
+  - ⚠️ 回退掉的东西**仍在 git 历史里**(提交 `0caf1ae`、`7ce6ed3`)——
+    包括那次探测得到的「DMS 有 `POST /file/getFiles`、`path` 是相对 Tomcat 工作目录的路径」
+    这条**通用**知识(不止对 yszs 有用)。如果哪天要浏览 DMS 服务器上的文件,
+    可以 `git show 7ce6ed3` 取回,或让我把不含 yszs 的部分重新写进参考文档
+  - ⚠️ 该路径本身**未做任何改动**,前几轮查到的结论(不是 URL、目录为空)仍然成立,
+    只是不再落在仓库文件里
+- **下一步最佳动作**:无(本轮为回退);功能清单里仍无 `in_progress`,可做的事见 Session 031 列的优先级
+
 ## Session 033
 
 - **日期**:2026-09-17