feat(aia): Complete AIA V2.0 with universal streaming capabilities

Major Changes:
- Add StreamingService with OpenAI Compatible format
- Upgrade Chat component V2 with Ant Design X integration
- Implement AIA module with 12 intelligent agents
- Update API routes to unified /api/v1 prefix
- Update system documentation

Backend (~1300 lines):
- common/streaming: OpenAI Compatible adapter
- modules/aia: 12 agents, conversation service, streaming integration
- Update route versions (RVW, PKB to v1)

Frontend (~3500 lines):
- modules/aia: AgentHub + ChatWorkspace (100% prototype restoration)
- shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook
- Update API endpoints to v1

Documentation:
- AIA module status guide
- Universal capabilities catalog
- System overview updates
- All module documentation sync

Tested: Stream response verified, authentication working
Status: AIA V2.0 core completed (85%)
This commit is contained in:
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions

View File

@@ -1,27 +1,27 @@
# AI涓村簥鐮旂┒骞冲彴 - 閮ㄧ讲鏂囨。浣跨敤鎸囧崡
> **鏂囨。鐗堟湰**锛歷1.0
> **创建日期**2025-12-25
> **用途**:帮助您快速找到需要的部署文档
> **鍒涘缓鏃ユ湡**锛?025-12-25
> **鐢ㄩ€?*锛氬府鍔╂偍蹇<E5818D>€熸壘鍒伴渶瑕佺殑閮ㄧ讲鏂囨。
---
## 🎯 快速导航
## 馃幆 蹇<>€熷<E282AC>鑸?
### 我应该看哪个文档?
### 鎴戝簲璇ョ湅鍝<EFBFBD>釜鏂囨。锛?
根据您的需求选择:
鏍规嵁鎮ㄧ殑闇€姹傞€夋嫨锛?
| 鍦烘櫙 | 鎺ㄨ崘鏂囨。 | 璇存槑 |
|------|---------|------|
| 🚀 **完整部署系统(推荐)** | [17-完整部署实战手册-2025版.md](./17-完整部署实战手册-2025版.md) | 基于实战经验,包含所有坑点和解决方案 |
| 📚 **学习部署原理** | [01-快速部署SOP-零基础版.md](./01-快速部署SOP-零基础版.md) | 零基础完整教程 |
| 馃殌 **瀹屾暣閮ㄧ讲绯荤粺锛堟帹鑽愶級** | [17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md](./17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md) | 鍩轰簬瀹炴垬缁忛獙锛屽寘鍚<EFBFBD>墍鏈夊潙鐐瑰拰瑙喅鏂规<EFBFBD> |
| 馃摎 **瀛︿範閮ㄧ讲鍘熺悊** | [01-<EFBFBD>€熼儴缃睸OP-闆跺熀纭€鐗?md](./01-蹇<>€熼儴缃睸OP-闆跺熀纭€鐗?md) | 闆跺熀纭€瀹屾暣鏁欑▼ |
| 馃攳 **鏌ヨ<E98F8C>璧勬簮淇℃伅** | [00-閮ㄧ讲杩涘害鎬昏<E98EAC>.md](./00-閮ㄧ讲杩涘害鎬昏<E98EAC>.md) | IP鍦板潃銆佸瘑鐮併€佺幆澧冨彉閲忕瓑 |
| 🐍 **只部署Python服务** | [09-Python微服务-SAE部署操作手册.md](./09-Python微服务-SAE部署操作手册.md) | Python微服务部署步骤 |
| 馃悕 **<EFBFBD>儴缃睵ython鏈嶅姟** | [09-Python<EFBFBD>湇鍔?SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md](./09-Python<EFBFBD>湇鍔?SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md) | Python<EFBFBD>湇鍔¢儴缃叉<EFBFBD>楠?|
| 馃煝 **鍙<>儴缃睳ode.js鍚庣<E98D9A>** | [12-Node.js鍚庣<E98D9A>-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md](./12-Node.js鍚庣<E98D9A>-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md) | Node.js鍚庣<E98D9A>閮ㄧ讲姝ラ<E5A79D> |
| 馃帹 **鍙<>儴缃插墠绔疦ginx** | [07-鍓嶇<E98D93>Nginx-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md](./07-鍓嶇<E98D93>Nginx-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md) | 鍓嶇<E98D93>Nginx閮ㄧ讲姝ラ<E5A79D> |
| 🗄️ **只部署数据库** | [08-PostgreSQL数据库部署操作手册.md](./08-PostgreSQL数据库部署操作手册.md) | PostgreSQL数据库部署 |
| **遇到问题排查** | [15-Node.js后端-部署成功总结.md](./15-Node.js后端-部署成功总结.md) | 常见问题及解决方案 |
| 馃梽锔?**鍙<>儴缃叉暟鎹<E69A9F>** | [08-PostgreSQL鏁版嵁搴撻儴缃叉搷浣滄墜鍐?md](./08-PostgreSQL鏁版嵁搴撻儴缃叉搷浣滄墜鍐?md) | PostgreSQL鏁版嵁搴撻儴缃?|
| 鉂?**閬囧埌闂<E59F8C><E99782>鎺掓煡** | [15-Node.js鍚庣<EFBFBD>-閮ㄧ讲鎴愬姛鎬荤粨.md](./15-Node.js鍚庣<EFBFBD>-閮ㄧ讲鎴愬姛鎬荤粨.md) | 甯歌<E794AF><EFBFBD><E99782>鍙婅В鍐虫柟妗?|
---
@@ -31,31 +31,31 @@
```
馃搨 05-閮ㄧ讲鏂囨。/
├── 📄 00-部署进度总览.md ⭐⭐⭐⭐⭐
│ └── 作用资源速查、IP地址、环境变量、文档索引
├── 📄 17-完整部署实战手册-2025版.md ⭐⭐⭐⭐⭐
│ └── 作用:完整部署流程、实战经验、问题解决
└── 📄 01-快速部署SOP-零基础版.md ⭐⭐⭐⭐
└── 作用:零基础教程、详细原理讲解
鈹溾攢鈹€ 馃搫 00-閮ㄧ讲杩涘害鎬昏<E98EAC>.md 猸愨瓙猸愨瓙猸?
鈹? 鈹斺攢鈹€ 浣滅敤锛氳祫婧愰€熸煡銆両P鍦板潃銆佺幆澧冨彉閲忋€佹枃妗储寮?
鈹?
鈹溾攢鈹€ 馃搫 17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md 猸愨瓙猸愨瓙猸?
鈹? 鈹斺攢鈹€ 浣滅敤锛氬畬鏁撮儴缃叉祦绋嬨€佸疄鎴樼粡楠屻€侀棶棰樿В鍐?
鈹?
鈹斺攢鈹€ 馃搫 01-蹇<>€熼儴缃睸OP-闆跺熀纭€鐗?md 猸愨瓙猸愨瓙
鈹斺攢鈹€ 浣滅敤锛氶浂鍩虹<E98DA9>鏁欑▼銆佽<E98A86>缁嗗師鐞嗚<E9909E>瑙?
```
### 服务部署手册(按需查看)
### 鏈嶅姟閮ㄧ讲鎵嬪唽锛堟寜闇€鏌ョ湅锛?
```
馃搨 鏈嶅姟閮ㄧ讲鎿嶄綔鎵嬪唽/
├── 📄 09-Python微服务-SAE部署操作手册.md ⭐⭐⭐
├── 📄 12-Node.js后端-SAE部署操作手册.md ⭐⭐⭐
├── 📄 07-前端Nginx-SAE部署操作手册.md ⭐⭐⭐
└── 📄 08-PostgreSQL数据库部署操作手册.md ⭐⭐⭐
鈹溾攢鈹€ 馃搫 09-Python<EFBFBD>湇鍔?SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md 猸愨瓙猸?
鈹溾攢鈹€ 馃搫 12-Node.js鍚庣<EFBFBD>-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md 猸愨瓙猸?
鈹溾攢鈹€ 馃搫 07-鍓嶇<EFBFBD>Nginx-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md 猸愨瓙猸?
鈹斺攢鈹€ 馃搫 08-PostgreSQL鏁版嵁搴撻儴缃叉搷浣滄墜鍐?md 猸愨瓙猸?
```
### 技术详解文档(深入理解)
### 鎶€鏈<EFBFBD><EFBFBD>枃妗紙娣卞叆鐞嗚В锛?
```
📂 技术详解/
├── 📄 04-Python微服务-SAE容器部署指南.md
馃搨 鎶€鏈<E282AC><E98F88>瑙?
鈹溾攢鈹€ 馃搫 04-Python<EFBFBD>湇鍔?SAE瀹瑰櫒閮ㄧ讲鎸囧崡.md
鈹溾攢鈹€ 馃搫 05-Node.js鍚庣<E98D9A>-SAE瀹瑰櫒閮ㄧ讲鎸囧崡.md
鈹溾攢鈹€ 馃搫 06-鍓嶇<E98D93>Nginx-SAE瀹瑰櫒閮ㄧ讲鎸囧崡.md
鈹斺攢鈹€ 馃搫 10-Node.js鍚庣<E98D9A>-Docker闀滃儚鏋勫缓鎵嬪唽.md
@@ -65,8 +65,8 @@
```
馃搨 閰嶇疆娓呭崟/
└── 📄 11-Node.js后端-SAE部署配置清单.md ⭐⭐⭐
└── 作用21个环境变量详细说明
鈹斺攢鈹€ 馃搫 11-Node.js鍚庣<EFBFBD>-SAE閮ㄧ讲閰嶇疆娓呭崟.md 猸愨瓙猸?
鈹斺攢鈹€ 浣滅敤锛?1涓<31>幆澧冨彉閲忚<E996B2>缁嗚<E7BC81>鏄?
```
### 闂<><E99782><EFBFBD><E6B787>璁板綍锛堟晠闅滄帓鏌ワ級
@@ -75,101 +75,101 @@
馃搨 闂<><E99782><EFBFBD><E6B787>/
鈹溾攢鈹€ 馃搫 13-Node.js鍚庣<E98D9A>-闀滃儚淇<E5849A><E6B787>璁板綍.md
鈹溾攢鈹€ 馃搫 14-Node.js鍚庣<E98D9A>-pino-pretty闂<79><E99782><EFBFBD><E6B787>.md
├── 📄 15-Node.js后端-部署成功总结.md ⭐⭐⭐
鈹溾攢鈹€ 馃搫 15-Node.js鍚庣<EFBFBD>-閮ㄧ讲鎴愬姛鎬荤粨.md 猸愨瓙猸?
鈹斺攢鈹€ 馃搫 16-鍓嶇<E98D93>Nginx-閮ㄧ讲鎴愬姛鎬荤粨.md
```
---
## 🚀 不同场景的推荐阅读路径
## 馃殌 涓嶅悓鍦烘櫙鐨勬帹鑽愰槄璇昏矾寰?
### 场景1首次完整部署新手
### 鍦烘櫙1锛氶<EFBFBD>娆″畬鏁撮儴缃诧紙鏂版墜锛?
**阅读顺序**
1. **先看**`17-完整部署实战手册-2025版.md`2小时
**闃呰<EFBFBD>椤哄簭**锛?
1. 鉁?**鍏堢湅**锛歚17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md`锛?灏忔椂锛?
- 浜嗚В瀹屾暣娴佺▼
- 鍑嗗<E98D91>鎵€闇€璧勬簮
- 按步骤执行
- 鎸夋<EFBFBD>楠ゆ墽琛?
2. **遇到问题时参考**
2. 鉁?**閬囧埌闂<E59F8C><E99782>鏃跺弬鑰?*锛?
- `15-Node.js鍚庣<E98D9A>-閮ㄧ讲鎴愬姛鎬荤粨.md`
- `00-閮ㄧ讲杩涘害鎬昏<E98EAC>.md`锛堟煡璇㈣祫婧愪俊鎭<EFBFBD>
3. **想深入了解时看**
- `01-快速部署SOP-零基础版.md`
3. 鉁?**鎯虫繁鍏ヤ簡瑙f椂鐪?*锛?
- `01-<EFBFBD>€熼儴缃睸OP-闆跺熀纭€鐗?md`
**预计时间**3.5 - 6小时
**棰勮<EFBFBD>鏃堕棿**锛?.5 - 6灏忔椂
---
### 场景2更新某个服务熟练用户
### 鍦烘櫙2锛氭洿鏂版煇涓<EFBFBD>湇鍔★紙鐔熺粌鐢ㄦ埛锛?
**渚嬪<E6B89A>锛氭洿鏂癗ode.js鍚庣<E98D9A>**
**操作流程**
1. ✅ 修改代码
2. ✅ 本地构建镜像:
**鎿嶄綔娴佺▼**锛?
1. 鉁?淇<>敼浠
2. 鉁?鏈<>湴鏋勫缓闀滃儚锛?
```bash
cd backend
npm run build
docker build -t backend-service:v1.4 .
```
3. ✅ 推送到ACR
3. 鉁?鎺ㄩ€佸埌ACR锛?
```bash
docker tag backend-service:v1.4 \
crpi-cd5ij4pjt65mweeo.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.4
docker push crpi-cd5ij4pjt65mweeo.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.4
```
4. ✅ 在SAE控制台
4. 鉁?鍦⊿AE鎺у埗鍙帮細
- 杩涘叆搴旂敤 `nodejs-backend-test`
- 点击【部署应用】
- 选择新版本 `v1.4`
- 鐐瑰嚮銆愰儴缃插簲鐢ㄣ€?
- 閫夋嫨鏂扮増鏈?`v1.4`
- 纭<><E7BAAD>閮ㄧ讲
**参考文档**
**鍙傝€冩枃妗?*锛?
- `12-Node.js鍚庣<E98D9A>-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md`锛堢<E9949B>3-4姝ワ級
- `00-部署进度总览.md`查ACR地址
- `00-閮ㄧ讲杩涘害鎬昏<EFBFBD>.md`锛堟煡ACR鍦板潃锛?
**预计时间**15-30分钟
**棰勮<EFBFBD>鏃堕棿**锛?5-30鍒嗛挓
---
### 场景3修改环境变量
### 鍦烘櫙3锛氫慨鏀圭幆澧冨彉閲?
**渚嬪<E6B89A>锛氫慨鏀筆ython鏈嶅姟鍦板潃**
**操作流程**
1. ✅ 登录SAE控制台
2. ✅ 进入应用(如 `nodejs-backend-test`
3. ✅ 点击【应用配置】→【环境变量】
4. ✅ 修改变量值
5. ✅ 点击【重启应用】(⚠️ 不是"部署应用"
**鎿嶄綔娴佺▼**锛?
1. 鉁?鐧诲綍SAE鎺у埗鍙?
2. 鉁?杩涘叆搴旂敤锛堝<E9949B> `nodejs-backend-test`锛?
3. 鉁?鐐瑰嚮銆愬簲鐢ㄩ厤缃<E58EA4>€戔啋銆愮幆澧冨彉閲忋€?
4. 鉁?淇<>敼鍙橀噺鍊?
5. 鉁?鐐瑰嚮銆愰噸鍚<E599B8>簲鐢ㄣ€戯紙鈿狅笍 涓嶆槸"閮ㄧ讲搴旂敤"锛侊級
**参考文档**
**鍙傝€冩枃妗?*锛?
- `11-Node.js鍚庣<E98D9A>-SAE閮ㄧ讲閰嶇疆娓呭崟.md`锛堢幆澧冨彉閲忚<E996B2>鏄庯級
- `17-完整部署实战手册-2025版.md`第9.2节:重启 vs 部署)
- `17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md`锛堢<EFBFBD>9.2鑺傦細閲嶅惎 vs 閮ㄧ讲锛?
**预计时间**5分钟
**棰勮<EFBFBD>鏃堕棿**锛?鍒嗛挓
---
### 场景4问题排查
### 鍦烘櫙4锛氶棶棰樻帓鏌?
**遇到问题时的查找顺序**
**閬囧埌闂<EFBFBD><EFBFBD>鏃剁殑鏌ユ壘椤哄簭**锛?
1. ✅ **先查**`17-完整部署实战手册-2025版.md` 第9节
1. 鉁?**鍏堟煡**锛歚17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md` 绗?鑺?
- 鍖呭惈瀹為檯閬囧埌鐨勬墍鏈夐棶棰樺強瑙喅鏂规<E98F82>
- 环境变量名错误
-<><E9909C>鍙橀噺鍚嶉敊璇?
- config鐩<67>綍缂哄け
- pino-pretty鎶ラ敊
- ES Module兼容性
- ES Module鍏煎<EFBFBD>鎬?
- bash璺<68>緞闂<E7B79E><E99782>
2. ✅ **再查**`15-Node.js后端-部署成功总结.md`
- 详细的问题修复历程
2. 鉁?**鍐嶆煡**锛歚15-Node.js鍚庣<E98D9A>-閮ㄧ讲鎴愬姛鎬荤粨.md`
- 璇︾粏鐨勯棶棰樹慨澶嶅巻绋?
3. ✅ **具体问题查**
- `13-Node.js后端-镜像修复记录.md`config问题
3. 鉁?**鍏蜂綋闂<E7B68B><E99782>鏌?*锛?
- `13-Node.js鍚庣<EFBFBD>-闀滃儚淇<E5849A><E6B787>璁板綍.md`锛坈onfig闂<EFBFBD><EFBFBD>锛?
- `14-Node.js鍚庣<E98D9A>-pino-pretty闂<79><E99782><EFBFBD><E6B787>.md`锛堟棩蹇楅棶棰橈級
---
@@ -193,105 +193,105 @@
## 鈿狅笍 閲嶈<E996B2>鎻愰啋
### 1. 环境变量名必须精确
### 1. <EFBFBD><EFBFBD>鍙橀噺鍚嶅繀椤荤簿纭?
**❌ 常见错误**
**鉂?甯歌<E794AF>閿欒<E996BF>**锛?
```bash
PYTHON_SERVICE_URL=http://172.17.173.66:8000
```
**✅ 正确配置**
**鉁?姝g‘閰嶇疆**锛?
```bash
EXTRACTION_SERVICE_URL=http://172.17.173.66:8000
```
**说明**:代码中使用的是 `EXTRACTION_SERVICE_URL`,不是 `PYTHON_SERVICE_URL`
**璇存槑**锛氫唬鐮佷腑浣跨敤鐨勬槸 `EXTRACTION_SERVICE_URL`锛屼笉鏄?`PYTHON_SERVICE_URL`锛?
---
### 2. 区分"重启应用"和"部署应用"
### 2. 鍖哄垎"閲嶅惎搴旂敤"鍜?閮ㄧ讲搴旂敤"
| 操作 | 用途 | IP是否变 | 何时使用 |
| 鎿嶄綔 | 鐢ㄩ€?| IP鏄<50>惁鍙?| 浣曟椂浣跨敤 |
|------|------|---------|---------|
| **重启应用** | 重启容器 | ❌ 不会 | 修改环境变量、调整配置 |
| **部署应用** | 更新镜像 | ✅ 会变 | 更新代码、更新镜像版本 |
| **閲嶅惎搴旂敤** | 閲嶅惎瀹瑰櫒 | 鉂?涓嶄細 | 淇<>敼鐜<E695BC><E9909C>鍙橀噺銆佽皟鏁撮厤缃?|
| **閮ㄧ讲搴旂敤** | 鏇存柊闀滃儚 | 鉁?浼氬彉 | 鏇存柊浠g爜銆佹洿鏂伴暅鍍忕増鏈?|
**教训**:只修改环境变量时,用"重启应用"避免IP变更
**鏁欒<EFBFBD>**锛氬彧淇<E5BDA7>敼鐜<E695BC><E9909C>鍙橀噺鏃讹紝鐢?閲嶅惎搴旂敤"锛岄伩鍏岻P鍙樻洿锛?
---
### 3. 瀵嗙爜涓<E7889C>殑@绗﹀彿瑕乁RL缂栫爜
**❌ 错误**
**鉂?閿欒<E996BF>**锛?
```bash
DATABASE_URL=postgresql://user:Xibahe@fengzhibo117@host:5432/db
```
**✅ 正确**
**鉁?姝g‘**锛?
```bash
DATABASE_URL=postgresql://user:Xibahe%40fengzhibo117@host:5432/db
```
**规则**`@` `%40`
**瑙勫垯**锛歚@` 鈫?`%40`
---
### 4. 浣跨敤VPC鍦板潃鎷夊彇闀滃儚锛堢渷閽憋級
**SAE拉取镜像时**
**SAE鎷夊彇闀滃儚鏃?*锛?
```bash
# ✅ 推荐VPC地址免流量费
# 鉁?鎺ㄨ崘锛圴PC鍦板潃锛屽厤娴侀噺璐癸級
crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.3
# ❌ 不推荐(公网地址,收流量费)
# 鉂?涓嶆帹鑽愶紙鍏<E7B499>綉鍦板潃锛屾敹娴侀噺璐癸級
crpi-cd5ij4pjt65mweeo.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.3
```
---
## 💡 最佳实践建议
## 馃挕 鏈€浣冲疄璺靛缓璁?
### 1. 部署前必做
### 1. 閮ㄧ讲鍓嶅繀鍋?
- [ ] 阅读 `17-完整部署实战手册-2025版.md`
- [ ] 准备好环境变量清单
- [ ] 闃呰<EFBFBD> `17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md`
- [ ] 鍑嗗<EFBFBD>濂界幆澧冨彉閲忔竻鍗?
- [ ] 鏈<>湴娴嬭瘯Docker闀滃儚
- [ ] 备份数据库
- [ ] 记录当前版本号
- [ ] 澶囦唤鏁版嵁搴?
- [ ] 璁板綍褰撳墠鐗堟湰鍙?
### 2. 部署中注意
### 2. 閮ㄧ讲涓<EFBFBD>敞鎰?
- [ ] 鎸夐『搴忛儴缃诧紙鏁版嵁搴撯啋Python鈫扤ode.js鈫掑墠绔<E5A2A0>
- [ ] 每个服务部署后验证健康检查
- [ ] 姣忎釜鏈嶅姟閮ㄧ讲鍚庨獙璇佸仴搴锋<EFBFBD>鏌?
- [ ] 璁板綍鍐呯綉IP鍦板潃
- [ ] 鎴<>浘閲嶈<E996B2>閰嶇疆
### 3. 部署后验证
### 3. 閮ㄧ讲鍚庨獙璇?
- [ ] 鍋ュ悍妫€鏌ラ€氳繃
- [ ] 鍓嶇<E98D93><EFBFBD>互璁块棶
- [ ] API璇锋眰姝
- [ ] 工具C的7大功能测试
- [ ] 宸ュ叿C鐨?澶у姛鑳芥祴璇?
- [ ] 鏂囩尞绛涙煡鍔熻兘娴嬭瘯
- [ ] 响应时间 < 1
- [ ] 鍝嶅簲鏃堕棿 < 1绉?
---
## 馃攧 鏂囨。鏇存柊璇存槑
### 最新更新(2025-12-25
### 鏈€鏂版洿鏂帮紙2025-12-25锛?
1. ✅ 新增:`17-完整部署实战手册-2025版.md`
1. 鉁?鏂板<E98F82>锛歚17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md`
- 鍩轰簬瀹為檯閮ㄧ讲缁忓巻缂栧啓
- 鍖呭惈鎵€鏈夊潙鐐瑰拰瑙喅鏂规<E98F82>
- 瀹屾暣鐨勯儴缃叉祦绋嬪拰楠岃瘉姝ラ<E5A79D>
2. ✅ 更新:`00-部署进度总览.md`
2. 鉁?鏇存柊锛歚00-閮ㄧ讲杩涘害鎬昏<E98EAC>.md`
- 娣诲姞瀹炴垬鎵嬪唽寮曠敤
- 鏇存柊鍐呯綉IP鍦板潃
- 娣诲姞鍏<E5A79E>綉璁块棶鍦板潃
3. ✅ 新增:`18-部署文档使用指南.md`(本文档)
3. 鉁?鏂板<E98F82>锛歚18-閮ㄧ讲鏂囨。浣跨敤鎸囧崡.md`锛堟湰鏂囨。锛?
-<>姪蹇<E5A7AA>€熸壘鍒伴渶瑕佺殑鏂囨。
### 鍘嗗彶鐗堟湰
@@ -306,43 +306,44 @@ crpi-cd5ij4pjt65mweeo.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-se
### 甯歌<E794AF><EFBFBD><E99782>
**Q1锛氭垜鏄<E59E9C>柊鎵嬶紝浠庡摢閲屽紑濮嬶紵**
- A直接看 `17-完整部署实战手册-2025版.md`,跟着做就行!
- A锛氱洿鎺ョ湅 `17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md`锛岃窡鐫€鍋氬氨琛岋紒
**Q2锛氭垜鍙<E59E9C>兂鏇存柊浠爜锛屼笉鎯冲叏閮ㄩ噸鏂伴儴缃诧紵**
- A看你要更新的服务对应的操作手册如 `12-Node.js后端-SAE部署操作手册.md`
- A锛氱湅浣犺<E6B5A3>鏇存柊鐨勬湇鍔″<E98D94>搴旂殑鎿嶄綔鎵嬪唽锛堝<E9949B> `12-Node.js鍚庣<EFBFBD>-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md`锛?
**Q3锛氶亣鍒版姤閿欎簡鎬庝箞鍔烇紵**
- A先看 `17-完整部署实战手册-2025版.md` 第9节99%的问题都在里面
- A锛氬厛鐪?`17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md` 绗?鑺傦紝99%鐨勯棶棰橀兘鍦ㄩ噷闈?
**Q4锛氬繕璁板瘑鐮佹垨IP鍦板潃浜嗭紵**
- A查 `00-部署进度总览.md`,所有资源信息都在那里
- A锛氭煡 `00-閮ㄧ讲杩涘害鎬昏<E98EAC>.md`锛屾墍鏈夎祫婧愪俊鎭<EFBFBD>兘鍦ㄩ偅閲?
**Q5锛氭兂娣卞叆鐞嗚В鎶€鏈<E282AC>師鐞嗭紵**
- A看对应的技术详解文档如 `05-Node.js后端-SAE容器部署指南.md`
- A锛氱湅瀵瑰簲鐨勬妧鏈<E5A6A7><E98F88>枃妗紙濡?`05-Node.js鍚庣<EFBFBD>-SAE瀹瑰櫒閮ㄧ讲鎸囧崡.md`锛?
---
## 馃幆 鎬荤粨
### 记住这3个核心文档
### 璁颁綇杩?涓<>牳蹇冩枃妗?
1. **`17-完整部署实战手册-2025版.md`** - 部署必看
1. **`17-瀹屾暣閮ㄧ讲瀹炴垬鎵嬪唽-2025鐗?md`** - 閮ㄧ讲蹇呯湅
2. **`00-閮ㄧ讲杩涘害鎬昏<E98EAC>.md`** - 淇℃伅閫熸煡
3. **`本文档`** - 找不到文档时看这里
3. **`鏈<>枃妗<E69E83>** - 鎵句笉鍒版枃妗f椂鐪嬭繖閲?
### 部署成功的关键
### 閮ㄧ讲鎴愬姛鐨勫叧閿?
- ✅ 环境变量名必须精确
- ✅ 区分"重启"和"部署"
- ✅ 按顺序部署服务
- ✅ 每步都要验证
- ✅ 遇到问题先查文档
- 鉁?鐜<><E9909C>鍙橀噺鍚嶅繀椤荤簿纭?
- 鉁?鍖哄垎"閲嶅惎"鍜?閮ㄧ讲"
- 鉁?鎸夐『搴忛儴缃叉湇鍔?
- 鉁?姣忔<E5A7A3>閮借<E996AE>楠岃瘉
- 鉁?閬囧埌闂<E59F8C><E99782>鍏堟煡鏂囨。
---
> **鏂囨。缁存姢**锛氳<E9949B>鍦ㄦ瘡娆¢儴缃插悗鏇存柊鐩稿叧鏂囨。
> **最后更新**2025-12-25
> **维护人员**:开发团队
> **鏈€鍚庢洿鏂?*锛?025-12-25
> **缁存姢浜哄憳**锛氬紑鍙戝洟闃?