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,8 +1,8 @@
# 鏍稿績涓氬姟瑙勫垯鎬昏<E98EAC>
> **版本:** v1.0
> **创建日期:** 2025-10-10
> **适用范围:** 整个系统
> **鐗堟湰锛?* v1.0
> **鍒涘缓鏃ユ湡锛?* 2025-10-10
> **閫傜敤鑼冨洿锛?* 鏁翠釜绯荤粺
---
@@ -10,9 +10,9 @@
1. [鐢ㄦ埛绠$悊瑙勫垯](#鐢ㄦ埛绠$悊瑙勫垯)
2. [椤圭洰绠$悊瑙勫垯](#椤圭洰绠$悊瑙勫垯)
3. [智能体管理规则](#智能体管理规则)
3. [鏅鸿兘浣撶<EFBFBD>鐞嗚<EFBFBD>鍒橾(#鏅鸿兘浣撶<EFBFBD>鐞嗚<EFBFBD>鍒?
4. [瀵硅瘽绠$悊瑙勫垯](#瀵硅瘽绠$悊瑙勫垯)
5. [知识库管理规则](#知识库管理规则)
5. [鐭ヨ瘑搴撶<EFBFBD>鐞嗚<EFBFBD>鍒橾(#鐭ヨ瘑搴撶<EFBFBD>鐞嗚<EFBFBD>鍒?
6. [鏉冮檺鎺у埗瑙勫垯](#鏉冮檺鎺у埗瑙勫垯)
7. [閰嶉<EFBFBD>闄愬埗瑙勫垯](#閰嶉<E996B0>闄愬埗瑙勫垯)
@@ -22,43 +22,43 @@
### 娉ㄥ唽瑙勫垯
**BR-U001: 邮箱唯一性**
- 规则:每个邮箱只能注册一个账号
**BR-U001: <EFBFBD><EFBFBD><EFBFBD>竴鎬?*
- 瑙勫垯锛氭瘡涓<EFBFBD>偖绠卞彧鑳芥敞鍐屼竴涓<EFBFBD>处鍙?
- 楠岃瘉鏃舵満锛氭敞鍐屾椂
- 错误提示:"该邮箱已被注册"
- 閿欒<EFBFBD>鎻愮ず锛?璇ラ偖绠卞凡琚<E587A1>敞鍐?
**BR-U002: 閭<><E996AD>鏍煎紡楠岃瘉**
- 规则:必须是有效的邮箱格式
- 瑙勫垯锛氬繀椤绘槸鏈夋晥鐨勯偖绠辨牸寮?
- 姝e垯锛歚^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}$`
- 错误提示:"邮箱格式不正确"
- 閿欒<EFBFBD>鎻愮ず锛?閭<><E996AD>鏍煎紡涓嶆<E6B693>纭?
**BR-U003: 瀵嗙爜寮哄害**
- 规则密码至少8位包含字母和数字
- 瑙勫垯锛氬瘑鐮佽嚦灏?浣嶏紝鍖呭惈瀛楁瘝鍜屾暟瀛?
- 姝e垯锛歚^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d@$!%*#?&]{8,}$`
- 错误提示:"密码至少8位需包含字母和数字"
- 閿欒<EFBFBD>鎻愮ず锛?瀵嗙爜鑷冲皯8浣嶏紝闇€鍖呭惈瀛楁瘝鍜屾暟瀛?
**BR-U004: 默认试用期**
**BR-U004: 榛樿<EFBFBD>璇曠敤鏈?*
- 瑙勫垯锛氭柊鐢ㄦ埛榛樿<E6A69B>鑾峰緱30澶╄瘯鐢ㄦ湡
- 瀹炵幇锛歚trial_ends_at = now() + 30澶ー
### 鐧诲綍瑙勫垯
**BR-U005: 账户状态检查**
- 规则只有status=active的用户可以登录
**BR-U005: 璐︽埛鐘舵€佹<EFBFBD>鏌?*
- 瑙勫垯锛氬彧鏈塻tatus=active鐨勭敤鎴峰彲浠ョ櫥褰?
- 鐘舵€侊細
- `active` - 可登录
- `active` - <EFBFBD>櫥褰?
- `inactive` - 鏈<>縺娲伙紝涓嶅彲鐧诲綍
- `suspended` - 宸叉殏鍋滐紝涓嶅彲鐧诲綍
**BR-U006: 瀵嗙爜閿欒<E996BF>娆℃暟闄愬埗**
- 规则5分钟内最多5次错误尝试
- 超过次数临时锁定账户15分钟
- 瑙勫垯锛?鍒嗛挓鍐呮渶澶?娆¢敊璇<E6958A>皾璇?
- 瓒呰繃娆℃暟锛氫复鏃堕攣瀹氳处鎴?5鍒嗛挓
- 瀹炵幇锛氫娇鐢≧edis璁板綍澶辫触娆℃暟
**BR-U007: JWT Token有效期**
- Access Token7天
- Refresh Token30天
- 过期后需要重新登录
**BR-U007: JWT Token鏈夋晥鏈?*
- Access Token锛?澶?
- Refresh Token锛?0澶?
- 杩囨湡鍚庨渶瑕侀噸鏂扮櫥褰?
---
@@ -66,92 +66,92 @@
### 鍒涘缓瑙勫垯
**BR-P001: 项目数量无限制**
**BR-P001: 椤圭洰鏁伴噺鏃犻檺鍒?*
- 瑙勫垯锛氱敤鎴峰彲浠ュ垱寤轰换鎰忔暟閲忕殑椤圭洰
- 理由:项目是核心功能,不应限制
- 鐞嗙敱锛氶」鐩<EFBFBD>槸鏍稿績鍔熻兘锛屼笉搴旈檺鍒?
**BR-P002: 椤圭洰鍚嶇О蹇呭~**
- 规则:项目名称不能为空
- 长度1-200字符
- 错误提示:"项目名称不能为空"
- 瑙勫垯锛氶」鐩<EFBFBD>悕绉颁笉鑳戒负绌?
- 闀垮害锛?-200瀛楃<EFBFBD>
- 閿欒<EFBFBD>鎻愮ず锛?椤圭洰鍚嶇О涓嶈兘涓虹┖"
**BR-P003: 椤圭洰鎻忚堪蹇呭~**
- 瑙勫垯锛氶」鐩<E3808D>弿杩颁笉鑳戒负绌猴紙鐢ㄤ簬涓婁笅鏂囨敞鍏ワ級
- 鏈€灏忛暱搴︼細10瀛楃<E7809B>
- 错误提示:"请输入项目背景信息至少10个字符"
- 閿欒<EFBFBD>鎻愮ず锛?璇疯緭鍏ラ」鐩<E3808D>儗鏅<E58497>俊鎭<E4BF8A>紝鑷冲皯10涓<30>瓧绗?
### 鏇存柊瑙勫垯
**BR-P004: 项目背景动态更新**
- 规则:用户可以随时编辑项目描述
- 规则:可以"固定"AI回复到项目描述中
**BR-P004: 椤圭洰鑳屾櫙鍔ㄦ€佹洿鏂?*
- 瑙勫垯锛氱敤鎴峰彲浠ラ殢鏃剁紪杈戦」鐩<EFBFBD>弿杩?
- 瑙勫垯锛氬彲浠?鍥哄畾"AI鍥炲<E98DA5>鍒伴」鐩<E3808D>弿杩颁腑
- 瀹炵幇锛氳拷鍔犲埌description瀛楁<E7809B><EFBFBD>
**BR-P005: 椤圭洰鎵€鏈夋潈楠岃瘉**
- 规则:只能修改/删除自己的项目
- 瑙勫垯锛氬彧鑳戒慨鏀?鍒犻櫎鑷<E6AB8E>繁鐨勯」鐩?
- 楠岃瘉锛歚project.userId === currentUser.id`
- 错误提示:"无权限操作该项目"
- 閿欒<EFBFBD>鎻愮ず锛?鏃犳潈闄愭搷浣滆<E6B5A3>椤圭洰"
### 鍒犻櫎瑙勫垯
**BR-P006: 绾ц仈鍒犻櫎**
- 瑙勫垯锛氬垹闄ら」鐩<E3808D>椂锛岀骇鑱斿垹闄ゅ叾鎵€鏈夊<E98F88>璇濆拰娑堟伅
- 瀹炵幇锛氭暟鎹<E69A9F>簱ON DELETE CASCADE
- 确认:前端需要二次确认
- <EFBFBD><EFBFBD>锛氬墠绔<EFBFBD>渶瑕佷簩娆璁?
**BR-P007: 杞<>垹闄わ紙鍙<E7B499>€夛級**
- 规则重要项目可以先软删除保留30天
- 瑙勫垯锛氶噸瑕侀」鐩<EFBFBD>彲浠ュ厛杞<EFBFBD>垹闄わ紝淇濈暀30澶?
- 瀹炵幇锛氭坊鍔燿eleted_at瀛楁<E7809B>
- 备注:当前版本暂不实现
- 澶囨敞锛氬綋鍓嶇増鏈<EFBFBD>殏涓嶅疄鐜?
---
## 智能体管理规则
## 鏅鸿兘浣撶<EFBFBD>鐞嗚<EFBFBD>鍒?
### 智能体配置
### 鏅鸿兘浣撻厤缃?
**BR-A001: 鏅鸿兘浣撻厤缃<E58EA4>寲绠**
- 瑙勫垯锛氭櫤鑳戒綋閰嶇疆瀛樺偍鍦╜config/agents.yaml`
- 规则:不通过数据库管理
- 规则:修改配置后需要重启服务
- 瑙勫垯锛氫笉閫氳繃鏁版嵁搴撶<EFBFBD>鐞?
- 瑙勫垯锛氫慨鏀归厤缃<EFBFBD>悗闇€瑕侀噸鍚<EFBFBD>湇鍔?
**BR-A002: 智能体状态**
**BR-A002: 鏅鸿兘浣撶姸鎬?*
- `active` - 鍙<>敤锛岀敤鎴峰彲浠ラ€夋嫨
- `inactive` - 涓嶅彲鐢<E5BDB2>紝闅愯棌
- `testing` - 娴嬭瘯涓<E798AF>紝浠呯<E6B5A0>鐞嗗憳鍙<E686B3><E98D99>
**BR-A003: 智能体分类**
- 选题阶段:选题评价、科学问题梳理
- 研究设计PICOS构建、观察指标设计、CRF制定、样本量计算、临床研究方案撰写
- 论文阶段:论文润色、论文翻译、方法学评审、期刊方法学评审、期刊稿约评审
**BR-A003: 鏅鸿兘浣撳垎绫?*
- 閫夐<EFBFBD>闃舵<EFBFBD>锛氶€夐<EFBFBD>璇勪环銆佺<EFBFBD>瀛﹂棶棰樻⒊鐞?
- 鐮旂┒璁捐<EFBFBD>锛歅ICOS鏋勫缓銆佽<EFBFBD>瀵熸寚鏍囪<EFBFBD>璁°€丆RF鍒跺畾銆佹牱鏈<EFBFBD>噺璁畻銆佷复搴婄爺绌舵柟妗堟挵鍐?
- 璁烘枃闃舵<EFBFBD>锛氳<EFBFBD>鏂囨鼎鑹层€佽<EFBFBD>鏂囩炕璇戙€佹柟娉曞<EFBFBD>璇勫<EFBFBD>銆佹湡鍒婃柟娉曞<EFBFBD>璇勫<EFBFBD>銆佹湡鍒婄ǹ绾﹁瘎瀹?
### Prompt绠
**BR-A004: Prompt鏂囦欢绠**
- 瑙勫垯锛歅rompt瀛樺偍鍦╜backend/prompts/`鐩<>
- 命名:`{agent_id}_system.txt``{agent_id}_user.txt`
- 鍛藉悕锛歚{agent_id}_system.txt` 鍜?`{agent_id}_user.txt`
- 鐗堟湰锛氶€氳繃Git绠悊鐗堟湰
**BR-A005: Prompt鍙橀噺娉ㄥ叆**
- 规则Prompt中可以使用变量
- 瑙勫垯锛歅rompt涓<EFBFBD>彲浠ヤ娇鐢ㄥ彉閲?
- 鏍煎紡锛歚{variable_name}`
- 绀轰緥锛歚{project_description}`, `{user_question}`
### 妯″瀷閰嶇疆
**BR-A006: 妯″瀷鍙傛暟閰嶇疆**
- 规则:每个智能体可以配置不同模型的参数
- 参数:
- 瑙勫垯锛氭瘡涓<EFBFBD>櫤鑳戒綋鍙<EFBFBD>互閰嶇疆涓嶅悓妯″瀷鐨勫弬鏁?
- 鍙傛暟锛?
- `temperature`: 0.0-1.0
- `max_tokens`: 最大输出token
- `max_tokens`: 鏈€澶ц緭鍑簍oken鏁?
- `top_p`: 0.0-1.0
**BR-A007: 妯″瀷鍒囨崲**
- 规则:用户可以在对话中切换模型
- 瑙勫垯锛氱敤鎴峰彲浠ュ湪瀵硅瘽涓<EFBFBD>垏鎹㈡ā鍨?
-<>€夋ā鍨嬶細
- `deepseek-v3` (榛樿<E6A69B>)
- `qwen3-72b`
- `gemini-2.0-flash` (可选)
- `gemini-2.0-flash` (<EFBFBD>€?
---
@@ -160,40 +160,40 @@
### 鍒涘缓瀵硅瘽
**BR-C001: 瀵硅瘽褰掑睘**
- 规则:对话可以属于项目,也可以是全局快速问答
- 瑙勫垯锛氬<EFBFBD>璇濆彲浠ュ睘浜庨」鐩<EFBFBD>紝涔熷彲浠ユ槸鍏ㄥ眬蹇<EFBFBD>€熼棶绛?
- 椤圭洰瀵硅瘽锛歚projectId` 涓嶄负null
- 鍏ㄥ眬蹇<E79CAC>€熼棶绛旓細`projectId` 涓簄ull
**BR-C002: 瀵硅瘽鏍囬<E98F8D><EFBFBD>姩鐢熸垚**
- 规则:首次创建对话时,标题为"与{智能体名称}的对话"
- 规则:可以手动修改标题
- 瑙勫垯锛氶<EFBFBD>娆″垱寤哄<EFBFBD>璇濇椂锛屾爣棰樹负"涓巤鏅鸿兘浣撳悕绉皚鐨勫<E990A8>璇?
- 瑙勫垯锛氬彲浠ユ墜鍔ㄤ慨鏀规爣棰?
### 上下文管理
### 涓婁笅鏂囩<EFBFBD>鐞?
**BR-C003: 椤圭洰鑳屾櫙鑷<E6AB99>姩娉ㄥ叆**
- 规则如果对话属于项目自动将项目description注入上下文
- 瑙勫垯锛氬<EFBFBD>鏋滃<EFBFBD>璇濆睘浜庨」鐩<EFBFBD>紝鑷<EFBFBD>姩灏嗛」鐩甦escription娉ㄥ叆涓婁笅鏂?
- 娉ㄥ叆浣嶇疆锛歋ystem prompt涔嬪悗
- 鏍煎紡锛歚# 椤圭洰鑳屾櫙\n{project.description}`
**BR-C004: 鍘嗗彶瀵硅瘽绠$悊**
- 规则保留最近10轮对话作为上下文
- 规则超过10轮的对话进行摘要压缩
- 瑙勫垯锛氫繚鐣欐渶杩?0杞<30><E69D9E>璇濅綔涓轰笂涓嬫枃
- 瑙勫垯锛氳秴杩?0杞<30>殑瀵硅瘽锛岃繘琛屾憳瑕佸帇缂?
- Token闄愬埗锛氫笂涓嬫枃鎬籺oken鏁颁笉瓒呰繃6000
**BR-C005: 知识库引用**
- 规则:用户可以通过`@知识库名称`引用知识库
- 规则最多同时引用3个知识库
**BR-C005: 鐭ヨ瘑搴撳紩鐢?*
- 瑙勫垯锛氱敤鎴峰彲浠ラ€氳繃`@鐭ヨ瘑搴撳悕绉癭寮曠敤鐭ヨ瘑搴?
- 瑙勫垯锛氭渶澶氬悓鏃跺紩鐢?涓<>煡璇嗗簱
- 妫€绱㈡暟閲忥細姣忎釜鐭ヨ瘑搴撴<E690B4><EFBFBD>op 5缁撴灉
### 娑堟伅鍥哄畾
**BR-C006: 固定消息到项目背景**
- 规则只有AI回复可以被固定
- 规则:只有项目内对话可以固定(全局对话不可)
**BR-C006: 鍥哄畾娑堟伅鍒伴」鐩<EFBFBD>儗鏅?*
- 瑙勫垯锛氬彧鏈堿I鍥炲<EFBFBD><EFBFBD>互琚<EFBFBD>浐瀹?
- 瑙勫垯锛氬彧鏈夐」鐩<EFBFBD>唴瀵硅瘽鍙<EFBFBD>互鍥哄畾锛堝叏灞€瀵硅瘽涓嶅彲锛?
- 瀹炵幇锛氳拷鍔犲埌project.description鏈<6E>
- 格式:
- 鏍煎紡锛?
```
--- 来自对话的补充 ---
--- 鏉ヨ嚜瀵硅瘽鐨勮ˉ鍏?---
{message.content}
```
@@ -205,83 +205,83 @@
**BR-C008: Server-Sent Events**
- 瑙勫垯锛氫娇鐢⊿SE瀹炵幇娴佸紡杈撳嚭
- 事件类型:
- `start`: 开始生成
- 浜嬩欢绫诲瀷锛?
- `start`: 寮€濮嬬敓鎴?
- `token`: 姣忎釜token
- `done`: 瀹屾垚
- `error`: 閿欒<E996BF>
**BR-C009: 娴佸紡杈撳嚭瓒呮椂**
- 规则单个请求最长60秒
- 瑙勫垯锛氬崟涓<EFBFBD><EFBFBD>姹傛渶闀?0绉?
- 瓒呮椂鍚庯細杩斿洖宸茬敓鎴愮殑鍐呭<E98D90>
- 错误提示:"生成超时,请重试"
- 閿欒<EFBFBD>鎻愮ず锛?鐢熸垚瓒呮椂锛岃<E9949B>閲嶈瘯"
---
## 知识库管理规则
## 鐭ヨ瘑搴撶<EFBFBD>鐞嗚<EFBFBD>鍒?
### 鏁伴噺闄愬埗
**BR-K001: 知识库数量限制**
- 规则每个用户最多创建3个知识库
- 验证时机:创建知识库时
- 错误提示:"已达到知识库数量上限3个"
**BR-K001: 鐭ヨ瘑搴撴暟閲忛檺鍒?*
- 瑙勫垯锛氭瘡涓<EFBFBD>敤鎴锋渶澶氬垱寤?涓<>煡璇嗗簱
- 楠岃瘉鏃舵満锛氬垱寤虹煡璇嗗簱鏃?
- 閿欒<EFBFBD>鎻愮ず锛?宸茶揪鍒扮煡璇嗗簱鏁伴噺涓婇檺锛?涓<>"
**BR-K002: 鏂囨。鏁伴噺闄愬埗**
- 规则每个知识库最多上传50个文档
- 瑙勫垯锛氭瘡涓<EFBFBD>煡璇嗗簱鏈€澶氫笂浼?0涓<30>枃妗?
- 楠岃瘉鏃舵満锛氫笂浼犳枃妗f椂
- 错误提示:"该知识库文档数量已达上限50个"
- 閿欒<EFBFBD>鎻愮ず锛?璇ョ煡璇嗗簱鏂囨。鏁伴噺宸茶揪涓婇檺锛?0涓<30>"
### 鏂囨。涓婁紶
**BR-K003: 鏂囦欢鏍煎紡闄愬埗**
- 瑙勫垯锛氬彧鏀<E5BDA7>寔PDF鍜孌OCX鏍煎紡
- MIME类型:
- MIME绫诲瀷锛?
- `application/pdf`
- `application/vnd.openxmlformats-officedocument.wordprocessingml.document`
- 错误提示:"仅支持PDF和DOCX格式"
- 閿欒<EFBFBD>鎻愮ず锛?浠呮敮鎸丳DF鍜孌OCX鏍煎紡"
**BR-K004: 鏂囦欢澶у皬闄愬埗**
- 规则单个文件最大50MB
- 瑙勫垯锛氬崟涓<EFBFBD>枃浠舵渶澶?0MB
- 楠岃瘉鏃舵満锛氫笂浼犲墠锛堝墠绔<E5A2A0>級鍜屼笂浼犲悗锛堝悗绔<E68297>
- 错误提示:"文件大小超过限制最大50MB"
- 閿欒<EFBFBD>鎻愮ず锛?鏂囦欢澶у皬瓒呰繃闄愬埗锛堟渶澶?0MB锛?
**BR-K005: 文件名唯一性**
**BR-K005: 鏂囦欢鍚嶅敮涓€鎬?*
- 瑙勫垯锛氬悓涓€鐭ヨ瘑搴撳唴锛屾枃浠跺悕涓嶈兘閲嶅<E996B2>
- 楠岃瘉锛氭<E9949B>鏌ユ槸鍚﹀凡瀛樺湪鍚屽悕鏂囦欢
- 处理:自动重命名(添加时间戳)
- 澶勭悊锛氳嚜鍔ㄩ噸鍛藉悕锛堟坊鍔犳椂闂存埑锛?
### 鏂囨。澶勭悊
**BR-K006: 文档处理状态**
**BR-K006: 鏂囨。澶勭悊鐘舵€?*
- 鐘舵€佹祦杞<E7A5A6>
1. `uploading` - 上传中
2. `processing` - Dify处理中
1. `uploading` - 涓婁紶涓?
2. `processing` - Dify澶勭悊涓?
3. `completed` - 澶勭悊瀹屾垚
4. `failed` - 澶勭悊澶辫触
**BR-K007: 澶勭悊澶辫触閲嶈瘯**
- 规则:处理失败的文档不自动重试
- 瑙勫垯锛氬<EFBFBD>鐞嗗け璐ョ殑鏂囨。涓嶈嚜鍔ㄩ噸璇?
- 瑙勫垯锛氱敤鎴峰彲浠ュ垹闄ゅ悗閲嶆柊涓婁紶
- 閿欒<E996BF>淇℃伅锛氳<E9949B>褰曞湪error_message瀛楁<E7809B>
**BR-K008: 寮傛<E5AFAE>澶勭悊**
- 瑙勫垯锛氭枃妗d笂浼犲悗绔嬪嵆杩斿洖
- 瑙勫垯锛氬悗鍙板紓姝ユ彁浜ゅ埌Dify澶勭悊
- 规则:前端轮询获取处理状态
- 瑙勫垯锛氬墠绔<EFBFBD>疆璇㈣幏鍙栧<EFBFBD>鐞嗙姸鎬?
### 知识库检索
### 鐭ヨ瘑搴撴<EFBFBD>绱?
**BR-K009: 混合检索**
- 规则:使用关键词检索 + 语义检索
- 规则启用Reranking重排序
- Top K5个结果
**BR-K009: 娣峰悎妫€绱?*
- 瑙勫垯锛氫娇鐢ㄥ叧閿<EFBFBD>瘝妫€绱?+ 璇<>箟妫€绱?
- 瑙勫垯锛氬惎鐢≧eranking閲嶆帓搴?
- Top K锛?涓<>粨鏋?
- 鐩镐技搴﹂槇鍊硷細0.5
**BR-K010: 检索结果引用**
**BR-K010: 妫€绱㈢粨鏋滃紩鐢?*
- 瑙勫垯锛欰I鍥炵瓟蹇呴』娉ㄦ槑寮曠敤鏉ユ簮
- 鏍煎紡锛歚[鏂囨。鍚峕 鍐呭<E98D90>...`
- 规则:前端显示可点击的引用标记
- 瑙勫垯锛氬墠绔<E5A2A0>樉绀哄彲鐐瑰嚮鐨勫紩鐢ㄦ爣璁?
---
@@ -290,27 +290,27 @@
### 鐢ㄦ埛鏉冮檺
**BR-P001: 瑙掕壊瀹氫箟**
- `user` - 普通用户
- 可以使用所有功能
- 受配额限制
- `admin` - 管理员
- `user` - <EFBFBD>€氱敤鎴?
-<>互浣跨敤鎵€鏈夊姛鑳?
- 鍙楅厤棰濋檺鍒?
- `admin` - 绠$悊鍛?
- 鎵€鏈塽ser鏉冮檺
-<>互璁块棶杩愯惀鍚庡彴
- 可以查看所有用户数据
-<>互鏌ョ湅鎵€鏈夌敤鎴锋暟鎹?
### 鏁版嵁闅旂<E99785>
**BR-P002: 鐢ㄦ埛鏁版嵁闅旂<E99785>**
- 瑙勫垯锛氱敤鎴峰彧鑳借<E991B3><EFBFBD>嚜宸卞垱寤虹殑鏁版嵁
- 楠岃瘉锛氭墍鏈夋煡璇㈠繀椤诲寘鍚玼serId杩囨护
- 实现:
- 瀹炵幇锛?
```sql
WHERE user_id = currentUser.id
```
**BR-P003: 椤圭洰鏉冮檺楠岃瘉**
- 规则:修改/删除项目前,验证所有权
- 实现:
- 瑙勫垯锛氫慨鏀?鍒犻櫎椤圭洰鍓嶏紝楠岃瘉鎵€鏈夋潈
- 瀹炵幇锛?
```typescript
const project = await prisma.project.findFirst({
where: { id: projectId, userId: currentUser.id }
@@ -318,33 +318,33 @@
if (!project) throw new UnauthorizedError()
```
### 管理员权限
### 绠$悊鍛樻潈闄?
**BR-P004: 鐢ㄦ埛绠$悊鏉冮檺**
- 瑙勫垯锛氬彧鏈塧dmin鍙<6E>互鏌ョ湅鐢ㄦ埛鍒楄〃
- 规则只有admin可以修改用户状态
- 瑙勫垯锛氬彧鏈塧dmin鍙<EFBFBD>互淇<EFBFBD>敼鐢ㄦ埛鐘舵€?
- 瑙勫垯锛歛dmin涓嶈兘鍒犻櫎鐢ㄦ埛锛堝彧鑳芥殏鍋滐級
**BR-P005: 瀵硅瘽鏌ョ湅鏉冮檺**
- 瑙勫垯锛氬彧鏈塧dmin鍙<6E>互鏌ョ湅鐢ㄦ埛瀵硅瘽
- 规则:必须记录审计日志
- 规则:敏感信息需要脱敏(如邮箱、手机号)
- 瑙勫垯锛氬繀椤昏<EFBFBD>褰曞<EFBFBD>璁℃棩蹇?
- 瑙勫垯锛氭晱鎰熶俊鎭<EFBFBD>渶瑕佽劚鏁忥紙濡傞偖绠便€佹墜鏈哄彿锛?
---
## 閰嶉<E996B0>闄愬埗瑙勫垯
### 知识库配额
### 鐭ヨ瘑搴撻厤棰?
**BR-Q001: 知识库数量配额**
- 默认配额3个知识库
**BR-Q001: 鐭ヨ瘑搴撴暟閲忛厤棰?*
- 榛樿<EFBFBD>閰嶉<EFBFBD>锛?涓<>煡璇嗗簱
- 璁板綍瀛楁<E7809B>锛歚users.kb_quota`, `users.kb_used`
- 更新时机:创建/删除知识库时
- 鏇存柊鏃舵満锛氬垱寤?鍒犻櫎鐭ヨ瘑搴撴椂
**BR-Q002: 鏂囨。鏁伴噺閰嶉<E996B0>**
- 默认配额50个文档/知识库
- 检查时机:上传文档前
- 实现:
- 榛樿<E6A69B>閰嶉<E996B0>锛?0涓<30>枃妗?鐭ヨ瘑搴?
- 妫€鏌ユ椂鏈猴細涓婁紶鏂囨。鍓?
- 瀹炵幇锛?
```sql
SELECT COUNT(*) FROM documents
WHERE kb_id = ? AND status != 'failed'
@@ -353,72 +353,72 @@
### 瀛樺偍閰嶉<E996B0>锛堥<E9949B>鐣欙級
**BR-Q003: 瀛樺偍绌洪棿閰嶉<E996B0>**
- 默认配额1GB/用户
- 榛樿<EFBFBD>閰嶉<EFBFBD>锛?GB/鐢ㄦ埛
- 褰撳墠鐗堟湰锛氫笉寮哄埗闄愬埗
- 未来:可以根据实际需求启用
- <EFBFBD>潵锛氬彲浠ユ牴鎹<EFBFBD>疄闄呴渶姹傚惎鐢?
### API闄愭祦
**BR-Q004: API璇锋眰棰戠巼闄愬埗**
- 普通用户100次/分钟
- 管理员500次/分钟
- <EFBFBD>€氱敤鎴凤細100娆?鍒嗛挓
- 悊鍛橈細500娆?鍒嗛挓
- 瀹炵幇锛氫娇鐢≧edis + 婊戝姩绐楀彛绠楁硶
**BR-Q005: 鐧诲綍鎺ュ彛闄愭祦**
- 规则5次/分钟
- 规则IP和账户双重限制
- 瑙勫垯锛?娆?鍒嗛挓
- 瑙勫垯锛欼P鍜岃处鎴峰弻閲嶉檺鍒?
- 瓒呰繃鍚庯細涓存椂灏佺<E7818F>15鍒嗛挓
---
## 涓氬姟娴佺▼
### 完整的对话流程
### 瀹屾暣鐨勫<EFBFBD>璇濇祦绋?
```
1. 用户选择智能体
1. 鐢ㄦ埛閫夋嫨鏅鸿兘浣?
鈫?
2. 鍒涘缓瀵硅瘽锛堝彲閫夊叧鑱旈」鐩<E3808D>
3. 用户发送消息(可选引用知识库)
鈫?
3. 鐢ㄦ埛鍙戦€佹秷鎭<EFBFBD>紙鍙<EFBFBD>€夊紩鐢ㄧ煡璇嗗簱锛?
鈫?
4. 鍚庣<E98D9A>缁勮<E7BC81>涓婁笅鏂囷細
- 椤圭洰鑳屾櫙锛堝<E9949B>鏈夛級
- 鏅鸿兘浣揝ystem Prompt
- 历史对话最近10轮
- 知识库检索结果(如有)
- 鍘嗗彶瀵硅瘽锛堟渶杩?0杞<30>
- 鐭ヨ瘑搴撴<EFBFBD>绱㈢粨鏋滐紙濡傛湁锛?
- 褰撳墠鐢ㄦ埛闂<E59F9B><E99782>
鈫?
5. 璋冪敤LLM锛堟祦寮忚緭鍑猴級
鈫?
6. 淇濆瓨娑堟伅鍒版暟鎹<E69A9F>
7. 用户可选:固定消息到项目背景
鈫?
7. 鐢ㄦ埛鍙<EFBFBD>€夛細鍥哄畾娑堟伅鍒伴」鐩<EFBFBD>儗鏅?
```
### 知识库文档处理流程
### 鐭ヨ瘑搴撴枃妗<EFBFBD>鐞嗘祦绋?
```
1. 鐢ㄦ埛涓婁紶鏂囨。
2. 验证:
鈫?
2. 楠岃瘉锛?
- 鏂囦欢鏍煎紡
- 鏂囦欢澶у皬
- 鏁伴噺闄愬埗
3. 上传到对象存储(OSS
4. 创建document记录status: uploading
5. 异步提交到Dify
鈫?
3. 涓婁紶鍒板<EFBFBD>璞″瓨鍌<EFBFBD>OSS锛?
鈫?
4. 鍒涘缓document璁板綍锛坰tatus: uploading锛?
鈫?
5. 寮傛<EFBFBD>鎻愪氦鍒癉ify锛?
- 璋冪敤Dify涓婁紶API
- 鑾峰彇dify_document_id
6. 轮询处理状态每2秒
- processing → 更新progress
- completed → 更新status, segments_count, tokens_count
- failed → 更新status, error_message
鈫?
6. <EFBFBD><EFBFBD>澶勭悊鐘舵€侊紙姣?绉掞級锛?
- processing 鈫?鏇存柊progress
- completed 鈫?鏇存柊status, segments_count, tokens_count
- failed 鈫?鏇存柊status, error_message
鈫?
7. 鏇存柊鐭ヨ瘑搴撶粺璁★細
- file_count
- total_size_bytes
@@ -426,29 +426,29 @@
---
## 数据一致性规则
## 鏁版嵁涓€鑷存€ц<EFBFBD>鍒?
### 缁熻<E7BC81>瀛楁<E7809B>鏇存柊
**BR-D001: 项目对话数统计**
**BR-D001: 椤圭洰瀵硅瘽鏁扮粺璁?*
- 瀛楁<E7809B>锛歚projects.conversation_count`
- 更新时机:创建/删除对话时
- 实现:使用事务保证一致性
- 鏇存柊鏃舵満锛氬垱寤?鍒犻櫎瀵硅瘽鏃?
- 瀹炵幇锛氫娇鐢ㄤ簨鍔′繚璇佷竴鑷存€?
**BR-D002: 鐭ヨ瘑搴撴枃妗暟缁熻<E7BC81>**
- 瀛楁<E7809B>锛歚knowledge_bases.file_count`
- 鏇存柊鏃舵満锛氭枃妗姸鎬佸彉涓篶ompleted鎴栧垹闄ゆ椂
- 计算:只统计status='completed'的文档
-畻锛氬彧缁熻<E7BC81>status='completed'鐨勬枃妗?
**BR-D003: 鐢ㄦ埛鐭ヨ瘑搴撴暟缁熻<E7BC81>**
- 瀛楁<E7809B>锛歚users.kb_used`
- 更新时机:创建/删除知识库时
- 鏇存柊鏃舵満锛氬垱寤?鍒犻櫎鐭ヨ瘑搴撴椂
- 楠岃瘉锛氬垱寤哄墠妫€鏌ユ槸鍚﹁秴杩噏uota
### 绾ц仈鍒犻櫎
**BR-D004: 鐢ㄦ埛鍒犻櫎绾ц仈**
- 规则:删除用户时,级联删除所有关联数据
- 瑙勫垯锛氬垹闄ょ敤鎴锋椂锛岀骇鑱斿垹闄ゆ墍鏈夊叧鑱旀暟鎹?
- 鍖呮嫭锛歱rojects, conversations, messages, knowledge_bases, documents
- 瀹炵幇锛氭暟鎹<E69A9F>簱ON DELETE CASCADE
@@ -456,7 +456,7 @@
- 瑙勫垯锛氬垹闄ら」鐩<E3808D>椂锛岀骇鑱斿垹闄ゆ墍鏈夊<E98F88>璇濆拰娑堟伅
- 瀹炵幇锛氭暟鎹<E69A9F>簱ON DELETE CASCADE
**BR-D006: 知识库删除级联**
**BR-D006: 鐭ヨ瘑搴撳垹闄ょ骇鑱?*
- 瑙勫垯锛氬垹闄ょ煡璇嗗簱鏃讹細
1. 绾ц仈鍒犻櫎鏁版嵁搴撲腑鐨刣ocuments
2. 璋冪敤Dify API鍒犻櫎dataset
@@ -487,7 +487,7 @@
"success": false,
"error": {
"code": "QUOTA_EXCEEDED",
"message": "知识库数量已达上限",
"message": "鐭ヨ瘑搴撴暟閲忓凡杈句笂闄?,
"details": {
"resource": "knowledge_base",
"quota": 3,
@@ -506,11 +506,11 @@
**BR-S001: 瀵嗙爜鍔犲瘑**
- 绠楁硶锛歜crypt
- 成本因子12
- 规则:永不存储明文密码
- 鎴愭湰鍥犲瓙锛?2
- 瑙勫垯锛氭案涓嶅瓨鍌ㄦ槑鏂囧瘑鐮?
**BR-S002: Token瀹夊叏**
- 规则Token包含用户ID和角色
- 瑙勫垯锛歍oken鍖呭惈鐢ㄦ埛ID鍜岃<E98D9C>鑹?
- 瑙勫垯锛歍oken绛惧悕浣跨敤JWT_SECRET
- 瑙勫垯锛氳繃鏈烼oken鑷<6E>姩澶辨晥
@@ -524,7 +524,7 @@
### XSS闃叉姢
**BR-S004: 杈撳叆杞<E58F86>**
- 规则:所有用户输入在显示前转义
- 瑙勫垯锛氭墍鏈夌敤鎴疯緭鍏ュ湪鏄剧ず鍓嶈浆涔?
- 瑙勫垯锛氫娇鐢≧eact榛樿<E6A69B><EFBFBD>
- 瑙勫垯锛氱<E9949B><EFBFBD>娇鐢╠angerouslySetInnerHTML锛堥櫎闈炲繀瑕侊級
@@ -534,22 +534,22 @@
### 缂撳瓨瑙勫垯
**BR-O001: 智能体列表缓存**
**BR-O001: 鏅鸿兘浣撳垪琛ㄧ紦瀛?*
- 瑙勫垯锛氭櫤鑳戒綋鍒楄〃缂撳瓨1灏忔椂
- 瀹炵幇锛歊edis缂撳瓨
- 澶辨晥锛氫慨鏀筧gents.yaml鍚庨渶娓呴櫎缂撳瓨
**BR-O002: 鐢ㄦ埛淇℃伅缂撳瓨**
- 规则用户信息缓存5分钟
- 瑙勫垯锛氱敤鎴蜂俊鎭<E4BF8A>紦瀛?鍒嗛挓
- Key锛歚user:{userId}`
- 澶辨晥锛氱敤鎴蜂俊鎭<E4BF8A>洿鏂版椂
### 鏌ヨ<E98F8C>浼樺寲
**BR-O003: 鍒嗛〉鏌ヨ<E98F8C>**
- 规则:列表查询必须分页
- 默认20条/页
- 最大100条/页
- 瑙勫垯锛氬垪琛ㄦ煡璇㈠繀椤诲垎椤?
- 榛樿<EFBFBD>锛?0鏉?椤?
- 鏈€澶э細100鏉?椤?
**BR-O004: 绱㈠紩浣跨敤**
- 瑙勫垯锛氶<E9949B>绻佹煡璇㈢殑瀛楁<E7809B>蹇呴』寤虹珛绱㈠紩
@@ -563,30 +563,30 @@
### 鏁版嵁褰掓。
**BR-R001: 瀵硅瘽褰掓。锛堟湭鏉ワ級**
- 规则超过6个月的对话自动归档
- 瑙勫垯锛氳秴杩?涓<>湀鐨勫<E990A8>璇濊嚜鍔ㄥ綊妗?
- 褰掓。琛<E38082>細conversations_archive
- 鏌ヨ<E98F8C>锛氶粯璁や笉鏌ヨ<E98F8C>褰掓。鏁版嵁
**BR-R002: 鏃ュ織娓呯悊**
- 瑙勫垯锛歛dmin_logs淇濈暀3涓<33>
- 执行:定时任务每月清理
- 鎵ц<EFBFBD>锛氬畾鏃朵换鍔℃瘡鏈堟竻鐞?
---
## 涓氬姟瑙勫垯鍙樻洿娴佺▼
1. **提出变更**:填写变更申请
2. **影响评估**:评估对系统的影响
1. **鎻愬嚭鍙樻洿**锛氬~鍐欏彉鏇寸敵璇?
2. **褰卞搷璇勪及**锛氳瘎浼板<E6B5BC>绯荤粺鐨勫奖鍝?
3. **Review**锛氭妧鏈<E5A6A7>洟闃烺eview
4. **鏇存柊鏂囨。**锛氬悓姝ユ洿鏂版湰鏂囨。
5. **实施变更**:修改代码
5. **瀹炴柦鍙樻洿**锛氫慨鏀逛唬鐮?
6. **娴嬭瘯楠岃瘉**锛氭祴璇曟柊瑙勫垯
7. **涓婄嚎鍙戝竷**锛氬彂甯冨埌鐢熶骇
---
**文档维护:** 业务规则变更需同步更新
**Review频率:** 每个里程碑Review一次
**鏂囨。缁存姢锛?* 涓氬姟瑙勫垯鍙樻洿闇€鍚屾<E98D9A>鏇存柊
**Review棰戠巼锛?* 姣忎釜閲岀▼纰慠eview涓€娆?
**鏈€鍚庢洿鏂帮細** 2025-10-10
**缁存姢鑰咃細** 浜у搧缁忕悊 + 鎶€鏈<E282AC>礋璐