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,35 +1,31 @@
# 馃摎 澹硅瘉寰狝I绉戠爺骞冲彴 - 鏂囨。涓<E38082>
> **文档版本:** v3.0
> **鏂囨。鐗堟湰锛?* v3.0
> **鏈€鍚庢洿鏂帮細** 2025-11-06
> **文档体系:** 三层架构 + 金字塔式快速上下文
> **鏂囨。浣撶郴锛?* 涓夊眰鏋舵瀯 + 閲戝瓧濉斿紡蹇<E7B4A1>€熶笂涓嬫枃
---
## 🚀 快速开始
### 我是新AI实例第一次对话
**必读:** [00-系统总体设计/[AI对接] 快速上下文](./00-系统总体设计/[AI对接]%20快速上下文.md)
**阅读时间:** 2分钟 | **Token消耗** ~800 tokens
**价值:** 快速了解项目全貌、8个业务模块、技术栈、当前进度
## 馃殌 蹇<>€熷紑濮?
### 鎴戞槸鏂癆I瀹炰緥锛岀<E9949B>涓€娆″<E5A886>璇?**蹇呰<E8B987>锛?* [00-绯荤粺鎬讳綋璁捐<E79281>/[AI瀵规帴] 蹇<>€熶笂涓嬫枃](./00-绯荤粺鎬讳綋璁捐<E79281>/[AI瀵规帴]%20蹇<30>€熶笂涓嬫枃.md)
**闃呰<E99783>鏃堕棿锛?* 2鍒嗛挓 | **Token娑堣€楋細** ~800 tokens
**浠峰€硷細**<>€熶簡瑙」鐩<E3808D>叏璨屻€?涓<>笟鍔℃ā鍧椼€佹妧鏈<E5A6A7>爤銆佸綋鍓嶈繘搴?
---
### 我要开发具体模块
| 模块 | 快速上下文 | 阅读时间 | Token消耗 |
### 鎴戣<EFBFBD>寮€鍙戝叿浣撴ā鍧?| 妯″潡 | 蹇<>€熶笂涓嬫枃 | 闃呰<E99783>鏃堕棿 | Token娑堣€?|
|------|-----------|---------|---------|
| **ASL-AI智能文献** P0 | [ASL快速上下文](./03-业务模块/ASL-AI智能文献/[AI对接]%20ASL快速上下文.md) | 5分钟 | ~2000 |
| **LLM网关** P0 | [LLM网关快速上下文](./02-通用能力层/01-LLM大模型网关/[AI对接]%20LLM网关快速上下文.md) | 5分钟 | ~2000 |
| **ADMIN运营管理端** P1 | [ADMIN快速上下文](./03-业务模块/ADMIN-运营管理端/[AI对接]%20ADMIN快速上下文.md) | 5分钟 | ~2000 |
| **ASL-AI鏅鸿兘鏂囩尞** 猸?P0 | [ASL<EFBFBD>€熶笂涓嬫枃](./03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/[AI瀵规帴]%20ASL<EFBFBD>€熶笂涓嬫枃.md) | 5鍒嗛挓 | ~2000 |
| **LLM缃戝叧** 猸?P0 | [LLM缃戝叧蹇<EFBFBD>€熶笂涓嬫枃](./02-閫氱敤鑳藉姏灞?01-LLM澶фā鍨嬬綉鍏?[AI瀵规帴]%20LLM缃戝叧蹇<E58FA7>€熶笂涓嬫枃.md) | 5鍒嗛挓 | ~2000 |
| **ADMIN杩愯惀绠$悊绔?* P1 | [ADMIN<EFBFBD>€熶笂涓嬫枃](./03-涓氬姟妯″潡/ADMIN-杩愯惀绠$悊绔?[AI瀵规帴]%20ADMIN<EFBFBD>€熶笂涓嬫枃.md) | 5鍒嗛挓 | ~2000 |
---
### 鎴戣<E98EB4>浜嗚В鏁翠綋鏋舵瀯
| 鏂囨。 | 璇存槑 |
|------|------|
| [系统架构分层设计](./00-系统总体设计/01-系统架构分层设计.md) | 三层架构、8个业务模块 |
| [架构设计全景图](./00-系统总体设计/08-架构设计全景图.md) | 可视化架构图 |
| [数据库架构说明](./00-系统总体设计/03-数据库架构说明.md) | PostgreSQL + Schema隔离 |
| [绯荤粺鏋舵瀯鍒嗗眰璁捐<EFBFBD>](./00-绯荤粺鎬讳綋璁捐<E79281>/01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>.md) | 涓夊眰鏋舵瀯銆?涓<>笟鍔℃ā鍧?|
| [鏋舵瀯璁捐<EFBFBD>鍏ㄦ櫙鍥綸(./00-绯荤粺鎬讳綋璁捐<E79281>/08-鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥?md) | <EFBFBD><EFBFBD>鍖栨灦鏋勫浘 |
| [鏁版嵁搴撴灦鏋勮<EFBFBD>鏄嶿(./00-绯荤粺鎬讳綋璁捐<E79281>/03-鏁版嵁搴撴灦鏋勮<E98F8B>鏄?md) | PostgreSQL + Schema闅旂<EFBFBD> |
---
@@ -37,224 +33,167 @@
```
docs/
├── 📖 00-系统总体设计/ # 总体架构、技术决策
│ ├── [AI对接] 快速上下文.md ⭐ L0总览必读
│ ├── 01-系统架构分层设计.md
│ ├── 02-文档体系重构方案.md
│ ├── 03-数据库架构说明.md
│ ├── 08-架构设计全景图.md
│ └── README.md
├── 📖 01-平台基础层/ # 平台基础设施5个模块
│ ├── [AI对接] 平台层快速上下文.md ⭐ L1层级
│ ├── 01-用户与权限中心(UAM)/
│ ├── 02-存储服务/
│ ├── 03-通知服务/
│ ├── 04-监控与日志/
│ ├── 05-系统配置/
│ └── README.md
├── 📖 02-通用能力层/ # 跨模块共享能力5个能力
│ ├── [AI对接] 通用能力快速上下文.md ⭐ L1层级
│ ├── 01-LLM大模型网关/ ⭐ P0优先级
│ │ ├── [AI对接] LLM网关快速上下文.md ⭐ L2模块级
│ │ └── README.md
│ ├── 02-文档处理引擎/
│ ├── 03-RAG引擎/
│ ├── 04-数据ETL引擎/
│ ├── 05-医学NLP引擎/
│ └── README.md
├── 📖 03-业务模块/ # 业务功能模块8个模块
│ ├── [AI对接] 业务模块快速上下文.md ⭐ L1层级
│ ├── ASL-AI智能文献/ ⭐ P0优先级
│ │ ├── [AI对接] ASL快速上下文.md ⭐ L2模块级
│ │ └── README.md
│ ├── ADMIN-运营管理端/ ⭐ P1优先级
│ │ ├── [AI对接] ADMIN快速上下文.md ⭐ L2模块级
│ │ └── README.md
│ ├── AIA-AI智能问答/ ✅ 已完成
│ ├── PKB-个人知识库/ ✅ 已完成
│ ├── RVW-稿件审查系统/ ✅ 已完成
│ ├── DC-数据清洗整理/
│ ├── SSA-智能统计分析/
│ ├── ST-统计分析工具/
│ └── README.md
├── 📖 04-开发规范/ # 编码规范、API规范
│ ├── 01-数据库设计规范.md
│ ├── 02-API设计规范.md
│ ├── 03-代码规范.md
│ ├── 04-Git提交规范.md
│ └── README.md
├── 📖 05-部署文档/ # 4种部署模式
├── 01-云端SaaS部署/
│ ├── 02-独立产品包部署/
│ ├── 03-Electron单机版/
│ ├── 04-私有化部署/
│ └── README.md
├── 📖 06-测试文档/ # 测试计划、测试用例
│ └── README.md
├── 📖 07-运维文档/ # 运维手册、故障排查
│ └── README.md
├── 📖 08-项目管理/ # 开发计划、每日进度
│ ├── 01-整体开发计划/
│ ├── 02-里程碑规划/
│ └── 03-每日进度/
├── 📖 09-架构实施/ # 架构演进、重构计划
│ └── README.md
├── 📖 _templates/ # 文档模板
│ ├── [AI对接] 快速上下文-模板.md
│ ├── 模块README-模板.md
│ └── README.md
└── 📖 00-项目概述/ # 历史文档(待整理)
├── 现有系统技术摸底报告.md
├── 壹证循科技 AI科研产品需求文档.md
鈹溾攢鈹€ 馃摉 00-绯荤粺鎬讳綋璁捐<E79281>/ # 鎬讳綋鏋舵瀯銆佹妧鏈<E5A6A7>喅绛?鈹? 鈹溾攢鈹€ [AI瀵规帴] 蹇<>€熶笂涓嬫枃.md 猸?L0鎬昏<E98EAC>锛堝繀璇伙級
鈹? 鈹溾攢鈹€ 01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>.md
鈹? 鈹溾攢鈹€ 02-鏂囨。浣撶郴閲嶆瀯鏂规<E98F82>.md
鈹? 鈹溾攢鈹€ 03-鏁版嵁搴撴灦鏋勮<E98F8B>鏄?md
鈹? 鈹溾攢鈹€ 08-鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥?md
鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 01-骞冲彴鍩虹<E98DA9>灞? # 骞冲彴鍩虹<E98DA9>璁炬柦锛?涓<>ā鍧楋級
鈹? 鈹溾攢鈹€ [AI瀵规帴] 骞冲彴灞傚揩閫熶笂涓嬫枃.md 猸?L1灞傜骇
鈹? 鈹溾攢鈹€ 01-鐢ㄦ埛涓庢潈闄愪腑蹇?UAM)/
鈹? 鈹溾攢鈹€ 02-瀛樺偍鏈嶅姟/
鈹? 鈹溾攢鈹€ 03-閫氱煡鏈嶅姟/
鈹? 鈹溾攢鈹€ 04-鐩戞帶涓庢棩蹇?
鈹? 鈹溾攢鈹€ 05-绯荤粺閰嶇疆/
鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 02-閫氱敤鑳藉姏灞? # 璺ㄦā鍧楀叡浜<E58FA1>兘鍔涳紙5涓<35>兘鍔涳級
鈹? 鈹溾攢鈹€ [AI瀵规帴] 閫氱敤鑳藉姏蹇<E5A78F>€熶笂涓嬫枃.md 猸?L1灞傜骇
鈹? 鈹溾攢鈹€ 01-LLM澶фā鍨嬬綉鍏? 猸?P0浼樺厛绾?鈹? 鈹? 鈹溾攢鈹€ [AI瀵规帴] LLM缃戝叧蹇<E58FA7>€熶笂涓嬫枃.md 猸?L2妯″潡绾?鈹? 鈹? 鈹斺攢鈹€ README.md
鈹? 鈹溾攢鈹€ 02-鏂囨。澶勭悊寮曟搸/
鈹? 鈹溾攢鈹€ 03-RAG寮曟搸/
鈹? 鈹溾攢鈹€ 04-鏁版嵁ETL寮曟搸/
鈹? 鈹溾攢鈹€ 05-鍖诲<E98D96>NLP寮曟搸/
鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 03-涓氬姟妯″潡/ # 涓氬姟鍔熻兘妯″潡锛?涓<>ā鍧楋級
鈹? 鈹溾攢鈹€ [AI瀵规帴] 涓氬姟妯″潡蹇<E6BDA1>€熶笂涓嬫枃.md 猸?L1灞傜骇
鈹? 鈹溾攢鈹€ ASL-AI鏅鸿兘鏂囩尞/ 猸?P0浼樺厛绾?鈹? 鈹? 鈹溾攢鈹€ [AI瀵规帴] ASL蹇<4C>€熶笂涓嬫枃.md 猸?L2妯″潡绾?鈹? 鈹? 鈹斺攢鈹€ README.md
鈹? 鈹溾攢鈹€ ADMIN-杩愯惀绠$悊绔? 猸?P1浼樺厛绾?鈹? 鈹? 鈹溾攢鈹€ [AI瀵规帴] ADMIN蹇<4E>€熶笂涓嬫枃.md 猸?L2妯″潡绾?鈹? 鈹? 鈹斺攢鈹€ README.md
鈹? 鈹溾攢鈹€ AIA-AI鏅鸿兘闂<E58598>瓟/ 鉁?宸插畬鎴?鈹? 鈹溾攢鈹€ PKB-涓<>汉鐭ヨ瘑搴? 鉁?宸插畬鎴?鈹? 鈹溾攢鈹€ RVW-绋夸欢瀹℃煡绯荤粺/ 鉁?宸插畬鎴?鈹? 鈹溾攢鈹€ DC-鏁版嵁娓呮礂鏁寸悊/
鈹? 鈹溾攢鈹€ SSA-鏅鸿兘缁熻<E7BC81>鍒嗘瀽/
鈹? 鈹溾攢鈹€ ST-缁熻<E7BC81>鍒嗘瀽宸ュ叿/
鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 04-寮€鍙戣<E98D99>鑼? # 缂栫爜瑙勮寖銆丄PI瑙勮寖
鈹? 鈹溾攢鈹€ 01-鏁版嵁搴撹<E690B4>璁¤<E79281>鑼?md
鈹? 鈹溾攢鈹€ 02-API璁捐<E79281>瑙勮寖.md
鈹? 鈹溾攢鈹€ 03-浠g爜瑙勮寖.md
鈹? 鈹溾攢鈹€ 04-Git鎻愪氦瑙勮寖.md
鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 05-閮ㄧ讲鏂囨。/ # 4绉嶉儴缃叉ā寮?鈹? 鈹溾攢鈹€ 01-浜戠<E6B59C>SaaS閮ㄧ讲/
鈹? 鈹溾攢鈹€ 02-鐙<>珛浜у搧鍖呴儴缃?
鈹? 鈹溾攢鈹€ 03-Electron鍗曟満鐗?
鈹? 鈹溾攢鈹€ 04-绉佹湁鍖栭儴缃?
鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 06-娴嬭瘯鏂囨。/ # 娴嬭瘯璁″垝銆佹祴璇曠敤渚?鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 07-杩愮淮鏂囨。/ # 杩愮淮鎵嬪唽銆佹晠闅滄帓鏌?鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 08-椤圭洰绠$悊/ # 寮€鍙戣<E98D99>鍒掋€佹瘡鏃ヨ繘搴?鈹? 鈹溾攢鈹€ 01-鏁翠綋寮€鍙戣<E98D99>鍒?
鈹? 鈹溾攢鈹€ 02-閲岀▼纰戣<E7BAB0>鍒?
鈹? 鈹斺攢鈹€ 03-姣忔棩杩涘害/
鈹?鈹溾攢鈹€ 馃摉 09-鏋舵瀯瀹炴柦/ # 鏋舵瀯婕旇繘銆侀噸鏋勮<E98F8B>鍒?鈹? 鈹斺攢鈹€ README.md
鈹?鈹溾攢鈹€ 馃摉 _templates/ # 鏂囨。妯℃澘
鈹? 鈹溾攢鈹€ [AI瀵规帴] 蹇<>€熶笂涓嬫枃-妯℃澘.md
鈹? 鈹溾攢鈹€ 妯″潡README-妯℃澘.md
鈹? 鈹斺攢鈹€ README.md
鈹?鈹斺攢鈹€ 馃摉 00-椤圭洰姒傝堪/ # 鍘嗗彶鏂囨。锛堝緟鏁寸悊锛? 鈹溾攢鈹€ 鐜版湁绯荤粺鎶€鏈<E282AC>懜搴曟姤鍛?md
鈹溾攢鈹€ 澹硅瘉寰<E79889><E5AFB0>鎶€ AI绉戠爺浜у搧闇€姹傛枃妗?md
鈹溾攢鈹€ 澹硅瘉寰<E79889><E5AFB0>鎶€AI绉戠爺浜у搧 - 鎶€鏈<E282AC>灦鏋勭櫧鐨<E6ABA7>功.md
└── AI智能文献PRD1-3.md
鈹斺攢鈹€ AI鏅鸿兘鏂囩尞PRD锛?-3锛?md
```
---
## 馃幆 蹇<>€熶笂涓嬫枃浣撶郴锛堥噾瀛楀<E7809B>寮忥級
### L0 - 总览800 tokens2分钟
**目标:** 新AI实例快速了解项目全貌
**文档:** [00-系统总体设计/[AI对接] 快速上下文](./00-系统总体设计/[AI对接]%20快速上下文.md)
**包含:** 8个业务模块、技术栈、当前进度、依赖关系
### L1 - 层级1500 tokens/篇3分钟
**目标:** 了解某一层的所有模块/能力
**文档:**
- [01-平台基础层/[AI对接] 平台层快速上下文](./01-平台基础层/[AI对接]%20平台层快速上下文.md)
- [02-通用能力层/[AI对接] 通用能力快速上下文](./02-通用能力层/[AI对接]%20通用能力快速上下文.md)
### L0 - 鎬昏<EFBFBD>锛?00 tokens锛?鍒嗛挓锛?**鐩<>爣锛?* 鏂癆I瀹炰緥蹇<E7B7A5>€熶簡瑙」鐩<E3808D>叏璨?
**鏂囨。锛?* [00-绯荤粺鎬讳綋璁捐<E79281>/[AI瀵规帴] 蹇<>€熶笂涓嬫枃](./00-绯荤粺鎬讳綋璁捐<E79281>/[AI瀵规帴]%20蹇<30>€熶笂涓嬫枃.md)
**鍖呭惈锛?* 8涓<38>笟鍔℃ā鍧椼€佹妧鏈<E5A6A7>爤銆佸綋鍓嶈繘搴︺€佷緷璧栧叧绯?
### L1 - 灞傜骇锛?500 tokens/绡囷紝3鍒嗛挓锛?**鐩<>爣锛?* 浜嗚В鏌愪竴灞傜殑鎵€鏈夋ā鍧?鑳藉姏
**鏂囨。锛?*
- [01-骞冲彴鍩虹<E98DA9>灞?[AI瀵规帴] 骞冲彴灞傚揩閫熶笂涓嬫枃](./01-骞冲彴鍩虹<E98DA9>灞?[AI瀵规帴]%20骞冲彴灞傚揩閫熶笂涓嬫枃.md)
- [02-閫氱敤鑳藉姏灞?[AI瀵规帴] 閫氱敤鑳藉姏蹇<E5A78F>€熶笂涓嬫枃](./02-閫氱敤鑳藉姏灞?[AI瀵规帴]%20閫氱敤鑳藉姏蹇<E5A78F>€熶笂涓嬫枃.md)
- [03-涓氬姟妯″潡/[AI瀵规帴] 涓氬姟妯″潡蹇<E6BDA1>€熶笂涓嬫枃](./03-涓氬姟妯″潡/[AI瀵规帴]%20涓氬姟妯″潡蹇<E6BDA1>€熶笂涓嬫枃.md)
### L2 - 模块级(2000 tokens/5分钟
**目标:** 深入了解具体模块的实现细节
**文档:**
- [ASL-AI智能文献/[AI对接] ASL快速上下文](./03-业务模块/ASL-AI智能文献/[AI对接]%20ASL快速上下文.md) P0
- [LLM大模型网关/[AI对接] LLM网关快速上下文](./02-通用能力层/01-LLM大模型网关/[AI对接]%20LLM网关快速上下文.md) ⭐ P0
- [ADMIN-运营管理端/[AI对接] ADMIN快速上下文](./03-业务模块/ADMIN-运营管理端/[AI对接]%20ADMIN快速上下文.md) P1
### L2 - 妯″潡绾э紙2000 tokens/绡囷紝5鍒嗛挓锛?**鐩<>爣锛?* 娣卞叆浜嗚В鍏蜂綋妯″潡鐨勫疄鐜扮粏鑺?
**鏂囨。锛?*
- [ASL-AI鏅鸿兘鏂囩尞/[AI瀵规帴] ASL蹇<4C>€熶笂涓嬫枃](./03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/[AI瀵规帴]%20ASL蹇<4C>€熶笂涓嬫枃.md) 猸?P0
- [LLM澶фā鍨嬬綉鍏?[AI瀵规帴] LLM缃戝叧蹇<E58FA7>€熶笂涓嬫枃](./02-閫氱敤鑳藉姏灞?01-LLM澶фā鍨嬬綉鍏?[AI瀵规帴]%20LLM缃戝叧蹇<E58FA7>€熶笂涓嬫枃.md) 猸?P0
- [ADMIN-杩愯惀绠$悊绔?[AI瀵规帴] ADMIN蹇<4E>€熶笂涓嬫枃](./03-涓氬姟妯″潡/ADMIN-杩愯惀绠$悊绔?[AI瀵规帴]%20ADMIN蹇<4E>€熶笂涓嬫枃.md) P1
---
## 📊 项目状态一览
## 馃搳 椤圭洰鐘舵€佷竴瑙?
### 褰撳墠闃舵<E99783>
🏗️ **架构设计完成文档重构完成准备ASL模块开发**
馃彈锔?**鏋舵瀯璁捐<E79281>瀹屾垚锛屾枃妗噸鏋勫畬鎴愶紝鍑嗗<E98D91>ASL妯″潡寮€鍙?*
### 宸插畬鎴愭ā鍧楋紙3涓<33>
| 模块 | 状态 | 说明 |
| 妯″潡 | 鐘舵€?| 璇存槑 |
|------|------|------|
| AIA-AI智能问答 | | 12个智能体、多轮对话 |
| PKB-个人知识库 | ✅ | RAG问答、智能引用 |
| RVW-稿件审查系统 | ✅ | 独立系统,可独立售卖 |
| AIA-AI鏅鸿兘闂<EFBFBD> | 鉁?| 12<EFBFBD>櫤鑳戒綋銆佸<EFBFBD><EFBFBD><EFBFBD>璇?|
| PKB-<EFBFBD>汉鐭ヨ瘑搴?| 鉁?| RAG闂<47>瓟銆佹櫤鑳藉紩鐢?|
| RVW-绋夸欢瀹℃煡绯荤粺 | 鉁?| 鐙<>珛绯荤粺锛屽彲鐙<E5BDB2>珛鍞<E78F9B> |
### 下一步开发P0
| 模块 | 优先级 | 预计时间 | 前置条件 |
### 涓嬩竴姝ュ紑鍙戯紙P0锛?| 妯″潡 | 浼樺厛绾?| 棰勮<E6A3B0>鏃堕棿 | 鍓嶇疆鏉′欢 |
|------|--------|---------|---------|
| **LLM大模型网关** | P0 | 3天 | 无 |
| **ASL-AI智能文献** | P0 | 3| LLM网关完成 |
| **LLM澶фā鍨嬬綉鍏?* | P0 | 3澶?| 鏃?|
| **ASL-AI鏅鸿兘鏂囩尞** | P0 | 3鍛?| LLM缃戝叧瀹屾垚 |
---
## 馃攳 甯歌<E794AF>鍦烘櫙瀵艰埅
### 鍦烘櫙1锛氬紑鍙慉SL妯″潡锛堟爣棰樻憳瑕佸垵绛涳級
1. 阅读:[ASL快速上下文](./03-业务模块/ASL-AI智能文献/[AI对接]%20ASL快速上下文.md)5分钟
2. 阅读:[LLM网关快速上下文](./02-通用能力层/01-LLM大模型网关/[AI对接]%20LLM网关快速上下文.md)5分钟
3. 参考:`AI智能文献/` 目录下的详细PRD和技术设计文档
4. 开始开发
**Token消耗** ~4000 tokens | **时间:** 10-15分钟
1. 闃呰<EFBFBD>锛歔ASL蹇<EFBFBD>€熶笂涓嬫枃](./03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/[AI瀵规帴]%20ASL<EFBFBD>€熶笂涓嬫枃.md)锛?鍒嗛挓锛?2. 闃呰<E99783>锛歔LLM缃戝叧蹇<E58FA7>€熶笂涓嬫枃](./02-閫氱敤鑳藉姏灞?01-LLM澶фā鍨嬬綉鍏?[AI瀵规帴]%20LLM缃戝叧蹇<E58FA7>€熶笂涓嬫枃.md)锛?鍒嗛挓锛?3. 鍙傝€冿細`AI鏅鸿兘鏂囩尞/`<>綍涓嬬殑璇︾粏PRD鍜屾妧鏈<E5A6A7><E98F88>璁℃枃妗?4. 寮€濮嬪紑鍙?
**Token娑堣€楋細** ~4000 tokens | **鏃堕棿锛?* 10-15鍒嗛挓
---
### 鍦烘櫙2锛氬疄鐜癓LM缃戝叧
1. 阅读:[LLM网关快速上下文](./02-通用能力层/01-LLM大模型网关/[AI对接]%20LLM网关快速上下文.md)5分钟
2. 阅读:[平台层快速上下文](./01-平台基础层/[AI对接]%20平台层快速上下文.md) - 了解Feature Flag3分钟
3. 参考API设计规范、数据库设计规范
4. 开始开发
**Token消耗** ~3500 tokens | **时间:** 8-10分钟
1. 闃呰<EFBFBD>锛歔LLM缃戝叧蹇<EFBFBD>€熶笂涓嬫枃](./02-閫氱敤鑳藉姏灞?01-LLM澶фā鍨嬬綉鍏?[AI瀵规帴]%20LLM缃戝叧蹇<E58FA7>€熶笂涓嬫枃.md)锛?鍒嗛挓锛?2. 闃呰<E99783>锛歔骞冲彴灞傚揩閫熶笂涓嬫枃](./01-骞冲彴鍩虹<E98DA9>灞?[AI瀵规帴]%20骞冲彴灞傚揩閫熶笂涓嬫枃.md) - 浜嗚ВFeature Flag锛?鍒嗛挓锛?3. 鍙傝€冿細API璁捐<E79281>瑙勮寖銆佹暟鎹<E69A9F>簱璁捐<E79281>瑙勮寖
4. 寮€濮嬪紑鍙?
**Token娑堣€楋細** ~3500 tokens | **鏃堕棿锛?* 8-10鍒嗛挓
---
### 场景3了解整体架构设计
1. 阅读:[00-系统总体设计/[AI对接] 快速上下文](./00-系统总体设计/[AI对接]%20快速上下文.md)2分钟
2. 阅读:[系统架构分层设计](./00-系统总体设计/01-系统架构分层设计.md)10分钟
3. 阅读:[架构设计全景图](./00-系统总体设计/08-架构设计全景图.md)5分钟
4. 根据需要深入了解特定层级
**Token消耗** ~5000 tokens | **时间:** 15-20分钟
### 鍦烘櫙3锛氫簡瑙暣浣撴灦鏋勮<EFBFBD>璁?1. 闃呰<E99783>锛歔00-绯荤粺鎬讳綋璁捐<E79281>/[AI瀵规帴] 蹇<>€熶笂涓嬫枃](./00-绯荤粺鎬讳綋璁捐<E79281>/[AI瀵规帴]%20蹇<30>€熶笂涓嬫枃.md)锛?鍒嗛挓锛?2. 闃呰<E99783>锛歔绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>](./00-绯荤粺鎬讳綋璁捐<E79281>/01-绯荤粺鏋舵瀯鍒嗗眰璁捐<E79281>.md)锛?0鍒嗛挓锛?3. 闃呰<E99783>锛歔鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥綸(./00-绯荤粺鎬讳綋璁捐<E79281>/08-鏋舵瀯璁捐<E79281>鍏ㄦ櫙鍥?md)锛?鍒嗛挓锛?4. 鏍规嵁闇€瑕佹繁鍏ヤ簡瑙g壒瀹氬眰绾?
**Token娑堣€楋細** ~5000 tokens | **鏃堕棿锛?* 15-20鍒嗛挓
---
### 鍦烘櫙4锛氫慨鏀规暟鎹<E69A9F>
1. 阅读:[数据库架构说明](./00-系统总体设计/03-数据库架构说明.md)
2. 参考:[04-开发规范/01-数据库设计规范](./04-开发规范/README.md)
1. 闃呰<EFBFBD>锛歔鏁版嵁搴撴灦鏋勮<EFBFBD>鏄嶿(./00-绯荤粺鎬讳綋璁捐<E79281>/03-鏁版嵁搴撴灦鏋勮<E98F8B>鏄?md)
2. 鍙傝€冿細[04-寮€鍙戣<E98D99>鑼?01-鏁版嵁搴撹<E690B4>璁¤<E79281>鑼僝(./04-寮€鍙戣<E98D99>鑼?README.md)
3. 鎵惧埌瀵瑰簲妯″潡鐨勬暟鎹<E69A9F>簱璁捐<E79281>鏂囨。
4. 开始修改
4. 寮€濮嬩慨鏀?
---
## 馃摑 鏂囨。缁存姢瑙勫垯
### 1. 蹇<>€熶笂涓嬫枃鏂囨。
- ✅ 必须控制在指定Token范围内
- ✅ 包含关键信息和跳转链接
- ✅ 每次架构变更后及时更新
- 鉁?蹇呴』鎺у埗鍦ㄦ寚瀹歍oken鑼冨洿鍐?- 鉁?鍖呭惈鍏抽敭淇℃伅鍜岃烦杞<E783A6>摼鎺?- 鉁?姣忔<E5A7A3>鏋舵瀯鍙樻洿鍚庡強鏃舵洿鏂?
### 2. 璇︾粏璁捐<E79281>鏂囨。
- ✅ 每个模块必须有README.md
- ✅ 复杂模块需要分多个子文档
- ✅ 使用统一的文档模板
- 鉁?姣忎釜妯″潡蹇呴』鏈塕EADME.md
- 鉁?澶嶆潅妯″潡闇€瑕佸垎澶氫釜瀛愭枃妗?- 鉁?浣跨敤缁熶竴鐨勬枃妗fā鏉?
### 3. 浠g爜娉ㄩ噴
- ✅ 核心逻辑必须有注释
- ✅ 复杂算法必须有文档说明
- ✅ API接口必须有JSDoc
- 鉁?鏍稿績閫昏緫蹇呴』鏈夋敞閲?- 鉁?澶嶆潅绠楁硶蹇呴』鏈夋枃妗<E5A697>鏄?- 鉁?API鎺ュ彛蹇呴』鏈塉SDoc
---
## 鈿狅笍 閲嶈<E996B2>鎻愰啋
### 文档优先级
1. ⭐⭐⭐⭐⭐ **快速上下文L0、L1、L2** - 必须保持更新
### 鏂囨。浼樺厛绾?1. 猸愨瓙猸愨瓙猸?**蹇<>€熶笂涓嬫枃锛圠0銆丩1銆丩2锛?* - 蹇呴』淇濇寔鏇存柊
2. 猸愨瓙猸愨瓙 **鏋舵瀯璁捐<E79281>鏂囨。** - 閲嶈<E996B2>鍙樻洿蹇呴』鏇存柊
3. ⭐⭐⭐ **模块README** - 每个模块必备
4. ⭐⭐ **详细设计文档** - 复杂模块需要
5.**开发日志** - 记录关键决策
### Token消耗优化
**传统方式:** 阅读全部文档 → ~30,000 tokens → 1小时+
**快速上下文:** L0+L1+L2 → ~5,000 tokens → 10-15分钟
**节省:** 83%的Token + 75%的时间
3. 猸愨瓙猸?**妯″潡README** - 姣忎釜妯″潡蹇呭<EFBFBD>
4. 猸愨瓙 **璇︾粏璁捐<EFBFBD>鏂囨。** - 澶嶆潅妯″潡闇€瑕?5. 猸?**寮€鍙戞棩蹇?* - 璁板綍鍏抽敭鍐崇瓥
### Token娑堣€椾紭鍖?**浼犵粺鏂瑰紡锛?* 闃呰<E99783>鍏ㄩ儴鏂囨。 鈫?~30,000 tokens 鈫?1灏忔椂+
**蹇<>€熶笂涓嬫枃锛?* L0+L1+L2 鈫?~5,000 tokens 鈫?10-15鍒嗛挓
**鑺傜渷锛?* 83%鐨凾oken + 75%鐨勬椂闂?
---
## 馃敆 澶栭儴璧勬簮
**代码仓库:** `D:\MyCursor\AIclinicalresearch\`
**浠g爜浠撳簱锛?* `D:\MyCursor\AIclinicalresearch\`
**鏁版嵁搴擄細** PostgreSQL (Docker, localhost:5432)
**Dify** http://localhost (独立系统)
**Dify锛?* http://localhost (<EFBFBD>珛绯荤粺)
---
## 馃摓 鑱旂郴鏂瑰紡
**技术架构师:** 负责架构设计和文档维护
**文档版本:** v3.0
**鎶€鏈<EFBFBD>灦鏋勫笀锛?* 璐熻矗鏋舵瀯璁捐<E79281>鍜屾枃妗淮鎶?
**鏂囨。鐗堟湰锛?* v3.0
**鏈€鍚庢洿鏂帮細** 2025-11-06
---
**🎯 下一步行动:** 开始ASL模块开发 + LLM网关实现Week 2
**馃幆 涓嬩竴姝ヨ<E5A79D><EFBFBD>** 寮€濮婣SL妯″潡寮€鍙?+ LLM缃戝叧瀹炵幇锛圵eek 2锛?