feat(admin): Add user management and upgrade to module permission system

Features - User Management (Phase 4.1):
- Database: Add user_modules table for fine-grained module permissions
- Database: Add 4 user permissions (view/create/edit/delete) to role_permissions
- Backend: UserService (780 lines) - CRUD with tenant isolation
- Backend: UserController + UserRoutes (648 lines) - 13 API endpoints
- Backend: Batch import users from Excel
- Frontend: UserListPage (412 lines) - list/filter/search/pagination
- Frontend: UserFormPage (341 lines) - create/edit with module config
- Frontend: UserDetailPage (393 lines) - details/tenant/module management
- Frontend: 3 modal components (592 lines) - import/assign/configure
- API: GET/POST/PUT/DELETE /api/admin/users/* endpoints

Architecture Upgrade - Module Permission System:
- Backend: Add getUserModules() method in auth.service
- Backend: Login API returns modules array in user object
- Frontend: AuthContext adds hasModule() method
- Frontend: Navigation filters modules based on user.modules
- Frontend: RouteGuard checks requiredModule instead of requiredVersion
- Frontend: Remove deprecated version-based permission system
- UX: Only show accessible modules in navigation (clean UI)
- UX: Smart redirect after login (avoid 403 for regular users)

Fixes:
- Fix UTF-8 encoding corruption in ~100 docs files
- Fix pageSize type conversion in userService (String to Number)
- Fix authUser undefined error in TopNavigation
- Fix login redirect logic with role-based access check
- Update Git commit guidelines v1.2 with UTF-8 safety rules

Database Changes:
- CREATE TABLE user_modules (user_id, tenant_id, module_code, is_enabled)
- ADD UNIQUE CONSTRAINT (user_id, tenant_id, module_code)
- INSERT 4 permissions + role assignments
- UPDATE PUBLIC tenant with 8 module subscriptions

Technical:
- Backend: 5 new files (~2400 lines)
- Frontend: 10 new files (~2500 lines)
- Docs: 1 development record + 2 status updates + 1 guideline update
- Total: ~4900 lines of code

Status: User management 100% complete, module permission system operational
This commit is contained in:
2026-01-16 13:42:10 +08:00
parent 98d862dbd4
commit 66255368b7
560 changed files with 70424 additions and 52353 deletions

View File

@@ -1,43 +1,43 @@
# AI蝘𤑳<EFBFBD><EFBFBD><EFBFBD>鈭批<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>獢?(PRD)
# AI科研助手产品需求文档 (PRD)
> **<EFBFBD><EFBFBD>𧋦嚗?* v1.0
> **<EFBFBD>𥕦遣<EFBFBD><EFBFBD>嚗?* 2025-10-10
> **<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>** 甇<><E79487><EFBFBD>?
> **版本:** v1.0
> **创建日期:** 2025-10-10
> **文档状态:** 正式版
---
## 📋 目录
1. [产品概述](#产品概述)
2. [<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>祕餈財(#<23><EFBFBD><E8A098><EFBFBD><EFBFBD>祕餈?
3. [<EFBFBD><EFBFBD>蝡臬<EFBFBD><EFBFBD>稽(#<23><EFBFBD>蝡臬<E89DA1><E887AC>?
4. [餈鞱𨯫蝡?<3F>𤾸蝱<F0A4BEB8><EFBFBD>](#餈鞱𨯫蝡臬<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
2. [功能需求详述](#功能需求详述)
3. [用户端功能](#用户端功能)
4. [运营端/后台功能](#运营端后台功能)
---
## 1. 产品概述
### 1.1 鈭批<EFBFBD><EFBFBD>隞?
### 1.1 产品简介
**AI蝘𤑳<EFBFBD><EFBFBD><EFBFBD>**<EFBFBD><EFBFBD>甈曆<EFBFBD>瘜其<EFBFBD>韏贝<EFBFBD>銝游<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𥪯犖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>硋像<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝟餃<EFBFBD><EFBFBD><EFBFBD>憭扯祗閮<EFBFBD><EFBFBD><EFBFBD><EFBFBD>I<EFBFBD><EFBFBD>雿橒<EFBFBD>銝箇<EFBFBD><EFBFBD>𥪜極雿𡏭<EFBFBD><EFBFBD>銁隞舘紋憸㗛<EFBFBD>㗇𥋘<EFBFBD><EFBFBD>䲮獢<EFBFBD>挽霈<EFBFBD><EFBFBD><EFBFBD>格𤣰<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵函<EFBFBD><EFBFBD><EFBFBD>蝔衤葉<EFBFBD>𣂷<EFBFBD>蝎曉<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝𡁶<EFBFBD>AI颲<EFBFBD>𨭌嚗峕秄<EFBFBD>刻圾<EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝔衤葉<EFBFBD>埈𧒄<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>䲮瘜訫郎<EFBFBD><EFBFBD>擃条<EFBFBD><EFBFBD>𤤿<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𥪜極雿𦦵<EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝舘捶<EFBFBD><EFBFBD>?
**AI科研助手**是一款专注于赋能临床及科研人员的智能化平台。它通过集成一系列基于大语言模型的AI智能体为科研工作者在从课题选择、方案设计、数据收集、论文撰写到最终发表的全流程中提供精准、高效、专业的AI辅助旨在解决科研过程中耗时耗力、信息壁垒、方法学门槛高等痛点全面提升科研工作的效率与质量。
### 1.2 目标用户
<EFBFBD>砍像<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝢支<EFBFBD><EFBFBD><EFBFBD>𡠺嚗?
本平台的核心用户群体包括:
**(1) 临床医生/科研人员**
- <EFBFBD><EFBFBD><EFBFBD>銁蝜<EFBFBD><EFBFBD><EFBFBD><EFBFBD>葩摨𠰴極雿靝<EFBFBD>雿辷<EFBFBD>擃䀹<EFBFBD><EFBFBD>撅閖<EFBFBD>韐券<EFBFBD>蝘穃郎<EFBFBD>𠉛弦<EFBFBD><EFBFBD>瓲敹<EFBFBD>犖蝢?
- 需要在繁忙的临床工作之余,高效开展高质量科学研究的核心人群
**(2) <EFBFBD>刻粉蝖?<3F>𡁜ㄚ<F0A1819C>𠉛弦<F0A0899B>?*
- <EFBFBD><EFBFBD><EFBFBD>𥪜郎銋𣳇𧫴畾蛛<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝𡁏<EFBFBD>撖澆<EFBFBD>擃䀹<EFBFBD>撌亙<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝛嗉紋憸䀝<EFBFBD>瘥蓥<EFBFBD>霈箸<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
**(2) 在读硕/博士研究生**
- 在科研学习阶段,需要专业指导和高效工具来完成研究课题与毕业论文的学生
**(3) <EFBFBD>餉晓隡<EFBFBD><EFBFBD><EFBFBD>𥪜<EFBFBD>鈭箏<EFBFBD>嚗㇌&D嚗?*
**(3) 医药企业研发人员R&D**
- 从事新药研发、临床试验等工作,需要快速获取文献信息、设计研究方案的专业人士
### 1.3 产品目标
**(1) 撌亙<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?*
- <EFBFBD><EFBFBD><EFBFBD>憟𡑒<EFBFBD><EFBFBD>碶葩摨羓<EFBFBD>蝛嗆瓲敹<EFBFBD><EFBFBD>蝔讠<EFBFBD>AI<EFBFBD><EFBFBD>雿枏極<EFBFBD><EFBFBD>嚗諹圾<EFBFBD>喟鍂<EFBFBD>瑕銁<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝛嗉挽霈<EFBFBD>霈箸<EFBFBD><EFBFBD><EFBFBD><EFBFBD>嗆挾<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>瘙?
**(1) 工具集覆盖**
- 打造一套覆盖临床研究核心流程的AI智能体工具集解决用户在选题、研究设计及论文写作阶段的关键需求
**(2) 交互优化**
- 优化人机交互体验,确保用户可以低门槛、便捷地使用各项功能
@@ -46,49 +46,49 @@
- 发展成为科研领域内领先的一站式AI解决方案平台
**(4) 未来规划**
- <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>惩抅鈭𤾸之閫<EFBFBD>芋嚗?000蝭<30><EFBFBD><E8AA91><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E8AE83><EFBFBD><EFBFBD><E7A194><EFBFBD><EFBFBD><EFBFBD><E68092><EFBFBD>摰寞<E691B0><E5AF9E>𣇉<EFBFBD>撌乩<E6928C>
- 后期考虑增加基于大规模1000篇以内文献的读取、识别、内容提取的工作
---
## 2. <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>祕餈?(Functional Requirements)
## 2. 功能需求详述 (Functional Requirements)
### 2.1 <EFBFBD><EFBFBD>蝡臬<EFBFBD><EFBFBD>?
### 2.1 用户端功能
#### 2.1.1 <EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗𡁻★<EFBFBD>?霂暸<E99C82>蝞∠<E89D9E> (Context Persistence)
#### 2.1.1 核心功能:项目/课题管理 (Context Persistence)
銝箄圾<EFBFBD>喟鍂<EFBFBD><EFBFBD><EFBFBD><EFBFBD>憭滩<EFBFBD><EFBFBD><EFBFBD><EFBFBD>臭縑<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>仿★<EFBFBD><EFBFBD>蝞∠<EFBFBD>嚗𣬚靽𨆯I撖寡<EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝𧢲<EFBFBD>餈噼敞<EFBFBD><EFBFBD>?
为解决用户需要反复输入背景信息的问题引入项目制管理确保AI对话的上下文连贯性。
**<EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?*
**基础功能:**
**(1) 憿寧𤌍<EFBFBD>𥕦遣銝𡒊恣<EFBFBD>?*
- <EFBFBD><EFBFBD><EFBFBD>臭誑<EFBFBD>𥕦遣<EFBFBD><EFBFBD><EFBFBD>颲穃<EFBFBD><EFBFBD>𣳇膄銝滚<EFBFBD><EFBFBD>?憿寧𤌍"<22>?霂暸<E99C82>"
**(1) 项目创建与管理**
- 用户可以创建、编辑和删除不同的"项目"或"课题"
**(2) 项目背景信息预设**
- <EFBFBD><EFBFBD>銝芷★<EFBFBD>桐葉嚗𣬚鍂<EFBFBD>瑕虾隞仿<EFBFBD><EFBFBD><EFBFBD><EFBFBD>亥砲憿寧𤌍<EFBFBD><EFBFBD>瓲敹<EFBFBD><EFBFBD><EFBFBD>臭縑<EFBFBD>?
- 在每个项目中,用户可以预先填入该项目的核心背景信息
**(3) 銝𠹺<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?*
**(3) 上下文自动关联**
- 在特定项目内发起的所有AI智能体对话都将自动继承该项目的背景信息
**动态背景信息管理:**
**(1) 宏观编辑**
- <EFBFBD>券★<EFBFBD>桐蜓憿蛛<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>孵稬蝻𤥁<EFBFBD><EFBFBD>厰僼嚗<EFBFBD>銁撘孵枂<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝剖笆憿寧𤌍<EFBFBD>峕艶靽⊥<EFBFBD>餈𥡝<EFBFBD><EFBFBD>券𢒰<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵𣬚<EFBFBD>蝻𤥁<EFBFBD>銝𦒘耨<EFBFBD>?
- 在项目主页,用户可通过点击编辑按钮,在弹出的模态框中对项目背景信息进行全面的、多行的编辑与修改
**(2) 微观追加**
- <EFBFBD>券★<EFBFBD><EFBFBD><EFBFBD><EFBFBD>笆霂苷葉嚗𣬚鍂<EFBFBD>瑕虾撠<EFBFBD>I<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝑䈑<EFBFBD><EFBFBD>ICOS獢<EFBFBD><EFBFBD><EFBFBD>瓲敹<EFBFBD><EFBFBD>霈箇<EFBFBD>嚗厰<EFBFBD><EFBFBD>"<22><EFBFBD>"<22><EFBFBD>嚗䔶<E59A97><E494B6>株蕭<E6A0AA><EFBFBD>敶枏<E695B6>憿寧𤌍<E5AFA7><F0A48C8D><EFBFBD><EFBFBD>臭縑<E887AD>臭葉嚗<E89189><E59A97><EFBFBD>圈★<E59C88>桐縑<E6A190><EFBFBD><E88890><EFBFBD><E586BD><EFBFBD>餈?
- 在项目内的对话中用户可将AI生成的关键回答如PICOS框架、核心结论等通过"固定"操作,一键追加到当前项目的背景信息中,实现项目信息的动态演进
---
#### 2.1.2 <EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗鋫I<EFBFBD><EFBFBD>雿?(Agent)
#### 2.1.2 核心功能AI智能体 (Agent)
AI<EFBFBD><EFBFBD>雿𤘪糓鈭批<EFBFBD><EFBFBD><EFBFBD>瓲敹<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>臭誑<EFBFBD><EFBFBD>隞乩<EFBFBD>銝斤<EFBFBD>銝餉<EFBFBD>頝臬<EFBFBD>銝擧惣<EFBFBD><EFBFBD>餈𥡝<EFBFBD>鈭支<EFBFBD>嚗?
AI智能体是产品的核心,用户可以通过以下两种主要路径与智能体进行交互:
**鈭支<EFBFBD>頝臬<EFBFBD>嚗?*
**交互路径:**
**1. <EFBFBD><EFBFBD>敹恍<EFBFBD>罸䔮蝑?(Global Quick Chat)**
- <EFBFBD><EFBFBD><EFBFBD>舐凒<EFBFBD>亙銁銝餌<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>㗇惣<EFBFBD><EFBFBD>嚗𣬚鍂鈭𤾸<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>憿寧𤌍<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>甈⊥<EFBFBD>折䔮憸?
**1. 全局快速问答 (Global Quick Chat)**
- 用户可直接在主界面访问所有智能体,用于处理与特定项目无关的一次性问题
**2. 憿寧𤌍<EFBFBD><EFBFBD>楛摨衣<EFBFBD>蝛?(In-Project Deep Research)**
**2. 项目内深度研究 (In-Project Deep Research)**
- 用户进入一个具体的"项目/课题"空间后调用智能体,所有对话将自动继承该项目的背景信息
---
@@ -97,146 +97,146 @@ AI智能体是产品的核心用户可以通过以下两种主要路径与智
##### 选题阶段
**<EFBFBD>?<3F><EFBFBD><EFBFBD><EFBFBD><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* 隞𤾸<E99A9E><F0A4BEB8><EFBFBD><EFBFBD><E689BC>葩摨𠹺遠<F0A0B9BA><EFBFBD><E6BDA6><EFBFBD>摮行<E691AE><EFBFBD><E689B9><EFBFBD><E888AA><EFBFBD>蝏游漲嚗<E6BCB2><EFBFBD><EFBFBD><E586BD>𣂼枂<F0A382BC><E69E82>葩摨𢠃䔮憸䁅<E686B8><EFBFBD><E98AB5><EFBFBD><EFBFBD>隞瘀<E99A9E>撟嗆<E6929F>靘𥕦<E99D98>甇亦<E79487>SWOT<EFBFBD><EFBFBD><EFBFBD>
- **颲枏<EFBFBD>嚗?* <20><EFBFBD>颲枏<E9A2B2><E69E8F><EFBFBD>葩摨𢠃䔮憸䀹<E686B8>餈堆<E9A488><E5A086>芰眏<E88AB0><E79C8F>𧋦嚗㚁<E59A97><E39A81><EFBFBD><E887AC>娪★<E5A8AA><EFBFBD><E6A0AA>?
- **颲枏枂嚗?* 蝏𤘪<E89D8F><F0A498AA>𣇉<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E59A97><EFBFBD><EFBFBD><E680A0><EFBFBD><EFBFBD><E689BC>葩摨𠹺遠<F0A0B9BA><EFBFBD><E6BDA6><EFBFBD>摮行<E691AE><EFBFBD><E689BC>虾銵峕<E98AB5><EFBFBD><E689B9>𣂼<EFBFBD>蝏澆<E89D8F>撱箄悅
**① 选题评价智能体**
- **功能描述:** 从创新性、临床价值、科学性和可行性等维度,对用户提出的临床问题进行全面评价,并提供初步的SWOT分析
- **输入:** 用户输入的临床问题描述(自由文本),可关联项目背景
- **输出:** 结构化的评价报告,包含创新性、临床价值、科学性、可行性分析及综合建议
**<EFBFBD>?蝘穃郎<E7A983><EFBFBD>璇喟<E79287><E5969F><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* 颲<>𨭌<EFBFBD><EFBFBD><EFBFBD><E692A0>銝芣芋蝟𦠜<E89D9F>摰賣<E691B0><E8B3A3><EFBFBD><EFBFBD>蝛嗆<E89D9B>瘜𤏪<E7989C><F0A48FAA><EFBFBD><E99E9F>𣂷<EFBFBD>銝芣<E98A9D><E88AA3><EFBFBD><E5959C><EFBFBD>雿瓐<E99BBF><E79390>虾撉諹<E69289><E8ABB9><EFBFBD><EFBFBD>摮阡䔮憸?
- **颲枏<EFBFBD>嚗?* 銝<>銝芸<E98A9D>甇亦<E79487><E4BAA6>𠉛弦<F0A0899B><EFBFBD><EFBFBD><E59A97>"<22>𠉛弦<F0A0899B>𣳇<EFBFBD><F0A3B387>𣬚黎銝擧<E98A9D><E693A7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝟?
- **颲枏枂嚗?* 憭帋葵蝎曄<E89D8E><E69B84>𡒊<EFBFBD>蝘穃郎<E7A983><EFBFBD><E6A185>厰★嚗䔶<E59A97><E494B6><EFBFBD><E586BD>㗇𥋘<E39787><EFBFBD><E7A18B>?
**② 科学问题梳理智能体**
- **功能描述:** 辅助用户将一个模糊或宽泛的研究想法,提炼成一个清晰、具体、可验证的科学问题
- **输入:** 一个初步的研究想法,如"研究肠道菌群与抑郁症的关系"
- **输出:** 多个精炼后的科学问题选项,供用户选择或参考
##### 研究设计阶段
**<EFBFBD>?PICOS<EFBFBD><EFBFBD><EFBFBD><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* 撘訫紡<E8A8AB><EFBFBD><E586BD><EFBFBD>PICOS<4F><EFBFBD><E7AC94><EFBFBD><E4BAA6><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銋劐葩摨羓<E691A8>蝛嗥<E89D9B><E597A5><EFBFBD><EFBFBD><E996AC>
- **颲枏<EFBFBD>嚗?* 撘訫紡撘讛”<E8AE9B><EFBFBD><E99699>芰眏<E88AB0><E79C8F>𧋦<EFBFBD>讛膩<E8AE9B><E886A9><EFBFBD>蝛園䔮憸?
- **颲枏枂嚗?* 銝<>銝芣<E98A9D><E88AA3><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ICOS銵冽聢嚗峕<E59A97><E5B395><EFBFBD><E595A3><EFBFBD>憿孵<E686BF>雿枏<E99BBF>摰?
**PICOS构建智能体**
- **功能描述:** 引导用户按照PICOS原则来结构化地定义临床研究的核心要素
- **输入:** 引导式表单或自由文本描述的研究问题
- **输出:** 一个标准化的PICOS表格清晰列出各项具体内容
**<EFBFBD>?閫<><E996AB><EFBFBD><EFBFBD><EFBFBD>霈曇恣<E69B87><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* <20><EFBFBD><E7AE94>𠉛弦霈曇恣<E69B87><E681A3><EFBFBD><EFBFBD>𨅯<EFBFBD>蝟鳴<E89D9F>銝箇鍂<E7AE87><EFBFBD><E7919E>𠉛弦<F0A0899B><EFBFBD><E588BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝餉<E98A9D><E9A489><EFBFBD>活閬<E6B4BB><E996AC>摰匧<E691B0><E58CA7><EFBFBD><EFBFBD><E69296><EFBFBD><EFBFBD><EFBFBD>
- **颲枏<EFBFBD>嚗?* 撌脩摰𡁶<E691B0>PICOS獢<53><EFBFBD>𣇉<EFBFBD>蝛園䔮憸?
- **颲枏枂嚗?* <20><><EFBFBD><EFBFBD><E7919A><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銋剹<E98A8B><E589B9><EFBFBD><EFBFBD>𤩺䲮瘜訫遣霈桃<E99C88><EFBFBD><E79A9C>
**④ 观察指标设计智能体**
- **功能描述:** 基于研究设计和因果关系,为用户的研究推荐合适的主要、次要及安全性观察指标集
- **输入:** 已确定的PICOS框架或研究问题
- **输出:** 包含具体指标、定义、测量方法建议的清单
**<EFBFBD>?CRF<EFBFBD><EFBFBD><EFBFBD><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* <20><EFBFBD><E7AE94>𠉛弦<F0A0899B><EFBFBD><E5AF9E><EFBFBD><EFBFBD><E69296><EFBFBD><EFBFBD><EFBFBD><EFBFBD>芸𢆡<E88AB8><F0A286A1><EFBFBD><EFBFBD>隞賜<E99A9E><E8B39C><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E6B3B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵剁<E98AB5>CRF嚗㗇<E59A97><E39787>?
- **颲枏<EFBFBD>嚗?* <20>𠉛弦<F0A0899B><EFBFBD><E5AF9E><EFBFBD><EFBFBD><EFBFBD><E69296><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
- **颲枏枂嚗?* 銝<>隞賢虾銝贝蝸<E8B49D><E89DB8>RF獢<46><EFBFBD>厩阮嚗<E998AE><E59A97>Word/Excel<EFBFBD><EFBFBD>嚗?
**CRF制定智能体**
- **功能描述:** 基于研究方案和观察指标自动生成一份结构化、符合规范的病例报告表CRF框架
- **输入:** 研究方案、观察指标清单
- **输出:** 一份可下载的CRF框架草稿Word/Excel格式)
**<EFBFBD>?<3F>瑟𧋦<E7919F>讛恣蝞埈惣<E59F88><EFBFBD>**
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* <20>寞旿<E5AF9E>𠉛弦蝐餃<E89D90><E9A483><EFBFBD><EFBFBD>撉峕偌<E5B395><E5818C><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E288AA><E6BCB2><EFBFBD>摨娪<E691A8>蝑㗇瓲敹<E793B2><E695B9><EFBFBD><EFBFBD><E5A086>𣂷<EFBFBD>蝘穃郎<E7A983><E9838E><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>隡啁<E99AA1>蝏𤘪<E89D8F>
- **颲枏<EFBFBD>嚗?* 撘訫紡撘讛”<E8AE9B><EFBFBD><E99697><EFBFBD>蝛嗉挽霈<E99C88><EFBD9E><EFBFBD><E6999E><EFBFBD><E884AF><EFBFBD>摨娪<E691A8>蝑?
- **颲枏枂嚗?* 霂衣<E99C82><E8A1A3><EFBFBD><EFBFBD><EFBFBD>霈∠<E99C88>蝏𤘪<E89D8F><EFBFBD><E59A97><EFBFBD><EFBFBD>撘譌<E69298><E8AD8C><EFBFBD><EFBFBD>啗秩<E59597>𤾸<EFBFBD><F0A4BEB8><EFBFBD><EFBFBD>遣霈格甅<E6A0BC><EFBFBD>
**⑥ 样本量计算智能体**
- **功能描述:** 根据研究类型、检验水准、把握度、效应量等核心参数,提供科学合理的样本量估算结果
- **输入:** 引导式表单输入研究设计、α、β、效应量等
- **输出:** 详细的样本量计算结果,包含公式、参数说明和最终建议样本量
**<EFBFBD>?銝游<E98A9D><E6B8B8>𠉛弦<F0A0899B><EFBFBD><E5AF9E><EFBFBD><E595A3><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* <20><EFBFBD>蝘穃郎<E7A983><EFBFBD><E6A185><EFBFBD>ICOS蝑劐縑<E58A90><EFBFBD><E88D94>芸𢆡<E88AB8><F0A286A1><EFBFBD><EFBFBD>隞賢<E99A9E>甇乩<E79487>蝏𤘪<E89D8F>摰峕㟲<E5B395><E39FB2>葩摨羓<E691A8>蝛嗉挽霈⊥䲮獢?
- **颲枏<EFBFBD>嚗?* 撌脩摰𡁶<E691B0>蝘穃郎<E7A983><EFBFBD><E6A185><EFBFBD>ICOS<4F><53><EFBFBD><EFBFBD>蝑?
- **颲枏枂嚗?* 銝<>隞賢<E99A9E><E8B3A2><EFBFBD>蝛嗉<E89D9B><E59789><EFBFBD><E883AF>𤌍<EFBFBD><F0A48C8D><EFBFBD><EFBFBD>挽霈<E99C88><EFBD9E><EFBFBD>蝔讠<E89D94>蝡㰘<E89DA1><E3B098><EFBFBD>ord<72><64><EFBFBD>萘阮
**⑦ 临床研究方案撰写智能体**
- **功能描述:** 基于科学问题、PICOS等信息自动生成一份初步但结构完整的临床研究设计方案
- **输入:** 已确定的科学问题、PICOS、样本量等
- **输出:** 一份包含研究背景、目的、设计、流程等章节的Word文档初稿
##### 论文阶段
**<EFBFBD>?霈箸<E99C88>瘨西𠧧<E8A5BF><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* <20><><EFBFBD><EFBFBD>銝𠹺<E98A9D><F0A0B9BA><EFBFBD>阮隞塚<E99A9E><E5A19A>𣂷<EFBFBD>銝㮖<E98A9D>蝥抒<E89DA5>霂剛<E99C82>瘨西𠧧嚗䔶耨甇<E880A8>祗瘜𨰻<E7989C><F0A8B0BB>𣄽<EFBFBD><EFBFBD>銵刻噢<E588BB><EFBFBD>
- **颲枏<EFBFBD>嚗?* 銝𠹺<E98A9D><F0A0B9BA><EFBFBD><EFBFBD><E68D8F>阮隞塚<E99A9E>Word/Text嚗㚁<E59A97><E39A81><EFBFBD><E6A0BC><EFBFBD><E7AC94>滨妍嚗<E5A68D><EFBFBD><EFBFBD>
- **颲枏枂嚗?* 銝<>隞賢蒂靽株恥<E6A0AA><E681A5><EFBFBD><E68987><EFBFBD><EFBFBD><E884A3><EFBFBD><EFBFBD>𠹺耨<F0A0B9BA><EFBFBD><EFBFBD><EFBFBD>?
**⑧ 论文润色智能体**
- **功能描述:** 针对用户上传的稿件,提供专业级的语言润色,修正语法、拼写和表达方式
- **输入:** 上传的论文稿件Word/Text目标期刊名称可选
- **输出:** 一份带修订标记的润色后文稿及修改摘要说明
**<EFBFBD>?霈箸<E99C88>蝧餉<E89DA7><E9A489><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* <20>𣂷<EFBFBD>銝㮖<E98A9D><E3AE96><EFBFBD><EFBFBD><E7A7BB><EFBFBD>銝剛㘚鈭坿<E988AD><E59DBF>滚𦛚嚗𣬚鸌<F0A3AC9A><EFBFBD>撖孵龫摮衣<E691AE><E8A1A3><EFBFBD><E5A8AA><EFBFBD><E6AFBA>航祗餈𥡝<E9A488>隡睃<E99AA1>
- **颲枏<EFBFBD>嚗?* 銝𠹺<E98A9D><F0A0B9BA><EFBFBD><EFBFBD><E68D8F>阮隞塚<E99A9E>Word/Text嚗㚁<E59A97><E39A81>㗇𥋘皞鞱祗閮<E7A597><E996AE>𣬚𤌍<F0A3AC9A><F0A48C8D>祗閮<E7A597>
- **颲枏枂嚗?* 蝧餉<E89DA7>摰峕<E691B0><E5B395><EFBFBD>阮隞塚<E99A9E>靽萘<E99DBD><E89098><EFBFBD>聢撘?
**⑨ 论文翻译智能体**
- **功能描述:** 提供专业、精准的中英互译服务,特别针对医学科研领域的术语进行优化
- **输入:** 上传的论文稿件Word/Text选择源语言和目标语言
- **输出:** 翻译完成的稿件,保留原格式
**<EFBFBD>?<3F><EFBFBD>摮西<E691AE>摰⊥惣<E28AA5><EFBFBD>**
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* 隞𡒊<E99A9E>蝛園䔮憸塩<E686B8><E5A1A9>䲮獢<E4B2AE>挽霈<E99C88><EFBD9E><EFBFBD><EFBFBD>賢虾銵峕<E98AB5><EFBFBD>銝游<E98A9D><E6B8B8><EFBFBD>蝑厩輕摨佗<E691A8>撖寧<E69296>蝛嗆䲮獢<E4B2AE><E78DA2>霈箸<E99C88>餈𥡝<E9A488><F0A5A19D>券𢒰<E588B8><F0A292B0>䲮瘜訫郎霂<E9838E>
- **颲枏<EFBFBD>嚗?* 銝𠹺<E98A9D><F0A0B9BA><EFBFBD><EFBFBD>蝛嗆䲮獢<E4B2AE><E78DA2>霈箸<E99C88>蝔蹂辣
- **颲枏枂嚗?* 銝<>隞質<E99A9E>摰⊥𥁒<E28AA5>𠺪<EFBFBD><F0A0BAAA><EFBFBD><EFBFBD><EFBFBD>堒枂<E5A092><EFBFBD>摮虫<E691AE><E899AB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E5AB98><EFBFBD><EFBFBD>函撩<E587BD><EFBFBD><E79195><EFBFBD>撱箄悅
**⑩ 方法学评审智能体**
- **功能描述:** 从研究问题、方案设计、实施可行性和临床意义等维度,对研究方案或论文进行全面的方法学评审
- **输入:** 上传的研究方案或论文稿件
- **输出:** 一份评审报告,分点列出方法学上的优点、潜在缺陷及改进建议
**<EFBFBD>?<3F><EFBFBD><E7AC94><EFBFBD>摮西<E691AE>摰⊥惣<E28AA5><EFBFBD>**
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* 璅⊥<E79285><E28AA5><EFBFBD>摰∠阮鈭箄<E988AD>閫𡜐<E996AB><F0A19C90><EFBFBD><EFBFBD>閧阮<E996A7><E998AE><EFBFBD>銝剖虾<E58996><EFBFBD><E8B3A2><EFBFBD>蝏蠘恣摮艾<E691AE><E889BE>䲮瘜訫郎<E8A8AB><EFBFBD>餈𥡝<E9A488><F0A5A19D>鞾䔮<E99EBE><EFBFBD><E5B395>?
- **颲枏<EFBFBD>嚗?* 銝𠹺<E98A9D><F0A0B9BA><EFBFBD><EFBFBD><E68D8F>阮隞塚<E99A9E><E5A19A><EFBFBD><E6A0BC><EFBFBD>
- **颲枏枂嚗?* 銝<>隞賣芋<E8B3A3><EFBFBD>"摰∠阮<E288A0><EFBFBD>"嚗<><E59A97><EFBFBD>箏虾<E7AE8F>質◤<E8B3AA><EFBFBD><E78390><EFBFBD>䔮憸条<E686B8>
**⑪ 期刊方法学评审智能体**
- **功能描述:** 模拟期刊审稿人视角,针对投稿文章中可能存在的统计学、方法学问题进行提问和挑战
- **输入:** 上传的论文稿件,目标期刊
- **输出:** 一份模拟的"审稿意见",列出可能被挑战的问题点
**<EFBFBD>?<3F><EFBFBD>蝔輻漲霂<E6BCB2><EFBFBD><EFBFBD>雿?*
- **<EFBFBD><EFBFBD><EFBFBD>讛膩嚗?* 靘脲旿<E884B2><EFBFBD><E6A0BC><EFBFBD><E7AC94><EFBFBD><EFBFBD>蝔輯<E89D94><EFBFBD><E79899><EFBFBD>芸𢆡璉<F0A286A1><E79289><EFBFBD>蝡惩銁<E683A9><EFBFBD><E6BE86><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E5959C><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E6A0AA><EFBFBD><EFBFBD><EFBFBD>寥𢒰<E5AFA5>臬炏蝚血<E89D9A><E8A180><EFBFBD><EFBFBD>
- **颲枏<EFBFBD>嚗?* 銝𠹺<E98A9D><F0A0B9BA><EFBFBD><EFBFBD><E68D8F>阮隞塚<E99A9E><E5A19A><EFBFBD><E6A0BC><EFBFBD><E7AC94><EFBFBD><EFBFBD>蝔踵<E89D94><E8B8B5>?
- **颲枏枂嚗?* 銝<>隞賣聢撘誩恣<E8AAA9>交𥁒<E4BAA4>𠺪<EFBFBD><EFBFBD><EFBFBD>堒枂<E5A092><E69E82><EFBFBD><EFBFBD>蝚血<E89D9A>憿孵<E686BF>靽格㺿撱箄悅
**⑫ 期刊稿约评审智能体**
- **功能描述:** 依据目标期刊的投稿要求,自动检查文章在格式、字数、参考文献规范等方面是否符合标准
- **输入:** 上传的论文稿件,目标期刊的投稿指南
- **输出:** 一份格式审查报告,清晰列出所有不符合项和修改建议
---
**<EFBFBD>冽惣<EFBFBD><EFBFBD>撖寡<EFBFBD>銝剔<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?*
**在智能体对话中的重点功能:**
**(1) 模型即时切换**
- 在对话界面用户可随时通过下拉菜单切换当前对话所使用的大语言模型如Gemini, DeepSeek等以应对不同任务
- <EFBFBD><EFBFBD><EFBFBD>㗇𥋘璅<EFBFBD><EFBFBD><EFBFBD>蝏剖笆霂萘眏<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>钅店<EFBFBD>?
- 用户选择模型,后续对话由新选定的模型驱动
**(2) 临时附件上传**
- <EFBFBD>典笆霂肽<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>靘𥕢<EFBFBD>隡䭾<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝𠹺<EFBFBD>銝湔𧒄<EFBFBD><EFBFBD>辣嚗<EFBFBD><EFBFBD>PDF, Word嚗劐<E59A97>AI餈𥡝<E9A488><EFBFBD>甈⊥<E79488><EFBFBD><E689B9><EFBFBD><E58390><EFBFBD><EFBFBD><E9A48C>𤥁<EFBFBD>摰?
- <EFBFBD><EFBFBD>銝𠹺<EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝芣<EFBFBD>隞?
- AI<EFBFBD><EFBFBD>霂仿<EFBFBD>隞嗅<EFBFBD>摰寡<EFBFBD><EFBFBD><EFBFBD>蝑?
- 在对话输入框旁提供上传按钮支持用户上传临时文件如PDF, Word供AI进行一次性分析、总结或评审
- 用户上传的单个文件
- AI基于该附件内容进行回答
**(3) <EFBFBD><EFBFBD>摨栞<EFBFBD><EFBFBD><EFBFBD>笆霂?* 潃?
- <EFBFBD>其遙雿訫笆霂萘<EFBFBD><EFBFBD><EFBFBD>葉嚗𣬚鍂<EFBFBD>瑕虾<EFBFBD>𤩺𧒄<EFBFBD><EFBFBD>"@"<22><EFBFBD><EFBFBD>鍂銝芯犖<E88AAF><EFBFBD>摨㮖葉<E3AE96><E89189><EFBFBD>蝐鳴<E89D90>霈呸I隡睃<E99AA1><E79D83><EFBFBD><E7AE94><EFBFBD><EFBFBD><EFBFBD>摰孵<E691B0>蝑?
**(3) 知识库融合对话** ⭐
- 在任何对话窗口中,用户可随时通过"@"操作调用个人知识库中的分类让AI优先基于所选内容回答
- 示例:`@骨质疏松专题`
- 颲枏枂嚗朞<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𡁶鍂<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝑?
- 输出:融合了私有知识和通用知识的回答
**(4) 蝑娍<EFBFBD>皞舀<EFBFBD>銝𤾸<EFBFBD><EFBFBD>?*
- 敶𨯗I<EFBFBD><EFBFBD>撘閧鍂<EFBFBD>芯葵鈭箇䰻霂<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>孵稬<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>霈?
- <EFBFBD><EFBFBD>銝剖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>雿滨蔭<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
**(4) 答案溯源与引用**
- 当AI回答引用自个人知识库时必须生成清晰、可点击的引用标记
- 回答中包含指向源文档具体位置的引用
**(5) 撖寡<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?*
**(5) 对话内追加背景**
- 在项目对话中提供将AI回答"固定"到项目背景的功能
- 用户点击"固定"按钮
- 霂交辺<EFBFBD><EFBFBD>鋡怨蕭<EFBFBD><EFBFBD>憿寧𤌍<EFBFBD>讛膩銝?
- 该条回答被追加到项目描述中
**(6) 历史对话管理**
- <EFBFBD>芸𢆡靽嘥<EFBFBD><EFBFBD><EFBFBD><EFBFBD>匧笆霂肽扇敶𤏪<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>函𡠺蝡讠<EFBFBD>"<22><>蟮霈啣<E99C88>"憿菟𢒰銝剛<E98A9D>銵峕䰻<E5B395><EFBFBD><E58D9D><EFBFBD><E89D9D>蝑偦<E89D91>?
- 自动保存所有对话记录,支持用户在独立的"历史记录"页面中进行查看、搜索和筛选
---
#### 2.1.3 核心功能:个人知识库 (Personal Knowledge Base)
銝芯犖<EFBFBD><EFBFBD>摨𤘪糓<EFBFBD><EFBFBD>銝枏<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝞∠<EFBFBD>銝剖<EFBFBD><EFBFBD>?
个人知识库是用户专属的、私密的知识管理中心。
**(1) <EFBFBD><EFBFBD>𣇉恣<EFBFBD>?*
**(1) 层级化管理**
- 采用两级结构进行管理
- **第一级:** 知识库列表,用户可在此创建、编辑知识库分类
- **蝚砌<EFBFBD>蝥改<EFBFBD>** <20><EFBFBD>摨栞祕<E6A09E><E7A595>△嚗𣬚鍂<F0A3AC9A><EFBFBD><E7919E><EFBFBD>銝芰䰻霂<E4B0BB><E99C82><EFBFBD>𠬍<EFBFBD><F0A0AC8D>舀䰻<E88880><EFBFBD>蝞∠<E89D9E>霂亙<E99C82><E4BA99><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>隞?
- **第二级:** 知识库详情页,用户点击某个知识库后,可查看和管理该库内的所有文件
**(2) <EFBFBD><EFBFBD>﹝銝𠹺<EFBFBD>銝𤾸<EFBFBD><EFBFBD>?*
**(2) 文档上传与处理**
- 支持在知识库详情页上传多种格式的文档
**(3) <EFBFBD><EFBFBD>﹝憭<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𤩺<EFBFBD><EFBFBD>?*
- 瘥譍遢銝𠹺<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>摨娍<EFBFBD><EFBFBD>𡒊<EFBFBD><EFBFBD>𠶖<EFBFBD><EFBFBD><EFBFBD>霂?
- <EFBFBD><EFBFBD><EFBFBD><EFBFBD>**"憭<><E686AD>銝?**<2A>?*"撌脣停蝏?**<2A>?*"憭<><E686AD>憭梯揖"**
**(3) 文档处理状态透明化**
- 每份上传的文档都应有明确的状态标识
- 状态:**"处理中"**、**"已就绪"**、**"处理失败"**
**(4) 失败原因提示**
- 若文档处理失败,系统需向用户提供清晰的原因说明
**(5) 在对话中使用**
- <EFBFBD><EFBFBD><EFBFBD>冽惣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝哨<EFBFBD><EFBFBD>臭誑<EFBFBD><EFBFBD><EFBFBD>𥕦遣<EFBFBD><EFBFBD>葵鈭箇䰻霂<EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵屸䔮蝑?
- 用户在智能体问答过程中,可以基于创建的个人知识库来进行问答
---
#### 2.1.4 <EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗𡁜<EFBFBD><EFBFBD>脰扇敶?(History)
#### 2.1.4 核心功能:历史记录 (History)
<EFBFBD>𣂷<EFBFBD><EFBFBD>銝芰𡠺蝡讠<EFBFBD>憿嗥漣<EFBFBD><EFBFBD><EFBFBD>亙藁嚗𣬚鍂鈭𡒊恣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>匧笆霂腈<EFBFBD>?
提供一个独立的顶级功能入口,用于管理用户的所有对话。
**(1) 统一列表**
- 按时间倒序展示用户所有的对话记录
**(2) 来源标识**
- 瘥𤩺辺霈啣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?<3F><EFBFBD>敹恍<E695B9>罸䔮蝑?餈䀹糓<E480B9><EFBFBD><E7919A><EFBFBD><EFBFBD>銝?憿寧𤌍"
- 每条记录都清晰标识其来源是"全局快速问答"还是具体的某个"项目"
**(3) <EFBFBD>𦦵揣銝𡒊<EFBFBD><EFBFBD>?*
**(3) 搜索与筛选**
- 提供强大的搜索框
- <EFBFBD><EFBFBD><EFBFBD>厰★<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𠯫<EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵𣬚<EFBFBD><EFBFBD>?
- 撣桀𨭌<EFBFBD><EFBFBD>敹恍<EFBFBD><EFBFBD>雿滚<EFBFBD><EFBFBD>脣笆霂?
- 支持按项目、智能体、日期范围进行筛选
- 帮助用户快速定位历史对话
---
#### 2.1.5 辅助功能 (Support)
**(1) 敹恍<EFBFBD><EFBFBD><EFBFBD>?*
**(1) 快速上手**
- 在侧边栏提供独立入口
- 点击后展示产品核心功能引导和使用教程
@@ -246,30 +246,30 @@ AI智能体是产品的核心用户可以通过以下两种主要路径与智
---
### 2.2 餈鞱𨯫蝡?<3F>𤾸蝱<F0A4BEB8><EFBFBD>
### 2.2 运营端/后台功能
#### (1) 隞芾”<EFBFBD>?
#### (1) 仪表盘
**核心数据概览**
- 隞亙㦛銵典耦撘誩<EFBFBD>蝷箏<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
- <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𡠺嚗?
- 以图表形式展示关键运营指标
- 指标包括:
- 今日活跃用户
- 7<EFBFBD>交暑頝<EFBFBD><EFBFBD>?
- 7日活跃用户
- 总用户数
- 今日对话数等
- <EFBFBD><EFBFBD>嚗𡁏䲮靘輯<EFBFBD><EFBFBD>乩犖<EFBFBD>睃翰<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𠶖<EFBFBD>?
- 目的:方便运营人员快速了解产品状态
---
#### (2) <EFBFBD><EFBFBD>雿梶恣<EFBFBD>?
#### (2) 智能体管理
**<EFBFBD><EFBFBD>雿枏<EFBFBD>銵?*
- 隞亙<EFBFBD>銵典耦撘誩<EFBFBD>蝷箸<EFBFBD><EFBFBD><EFBFBD>蝡臬虾<EFBFBD><EFBFBD>AI<EFBFBD><EFBFBD>雿?
- <EFBFBD><EFBFBD>銝𠹺<EFBFBD>蝥踵<EFBFBD>雿?
**智能体列表**
- 以列表形式展示所有前端可用的AI智能体
- 支持上下线操作
---
#### (3) <EFBFBD><EFBFBD>雿㯄<EFBFBD>蝵?
#### (3) 智能体配置
**配置管理**
- 管理员可新增、编辑智能体
@@ -279,8 +279,8 @@ AI智能体是产品的核心用户可以通过以下两种主要路径与智
#### (4) Prompt管理
**<EFBFBD><EFBFBD><EFBFBD><EFBFBD>** 潃?
- 蝞∠<EFBFBD><EFBFBD>睃虾銝箸<EFBFBD>銝芣惣<EFBFBD><EFBFBD>蝎曄<EFBFBD><EFBFBD>硋𧑐靚<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>頂蝏毺漣<EFBFBD>鞟內霂㵪<EFBFBD>System Prompt嚗?
**核心功能**
- 管理员可为每个智能体精细化地调试和优化其背后的系统级提示词(System Prompt
- 支持版本管理
- **重要性:** 这是保障智能体专业性的关键
@@ -288,27 +288,27 @@ AI智能体是产品的核心用户可以通过以下两种主要路径与智
#### (5) 模型管理
**<EFBFBD><EFBFBD><EFBFBD>銝𡡞<EFBFBD>蝵?*
- 蝞∠<EFBFBD><EFBFBD>𤾸蝱<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝐餃之霂剛<EFBFBD><EFBFBD><EFBFBD><EFBFBD>Gemini, DeepSeek嚗?
**模型接入与配置**
- 管理后台接入的各类大语言模型(如Gemini, DeepSeek
- 可配置:
- API密钥
- 调用参数
- <EFBFBD>舐鍂/蝳<><EFBFBD><EFBFBD>?
- 启用/禁用状态
---
#### (6) 用户管理
**<EFBFBD><EFBFBD><EFBFBD>𡑒”銝擧<EFBFBD>蝝?*
- <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>厩鍂<EFBFBD>瑚縑<EFBFBD>?
- 靽⊥<EFBFBD><EFBFBD><EFBFBD>𡠺嚗䥑D<EFBFBD><EFBFBD><EFBFBD><EFBFBD>箏噡/<2F>桃拳<E6A183><E68BB3><EFBFBD>峕𧒄<E5B395><EFBFBD><E6B0AC>𠶖<EFBFBD>?
- <EFBFBD><EFBFBD>憭𡁏辺隞嗆<EFBFBD>蝝?
**用户列表与检索**
- 查看所有用户信息
- 信息包括ID、手机号/邮箱、注册时间、状态
- 支持多条件搜索
**韐行<EFBFBD>霂行<EFBFBD>銝擧<EFBFBD>雿?*
- 蝞∠<EFBFBD><EFBFBD>睃虾<EFBFBD><EFBFBD><EFBFBD>蓥葵<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
- <EFBFBD><EFBFBD>銵𣬚<EFBFBD><EFBFBD><EFBFBD>嚗?
- 霈曄蔭/撱園鵭霂閧鍂<E996A7>?
- <EFBFBD>舐鍂<EFBFBD>𣇉<EFBFBD><EFBFBD>刻揭<EFBFBD>?
**账户详情与操作**
- 管理员可查看单个用户的详情
- 可进行的操作:
- 设置/延长试用期
- 启用或禁用账户
- 查看操作日志
---
@@ -316,8 +316,8 @@ AI智能体是产品的核心用户可以通过以下两种主要路径与智
#### (7) 数据统计
**用户行为统计**
- <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蒈敶訫<EFBFBD><EFBFBD>脰扇敶𤏪<EFBFBD><EFBFBD><EFBFBD><EFBFBD>園𡢿嚗?
- <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>甈∠<EFBFBD>霈∴<EFBFBD><EFBFBD><EFBFBD><EFBFBD>峕惣<EFBFBD><EFBFBD>嚗?
- 查看用户的登录历史记录(登录时间)
- 各个核心功能的使用频次统计(如不同智能体)
- 目的:帮助分析用户偏好和功能热度
---
@@ -325,14 +325,14 @@ AI智能体是产品的核心用户可以通过以下两种主要路径与智
#### (8) 对话管理
**用户历史对话查看**
- <EFBFBD>𩤃<EFBFBD> **<EFBFBD><EFBFBD>嚗?* <20><>撱箇<E692B1>銝交聢<E4BAA4><E881A2><EFBFBD><EFBFBD>𣂼<EFBFBD>蝥?
- 霈輸䔮<EFBFBD>∩辣嚗?
- ⚠️ **重要:** 需建立严格的权限分级
- 访问条件:
- 只有在处理用户申诉或技术排障时
- <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>擃条漣蝞∠<EFBFBD><EFBFBD>?
- 由授权的高级管理员
- 在获得审批后
- 才能查看经过脱敏和屏蔽隐私信息的对话数据
**摰匧<EFBFBD>銝𡡞<EFBFBD><EFBFBD><EFBFBD>?*
**安全与隐私强化**
- 所有查看行为必须记录在案,以备审计
---
@@ -341,13 +341,13 @@ AI智能体是产品的核心用户可以通过以下两种主要路径与智
### 版本变更记录
| <EFBFBD><EFBFBD>𧋦 | <20><EFBFBD> | <20>䀹凒<E480B9><E58792>捆 | 靽格㺿鈭?|
| 版本 | 日期 | 变更内容 | 修改人 |
|------|------|---------|--------|
| v1.0 | 2025-10-10 | 初始版本从TXT转换为MD格式 | 项目团队 |
### 相关文档
- [<EFBFBD>唳旿摨栞挽霈⊥<EFBFBD>獢β(../01-霈曇恣<E69B87><E681A3>﹝/<2F>唳旿摨栞挽霈⊥<E99C88>獢?md)
- [数据库设计文档](../01-设计文档/数据库设计文档.md)
- [API设计规范](../01-设计文档/API设计规范.md)
- [核心业务规则](../03-业务规则/核心业务规则总览.md)
- [用户端原型图](../01-设计文档/用户端原型图.html)

View File

@@ -1,76 +1,86 @@
# **憯寡<EFBFBD>敺芰<EFBFBD><EFBFBD><EFBFBD> \- AI蝘𤑳<E89D98>鈭批<E988AD><E689B9><EFBFBD><EFBFBD><E79899>獢?(PRD)**
# **壹证循科技 \- AI科研产品需求文档 (PRD)**
文档版本: 1.0
<EFBFBD><EFBFBD>: 2025撟?1<>?<3F>?
<EFBFBD><EFBFBD> 鈭批<E988AD><E689B9><EFBFBD><E585B7><EFBFBD><EFBFBD><EFBFBD><E7B2B9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E6A185><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E888AB>𠰴<EFBFBD>雿枏<E99BBF>隞?
日期: 2025年11月5日
致: 产品部、市场部、销售部、技术部及全体同仁
## **1\. 文档目的**
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>獢?(Product Requirements Document, PRD) <EFBFBD>典銁皜<EFBFBD>苊摰帋<EFBFBD><EFBFBD>𨅯ㄨ霂<EFBFBD>儐蝘烐<EFBFBD>AI蝘𤑳<EFBFBD>鈭批<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𤌍<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>喲睸<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD>糓頝券<EFBFBD><EFBFBD><EFBFBD>雿𦦵<EFBFBD><EFBFBD>箇𨺗嚗𣬚鍂鈭𡒊靽脲<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>挽霈∩<EFBFBD><EFBFBD>㦤蝑𣇉裦靽脲<EFBFBD>擃睃漲銝<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>撖寞<EFBFBD>隞砍<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>函蔡<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
## **2\. 鈭批<E988AD><E689B9>踵艶銝𡒊𤌍<F0A1928A>?*
本需求文档 (Product Requirements Document, PRD) 旨在清晰定义“壹证循科技AI科研产品”的核心功能、目标用户及关键的非功能性需求。
本文档是跨部门协作的基石,用于确保技术实现、产品设计与市场策略保持高度一致,特别是应对我们复杂的商业模式和多样的客户部署需求。
## **2\. 产品愿景与目标**
产品愿景:
打造一个覆盖临床科研全生命周期、AI驱动的一站式智能科研平台。
核心目标:
赋能临床医生和科研人员通过AI与自动化工具极大地提升科研效率、数据处理质量和文献分析深度缩短从数据到洞察的周期。
鈭批<EFBFBD><EFBFBD>踵艶嚗?
<EFBFBD><EFBFBD><EFBFBD>銝芾<EFBFBD><EFBFBD>碶葩摨羓<EFBFBD><EFBFBD>𥪜<EFBFBD><EFBFBD>笔𦶢<EFBFBD><EFBFBD><EFBFBD><EFBFBD>I撽勗𢆡<EFBFBD><EFBFBD><EFBFBD>蝡坔<EFBFBD><EFBFBD><EFBFBD>蝘𤑳<EFBFBD>撟喳蝱<EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?
韏贝<EFBFBD>銝游<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𣬚<EFBFBD><EFBFBD>𥪯犖<EFBFBD><EFBFBD><EFBFBD><EFBFBD>AI銝舘䌊<EFBFBD><EFBFBD>撌亙<EFBFBD>嚗峕<EFBFBD>憭批𧑐<EFBFBD>𣂼<EFBFBD>蝘𤑳<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>瘛勗漲嚗𣬚憬<EFBFBD><EFBFBD><EFBFBD>唳旿<EFBFBD><EFBFBD>撖毺<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
## **3\. 目标用户画像 (User Personas)**
1. **銝游<EFBFBD><EFBFBD><EFBFBD>/<2F>𠉛弦<F0A0899B>?*嚗?
* **<EFBFBD><EFBFBD>**嚗帋<E59A97><E5B88B>脣龫<E884A3><EFBFBD>蝘穃恕銝颱遙<E9A2B1><E98199>蜓瘝餃龫撣<E9BEAB><E692A3><EFBFBD><EFBFBD>蝛嗥<E89D9B><E597A5>?
* **<EFBFBD>𤤿<EFBFBD>**嚗𡁏<E59A97>蝘𤑳<E89D98>憿寧𤌍嚗<F0A48C8D><E59A97><EFBFBD>質䌊<E8B3AA><EFBFBD><E5979A>CP<43><50><EFBFBD>憿暹<E686BF><EFBFBD>蝛塚<E89D9B><E5A19A><EFBFBD>嚗䔶<E59A97>銝游<E98A9D>撌乩<E6928C><EFBFBD><E89D9C>嚗𣬚撩銋譍<E98A8B>銝𡁶<E98A9D><E99C88><E288AA>唳旿憭<E697BF><E686AD><EFBFBD>園𡢿<E59C92>?
* **<EFBFBD><EFBFBD>瘙?*嚗𡁻<E59A97><EFBFBD><E996AC>𨅯<EFBFBD>蝞勗朖<E58B97><EFBFBD><EFBFBD>撌亙<E6928C><EFBFBD><EFBFBD><EFBFBD><E7AC94><EFBFBD><EFBFBD><E5A0BA><EFBFBD><EFBFBD><E69FB4><EFBFBD><EFBFBD><EFBFBD><E99E89><EFBFBD><E69FB4><EFBFBD><EFBFBD><EFBFBD><E99C88><EFBD9E><EFBFBD>躰捏<E8BAB0><E68D8F><EFBFBD>?*<2A><><EFBFBD><EFBFBD>單釣<E596AE><E987A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E89D98>摰匧<E691B0>**<2A>?
2. **<EFBFBD>駁堺蝘穃恕/IT<49>券秄**嚗?
* **<EFBFBD><EFBFBD>**嚗𡁜龫<F0A1819C><EFBFBD>蝘𤑳<E89D98>蝞∠<E89D9E>蝘穃恕<E7A983><E68195><EFBFBD>臭葉敹<E89189><E695B9>?
* **<EFBFBD>𤤿<EFBFBD>**嚗𡁻<E59A97><EFBFBD><EFBFBD>券堺<E588B8>𣂷<EFBFBD><F0A382B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝘𤑳<E89D98>撌亙<E6928C>嚗𥕦<E59A97><F0A595A6>𤤿<EFBFBD><F0A4A4BF>娍㺭<E5A88D><EFBFBD>撠文<E692A0><E69687>浹IS<49><53>IS<49>唳旿嚗劐<E59A97><E58A90>坔銁<E59D94><EFBFBD><EFBCB7>?
* **<EFBFBD><EFBFBD>瘙?*嚗𡁻<E59A97>韐剔<E99F90>撌亙<E6928C><EFBFBD><EFBFBD><EFBFBD>**蝘<><E89D98><EFBFBD><EFBFBD>蝵?*嚗䔶<E59A97>摰匧<E691B0><E58CA7><EFBFBD>迅摰𠾼<E691B0><F0A0BEBC><EFBFBD>鈭𡒊恣<F0A1928A><E681A3><EFBFBD>?
## **4\. <20><EFBFBD><E8A9A8><EFBFBD><E8A098><EFBFBD>瘙?(Functional Requirements)**
1. **临床医生/研究者**
* **画像**:三甲医院的科室主任、主治医师、研究生。
* **痛点**有科研项目如国自然、GCP、回顾性研究压力但临床工作繁忙缺乏专业统计和数据处理时间。
* **需求**:需要“开箱即用”的工具,快速处理院内数据、分析文献、完成统计、撰写论文。**极其关注患者数据隐私与安全**。
2. **医院科室/IT部门**
* **画像**:医院的科研管理科室、信息中心。
* **痛点**需要为全院提供合规、可控的科研工具希望科研数据尤其是HIS、LIS数据保留在院内。
* **需求**:采购的工具必须支持**私有化部署**,且安全、稳定、易于管理。
## **4\. 核心功能需求 (Functional Requirements)**
产品功能矩阵共分为7大核心模块共同构成科研全流程闭环。
鈭批<EFBFBD><EFBFBD><EFBFBD><EFBFBD>拚猐<EFBFBD><EFBFBD>銝?憭扳瓲敹<E793B2><EFBFBD><EFBFBD><E6A2B9><EFBFBD><E58B97><EFBFBD><EFBFBD>蝘𤑳<E89D98><F0A491B3><EFBFBD>蝔钅𡡒<E99285><EFBFBD>?
| 模块ID | 模块名称 | 核心功能描述 |
| :---- | :---- | :---- |
| **F1** | **<EFBFBD><EFBFBD>蝏蠘恣<EFBFBD><EFBFBD><EFBFBD> (SSA)** | <EFBFBD>𣂷<EFBFBD>3<EFBFBD>⊥瓲敹<EFBFBD><EFBFBD><EFBFBD>鞱楝敺<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𠉛弦<EFBFBD><EFBFBD><EFBFBD>瘚𧢲芋<EFBFBD><EFBFBD><EFBFBD>CT<EFBFBD>𠉛弦<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>唳旿銝𠹺<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𣂼<EFBFBD><EFBFBD><EFBFBD>撖澆枂<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝔卝<EFBFBD>?|
| **F2** | **蝏蠘恣<EFBFBD><EFBFBD><EFBFBD>撌亙<EFBFBD> (ST)** | <EFBFBD>𣂷<EFBFBD><EFBFBD>銝芸<EFBFBD><EFBFBD>?00+蝘滩蝠<E6BBA9><EFBFBD>蝏蠘恣撌亙<E6928C><E4BA99><EFBFBD><EFBFBD>瑞拳嚗峕說頞喳朖<E596B3><EFBFBD><E5979A><EFBFBD><EFBFBD><EFBFBD><E8AEA0><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E79899>?|
| **F3** | **AI<EFBFBD><EFBFBD><EFBFBD><EFBFBD> (AIA)** | <EFBFBD>𣂷<EFBFBD>10+銝芯<E98A9D>銝鋫I<E98BAB><EFBFBD>雿橒<E99BBF><EFBFBD><E996AC>蝘𤑳<E89D98><F0A491B3>喲睸<E596B2><E79DB8><EFBFBD>嚗𡁻<E59A97><EFBFBD><EFBFBD><EFBFBD><E981A0>ICO璇喟<E79287><E5969F><EFBFBD><EFBFBD><EFBFBD>霈∠<E99C88><E288A0><EFBFBD><EFBFBD>蝛嗆䲮獢<E4B2AE><E78DA2>摰𠾼<E691B0><F0A0BEBC><EFBFBD>蝡䭾隋<E4ADBE><EFBFBD>蝧餉<E89DA7>蝑剹<E89D91>?|
| **F4** | **AI<EFBFBD><EFBFBD><EFBFBD><EFBFBD> (ASL)** | <EFBFBD>𣂷<EFBFBD>AI撽勗𢆡<EFBFBD><EFBFBD><EFBFBD><EFBFBD>桀極雿𨀣<EFBFBD>嚗𡁏惣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>憸䀹<EFBFBD><EFBFBD><EFBFBD>蝑䜘<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝑䜘<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>撟嗆𣈲<EFBFBD><EFBFBD>eta<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>桀㦛靚梁<EFBFBD>摨𠉛鍂<EFBFBD>?|
| **F5** | **銝芯犖<EFBFBD><EFBFBD>摨?(PKB)** | <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𥕦遣蝘<EFBFBD><EFBFBD><EFBFBD>讃摨橒<EFBFBD><EFBFBD><EFBFBD>銝芸<EFBFBD>50蝭<EFBFBD><EFBFBD><EFBFBD><EFBFBD>賢抅鈭𤾸<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵淾I<EFBFBD><EFBFBD>嚗㇌AG嚗剹<EFBFBD>?|
| **F6** | **<EFBFBD>唳旿皜<EFBFBD><EFBFBD><EFBFBD><EFBFBD> (DC)** | **(<EFBFBD><EFBFBD><EFBFBD><EFBFBD>)** <20>𣂷<EFBFBD>銝㮖<E98A9D>撌亙<E6928C><EFBFBD><E59A97><EFBFBD><EFBFBD><EFBFBD><EFBCB7><EFBFBD>瘚琿<E7989A><EFBFBD>蓡銝<E893A1><E98A9D>蝥改<E89DA5><E694B9><EFBFBD><EFBFBD>銵冽聢嚗?0+撘𩤃<E69298><F0A9A483><EFBFBD>xcel<65>唳旿嚗<E697BF><E59A97><EFBFBD>唬舅憭批<E686AD><E689B9><EFBFBD> 1\. **銵冽聢ETL**嚗𡁜<E59A97>憭𡁜<E686AD><F0A1819C><EFBFBD><EFBFBD><E5839A><EFBFBD>瘞渲”嚗峕<E59A97><E5B395>𨀣<EFBFBD><F0A880A3><EFBFBD>D<EFBFBD><EFBFBD><E598A5>𨀣𧒄<F0A880A3><EFBFBD><EFBFBD><EFBFBD>蛹銝<E89BB9>撘惩僕<E683A9><E58395><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𣂼捐銵具<E98AB5>?2\. **<EFBFBD><EFBFBD>𧋦<EFBFBD>𣂼<EFBFBD>(NER)**嚗帋<E59A97><E5B88B><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E4BA99><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝏梶<E89D8F>憭扳挾<E689B3><E68CBE>𧋦銝哨<E98A9D><E593A8>芸𢆡<E88AB8>𣂼<EFBFBD>蝏𤘪<E89D8F><F0A498AA>𣇉<EFBFBD><F0A38789>喲睸摮埈挾嚗<E68CBE><E59A97>TNM<4E><4D><EFBFBD>嚗剹<E59A97>?|
| **F7** | **銝芯犖銝剖<EFBFBD> (UAM)** | <EFBFBD>𣂷<EFBFBD>韐行<EFBFBD>蝞∠<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>砌縑<EFBFBD><EFBFBD><EFBFBD><EFBFBD>拐葉敹<EFBFBD><EFBFBD><EFBFBD><EFBFBD>閧恣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?|
| **F1** | **智能统计分析 (SSA)** | 提供3条核心分析路径队列研究、预测模型、RCT研究。实现从数据上传、质控、分析到报告导出的完整流程。 |
| **F2** | **统计分析工具 (ST)** | 提供一个包含100+种轻量化统计工具的工具箱,满足即时、小型的分析需求。 |
| **F3** | **AI智能回答 (AIA)** | 提供10+个专业AI智能体覆盖科研关键节点选题评价、PICO梳理、样本量计算、研究方案制定、文章润色与翻译等。 |
| **F4** | **AI智能文献 (ASL)** | 提供AI驱动的文献工作流智能检索、标题摘要初筛、全文复筛、信息提取并支持Meta分析、证据图谱等应用。 |
| **F5** | **个人知识库 (PKB)** | 允许用户创建私人文献库如每个库50篇并能基于库内文献进行AI问答RAG|
| **F6** | **数据清洗整理 (DC)** | **(核心难点)** 提供专业工具处理医院导出的海量百万行级、多表格10+张的Excel数据实现两大功能 1\. **表格ETL**将多张散乱的流水表按“患者ID”和“时间”重组为一张干净的分析宽表。 2\. **文本提取(NER)**从病理报告、住院小结等大段文本中自动提取结构化的关键字段如TNM分期|
| **F7** | **个人中心 (UAM)** | 提供账户管理、版本信息、帮助中心、订单管理等基础支撑功能。 |
## **5\. <EFBFBD>喲睸<EFBFBD>𧼮<EFBFBD><EFBFBD><EFBFBD><EFBFBD>瘙?(Non-Functional Requirements)**
## **5\. 关键非功能性需求 (Non-Functional Requirements)**
餈蹱糓<EFBFBD>砌漣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>典嘀銝?*<2A><>憭齿<E686AD><E9BDBF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>**<2A><><EFBFBD><EFBFBD><E79899><EFBFBD><EFBFBD><E88880>舀沲<E88880><E6B2B2><EFBFBD>憿餉圾<E9A489><EFBFBD><E5969F>喲睸<E596B2><EFBFBD><E78390>?
### **NFR-1: <20>函蔡璅<E79285><E288AA>菜暑<E88F9C>?(Deployment Flexibility)**
这是本产品在商业推广中**最复杂、最核心**的需求,是技术架构必须解决的关键挑战。
鈭批<EFBFBD><EFBFBD><EFBFBD><EFBFBD>隞乩<EFBFBD><EFBFBD>𤤿<EFBFBD><EFBFBD>函蔡敶<EFBFBD><EFBFBD><EFBFBD>隞交說頞喃<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>撠文<EFBFBD><EFBFBD>臬龫<EFBFBD><EFBFBD>撖寞㺭<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝亥<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
| <20>函蔡敶<E695B6>?| <20>讛膩 | <20>喲睸閬<E79DB8><E996AC> |
### **NFR-1: 部署模式灵活性 (Deployment Flexibility)**
产品必须支持以下四种部署形态,以满足不同客户(尤其是医院)对数据安全和合规性的严苛要求。
| 部署形态 | 描述 | 关键要求 |
| :---- | :---- | :---- |
| **鈭𤑳垢SaaS<EFBFBD>?* | (暺䁅恕) 鈭批<E988AD><E689B9>函蔡<E587BD><EFBFBD><E585B8><EFBFBD>嚗𣬚鍂<F0A3AC9A><EFBFBD><EFBFBD>瘚讛<E7989A><E8AE9B><EFBFBD><E586BD><EFBFBD><E99C88>雿輻鍂<E8BCBB>?| 敹<><EFBFBD><EFBFBD>憭𡁶<E686AD><F0A181B6><EFBFBD><E791AF><EFBFBD><EFBFBD>舐鍂<E88890>?|
| **<EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝵?* | (<28>駁堺/<2F><EFBFBD>) 撠?*<2A>港葵撟喳蝱**<EFBFBD>?*<2A><><EFBFBD><E79285>**嚗<><E59A97>DC, SSA嚗厰<E59A97>蝵脣銁摰<E691B0><EFBCB8><EFBFBD><EFBFBD>蝵烐<E89DB5><E78390>膥銝𨳍<E98A9D>?| 敹<><EFBFBD>𣂷<EFBFBD>摰孵膥<E5ADB5><EFBFBD>Docker/K8s嚗厩<E59A97><EFBFBD><E98A9D><EFBFBD>蝵脫䲮獢<E4B2AE><E78DA2><EFBFBD><EFBFBD>?00%銝滚枂<E6BB9A><E69E82><EFBFBD><EFBFBD>?|
| **瘛瑕<EFBFBD><EFBFBD>函蔡** | (<EFBFBD><EFBFBD><EFBFBD>硋恥<EFBFBD>? 摰<E691B0><EFBCB8><EFBFBD>蝵睲蝙<E79DB2><EFBFBD>𦦵<EFBFBD><F0A6A6B5><EFBFBD><E58CA7><EFBFBD>DC/SSA璅<E79285><EFBFBD><E59A97><EFBFBD><EFBFBD><EFBFBD><EFBFBD>睲賑<E79DB2><EFBFBD>蝡胼<E89DA1><EFBFBD>ASL/AIA璅<E79285><E288AA>?| 撟喳蝱敹<E89DB1><EFBFBD><EFBFBD>餈嗵<E9A488><E597B5>𨀣𧋦<F0A880A3>?鈭𤑳垢<F0A491B3><EFBFBD>瘛瑕<E7989B><EFBFBD>鍂璅<E79285><EFBFBD><E59A97>蝡舫<E89DA1><E888AB><EFBFBD>頝舐眏<E88890>?|
| **<EFBFBD>閙㦤<EFBFBD>?* | (銝芯犖<E88AAF><EFBFBD>) <20>𣂷<EFBFBD>**<2A><EFBFBD><EFBFBD><E98B86>獢屸𢒰摨𠉛鍂(Windows/Mac)**嚗屸<E59A97>撖道C<E98193><43>SA<53><41>SL蝑㗇瓲敹<E793B2><EFBFBD>𨰜<EFBFBD>?| **<EFBFBD>唳旿100%<25>砍𧑐<E7A08D>?*<2A><><EFBFBD><EFBFBD><EFBFBD><E69FB4><EFBFBD>靘见<E99D98>憪𧢲<E686AA>隞嗡艇蝳<E88987><E89DB3>隡𨬭<E99AA1><F0A8ACAD><EFBFBD>憿餅𣈲<E9A485><F0A388B2>氖蝥輯<E89DA5>銵䕘<E98AB5><EFBFBD>C, SSA嚗剹<E59A97>?*(靘见<E99D98>嚗鋫SL璅<E79285><E288AA><EFBFBD><E887AC><EFBFBD><E689AF><EFBFBD>蝡烊LM嚗䔶<E59A97><EFBFBD><E99A9E><EFBFBD><EFBFBD><E785BE><EFBFBD>𨀣<EFBFBD><EFBFBD><E996AC><EFBFBD><EFBFBD><E5B1B8>𨅯<EFBFBD><F0A885AF><EFBFBD><EFBFBD>?* |
| **云端SaaS** | (默认) 产品部署在公有云,用户通过浏览器按需订阅使用。 | 必须支持多租户、高可用。 |
| **私有化部署** | (医院/机构) 将**整个平台**或**指定模块**如DC, SSA部署在客户的内网服务器上。 | 必须提供容器化Docker/K8s的一键部署方案。数据100%不出内网。 |
| **混合部署** | (私有化客户) 客户在内网使用“私有化”的DC/SSA模块同时能调用我们“云端”的ASL/AIA模块。 | 平台必须支持这种“本地+云端”的混合调用模式,前端需智能路由。 |
| **单机版** | (个人医生) 提供**可安装的桌面应用(Windows/Mac)**针对DC、SSA、ASL等核心模块。 | **数据100%本地化**。文献、病例原始文件严禁上传。必须支持离线运行如DC, SSA*(例外ASL模块可受控调用云端LLM但仅限发送“摘要”而非“原文”)* |
### **NFR-2: <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝵?(Commercial Flexibility)**
### **NFR-2: 商业模式可配置 (Commercial Flexibility)**
鈭批<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>㦤蝑𣇉裦<EFBFBD><EFBFBD><EFBFBD>瘣餅<EFBFBD><EFBFBD>?
1. **SaaS憭𡁶<E686AD><F0A181B6>?(Tiered SaaS)**
* **<EFBFBD><EFBFBD>瘙?*嚗帋<E59A97>蝡特aaS<61><53><EFBFBD>憿餅𣈲<E9A485><F0A388B2>秐撠睲<E692A0>銝芰<E98A9D>蝥改<E89DA5>**銝㮖<E98A9D><E3AE96><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝥抒<E89DA5><E68A92><EFBFBD><EFBFBD><EFBFBD><EFBFBD>**<2A>?
* **摰䂿緵**嚗𡁜<E59A97>蝡舫<E89DA1><E888AB><EFBFBD><EFBFBD><E691B0><EFBFBD><EFBFBD>*\*<2A><EFBFBD><EFBFBD><E69298>?Feature Flag)\*\*蝟餌<E89D9F>嚗諹<E59A97><E8ABB9><EFBFBD><E58EA9><EFBFBD><E7A587>嗥鍂<E597A5>瑕虾<E79195><EFBFBD><E587BD><EFBFBD><E79285><E288AA><EFBFBD><EFBFBD>冽活<E586BD><EFBFBD><E5959C>I璅<E79285>蝑剹<E89D91>?
2. **<EFBFBD><EFBFBD>硋睸<EFBFBD>?(Modular Sales)**
* **<EFBFBD><EFBFBD>瘙?*嚗帋遙雿蓥<E99BBF>銝芸<E98A9D><E88AB8>賣芋<E8B3A3><EFBFBD><EFBFBD>4: AI<41><EFBFBD><E7AE84><EFBFBD>讃嚗厰<E59A97>**敹<><EFBFBD>?*鋡怎𡠺蝡𧢲<E89DA1><F0A7A2B2><EFBFBD><EFBFBD>雿靝蛹<E99D9D>閧𡠺<E996A7><F0A1A0BA><EFBFBD><E6BCA3><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
* **摰䂿緵**嚗𡁏<E59A97><F0A1818F>舀沲<E88880><E6B2B2><EFBFBD>憿餅糓<E9A485>𨀣𠹭<F0A880A3><EFBFBD><E8A180><EFBFBD>嚗𣬚靽脲芋<E884B2>烾𡢿瘝⊥<E7989D>蝖砌<E89D96>韏硔<E99F8F>?
产品架构必须支持销售和市场策略的灵活性。
1. **SaaS多版本 (Tiered SaaS)**
* **需求**云端SaaS版必须支持至少三个等级**专业版、高级版、旗舰版**。
* **实现**:后端需具备完善的\*\*功能开关(Feature Flag)\*\*系统能按版本限制用户可用的功能模块、使用次数、AI模型等。
2. **模块化售卖 (Modular Sales)**
* **需求**任何一个功能模块如F4: AI智能文献都**必须能**被独立打包,作为单独的产品进行售卖。
* **实现**:技术架构必须是“松耦合”的,确保模块间没有硬依赖。
3. **AI成本可控 (Configurable AI)**
* **<EFBFBD><EFBFBD>瘙?*嚗帋蛹摨𥪜笆銝滚<E98A9D><E691B0><EFBCB8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E7A586>笔漲嚗<E6BCB2><EFBFBD><EFBFBD>憿餅𣈲<E9A485>?*<2A><EFBFBD><E586BD><EFBFBD><EFBFBD>?*<2A>𡒊垢<F0A1928A><E59EA2>之霂剛<E99C82><E79285><E288AA>?
* **摰䂿緵**嚗帋<E59A97><EFBFBD><E68692>銝㮖<E98A9D><E3AE96><EFBFBD><EFBFBD><EFBFBD>霈方<E99C88><E696B9><EFBFBD><E586BD><EFBFBD>雿𡒊<E99BBF>DeepSeek嚗峕<E59A97><E5B395><EFBFBD><E59581><EFBFBD><E586BD><EFBFBD><E888AA>冽凒擃䁅捶<E48185><EFBFBD>Claude<64>𨰦PT<50>?
* **需求**:为应对不同客户的成本敏感度,平台必须支持**动态切换**后端的大语言模型。
* **实现**例如专业版用户默认调用成本较低的DeepSeek旗舰版用户可调用更高质量的Claude或GPT。
### **NFR-3: 平台与性能 (Platform & Performance)**
1. **撟喳蝱<EFBFBD>澆捆<EFBFBD>?*嚗?
* Web<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>厩緵隞<EFBFBD><EFBFBD><EFBFBD>膥嚗㇃hrome, Edge, Firefox, Safari嚗剹<EFBFBD>?
* <EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> **Windows 10 (64雿?<3F>𠹺誑銝?* <20>?**macOS (Intel & Apple Silicon)**<EFBFBD>?
* **<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝖桐<EFBFBD><EFBFBD><EFBFBD>**嚗帋蛹靽肽<E99DBD>鈭批<E988AD>蝔喳<E89D94><E596B3><EFBFBD><E689B9>唳旿摰匧<E691B0><EFBFBD><E59A97><EFBFBD><EFBFBD>**銝齿𣈲<E9BDBF>?*隞颱<E99A9E>32雿齿<E99BBF>雿𦦵頂蝏笔<E89D8F>Windows 7蝑匧歇<E58CA7>𨀣迫<F0A880A3>滚𦛚<E6BB9A><F0A69B9A>頂蝏麄<E89D8F>?
2. **<EFBFBD>唳旿憭<EFBFBD><EFBFBD><EFBFBD><EFBFBD> (DC璅<E79285>)**嚗?
* 鈭批<EFBFBD><EFBFBD><EFBFBD>嗆糓<EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>賜迅摰𡁜<EFBFBD><EFBFBD><EFBFBD>蓡銝<EFBFBD><EFBFBD>蝥批<EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵汞xcel<EFBFBD>唳旿嚗?*銝亦<E98A9D>**<2A><EFBFBD>摮䀹滯<E480B9><EFBFBD><E7AE84><EFBFBD><EFBFBD>摨誩援皞<E68FB4><E79A9E>?
* 鈭批<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>峕㺭<EFBFBD>格𧒄嚗<EFBFBD><EFBFBD>餈賣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>摰峕<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
3. **<EFBFBD><EFBFBD>𧋦<EFBFBD>𣂼<EFBFBD>韐券<EFBFBD> (DC璅<E79285>)**嚗?
* 鈭批<EFBFBD><EFBFBD><EFBFBD><EFBFBD>靘偦<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>餃郎<EFBFBD><EFBFBD>𧋦<EFBFBD>𣂼<EFBFBD><EFBFBD>?
* **<EFBFBD>滚𦛚<EFBFBD><EFBFBD><EFBFBD><EFBFBD>隡䁅圾嚗?*嚗𡁜<E59A97>雿輻鍂SOTA嚗<41><E59A97><EFBFBD>屸▲撠吔<E692A0><E59094><EFBFBD>LM嚗<4D><E59A97>Claude 3嚗劐誑靽肽<E99DBD><E882BD><EFBFBD>擃䁅捶<E48185><EFBFBD>?
* **<EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD>憒亙<EFBFBD><EFBFBD><EFBFBD>**嚗帋蛹靽肽<E99DBD><E882BD>唳旿<E594B3><EFBFBD><EFBFBD><E59A97>憿颱蝙<E9A2B1>?00%<25>砍𧑐餈鞱<E9A488><E99EB1><EFBFBD>LP璅<E79285><EFBFBD><E59A97>spaCy嚗㚁<E59A97><E39A81><EFBFBD><E585B6><EFBFBD><EFBFBD><E89D98><EFBFBD>齿<EFBFBD>銝见偷<E8A781>𥟇<EFBFBD>擃睃<E69383>蝖桃<E89D96><E6A183>
1. **平台兼容性**
* Web必须支持所有现代浏览器Chrome, Edge, Firefox, Safari)。
* 单机版:必须支持 **Windows 10 (64位)及以上****macOS (Intel & Apple Silicon)**
* **【重点】明确不支持**:为保证产品稳定性和数据安全,单机版**不支持**任何32位操作系统及Windows 7等已停止服务的系统。
2. **数据处理性能 (DC模块)**
* 产品尤其是单机版必须能稳定处理百万行级别的多表Excel数据**严禁**因内存溢出而导致程序崩溃。
* 产品(服务器版)在处理相同数据时,应追求极致效率,在数分钟内完成处理。
3. **文本提取质量 (DC模块)**
* 产品必须能提供高准确率的医学文本提取。
* **服务器版(最优解)**应使用SOTA业界顶尖的LLM如Claude 3以保证最高质量。
* **单机版(妥协解)**为保证数据隐私必须使用100%本地运行的NLP模型如spaCy在保护隐私的前提下尽力提高准确率。

View File

@@ -2,199 +2,233 @@
## **1\. 执行摘要 (Executive Summary)**
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𨅯ㄨ霂<EFBFBD>儐蝘烐<EFBFBD><EFBFBD>𨆯I蝘𤑳<EFBFBD>鈭批<EFBFBD>憟𦯀辣<EFBFBD>𣂷<EFBFBD><EFBFBD><EFBFBD>銝芰<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>舀沲<EFBFBD><EFBFBD>䲮獢<EFBFBD><EFBFBD>?
**<EFBFBD><EFBFBD><EFBFBD>条裦**嚗𡁻<E59A97><F0A181BB>沔*\*<2A>𨀣<EFBFBD>餈𥕦<E9A488><F0A595A6><EFBFBD><E59786>?*<2A><>誑**<2A>𨀣芋<F0A880A3><EFBFBD><E5A092><EFBFBD><E893A5>?*嚗㇈odular Monolith嚗匧鍳<E58CA7><EFBFBD>敹恍<E695B9>蠘翮隞<E7BFAE><E99A9E>撟嗡蛹<E597A1>芣䔉<E88AA3>?*<2A>𨅯凝<F0A885AF>滚𦛚<E6BB9A>𩄼*\*嚗㇈icroservices嚗㗇沲<E39787><E6B2B2><EFBFBD>撟單<E6929F><EFBFBD><EFBFBD>𡁜末<F0A1819C><E69CAB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
**<EFBFBD><EFBFBD><EFBFBD><EFBFBD>**嚗?
1. **撟喳蝱銝𦒘漣<F0A69298><E6BCA3><EFBFBD>蝳?*嚗帋艇<E5B88B><EFBFBD><E6BE86><EFBFBD><EFBFBD>𨅯<EFBFBD><EFBFBD><E69285>𡁶鍂璅<E79285><E288AA><EFBFBD><EFBFBD><EFBFBD>瑚葉敹<E89189><E695B9><EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><E69285><EFBFBD>⊥芋<E28AA5><EFBFBD><EFBFBD><EFBFBD><E68692><E99C88><E288AA><EFBFBD><E7909C>?
2. **銝<>銝芣沲<E88AA3><E6B2B2><EFBFBD>憭𡁶<E686AD><F0A181B6>函蔡**嚗朞挽霈∩<E99C88>憟㛖<E6869F>瘣餌<E798A3><E9A48C><EFBFBD>嚗屸<E59A97><EFBFBD><E69C9E>𨅯捆<F0A885AF><EFBFBD><E585B8><EFBFBD><E598A5>𣈯<EFBFBD><EFBFBD><E9A489><EFBFBD><E6BBA8><EFBFBD><E59885>峕𧒄<E5B395><EFBFBD>**<EFBFBD><EFBFBD>蝡特aaS**<2A>?*<2A><E288AA><EFBFBD><EFBCB9><EFBFBD><E58CA7>函蔡**<2A>?*<2A><EFBCB8><E6AFBD><EFBFBD>蝵?*<2A>?*<2A><><EFBFBD>煺葵鈭箏<E988AD><E7AE8F><EFBFBD>**<2A>?
3. **<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Polyglot嚗?*嚗𡁻<E59A97><F0A181BB><EFBFBD>𦦵鍂<F0A6A6B5><E98D82><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>撌亙<E6928C><E4BA99>𡁏<EFBFBD><F0A1818F><EFBFBD><EFBFBD><EFBFBD><EFBFBD>鈭𦥑<E988AD><EFBFBD><E89098><EFBFBD><EFBFBD><E59A97>霈硼ode.js<6A><73><EFBFBD><EFBFBD>ython<6F><6E>ava蝑㗇<E89D91><E39787><EFBFBD><E88880>典凝<E585B8>滚𦛚<E6BB9A><EFBFBD>銝剖<E98A9D>摮塩<E691AE>?
**<2A><><EFBFBD>航楝敺?*嚗?
* **鈭𤑳垢/蝘<><E89D98><EFBFBD>?*嚗𡁻<E59A97><F0A181BB>?Docker(摰孵膥) \+ Kubernetes(蝻𡝗<E89DBB>) \+ API蝵穃<E89DB5> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>滚𦛚<E6BB9A>函蔡<E587BD><EFBFBD><E5AF9E>?
* **<2A>閙㦤<E99699>?*嚗𡁻<E59A97><F0A181BB>?**Electron** 獢<>沲嚗?*100%憭滨鍂<E6BBA8>滨垢UI隞<49><E99A9E>**嚗<><EFBFBD><EFBFBD> Node.js銝餉<E98A9D>蝔?\+ <20>砍𧑐摮鞱<E691AE>蝔?R/Python) <20><>䲮撘誯<E69298><EFBFBD><E89D8F>蝡舫<E89DA1><EFBFBD><EFBFBD><E59A97><EFBFBD>唳㺭<E594B3>?00%<25>砍𧑐<E7A08D><EFBFBD>?
本文档为“壹证循科技”AI科研产品套件提供了一个统一的技术架构方案。
**核心战略**:采用\*\*“演进式架构”**。以**“模块化单体”**Modular Monolith启动快速迭代并为未来向**“微服务”\*\*Microservices架构的平滑过渡做好充分准备。
**核心原则**
1. **平台与产品分离**:严格划分“底层通用模块”(如用户中心)和“上层业务模块”(如统计分析)。
2. **一个架构,多种部署**:设计一套灵活的架构,通过“容器化”和“逻辑重组”,同时支持**①云端SaaS**、**②医院私有化部署**、**③混合部署**和**④医生个人单机版**。
3. **技术异构Polyglot**采用“用最合适的工具做最合适的事”的原则允许Node.js、R、Python、Java等技术栈在微服务架构中共存。
**技术路径**
* **云端/私有化**:采用 Docker(容器) \+ Kubernetes(编排) \+ API网关 的标准微服务部署方案。
* **单机版**:采用 **Electron** 框架,**100%复用前端UI代码**,并通过 Node.js主进程 \+ 本地子进程(R/Python) 的方式重组后端逻辑实现数据100%本地化。
## **2\. 业务需求与架构挑战**
### **2.1 鈭批<EFBFBD><EFBFBD><EFBFBD><EFBFBD>拚猐 (7憭扳芋<E689B3>?**
### **2.1 产品功能矩阵 (7大模块)**
1. **智能统计分析 (SSA)**
2. **统计分析工具 (ST)**
3. **AI智能回答 (AIA)**
4. **AI智能文献 (ASL)**
5. **銝芯犖<EFBFBD><EFBFBD>摨?(PKB)**
5. **个人知识库 (PKB)**
6. **数据清洗整理 (DC)**
7. **个人中心 (UAM)**
### **2.2 复杂的商业与部署挑战**
1. **憭𡁶<EFBFBD><EFBFBD>?(SaaS)**嚗帋<E59A97>蝡舐<E89DA1><E88890><EFBFBD>蛹銝㮖<E98A9D><E3AE96><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝥抒<E89DA5><E68A92><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E59581>?
2. **<EFBFBD><EFBFBD>硋睸<EFBFBD>?*嚗帋遙雿閙芋<E99699><EFBFBD><EFBFBD>I<EFBFBD><EFBFBD><E7AE84><EFBFBD>讃嚗厰<E59A97><E58EB0><EFBFBD><E888AA><EFBFBD><E7A589><EFBFBD><E6A180>?
3. **<EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝵?*嚗𡁜龫<F0A1819C><EFBFBD><EFBFBD><E79899><EFBFBD>唳旿<E594B3>𤩺<EFBFBD><E79285><EFBFBD><E59A97>SSA<53><41>C嚗厰<E59A97>蝵脣銁<E884A3><E98A81><EFBFBD><EFBFBD>滚𦛚<E6BB9A><EFBFBD>?
4. **瘛瑕<EFBFBD><EFBFBD>函蔡**嚗𡁜龫<F0A1819C>𧋦<EFBCB8>唬蝙<E594AC>沒SA嚗<41><E59A97><EFBFBD><EFBFBD><EFBFBD>鍂鈭𤑳垢<F0A491B3><E59EA2>SL<53>?
5. **<EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD>蝵?*嚗𡁜龫<F0A1819C><EFBFBD><EFBFBD>銁銝芯犖<E88AAF><EFBFBD>(Windows/Mac)銝羓氖蝥輯<E89DA5>銵玺SA<53><41>C<EFBFBD><43>SL蝑㗇芋<E39787><EFBFBD>蝖桐<E89D96><E6A190>唳旿嚗<E697BF><E59A97><EFBFBD><EFBFBD><E69FB4><EFBFBD>靘页<E99D98>銝滚枂<E6BB9A>砍𧑐<E7A08D>?
## **3\. <20><EFBFBD><E8A9A8><EFBFBD>嚗鋫PI蝵穃<E89DB5> \+ 敺格<E695BA><E6A0BC>?*
1. **多版本 (SaaS)**:云端版分为专业版、高级版、旗舰版。
2. **模块化售卖**任何模块如AI智能文献都可能独立售卖。
3. **私有化部署**医院要求将数据敏感模块如SSA、DC部署在内网服务器。
4. **混合部署**医院本地使用SSA同时又调用云端的ASL。
5. **单机版部署**:医生需要在个人电脑(Windows/Mac)上离线运行SSA、DC、ASL等模块确保数据文献、病例不出本地。
銝箸說頞喃誑銝𦠜<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>睲賑<EFBFBD><EFBFBD><EFBFBD>銝芾圾<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𢒰<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
* **摰<E691B0>蝡?(Clients)**嚗𡁜<E59A97><F0A1819C>柱eb瘚讛<E7989A><E8AE9B><EFBFBD><E585B7>C<EFBFBD>閙㦤<E99699>?Electron)<29><><EFBFBD>函垢<E587BD>?
## **3\. 核心架构API网关 \+ 微服务**
为满足以上所有需求,我们推荐一个解耦的、面向服务的架构。
* **客户端 (Clients)**包括Web浏览器、PC单机版(Electron)、移动端。
* **API网关 (API Gateway)**:所有流量的统一入口。负责:
* **霈方<EFBFBD>**嚗𡁏嵗撉𣬚鍂<F0A3AC9A>oken<EFBFBD>?
* **頝舐眏**嚗𡁜<E59A97>霂瑟<E99C82>頧砍<E9A0A7>蝏蹱迤蝖桃<E89D96><E6A183>𡒊垢敺格<E695BA><E6A0BC><EFBFBD>憒?/api/stats \-\> SSA<EFBFBD>滚𦛚嚗剹<EFBFBD>?
* **<EFBFBD>𡁜<EFBFBD>**嚗?<3F>芣䔉)<29><>僎憭帋葵<E5B88B>滚𦛚<E6BB9A><F0A69B9A><EFBFBD><EFBFBD>?
* **<EFBFBD>𡒊垢<EFBFBD>滚𦛚 (Services)**嚗𡁶<EFBFBD><EFBFBD><EFBFBD>銵䔶<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
* **认证**校验用户Token
* **路由**:将请求转发给正确的后端微服务(如 /api/stats \-\> SSA服务)。
* **聚合**(未来)合并多个服务的数据。
* **后端服务 (Services)**:真正执行业务逻辑的单元。
## **4\. 服务模块划分 (平台 vs 产品)**
餈蹱糓<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝚砌<EFBFBD>甇乓<EFBFBD>?
### **4.1 摨訫<E691A8><E8A8AB>𡁶鍂璅<E79285> (撟喳蝱撅?**
这是架构解耦的第一步。
餈嗘<EFBFBD><EFBFBD><EFBFBD><EFBFBD>劐漣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𨅯𧑐<EFBFBD><EFBFBD><EFBFBD><EFBFBD>◆蝔喳𤐄<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
1. **<EFBFBD><EFBFBD>銝擧<EFBFBD><EFBFBD>𣂷葉敹?(UAM)**
* **<2A><EFBFBD>**嚗𡁶恣<F0A181B6><E681A3><EFBFBD><EFBFBD><E791AF><EFBFBD><EFBFBD><EFBFBD><E884AF><EFBFBD><EFBFBD><EFBFBD><E79880>駁堺嚗剹<E59A97><E589B9><EFBFBD><EFBFBD><EFBFBD>?
* **隞瑕<E99A9E>?*嚗𡁜<E59A97><F0A1819C>訕aaS憭𡁶<E686AD><F0A181B6>穿<EFBFBD>銝㮖<E98A9D><E3AE96>?擃条漣<E69DA1><E6BCA3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E8B3A2>?Feature Flag)<29><EFBFBD><E689B9>?
2. **AI憭扳芋<EFBFBD><EFBFBD><EFBFBD>?(LLM Gateway)**
* **<EFBFBD><EFBFBD>**嚗𡁶<E59A97><EFBFBD>蝞∠<E89D9E><E288A0><EFBFBD><EFBFBD>匧笆憭扳芋<E689B3><EFBFBD><EFBFBD>鍂嚗㇄eepSeek, Claude蝑㚁<E89D91><E39A81>?
* **隞瑕<EFBFBD>?*嚗𡁏覔<F0A1818F>娟aaS<61><53>𧋦<EFBFBD><F0A78BA6><EFBFBD><EFBFBD><EFBFBD><E7A588><EFBFBD><EFBFBD><EFBFBD><E586BD><EFBFBD><EFBFBD><EFBCB8><EFBFBD><E58D9D>糓AI<41><EFBFBD><E8A098><EFBFBD>瓲敹<E793B2><EFBFBD><EFBFBD>?
3. **韐行<EFBFBD>/銝芯犖銝剖<E98A9D>**嚗𡁶恣<F0A181B6><E681A3><EFBFBD><EFBFBD>蝵柴<E89DB5><E69FB4><EFBFBD>𨰻<EFBFBD><F0A8B0BB><EFBFBD><EFBFBD><EFBFBD><E78DA2>?
4. **<EFBFBD>𡁶䰻<EFBFBD>滚𦛚**嚗𡁻<E59A97>隞嗚<E99A9E><E5979A><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
### **4.2 <20><EFBFBD>銝𡁜𦛚璅<E79285> (鈭批<E988AD>撅?**
### **4.1 底层通用模块 (平台层)**
这些是所有产品共用的“地基”,必须稳固、统一。
1. **用户与权限中心 (UAM)**
* **功能**:管理用户、角色、租户(医院)、权限。
* **价值**实现SaaS多版本专业版/高级版)的功能开关(Feature Flag)控制。
2. **AI大模型网关 (LLM Gateway)**
* **功能**统一管理所有对大模型的调用DeepSeek, Claude等
* **价值**根据SaaS版本、成本考量动态切换模型。是AI功能的核心中枢。
3. **账户/个人中心**:管理用户配置、订单、帮助文档。
4. **通知服务**:邮件、站内信。
### **4.2 独立业务模块 (产品层)**
这些是可插拔的“积木”对应你们的7大功能每个都应设计为**独立的服务**。
餈嗘<EFBFBD><EFBFBD>臬虾<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𦦵妖<EFBFBD><EFBFBD><EFBFBD>撖孵<EFBFBD>雿牐賑<EFBFBD>?憭批<E686AD><E689B9><EFBFBD>瘥譍葵<E8AD8D><EFBFBD>霈曇恣銝?*<2A><EFBFBD><E7A589><EFBFBD><EFBFBD><EFBFBD>?*<2A>?
1. **智能统计 (SSA) 服务** (可包含统计工具ST)
2. **AI问答 (AIA) 服务**
3. **AI文献 (ASL) 服务**
4. **<EFBFBD><EFBFBD>摨?(PKB) <EFBFBD>滚𦛚**
5. **<EFBFBD>唳旿皜<EFBFBD><EFBFBD> (DC) <EFBFBD>滚𦛚** (霂西<EFBFBD>蝚?<3F>?
4. **知识库 (PKB) 服务**
5. **数据清洗 (DC) 服务** (详见第6节)
## **5\. <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> (<28><><EFBFBD><EFBFBD><E887AC>?**
## **5\. 推荐技术栈 (技术异构)**
<EFBFBD>睲賑<EFBFBD><EFBFBD><EFBFBD>𦦵鍂<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>撌亙<EFBFBD><EFBFBD>𡁏<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>鈭𦥑<EFBFBD><EFBFBD>?
| 憸<><E686B8> | <20><EFBFBD><E588BB><EFBFBD><EFBFBD>?| <20><>眏 |
| <20>滨垢 (UI) | React <20>?Vue | 1\. <20>唬誨SPA獢<41><EFBFBD>?2\. <20>?00%憭滨鍂鈭竝eb<65><62><EFBFBD>Electron<6F>閙㦤<E99699><E3A6A4><EFBFBD>?|
| API蝵穃<E89DB5> & 蝎睃<E89D8E>撅?| Node.js | 1\. 擃睃僎<E79D83>飡/O<><EFBFBD><E689AF>?2\. 雿靝蛹<E99D9D>𨀣<EFBFBD><EFBFBD><E9A485><EFBFBD><EFBFBD><E89098>㇌/Python<6F>𧼮虜<F0A7BCAE><EFBFBD><E99E9F>?3\. Electron<6F>閙㦤<E99699><E3A6A4><EFBFBD>蝡臬<E89DA1><E887AC><EFBFBD>?|
| 蝏蠘恣<E8A098><E681A3><EFBFBD> (SSA) | R 霂剛<E99C82> | 蝏蠘恣<E8A098><E681A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> Plumber <20><>𠂔<EFBFBD>脖蛹API嚗峕<E59A97><E5B395><EFBFBD>摮鞱<E691AE>蝔贝<E89D94><E8B49D><EFBFBD>?|
| AI/<2F>唳旿皜<E697BF><E79A9C> (DC) | Python | 撘箏之<E7AE8F><E4B98B>andas<61><73>cikit-learn<72><6E>LP<4C><50><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> FastAPI <20>湧蠧API嚗峕<E59A97><E5B395><EFBFBD>摮鞱<E691AE>蝔贝<E89D94><E8B49D><EFBFBD>?|
| <20>唳旿摨?| PostgreSQL \+ Vector DB | PostgreSQL憭<4C><E686AD>蝏𤘪<E89D8F><F0A498AA>𡝗㺭<F0A19D97><EFBFBD><E6AEB7><EFBFBD><E785BE>唳旿摨𤘪𣈲<F0A498AA><F0A388B2>䰻霂<E4B0BB><E99C82>(PKB)<29><>AG<41>?|
| <20>函蔡<E587BD><EFBFBD> | Docker \+ Kubernetes | <20>唬誨鈭穃<E988AD><E7A983><EFBFBD><E6AFBA><EFBFBD><E887AD><EFBFBD><EFBFBD><EFBFBD><E59A97><EFBFBD>啣撕<E595A3><EFBFBD>憭𡁶㴓憓<E3B493><E68693>蝵脯<E89DB5>?|
| <20>閙㦤<E99699><E3A6A4>䲮獢?| Electron | <20><EFBFBD><E887AD><EFBFBD><E8B3A2><EFBFBD>𣈲<EFBFBD><F0A388B2>ode.js<6A>𡒊垢<F0A1928A><E59EA2><EFBFBD><EFBFBD>汾eb<65>滨垢UI<55><49>楊撟喳蝱<E596B3><EFBFBD><E5AF9E>?|
我们允许“用最合适的工具做最合适的事”。
## **6\. 璅<E79285>瘛勗漲閫<E6BCB2><E996AB>嚗?DC) <20>唳旿皜<E697BF><E79A9C><EFBFBD><EFBFBD><E6B8A1>滚𦛚**
| 领域 | 推荐技术 | 理由 |
| 前端 (UI) | React 或 Vue | 1\. 现代SPA框架。 2\. 可100%复用于Web版和Electron单机版。 |
| API网关 & 粘合层 | Node.js | 1\. 高并发I/O性能。 2\. 作为“总指挥”粘合R/Python非常成熟。 3\. Electron单机版后端复用。 |
| 统计分析 (SSA) | R 语言 | 统计分析的王者。通过 Plumber 包暴露为API或通过子进程调用。 |
| AI/数据清洗 (DC) | Python | 强大的Pandas、Scikit-learn、NLP生态。通过 FastAPI 暴露API或通过子进程调用。 |
| 数据库 | PostgreSQL \+ Vector DB | PostgreSQL处理结构化数据向量数据库支持知识库(PKB)的RAG。 |
| 部署方案 | Docker \+ Kubernetes | 现代云原生的唯一标准,实现弹性和多环境部署。 |
| 单机版方案 | Electron | 唯一能原生支持Node.js后端、复用Web前端UI的跨平台方案。 |
## **6\. 模块深度解析:(DC) 数据清洗整理服务**
“数据清洗整理 (DC)” 模块是连接原始数据与有效分析的桥梁,技术挑战分为两部分:
1. **海量表格ETL**:处理百万行、多表格的结构化数据,执行高效的连接(Join)、重组(Pivot)和排序。
2. **非结构化文本NER**从病理、出入院小结等大段文本中提取结构化字段如TNM分期、肿瘤大小
针对不同的部署场景,我们采用两种实现方案:
<EFBFBD>𨀣㺭<EFBFBD><EFBFBD>瘣埈㟲<EFBFBD>?(DC)<29>?璅<E79285><E288AA><EFBFBD><E888AA><EFBFBD>憪𧢲㺭<F0A7A2B2><EFBFBD><E6A190><EFBFBD><E39787><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E28098><E79287><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E88880><EFBFBD>銝箔舅<E7AE94><EFBFBD>嚗?
1. **瘚琿<E7989A>銵冽聢ETL**嚗𡁜<E59A97><F0A1819C><EFBFBD>蓡銝<E893A1><E98A9D><EFBFBD><EFBFBD><EFBFBD>銵冽聢<E586BD><E881A2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>唳旿嚗峕<E59A97>銵屸<E98AB5><E5B1B8><EFBFBD><EFBFBD>餈墧𦻖(Join)<29><><EFBFBD>蝏?Pivot)<29><EFBFBD>摨譌<E691A8>?
2. **<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𧋦NER**嚗帋<E59A97><E5B88B><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>仿堺撠讐<E692A0>蝑匧之畾菜<E795BE><E88F9C>砌葉嚗峕<E59A97><E5B395>𣇉<EFBFBD><F0A38789><EFBFBD><EFBFBD>摮埈挾嚗<E68CBE><E59A97>TNM<4E><4D><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>文之撠𧶏<E692A0><F0A7B68F>?
<EFBFBD><EFBFBD>笆銝滚<EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝵脣㦤<EFBFBD><EFBFBD><EFBFBD>睲賑<EFBFBD><EFBFBD>鍂銝斤<EFBFBD>摰䂿緵<EFBFBD><EFBFBD>嚗?
### **6.1 方案一:服务器最优版 (Cloud-Optimal)**
甇斗䲮獢<EFBFBD>鍂鈭?*鈭𤑳垢SaaS<61>?*<2A>?*蝘<><E89D98><EFBFBD><EFBFBD>蝵?*嚗𣬚𤌍<F0A3AC9A><F0A48C8D>糓餈賣<E9A488><E8B3A3><EFBFBD><EFBFBD>?*<2A><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝖桃<E89D96><E6A183>諹捶<E8ABB9>?*嚗<><E59A97>霈暹㺭<E69AB9>桀歇<E6A180><EFBFBD>嚗剹<E59A97>?
* **<2A><><EFBFBD><EFBFBD>**嚗䥪ython (FastAPI) \+ Polars \+ LLM API (Claude/GPT) \+ PostgreSQL
* **撌乩<E6928C>瘚?*嚗?
1. **API<50>交𤣰**嚗鎄astAPI (Python) <20>滚𦛚<E6BB9A>交𤣰<E4BAA4><EFBFBD>銝𠹺<E98A9D><F0A0B9BA><EFBFBD><EFBFBD>銝枕xcel<65><6C><EFBFBD>?
2. **ETL (Polars)**嚗?
* **<EFBFBD><EFBFBD>Pandas**嚗屸<E59A97><E5B1B8>沌olars摨瓐<E691A8><E79390>olars<72><EFBFBD>Rust嚗<74><EFBFBD>?*憭𡁶瑪蝔见僎銵?*嚗<><E59A97>摮䀹<E691AE><E480B9><EFBFBD><EFBFBD>擃塩<E69383>?
* <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝哨<EFBFBD>憒?4GB+嚗㚁<E59A97>Polars<72>賭誑**<2A><EFBFBD><E59581>𡝗㺭<F0A19D97><E3BAAD><EFBFBD>**<2A><><EFBFBD>笔漲嚗<E6BCB2><EFBFBD><E98A81><EFBFBD>銝剖<E98A9D><E58996>?00銝<30><E98A9D><EFBFBD>唳旿<E594B3><E697BF><EFBFBD>銵沅OIN<49><4E>ROUP BY蝑㗇<E89D91>雿頣<E99BBF><E9A0A3>笔漲<E7AC94>烈andas<61>?0-100<30><EFBFBD>?
3. **NER (LLM API)**嚗?
* FastAPI <20>滚𦛚**撟嗉<E6929F><EFBFBD>鍂** AI憭扳芋<E689B3><EFBFBD><E8AEA0><EFBFBD>閫?.1<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
* 雿輻鍂 **Claude 3** <20>?**GPT-4o** 蝑农OTA璅<E79285>嚗屸<E59A97><E5B1B8>㇇SON Mode嚗䔶<E59A97><E494B6><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝剜<E98A9D><E5899C>𣇉<EFBFBD><F0A38789><EFBFBD><EFBFBD>靽⊥<E99DBD><E28AA5>?
* **隡睃飵**嚗𡁜<E59A97>蝖桃<E89D96><E6A183><EFBFBD><EFBFBD>嚗諹<E59A97><E8ABB9><EFBFBD>圾憭齿<E686AD>銝𠹺<E98A9D><F0A0B9BA><EFBFBD><EFBFBD><EFBFBD>𣳇<EFBFBD>霈剔<E99C88><E79285><E288AA>?
4. **鈭支<EFBFBD>**嚗𡁏<E59A97>瘣堒<E798A3><E5A092><EFBFBD>Polars DataFrame鋡怠<E98BA1><E680A0>仙ostgreSQL蝏𤘪<E89D8F>銵剁<E98AB5><E58981>滨垢<E6BBA8>臬銁蝥踵<E89DA5><EFBFBD><E996AB>撖澆枂<E6BE86>?
* **<EFBFBD><EFBFBD><EFBFBD><EFBFBD>**嚗𡁏迨 FastAPI \+ Polars <20>滚𦛚嚗?*撠望糓**<2A>賜铜銋行沲<E8A18C><E6B2B2><EFBFBD><E89189><EFBFBD>𨀣㺭<F0A880A3><EFBFBD>瘣?(DC) 敺格<E695BA><E6A0BC><EFBFBD><EFBFBD><E59885><EFBFBD>鑥ode.js API蝵穃<E89DB5><E7A983><EFBFBD><EFBFBD><E99F90><EFBFBD><EFBFBD>?
### **6.2 <20><EFBFBD>鈭䕘<E988AD><E49598>閙㦤<E99699>?(Desktop-Offline)**
此方案用于**云端SaaS版**和**私有化部署**,目标是追求极致的**效率、准确率和质量**(假设数据已脱敏)。
* **技术栈**Python (FastAPI) \+ Polars \+ LLM API (Claude/GPT) \+ PostgreSQL
* **工作流**
1. **API接收**FastAPI (Python) 服务接收用户上传的多个Excel文件。
2. **ETL (Polars)**
* **放弃Pandas**采用Polars库。Polars基于Rust天生**多线程并行**,内存效率极高。
* 在服务器的大内存中如64GB+Polars能以**数秒或数十秒**的速度在内存中完成200万行数据的多表JOIN、GROUP BY等操作速度是Pandas的10-100倍。
3. **NER (LLM API)**
* FastAPI 服务**并行调用** AI大模型网关见4.1节)。
* 使用 **Claude 3****GPT-4o** 等SOTA模型配合JSON Mode从病理报告中提取结构化信息。
* **优势**:准确率极高,能理解复杂上下文,无需训练模型。
4. **交付**清洗完成的Polars DataFrame被存入PostgreSQL结果表前端可在线浏览或导出。
* **架构融合**:此 FastAPI \+ Polars 服务,**就是**白皮书架构中的“数据清洗 (DC) 微服务”由“Node.js API网关”负责调用。
### **6.2 方案二:单机版 (Desktop-Offline)**
此方案用于**医生个人电脑**,目标是**100%数据隐私**和**离线可用性**,是对性能和准确率的**必要妥协**。
甇斗䲮獢<EFBFBD>鍂鈭?*<2A><EFBFBD>銝芯犖<E88AAF><EFBFBD>**嚗𣬚𤌍<F0A3AC9A><F0A48C8D>糓**100%<25>唳旿<E594B3><EFBFBD>**<2A>?*蝳餌瑪<E9A48C>舐鍂<E88890>?*嚗峕糓撖寞<E69296><EFBFBD><E689AF><EFBFBD><EFBFBD>蝖桃<E89D96><E6A183>?*敹<><E695B9>憒亙<E68692>**<2A>?
* **技术栈**Electron (Node.js) \+ Python (Pandas) \+ SQLite \+ spaCy (本地NLP)
* **撌乩<E6928C>瘚?*嚗?
1. **<EFBFBD><EFBFBD><EFBFBD>?(Node.js)**嚗鍃lectron<6F><6E>蜓餈𤤿<E9A488>雿靝蛹<E99D9D><EFBFBD><E9A485><EFBFBD><EFBFBD>漲Python摮鞱<E691AE>蝔卝<E89D94>?
2. **ETL (SQLite)**嚗?
* **銝亦<EFBFBD>**撠?00銝<30><E98A9D><EFBFBD>唳旿銝<E697BF>甈⊥<E79488>扯粉<E689AF><EFBFBD>摮矋<E691AE>隡𡁜紡<F0A1819C>渡鍂<E6B8A1>瑞㩞<E7919E>穃援皞<E68FB4><E79A9E><EFBFBD>?
* Python<EFBFBD>𡁏𧋦鋡怨<EFBFBD><EFBFBD><EFBFBD>雿輻鍂Pandas<EFBFBD><EFBFBD>hunksize<EFBFBD><EFBFBD>㺭嚗?*<2A><><EFBFBD>**霂餃<E99C82>Excel嚗?*<2A><EFBFBD>**<2A><EFBFBD><EFBFBD>銝芣𧋦<E88AA3>?*SQLite**<EFBFBD>唳旿摨𤘪<EFBFBD>隞?(.db)<EFBFBD>?
* **<EFBFBD>喲睸**嚗𡁜⏚<F0A1819C>?**SQLite <20>唳旿摨枏<E691A8><E69E8F>?*嚗<><E59A97><EFBFBD><E494B6>烈andas<61><73><EFBFBD>嚗㗇䔉<E39787><EFBFBD><E689AF><EFBFBD><EFBFBD><EFBFBD><E58EA9><EFBFBD>JOIN<EFBFBD>ROUP BY<EFBFBD><EFBFBD><EFBFBD><EFBFBD>臬銁雿𤾸<EFBFBD>摮条㩞<EFBFBD><EFBFBD><EFBFBD><EFBFBD>憭扳㺭<EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝔喳<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
3. **NER (<EFBFBD>砍𧑐 spaCy)**嚗?
* **銝亦<EFBFBD>**撠<><E692A0>憪讠<E686AA>靘页<E99D98>PHI嚗匧<E59A97><E58CA7><EFBFBD><EFBFBD>隞颱<E99A9E>鈭𤑳垢API嚗<49><E59A97>憭扯<E686AD><EFBFBD><E996AB><EFBFBD>?
* Python<EFBFBD>𡁏𧋦鋡怨<EFBFBD><EFBFBD><EFBFBD><EFBFBD>㰘蝸 **spaCy** 蝑?*100%<EFBFBD>砍𧑐餈鞱<EFBFBD>**<2A><>LP璅<E79285><EFBFBD><EFBFBD><EFBFBD><E586BD><EFBFBD>銝𦠜<E98A9D><F0A6A09C><EFBFBD>雿瓐<E99BBF>?
* **<EFBFBD><EFBFBD>飵**嚗窃paCy<43><79><EFBFBD><EFBC86><EFBFBD><EFBFBD><EFBFBD><E7909C><EFBFBD><EFBFBD><E686AD>憭齿<E686AD>霂凋<E99C82>嚗峕<E59A97><E5B395>𡏭<EFBFBD>銝滚<E98A9D>LLM<EFBFBD>?
4. **鈭支<EFBFBD>**嚗𡁏<E59A97><F0A1818F><EFBFBD><E58EA9>𡏭◤<F0A18FAD><EFBFBD><E59D94>砍𧑐 SQLite <20>唳旿摨瓐<E691A8><E79390>lectron<6F>滨垢<E6BBA8><EFBFBD><E69C9E><EFBFBD>△隞燑QLite銝剛粉<E5899B>𡝗㺭<F0A19D97><EFBFBD>蝷綽<E89DB7><E7B6BD>硋紡<E7A18B>箔蛹Excel<EFBFBD>?
* **<EFBFBD><EFBFBD><EFBFBD><EFBFBD>**嚗𡁏迨<F0A1818F><EFBFBD>**撠望糓**<2A>賜铜銋艾<E98A8B>?.4 <20>箸艶<E7AEB8>𨥈<EFBFBD><F0A8A588><EFBFBD><E9A48C>閙㦤<E99699><E3A6A4><EFBFBD>𤑳<EFBFBD><F0A491B3><EFBFBD>摰䂿緵<E482BF>?
* **工作流**
1. **总指挥 (Node.js)**Electron的主进程作为总指挥调度Python子进程。
2. **ETL (SQLite)**
* **严禁**将200万行数据一次性读入内存会导致用户电脑崩溃
* Python脚本被调用,使用Pandas的chunksize参数,**分块**读取Excel**逐行**写入一个本地**SQLite**数据库文件 (.db)
* **关键**:利用 **SQLite 数据库引擎**而不是Pandas内存来执行所有繁重的JOIN和GROUP BY。这是在低内存电脑上处理大数据的唯一稳定方案。
3. **NER (本地 spaCy)**
* **严禁**将原始病例PHI发送到任何云端API重大违规
* Python脚本被调用,加载 **spaCy** 等**100%本地运行**的NLP模型在用户电脑上提取实体。
* **劣势**spaCy准确率有限无法处理复杂语义效果远不如LLM
4. **交付**:所有结果被写回本地 SQLite 数据库。Electron前端通过分页从SQLite中读取数据展示或导出为Excel
* **架构融合**:此方案**就是**白皮书【7.4 场景四:医生单机版】的具体实现。
## **7\. 关键路径:多部署模式实现**
同一套代码库,如何支持所有商业场景?
### **7.1 <EFBFBD>箸艶銝<EFBFBD>嚗帋<EFBFBD>蝡特aaS<EFBFBD>?(<28><><EFBFBD>敺格<E695BA><E6A0BC>?**
### **7.1 场景一云端SaaS版 (标准微服务)**
* **<EFBFBD><EFBFBD>**嚗𡁏<E59A97><F0A1818F><EFBFBD><E39787><EFBFBD>UAM, SSA, ASL...嚗匧<EFBFBD><EFBFBD>唳旿摨㯄<EFBFBD><EFBFBD><EFBFBD>蝡荔<EFBFBD><EFBFBD><EFBFBD>K8s蝞∠<EFBFBD><EFBFBD>?
* **<EFBFBD>蝡?*嚗𡁶鍂<F0A181B6><EFBFBD><EFBFBD>瘚讛<E7989A><E8AE9B>刻挪<E588BB><EFBFBD>?
### **7.2 <20>箸艶鈭䕘<E988AD><E49598>駁堺<E9A781>砍𧑐<E7A08D><EFBFBD>蝵?(蝘<><E89D98><EFBFBD>?**
* **架构**:所有服务(UAM, SSA, ASL...和数据库都在云端通过K8s管理。
* **客户端**:用户通过浏览器访问。
### **7.2 场景二:医院本地化部署 (私有化)**
* **架构**:将数据敏感的服务(如 SSA服务、DC服务及其数据库打包为Docker容器。
* **部署**使用K8s或更轻量的K3s在医院内网服务器上“一键部署”。
* **数据**数据100%留在医院内网。
* **<2A><EFBFBD>**嚗𡁜<E59A97><F0A1819C>唳旿<E594B3>𤩺<EFBFBD><F0A4A9BA><EFBFBD><EFBFBD><EFBFBD><EFBFBD>憒?SSA<53>滚𦛚<E6BB9A><F0A69B9A>C<EFBFBD>滚𦛚嚗匧<E59A97><E58CA7>嗆㺭<E59786><EFBFBD><E6A180><EFBFBD>銝慣ocker摰孵膥<E5ADB5>?
* **<2A>函蔡**嚗帋蝙<E5B88B>沛8s<38>𡝗凒頧駁<E9A0A7><E9A781><EFBFBD>3s嚗<73><EFBFBD>駁堺<E9A781><E5A0BA><EFBFBD><EFBFBD>滚𦛚<E6BB9A><EFBFBD><E585B6><EFBFBD><E99D9D><EFBFBD>蝵聆<E89DB5><EFBFBD>?
* **<2A>唳旿**嚗𡁏㺭<F0A1818F>?00%<25>坔銁<E59D94>駁堺<E9A781><E5A0BA><EFBFBD><EFBFBD>?
### **7.3 场景三:混合部署**
* **<EFBFBD><EFBFBD>**嚗𡁜銁<F0A1819C>箸艶鈭𣬚<E988AD><F0A3AC9A><EFBFBD>銝𠺪<E98A9D><F0A0BAAA>滨垢摨𠉛鍂鋡急惣<E680A5><EFBFBD>蝵柴<E89DB5>?
* **<EFBFBD><EFBFBD>**嚗?
* <EFBFBD><EFBFBD>霈輸䔮 .../stats \-\> <EFBFBD>滨垢靚<EFBFBD>鍂**<2A>駁堺<E9A781><E5A0BA><EFBFBD>API** (http://192.168.x.x/api/stats)<EFBFBD>?
* <EFBFBD><EFBFBD>霈輸䔮 .../literature \-\> <EFBFBD>滨垢靚<EFBFBD>鍂**鈭𤑳垢<F0A491B3><EFBFBD>API** (https://api.yizhengxun.com/api/lit)<EFBFBD>?
### **7.4 <20>箸艶<E7AEB8>𨥈<EFBFBD><F0A8A588><EFBFBD><E9A48C>閙㦤<E99699>?(Electron)**
* **架构**:在场景二的基础上,前端应用被智能配置。
* **流程**
* 用户访问 .../stats \-\> 前端调用**医院内网API** (http://192.168.x.x/api/stats)
* 用户访问 .../literature \-\> 前端调用**云端公网API** (https://api.yizhengxun.com/api/lit)
餈蹱糓<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>喲睸<EFBFBD><EFBFBD><EFBFBD>𡏭<EFBFBD>皜﹦<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𨀣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>峕糓\*\*<2A>𨀣沲<F0A880A3><E6B2B2><EFBFBD><EFBFBD><E89D8F>𩄼*\*<2A>?
鈭𤑳垢<EFBFBD><EFBFBD><EFBFBD>?
### **7.4 场景四:医生单机版 (Electron)**
这是技术上最关键的“过渡”,它不是“打包”,而是\*\*“架构重组”\*\*。
云端版架构:
\[浏览器UI\] \<-- (HTTP网络) \--\> \[云端Node.js API\] \<-- (HTTP) \--\> \[云端R/Python服务\]
<EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD>?
\[Electron UI (憭滨鍂)\] \<-- (IPC<EFBFBD>祆㦤<EFBFBD>帋縑) \--\> \[Electron銝餉<EFBFBD>蝔?(Node.js憭滨鍂)\] \<-- (Child Process<EFBFBD>祆㦤靚<EFBFBD>) \--\> \[<EFBFBD>砍𧑐R/Python<EFBFBD>𡁏𧋦\]
**摰䂿緵頝臬<EFBFBD>嚗?*
单机版架构:
\[Electron UI (复用)\] \<-- (IPC本机通信) \--\> \[Electron主进程 (Node.js复用)\] \<-- (Child Process本机调用) \--\> \[本地R/Python脚本\]
**实现路径:**
1. **<EFBFBD>啣遣Electron憿寧𤌍**<2A>?
2. **蝘餅<EFBFBD><EFBFBD>滨垢 (UI憭滨鍂)**嚗𡁜<E59A97>鈭𤑳垢<F0A491B3><E59EA2><EFBFBD>React/Vue**蝻𤥁<E89DBB><F0A4A581>𡒊<EFBFBD><F0A1928A><EFBFBD><E8B9B1><EFBFBD>隞?* (dist<73><EFBFBD>) 摰峕㟲憭滚<E686AD><E6BB9A>lectron銝准<EFBFBD>?
3. **<EFBFBD><EFBFBD><EFBFBD>𡒊垢 (<28><EFBFBD>憭滨鍂)**嚗?
* 鈭𤑳垢<EFBFBD><EFBFBD><EFBFBD> **Node.js API<EFBFBD><EFBFBD>**嚗諹◤蝘餅<E89D98><E9A485>?**Electron<EFBFBD><EFBFBD>蜓餈𤤿<EFBFBD>(main.js)** 銝准<EFBFBD>?
* 鈭𤑳垢<EFBFBD><EFBFBD><EFBFBD> **R <EFBFBD>?Python <EFBFBD>𡁏𧋦**嚗諹◤雿靝蛹**<EFBFBD>砍𧑐<EFBFBD><EFBFBD>辣**<2A><EFBFBD>餈𥕦<E9A488><EFBFBD><E98B86><EFBFBD>?
1. **新建Electron项目**
2. **移植前端 (UI复用)**将云端版的React/Vue**编译后的静态文件** (dist目录) 完整复制到Electron中。
3. **重组后端 (逻辑复用)**
* 云端版的 **Node.js API逻辑**,被移植到 **Electron的主进程(main.js)** 中。
* 云端版的 **R Python 脚本**,被作为**本地文件**打包进安装包。
* main.js (Node.js) 通过 child\_process.spawn子进程来**本地调用**这些R/Python脚本。具体实现见第6.2节)
4. **<EFBFBD>唳旿鈭斗揢**嚗鐭ode.js<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ython銋钅𡢿<EFBFBD><EFBFBD> stdin/stdout <EFBFBD>?**JSON** 摮㛖泵銝脰<E98A9D>銵峕㺭<E5B395>桐漱<E6A190><EFBFBD>?
5. **<EFBFBD>砍𧑐AI<EFBFBD><EFBFBD> (ASL璅<E79285>)**嚗?
* Node.js (fs<EFBFBD>) 霂餃<E99C82><E9A483>砍𧑐<E7A08D><F0A79190>讃憭嫣葉<E5ABA3><E89189>DF<44>?
* Node.js (<EFBFBD>?pdf-parse) <EFBFBD>?*<2A>砍𧑐**<2A>𣂼<EFBFBD><F0A382BC><EFBFBD><E48185><EFBFBD>𧋦<EFBFBD>?
* Node.js (<EFBFBD>?axios) **<EFBFBD><EFBFBD><EFBFBD>𨀣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>鈭𤑳垢LLM API** (<EFBFBD>eepSeek) 餈𥡝<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>瘜冽<EFBFBD>嚗朞<EFBFBD>銝𥟠C璅<EFBFBD><EFBFBD><EFBFBD><EFBFBD>憪讠<EFBFBD>靘见<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
* **<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>隞?(.pdf) 100% 銝滨氖撘<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>**<2A>?
6. **<EFBFBD>砍𧑐摮睃<EFBFBD>**嚗帋蝙<E5B88B>?**SQLite**嚗<><E59A97><EFBFBD> npm install sqlite3嚗匧銁<E58CA7>砍𧑐摮睃<E691AE><E79D83><EFBFBD><EFBFBD><E8AE83><EFBFBD><EFBFBD>唳旿<E594B3><E697BF><EFBFBD><EFBFBD><EFBFBD><E99E9F>𦦵<EFBFBD><F0A6A6B5>?
## **8\. 撌亦<E6928C><E4BAA6><EFBFBD><E7A2B6>澆捆<E6BE86>?(敹<>粉)**
4. **数据交换**Node.js、R、Python之间通过 stdin/stdout **JSON** 字符串进行数据交换。
5. **本地AI功能 (ASL模块)**
* Node.js (fs模块) 读取本地文献夹中的PDF。
* Node.js (pdf-parse) 在**本地**提取摘要文本。
* Node.js (axios) **只将“摘要文本”发送给云端LLM API** (如DeepSeek) 进行分析。注意这与DC模块的原始病例处理不同
* **文献原文件 (.pdf) 100% 不离开用户电脑**。
6. **本地存储**:使用 **SQLite**(通过 npm install sqlite3在本地存储文献的元数据、分析结果等。
### **8.1 <20>閙㦤<E99699><E3A6A4><EFBFBD><EFBFBD>𨅯<EFBFBD>摰嗆▲<E59786><EFBFBD><E884B2>?*
## **8\. 工程化与兼容性 (必读)**
<EFBFBD>閙㦤<EFBFBD><EFBFBD><EFBFBD>撌亦<EFBFBD><EFBFBD><EFBFBD>銝齿糓撘<EFBFBD><EFBFBD>𡢅<EFBFBD><EFBFBD>峕糓**<2A><EFBFBD>**<2A>?
* <20><EFBFBD> .exe (Windows) <20>?.dmg (Mac) 摰㕑<E691B0><E39591><EFBFBD><EFBFBD>憿餅糓銝<E7B393>銝芬<E98A9D>𨅯<EFBFBD>摰嗆▲<E59786><EFBFBD>?
* <20><EFBFBD><EFBFBD><EFBFBD>?electron-builder 蝑匧極<E58CA7><EFBFBD><EFBFBD>誑銝𧢲<E98A9D><F0A7A2B2><EFBFBD>摰寞<E691B0>蝏𤏸<E89D8F><EFBFBD>銝芸<E98A9D><EFBFBD><E98B86>嚗?
1. <20><EFBFBD>Electron摨𠉛鍂 (Node.js \+ <20>滨垢UI)<29>?
2.<>銝?*撋<><E6928B>撘讐<E69298> Python 餈鞱<E9A488><E99EB1>?*<2A>𦠜<EFBFBD><F0A6A09C><EFBFBD>韏?(pandas, spaCy蝑?<3F>?
3.<>銝?*撋<><E6928B>撘讐<E69298> R 餈鞱<E9A488><E99EB1>?*<2A>𦠜<EFBFBD><F0A6A09C><EFBFBD>韏?(jsonlite蝑?<3F>?
* 餈嗘<E9A488>雿踹<E99BBF><EFBFBD><E98B86>雿梶妖<E6A2B6>睃之嚗<E4B98B><E59A97>500MB+嚗㚁<E59A97>餈坔笆鈭𦒘<E988AD>銝朞蔓隞嗆糓摰<E7B393><E691B0><EFBFBD>臭誑<E887AD><EFBFBD><E4BA99><EFBFBD><EFBFBD>?
### **8.2 敹<><EFBFBD><EFBFBD>嚗阳in 7 銝?32雿滨頂蝏?*
### **8.1 单机版的“全家桶”挑战**
**餈蹱糓銝<E7B393>銝芸<E98A9D>銝𡁜<E98A9D>摰匧<E691B0><E58CA7><EFBFBD>嚗䔶<E59A97><E494B6><EFBFBD><E88880><EFBFBD>厰★<E58EB0>?*
单机版的工程挑战不是开发,而是**打包**。
**敹<>◆憯唳<E686AF>嚗?* <20><EFBFBD><E587BD>閙㦤<E99699><E3A6A4><EFBFBD>雿𡒊頂蝏蠘<E89D8F><EFBFBD>糓 **Windows 10 (64雿?**<EFBFBD>?
**<EFBFBD><EFBFBD>眏嚗?*
* 您的 .exe (Windows) 和 .dmg (Mac) 安装包必须是一个“全家桶”。
* 您需要使用 electron-builder 等工具,将以下所有内容捆绑进一个安装包:
1. 您的Electron应用 (Node.js \+ 前端UI)。
2. 一个**嵌入式的 Python 运行时**及所有依赖 (pandas, spaCy等)。
3. 一个**嵌入式的 R 运行时**及所有依赖 (jsonlite等)。
* 这会使安装包体积变大如500MB+),这对于专业软件是完全可以接受的。
### **8.2 必须放弃Win 7 与 32位系统**
**这是一个商业和安全决策,不是技术选项。**
**必须声明:** 您的单机版最低系统要求是 **Windows 10 (64位)**
**理由:**
1. **稳定性的“崩溃”问题**32位系统有4GB内存上限APP最多用2-3GB。您的**R语言统计分析**和**数据清洗**都是内存消耗大户,处理真实数据时**不是变卡,而是会直接崩溃闪退**,导致用户数据丢失。
2. **安全性的“漏洞”问题**微软已放弃Win 7。现代Electron, Node.js, Python, R生态已**全部停止支持32位和Win 7**。强行兼容意味着您必须使用5年前、充满已知安全漏洞的“古董”技术栈来处理敏感医疗数据这是不可接受的。
1. **蝔喳<E89D94><E596B3><EFBFBD><E68A92>𨅯援皞<E68FB4><E79A9E>嗪䔮憸?*嚗?2雿滨頂蝏<E9A082><E89D8F>4GB<47><42><EFBFBD>銝𢠃<E98A9D>嚗淾PP<50><50>憭𡁶鍂2-3GB<47><42><EFBFBD><EFBFBD>?*R霂剛<E99C82>蝏蠘恣<E8A098><E681A3><EFBFBD>**<EFBFBD>?*<2A>唳旿皜<E697BF><E79A9C>**<2A>賣糓<E8B3A3><E7B393><EFBFBD><EFBFBD><E798A8>堒之<E5A092><EFBFBD><EFBFBD><E686AD><EFBFBD><EFBFBD><E7AC94>唳旿<E594B3>?*銝齿糓<E9BDBF>睃㨃嚗諹<E59A97>峕糓隡𡁶凒<F0A181B6>亙援皞<E68FB4><EFBFBD><E7B7BE>**嚗<><EFBFBD>渡鍂<E6B8A1>瑟㺭<E7919F>桐腺憭晞<E686AD>?
2. **摰匧<E691B0><E58CA7><EFBFBD><E68A92>𨀣<EFBFBD>瘣嫰<E798A3>嗪䔮憸?*嚗𡁜凝頧臬歇<E887AC><EFBFBD>Win 7<><37>緵隞Βlectron, Node.js, Python, R<><52><EFBFBD><EFBFBD>**<EFBFBD><EFBFBD><EFBFBD>𨀣迫<EFBFBD><EFBFBD>32雿滚<EFBFBD>Win 7**<2A><>撩銵<E692A9><E98AB5>摰寞<E691B0><E5AF9E><EFBFBD><E5969F><EFBFBD>憿颱蝙<E9A2B1>?撟游<E6929F><E6B8B8><EFBFBD><EFBFBD><E288AA><EFBFBD><E4BA99><EFBFBD>瘣䂿<E798A3><E482BF>𨅯𧂈<F0A885AF><F0A78288><EFBFBD><EFBFBD><E884B2><EFBFBD><E88880><EFBFBD><E4BA99><EFBFBD><EFBFBD><EFBFBD>笔龫<E7AC94>埈㺭<E59F88><EFBFBD>餈蹱糓銝滚虾<E6BB9A><EFBFBD><E4BA99><EFBFBD><EFBFBD>?
## **9\. 分阶段实施路线图 (Roadmap)**
雿靝蛹<EFBFBD><EFBFBD><EFBFBD>砍虬嚗峕<EFBFBD>隞砍<EFBFBD>憿餃𦛚摰𠺶<EFBFBD>?
### **9.1 <20>嗆挾銝<E68CBE>嚗帋<E59A97>蝡烘VP (0-6銝芣<E98A9D>) \- <20>𨀣芋<F0A880A3><EFBFBD><E5A092><EFBFBD><E893A5>?*
作为初创公司,我们必须务实。
* **<2A><EFBFBD>**嚗𡁜翰<F0A1819C><EFBFBD>蝥蹂<E89DA5>蝡特aaS<61><53><EFBFBD>撉諹<E69289><EFBFBD><EFBFBD>?
* **<2A><EFBFBD>**嚗帋<E59A97>銝芯誨<E88AAF><E8AAA8><EFBFBD>摨?(Monorepo)嚗䔶<E59A97>銝芯蜓<E88AAF>𡒊垢<F0A1928A>滚𦛚嚗<F0A69B9A><E59A97>Node.js嚗剹<E59A97>?
* **<2A>喲睸蝥芸<E89DA5> (<28>枏𧑐<E69E8F>?**嚗?
1. **隞<><E99A9E><EFBFBD>𠉛氖**嚗𡁜銁隞<E98A81><E99A9E><EFBFBD><EFBFBD>銝𠺪<E98A9D>銝交聢<E4BAA4><EFBFBD>𨅯像<F0A885AF>唳芋<E594B3><EFBFBD><EFBFBD><E598A5><EFBFBD><E99D9D>⊥芋<E28AA5><EFBFBD><EFBFBD><E598A5><EFBFBD><EFBFBD>?
2. **<EFBFBD>唳旿<EFBFBD>𠉛氖**嚗𡁜銁<F0A1819C><EFBFBD>銝枉ostgreSQL<51>唳旿摨㮖葉嚗?*銝交聢雿輻鍂銝滚<E98A9D><E6BB9A><EFBFBD>chema** (憒?uam\_schema, stats\_schema) <20>仿<EFBFBD>蝳餅㺭<E9A485><EFBFBD><E69FB4><EFBFBD><EFBFBD>舀𧊋<E88880><EFBFBD><E4BAA4><EFBFBD><EFBFBD>滚𦛚<E6BB9A><F0A69B9A><EFBFBD><EFBFBD>賜瑪<E8B39C>?
3. **<EFBFBD><EFBFBD>Docker**嚗帋<E59A97>蝚砌<E89D9A>憭抵絲嚗峕<E59A97><E5B395><EFBFBD><E58CA7><EFBFBD><E3BBAB><EFBFBD>霂𨰻<E99C82><F0A8B0BB><EFBFBD>鈭抒㴓憓<E3B493><E68693><EFBFBD><EFBFBD><EFBFBD> Docker <20>?docker-compose<73>?
### **9.2 <20>嗆挾鈭䕘<E988AD>擐𡝗活<F0A19D97>函蔡 (6-18銝芣<E98A9D>) \- <20>𣈯<EFBFBD>甈⊥<E79488><E28AA5><EFBFBD><EFBFBD>?*
### **9.1 阶段一云端MVP (0-6个月) \- “模块化单体”**
* **閫血<EFBFBD><EFBFBD>?*嚗朞<E59A97><E69C9E>亦洵銝<E6B4B5>銝芬<E98A9D>𦦵<EFBFBD><F0A6A6B5><EFBFBD><E58CA7>函蔡<E587BD>嘥恥<E598A5><EFBFBD><E79880><EFBFBD>𨅯<EFBFBD><F0A885AF><EFBFBD><E7AE87><EFBFBD><EFBFBD><E79899>?
* **<EFBFBD><EFBFBD>**嚗?
1. **撘訫<E69298>K8s**嚗𡁜銁鈭𤑳垢甇<E59EA2><E79487><EFBFBD>舐鍂Kubernetes餈𥡝<E9A488><F0A5A19D>滚𦛚蝻𡝗<E89DBB><F0A19D97>?
2. **撘訫<EFBFBD>API蝵穃<EFBFBD>**嚗𡁜銁K8s<38><73><EFBFBD><EFBFBD>蝵淇ginx<6E>嬑ong<6E>?
3. **<EFBFBD><EFBFBD>擐𡝗活<EFBFBD><EFBFBD><EFBFBD>**嚗𡁜<E59A97> SSA <20>?DC 璅<E79285><EFBFBD><E59A97><EFBFBD><EFBFBD><EFBFBD>隞祉<E99A9E> stats\_schema嚗劐<E59A97>銝餃<E98A9D><E9A483>其葉**<2A><EFBFBD><E68B8D><EFBFBD><EFBFBD>**<2A>箸䔉嚗峕<E59A97><E5B395><EFBFBD><EFBFBD>蝚砌<E89D9A>銝芰𡠺蝡讠<E89DA1>敺格<E695BA><E6A0BC><EFBFBD><E288B4><EFBFBD>鍂6.1<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𨀣<EFBFBD>隡条<EFBFBD><EFBFBD>脲沲<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
4. **<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>**嚗𡁜鍳<F0A1819C>函洵銝<E6B4B5>銝枕lectron憿寧𤌍嚗峕<E59A97><E5B395><EFBFBD>?.4<EFBFBD>睲葉<EFBFBD><EFBFBD>楝敺<EFBFBD><EFBFBD>銵𢞖<EFBFBD>𣈯<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>鍂6.2<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𨅯<EFBFBD><EFBFBD><EFBFBD><EFBFBD>脲沲<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
### **9.3 <20>嗆挾銝㚁<E98A9D><E39A81>券𢒰敺格<E695BA><E6A0BC>?(18銝芣<E98A9D>+)**
* **目标**快速上线云端SaaS版验证市场。
* **架构**:一个代码仓库 (Monorepo)一个主后端服务如Node.js
* **关键纪律 (打地基)**
1. **代码隔离**:在代码目录上,严格按“平台模块”和“业务模块”划分。
2. **数据隔离**在同一个PostgreSQL数据库中**严格使用不同的Schema** (如 uam\_schema, stats\_schema) 来隔离数据。这是未来拆分微服务的生命线。
3. **全员Docker**:从第一天起,所有开发、测试、生产环境都必须基于 Docker 和 docker-compose。
### **9.2 阶段二:首次部署 (6-18个月) \- “首次拆分”**
* **触发点**:迎来第一个“私有化部署”客户,或“单机版”需求。
* **架构**
1. **引入K8s**在云端正式启用Kubernetes进行服务编排。
2. **引入API网关**在K8s集群前部署Nginx或Kong。
3. **执行首次拆分**:将 SSA 和 DC 模块(连同它们的 stats\_schema从主应用中**物理拆分**出来打包成第一个独立的微服务采用6.1节的“最优版”架构)。
4. **开发单机版**启动第一个Electron项目按照【7.4】中的路径进行“重组”采用6.2节的“单机版”架构)。
### **9.3 阶段三:全面微服务 (18个月+)**
* **目标**:支持灵活的业务组合和团队扩张。
* **架构**:随着业务发展,将 ASL, PKB 等其他成熟模块也逐步拆分为独立的微服务,实现最终的“乐高积木式”的灵活架构。
* **<2A><EFBFBD>**嚗𡁏𣈲<F0A1818F><F0A388B2><EFBFBD>瘣餌<E798A3>銝𡁜𦛚蝏<F0A69B9A><E89D8F><EFBFBD><EFBFBD>𣪧<EFBFBD><F0A3AAA7><EFBFBD>撘𨬭<E69298>?
* **<2A><EFBFBD>**嚗𡁻<E59A97><F0A181BB><EFBFBD>銝𡁜𦛚<F0A1819C><EFBFBD><EFBFBD><E59A97> ASL, PKB 蝑匧<E89D91>隞𡝗<E99A9E><F0A19D97><EFBFBD><EFBFBD>𦯀<EFBFBD><F0A6AF80>鞉郊<E99E89><E9838A><EFBFBD>銝箇𡠺蝡讠<E89DA1>敺格<E695BA><E6A0BC><EFBFBD>摰䂿緵<E482BF><E7B7B5><EFBFBD><E89D8F><EFBFBD><EFBFBD>擃条妖<E69DA1><EFBFBD><E585B8><EFBFBD><E89098>菜暑<E88F9C><EFBFBD><E59786>?
## **10\. 结论**
<EFBFBD>祆沲<EFBFBD><EFBFBD>䲮獢<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>珮*\*<2A>𨀣<EFBFBD>餈𥕞<E9A488>𩄼*\*<2A><><EFBFBD><EFBFBD><EFBFBD><E585B8><EFBFBD><EFBFBD><EFBFBD>嗆挾銝<E68CBE>嚗厰<E59A97><EFBFBD><E69C9E>𨀣芋<F0A880A3><EFBFBD><E5A092><EFBFBD><E893A5><EFBFBD><EFBFBD><E99C82><EFBFBD><EFBFBD><E598A5>砍虬<E7A08D><E899AC>翮隞<E7BFAE><E99A9E>笔漲嚗<E6BCB2><E59A97><EFBFBD><EFBFBD><EFBFBD><E69C9E>靝誨<E99D9D>?<3F>唳旿<E594B3>𠉛氖<F0A0899B><EFBFBD><E598A5>𨅯<EFBFBD><F0A885AF>¥ocker<65><EFBFBD><EFBFBD>蝥芸<E89DA5>嚗䔶蛹<E494B6>芣䔉嚗<E49489>𧫴畾萎<E795BE><E8908E><EFBFBD><EFBFBD>嚗匧<E59A97>憭齿<E686AD>敺格<E695BA><E6A0BC><EFBFBD>憭𡁻<E686AD>蝵脣耦<E884A3><E880A6><EFBFBD>撟單<E6929F><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E988AD>摰䂿<E691B0><E482BF>啣抅嚗屸<E59A97><E5B1B8><EFBFBD><E6BBA2>芣䔉<E88AA3><EFBFBD><EFBFBD><E398BE><EFBFBD><E4BAA6>暸𠗕<E69AB8><EFBFBD><E689B3><EFBFBD>
本架构方案的核心是\*\*“演进”\*\*。它在初期(阶段一)通过“模块化单体”保证了初创公司的迭代速度,同时通过“代码/数据隔离”和“全面Docker化”的纪律为未来阶段二、三向复杂微服务和多部署形态的平滑过渡打下了坚实的地基避免了未来推倒重来的灾难性成本。

View File

@@ -1,63 +1,63 @@
# AI科研助手 - 技术架构总览
> **最后更新2025-10-10**
> **鏂规<EFBFBD>鐗堟湰锛歷2.0锛堟渶缁堜紭鍖栫増锛?*
> **鏂囨。璇存槑锛?* 鏈<>枃妗槸鎶€鏈<E282AC>灦鏋勭殑蹇<E6AE91>€熷弬鑰冩寚鍗楋紝閫傚悎鏂颁汉蹇<E6B189>€熶簡瑙暣浣撴妧鏈<E5A6A7>柟妗?
> **方案版本v2.0(最终优化版)**
> **文档说明:** 本文档是技术架构的快速参考指南,适合新人快速了解整体技术方案
---
## 馃搳 鏍稿績鏁版嵁涓€瑙?
## 📊 核心数据一览
| 鎸囨爣 | 鏁板€?|
| 指标 | 数值 |
|------|------|
| **寮€鍙戝懆鏈?* | 2.5涓<EFBFBD>湀锛?0鍛<30> |
| **寮€鍙戞垚鏈?* | 49,300 |
| **鎶€鏈<EFBFBD>毦搴?* | 猸愨瓙猸愶紙涓<E7B499>瓑锛?|
| **鏈堝害鎴愭湰** | 16,520锛?000鐢ㄦ埛锛?|
| **鍥㈤槦瑙勬ā** | 2浜猴紙1鍏ㄦ爤 + 1鍓嶇<E98D93>锛?|
| **开发周期** | 2.5个月10周 |
| **开发成本** | ¥49,300 |
| **技术难度** | ⭐⭐⭐(中等) |
| **月度成本** | ¥16,5201000用户) |
| **团队规模** | 21全栈 + 1前端 |
---
## 馃幆 鍏抽敭闇€姹傛緞娓?
## 🎯 关键需求澄清
### 鐭ヨ瘑搴撹<EFBFBD>妯★紙閲嶈<EFBFBD>鍙樻洿锛?
### 知识库规模(重要变更)
| 项目 | 限制 |
|------|------|
| 鐭ヨ瘑搴撴暟閲?| 3涓?鐢ㄦ埛 |
| 鏂囦欢鏁伴噺 | 50涓?鐭ヨ瘑搴?|
| 知识库数量 | 3个/用户 |
| 文件数量 | 50个/知识库 |
| 文件格式 | PDF、DOCX |
| 鍗曠敤鎴锋渶澶?| 150涓<30>枃浠?|
| 单用户最大 | 150个文件 |
**褰卞搷锛?* 鎶€鏈<E282AC>毦搴︿粠猸愨瓙猸愨瓙猸愰檷鑷斥瓙猸愨瓙锛孌ify瀹屽叏婊¤冻闇€姹傦紒
**影响:** 技术难度从⭐⭐⭐⭐⭐降至⭐⭐⭐Dify完全满足需求
---
## 馃彈锔?鎶€鏈<E282AC>灦鏋勶紙涓€鍥剧湅鎳傦級
## 🏗️ 技术架构(一图看懂)
```
鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
鈹? 鍓嶇<EFBFBD>锛圧eact + Vite锛? 鈹?
鈹? - 椤圭洰绠$悊锛堣嚜鐮旓級 鈹?
鈹? - 鏅鸿兘浣撻€夋嫨锛堣嚜鐮旓級 鈹?
鈹? - 鑱婂ぉ鐣岄潰锛堝弬鑰僉obeChat锛夆瓙 鈹?
鈹? - 鐭ヨ瘑搴撶<EFBFBD>鐞嗭紙鑷<EFBFBD>爺锛? 鈹?
鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
鈫?REST API
鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
鈹? 涓氬姟灞?(Node.js/TypeScript) 鈹?
鈹? - 瀵硅瘽閫昏緫锛堣嚜鐮旓級猸? 鈹?
鈹? - 椤圭洰/璇鹃<E79287> 鈹?
鈹? - 鏅鸿兘浣撹矾鐢憋紙閰嶇疆鍖栵級猸? 鈹?
鈹? - 绠€鍖栬繍钀ュ悗鍙扳瓙 鈹?
鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
鈫? 鈫?
鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹? 鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
鈹? Dify 鈹? 鈹? LLM API 鈹?
鈹? 锛堜粎RAG锛夆瓙 鈹? 鈹? - DeepSeek-V3猸愨攤
鈹? - 鐭ヨ瘑搴撴<EFBFBD>绱? 鈹? 鈹? - Qwen3 猸? 鈹?
鈹? - Qdrant(鍐呯疆)猸?鈹? 鈹? 鈹?
鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹? 鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
┌─────────────────────────────────────────┐
前端React + Vite
- 项目管理(自研)
- 智能体选择(自研)
- 聊天界面参考LobeChat)⭐
- 知识库管理(自研)
└─────────────────────────────────────────┘
REST API
┌─────────────────────────────────────────┐
业务层 (Node.js/TypeScript)
- 对话逻辑(自研)⭐
- 项目/课题管理
- 智能体路由(配置化)⭐
- 简化运营后台⭐
└─────────────────────────────────────────┘
┌──────────────────┐ ┌─────────────────┐
Dify │ │ LLM API
仅RAG - DeepSeek-V3⭐│
- 知识库检索 - Qwen3
- Qdrant(内置)⭐ │ │
└──────────────────┘ └─────────────────┘
```
---
@@ -68,72 +68,72 @@
| 方案 | 选择 | 原因 |
|------|------|------|
| **鍓嶇<EFBFBD>UI** | 鍙傝€僉obeChat缁勪欢 鉁?| 鎴愮啛绋冲畾锛岃妭鐪?.5澶?|
| **瀵硅瘽閫昏緫** | <EFBFBD>爺锛堣皟鐢↙LM API锛夆渽 | 涓氬姟鍙<E5A79F>帶锛屾牳蹇冨彧瑕?姝?|
| Dify瀵硅瘽鍔熻兘 | 鉂?涓嶇敤 | 涓嶉€傚悎12涓<32>櫤鑳戒綋绠 |
| LobeChat鏁翠綋 | 鉂?涓嶇敤 | 缂哄皯椤圭洰绠$悊鍔熻兘 |
| **前端UI** | 参考LobeChat组件 ✅ | 成熟稳定节省9.5天 |
| **对话逻辑** | 自研调用LLM API✅ | 业务可控核心只要4步 |
| Dify对话功能 | ❌ 不用 | 不适合12个智能体管理 |
| LobeChat整体 | ❌ 不用 | 缺少项目管理功能 |
### 2. RAG系统
| 功能 | 方案 |
|------|------|
| **鐭ヨ瘑搴撶<EFBFBD>鐞?* | Dify 鉁?|
| **鏂囨。瑙f瀽** | Dify鍐呯疆 鉁?|
| **鍚戦噺鏁版嵁搴?* | Dify鍐呯疆Qdrant 鉁?|
| **妫€绱?* | Dify API 鉁?|
| <EFBFBD>RAG | 鉂?涓嶉渶瑕?|
| **知识库管理** | Dify |
| **文档解析** | Dify内置 ✅ |
| **向量数据库** | Dify内置Qdrant |
| **检索** | Dify API |
| 自建RAG | ❌ 不需要 |
### 3. 运营后台
| 鍔熻兘 | 鐘舵€?| 瀹炵幇鏂瑰紡 |
| 功能 | 状态 | 实现方式 |
|------|------|---------|
| 鐢ㄦ埛绠$悊 | 鉁?淇濈暀 | 绠€鍖栫増 |
| 鏁版嵁缁熻<EFBFBD> | 鉁?淇濈暀 | 鍩虹<E98DA9><EFBFBD>〃鐩?|
| 妯″瀷绠$悊 | 鉂?鍒犻櫎 | `config/models.yaml` |
| 鏅鸿兘浣撶<EFBFBD>鐞?| 鉂?鍒犻櫎 | `config/agents.yaml` |
| Prompt閰嶇疆 | 鉂?鍒犻櫎 | `prompts/*.txt` |
| 用户管理 | ✅ 保留 | 简化版 |
| 数据统计 | ✅ 保留 | 基础仪表盘 |
| 模型管理 | ❌ 删除 | `config/models.yaml` |
| 智能体管理 | ❌ 删除 | `config/agents.yaml` |
| Prompt配置 | ❌ 删除 | `prompts/*.txt` |
### 4. 大模型选择
| 浼樺厛绾?| 妯″瀷 | 浠锋牸 | 鐢ㄩ€?|
| 优先级 | 模型 | 价格 | 用途 |
|--------|------|------|------|
| **涓诲姏** | DeepSeek-V3 | 1/鐧句竾tokens | 90%鐨勮<EFBFBD>姹?|
| **主力** | DeepSeek-V3 | ¥1/百万tokens | 90%的请求 |
| **备用** | Qwen3-72B | ¥4/百万tokens | 需要更强中文理解时 |
| <EFBFBD>€?| Gemini 2.0 | 2.7/鐧句竾tokens | 鍥介檯鐢ㄦ埛 |
| 可选 | Gemini 2.0 | ¥2.7/百万tokens | 国际用户 |
---
## 💰 成本明细
### 寮€鍙戞垚鏈?
### 开发成本
| 项目 | 金额 |
|------|------|
| 浜哄姏锛?浜烘湀锛?| 48,000 |
| 人力4人月 | ¥48,000 |
| 服务器(开发环境) | ¥1,250 |
| LLM API测试 | ¥50 |
| **总计** | **¥49,300** |
### 鏈堝害杩愯惀鎴愭湰锛?000鐢ㄦ埛锛?
### 月度运营成本1000用户
| 项目 | 金额 |
|------|------|
| 鍩虹<EFBFBD>璁炬柦锛堟湇鍔″櫒锛?| 1,200 |
| LLM API锛圖eepSeek-V3锛?| 180 |
| 瀵硅薄瀛樺偍锛堢煡璇嗗簱锛?| 140 |
| 浜哄姏锛?浜鸿繍缁达級 | 15,000 |
| **鎬昏<EFBFBD>** | **楼16,520/鏈?* |
| 基础设施(服务器) | ¥1,200 |
| LLM APIDeepSeek-V3 | ¥180 |
| 对象存储(知识库) | ¥140 |
| 人力1人运维 | ¥15,000 |
| **总计** | **¥16,520/月** |
### 鐭ヨ瘑搴撳瓨鍌ㄨ<EFBFBD>鎯?
### 知识库存储详情
```
鍗曠敤鎴凤細150涓<EFBFBD>枃浠?脳 5MB = 750MB
1000鐢ㄦ埛锛?50GB鎬诲瓨鍌?
单用户150个文件 × 5MB = 750MB
1000用户750GB总存储
对象存储阿里云OSS
- 瀛樺偍璐癸細楼90/鏈?
- 娴侀噺璐癸細楼50/鏈?
- 鎬昏<EFBFBD>锛毬?40/鏈?
- 存储费:¥90/
- 流量费:¥50/
- 总计¥140/
```
---
@@ -142,34 +142,34 @@
| 阶段 | 时间 | 主要任务 |
|------|------|---------|
| **闃舵<EFBFBD>1** | 1.5鍛?| 鍩虹<E98DA9><EFBFBD>缓 + 澶嶇敤LobeChat缁勪欢 |
| **闃舵<EFBFBD>2** | 3.5鍛?| 鏍稿績鍔熻兘锛?2涓<32>櫤鑳戒綋 + 瀵硅瘽锛?|
| **闃舵<EFBFBD>3** | 2鍛?| 楂樼骇鍔熻兘锛圧AG + 鏂囨。鐢熸垚锛?|
| **闃舵<EFBFBD>4** | 1鍛?| 绠€鍖栬繍钀ュ悗鍙?|
| **闃舵<EFBFBD>5** | 2鍛?| 娴嬭瘯浼樺寲 |
| **阶段1** | 1.5周 | 基础搭建 + 复用LobeChat组件 |
| **阶段2** | 3.5周 | 核心功能12个智能体 + 对话) |
| **阶段3** | 2周 | 高级功能RAG + 文档生成) |
| **阶段4** | 1周 | 简化运营后台 |
| **阶段5** | 2周 | 测试优化 |
### 闃舵<EFBFBD>1锛氬熀纭€鎼<EFBFBD>缓锛?.5鍛<EFBFBD>
- [ ] 鍓嶇<EFBFBD>妗嗘灦锛圧eact + Vite + TailwindCSS锛?
- [ ] **澶嶇敤LobeChat鑱婂ぉUI缁勪欢** 猸?
- [ ] 鍚庣<EFBFBD>妗嗘灦锛團astify + Prisma + PostgreSQL锛?
- [ ] Dify閮ㄧ讲锛圖ocker锛?
### 阶段1基础搭建1.5周)
- [ ] 前端框架React + Vite + TailwindCSS
- [ ] **复用LobeChat聊天UI组件**
- [ ] 后端框架Fastify + Prisma + PostgreSQL
- [ ] Dify部署Docker
- [ ] DeepSeek-V3 + Qwen3接入
### 阶段2核心功能3.5周)
- [ ] 鐢ㄦ埛璁よ瘉锛圝WT锛?
- [ ] 用户认证JWT
- [ ] 项目/课题CRUD
- [ ] 12<EFBFBD>櫤鑳戒綋閰嶇疆锛坄agents.yaml`锛?
- [ ] 瀵硅瘽绯荤粺锛堜笂涓嬫枃缁勮<EFBFBD> + 娴佸紡杈撳嚭锛?
- [ ] 鐭ヨ瘑搴撻泦鎴愶紙Dify API锛?
- [ ] 12个智能体配置(`agents.yaml`
- [ ] 对话系统(上下文组装 + 流式输出)
- [ ] 知识库集成(Dify API
### 阶段3高级功能2周
- [ ] 澶氭ā鍨嬪垏鎹<EFBFBD>DeepSeek/Qwen锛?
- [ ] 多模型切换(DeepSeek/Qwen
- [ ] 历史记录管理
- [ ] 鍥哄畾鍒伴」鐩<EFBFBD>儗鏅<EFBFBD>姛鑳?
- [ ] 固定到项目背景功能
- [ ] 文档生成CRF、研究方案
### 阶段4简化运营后台1周
- [ ] 鐢ㄦ埛鍒楄〃涓庣<EFBFBD>鐞?
- [ ] 用户列表与管理
- [ ] 基础数据统计
- [ ] 对话记录查看
@@ -180,29 +180,29 @@
---
## 馃洜锔?鎶€鏈<E282AC>
## 🛠️ 技术栈
### 前端
```
- React 18 + TypeScript
- Vite构建工具
- TailwindCSS锛圲I妗嗘灦锛?
- TailwindCSSUI框架
- Zustand状态管理
- LobeChat组件聊天UI
- react-markdown锛圡arkdown娓叉煋锛?
- react-markdownMarkdown渲染)
```
### 后端
```
- Node.js + Fastify + TypeScript
- Prisma锛圤RM锛?
- PostgreSQL锛堟暟鎹<EFBFBD>簱锛?
- PrismaORM
- PostgreSQL(数据库)
- Redis缓存
```
### <EFBFBD>笁鏂规湇鍔?
### 第三方服务
```
- Dify锛圧AG鐭ヨ瘑搴擄級猸?
- DifyRAG知识库
- DeepSeek-V3主力LLM
- Qwen3备用LLM
- 阿里云OSS对象存储
@@ -210,86 +210,86 @@
---
## 鉁?鏍稿績浼樺娍
## ✅ 核心优势
### 1. 开发效率高
- 鉁?澶嶇敤LobeChat鑱婂ぉUI锛氳妭鐪?.5澶?
- 鉁?浣跨敤Dify RAG锛氳妭鐪?0澶?
- 鉁?閰嶇疆鍖栨櫤鑳戒綋锛氳妭鐪?澶?
- 鉁?鎬昏妭鐪侊細**绾?4.5澶?*
- ✅ 复用LobeChat聊天UI节省9.5天
- ✅ 使用Dify RAG节省40天
- ✅ 配置化智能体节省5天
- ✅ 总节省:**约54.5天**
### 2. 成本可控
- 鉁?寮€鍙戞垚鏈<E59E9A>細楼49,300锛坴s 绾<>墜鍐櫬?0k+锛?
- 鉁?鏈堝害LLM鎴愭湰锛毬?80锛坴s GPT-4 2,500锛?
- 鉁?鐭ヨ瘑搴撳瓨鍌<E793A8>細楼140/鏈堬紙閫傚害瑙勬ā锛?
- ✅ 开发成本¥49,300vs 纯手写¥80k+
- ✅ 月度LLM成本¥180vs GPT-4 ¥2,500
- ✅ 知识库存储¥140/月(适度规模)
### 3. 技术风险低
- 鉁?Dify锛?0k+ Stars锛岀敓浜х骇绋冲畾
- 鉁?LobeChat锛?0k+ Stars锛屾垚鐔熸柟妗?
- 鉁?DeepSeek-V3锛氭€т环姣旀瀬楂?
- Dify50k+ Stars,生产级稳定
- LobeChat40k+ Stars,成熟方案
- DeepSeek-V3:性价比极高
### 4. 架构灵活
- 鉁?涓氬姟閫昏緫瀹屽叏鍙<E58F8F>
- 鉁?鍙<>殢鏃舵浛鎹<E6B59B>AG寮曟搸
- 鉁?鍙<>殢鏃跺<E98F83>鍑廘LM妯″瀷
- ✅ 业务逻辑完全可控
- ✅ 可随时替换RAG引擎
- ✅ 可随时增减LLM模型
---
## 📋 核心文件结构
```
椤圭洰鏍圭洰褰?
项目根目录/
├── frontend/ # 前端
鈹? 鈹溾攢鈹€ src/
鈹? 鈹? 鈹溾攢鈹€ components/
鈹? 鈹? 鈹? 鈹溾攢鈹€ chat/ # 鑱婂ぉ缁勪欢锛堝弬鑰僉obeChat锛夆瓙
鈹? 鈹? 鈹? 鈹? 鈹溾攢鈹€ ChatMessage.tsx
鈹? 鈹? 鈹? 鈹? 鈹溾攢鈹€ ChatInput.tsx
鈹? 鈹? 鈹? 鈹? 鈹斺攢鈹€ StreamRenderer.tsx
鈹? 鈹? 鈹? 鈹溾攢鈹€ project/ # 椤圭洰绠$悊
鈹? 鈹? 鈹? 鈹斺攢鈹€ kb/ # 鐭ヨ瘑搴撶<EFBFBD>鐞?
鈹? 鈹? 鈹溾攢鈹€ pages/
鈹? 鈹? 鈹斺攢鈹€ services/
鈹? 鈹斺攢鈹€ package.json
鈹?
│ ├── src/
│ │ ├── components/
│ │ │ ├── chat/ # 聊天组件参考LobeChat)⭐
│ │ │ │ ├── ChatMessage.tsx
│ │ │ │ ├── ChatInput.tsx
│ │ │ │ └── StreamRenderer.tsx
│ │ │ ├── project/ # 项目管理
│ │ │ └── kb/ # 知识库管理
│ │ ├── pages/
│ │ └── services/
│ └── package.json
├── backend/ # 后端
鈹? 鈹溾攢鈹€ src/
鈹? 鈹? 鈹溾攢鈹€ services/
鈹? 鈹? 鈹? 鈹溾攢鈹€ chat.service.ts # 瀵硅瘽鏈嶅姟 猸?
鈹? 鈹? 鈹? 鈹溾攢鈹€ kb.service.ts # 鐭ヨ瘑搴撴湇鍔?
鈹? 鈹? 鈹? 鈹斺攢鈹€ project.service.ts
鈹? 鈹? 鈹溾攢鈹€ adapters/
鈹? 鈹? 鈹? 鈹斺攢鈹€ llm-factory.ts # LLM閫傞厤鍣?猸?
鈹? 鈹? 鈹溾攢鈹€ clients/
鈹? 鈹? 鈹? 鈹斺攢鈹€ dify.ts # Dify瀹㈡埛绔?
鈹? 鈹? 鈹斺攢鈹€ config/
鈹? 鈹? 鈹斺攢鈹€ agent-loader.ts # 鏅鸿兘浣撻厤缃<EFBFBD>姞杞?猸?
鈹? 鈹溾攢鈹€ config/
鈹? 鈹? 鈹溾攢鈹€ agents.yaml # 鏅鸿兘浣撻厤缃?猸?
鈹? 鈹? 鈹斺攢鈹€ models.yaml # 妯″瀷閰嶇疆 猸?
鈹? 鈹溾攢鈹€ prompts/ # Prompt鏂囦欢 猸?
鈹? 鈹? 鈹溾攢鈹€ picos_system.txt
鈹? 鈹? 鈹溾攢鈹€ topic_evaluation_system.txt
鈹? 鈹? 鈹斺攢鈹€ ...锛堝叡12涓<32>櫤鑳戒綋锛?
鈹? 鈹斺攢鈹€ package.json
鈹?
│ ├── src/
│ │ ├── services/
│ │ │ ├── chat.service.ts # 对话服务 ⭐
│ │ │ ├── kb.service.ts # 知识库服务
│ │ │ └── project.service.ts
│ │ ├── adapters/
│ │ │ └── llm-factory.ts # LLM适配器 ⭐
│ │ ├── clients/
│ │ │ └── dify.ts # Dify客户端
│ │ └── config/
│ │ └── agent-loader.ts # 智能体配置加载 ⭐
│ ├── config/
│ │ ├── agents.yaml # 智能体配置 ⭐
│ │ └── models.yaml # 模型配置 ⭐
│ ├── prompts/ # Prompt文件 ⭐
│ │ ├── picos_system.txt
│ │ ├── topic_evaluation_system.txt
│ │ └── ...共12个智能体
│ └── package.json
└── docker-compose.yml # Dify部署
```
---
## 馃殌 蹇<>€熷惎鍔?
## 🚀 快速启动
### 1. 准备工作
**鐢宠<EFBFBD>API Key锛?*
**申请API Key**
- [ ] DeepSeek API Key (https://platform.deepseek.com)
- [ ] 阿里云DashScope Key (https://dashscope.aliyun.com)
- [ ] 阿里云OSS (https://oss.console.aliyun.com)
**准备服务器:**
- [ ] 浜戞湇鍔″櫒 4鏍?G锛堝紑鍙戠幆澧冿級
- [ ] PostgreSQL 鏁版嵁搴?
- [ ] 云服务器 4核8G开发环境
- [ ] PostgreSQL 数据库
- [ ] Redis 缓存
### 2. 部署Dify
@@ -306,7 +306,7 @@ docker-compose up -d
# 创建账号并获取API Key
```
### 3. 鍚庣<EFBFBD>寮€鍙?
### 3. 后端开发
```bash
cd backend
@@ -314,21 +314,21 @@ npm install
# 配置环境变量
cp .env.example .env
# <EFBFBD>叆锛?
# 填入:
# - DATABASE_URL
# - REDIS_URL
# - DEEPSEEK_API_KEY
# - DASHSCOPE_API_KEY
# - DIFY_API_KEY
# 杩愯<EFBFBD>鏁版嵁搴撹縼绉?
# 运行数据库迁移
npx prisma migrate dev
# 启动开发服务器
npm run dev
```
### 4. 鍓嶇<EFBFBD>寮€鍙?
### 4. 前端开发
```bash
cd frontend
@@ -347,66 +347,66 @@ npm run dev
## 📚 相关文档
### 设计文档
- [浜у搧闇€姹傛枃妗?PRD)](./浜у搧闇€姹傛枃妗?PRD).md) - 瀹屾暣鐨勪骇鍝侀渶姹?
- [鏁版嵁搴撹<EFBFBD>璁℃枃妗<EFBFBD>(../01-璁捐<E79281>鏂囨。/鏁版嵁搴撹<E690B4>璁℃枃妗?md) - 鏁版嵁搴撹〃缁撴瀯
- [产品需求文档(PRD)](./产品需求文档(PRD).md) - 完整的产品需求
- [数据库设计文档](../01-设计文档/数据库设计文档.md) - 数据库表结构
- [API设计规范](../01-设计文档/API设计规范.md) - 所有API定义
- [浠g爜瑙勮寖](../02-寮€鍙戣<EFBFBD>鑼?浠g爜瑙勮寖.md) - 浠g爜椋庢牸瑙勮寖
- [代码规范](../02-开发规范/代码规范.md) - 代码风格规范
- [核心业务规则](../03-业务规则/核心业务规则总览.md) - 业务逻辑规则
### 寮€鍙戣<EFBFBD>鍒?
- [寮€鍙戦噷绋嬬<EFBFBD>](../04-寮€鍙戣<EFBFBD>鍒?寮€鍙戦噷绋嬬<E7BB8B>.md) - 璇︾粏鐨?0鍛ㄥ紑鍙戣<E98D99>鍒?
### 开发计划
- [开发里程碑](../04-开发计划/开发里程碑.md) - 详细的10周开发计划
### 鍙傝€冩枃妗?
- **鎶€鏈<EFBFBD>灦鏋勯€夊瀷瀵规瘮鏂规<EFBFBD>.md** - 瀹屾暣鎶€鏈<E282AC>柟妗堬紙鍦ㄩ」鐩<E3808D>牴鐩<E789B4>綍锛?
### 参考文档
- **技术架构选型对比方案.md** - 完整技术方案(在项目根目录)
- **对话系统实现方案对比.md** - 对话功能详细说明(在项目根目录)
- **鐭ヨ瘑搴撻渶姹傝皟鏁磋<EFBFBD>鏄?md** - 鐭ヨ瘑搴撳疄鐜版柟妗堬紙鍦ㄩ」鐩<E3808D>牴鐩<E789B4>綍锛?
- **知识库需求调整说明.md** - 知识库实现方案(在项目根目录)
---
## 🎯 关键决策清单
**鍦ㄥ紑濮嬪紑鍙戝墠锛岃<EFBFBD><EFBFBD><EFBFBD>锛?*
**在开始开发前,请确认:**
- [ ] **鑱婂ぉ瀹炵幇鏂瑰紡锛?* 鍙傝€僉obeChat + 鑷<>爺瀵硅瘽閫昏緫 鉁?
- [ ] **RAG绯荤粺锛?* 浣跨敤Dify锛堟棤闇€鑷<E282AC>缓锛夆渽
- [ ] **聊天实现方式:** 参考LobeChat + 自研对话逻辑 ✅
- [ ] **RAG系统:** 使用Dify无需自建
- [ ] **向量数据库:** Dify内置Qdrant无需关心
- [ ] **杩愯惀鍚庡彴锛?* 绠€鍖栫増锛堥厤缃<E58EA4>枃浠剁<E6B5A0>鐞嗭級鉁?
- [ ] **涓诲姏LLM锛?* DeepSeek-V3 鉁?
- [ ] **澶囩敤LLM锛?* Qwen3 鉁?
- [ ] **鐭ヨ瘑搴撻檺鍒讹細** 3涓?鐢ㄦ埛锛?0涓<30>枃浠?搴?鉁?
- [ ] **寮€鍙戝懆鏈燂細** 2.5<EFBFBD>湀 鉁?
- [ ] **鍥㈤槦瑙勬ā锛?* 2浜?鉁?
- [ ] **运营后台:** 简化版(配置文件管理)✅
- [ ] **主力LLM** DeepSeek-V3
- [ ] **备用LLM** Qwen3
- [ ] **知识库限制:** 3个/用户50个文件/库 ✅
- [ ] **开发周期:** 2.5个月 ✅
- [ ] **团队规模:** 2人 ✅
---
## 💡 常见问题 FAQ
### Q1: 为什么不直接用Dify的对话功能
**A:** Dify瀵硅瘽鍔熻兘闇€瑕佷负姣忎釜鏅鸿兘浣撳垱寤虹嫭绔嬪簲鐢<EFBFBD>紝12涓<EFBFBD>櫤鑳戒綋绠悊澶嶆潅锛屼笖缂哄皯椤圭洰绠悊鍔熻兘銆傛垜浠<EFBFBD>彧鐢―ify鍋歊AG妫€绱€€?
**A:** Dify对话功能需要为每个智能体创建独立应用12个智能体管理复杂且缺少项目管理功能。我们只用Dify做RAG检索。
### Q2: 对话功能自己实现会很复杂吗?
**A:** 涓嶅<EFBFBD>鏉傦紒鏍稿績鍙<EFBFBD><EFBFBD>4姝ワ細鎺ユ敹娑堟伅 鈫?缁勮<E7BC81>涓婁笅鏂?鈫?璋冪敤LLM 鈫?杩斿洖娴佸紡缁撴灉銆傚弬鑰僉obeChat鐨勫疄鐜帮紝绾﹂渶4澶┿€?
**A:** 不复杂核心只要4步接收消息 → 组装上下文 → 调用LLM → 返回流式结果。参考LobeChat的实现约需4天。
### Q3: 150<EFBFBD>枃浠?鐢ㄦ埛锛孌ify澶熺敤鍚楋紵
**A:** 瀹屽叏澶熺敤锛丏ify鍗曚釜鐭ヨ瘑搴撴敮鎸佷笂涓囦釜鏂囨。鐗囨<EFBFBD>锛屾垜浠<EFBFBD>殑闇€姹傝繙浣庝簬涓婇檺銆?
### Q3: 150个文件/用户Dify够用吗
**A:** 完全够用Dify单个知识库支持上万个文档片段我们的需求远低于上限。
### Q4: 涓轰粈涔堥€夋嫨DeepSeek-V3锛?
**A:** 鎬т环姣旀瀬楂橈紙楼1/鐧句竾tokens锛夛紝鎬ц兘鎺ヨ繎GPT-4锛屽勾搴﹀彲鑺傜渷楼27,840銆?
### Q4: 为什么选择DeepSeek-V3
**A:** 性价比极高¥1/百万tokens性能接近GPT-4年度可节省¥27,840
### Q5: 2.5<EFBFBD>湀鐪熺殑鑳藉畬鎴愬悧锛?
**A:** <EFBFBD>互锛侀€氳繃澶嶇敤LobeChat缁勪欢銆佷娇鐢―ify RAG銆侀厤缃<E58EA4>寲鏅鸿兘浣擄紝鎴戜滑鑺傜渷浜嗙害54澶╁紑鍙戞椂闂淬€?
### Q5: 2.5个月真的能完成吗?
**A:** 可以通过复用LobeChat组件、使用Dify RAG、配置化智能体我们节省了约54天开发时间。
---
## 🎉 总结
**杩欐槸涓€涓<EFBFBD>粡杩囧厖鍒嗕紭鍖栥€佹垚鏈<EFBFBD>彲鎺с€佹妧鏈<EFBFBD>彲琛岀殑鏂规<EFBFBD>锛?*
**这是一个经过充分优化、成本可控、技术可行的方案:**
鉁?**寮€鍙戝懆鏈燂細** 2.5<EFBFBD>
鉁?**寮€鍙戞垚鏈<E59E9A>細** 楼49,300
鉁?**鏈堝害鎴愭湰锛?* 楼16,520锛?000鐢ㄦ埛锛?
鉁?**鎶€鏈<E282AC>毦搴︼細** 猸愨瓙猸愶紙涓<E7B499>瓑锛?
鉁?**椋庨櫓绛夌骇锛?* 浣庯紙浣跨敤鎴愮啛缁勪欢鍜屾湇鍔★級
**开发周期:** 2.5个月
**开发成本:** ¥49,300
**月度成本:** ¥16,5201000用户)
**技术难度:** ⭐⭐⭐(中等)
**风险等级:** 低(使用成熟组件和服务)
**立即可以开始!** 🚀
@@ -414,8 +414,8 @@ npm run dev
**文档版本v2.0**
**最后更新2025-10-10**
**鏂囨。浣嶇疆锛?* `docs/00-椤圭洰姒傝堪/鎶€鏈<E282AC>灦鏋勬€昏<E282AC>.md`
**浣滆€咃細** AI鎶€鏈<EFBFBD>【闂?
**文档位置:** `docs/00-项目概述/技术架构总览.md`
**作者:** AI技术顾问

View File

@@ -1,7 +1,7 @@
# AIclinicalresearch 鏂囨。姊崇悊涓庡樊寮傚垎鏋?
# AIclinicalresearch 文档梳理与差异分析
> **鏂囨。鐗堟湰锛?* v1.0
> **鍒涘缓鏃ユ湡锛?* 2025-11-06
> **文档版本:** v1.0
> **创建日期:** 2025-11-06
> **维护者:** 项目团队
> **最后更新:** 2025-11-06
@@ -9,63 +9,63 @@
## 📋 执行摘要
<EFBFBD>枃妗<EFBFBD>AIclinicalresearch椤圭洰涓嬬殑鎵€鏈夋枃妗h繘琛屼簡绯荤粺姊崇悊,骞堕噸鐐瑰<E99090>姣斾簡**鏈€鏂伴渶姹傛枃妗?*锛堝9璇佸惊绉戞妧 AI绉戠爺浜у搧闇€姹傛枃妗?md 鍜?鎶€鏈<E282AC>灦鏋勭櫧鐨<E6ABA7>功.md锛変笌**鐜版湁鏂囨。**涔嬮棿鐨勫樊寮傘€?
本文档对AIclinicalresearch项目下的所有文档进行了系统梳理,并重点对比了**最新需求文档**(壹证循科技 AI科研产品需求文档.md 和 技术架构白皮书.md与**现有文档**之间的差异。
### 🎯 核心发现
**最新需求文档2025-11-05反映了产品战略的重大调整**
1. **浜у搧瀹氫綅鍙樺寲锛?* 浠庡崟涓€鐨?AI绉戠爺鍔╂墜"鎵╁睍涓?*7澶фā鍧楃殑缁煎悎鎬<E6828E>I绉戠爺骞冲彴**
2. **鍟嗕笟妯″紡鍙樺寲锛?* 浠庣畝鍗昐aaS妯″紡鎵╁睍涓?*4绉嶉儴缃插舰鎬?*锛堜簯绔疭aaS銆佺<E98A86>鏈夊寲銆佹贩鍚堥儴缃层€佸崟鏈虹増锛?
3. **鎶€鏈<EFBFBD>灦鏋勫彉鍖栵細** 浠?妯″潡鍖栧崟浣?婕旇繘涓?*寰<>湇鍔℃灦鏋?*锛屾敮鎸佹ā鍧楀寲鍞<E5AFB2>
4. **<EFBFBD>爣鐢ㄦ埛鍙樺寲锛?* 浠庣<E6B5A0>鐮斾汉鍛樻墿灞曞埌**鍖婚櫌鏈烘瀯**锛堝己璋冩暟鎹<E69A9F>畨鍏ㄥ拰绉佹湁鍖栭儴缃诧級
1. **产品定位变化:** 从单一的"AI科研助手"扩展为**7大模块的综合性AI科研平台**
2. **商业模式变化:** 从简单SaaS模式扩展为**4种部署形态**云端SaaS、私有化、混合部署、单机版
3. **技术架构变化:** 从"模块化单体"演进为**微服务架构**,支持模块化售卖
4. **目标用户变化:** 从科研人员扩展到**医院机构**(强调数据安全和私有化部署)
---
## 📚 文档结构梳理
### 1. 00-椤圭洰姒傝堪 鏂囦欢澶?
### 1. 00-项目概述 文件夹
| 鏂囨。鍚嶇О | 鐘舵€?| 鐗堟湰鏃ユ湡 | 鏍稿績鍐呭<E98D90> | 鏄<>惁绗﹀悎鏈€鏂伴渶姹?|
| 文档名称 | 状态 | 版本日期 | 核心内容 | 是否符合最新需求 |
|---------|------|---------|---------|----------------|
| **澹硅瘉寰<EFBFBD><EFBFBD>鎶€ AI绉戠爺浜у搧闇€姹傛枃妗?md** | 鉁?鏈€鏂?| 2025-11-05 | 7澶фā鍧楀姛鑳界煩闃点€?绉嶉儴缃叉ā寮忋€佸晢涓氭ā寮?| 鉁?鍩哄噯鏂囨。 |
| **澹硅瘉寰<EFBFBD><EFBFBD>鎶€AI绉戠爺浜у搧 - 鎶€鏈<E282AC>灦鏋勭櫧鐨<E6ABA7>.md** | 鉁?鏈€鏂?| 2025-11-05 | <EFBFBD>湇鍔℃灦鏋勩€佹妧鏈<EFBFBD>紓鏋勩€丒lectron鍗曟満鐗?| 鉁?鍩哄噯鏂囨。 |
| 浜у搧闇€姹傛枃妗?PRD).md | 鈿狅笍 鏃х増 | 2025-10-10 | 浠呭寘鍚獳I闂<EFBFBD>瓟銆佺煡璇嗗簱銆侀」鐩<EFBFBD><EFBFBD>鐞?| 鉂?**闇€瑕佹洿鏂?* |
| 鎶€鏈<EFBFBD>灦鏋勬€昏<EFBFBD>.md | 鈿狅笍 鏃х増 | 2025-10-10 | 鍩轰簬Dify+LobeChat鐨勭畝鍖栨灦鏋?| 鉂?**闇€瑕佹洿鏂?* |
| AI鏅鸿兘鏂囩尞PRD锛?锛?浜у搧姒傝<E5A792>.md | 鈿狅笍 閮ㄥ垎鏃?| 2025-10-21 | 6澶фā鍧楋紙鐮旂┒鏂规<E98F82>銆佹<E98A86>绱€€佸垵绛涖€佸<E282AC>绛涖€佹彁鍙栥€佸垎鏋愶級 | 鈿狅笍 **閮ㄥ垎绗﹀悎锛岄渶鏁村悎** |
| AI鏅鸿兘鏂囩尞PRD锛?锛?鍒濈瓫涓庡<E6B693>绛?md | 鈿狅笍 閮ㄥ垎鏃?| 2025-10-21 | 鍒濈瓫鍜屽<E98D9C>绛涜<E7BB9B>缁嗚<E7BC81>璁?| 鈿狅笍 **閮ㄥ垎绗﹀悎锛岄渶鏁村悎** |
| AI鏅鸿兘鏂囩尞PRD锛?锛?鎻愬彇涓庡垎鏋愭ā鍧?md | 鈿狅笍 閮ㄥ垎鏃?| 2025-10-21 | 鎻愬彇鍜屽垎鏋愯<E98F8B>缁嗚<E7BC81>璁?| 鈿狅笍 **閮ㄥ垎绗﹀悎锛岄渶鏁村悎** |
| 绯荤粺鎬讳綋鏋舵瀯璁捐<EFBFBD>.md | 鈿狅笍 鍗犱綅 | 2025-10-29 | 鍗犱綅鏂囨。锛屽緟瀹屽杽 | 鉂?**闇€瑕侀噸鍐?* |
| 璁捐<EFBFBD>鏂囨。瀹屾垚鎬荤粨.md | 鈿狅笍 鏃х増 | 2025-10-10 | 鍩轰簬鏃х増PRD鐨勬€荤粨 | 鉂?**闇€瑕佹洿鏂?* |
| **壹证循科技 AI科研产品需求文档.md** | ✅ 最新 | 2025-11-05 | 7大模块功能矩阵、4种部署模式、商业模式 | ✅ 基准文档 |
| **壹证循科技AI科研产品 - 技术架构白皮书.md** | ✅ 最新 | 2025-11-05 | 微服务架构、技术异构、Electron单机版 | ✅ 基准文档 |
| 产品需求文档(PRD).md | ⚠️ 旧版 | 2025-10-10 | 仅包含AI问答、知识库、项目管理 | ❌ **需要更新** |
| 技术架构总览.md | ⚠️ 旧版 | 2025-10-10 | 基于Dify+LobeChat的简化架构 | ❌ **需要更新** |
| AI智能文献PRD1-产品概览.md | ⚠️ 部分旧 | 2025-10-21 | 6大模块研究方案、检索、初筛、复筛、提取、分析 | ⚠️ **部分符合,需整合** |
| AI智能文献PRD2-初筛与复筛.md | ⚠️ 部分旧 | 2025-10-21 | 初筛和复筛详细设计 | ⚠️ **部分符合,需整合** |
| AI智能文献PRD3-提取与分析模块.md | ⚠️ 部分旧 | 2025-10-21 | 提取和分析详细设计 | ⚠️ **部分符合,需整合** |
| 系统总体架构设计.md | ⚠️ 占位 | 2025-10-29 | 占位文档,待完善 | ❌ **需要重写** |
| 设计文档完成总结.md | ⚠️ 旧版 | 2025-10-10 | 基于旧版PRD的总结 | ❌ **需要更新** |
### 2. 01-璁捐<EFBFBD>鏂囨。 鏂囦欢澶?
### 2. 01-设计文档 文件夹
| 鏂囨。鍚嶇О | 鐘舵€?| 鐗堟湰鏃ユ湡 | 鏍稿績鍐呭<E98D90> | 鏄<>惁绗﹀悎鏈€鏂伴渶姹?|
| 文档名称 | 状态 | 版本日期 | 核心内容 | 是否符合最新需求 |
|---------|------|---------|---------|----------------|
| 鏁版嵁搴撹<EFBFBD>璁℃枃妗?md | 鈿狅笍 鏃х増 | 2025-10-10 | 鍩轰簬AI闂<49>瓟+鐭ヨ瘑搴撶殑鏁版嵁搴撹<E690B4>璁?| 鉂?**缂哄皯DC銆丼SA銆丄SL妯″潡琛?* |
| API璁捐<EFBFBD>瑙勮寖.md | 鈿狅笍 鏃х増 | 2025-10-10 | 鍩轰簬AI闂<49>瓟+鐭ヨ瘑搴撶殑API璁捐<E79281> | 鉂?**缂哄皯鏂版ā鍧桝PI** |
| 骞冲彴鍓嶇<EFBFBD>鏋舵瀯璁捐<EFBFBD>/01-鍓嶇<E98D93>鎬讳綋鏋舵瀯璁捐<E79281>.md | 鈿狅笍 閮ㄥ垎鏃?| 2025-10-29 | 7涓<37>ā鍧楃殑椤堕儴瀵艰埅璁捐<E79281> | 鈿狅笍 **鏋舵瀯姝g‘锛屼絾缂哄皯閮ㄧ讲妯″紡鑰冭檻** |
| 骞冲彴鍓嶇<EFBFBD>鏋舵瀯璁捐<EFBFBD>/02-瀵艰埅缁撴瀯璁捐<E79281>.md | 鈿狅笍 閮ㄥ垎鏃?| 2025-10-29 | 瀵艰埅璇︾粏璁捐<E79281> | 鈿狅笍 **鏋舵瀯姝g‘锛屼絾缂哄皯閮ㄧ讲妯″紡鑰冭檻** |
| 绯荤粺鏋舵瀯/01-绯荤粺鎬讳綋鏋舵瀯璁捐<E79281>.md | 鈿狅笍 鍗犱綅 | 2025-10-29 | 鍗犱綅鏂囨。 | 鉂?**闇€瑕侀噸鍐?* |
| 绯荤粺鏋舵瀯/04-杩愯惀绠悊绔<E6828A>灦鏋勮<E98F8B>璁?md | 鈿狅笍 鍗犱綅 | 2025-10-29 | 鍗犱綅鏂囨。 | 鉂?**闇€瑕侀噸鍐?* |
| 绯荤粺鏋舵瀯/05-閮ㄧ讲鏋舵瀯璁捐<E79281>.md | 鈿狅笍 鍗犱綅 | 2025-10-29 | 鍗犱綅鏂囨。 | 鉂?**闇€瑕侀噸鍐欙紙鍏抽敭锛?* |
| 数据库设计文档.md | ⚠️ 旧版 | 2025-10-10 | 基于AI问答+知识库的数据库设计 | ❌ **缺少DC、SSA、ASL模块表** |
| API设计规范.md | ⚠️ 旧版 | 2025-10-10 | 基于AI问答+知识库的API设计 | ❌ **缺少新模块API** |
| 平台前端架构设计/01-前端总体架构设计.md | ⚠️ 部分旧 | 2025-10-29 | 7个模块的顶部导航设计 | ⚠️ **架构正确,但缺少部署模式考虑** |
| 平台前端架构设计/02-导航结构设计.md | ⚠️ 部分旧 | 2025-10-29 | 导航详细设计 | ⚠️ **架构正确,但缺少部署模式考虑** |
| 系统架构/01-系统总体架构设计.md | ⚠️ 占位 | 2025-10-29 | 占位文档 | ❌ **需要重写** |
| 系统架构/04-运营管理端架构设计.md | ⚠️ 占位 | 2025-10-29 | 占位文档 | ❌ **需要重写** |
| 系统架构/05-部署架构设计.md | ⚠️ 占位 | 2025-10-29 | 占位文档 | ❌ **需要重写(关键)** |
### 3. AI鏅鸿兘鏂囩尞 鏂囦欢澶?
### 3. AI智能文献 文件夹
| 鏂囨。鍚嶇О | 鐘舵€?| 鐗堟湰鏃ユ湡 | 鏍稿績鍐呭<E98D90> | 鏄<>惁绗﹀悎鏈€鏂伴渶姹?|
| 文档名称 | 状态 | 版本日期 | 核心内容 | 是否符合最新需求 |
|---------|------|---------|---------|----------------|
| 鎵€鏈夋枃妗?| 鈿狅笍 閮ㄥ垎鏃?| 2025-10-29 | 鍩轰簬Web鐗堢殑AI鏅鸿兘鏂囩尞璁捐<E79281> | 鈿狅笍 **缂哄皯鍗曟満鐗堛€佺<E282AC>鏈夊寲閮ㄧ讲鑰冭檻** |
| 所有文档 | ⚠️ 部分旧 | 2025-10-29 | 基于Web版的AI智能文献设计 | ⚠️ **缺少单机版、私有化部署考虑** |
### 4. 07-閮ㄧ讲鏂囨。 鏂囦欢澶?
### 4. 07-部署文档 文件夹
| 鏂囨。鍚嶇О | 鐘舵€?| 鐗堟湰鏃ユ湡 | 鏍稿績鍐呭<E98D90> | 鏄<>惁绗﹀悎鏈€鏂伴渶姹?|
| 文档名称 | 状态 | 版本日期 | 核心内容 | 是否符合最新需求 |
|---------|------|---------|---------|----------------|
| <EFBFBD>湴鍖栭儴缃叉柟妗?md | 鈿狅笍 鍗犱綅 | 2025-10-29 | 鍗犱綅鏂囨。 | 鉂?**闇€瑕侀噸鍐欙紙鍏抽敭锛?* |
| 妯″潡鐙<EFBFBD>珛閮ㄧ讲鎸囧崡.md | 鈿狅笍 鍗犱綅 | 2025-10-29 | 鍗犱綅鏂囨。 | 鉂?**闇€瑕侀噸鍐欙紙鍏抽敭锛?* |
| 本地化部署方案.md | ⚠️ 占位 | 2025-10-29 | 占位文档 | ❌ **需要重写(关键)** |
| 模块独立部署指南.md | ⚠️ 占位 | 2025-10-29 | 占位文档 | ❌ **需要重写(关键)** |
### 5. 05-姣忔棩杩涘害 鏂囦欢澶?
### 5. 05-每日进度 文件夹
| 鐘舵€?| 璇存槑 |
| 状态 | 说明 |
|------|------|
| ⚠️ 历史记录 | 记录了AI问答+知识库的开发历史Day04-Day31基于旧版PRD |
@@ -73,94 +73,94 @@
## 🔍 关键差异分析
### <EFBFBD>紓1锛氫骇鍝佸姛鑳借寖鍥?
### 差异1产品功能范围
#### 鏃х増鏂囨。锛堜骇鍝侀渶姹傛枃妗?PRD).md锛?
#### 旧版文档(产品需求文档(PRD).md
```
鏍稿績鍔熻兘锛?
核心功能:
1. 项目/课题管理
2. AI鏅鸿兘浣擄紙12涓<EFBFBD>櫤鑳戒綋锛?
3. <EFBFBD>汉鐭ヨ瘑搴?
2. AI智能体12个智能体
3. 个人知识库
4. 历史记录
5. 运营后台
```
#### 鏈€鏂伴渶姹傦紙澹硅瘉寰<EFBFBD><EFBFBD>鎶€ AI绉戠爺浜у搧闇€姹傛枃妗?md锛?
#### 最新需求(壹证循科技 AI科研产品需求文档.md
```
7大核心模块
F1. 鏅鸿兘缁熻<EFBFBD>鍒嗘瀽 (SSA) - 鉂?鏃ф枃妗e畬鍏ㄧ己澶?
F2. 缁熻<EFBFBD>鍒嗘瀽宸ュ叿 (ST) - 鉂?鏃ф枃妗e畬鍏ㄧ己澶?
F3. AI鏅鸿兘鍥炵瓟 (AIA) - 鉁?瀵瑰簲鏃ф枃妗g殑"AI鏅鸿兘浣?
F4. AI鏅鸿兘鏂囩尞 (ASL) - 鈿狅笍 鏈夌嫭绔婸RD锛屼絾鏈<E7B5BE>暣鍚?
F5. <EFBFBD>汉鐭ヨ瘑搴?(PKB) - 鉁?瀵瑰簲鏃ф枃妗g殑"涓<>汉鐭ヨ瘑搴?
F6. 鏁版嵁娓呮礂鏁寸悊 (DC) - 鉂?鏃ф枃妗e畬鍏ㄧ己澶憋紙鏍稿績闅剧偣锛?
F7. <EFBFBD>汉涓<EFBFBD> (UAM) - 鉁?瀵瑰簲鏃ф枃妗g殑"涓<>汉涓<E6B189>"
F1. 智能统计分析 (SSA) - ❌ 旧文档完全缺失
F2. 统计分析工具 (ST) - ❌ 旧文档完全缺失
F3. AI智能回答 (AIA) - ✅ 对应旧文档的"AI智能体"
F4. AI智能文献 (ASL) - ⚠️ 有独立PRD但未整合
F5. 个人知识库 (PKB) - ✅ 对应旧文档的"个人知识库"
F6. 数据清洗整理 (DC) - ❌ 旧文档完全缺失(核心难点)
F7. 个人中心 (UAM) - ✅ 对应旧文档的"个人中心"
```
**褰卞搷锛?*
- 鉂?鏃х増鏁版嵁搴撹<E690B4>己灏?SSA銆丼T銆丏C銆丄SL 妯″潡鐨勮〃缁撴瀯
- 鉂?鏃х増API璁捐<E79281>缂哄皯杩欎簺妯″潡鐨勬帴鍙?
- 鉂?鏃х増鍓嶇<E98D93>鏋舵瀯铏界劧棰勭暀浜嗗<E6B59C><EFBFBD>綅缃<E7B685>紝浣嗙己灏戣<E7818F>缁嗚<E7BC81>璁?
**影响:**
- ❌ 旧版数据库设计缺少 SSA、ST、DC、ASL 模块的表结构
- ❌ 旧版API设计缺少这些模块的接口
- ❌ 旧版前端架构虽然预留了导航位置,但缺少详细设计
---
### <EFBFBD>紓2锛氶儴缃叉ā寮?
### 差异2部署模式
#### х増鏂囨。锛堟妧鏈<EFBFBD>灦鏋勬€昏<EFBFBD>.md锛?
#### 旧版文档(技术架构总览.md
```
閮ㄧ讲妯″紡锛?
- 浜戠<EFBFBD>SaaS鐗堬紙鍞<EFBFBD>竴妯″紡锛?
部署模式:
- 云端SaaS版(唯一模式)
- 基于Docker部署
- 单一租户架构
```
#### 鏈€鏂伴渶姹傦紙鎶€鏈<EFBFBD>灦鏋勭櫧鐨<EFBFBD>.md锛?
#### 最新需求(技术架构白皮书.md
```
4种部署形态NFR-1核心要求
1. 浜戠<EFBFBD>SaaS鐗?- 澶氱<E6BEB6>鎴枫€侀珮鍙<E78FAE>
2. 绉佹湁鍖栭儴缃?- 鏁翠釜骞冲彴鎴栨寚瀹氭ā鍧楅儴缃插湪瀹㈡埛鍐呯綉
1. 云端SaaS版 - 多租户、高可用
2. 私有化部署 - 整个平台或指定模块部署在客户内网
3. 混合部署 - 本地使用DC/SSA云端调用ASL/AIA
4. 鍗曟満鐗?- Electron妗岄潰搴旂敤锛圵indows/Mac锛夛紝鏁版嵁100%鏈<>湴鍖?
4. 单机版 - Electron桌面应用Windows/Mac数据100%本地化
```
**褰卞搷锛?*
- 鉂?鏃х増鏋舵瀯璁捐<E79281>**瀹屽叏涓嶆敮鎸?*绉佹湁鍖栭儴缃插拰鍗曟満鐗?
- 鉂?鏃х増鍓嶇<E98D93>鏋舵瀯璁捐<E79281><EFBFBD>€冭檻**娣峰悎閮ㄧ讲**鐨勮矾鐢辩瓥鐣?
- 鉂?缂哄皯**Electron鍗曟満鐗?*鐨勬妧鏈<E5A6A7>柟妗堝拰寮€鍙戣<E98D99>鍒?
- 鉂?缂哄皯**瀹瑰櫒鍖栵紙K8s锛?*鐨勯儴缃叉灦鏋勮<E98F8B>璁?
**影响:**
- ❌ 旧版架构设计**完全不支持**私有化部署和单机版
- ❌ 旧版前端架构设计未考虑**混合部署**的路由策略
- ❌ 缺少**Electron单机版**的技术方案和开发计划
- ❌ 缺少**容器化K8s**的部署架构设计
---
### <EFBFBD>紓3锛氬晢涓氭ā寮?
### 差异3商业模式
#### 旧版文档
```
鍟嗕笟妯″紡锛?
商业模式:
- 简单的SaaS订阅模式
- <EFBFBD>槑纭<EFBFBD>増鏈<EFBFBD>垎绾?
- 未明确版本分级
```
#### 鏈€鏂伴渶姹傦紙NFR-2鏍稿績瑕佹眰锛?
#### 最新需求NFR-2核心要求
```
商业模式NFR-2
1. SaaS多版本专业版、高级版、旗舰版
- 需要完善的Feature Flag系统
2. 妯″潡鍖栧敭鍗栵細浠讳綍妯″潡鍙<EFBFBD>嫭绔嬫墦鍖呭敭鍗?
2. 模块化售卖:任何模块可独立打包售卖
- 技术架构必须松耦合
3. AI成本可控动态切换LLM模型
- 专业版用DeepSeek旗舰版用Claude/GPT
```
**褰卞搷锛?*
**影响:**
- ⚠️ 旧版前端架构设计已考虑版本权限控制,但**未实现Feature Flag系统**
- 鉂?鏃х増鏋舵瀯璁捐<E79281><EFBFBD>€冭檻**妯″潡鐙<E6BDA1>珛鍞<E78F9B>崠**鐨勬妧鏈<E5A6A7>疄鐜?
- ❌ 旧版架构设计未考虑**模块独立售卖**的技术实现
- ⚠️ 旧版已支持多模型切换,但未与版本权限绑定
---
### <EFBFBD>紓4锛氭妧鏈<EFBFBD>灦鏋?
### 差异4技术架构
#### х増鏂囨。锛堟妧鏈<EFBFBD>灦鏋勬€昏<EFBFBD>.md锛?
#### 旧版文档(技术架构总览.md
```
技术架构:
- 前端React + Vite + LobeChat组件
@@ -168,186 +168,186 @@ F7. 个人中心 (UAM) -
- 数据库PostgreSQL
- RAGDify仅用于知识库
- LLMDeepSeek-V3 + Qwen3
- 鏋舵瀯锛氭ā鍧楀寲鍗曚綋锛圡onolith锛?
- 架构模块化单体Monolith
```
#### 鏈€鏂伴渶姹傦紙鎶€鏈<EFBFBD>灦鏋勭櫧鐨<EFBFBD>.md锛?
#### 最新需求(技术架构白皮书.md
```
鎶€鏈<EFBFBD>灦鏋勶紙婕旇繘寮忥級锛?
- 闃舵<EFBFBD>涓€锛?-6涓<36>湀锛夛細妯″潡鍖栧崟浣?鉁?涓庢棫鐗堜竴鑷?
- 闃舵<EFBFBD>浜岋紙6-18涓<38>湀锛夛細棣栨<E6A3A3>鎷嗗垎锛圫SA銆丏C寰<43>湇鍔★級+ Electron鍗曟満鐗?
- 闃舵<EFBFBD>涓夛紙18涓<EFBFBD>湀+锛夛細鍏ㄩ潰寰<E6BDB0>湇鍔℃灦鏋?
技术架构(演进式):
- 阶段一0-6个月模块化单体 ✅ 与旧版一致
- 阶段二6-18个月首次拆分SSA、DC微服务+ Electron单机版
- 阶段三18个月+):全面微服务架构
鏍稿績鎶€鏈<EFBFBD>爤锛堟妧鏈<EFBFBD>紓鏋勶級锛?
- 鍓嶇<EFBFBD>锛歊eact/Vue锛圵eb + Electron澶嶇敤锛?
核心技术栈(技术异构):
- 前端React/VueWeb + Electron复用)
- API网关Node.js
- 缁熻<EFBFBD>鍒嗘瀽锛圫SA锛夛細R璇<EFBFBD> + Plumber API 鉂?鏃ф枃妗g己澶?
- 鏁版嵁娓呮礂锛圖C锛夛細Python + Polars/Pandas + FastAPI 鉂?鏃ф枃妗g己澶?
- 统计分析SSAR语言 + Plumber API ❌ 旧文档缺失
- 数据清洗DCPython + Polars/Pandas + FastAPI ❌ 旧文档缺失
- 部署Docker + Kubernetes ⚠️ 旧文档仅Docker
- 鍗曟満鐗堬細Electron + <EFBFBD>R/Python瀛愯繘绋?鉂?鏃ф枃妗e畬鍏ㄧ己澶?
- 单机版:Electron + 本地R/Python子进程 ❌ 旧文档完全缺失
```
**褰卞搷锛?*
- 鉂?鏃х増鏋舵瀯璁捐<E79281>**鏈<>€冭檻R璇<52>█鍜孭ython寰<6E>湇鍔?*鐨勯泦鎴?
- 鉂?鏃х増鏋舵瀯璁捐<E79281>**鏈<>€冭檻Kubernetes缂栨帓**
- 鉂?鏃х増鏋舵瀯璁捐<E79281>**瀹屽叏缂哄皯Electron鍗曟満鐗?*鐨勬妧鏈<E5A6A7>柟妗?
- 鉂?鏃х増鏋舵瀯璁捐<E79281>**鏈<>€冭檻API缃戝叧**鐨勫紩鍏?
**影响:**
- ❌ 旧版架构设计**未考虑R语言和Python微服务**的集成
- ❌ 旧版架构设计**未考虑Kubernetes编排**
- ❌ 旧版架构设计**完全缺少Electron单机版**的技术方案
- ❌ 旧版架构设计**未考虑API网关**的引入
---
### <EFBFBD>紓5锛氭暟鎹<EFBFBD>竻娲楁ā鍧楋紙DC锛? 鏍稿績闅剧偣
### 差异5数据清洗模块DC- 核心难点
#### 旧版文档
```
状态:完全缺失
```
#### 鏈€鏂伴渶姹傦紙鎶€鏈<EFBFBD>灦鏋勭櫧鐨<EFBFBD>功绗?鑺傦級
#### 最新需求技术架构白皮书第6节
```
鏁版嵁娓呮礂鏁寸悊 (DC) 妯″潡锛?
数据清洗整理 (DC) 模块:
1. 海量表格ETL处理百万行、多表格的Excel数据
2. 非结构化文本NER从病理报告中提取结构化字段
涓ょ<EFBFBD>瀹炵幇鏂规<EFBFBD>锛?
鏂规<EFBFBD>涓€锛氭湇鍔″櫒鏈€浼樼増锛堜簯绔?绉佹湁鍖栵級
- Python + Polars锛堟浛浠<EFBFBD>andas锛?0-100鍊嶉€熷害锛?
两种实现方案:
方案一:服务器最优版(云端/私有化)
- Python + Polars替代Pandas10-100倍速度)
- LLM APIClaude 3/GPT-4o进行NER
- PostgreSQL存储结果
鏂规<EFBFBD>浜岋細鍗曟満鐗堬紙Desktop-Offline锛?
- Electron + Python瀛愯繘绋?
方案二:单机版(Desktop-Offline
- Electron + Python子进程
- SQLite避免内存溢出
- spaCy<EFBFBD>湴NLP妯″瀷锛?00%闅愮<E99785>淇濇姢锛?
- spaCy本地NLP模型100%隐私保护)
```
**褰卞搷锛?*
- 鉂?鏃х増鏁版嵁搴撹<E690B4>璁?*瀹屽叏缂哄皯DC妯″潡鐨勮〃缁撴瀯**
- 鉂?鏃х増API璁捐<E79281>**瀹屽叏缂哄皯DC妯″潡鐨勬帴鍙?*
- 鉂?鏃х増鎶€鏈<E282AC>爤**鏈<>寘鍚玃ython寰<6E>湇鍔?*
- 鉂?鏃х増鏋舵瀯璁捐<E79281>**鏈<>€冭檻Polars銆丼QLite銆乻paCy**绛夊叧閿<EFBFBD>妧鏈?
**影响:**
- ❌ 旧版数据库设计**完全缺少DC模块的表结构**
- ❌ 旧版API设计**完全缺少DC模块的接口**
- ❌ 旧版技术栈**未包含Python微服务**
- ❌ 旧版架构设计**未考虑Polars、SQLite、spaCy**等关键技术
---
### <EFBFBD>紓6锛欰I鏅鸿兘鏂囩尞妯″潡锛圓SL锛?
### 差异6AI智能文献模块ASL
#### х増鏂囨。锛圓I鏅鸿兘鏂囩尞PRD绯诲垪锛?
#### 旧版文档AI智能文献PRD系列
```
鐘舵€侊細鏈夌嫭绔婸RD鏂囨。锛?025-10-21锛?
鍐呭<EFBFBD>锛?澶фā鍧楋紙鐮旂┒鏂规<E98F82>銆佹<E98A86>绱€€佸垵绛涖€佸<E282AC>绛涖€佹彁鍙栥€佸垎鏋愶級
状态有独立PRD文档2025-10-21
内容6大模块研究方案、检索、初筛、复筛、提取、分析
架构基于Web版的设计
```
#### 鏈€鏂伴渶姹傦紙澹硅瘉寰<EFBFBD><EFBFBD>鎶€ AI绉戠爺浜у搧闇€姹傛枃妗?md锛?
#### 最新需求(壹证循科技 AI科研产品需求文档.md
```
F4. AI鏅鸿兘鏂囩尞 (ASL)锛?
F4. AI智能文献 (ASL)
- 提供AI驱动的文献工作流
- 鏅鸿兘妫€绱€€佹爣棰樻憳瑕佸垵绛涖€佸叏鏂囧<EFBFBD>绛涖€佷俊鎭<EFBFBD>彁鍙?
- 智能检索、标题摘要初筛、全文复筛、信息提取
- 支持Meta分析、证据图谱等应用
- 蹇呴』鏀<EFBFBD>寔鍗曟満鐗堬紙鏂囩尞鍘熸枃100%涓嶇<E6B693>寮€鐢ㄦ埛鐢佃剳锛?
- 必须支持单机版文献原文100%不离开用户电脑)
```
**褰卞搷锛?*
**影响:**
- ⚠️ 现有AI智能文献PRD文档**内容基本符合**,但需要:
1. 鉂?琛ュ厖**鍗曟満鐗堝疄鐜版柟妗?*锛圗lectron + 鏈<>湴PDF瑙瀽锛?
2. 鉂?琛ュ厖**绉佹湁鍖栭儴缃叉柟妗?*
3. 鈿狅笍 鏁村悎鍒?*7澶фā鍧?*鐨勬暣浣撴灦鏋勪腑
1. ❌ 补充**单机版实现方案**Electron + 本地PDF解析
2. ❌ 补充**私有化部署方案**
3. ⚠️ 整合到**7大模块**的整体架构中
---
### <EFBFBD>紓7锛氭櫤鑳界粺璁″垎鏋愭ā鍧楋紙SSA锛?
### 差异7智能统计分析模块SSA
#### 旧版文档
```
状态:完全缺失
```
#### 鏈€鏂伴渶姹?
#### 最新需求
```
F1. 鏅鸿兘缁熻<EFBFBD>鍒嗘瀽 (SSA)锛?
F1. 智能统计分析 (SSA)
- 3条核心分析路径队列研究、预测模型、RCT研究
- 鏁版嵁涓婁紶銆佽川鎺с€佸垎鏋愩€佹姤鍛婂<EFBFBD>鍑?
- 蹇呴』鏀<EFBFBD>寔绉佹湁鍖栭儴缃诧紙鍖婚櫌鍐呯綉锛?
- 数据上传、质控、分析、报告导出
- 必须支持私有化部署(医院内网)
- 必须支持单机版数据100%本地化)
鎶€鏈<EFBFBD>疄鐜帮紙鐧界毊涔︼級锛?
技术实现(白皮书):
- R语言 + Plumber API服务器版
- R语言 + Electron子进程单机版
```
**褰卞搷锛?*
- 鉂?鏃х増鏂囨。**瀹屽叏缂哄皯SSA妯″潡鐨凱RD**
- 鉂?鏃х増鏁版嵁搴撹<E690B4>璁?*瀹屽叏缂哄皯SSA妯″潡鐨勮〃缁撴瀯**
- 鉂?鏃х増鎶€鏈<E282AC>爤**鏈<>寘鍚玆璇<E78E86>**
- 鉂?鏃х増鏋舵瀯璁捐<E79281>**鏈<>€冭檻R璇<52>█寰<E29688>湇鍔?*鐨勯泦鎴?
**影响:**
- ❌ 旧版文档**完全缺少SSA模块的PRD**
- ❌ 旧版数据库设计**完全缺少SSA模块的表结构**
- ❌ 旧版技术栈**未包含R语言**
- ❌ 旧版架构设计**未考虑R语言微服务**的集成
---
## 馃搳 鏂囨。绗﹀悎搴﹁瘎鍒?
## 📊 文档符合度评分
| 鏂囨。绫诲埆 | 绗﹀悎搴?| 璇存槑 |
| 文档类别 | 符合度 | 说明 |
|---------|-------|------|
| **浜у搧闇€姹傛枃妗?* | 30% | 浠呰<E6B5A0>鐩?/7妯″潡锛圓IA銆丳KB銆乁AM锛?|
| **鎶€鏈<EFBFBD>灦鏋勬枃妗?* | 40% | 鍩虹<E98DA9>鏋舵瀯姝锛屼絾缂哄皯寰<E79AAF>湇鍔°€丒lectron銆並8s |
| **鏁版嵁搴撹<EFBFBD>璁?* | 35% | 浠呰<E6B5A0>鐩?/7妯″潡鐨勮〃缁撴瀯 |
| **API璁捐<EFBFBD>** | 35% | 浠呰<EFBFBD>鐩?/7妯″潡鐨勬帴鍙?|
| **产品需求文档** | 30% | 仅覆盖3/7模块AIA、PKB、UAM |
| **技术架构文档** | 40% | 基础架构正确但缺少微服务、Electron、K8s |
| **数据库设计** | 35% | 仅覆盖3/7模块的表结构 |
| **API设计** | 35% | 仅覆盖3/7模块的接口 |
| **前端架构** | 60% | 导航结构正确,但缺少部署模式考虑 |
| **部署文档** | 0% | 完全缺失(占位文档) |
| **AI鏅鸿兘鏂囩尞** | 70% | 鍐呭<EFBFBD>鍩烘湰绗﹀悎锛屼絾缂哄皯鍗曟満鐗堝拰绉佹湁鍖栨柟妗?|
| **AI智能文献** | 70% | 内容基本符合,但缺少单机版和私有化方案 |
**鎬讳綋绗﹀悎搴︼細绾?40%**
**总体符合度:约 40%**
---
## 🚨 关键缺失内容清单
### 1. 浜у搧闇€姹傚眰闈?
### 1. 产品需求层面
- [ ] **SSA妯″潡瀹屾暣PRD**锛堥槦鍒楃爺绌躲€侀<E282AC>娴嬫ā鍨嬨€丷CT鐮旂┒锛?
- [ ] **ST妯″潡瀹屾暣PRD**锛?00+绉嶇粺璁″伐鍏凤級
- [ ] **DC妯″潡瀹屾暣PRD**锛堣〃鏍糆TL + 鏂囨湰NER锛?
- [ ] **4绉嶉儴缃叉ā寮忕殑璇︾粏闇€姹傝<EFBFBD>鏄?*
- [ ] **SSA模块完整PRD**队列研究、预测模型、RCT研究
- [ ] **ST模块完整PRD**100+种统计工具)
- [ ] **DC模块完整PRD**表格ETL + 文本NER
- [ ] **4种部署模式的详细需求说明**
- [ ] **模块化售卖的商业模式设计**
- [ ] **Feature Flag绯荤粺鐨勯渶姹傚畾涔?*
- [ ] **Feature Flag系统的需求定义**
### 2. 鎶€鏈<EFBFBD>灦鏋勫眰闈?
### 2. 技术架构层面
- [ ] **<EFBFBD>湇鍔℃灦鏋勮<EFBFBD>璁?*锛圓PI缃戝叧 + 鏈嶅姟鎷嗗垎锛?
- [ ] **R<EFBFBD>█寰<EFBFBD>湇鍔¢泦鎴愭柟妗?*
- [ ] **Python<EFBFBD>湇鍔¢泦鎴愭柟妗?*锛圥olars + FastAPI锛?
- [ ] **微服务架构设计**API网关 + 服务拆分)
- [ ] **R语言微服务集成方案**
- [ ] **Python微服务集成方案**Polars + FastAPI
- [ ] **Kubernetes部署架构设计**
- [ ] **Electron鍗曟満鐗堝畬鏁存妧鏈<EFBFBD>柟妗?*
- [ ] **娣峰悎閮ㄧ讲鐨勮矾鐢辩瓥鐣ヨ<EFBFBD>璁?*
- [ ] **绉佹湁鍖栭儴缃茬殑瀹瑰櫒鍖栨柟妗?*
- [ ] **Electron单机版完整技术方案**
- [ ] **混合部署的路由策略设计**
- [ ] **私有化部署的容器化方案**
### 3. 鏁版嵁搴撹<EFBFBD>璁″眰闈?
### 3. 数据库设计层面
- [ ] **SSA妯″潡琛ㄧ粨鏋?*锛堢爺绌堕」鐩<E3808D>€佹暟鎹<E69A9F>泦銆佸垎鏋愮粨鏋滐級
- [ ] **ST妯″潡琛ㄧ粨鏋?*锛堝伐鍏烽厤缃<E58EA4>€佷娇鐢ㄨ<E990A2>褰曪級
- [ ] **DC妯″潡琛ㄧ粨鏋?*锛堟竻娲椾换鍔°€丒TL閰嶇疆銆丯ER缁撴灉锛?
- [ ] **ASL妯″潡琛ㄧ粨鏋?*锛堟枃鐚<E69E83>」鐩<E3808D>€佺瓫閫夎<E996AB>褰曘€佹彁鍙栨暟鎹<E69A9F>
- [ ] **澶氱<EFBFBD>鎴锋暟鎹<EFBFBD>殧绂昏<EFBFBD>璁?*锛圫chema闅旂<E99785>锛?
- [ ] **SSA模块表结构**(研究项目、数据集、分析结果)
- [ ] **ST模块表结构**(工具配置、使用记录)
- [ ] **DC模块表结构**清洗任务、ETL配置、NER结果
- [ ] **ASL模块表结构**(文献项目、筛选记录、提取数据)
- [ ] **多租户数据隔离设计**Schema隔离
### 4. API设计层面
- [ ] **SSA模块API**(数据上传、分析执行、报告生成)
- [ ] **ST模块API**(工具列表、工具执行)
- [ ] **DC妯″潡API**锛堟枃浠朵笂浼犮€丒TL鎵ц<E98EB5>銆丯ER鎵ц<E98EB5>锛?
- [ ] **DC模块API**文件上传、ETL执行、NER执行
- [ ] **ASL模块API**(文献导入、筛选、提取)
- [ ] **API网关路由配置**
### 5. 前端架构层面
- [ ] **Electron鍗曟満鐗堝墠绔<EFBFBD>灦鏋?*
- [ ] **娣峰悎閮ㄧ讲鐨勫墠绔<EFBFBD>矾鐢辩瓥鐣?*
- [ ] **Electron单机版前端架构**
- [ ] **混合部署的前端路由策略**
- [ ] **Feature Flag前端实现**
- [ ] **模块独立打包方案**
### 6. 部署文档层面
- [ ] **云端SaaS部署方案**K8s + 多租户)
- [ ] **绉佹湁鍖栭儴缃叉柟妗?*锛圖ocker + K3s锛?
- [ ] **娣峰悎閮ㄧ讲鏂规<EFBFBD>**锛堟湰鍦?浜戠<E6B59C>锛?
- [ ] **Electron鍗曟満鐗堟墦鍖呮柟妗?*锛圵indows + Mac锛?
- [ ] **私有化部署方案**Docker + K3s
- [ ] **混合部署方案**(本地+云端)
- [ ] **Electron单机版打包方案**Windows + Mac
- [ ] **模块独立部署指南**
---
@@ -357,81 +357,81 @@ F1. 智能统计分析 (SSA)
### 🔴 P0 - 立即更新(阻塞开发)
1. **系统总体架构设计.md** - 重写,基于技术架构白皮书
2. **閮ㄧ讲鏋舵瀯璁捐<EFBFBD>.md** - 閲嶅啓锛岃<EFBFBD>缁嗚<EFBFBD>鏄?绉嶉儴缃叉ā寮?
3. **鏁版嵁搴撹<EFBFBD>璁℃枃妗?md** - 琛ュ厖SSA銆丼T銆丏C銆丄SL妯″潡琛ㄧ粨鏋?
4. **浜у搧闇€姹傛枃妗?PRD).md** - 閲嶅啓锛屾暣鍚?澶фā鍧?
2. **部署架构设计.md** - 重写详细说明4种部署模式
3. **数据库设计文档.md** - 补充SSA、ST、DC、ASL模块表结构
4. **产品需求文档(PRD).md** - 重写整合7大模块
### 🟠 P1 - 近期更新(影响规划)
5. **DC妯″潡PRD** - 鏂板缓锛岃<EFBFBD>缁嗚<EFBFBD>鏄嶦TL鍜孨ER闇€姹?
6. **SSA妯″潡PRD** - 鏂板缓锛岃<EFBFBD>缁嗚<EFBFBD>鏄?鏉″垎鏋愯矾寰?
7. **ST妯″潡PRD** - 鏂板缓锛岃<EFBFBD>缁嗚<EFBFBD>鏄?00+宸ュ叿
8. **Electron鍗曟満鐗堟妧鏈<EFBFBD>柟妗?* - 鏂板缓锛岃<E9949B>缁嗚<E7BC81>鏄庡疄鐜拌矾寰?
5. **DC模块PRD** - 新建详细说明ETL和NER需求
6. **SSA模块PRD** - 新建详细说明3条分析路径
7. **ST模块PRD** - 新建详细说明100+工具
8. **Electron单机版技术方案** - 新建,详细说明实现路径
9. **API设计规范.md** - 补充新模块API
### 🟡 P2 - 后续更新(优化完善)
10. **前端总体架构设计.md** - 补充部署模式考虑
11. **AI鏅鸿兘鏂囩尞PRD绯诲垪** - 琛ュ厖鍗曟満鐗堝拰绉佹湁鍖栨柟妗?
11. **AI智能文献PRD系列** - 补充单机版和私有化方案
12. **技术架构总览.md** - 重写,基于技术架构白皮书
13. **<EFBFBD>湴鍖栭儴缃叉柟妗?md** - 璇︾粏璇存槑绉佹湁鍖栭儴缃?
14. **妯″潡鐙<EFBFBD>珛閮ㄧ讲鎸囧崡.md** - 璇︾粏璇存槑妯″潡鍖栧敭鍗?
13. **本地化部署方案.md** - 详细说明私有化部署
14. **模块独立部署指南.md** - 详细说明模块化售卖
---
## 馃幆 涓嬩竴姝ヨ<E5A79D>鍔ㄥ缓璁?
## 🎯 下一步行动建议
### 寤鸿<EFBFBD>1锛氭槑纭<EFBFBD>紑鍙戦樁娈?
### 建议1明确开发阶段
根据技术架构白皮书的分阶段实施路线图:
**闃舵<EFBFBD>涓€锛?-6涓<36>湀锛夛細浜戠<E6B59C>MVP - "妯″潡鍖栧崟浣?**
- 鉁?鍙<>互缁х画浣跨敤鐜版湁鏋舵瀯锛圢ode.js + Fastify + PostgreSQL锛?
- 鈿狅笍 浣嗗繀椤讳弗鏍奸伒寰?浠爜闅旂<E99785>"鍜?鏁版嵁闅旂<E99785>"锛圫chema闅旂<E99785>锛?
- 鉂?鏆備笉寮€鍙慐lectron鍗曟満鐗堝拰绉佹湁鍖栭儴缃?
**阶段一0-6个月云端MVP - "模块化单体"**
- ✅ 可以继续使用现有架构Node.js + Fastify + PostgreSQL
- ⚠️ 但必须严格遵循"代码隔离"和"数据隔离"Schema隔离
- ❌ 暂不开发Electron单机版和私有化部署
**阶段二6-18个月首次拆分**
- 引入K8s和API网关
- 拆分SSA和DC为独立微服务
- 寮€鍙慐lectron鍗曟満鐗?
- 开发Electron单机版
### 建议2模块开发优先级
鍩轰簬鍟嗕笟浠峰€煎拰鎶€鏈<EFBFBD><EFBFBD>鏉傚害锛?
基于商业价值和技术复杂度:
**<EFBFBD>竴浼樺厛绾э紙鏍稿績宸<EFBFBD>紓鍖栵級锛?*
1. **DC妯″潡锛堟暟鎹<EFBFBD>竻娲楁暣鐞嗭級** - 鏍稿績闅剧偣锛屽樊寮傚寲绔炰簤鍔?
2. **ASL妯″潡锛圓I鏅鸿兘鏂囩尞锛?* - 宸叉湁PRD锛屽彲蹇<E5BDB2>€熸帹杩?
**第一优先级(核心差异化):**
1. **DC模块(数据清洗整理)** - 核心难点,差异化竞争力
2. **ASL模块AI智能文献** - 已有PRD可快速推进
**第二优先级(完善产品矩阵):**
3. **SSA模块智能统计分析** - 需要R语言团队
4. **ST妯″潡锛堢粺璁″垎鏋愬伐鍏凤級** - 鐩稿<EFBFBD>绠€鍗?
4. **ST模块(统计分析工具)** - 相对简单
**<EFBFBD>笁浼樺厛绾э紙宸插畬鎴愶級锛?*
5. AIA妯″潡锛圓I鏅鸿兘鍥炵瓟锛?- 鉁?宸插畬鎴?
6. PKB妯″潡锛堜釜浜虹煡璇嗗簱锛?- 鉁?宸插畬鎴?
7. UAM妯″潡锛堜釜浜轰腑蹇冿級 - 鉁?宸插畬鎴?
**第三优先级(已完成):**
5. AIA模块AI智能回答 - ✅ 已完成
6. PKB模块(个人知识库) - ✅ 已完成
7. UAM模块(个人中心) - ✅ 已完成
### 寤鸿<EFBFBD>3锛氭枃妗洿鏂扮瓥鐣?
### 建议3文档更新策略
**绔嬪嵆琛屽姩锛堟湰鍛<EFBFBD>級锛?*
1. 鍒涘缓 `绯荤粺鎬讳綋鏋舵瀯璁捐<E79281>.md`锛堝熀浜庣櫧鐨<EFBFBD>功锛?
2. 鍒涘缓 `閮ㄧ讲鏋舵瀯璁捐<E79281>.md`锛?绉嶉儴缃叉ā寮忥級
3. 鏇存柊 `鏁版嵁搴撹<E690B4>璁℃枃妗?md`锛堣ˉ鍏呮柊妯″潡琛ㄧ粨鏋勶級
**立即行动(本周):**
1. 创建 `系统总体架构设计.md`(基于白皮书)
2. 创建 `部署架构设计.md`4种部署模式
3. 更新 `数据库设计文档.md`(补充新模块表结构)
**杩戞湡琛屽姩锛堟湰鏈堬級锛?*
**近期行动(本月):**
4. 创建 `DC模块PRD.md`
5. 创建 `SSA模块PRD.md`
6. 鍒涘缓 `Electron鍗曟満鐗堟妧鏈<EFBFBD>柟妗?md`
6. 创建 `Electron单机版技术方案.md`
**鎸佺画琛屽姩锛?*
**持续行动:**
7. 随着开发进展持续更新API设计、前端架构等文档
### 建议4技术选型确认
**需要与团队确认的关键技术决策:**
1. **<EFBFBD>惁寮曞叆R璇<EFBFBD>█锛?*
1. **是否引入R语言**
- SSA模块需要R语言统计分析的王者
- 需要评估团队能力和学习成本
@@ -440,11 +440,11 @@ F1. 智能统计分析 (SSA)
- 需要评估与现有Node.js架构的集成复杂度
3. **是否立即规划Electron单机版**
- 鐧界毊涔﹀缓璁<EFBFBD>湪闃舵<EFBFBD>浜岋紙6-18涓<38>湀锛夊紑鍙?
- 闇€瑕佺‘璁ゅ競鍦洪渶姹傜殑绱ц揩鎬?
- 白皮书建议在阶段二6-18个月开发
- 需要确认市场需求的紧迫性
4. **<EFBFBD>惁绔嬪嵆寮曞叆K8s锛?*
- 鐧界毊涔﹀缓璁<EFBFBD>湪闃舵<EFBFBD>浜屽紩鍏?
4. **是否立即引入K8s**
- 白皮书建议在阶段二引入
- 阶段一可以继续使用Docker Compose
---
@@ -453,34 +453,34 @@ F1. 智能统计分析 (SSA)
### 核心问题
**х増鏂囨。涓庢渶鏂伴渶姹傜殑鏍稿績宸<EFBFBD>紓锛?*
**旧版文档与最新需求的核心差异:**
1. **浜у搧鑼冨洿鎵╁ぇ锛?* 浠?涓<>ā鍧楁墿灞曞埌7涓<37>ā鍧?
2. **閮ㄧ讲妯″紡澶嶆潅鍖栵細** 浠庡崟涓€浜戠<E6B59C>SaaS鎵╁睍鍒?绉嶉儴缃插舰鎬?
1. **产品范围扩大:** 从3个模块扩展到7个模块
2. **部署模式复杂化:** 从单一云端SaaS扩展到4种部署形态
3. **技术架构演进:** 从模块化单体演进到微服务架构
4. **鍟嗕笟妯″紡鍗囩骇锛?* 浠庣畝鍗曡<E98D97>闃呭埌妯″潡鍖栧敭鍗?+ 澶氱増鏈?+ 澶氶儴缃?
4. **商业模式升级:** 从简单订阅到模块化售卖 + 多版本 + 多部署
### 关键建议
**务实的推进策略:**
1. **闃舵<EFBFBD>涓€锛堝綋鍓嶏級锛?* 缁х画浣跨敤鐜版湁鏋舵瀯锛屼笓娉ㄤ簬**浜戠<E6B59C>SaaS鐗?*鐨?澶фā鍧楀紑鍙?
2. **涓ユ牸绾<EFBFBD>緥锛?* 蹇呴』閬靛惊"浠爜闅旂<E99785>"鍜?鏁版嵁Schema闅旂<E99785>"锛屼负鏈<E8B49F>潵鎷嗗垎鎵撳熀纭€
1. **阶段一(当前):** 继续使用现有架构,专注于**云端SaaS版**的7大模块开发
2. **严格纪律:** 必须遵循"代码隔离"和"数据Schema隔离",为未来拆分打基础
3. **优先级:** 先开发DC和ASL模块差异化竞争力
4. **鏂囨。鍏堣<EFBFBD>锛?* 绔嬪嵆鏇存柊P0绾ф枃妗紝鎸囧<E98EB8>鍚庣画寮€鍙?
4. **文档先行:** 立即更新P0级文档指导后续开发
**閬垮厤杩囧害璁捐<EFBFBD>锛?*
**避免过度设计:**
- 鉂?涓嶈<E6B693>鍦ㄩ樁娈典竴灏卞紩鍏<E7B4A9>8s鍜孉PI缃戝叧锛堝<E9949B>鍔犲<E98D94>鏉傚害锛?
- 鉂?涓嶈<E6B693>鍦ㄩ樁娈典竴灏卞紑鍙慐lectron鍗曟満鐗堬紙鍒嗘暎绮惧姏锛?
- 鉁?涓撴敞浜庝簯绔疭aaS鐗堢殑鍔熻兘瀹屽杽鍜屽競鍦洪獙璇?
- 鉁?涓烘湭鏉ョ殑鏋舵瀯婕旇繘鎵撳ソ鍩虹<E98DA9>锛堜唬鐮佸拰鏁版嵁闅旂<E99785>锛?
- ❌ 不要在阶段一就引入K8s和API网关增加复杂度
- ❌ 不要在阶段一就开发Electron单机版分散精力
- ✅ 专注于云端SaaS版的功能完善和市场验证
- ✅ 为未来的架构演进打好基础(代码和数据隔离)
---
**文档维护者:** 项目团队
**最后更新:** 2025-11-06
**涓嬫<EFBFBD>瀹℃煡锛?* 2025-11-13
**下次审查:** 2025-11-13

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -1,92 +1,92 @@
# 设计文档完成总结
> **瀹屾垚鏃堕棿锛?* 2025-10-10
> **鑰楁椂锛?* 绾?灏忔椂
> **鐘舵€侊細** 鉁?宸插畬鎴?
> **完成时间:** 2025-10-10
> **耗时:** 约3小时
> **状态:** ✅ 已完成
---
## 🎉 恭喜!核心设计文档已全部完成
鎴戜滑鎸夌収鎮ㄦ彁鍑虹殑涓撲笟寮€鍙戞祦绋嬶紝鎴愬姛鍒涘缓浜嗗畬鏁寸殑璁捐<EFBFBD>鏂囨。浣撶郴銆傝繖涓烘帴涓嬫潵鐨勫紑鍙戝伐浣滃<EFBFBD>瀹氫簡鍧氬疄鐨勫熀纭€銆?
我们按照您提出的专业开发流程,成功创建了完整的设计文档体系。这为接下来的开发工作奠定了坚实的基础。
---
## 📚 已完成的文档清单
### 鉁?1. 鏂囨。鐩<EFBFBD>綍缁撴瀯
**鏂囦欢锛?* `docs/README.md`
### 1. 文档目录结构
**文件:** `docs/README.md`
- 寤虹珛浜?涓<>枃妗垎绫荤洰褰?
- 娓呮櫚鐨勬枃妗<EFBFBD><EFBFBD>郴缁?
- 建立了8个文档分类目录
- 清晰的文档导航系统
- 文档维护指南
### 鉁?2. 鏁版嵁搴撹<EFBFBD>璁℃枃妗紙771琛岋級
**鏂囦欢锛?* `docs/01-璁捐<EFBFBD>鏂囨。/鏁版嵁搴撹<E690B4>璁℃枃妗?md`
### 2. 数据库设计文档771行
**文件:** `docs/01-设计文档/数据库设计文档.md`
**鍖呭惈鍐呭<EFBFBD>锛?*
**包含内容:**
- 7个核心数据表设计
- 瀹屾暣鐨凟R鍥?
- 瀛楁<EFBFBD>璇存槑鍜岀害鏉?
- 完整的ER图
- 字段说明和约束
- 索引设计
- Prisma Schema
- 数据安全策略
- 性能优化建议
**核心表:**
1. users - 鐢ㄦ埛琛?
2. projects - 椤圭洰/璇鹃<E79287>琛?
3. conversations - 瀵硅瘽琛?
4. messages - 娑堟伅琛?
1. users - 用户表
2. projects - 项目/课题表
3. conversations - 对话表
4. messages - 消息表
5. knowledge_bases - 知识库表
6. documents - 鏂囨。琛?
6. documents - 文档表
7. admin_logs - 管理员日志表
### 鉁?3. API璁捐<EFBFBD>瑙勮寖锛?023琛岋級
**鏂囦欢锛?* `docs/01-璁捐<EFBFBD>鏂囨。/API璁捐<E79281>瑙勮寖.md`
### 3. API设计规范1023行
**文件:** `docs/01-设计文档/API设计规范.md`
**鍖呭惈鍐呭<EFBFBD>锛?*
**包含内容:**
- RESTful API设计原则
- 瀹屾暣鐨?涓<>ā鍧桝PI瀹氫箟
- 完整的8个模块API定义
- 请求/响应格式规范
- 错误处理规范
- 认证授权机制
- 分页规范
- 性能优化建议
**API妯″潡锛?*
1. 璁よ瘉妯″潡锛堟敞鍐?鐧诲綍/鍒锋柊Token锛?
**API模块:**
1. 认证模块(注册/登录/刷新Token
2. 用户模块(个人信息管理)
3. 项目管理模块
4. 瀵硅瘽绠$悊妯″潡锛堝惈娴佸紡杈撳嚭锛?
5. 鏅鸿兘浣撴ā鍧?
6. 鐭ヨ瘑搴撴ā鍧?
4. 对话管理模块(含流式输出)
5. 智能体模块
6. 知识库模块
7. 历史记录模块
8. 管理后台模块
### 鉁?4. 寮€鍙戦噷绋嬬<EFBFBD>锛?86琛岋級
**鏂囦欢锛?* `docs/04-寮€鍙戣<EFBFBD>鍒?寮€鍙戦噷绋嬬<E7BB8B>.md`
### 4. 开发里程碑586行
**文件:** `docs/04-开发计划/开发里程碑.md`
**鍖呭惈鍐呭<EFBFBD>锛?*
- 10鍛ㄨ<EFBFBD>缁嗗紑鍙戣<EFBFBD>鍒?
**包含内容:**
- 10周详细开发计划
- 5个里程碑定义
- 姣忔棩浠诲姟鍒嗚В锛圖ay 1-70锛?
- 每日任务分解Day 1-70
- 验收标准
- 风险管理
- 进度跟踪机制
**里程碑:**
- 璁捐<EFBFBD>闃舵<EFBFBD>锛欴ay 1-3 鉁?
- 閲岀▼纰?锛氬熀纭€鏋舵瀯 + 鐢ㄦ埛璁よ瘉锛圵eek 1-2锛?
- 閲岀▼纰?锛氶」鐩<E3808D><E990A9>鐞?+ 3涓<33>櫤鑳戒綋锛圵eek 3-4锛?
- 閲岀▼纰?锛?2涓<32>櫤鑳戒綋 + 鐭ヨ瘑搴擄紙Week 5-6锛?
- 閲岀▼纰?锛氬巻鍙茶<E98D99>褰?+ 鏂囨。鐢熸垚锛圵eek 7-8锛?
- 閲岀▼纰?锛氳繍钀ュ悗鍙?+ 娴嬭瘯浼樺寲锛圵eek 9-10锛?
- 设计阶段Day 1-3
- 里程碑1基础架构 + 用户认证Week 1-2
- 里程碑2项目管理 + 3个智能体Week 3-4
- 里程碑312个智能体 + 知识库(Week 5-6
- 里程碑4历史记录 + 文档生成Week 7-8
- 里程碑5运营后台 + 测试优化Week 9-10
### 鉁?5. 浠g爜瑙勮寖锛?00+琛岋級
**鏂囦欢锛?* `docs/02-寮€鍙戣<EFBFBD>鑼?浠g爜瑙勮寖.md`
### 5. 代码规范600+行)
**文件:** `docs/02-开发规范/代码规范.md`
**鍖呭惈鍐呭<EFBFBD>锛?*
**包含内容:**
- TypeScript规范
- React组件规范
- Node.js后端规范
@@ -94,99 +94,99 @@
- 注释规范
- Git提交规范
- ESLint/Prettier配置
- Code Review妫€鏌ユ竻鍗?
- Code Review检查清单
### 鉁?6. 鏍稿績涓氬姟瑙勫垯锛?00+琛岋級
**鏂囦欢锛?* `docs/03-涓氬姟瑙勫垯/鏍稿績涓氬姟瑙勫垯鎬昏<E98EAC>.md`
### 6. 核心业务规则700+行)
**文件:** `docs/03-业务规则/核心业务规则总览.md`
**鍖呭惈鍐呭<EFBFBD>锛?*
- 鐢ㄦ埛绠$悊瑙勫垯锛堟敞鍐?鐧诲綍/鏉冮檺锛?
- 椤圭洰绠悊瑙勫垯锛圕RUD/鏉冮檺楠岃瘉锛?
- 鏅鸿兘浣撶<EFBFBD>鐞嗚<EFBFBD>鍒欙紙閰嶇疆/Prompt锛?
- 瀵硅瘽绠$悊瑙勫垯锛堜笂涓嬫枃/娴佸紡杈撳嚭锛?
- 鐭ヨ瘑搴撶<EFBFBD>鐞嗚<EFBFBD>鍒欙紙閰嶉<EFBFBD>/鏂囨。澶勭悊锛?
- 鏉冮檺鎺у埗瑙勫垯锛圧BAC/鏁版嵁闅旂<E99785>锛?
- 閰嶉<EFBFBD>闄愬埗瑙勫垯锛堢煡璇嗗簱/API闄愭祦锛?
**包含内容:**
- 用户管理规则(注册/登录/权限)
- 项目管理规则CRUD/权限验证)
- 智能体管理规则(配置/Prompt
- 对话管理规则(上下文/流式输出)
- 知识库管理规则(配额/文档处理)
- 权限控制规则RBAC/数据隔离)
- 配额限制规则(知识库/API限流
**鍏抽敭瑙勫垯锛?*
- BR-K001: 姣忕敤鎴锋渶澶?涓<>煡璇嗗簱
- BR-K002: 姣忕煡璇嗗簱鏈€澶?0涓<30>枃妗?
**关键规则:**
- BR-K001: 每用户最多3个知识库
- BR-K002: 每知识库最多50个文档
- BR-K003: 只支持PDF和DOCX格式
- BR-K004: 鍗曟枃浠舵渶澶?0MB
- BR-C003: 椤圭洰鑳屾櫙鑷<EFBFBD>姩娉ㄥ叆涓婁笅鏂?
- BR-C006: 鍥哄畾娑堟伅鍒伴」鐩<EFBFBD>儗鏅?
- BR-K004: 单文件最大50MB
- BR-C003: 项目背景自动注入上下文
- BR-C006: 固定消息到项目背景
---
## 📊 文档统计
| 鏂囨。绫诲瀷 | 鏂囦欢鏁?| 鎬昏<E98EAC>鏁?| 鐘舵€?|
| 文档类型 | 文件数 | 总行数 | 状态 |
|---------|-------|--------|------|
| 鏁版嵁搴撹<EFBFBD>璁?| 1 | 771 | 鉁?|
| API璁捐<EFBFBD> | 1 | 1,023 | 鉁?|
| 寮€鍙戣<EFBFBD>鍒?| 1 | 586 | 鉁?|
| 浠g爜瑙勮寖 | 1 | 600+ | 鉁?|
| 涓氬姟瑙勫垯 | 1 | 700+ | 鉁?|
| **鎬昏<EFBFBD>** | **5** | **3,680+** | **鉁?* |
| 数据库设计 | 1 | 771 | |
| API设计 | 1 | 1,023 | |
| 开发计划 | 1 | 586 | |
| 代码规范 | 1 | 600+ | |
| 业务规则 | 1 | 700+ | |
| **总计** | **5** | **3,680+** | **✅** |
---
## 馃幆 璁捐<E79281>鏂囨。鐨勬牳蹇冧环鍊?
## 🎯 设计文档的核心价值
### 1. 涓哄墠鍚庣<EFBFBD>寮€鍙戞彁渚涘<EFBFBD>绾?
- 鉁?API璁捐<EFBFBD>瑙勮寖鏄<EFBFBD>墠鍚庣<EFBFBD>鍗忎綔鐨勫<EFBFBD>绾?
- 鉁?鍙<>互骞惰<E9AA9E>寮€鍙戯紝浜掍笉闃诲<E99783>
- 鉁?閬垮厤鎺ュ彛棰戠箒鍙樻洿
### 1. 为前后端开发提供契约
- API设计规范是前后端协作的契约
- ✅ 可以并行开发,互不阻塞
- ✅ 避免接口频繁变更
### 2. 閬垮厤寮€鍙戣繃绋嬩腑鐨勮繑宸?
- 鉁?鏁版嵁搴撹<E690B4>璁℃彁鍓嶇瀹氾紝鏀瑰姩鎴愭湰浣?
- 鉁?涓氬姟瑙勫垯鏄庣‘锛屽噺灏戠悊瑙e亸宸?
- 鉁?浠g爜瑙勮寖缁熶竴锛屾彁楂樿川閲?
### 2. 避免开发过程中的返工
- ✅ 数据库设计提前确定,改动成本低
- ✅ 业务规则明确,减少理解偏差
- ✅ 代码规范统一,提高质量
### 3. 提高团队协作效率
- 鉁?鏂版垚鍛樺揩閫熶笂鎵?
- 鉁?鍑忓皯娌熼€氭垚鏈?
- 鉁?Review鏈夋嵁鍙<EFBFBD>
- ✅ 新成员快速上手
- ✅ 减少沟通成本
- Review有据可依
### 4. 渚夸簬鍚庢湡缁存姢鍜屾墿灞?
- 鉁?鏂囨。鍖栫殑璁捐<E79281>鍐崇瓥
- 鉁?娓呮櫚鐨勪笟鍔¢€昏緫
- 鉁?鍙<>拷婧<E68BB7>殑鍙樻洿鍘嗗彶
### 4. 便于后期维护和扩展
- ✅ 文档化的设计决策
- ✅ 清晰的业务逻辑
- ✅ 可追溯的变更历史
---
## 馃殌 涓嬩竴姝ヨ<E5A79D>鍔?
## 🚀 下一步行动
### 立即可做(今天)
**1. Review设计文档**
- [ ] 浠旂粏闃呰<EFBFBD>鏁版嵁搴撹<EFBFBD>璁℃枃妗?
- [ ] 仔细阅读数据库设计文档
- [ ] 仔细阅读API设计规范
- [ ] 仔细阅读业务规则
- [ ] 鎻愬嚭鐤戦棶鍜屼紭鍖栧缓璁?
- [ ] 提出疑问和优化建议
**2. 团队讨论(如有团队)**
- [ ] 召开设计Review会议
- [ ] <EFBFBD><EFBFBD>鎶€鏈<EFBFBD>粏鑺?
- [ ] 确认技术细节
- [ ] 调整不合理的地方
**3. 鍑嗗<EFBFBD>寮€鍙戠幆澧?*
**3. 准备开发环境**
- [ ] 安装Docker Desktop ✅(已完成)
- [ ] 申请DeepSeek API Key ✅(已完成)
- [ ] 申请Qwen API Key ✅(已完成)
### 鏄庡ぉ寮€濮?
### 明天开始
**Day 4: 环境搭建**
- [ ] 创建项目目录结构
- [ ] 启动Docker服务
- [ ] 初始化Git仓库
- [ ] 楠岃瘉鎵€鏈夋湇鍔?
- [ ] 验证所有服务
**Day 5-7: 基础框架**
- [ ] 后端框架搭建
- [ ] 前端框架搭建
- [ ] 鏁版嵁搴撹縼绉?
- [ ] 数据库迁移
---
@@ -197,103 +197,103 @@
AIclinicalresearch/docs/
├── README.md # 文档导航
├── 00-项目概述/
鈹? 鈹斺攢鈹€ 璁捐<E79281>鏂囨。瀹屾垚鎬荤粨.md # <EFBFBD>枃妗?
│ └── 设计文档完成总结.md # 本文档
├── 01-设计文档/
鈹? 鈹溾攢鈹€ 鏁版嵁搴撹<E690B4>璁℃枃妗?md 猸?
鈹? 鈹斺攢鈹€ API璁捐<E79281>瑙勮寖.md 猸?
鈹溾攢鈹€ 02-寮€鍙戣<E98D99>鑼?
鈹? 鈹斺攢鈹€ 浠g爜瑙勮寖.md 猸?
│ ├── 数据库设计文档.md
│ └── API设计规范.md
├── 02-开发规范/
│ └── 代码规范.md
├── 03-业务规则/
鈹? 鈹斺攢鈹€ 鏍稿績涓氬姟瑙勫垯鎬昏<E98EAC>.md 猸?
鈹斺攢鈹€ 04-寮€鍙戣<E98D99>鍒?
鈹斺攢鈹€ 寮€鍙戦噷绋嬬<E7BB8B>.md 猸?
│ └── 核心业务规则总览.md
└── 04-开发计划/
└── 开发里程碑.md
```
---
## 💡 使用建议
### 瀵逛簬寮€鍙戣€?
1. **寮€鍙戝墠蹇呰<EFBFBD>锛?*
### 对于开发者
1. **开发前必读:**
- 数据库设计文档(了解表结构)
- API设计规范了解接口定义
- 浠g爜瑙勮寖锛堢粺涓€浠g爜椋庢牸锛?
- 代码规范(统一代码风格)
2. **开发中参考:**
- 涓氬姟瑙勫垯鎬昏<EFBFBD>锛堢悊瑙笟鍔¢€昏緫锛?
- 业务规则总览(理解业务逻辑)
- 开发里程碑(明确当前任务)
3. **遇到问题时:**
- 鍏堟煡闃呯浉鍏虫枃妗?
- 鏂囨。涓嶆竻妤氭椂鍐嶈<EFBFBD>璁?
- 先查阅相关文档
- 文档不清楚时再讨论
- 讨论结果更新文档
### 对于项目经理
1. **杩涘害绠$悊锛?*
1. **进度管理:**
- 参考开发里程碑
- 每周更新进度
- 椋庨櫓鍙婃椂娌熼€?
- 风险及时沟通
2. **璐ㄩ噺鎶婃帶锛?*
- Code Review鍙傝€冧唬鐮佽<EFBFBD>鑼?
- 楠屾敹鍙傝€冮獙鏀舵爣鍑?
- 涓氬姟閫昏緫鍙傝€冧笟鍔¤<EFBFBD>鍒?
2. **质量把控:**
- Code Review参考代码规范
- 验收参考验收标准
- 业务逻辑参考业务规则
---
## 鉁?楠屾敹妫€鏌?
## ✅ 验收检查
### 璁捐<EFBFBD>鏂囨。璐ㄩ噺妫€鏌?
### 设计文档质量检查
- [x] 数据库设计完整,包含所有核心表
- [x] API璁捐<EFBFBD>瑕嗙洊鎵€鏈夊姛鑳芥ā鍧?
- [x] 涓氬姟瑙勫垯娓呮櫚锛屾棤浜屼箟鎬?
- [x] API设计覆盖所有功能模块
- [x] 业务规则清晰,无二义性
- [x] 开发计划详细,可执行性强
- [x] 代码规范全面,有示例代码
### <EFBFBD>敤鎬ф<EFBFBD>鏌?
- [x] 鏂囨。缁撴瀯娓呮櫚锛屾槗浜庢煡鎵?
### 可用性检查
- [x] 文档结构清晰,易于查找
- [x] 术语统一,无矛盾之处
- [x] 鏈夊厖瓒崇殑绀轰緥鍜岃<EFBFBD>鏄?
- [x] 渚夸簬缁存姢鍜屾洿鏂?
- [x] 有充足的示例和说明
- [x] 便于维护和更新
---
## 🎊 总结
**鎴戜滑瀹屾垚浜嗕竴浠堕潪甯搁噸瑕佺殑宸ヤ綔锛?*
**我们完成了一件非常重要的工作!**
閫氳繃杩?灏忔椂鐨勫姫鍔涳紝鎴戜滑寤虹珛浜嗭細
- 鉁?**瀹屾暣鐨勬枃妗d綋绯?*锛?涓<>牳蹇冩枃妗3680+琛岋級
- 鉁?**娓呮櫚鐨勫紑鍙戣矾绾垮浘**锛?0鍛?0澶╄<E6BEB6>缁嗚<E7BC81>鍒掞級
- 鉁?**缁熶竴鐨勬妧鏈<E5A6A7><E98F88>鑼?*锛堟暟鎹<E69A9F>簱銆丄PI銆佷唬鐮侊級
- 鉁?**鏄庣鐨勪笟鍔¤<E98D94>鍒?*锛?0+鏉笟鍔¤<E98D94>鍒欙級
通过这3小时的努力我们建立了
- **完整的文档体系**5个核心文档3680+行)
- **清晰的开发路线图**10周70天详细计划
- **统一的技术规范**数据库、API、代码
- **明确的业务规则**70+条业务规则)
**这些文档的价值:**
- 馃挵 **鑺傜渷鏃堕棿**锛氶伩鍏嶅悗鏈熻繑宸ワ紝棰勮<E6A3B0>鑺傜渷15-20澶?
- 馃搱 **鎻愰珮璐ㄩ噺**锛氱粺涓€瑙勮寖锛屼唬鐮佽川閲忔洿楂?
- <EFBFBD> **闄嶄綆椋庨櫓**锛氳<E9949B>璁℃槑纭<E6A791>紝鎶€鏈<E282AC><E98F88>闄╁彲鎺?
- 馃殌 **鍔犲揩寮€鍙?*锛氫换鍔℃竻鏅帮紝骞惰<E9AA9E>寮€鍙戞洿楂樻晥
- 💰 **节省时间**:避免后期返工,预计节省15-20
- 📈 **提高质量**:统一规范,代码质量更高
- 🤝 **降低风险**:设计明确,技术风险可控
- 🚀 **加快开发**:任务清晰,并行开发更高效
---
## 馃幆 鐜板湪鍙<E6B9AA>互淇″績婊℃弧鍦板紑濮嬪紑鍙戜簡锛?
## 🎯 现在可以信心满满地开始开发了!
**基于这些文档,我们可以:**
1. 鉁?鍓嶅悗绔<E68297>苟琛屽紑鍙戯紙API宸插畾涔夛級
2. 鉁?鏁版嵁搴撶粨鏋勭ǔ瀹氾紙寰堝皯闇€瑕佽縼绉伙級
3. 鉁?涓氬姟閫昏緫鏄庣锛堝噺灏戠悊瑙亸宸<E4BAB8>
4. 鉁?浠g爜椋庢牸缁熶竴锛堜究浜庡崗浣滃拰Review锛?
5. 鉁?杩涘害鍙<E5AEB3>帶锛堟瘡鏃ヤ换鍔℃竻鏅帮級
1. ✅ 前后端并行开发API已定义
2. ✅ 数据库结构稳定(很少需要迁移)
3. ✅ 业务逻辑明确(减少理解偏差)
4. ✅ 代码风格统一(便于协作和Review
5. ✅ 进度可控(每日任务清晰)
---
**鍑嗗<EFBFBD>濂戒簡鍚楋紵璁╂垜浠<EFBFBD>紑濮婦ay 4鐨勫紑鍙戝伐浣滃惂锛?* 馃殌
**准备好了吗让我们开始Day 4的开发工作吧** 🚀
---
**鏂囨。鐗堟湰锛?* v1.0
**瀹屾垚鏃堕棿锛?* 2025-10-10
**鍒涘缓鑰咃細** AI鎶€鏈<EFBFBD>【闂?+ 椤圭洰鍥㈤槦
**文档版本:** v1.0
**完成时间:** 2025-10-10
**创建者:** AI技术顾问 + 项目团队