feat(aia): Complete AIA V2.0 with universal streaming capabilities
Major Changes: - Add StreamingService with OpenAI Compatible format - Upgrade Chat component V2 with Ant Design X integration - Implement AIA module with 12 intelligent agents - Update API routes to unified /api/v1 prefix - Update system documentation Backend (~1300 lines): - common/streaming: OpenAI Compatible adapter - modules/aia: 12 agents, conversation service, streaming integration - Update route versions (RVW, PKB to v1) Frontend (~3500 lines): - modules/aia: AgentHub + ChatWorkspace (100% prototype restoration) - shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook - Update API endpoints to v1 Documentation: - AIA module status guide - Universal capabilities catalog - System overview updates - All module documentation sync Tested: Stream response verified, authentication working Status: AIA V2.0 core completed (85%)
This commit is contained in:
@@ -1,114 +1,102 @@
|
||||
# **PRD：Tool C \- 科研数据编辑器 (The Research Editor)**
|
||||
# **PRD<EFBFBD>啜ool C \- 遘醍<EFBFBD>疲焚謐ｮ郛冶ｾ大<EFBFBD>?(The Research Editor)**
|
||||
|
||||
| 文档版本 | V6.0 (AI Code Interpreter 增强版) |
|
||||
| 譁<EFBFBD>｡｣迚域悽 | V6.0 (AI Code Interpreter 蠅槫ｼｺ迚? |
|
||||
| :---- | :---- |
|
||||
| **产品形态** | Web 端双核编辑器 (GUI 可视化操作 \+ LUI 自然语言交互) |
|
||||
| **核心价值** | 将“Excel 的易用性”与“Python 的强大能力”结合。医生既可以通过鼠标点击完成微操，也可以通过自然语言指挥 AI 编写代码完成复杂的清洗任务（如长宽转换、多重插补）。 |
|
||||
| **技术底座** | Node.js BFF \+ Python Server-side Sandbox \+ DeepSeek-V3 |
|
||||
| **莠ｧ蜩∝ｽ｢諤?* | Web 遶ｯ蜿梧<E89CBF>ｸ郛冶ｾ大勣 (GUI 蜿ｯ隗<EFBDAF>喧謫堺ｽ?\+ LUI 閾ｪ辟ｶ隸ｭ險莠､莠<EFBDA4>) |
|
||||
| **譬ｸ蠢<EFBFBD>ｻｷ蛟?* | 蟆<>廢xcel 逧<><E980A7>逕ｨ諤ｧ窶昜ｸ寂弃ython 逧<>ｼｺ螟ｧ閭ｽ蜉帚晉ｻ灘粋縲ょ現逕滓里蜿ｯ莉･騾夊ｿ<E5A48A>ｼ<EFBFBD>譬<EFBFBD>せ蜃ｻ螳梧<E89EB3>蠕ｮ謫搾ｼ御ｹ溷庄莉･騾夊ｿ<E5A48A><EFBDBF>辟ｶ隸ｭ險謖<C280>硯 AI 郛門<E9839B>莉｣遐∝ｮ梧<EFBDAE>螟肴揩逧<E68FA9>ｸ<EFBFBD>ｴ嶺ｻｻ蜉｡<E89C89>亥ｦる柄螳ｽ霓ｬ謐｢縲∝､夐㍾謠定｡･<EFBDA1>峨?|
|
||||
| **謚譛ｯ蠎募ｺ?* | Node.js BFF \+ Python Server-side Sandbox \+ DeepSeek-V3 |
|
||||
|
||||
## **一、 产品核心理念 (Core Philosophy)**
|
||||
## **荳縲?莠ｧ蜩∵<E89CA9>ｸ蠢<EFBDB8>炊蠢ｵ (Core Philosophy)**
|
||||
|
||||
### **1.1 蜿梧<E89CBF>ｸ鬩ｱ蜉ｨ (Dual-Core Interaction)**
|
||||
|
||||
* **左脑 (GUI):** 提供类似 Excel 的网格和工具栏，适合“直觉式、原子化”的操作（如手动修改一个值、排序、筛选）。
|
||||
* **右脑 (AI Copilot):** 提供对话式代码解释器，适合“逻辑性、批量化”的操作（如“把年龄按60岁分箱”、“删除所有空行”、“计算生存时间”）。
|
||||
|
||||
* **蟾ｦ閼<EFBFBD> (GUI):** 謠蝉ｾ帷ｱｻ莨ｼ Excel 逧<>ｽ第<EFBDBD>ｼ蜥悟ｷ･蜈ｷ譬擾ｼ碁ょ粋窶懃峩隗牙ｼ上∝次蟄仙喧窶晉噪謫堺ｽ懶ｼ亥ｦよ焔蜉ｨ菫ｮ謾ｹ荳荳ｪ蛟ｼ縲∵賜蠎上∫ｭ幃会ｼ峨?
|
||||
* **蜿ｳ閼<EFBFBD> (AI Copilot):** 謠蝉ｾ帛ｯｹ隸晏ｼ丈ｻ｣遐∬ｧ｣驥雁勣<EFBFBD>碁ょ粋窶憺ｻ霎第ｧ縲∵音驥丞喧窶晉噪謫堺ｽ懶ｼ亥ｦや懈滑蟷ｴ鮴<EFBFBD><EFBFBD>?0蟯∝<E89FAF>邂ｱ窶昴≫懷唖髯､謇譛臥ｩｺ陦娯昴≫懆ｮ｡邂礼函蟄俶慮髣ｴ窶晢ｼ峨?
|
||||
### **1.2 蜿ｯ謗ｧ鮟醍將 (Controllable Blackbox)**
|
||||
|
||||
AI 不直接修改数据，而是**生成 Python 代码**。系统在执行前展示\*\*“预操作卡片”\*\*，由用户确认执行，确保科研数据的严谨性。
|
||||
AI 荳咲峩謗･菫ｮ謾ｹ謨ｰ謐ｮ<EFBFBD>瑚梧弍**逕滓<E98095> Python 莉｣遐<EFBDA3>**縲らｳｻ扈溷惠謇ｧ陦悟燕螻慕､ｺ\*\*窶憺｢<E686BA>桃菴懷今迚<E4BB8A>拿*\*<2A>檎罰逕ｨ謌ｷ遑ｮ隶､謇ｧ陦鯉ｼ檎｡ｮ菫晉ｧ醍<EFBDA7>疲焚謐ｮ逧<EFBDAE>ｸ･隹ｨ諤ｧ縲?
|
||||
## **莠後?譬ｸ蠢<EFBDB8>ｸ壼苅豬∫ｨ<E288AB> (User Flow)**
|
||||
|
||||
## **二、 核心业务流程 (User Flow)**
|
||||
謨ｰ謐ｮ蟇ｼ蜈･ \-\> 蜿梧ｨ｡蠑乗ｸ<E4B997>ｴ?(轤ｹ蜃ｻ蟾･蜈ｷ譬?OR 蟇ｹ隸<EFBDB9> AI) \-\> 莉｣遐<EFBDA3>/謫堺ｽ懈鴬陦<E9B4AC> \-\> 螳樊慮鬚<E685AE>ｧ域峩譁ｰ \-\> 迚域悽蠢ｫ辣ｧ \-\> 蟇ｼ蜃ｺ扈捺棡
|
||||
|
||||
数据导入 \-\> 双模式清洗 (点击工具栏 OR 对话 AI) \-\> 代码/操作执行 \-\> 实时预览更新 \-\> 版本快照 \-\> 导出结果
|
||||
|
||||
## **三、 功能模块详解 (Functional Requirements)**
|
||||
## **荳峨?蜉溯<E89C89>讓｡蝮苓ｯｦ隗｣ (Functional Requirements)**
|
||||
|
||||
### **1\. 逡碁擇蟶<E69387>ｱ (The Workspace)**
|
||||
|
||||
* **P0:** **蛻<><E89BBB>丞ｸ<E4B89E>ｱ (Split View):**
|
||||
* **左侧 (70%):** 超级网格 (The Grid)，展示数据预览。
|
||||
* **右侧 (30%):** 智能侧边栏 (Smart Sidebar)，包含 **\[统计概览\]** 和 **\[AI 助手\]** 两个 Tab。
|
||||
* **P0:** **全局状态指示:**
|
||||
* 当 AI 正在思考或后端正在计算时，左侧网格显示 **“AI 处理中...”** 遮罩，并锁定编辑，防止双写冲突。
|
||||
* **蟾ｦ萓ｧ (70%):** 雜<EFBFBD>ｺｧ鄂第<EFBFBD>ｼ (The Grid)<EFBFBD>悟ｱ慕､ｺ謨ｰ謐ｮ鬚<EFBFBD>ｧ医?
|
||||
* **蜿ｳ萓ｧ (30%):** 譎ｺ閭ｽ萓ｧ霎ｹ譬?(Smart Sidebar)<EFBFBD>悟桁蜷?**\[扈溯ｮ｡讎りｧ<E3828A>]** 蜥?**\[AI 蜉ｩ謇欺]** 荳､荳ｪ Tab縲?
|
||||
* **P0:** **蜈ｨ螻迥ｶ諤∵欠遉?**
|
||||
* 蠖?AI 豁｣蝨ｨ諤晁<EFBFBD><EFBFBD>蜷守ｫｯ豁｣蝨ｨ隶｡邂玲慮<EFBFBD>悟ｷｦ萓ｧ鄂第<EFBFBD>ｼ譏ｾ遉ｺ **窶廣I 螟<>炊荳?..窶?* 驕ｮ鄂ｩ<E98482>悟ｹｶ髞∝ｮ夂ｼ冶ｾ托ｼ碁亟豁｢蜿悟<E89CBF>蜀ｲ遯√?
|
||||
### **2\. 鬘ｶ驛ｨ謇∝ｹｳ蟾･蜈ｷ譬?(Flat Toolbar) 窶披?GUI 譬ｸ蠢<EFBDB8>**
|
||||
|
||||
### **2\. 顶部扁平工具栏 (Flat Toolbar) —— GUI 核心**
|
||||
|
||||
*保留高频、标准化的操作入口，作为 AI 的补充。*
|
||||
*菫晉蕗鬮倬｢代∵<C280><E288B5>㊥蛹也噪謫堺ｽ懷<EFBDBD>蜿｣<E89CBF>御ｽ應ｸｺ AI 逧<>｡･蜈<EFBDA5>?
|
||||
|
||||
* **P0: 蜿倬㍼蜉<E38DBC>蟾･:**
|
||||
* **生成新变量:** 弹窗公式构建器。
|
||||
* **计算时间差:** 内置医学常数 (年=365.25天)。
|
||||
* **生成哑变量:** 回归分析专用。
|
||||
* **横纵表转换 (Pivot):** \* *交互升级:* 点击后不再只是纯前端计算，而是调用后端 Python 逻辑，支持处理更复杂的转换。
|
||||
* **逕滓<EFBFBD>譁ｰ蜿倬<EFBFBD>?** 蠑ｹ遯怜<E981AF>蠑乗桷蟒ｺ蝎ｨ縲?
|
||||
* **隶｡邂玲慮髣ｴ蟾?** 蜀<>ｽｮ蛹ｻ蟄ｦ蟶ｸ謨ｰ (蟷?365.25螟?縲?
|
||||
* **逕滓<EFBFBD>蜩大序驥?** 蝗槫ｽ貞<EFBDBD>譫蝉ｸ鍋畑縲?
|
||||
* **讓ｪ郤ｵ陦ｨ霓ｬ謐?(Pivot):** \* *莠､莠貞合郤ｧ:* 轤ｹ蜃ｻ蜷惹ｸ榊<EFBDB8>蜿ｪ譏ｯ郤ｯ蜑咲ｫｯ隶｡邂暦ｼ瑚梧弍隹<E5BC8D>畑蜷守ｫｯ Python 騾ｻ霎托ｼ梧髪謖∝､<E2889D>炊譖ｴ螟肴揩逧<E68FA9>ｽｬ謐｢縲?
|
||||
* **P0: 雍ｨ驥乗ｲｻ逅<EFBDBB>:**
|
||||
* **查找重复值:** 按 ID 或全字段查重。
|
||||
* **多重插补 (MICE):** 全局入口，调用后端 sklearn 或 fancyimpute 库。
|
||||
* **P0: 样本筛选:** 构建入排标准。
|
||||
* **譟･謇ｾ驥榊､榊?** 謖?ID 謌門<EFBFBD>蟄玲ｮｵ譟･驥阪?
|
||||
* **螟夐㍾謠定｡･ (MICE):** 蜈ｨ螻蜈･蜿｣<EFBFBD>瑚ｰ<EFBFBD>畑蜷守ｫ?sklearn 謌?fancyimpute 蠎薙?
|
||||
* **P0: 譬ｷ譛ｬ遲幃?** 譫<>ｻｺ蜈･謗呈<E8AC97><E59188>㊥縲?
|
||||
### **3\. AI Copilot 譎ｺ閭ｽ蜉ｩ謇<EFBDA9> (The Brain) 窶披?V6 譬ｸ蠢<EFBDB8>合郤ｧ**
|
||||
|
||||
### **3\. AI Copilot 智能助手 (The Brain) —— V6 核心升级**
|
||||
|
||||
*位于右侧侧边栏的 \[AI 助手\] Tab。*
|
||||
*菴堺ｺ主承萓ｧ萓ｧ霎ｹ譬冗噪 \[AI 蜉ｩ謇欺] Tab縲?
|
||||
|
||||
#### **3.1 閾ｪ辟ｶ隸ｭ險謖<C280>ｻ､隗｣譫<EFBDA3>**
|
||||
|
||||
* **P0:** **意图识别:** 支持模糊指令，如“洗一下数据”、“把男变成1”。
|
||||
* **P0:** **上下文感知:** AI 能够读取当前的列名 (Metadata) 和前 5 行数据示例，理解数据含义。
|
||||
* **P0:** **諢丞崟隸<EFBFBD>悪:** 謾ｯ謖∵ｨ｡邉頑欠莉､<EFBFBD>悟ｦや懈ｴ嶺ｸ荳区焚謐ｮ窶昴≫懈滑逕ｷ蜿俶<EFBFBD>?窶昴?
|
||||
* **P0:** **荳贋ｸ区枚諢溽<EFBFBD>?** AI 閭ｽ螟溯ｯｻ蜿門ｽ灘燕逧<E78795><E980A7>蜷?(Metadata) 蜥悟燕 5 陦梧焚謐ｮ遉ｺ萓具ｼ檎炊隗｣謨ｰ謐ｮ蜷ｫ荵峨?
|
||||
#### **3.2 莉｣遐∬ｧ｣驥雁勣讓｡蠑?(Code Interpreter)**
|
||||
|
||||
#### **3.2 代码解释器模式 (Code Interpreter)**
|
||||
|
||||
* **P0:** **代码生成:** AI 针对用户需求，生成可执行的 **Python (Pandas)** 代码块。
|
||||
* **P0:** **预操作卡片 (Action Card):**
|
||||
* AI 不直接执行代码。
|
||||
* 界面展示一个卡片：操作类型: 数据分箱 | 目标列: 年龄 | 代码预览。
|
||||
* 按钮：**\[运行代码\]** | **\[取消\]**。
|
||||
* **P0:** **莉｣遐∫函謌<E587BD>:** AI 髓亥ｯｹ逕ｨ謌ｷ髴豎ゑｼ檎函謌仙庄謇ｧ陦檎噪 **Python (Pandas)** 莉｣遐∝摎縲?
|
||||
* **P0:** **鬚<>桃菴懷今迚?(Action Card):**
|
||||
* AI 荳咲峩謗･謇ｧ陦御ｻ｣遐√?
|
||||
* 逡碁擇螻慕､ｺ荳荳ｪ蜊｡迚<EFBFBD>ｼ壽桃菴懃ｱｻ蝙<EFBFBD>: 謨ｰ謐ｮ蛻<EFBDAE>ｮｱ | 逶ｮ譬<EFBDAE><E8ADAC>? 蟷ｴ鮴<EFBDB4> | 莉｣遐<EFBDA3>｢<EFBFBD>ｧ医?
|
||||
* 謖蛾聴<EFBFBD>?*\[霑占｡御ｻ｣遐―]** | **\[蜿匁ｶ<E58C81>]**縲?
|
||||
* **P0:** **謇ｧ陦悟渚鬥<E6B89A>:**
|
||||
* 执行成功：显示 ✅，左侧表格自动刷新。
|
||||
* 执行失败：AI 自动分析 Error Log，尝试自我修正代码并建议重试。
|
||||
|
||||
* 謇ｧ陦梧<EFBFBD>蜉滂ｼ壽仞遉?笨<>ｼ悟ｷｦ萓ｧ陦ｨ譬ｼ閾ｪ蜉ｨ蛻ｷ譁ｰ縲?
|
||||
* 謇ｧ陦悟､ｱ雍･<EFBFBD>哂I 閾ｪ蜉ｨ蛻<EFBDA8>梵 Error Log<6F>悟ｰ晁ｯ戊<EFBDAF>謌台ｿｮ豁｣莉｣遐∝ｹｶ蟒ｺ隶ｮ驥崎ｯ輔?
|
||||
#### **3.3 蜈ｸ蝙<EFBDB8> AI 蝨ｺ譎ｯ謾ｯ謖<EFBDAF>**
|
||||
|
||||
* **高级清洗:** “把所有列的异常值（\>3倍标准差）替换为缺失值”。
|
||||
* **复杂提取:** “从‘诊断’列中提取出由‘/’分隔的第二部分，生成新列”。
|
||||
* **批量处理:** “删除所有缺失率超过 50% 的列”。
|
||||
|
||||
* **鬮倡ｺｧ貂<EFBFBD>ｴ<EFBFBD>:** 窶懈滑謇譛牙<E8AD9B>逧<EFBFBD>ｼょｸｸ蛟ｼ<E89B9F><EFBDBC>>3蛟肴<E89B9F><E882B4>㊥蟾ｮ<E89FBE>画崛謐｢荳ｺ郛ｺ螟ｱ蛟ｼ窶昴?
|
||||
* **螟肴揩謠仙叙:** 窶應ｻ寂倩ｯ頑妙窶吝<E7AAB6>荳ｭ謠仙叙蜃ｺ逕ｱ窶?窶吝<E7AAB6>髫皮噪隨ｬ莠碁Κ蛻<CE9A>ｼ檎函謌先眠蛻冷昴?
|
||||
* **謇ｹ驥丞､<EFBFBD>炊:** 窶懷唖髯､謇譛臥ｼｺ螟ｱ邇<EFBDB1>ｶ<EFBFBD>ｿ<EFBFBD> 50% 逧<><E980A7>窶昴?
|
||||
### **4\. 譎ｺ閭ｽ扈溯ｮ｡髱｢譚ｿ (Insight Panel)**
|
||||
|
||||
*位于右侧侧边栏的 \[统计概览\] Tab。*
|
||||
*菴堺ｺ主承萓ｧ萓ｧ霎ｹ譬冗噪 \[扈溯ｮ｡讎りｧ<E3828A>] Tab縲?
|
||||
|
||||
* **P0:** **列联动:** 点击左侧网格某一列，右侧自动显示该列的分布图（直方图/频次图）。
|
||||
* **P0:** **快捷操作:** 图表下方直接提供“填补”、“分箱”、“映射”等快捷按钮。
|
||||
* **P0:** **蛻苓＃蜉?** 轤ｹ蜃ｻ蟾ｦ萓ｧ鄂第<EFBFBD>ｼ譟蝉ｸ蛻暦ｼ悟承萓ｧ閾ｪ蜉ｨ譏ｾ遉ｺ隸･蛻礼噪蛻<EFBFBD>ｸ<EFBFBD>崟<EFBFBD>育峩譁ｹ蝗ｾ/鬚第ｬ｡蝗ｾ<E89D97>峨?
|
||||
* **P0:** **蠢ｫ謐ｷ謫堺ｽ<EFBFBD>:** 蝗ｾ陦ｨ荳区婿逶ｴ謗･謠蝉ｾ帚懷｡ｫ陦･窶昴≫懷<C280>邂ｱ窶昴≫懈丐蟆<E4B890>晉ｭ牙ｿｫ謐ｷ謖蛾聴縲?
|
||||
### **5\. 蟇ｼ蜃ｺ荳取ｵ∬ｽ?(Export)**
|
||||
|
||||
### **5\. 导出与流转 (Export)**
|
||||
|
||||
* **P0:** **结果导出:** 支持 Excel (.xlsx) 和 SPSS (.sav) 格式。
|
||||
* **P0:** **操作审计:** 导出的文件中，附带一份 **"清洗日志 (Cleaning Log)"**，记录了所有的 AI 代码和手动操作步骤（用于科研溯源）。
|
||||
|
||||
## **四、 数据与性能策略 (Data Strategy)**
|
||||
* **P0:** **扈捺棡蟇ｼ蜃ｺ:** 謾ｯ謖<EFBDAF> Excel (.xlsx) 蜥?SPSS (.sav) 譬ｼ蠑上?
|
||||
* **P0:** **謫堺ｽ懷ｮ｡隶｡:** 蟇ｼ蜃ｺ逧<EFBDBA>枚莉ｶ荳ｭ<E88DB3>碁刋蟶ｦ荳莉?**"貂<>ｴ玲律蠢<E5BE8B> (Cleaning Log)"**<2A>瑚ｮｰ蠖穂ｺ<E7A982>園譛臥噪 AI 莉｣遐∝柱謇句勘謫堺ｽ懈ｭ･鬪､<E9ACAA>育畑莠守ｧ醍<EFBDA7>疲ｺｯ貅撰ｼ峨?
|
||||
## **蝗帙?謨ｰ謐ｮ荳取ｧ閭ｽ遲也払 (Data Strategy)**
|
||||
|
||||
### **4.1 諤ｧ閭ｽ蜃<EFBDBD><E89C83> (Guardrails)**
|
||||
|
||||
* **文件大小限制:** 单个文件 **\< 20MB**。
|
||||
* **行数限制:** 建议 **\< 50,000 行** 以保证前端渲染流畅度。
|
||||
* *策略:* 后端 Python 可以处理百万行，但前端 AG Grid 仅加载前 100-1000 行作为预览（Preview Mode），导出时才生成全量文件。
|
||||
* **譁<EFBFBD>ｻｶ螟ｧ蟆城剞蛻ｶ:** 蜊穂ｸｪ譁<EFBDAA>ｻｶ **\< 20MB**縲?
|
||||
* **陦梧焚髯仙宛:** 蟒ｺ隶ｮ **\< 50,000 陦?* 莉･菫晁ｯ∝燕遶ｯ貂ｲ譟捺ｵ∫腐蠎ｦ縲?
|
||||
* *遲也払:* 蜷守ｫｯ Python 蜿ｯ莉･螟<EFBDA5>炊逋ｾ荳<EFBDBE>｡鯉ｼ御ｽ<E5BEA1>燕遶?AG Grid 莉<EFBFBD>刈霓ｽ蜑<EFBFBD> 100-1000 陦御ｽ應ｸｺ鬚<EFBFBD>ｧ茨ｼ<EFBFBD>review Mode<64>会ｼ悟ｯｼ蜃ｺ譌ｶ謇咲函謌仙<E8AC8C>驥乗枚莉ｶ縲?
|
||||
### **4.2 螳牙<E89EB3>荳朱嚼遘?*
|
||||
|
||||
### **4.2 安全与隐私**
|
||||
* **P0:** **豐咏ｮｱ髫皮ｦｻ:** AI 逕滓<E98095>逧?Python 莉｣遐∝ｿ<E2889D>｡ｻ蝨ｨ譛榊苅遶ｯ逧<EFBDAF>ｮ牙<EFBDAE>豐咏ｮｱ<EFBDAE><EFBDB1>ocker/SAE<41>我ｸｭ霑占｡鯉ｼ檎ｦ∵ｭ｢隶ｿ髣ｮ螟也ｽ大柱邉ｻ扈滓枚莉ｶ縲?
|
||||
* **P0:** **謨ｰ謐ｮ閼ｱ謨<EFBDB1>:** 遑ｮ菫晁ｾ灘<EFBDBE>郛冶ｾ大勣逧<E58BA3>焚謐ｮ蟾ｲ蝨ｨ蜑咲ｽｮ邇ｯ闃ゑｼ亥ｷ･蜈?B<>牙ｮ梧<EFBDAE>莠<EFBFBD> PII 閼ｱ謨上?
|
||||
## **莠斐?蝓狗せ荳守ｻ溯ｮ?*
|
||||
|
||||
* **P0:** **沙箱隔离:** AI 生成的 Python 代码必须在服务端的安全沙箱（Docker/SAE）中运行，禁止访问外网和系统文件。
|
||||
* **P0:** **数据脱敏:** 确保输入编辑器的数据已在前置环节（工具 B）完成了 PII 脱敏。
|
||||
|
||||
## **五、 埋点与统计**
|
||||
|
||||
* **AI 采纳率:** 展示 Action Card 后，用户点击“运行”的比例。
|
||||
* **代码报错率:** AI 生成的代码在后端执行失败的比例。
|
||||
* **常用指令 Top 10:** 统计医生最常对 AI 说的话。
|
||||
|
||||
## **六、 附录：AI 指令集示例 (Few-Shot Examples)**
|
||||
* **AI 驥<>ｺｳ邇?** 螻慕､ｺ Action Card 蜷趣ｼ檎畑謌ｷ轤ｹ蜃ｻ窶懆ｿ占｡娯晉噪豈比ｾ九?
|
||||
* **莉｣遐∵冠髞咏<EFBFBD>?** AI 逕滓<E98095>逧<EFBFBD>ｻ｣遐∝惠蜷守ｫｯ謇ｧ陦悟､ｱ雍･逧<EFBDA5>ｯ比ｾ九?
|
||||
* **蟶ｸ逕ｨ謖<EFBDA8>ｻ､ Top 10:** 扈溯ｮ｡蛹ｻ逕滓怙蟶ｸ蟇ｹ AI 隸ｴ逧<EFBDB4>ｯ昴?
|
||||
## **蜈ｭ縲?髯<>ｽ包ｼ哂I 謖<>ｻ､髮<EFBDA4>､ｺ萓?(Few-Shot Examples)**
|
||||
|
||||
| 逕ｨ謌ｷ謖<EFBDB7>ｻ､ | AI 蜉ｨ菴<EFBDA8> (Action) | 逕滓<E98095>莉｣遐<EFBDA3>ｻ霎<EFBDBB> (Python Pandas) |
|
||||
| :---- | :---- | :---- |
|
||||
| "把性别转为数字" | Recode | df\['sex'\] \= df\['sex'\].map({'男':1, '女':0}) |
|
||||
| "年龄按60分两组" | Binning | df\['age\_group'\] \= pd.cut(df\['age'\], bins=\[0,60,150\], labels=\['0','1'\]) |
|
||||
| "謚頑ｧ蛻ｫ霓ｬ荳ｺ謨ｰ蟄<EFBFBD>" | Recode | df\['sex'\] \= df\['sex'\].map({'逕?:1, '螂?:0}) |
|
||||
| "蟷ｴ鮴<EFBFBD><EFBFBD>?0蛻<30>ｸ､扈? | Binning | df\['age\_group'\] \= pd.cut(df\['age'\], bins=\[0,60,150\], labels=\['0','1'\]) |
|
||||
| "蛻<>髯､豐｡譛迂D逧<44>｡<EFBFBD>" | Filter | df \= df.dropna(subset=\['patient\_id'\]) |
|
||||
| "隶｡邂唯MI" | Formula | df\['bmi'\] \= df\['weight'\] / (df\['height'\]/100)\*\*2 |
|
||||
| "把每个人的一行变成多行" | Pivot/Melt | df \= df.melt(id\_vars=\['id'\], ...) |
|
||||
| "謚頑ｯ丈ｸｪ莠ｺ逧<EFBFBD>ｸ陦悟序謌仙､夊｡? | Pivot/Melt | df \= df.melt(id\_vars=\['id'\], ...) |
|
||||
|
||||
|
||||
@@ -1,91 +1,82 @@
|
||||
# **PRD：Tool A \- 医疗数据超级合并器 (The Super Merger)**
|
||||
# **PRD嚗関ool A \- <EFBFBD>餌<EFBFBD><EFBFBD>唳旿頞<EFBFBD>漣<EFBFBD><EFBFBD>僎<EFBFBD>?(The Super Merger)**
|
||||
|
||||
| 文档版本 | V2.0 (基准锚定版) |
|
||||
| <EFBFBD><EFBFBD>﹝<EFBFBD><EFBFBD>𧋦 | V2.0 (<EFBFBD>箏<EFBFBD><EFBFBD>𡁜<EFBFBD><EFBFBD>? |
|
||||
| :---- | :---- |
|
||||
| **产品形态** | Web 端工具（分步向导式 Wizard） |
|
||||
| **核心价值** | **解决临床科研中“一对多”数据对齐难题。** 基于“访视（Visit）”和“时间窗”逻辑，将散乱的化验、检查数据精准挂载到住院/门诊记录上。 |
|
||||
| **目标用户** | 临床医生、科研助理 |
|
||||
| **鈭批<EFBFBD>敶Ｘ<EFBFBD>?* | Web 蝡臬極<E887AC>瘀<EFBFBD><E79880><EFBFBD>郊<EFBFBD>穃紡撘?Wizard嚗?|
|
||||
| **<EFBFBD>詨<EFBFBD>隞瑕<EFBFBD>?* | **閫<EFBFBD><EFBFBD>銝游<EFBFBD>蝘𤑳<EFBFBD>銝凌<EFBFBD>靝<EFBFBD>撖孵<EFBFBD><EFBFBD>脲㺭<EFBFBD>桀笆朣鞾𠗕憸塩<EFBFBD>?* <20>箔<EFBFBD><E7AE94>𡏭挪閫<E68CAA><E996AB>Visit嚗争<E59A97>嘥<EFBFBD><E598A5>𨀣𧒄<F0A880A3>渡<EFBFBD><E6B8A1>嗪<EFBFBD>餉<EFBFBD>嚗<EFBFBD><E59A97><EFBFBD><EFBFBD>僚<EFBFBD><E5839A><EFBFBD>撉䎚<E69289><E48E9A><EFBFBD><EFBFBD>交㺭<E4BAA4>桃移<E6A183><E7A7BB><EFBFBD>頧賢<E9A0A7>雿誯堺/<2F>刻<EFBFBD>霈啣<E99C88>銝𨳍<E98A9D>?|
|
||||
| **<EFBFBD>格<EFBFBD><EFBFBD>冽<EFBFBD>** | 銝游<EFBFBD><EFBFBD>餌<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𥪜𨭌<EFBFBD>?|
|
||||
|
||||
## **一、 产品流程图 (User Flow)**
|
||||
## **銝<EFBFBD><EFBFBD>?鈭批<E988AD>瘚<EFBFBD><E7989A><EFBFBD>?(User Flow)**
|
||||
|
||||
1\. 数据装载 (Payload) \-\> 2\. 定基准 (Anchor & Window) \-\> 3\. 选列与预览 (Schema) \-\> 4\. 智能合并 \-\> 5\. 结果与流转
|
||||
1\. <EFBFBD>唳旿鋆<EFBFBD>蝸 (Payload) \-\> 2\. 摰𡁜抅<EFBFBD>?(Anchor & Window) \-\> 3\. <EFBFBD>匧<EFBFBD>銝𡡞<EFBFBD>閫?(Schema) \-\> 4\. <EFBFBD>箄<EFBFBD><EFBFBD><EFBFBD>僎 \-\> 5\. 蝏𤘪<EFBFBD>銝擧<EFBFBD>頧?
|
||||
## **鈭䎚<E988AD>?<3F>詨<EFBFBD><E8A9A8>蠘<EFBFBD><E8A098><EFBFBD>瘙?(Functional Requirements)**
|
||||
|
||||
## **二、 核心功能需求 (Functional Requirements)**
|
||||
### **1\. 甇仿炊銝<E7828A>嚗𡁏㺭<F0A1818F>株<EFBFBD>頧?(Payload)**
|
||||
|
||||
### **1\. 步骤一：数据装载 (Payload)**
|
||||
|
||||
* **P0:** **多文件上传：** 支持拖拽上传 .xlsx, .csv。建议大小 \< 50MB/文件。
|
||||
* **P0:** **自动预检 (Pre-flight Check)：**
|
||||
* 上传即解析表头。
|
||||
* **红灯拦截：** 文件加密、表头为空、文件损坏 \-\> 禁止下一步。
|
||||
* **P1:** **加载配置/模板：** 若用户之前保存过“肺癌门诊合并规则”，允许一键加载，跳过后续配置。
|
||||
|
||||
### **2\. 步骤二：定基准 (The Anchor) —— 核心算法逻辑**
|
||||
|
||||
此步骤决定了最终大表的“骨架”（行数）和“归类逻辑”。
|
||||
* **P0:** **憭𡁏<E686AD>隞嗡<E99A9E>隡𩤃<E99AA1>** <20>舀<EFBFBD><E88880>𡝗嗻銝𠹺<E98A9D> .xlsx, .csv<73><76>遣霈桀之撠?\< 50MB/<2F><>辣<EFBFBD>?
|
||||
* **P0:** **<EFBFBD>芸𢆡憸<EFBFBD><EFBFBD> (Pre-flight Check)嚗?*
|
||||
* 銝𠹺<E98A9D><F0A0B9BA>唾圾<E594BE>鞱”憭氬<E686AD>?
|
||||
* **蝥Ｙ<EFBFBD><EFBFBD>行⏛嚗?* <20><>辣<EFBFBD>惩<EFBFBD><E683A9><EFBFBD>”憭港蛹蝛箝<E89D9B><E7AE9D><EFBFBD>隞嗆<E99A9E><E59786>?\-\> 蝳<>迫銝衤<E98A9D>甇乓<E79487>?
|
||||
* **P1:** **<EFBFBD>㰘蝸<EFBFBD>滨蔭/璅⊥踎嚗?* <20>亦鍂<E4BAA6>瑚<EFBFBD><E7919A>滢<EFBFBD>摮䁅<E691AE><E48185>𡏭<EFBFBD><F0A18FAD>屸秄霂𠰴<E99C82>撟嗉<E6929F><E59789>仮<EFBFBD>嘅<EFBFBD><E59885><EFBFBD>捂銝<E68D82><E98A9D>桀<EFBFBD>頧踝<E9A0A7>頝唾<E9A09D><E594BE>𡒊賒<F0A1928A>滨蔭<E6BBA8>?
|
||||
### **2\. 甇仿炊鈭䕘<E988AD>摰𡁜抅<F0A1819C>?(The Anchor) <20>婙<EFBFBD>?<3F>詨<EFBFBD>蝞埈<E89D9E><E59F88>餉<EFBFBD>**
|
||||
|
||||
甇斗郊撉文<EFBFBD>摰帋<EFBFBD><EFBFBD><EFBFBD>蝏<EFBFBD>之銵函<EFBFBD><EFBFBD>𣈯爸<EFBFBD>嗯<EFBFBD>嘅<EFBFBD>銵峕㺭嚗匧<EFBFBD><EFBFBD>𨅯<EFBFBD>蝐駁<EFBFBD>餉<EFBFBD><EFBFBD>腈<EFBFBD>?
|
||||
#### **2.1 銝餉”<E9A489>㗇𥋘 (The Backbone)**
|
||||
|
||||
* **P0:** 用户必须从上传的文件中指定一个作为 **“主表 (Visit Base)”**。
|
||||
* **定义：** 主表的每一行，代表最终大表的一个基准行（一次就诊/访视）。通常是《住院记录》或《门诊挂号》。
|
||||
|
||||
#### **2.2 关键列映射 (Key Mapping)**
|
||||
|
||||
* **P0:** **ID 列对齐：** 用户需指定主表的 Patient\_ID 列。系统自动在辅表中寻找同名列，允许人工修正。
|
||||
* **P0:** **时间基准列：** 用户需指定主表的 Date 列（如“入院日期”）。这将作为时间窗的圆心。
|
||||
* **P0:** <EFBFBD>冽<EFBFBD>敹<EFBFBD>◆隞𦒘<EFBFBD>隡删<EFBFBD><EFBFBD><EFBFBD>辣銝剜<EFBFBD>摰帋<EFBFBD>銝芯<EFBFBD>銝?**<2A>靝蜓銵?(Visit Base)<EFBFBD>?*<2A>?
|
||||
* **摰帋<EFBFBD>嚗?* 銝餉”<E9A489><E2809D><EFBFBD>銝<EFBFBD>銵䕘<E98AB5>隞<EFBFBD>”<EFBFBD><E2809D>蝏<EFBFBD>之銵函<E98AB5>銝<EFBFBD>銝芸抅<E88AB8><E68A85><EFBFBD>嚗<EFBFBD><E59A97>甈∪停霂?霈輯<E99C88>嚗剹<E59A97><E589B9><EFBFBD>𡁜虜<F0A1819C>胯<EFBFBD>𠹺<EFBFBD><F0A0B9BA>Ｚ扇敶𨰻<E695B6>𧢲<EFBFBD><F0A7A2B2>𢠃秄霂𦠜<E99C82><F0A6A09C>瑯<EFBFBD>卝<EFBFBD>?
|
||||
#### **2.2 <20>喲睸<E596B2>埈<EFBFBD>撠?(Key Mapping)**
|
||||
|
||||
* **P0:** **ID <20>堒笆朣琜<E69CA3>** <20>冽<EFBFBD><E586BD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝餉”<E9A489>?Patient\_ID <20>𨰜<EFBFBD><F0A8B09C>頂蝏蠘䌊<E8A098>典銁颲<E98A81>”銝剖粉<E58996>曉<EFBFBD><E69B89>滚<EFBFBD>嚗<EFBFBD><E59A97>霈訾犖撌乩耨甇<E880A8><E79487>?
|
||||
* **P0:** **<EFBFBD>園𡢿<EFBFBD>箏<EFBFBD><EFBFBD>梹<EFBFBD>** <20>冽<EFBFBD><E586BD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>銝餉”<E9A489>?Date <20>梹<EFBFBD>憒<EFBFBD><E68692>𨅯<EFBFBD><F0A885AF>Ｘ𠯫<EFBCB8>麨<EFBFBD>嘅<EFBFBD><E59885><EFBFBD><EFBFBD>撠<EFBFBD><E692A0>銝箸𧒄<E7AEB8>渡<EFBFBD><E6B8A1><EFBFBD><EFBFBD>敹<EFBFBD><E695B9>?
|
||||
#### **2.3 颲<>”<EFBFBD>寥<EFBFBD>蝑𣇉裦 (Matching Strategy)**
|
||||
|
||||
* **P0:** **时间窗配置 (Time Window)：**
|
||||
* 设定规则：辅表的检查时间必须在 \[主表时间 \- X天, 主表时间 \+ Y天\] 范围内。
|
||||
* **默认值：** $\\pm 7$ 天。
|
||||
* **P0:** **冲突处理 (Collision Handling)：**
|
||||
* *场景：* 单次时间窗内，辅表有多条记录（如做了两次血常规）。
|
||||
* *选项 A (默认 \- 纵向展开)：* 保留所有记录。主表信息复制，行数增加。
|
||||
* *选项 B (最近匹配)：* 仅保留离主表时间最近的一条，丢弃其他。
|
||||
* **P0:** **<EFBFBD>園𡢿蝒烾<EFBFBD>蝵?(Time Window)嚗?*
|
||||
* 霈曉<EFBFBD>閫<EFBFBD><EFBFBD>嚗朞<EFBFBD>銵函<EFBFBD>璉<EFBFBD><EFBFBD>交𧒄<EFBFBD>游<EFBFBD>憿餃銁 \[銝餉”<E9A489>園𡢿 \- X憭? 銝餉”<E9A489>園𡢿 \+ Y憭坼] <20><>凒<EFBFBD><E58792><EFBFBD>?
|
||||
* **暺䁅恕<EFBFBD>潘<EFBFBD>** $\\pm 7$ 憭押<EFBFBD>?
|
||||
* **P0:** **<EFBFBD>脩<EFBFBD>憭<EFBFBD><EFBFBD> (Collision Handling)嚗?*
|
||||
* *<EFBFBD>箸艶嚗? <20>閙活<E99699>園𡢿蝒堒<E89D92>嚗諹<E59A97>銵冽<E98AB5>憭𡁏辺霈啣<E99C88>嚗<EFBFBD><E59A97><EFBFBD>帋<EFBFBD>銝斗活銵<E6B4BB>撣貉<E692A3>嚗剹<E59A97>?
|
||||
* *<EFBFBD>厰★ A (暺䁅恕 \- 蝥萄<EFBFBD>撅訫<EFBFBD>)嚗? 靽萘<E99DBD><E89098><EFBFBD><EFBFBD>㕑扇敶𨰻<E695B6><F0A8B0BB>蜓銵其縑<E585B6>臬<EFBFBD><E887AC>塚<EFBFBD>銵峕㺭憓𧼮<E68693><F0A7BCAE>?
|
||||
* *<EFBFBD>厰★ B (<EFBFBD><EFBFBD>餈穃龪<EFBFBD>?嚗? 隞<><E99A9E><EFBFBD>嗵氖銝餉”<E9A489>園𡢿<E59C92><F0A1A2BF>餈𤑳<E9A488>銝<EFBFBD><E98A9D>∴<EFBFBD>銝Ｗ<E98A9D><EFBCB7>嗡<EFBFBD><E597A1>?
|
||||
### **3\. 甇仿炊銝㚁<E98A9D><E39A81>匧<EFBFBD>銝𡡞<E98A9D>閫?(The Schema)**
|
||||
|
||||
### **3\. 步骤三：选列与预览 (The Schema)**
|
||||
甇斗郊撉文<EFBFBD>摰帋<EFBFBD><EFBFBD><EFBFBD>蝏<EFBFBD>之銵函<EFBFBD><EFBFBD>𡏭<EFBFBD><EFBFBD>争<EFBFBD>嘅<EFBFBD><EFBFBD>堒捐嚗剹<EFBFBD>?
|
||||
#### **3.1 <20>𤑳𠶖<F0A491B3>㗇𥋘<E39787>?(Tree Picker)**
|
||||
|
||||
此步骤决定了最终大表的“血肉”（列宽）。
|
||||
|
||||
#### **3.1 树状选择器 (Tree Picker)**
|
||||
|
||||
* **P0:** 展示所有文件的列结构。
|
||||
* **P0:** 撅閧內<E996A7><E585A7><EFBFBD>㗇<EFBFBD>隞嗥<E99A9E><E597A5>㛖<EFBFBD><E39B96><EFBFBD><EFBFBD>?
|
||||
* <20><> 銝餉”
|
||||
* ✅ 住院号
|
||||
* ✅ 诊断
|
||||
* <EFBFBD>?雿誯堺<E8AAAF>?
|
||||
* <EFBFBD>?霂𦠜鱏
|
||||
* <20><> 颲<>” A (<28>㚚<EFBFBD>)
|
||||
* ✅ 白细胞
|
||||
* ⬜ 审核医生 (不勾选)
|
||||
* **交互：** 支持按文件全选/反选。
|
||||
|
||||
* <EFBFBD>?<3F>賜<EFBFBD><E8B39C>?
|
||||
* 漎?摰⊥瓲<E28AA5>餌<EFBFBD> (銝滚㗲<E6BB9A>?
|
||||
* **鈭支<EFBFBD>嚗?* <20>舀<EFBFBD><E88880>㗇<EFBFBD>隞嗅<E99A9E><E59785>?<3F>漤<EFBFBD>剹<EFBFBD>?
|
||||
#### **3.2 摰墧𧒄蝏𤘪<E89D8F>憸<EFBFBD><E686B8> (Live Schema Preview)**
|
||||
|
||||
* **P0:** 在屏幕右侧实时展示\*\*“最终表头结构”\*\*（仅表头，不计算数据）。
|
||||
* **价值：** 让用户直观看到：“哦，原来我的表会变成这么长，包含这些列”。
|
||||
* **P0:** <EFBFBD>典<EFBFBD>撟訫𢰧靘批<EFBFBD><EFBFBD>嗅<EFBFBD>蝷暝*\*<2A>𨀣<EFBFBD>蝏<EFBFBD>”憭渡<E686AD><E6B8A1><EFBFBD><EFBFBD>𩄼*\*嚗<><E59A97>銵典仍嚗䔶<E59A97>霈∠<E99C88><E288A0>唳旿嚗剹<E59A97>?
|
||||
* **隞瑕<EFBFBD>潘<EFBFBD>** 霈拍鍂<E68B8D>瑞凒閫<E58792><E996AB><EFBFBD>堆<EFBFBD><E5A086>𨅯𣑐嚗<F0A39190><E59A97><EFBFBD>交<EFBFBD><E4BAA4><EFBFBD>”隡𡁜<E99AA1><F0A1819C>鞱<EFBFBD>銋<EFBFBD>鵭嚗<E9B5AD><E59A97><EFBFBD>怨<EFBFBD>鈭𥕦<E988AD><F0A595A6>腈<EFBFBD>?
|
||||
### **4\. 甇仿炊<E4BBBF>𨥈<EFBFBD>蝏𤘪<E89D8F>銝擧<E98A9D>頧?(The Result)**
|
||||
|
||||
### **4\. 步骤四：结果与流转 (The Result)**
|
||||
|
||||
* **P0:** **处理进度条：** 显示动态文案（“正在构建哈希索引...”、“正在进行时间窗碰撞...”）。
|
||||
* **P0:** **黄金预览 (Golden Preview)：**
|
||||
* 必须展示合并结果的 **前 5-10 行** 真实数据。
|
||||
* 用于用户肉眼核对 ID 是否对齐。
|
||||
* **P0:** **质量看板：**
|
||||
* 成功生成行数。
|
||||
* 丢弃行数（ID不匹配或时间窗外）。
|
||||
* **P0:** **行动流转：**
|
||||
* **P0:** **憭<><E686AD>餈𥕦漲<F0A595A6>∴<EFBFBD>** <20>曄內<E69B84>冽<EFBFBD><E586BD><EFBFBD>獢<EFBFBD><E78DA2><EFBFBD>𨀣迤<F0A880A3>冽<EFBFBD>撱箏<E692B1>撣𣬚揣撘?..<2E>腈<EFBFBD><E88588><EFBFBD>𨀣迤<F0A880A3>刻<EFBFBD>銵峕𧒄<E5B395>渡<EFBFBD>蝣唳<E89DA3>...<2E>嘅<EFBFBD><E59885>?
|
||||
* **P0:** **暺<><E69ABA>憸<EFBFBD><E686B8> (Golden Preview)嚗?*
|
||||
* 敹<EFBFBD>◆撅閧內<EFBFBD><EFBFBD>僎蝏𤘪<EFBFBD><EFBFBD>?**<2A>?5-10 銵?* <20>笔<EFBFBD><E7AC94>唳旿<E594B3>?
|
||||
* <EFBFBD>其<EFBFBD><EFBFBD>冽<EFBFBD><EFBFBD>厩尐<EFBFBD>詨笆 ID <20>臬炏撖寥<E69296><E5AFA5>?
|
||||
* **P0:** **韐券<E99F90><E588B8>𧢲踎嚗?*
|
||||
* <EFBFBD>𣂼<EFBFBD><EFBFBD><EFBFBD><EFBFBD>銵峕㺭<EFBFBD>?
|
||||
* 銝Ｗ<E98A9D>銵峕㺭嚗㇆D銝滚龪<E6BB9A>齿<EFBFBD><E9BDBF>園𡢿蝒堒<E89D92>嚗剹<E59A97>?
|
||||
* **P0:** **銵<>𢆡瘚<F0A286A1>蓮嚗?*
|
||||
* \[銝贝蝸 Excel\]
|
||||
* \[<5B>煾<EFBFBD><E785BE><EFBFBD> AI 蝏𤘪<E89D8F><F0A498AA>硋極<E7A18B>愧] (瘚<>蓮 Token)
|
||||
* \[<5B>煾<EFBFBD><E785BE><EFBFBD> 蝻𤥁<E89DBB><F0A4A581>冽<EFBFBD>瘣珢] (瘚<>蓮 Token)
|
||||
|
||||
## **三、 核心算法逻辑 (Technical Logic)**
|
||||
## **銝剹<EFBFBD>?<3F>詨<EFBFBD>蝞埈<E89D9E><E59F88>餉<EFBFBD> (Technical Logic)**
|
||||
|
||||
### **1\. 算法名称：基于时间窗的哈希流式连接 (Time-Windowed Stream Hash Join)**
|
||||
### **1\. 蝞埈<EFBFBD><EFBFBD>滨妍嚗𡁜抅鈭擧𧒄<EFBFBD>渡<EFBFBD><EFBFBD><EFBFBD><EFBFBD>撣峕<EFBFBD>撘讛<EFBFBD><EFBFBD>?(Time-Windowed Stream Hash Join)**
|
||||
|
||||
### **2\. 执行伪代码**
|
||||
### **2\. <EFBFBD>扯<EFBFBD>隡芯誨<EFBFBD>?*
|
||||
|
||||
// 1\. <20><><EFBFBD><EFBFBD><EFBFBD>遣 (Build Phase)
|
||||
// 将辅表 (Small Tables) 读入内存 Map
|
||||
// 撠<EFBFBD><EFBFBD>銵?(Small Tables) 霂餃<EFBFBD><EFBFBD><EFBFBD><EFBFBD> Map
|
||||
const lookupMap \= {
|
||||
"patient\_001": \[
|
||||
{ type: "lab", date: "2023-01-02", data: {...} }, // 霈啣<E99C88>1
|
||||
@@ -116,16 +107,14 @@ streamMainTable.on('data', (mainRow) \=\> {
|
||||
}
|
||||
});
|
||||
|
||||
## **四、 界面原型参考 (UI Reference)**
|
||||
## **<EFBFBD>䜘<EFBFBD>?<3F>屸𢒰<E5B1B8>笔<EFBFBD><E7AC94><EFBFBD><EFBFBD>?(UI Reference)**
|
||||
|
||||
请参考 工具A\_超级合并器\_原型设计.tsx (V1.0) 中的 Step 2 和 Step 3 界面。
|
||||
|
||||
* **Step 2 重点：** 主表选择单选框、时间列下拉框、策略单选钮。
|
||||
* **Step 3 重点：** 左右分栏布局（左侧树状勾选，右侧表格骨架预览）。
|
||||
|
||||
## **五、 风险规避检查 (Risk Check)**
|
||||
霂瑕<EFBFBD><EFBFBD>?撌亙<E6928C>A\_頞<5F>漣<EFBFBD><E6BCA3>僎<EFBFBD>沔_<E6B294>笔<EFBFBD>霈曇恣.tsx (V1.0) 銝剔<EFBFBD> Step 2 <EFBFBD>?Step 3 <EFBFBD>屸𢒰<EFBFBD>?
|
||||
* **Step 2 <20>滨<EFBFBD>嚗?* 銝餉”<E9A489>㗇𥋘<E39787>閖<EFBFBD>㗇<EFBFBD><E39787><EFBFBD>𧒄<EFBFBD>游<EFBFBD>銝𧢲<E98A9D>獢<EFBFBD><E78DA2><EFBFBD><EFBFBD><EFBFBD>亙<EFBFBD><E4BA99>厰僼<E58EB0>?
|
||||
* **Step 3 <20>滨<EFBFBD>嚗?* 撌血𢰧<E8A180><F0A2B0A7><EFBFBD>撣<EFBFBD><E692A3>嚗<EFBFBD>椰靘扳<E99D98><E689B3>嗅㗲<E59785>㚁<EFBFBD><E39A81>喃儒銵冽聢撉冽沲憸<E6B2B2><E686B8>嚗剹<E59A97>?
|
||||
## **鈭𢛵<E988AD>?憌𡡞埯閫<E59FAF><E996AB>璉<EFBFBD><E79289>?(Risk Check)**
|
||||
|
||||
1. **<EFBFBD>冽<EFBFBD><EFBFBD>厰<EFBFBD>銝餉”<EFBFBD>𦒘<EFBFBD><EFBFBD>痹<EFBFBD>**
|
||||
* *对策：* 在 Step 2 界面增加显眼的 **Tip**：“主表通常是包含‘入院日期’或‘诊断信息’的表格”。
|
||||
* *撖寧<EFBFBD>嚗? <20>?Step 2 <20>屸𢒰憓𧼮<E68693><F0A7BCAE>曄尐<E69B84>?**Tip**嚗尠<E59A97>靝蜓銵券<E98AB5>𡁜虜<F0A1819C>臬<EFBFBD><E887AC>徉<EFBFBD>睃<EFBFBD><E79D83>Ｘ𠯫<EFBCB8>麨<EFBFBD>蹱<EFBFBD><E8B9B1>䁅<EFBFBD><E48185>凋縑<E5878B>胼<EFBFBD>嗵<EFBFBD>銵冽聢<E586BD>腈<EFBFBD>?
|
||||
2. **<EFBFBD>園𡢿<EFBFBD>澆<EFBFBD>銋曹<EFBFBD><EFBFBD>怎<EFBFBD><EFBFBD>𦒘<EFBFBD><EFBFBD>痹<EFBFBD>**
|
||||
* *对策：* 后端在解析时间列时，必须使用强力的 Parser（支持 2023/1/1, 2023-01-01, 44927 等格式）。如果解析失败，归为“时间无效”，不进行匹配。
|
||||
* *撖寧<E69296>嚗? <20>𡒊垢<F0A1928A>刻圾<E588BB>鞉𧒄<E99E89>游<EFBFBD><E6B8B8>塚<EFBFBD>敹<EFBFBD>◆雿輻鍂撘箏<E69298><E7AE8F>?Parser嚗<EFBFBD>𣈲<EFBFBD>?2023/1/1, 2023-01-01, 44927 蝑㗇聢撘𧶏<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𡏭圾<EFBFBD>𣂼仃韐伐<EFBFBD>敶雴蛹<EFBFBD>𨀣𧒄<EFBFBD>湔<EFBFBD><EFBFBD><EFBFBD><EFBFBD>嘅<EFBFBD>銝滩<EFBFBD>銵<EFBFBD>龪<EFBFBD>溻<EFBFBD>
|
||||
@@ -1,82 +1,76 @@
|
||||
# **PRD嚗関ool B \- <20><><EFBFBD>蝏𤘪<E89D8F><F0A498AA>𡝗㦤<F0A19D97>其犖 (The AI Structurer)**
|
||||
|
||||
| <20><>﹝<EFBFBD><EFB99D>𧋦 | V2.0 (<28>峕芋<E5B395>衤漱<E8A1A4>厰<EFBFBD>霂<EFBFBD><E99C82>) |
|
||||
| 产品形态 | Web 端工具（批处理 \+ 全景验证网格） |
|
||||
| 核心价值 | 利用 双大模型（DeepSeek & Qwen）交叉验证 技术，将非结构化病历文本转化为高可信度的结构化数据，解决 AI 幻觉问题。 |
|
||||
| 鈭批<EFBFBD>敶Ｘ<EFBFBD>?| Web 蝡臬極<E887AC>瘀<EFBFBD><E79880>孵<EFBFBD><E5ADB5>?\+ <20>冽艶撉諹<E69289>蝵烐聢嚗?|
|
||||
| <EFBFBD>詨<EFBFBD>隞瑕<EFBFBD>?| <20>拍鍂 <20><>之璅∪<E79285>嚗㇄eepSeek & Qwen嚗劐漱<E58A90>厰<EFBFBD>霂?<3F><><EFBFBD>荔<EFBFBD>撠<EFBFBD><E692A0>蝏𤘪<E89D8F><F0A498AA>𣇉<EFBFBD><F0A38789><EFBFBD><EFBFBD><EFBFBD>祈蓮<E7A588>碶蛹擃睃虾靽∪漲<E288AA><E6BCB2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>唳旿嚗諹圾<E8ABB9>?AI 撟餉<E6929F><E9A489>桅<EFBFBD><E6A185>?|
|
||||
| <20>格<EFBFBD><E6A0BC>冽<EFBFBD> | <20><>閬<EFBFBD><E996AC><EFBFBD><EFBFBD>枂<EFBFBD>Ｗ<EFBFBD>蝏瓐<E89D8F><E79390><EFBFBD><EFBFBD><EFBFBD>𥁒<EFBFBD>羓<EFBFBD><E7BE93>餌<EFBFBD>嚗<EFBFBD>笆<EFBFBD>唳旿<E594B3><E697BF>＆<EFBFBD>扯<EFBFBD>瘙<EFBFBD><E79899>擃矋<E69383> |
|
||||
|
||||
## **一、 产品流程图 (User Flow)**
|
||||
## **銝<EFBFBD><EFBFBD>?鈭批<E988AD>瘚<EFBFBD><E7989A><EFBFBD>?(User Flow)**
|
||||
|
||||
数据导入(上传/流转) \-\> 健康体检 \-\> 智能模版配置 \-\> 双盲提取与交叉验证 \-\> 全景网格裁决 \-\> 结果导出
|
||||
<EFBFBD>唳旿撖澆<EFBFBD>(銝𠹺<E98A9D>/瘚<>蓮) \-\> <20>亙熒雿𤘪<E99BBF> \-\> <20>箄<EFBFBD>璅∠<E79285><E288A0>滨蔭 \-\> <20>𣬚𤩅<F0A3AC9A>𣂼<EFBFBD>銝𦒘漱<F0A69298>厰<EFBFBD>霂?\-\> <20>冽艶蝵烐聢鋆<E881A2><E98B86> \-\> 蝏𤘪<E89D8F>撖澆枂
|
||||
|
||||
## **二、 核心功能需求 (Functional Requirements)**
|
||||
## **鈭䎚<EFBFBD>?<3F>詨<EFBFBD><E8A9A8>蠘<EFBFBD><E8A098><EFBFBD>瘙?(Functional Requirements)**
|
||||
|
||||
### **1\. 甇仿炊銝<E7828A>嚗𡁏㺭<F0A1818F>株<EFBFBD>頧賭<E9A0A7>雿𤘪<E99BBF> (Injection & Health Check)**
|
||||
|
||||
* **P0:** **数据源接入：** 支持本地 Excel 上传，或接收来自工具 A 的流转文件。
|
||||
* **P0:** **智能体检 (Health Check)：**
|
||||
* 用户选定“文本源列”后，系统立即扫描前 100 行。
|
||||
* **拦截规则：** 若空值率 \> 80% 或平均字符数 \< 10，提示“该列不适合提取”，防止误操作浪费 Token。
|
||||
* **成本预估：** 根据字符数实时预估 Token 消耗量。
|
||||
* **P0:** **<EFBFBD>唳旿皞鞉𦻖<EFBFBD>伐<EFBFBD>** <20>舀<EFBFBD><E88880>砍𧑐 Excel 銝𠹺<E98A9D>嚗峕<E59A97><E5B395>交𤣰<E4BAA4>亥䌊撌亙<E6928C> A <20><><EFBFBD>頧祆<E9A0A7>隞嗚<E99A9E>?
|
||||
* **P0:** **<EFBFBD>箄<EFBFBD>雿𤘪<EFBFBD> (Health Check)嚗?*
|
||||
* <EFBFBD>冽<EFBFBD><EFBFBD>匧<EFBFBD><EFBFBD>𨀣<EFBFBD><EFBFBD>祆<EFBFBD><EFBFBD>轁<EFBFBD>嘥<EFBFBD>嚗𣬚頂蝏毺<EFBFBD><EFBFBD>單醌<EFBFBD>誩<EFBFBD> 100 銵䎚<EFBFBD>?
|
||||
* **<EFBFBD>行⏛閫<EFBFBD><EFBFBD>嚗?* <20>亦征<E4BAA6>潛<EFBFBD> \> 80% <20>硋像<E7A18B><E5838F><EFBFBD>蝚行㺭 \< 10嚗峕<E59A97>蝷算<E89DB7>𡏭砲<F0A18FAD>𦯀<EFBFBD><F0A6AF80><EFBFBD><EFBFBD><EFBFBD>𣂼<EFBFBD><F0A382BC>嘅<EFBFBD><E59885>脫迫霂舀<E99C82>雿𨀣答韐?Token<EFBFBD>?
|
||||
* **<EFBFBD>鞉𧋦憸<EFBFBD>摯嚗?* <20>寞旿摮㛖泵<E39B96>啣<EFBFBD><E595A3>園<EFBFBD>隡?Token 瘨<><E798A8>烾<EFBFBD><E783BE>?
|
||||
### **2\. 甇仿炊鈭䕘<E988AD><E49598>箄<EFBFBD>璅∠<E79285><E288A0>滨蔭 (Smart Schema) <20>婙<EFBFBD>?V2 <20>詨<EFBFBD><E8A9A8><EFBFBD>漣**
|
||||
|
||||
### **2\. 步骤二：智能模版配置 (Smart Schema) —— V2 核心升级**
|
||||
|
||||
* **P0:** **场景化模版选择：**
|
||||
* **一级分类（疾病）：** 肺癌、高血压、糖尿病等。
|
||||
* **二级分类（报告）：** 病理报告、入院记录、门诊病历、手术记录。
|
||||
* **P0:** **<EFBFBD>箸艶<EFBFBD>𡝗芋<EFBFBD><EFBFBD><EFBFBD>㗇𥋘嚗?*
|
||||
* **銝<>蝥批<E89DA5>蝐鳴<E89D90><E9B3B4>曄<EFBFBD>嚗㚁<E59A97>** <20>箇<EFBFBD><E7AE87><EFBFBD><EFBFBD>銵<EFBFBD><E98AB5>卝<EFBFBD><E58D9D><EFBFBD>撠輻<E692A0>蝑剹<E89D91>?
|
||||
* **鈭𣬚漣<EFBFBD><EFBFBD>掩嚗<EFBFBD>𥁒<EFBFBD>𠺪<EFBFBD>嚗?* <20><><EFBFBD><EFBFBD>亙<EFBFBD><E4BA99><EFBFBD><EFBFBD><EFBFBD>Ｚ扇敶𨰻<E695B6><F0A8B0BB>秄霂羓<E99C82><E7BE93><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>航扇敶𨰻<E695B6>?
|
||||
* **P0:** **<EFBFBD>冽<EFBFBD><EFBFBD><EFBFBD>畾萄<EFBFBD>銋㚁<EFBFBD>**
|
||||
* 选择模版后，自动加载预设字段列表（如“肺癌病理”自动加载：肿瘤大小、淋巴结转移、分化程度）。
|
||||
* 支持用户手动 **增/删/改** 字段定义。
|
||||
* **P1:** **Prompt 预览：** 实时展示系统将发送给 AI 的 Prompt 结构，增强专业用户信任感。
|
||||
|
||||
### **3\. 步骤三：双盲提取引擎 (Double-Blind Extraction) —— V2 核心升级**
|
||||
* <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>见𢆡 **憓?<3F>?<3F>?* 摮埈挾摰帋<E691B0><E5B88B>?
|
||||
* **P1:** **Prompt 憸<EFBFBD><EFBFBD>嚗?* 摰墧𧒄撅閧內蝟餌<E89D9F>撠<EFBFBD><E692A0><EFBFBD><EFBFBD><EFBFBD> AI <EFBFBD>?Prompt 蝏𤘪<EFBFBD>嚗<EFBFBD><EFBFBD>撘箔<EFBFBD>銝𡁶鍂<EFBFBD>瑚縑隞餅<EFBFBD><EFBFBD>?
|
||||
### **3\. 甇仿炊銝㚁<E98A9D><E39A81>𣬚𤩅<F0A3AC9A>𣂼<EFBFBD>撘閙<E69298> (Double-Blind Extraction) <20>婙<EFBFBD>?V2 <20>詨<EFBFBD><E8A9A8><EFBFBD>漣**
|
||||
|
||||
* **P0:** **<EFBFBD>峕芋<EFBFBD>见僎<EFBFBD>𡢅<EFBFBD>**
|
||||
* 系统同时调用 **DeepSeek-V3** (Model A) 和 **Qwen-Max** (Model B) 对同一段文本进行提取。
|
||||
* **P0:** **交叉验证算法 (Cross-Validation)：**
|
||||
* **完全一致：** 若 A 与 B 结果相同，标记为 Clean (可信)。
|
||||
* **冲突：** 若 A 与 B 结果不同，标记为 Conflict (待裁决)。
|
||||
* **P0:** **隐私脱敏：** 强制执行 PII 脱敏（正则替换姓名、身份证号）。
|
||||
* 蝟餌<EFBFBD><EFBFBD>峕𧒄靚<EFBFBD>鍂 **DeepSeek-V3** (Model A) <EFBFBD>?**Qwen-Max** (Model B) 撖孵<EFBFBD>銝<EFBFBD>畾菜<EFBFBD><EFBFBD>祈<EFBFBD>銵峕<EFBFBD><EFBFBD>硔<EFBFBD>?
|
||||
* **P0:** **鈭文<EFBFBD>撉諹<EFBFBD>蝞埈<EFBFBD> (Cross-Validation)嚗?*
|
||||
* **摰<EFBFBD><EFBFBD>銝<EFBFBD><EFBFBD>湛<EFBFBD>** <20>?A 銝?B 蝏𤘪<E89D8F><F0A498AA>詨<EFBFBD>嚗峕<E59A97>霈唬蛹 Clean (<EFBFBD>臭縑)<29>?
|
||||
* **<EFBFBD>脩<EFBFBD>嚗?* <20>?A 銝?B 蝏𤘪<E89D8F>銝滚<E98A9D>嚗峕<E59A97>霈唬蛹 Conflict (敺<EFBFBD><EFBFBD><EFBFBD>?<3F>?
|
||||
* **P0:** **<EFBFBD>鞟<EFBFBD><EFBFBD>望<EFBFBD>嚗?* 撘箏<E69298><E7AE8F>扯<EFBFBD> PII <20>望<EFBFBD>嚗<EFBFBD>迤<EFBFBD>蹱𤜯<E8B9B1>Ｗ<EFBFBD><EFBCB7>溻<EFBFBD><E6BABB>澈隞質<E99A9E><E8B3AA>瘀<EFBFBD><E79880>?
|
||||
### **4\. 甇仿炊<E4BBBF>𨥈<EFBFBD><F0A8A588>冽艶撉諹<E69289>蝵烐聢 (Verification Grid) <20>婙<EFBFBD>?鈭支<E988AD><E694AF>齿<EFBFBD>**
|
||||
|
||||
### **4\. 步骤四：全景验证网格 (Verification Grid) —— 交互重构**
|
||||
|
||||
*不再使用单条划动的 Tinder 模式，改为更高效的 Excel 列表模式。*
|
||||
|
||||
* **P0:** **验证列表 (The Grid)：**
|
||||
* **列结构：** 序号 | 原文摘要 | \[字段1\] | \[字段2\] ... | 状态。
|
||||
* **原文列：** 显示前 50 字，鼠标悬停显示 Tooltip。
|
||||
* **P0:** **冲突可视化与裁决：**
|
||||
* **一致单元格：** 显示绿色/白色背景，展示单一值。
|
||||
* **冲突单元格：** 背景标黄/红。内部并列显示$$DS: 值A$$
|
||||
与$$QW: 值B$$
|
||||
。
|
||||
* **一键采纳：** 用户点击 A 或 B，该值即被采纳，单元格转为已解决状态。支持双击手动输入修正。
|
||||
* **P0:** **侧边栏原文 (Context Drawer)：**
|
||||
* 点击表格任一行，右侧滑出侧边栏。
|
||||
* 展示病历**全文**，方便用户溯源核对。
|
||||
* **P1:** **批量操作：** 支持“剩余冲突全部采纳 Model A”或“导出当前进度”。
|
||||
*銝滚<E98A9D>雿輻鍂<E8BCBB>閙辺<E99699>鍦𢆡<E98DA6>?Tinder 璅∪<E79285>嚗峕㺿銝箸凒擃䀹<E69383><E480B9>?Excel <20>𡑒”璅∪<E79285><E288AA>?
|
||||
|
||||
* **P0:** **撉諹<E69289><E8ABB9>𡑒” (The Grid)嚗?*
|
||||
* **<2A>㛖<EFBFBD><E39B96><EFBFBD><EFBFBD>** 摨誩噡 | <20><><EFBFBD><EFBFBD>䁅<EFBFBD> | \[摮埈挾1\] | \[摮埈挾2\] ... | <20>嗆<EFBFBD><E59786><EFBFBD>?
|
||||
* **<2A><><EFBFBD><EFBFBD>梹<EFBFBD>** <20>曄內<E69B84>?50 摮梹<E691AE>曌䭾<E69B8C><E4ADBE>砍<EFBFBD><E7A08D>曄內 Tooltip<69>?
|
||||
* **P0:** **<EFBFBD>脩<EFBFBD><EFBFBD>航<EFBFBD><EFBFBD>碶<EFBFBD>鋆<EFBFBD><EFBFBD>嚗?*
|
||||
* **銝<><E98A9D>游<EFBFBD><E6B8B8><EFBFBD>聢嚗?* <20>曄內蝏輯𠧧/<2F>質𠧧<E8B3AA>峕艶嚗<E889B6><E59A97>蝷箏<E89DB7>銝<EFBFBD><E98A9D>潦<EFBFBD>?
|
||||
* **<2A>脩<EFBFBD><E884A9>訫<EFBFBD><E8A8AB>潘<EFBFBD>** <20>峕艶<E5B395><E889B6><EFBFBD>/蝥Ｕ<E89DA5><EFBCB5><EFBFBD><EFBFBD>典僎<E585B8>埈遬蝷?$DS: <20>劈$$
|
||||
銝?$QW: <20>劉$$
|
||||
<20>?
|
||||
* **銝<><E98A9D>桅<EFBFBD>蝥喉<E89DA5>** <20>冽<EFBFBD><E586BD>孵稬 A <20>?B嚗諹砲<E8ABB9>澆朖鋡恍<E98BA1>蝥喉<E89DA5><E59689>訫<EFBFBD><E8A8AB>潸蓮銝箏歇閫<E6AD87><E996AB><EFBFBD>嗆<EFBFBD><E59786><EFBFBD><EFBFBD>𣈲<EFBFBD><F0A388B2><EFBFBD><EFBFBD>餅<EFBFBD><E9A485>刻<EFBFBD><E588BB>乩耨甇<E880A8><E79487>?
|
||||
* **P0:** **靘扯器<E689AF>誩<EFBFBD><E8AAA9>?(Context Drawer)嚗?*
|
||||
* <20>孵稬銵冽聢隞颱<E99A9E>銵䕘<E98AB5><E49598>喃儒皛穃枂靘扯器<E689AF>譌<EFBFBD>?
|
||||
* 撅閧內<E996A7><E585A7><EFBFBD>**<2A>冽<EFBFBD>**嚗峕䲮靘輻鍂<E8BCBB>瑟滲皞鞉瓲撖嫘<E69296>?
|
||||
* **P1:** **<EFBFBD>寥<EFBFBD><EFBFBD>滢<EFBFBD>嚗?* <20>舀<EFBFBD><E88880>𨅯<EFBFBD>雿坔<E99BBF>蝒<EFBFBD><E89D92><EFBFBD>券<EFBFBD>蝥?Model A<>脲<EFBFBD><E884B2>𨅯紡<F0A885AF>箏<EFBFBD><E7AE8F>滩<EFBFBD>摨色<E691A8>腈<EFBFBD>?
|
||||
### **5\. 蝏𤘪<E89D8F>颲枏枂**
|
||||
|
||||
* **P0:** **导出 Excel：** 包含最终采纳的结构化数据。
|
||||
* **P0:** **流转到编辑器：** 一键发送到 **工具 C** 进行后续清洗（如缺失值填补）。
|
||||
* **P0:** **撖澆枂 Excel嚗?* <20><>鉄<EFBFBD><E98984>蝏<EFBFBD><E89D8F>蝥喟<E89DA5>蝏𤘪<E89D8F><F0A498AA>𡝗㺭<F0A19D97>柴<EFBFBD>?
|
||||
* **P0:** **瘚<EFBFBD>蓮<EFBFBD>啁<EFBFBD>颲穃膥嚗?* 銝<><E98A9D>桀<EFBFBD><E6A180><EFBFBD><EFBFBD> **撌亙<E6928C> C** 餈𥡝<E9A488><F0A5A19D>𡒊賒皜<E8B392><E79A9C>嚗<EFBFBD><E59A97>蝻箏仃<E7AE8F>澆‵銵伐<E98AB5><E4BC90>?
|
||||
## **銝剹<E98A9D>?<3F>屸𢒰<E5B1B8>笔<EFBFBD>璁<EFBFBD>艙 (UI Sketch)**
|
||||
|
||||
## **三、 界面原型概念 (UI Sketch)**
|
||||
* **雿𤘪<E99BBF>憿蛛<E686BF>** <20>劐葉<E58A90>堒<EFBFBD><E5A092>曄內蝥Ｙ遛<EFBCB9>臬㨃<E887AC><E3A883><EFBFBD><EFBFBD>𨅯<EFBFBD>摨瑕漲隡条<E99AA1>嚗屸<E59A97>霈⊥<E99C88><E28AA5>?45k Token<65>腈<EFBFBD>?
|
||||
* **<2A>滨蔭憿蛛<E686BF>** 銝𧢲<E98A9D><F0A7A2B2>㗇𥋘<E39787>𡏭<EFBFBD><F0A18FAD>𢞖<EFBFBD>?<3F>𦦵<EFBFBD><F0A6A6B5><EFBFBD>𥁒<EFBFBD>𪙛<EFBFBD>嘅<EFBFBD>銝𧢲䲮<F0A7A2B2>芸𢆡<E88AB8>堒枂 5 銝芸<E98A9D><E88AB8>格<EFBFBD><E6A0BC><EFBFBD><EFBFBD>?
|
||||
* **憭<><E686AD>憿蛛<E686BF>** 餈𥕦漲<F0A595A6>舀遬蝷算<E89DB7>𨅯<EFBFBD>璅∪<E79285><E288AA>𣂼<EFBFBD>銝?..<2E>嘅<EFBFBD>銝𧢲䲮<F0A7A2B2>亙<EFBFBD>皛𡁜𢆡<F0A1819C>𡤜eepSeek 摰峕<E691B0>... Qwen 摰峕<E691B0>... 甇<>銁鈭文<E988AD>瘥𥪜笆<F0A5AA9C>腈<EFBFBD>?
|
||||
* **撉諹<E69289>憿?(<28>詨<EFBFBD>)嚗?*
|
||||
* 憿園<E686BF>嚗𡁶<E59A97>霈⊥辺<E28AA5>𨅯<EFBFBD> 100 <20>∴<EFBFBD><E288B4>𤑳緵 12 <20>∪<EFBFBD>蝒<EFBFBD><E89D92>腈<EFBFBD>?
|
||||
* 銝颱<E98A9D>嚗𡁶掩 Excel 銵冽聢<E586BD><E881A2><EFBFBD>蝒<EFBFBD><E89D92><EFBFBD><EFBFBD>聢<EFBFBD><E881A2><EFBFBD>銝支葵<E694AF>厰僼靘偦<E99D98>㗇𥋘<E39787>?
|
||||
* 靘扯器<E689AF>𧶏<EFBFBD>撅閧內敶枏<E695B6>銵𣬚<E98AB5>摰峕㟲<E5B395><E39FB2><EFBFBD><EFBFBD><EFBFBD>𧋦<EFBFBD>?
|
||||
## **<2A>䜘<EFBFBD>?<3F><><EFBFBD>臬虾銵峕<E98AB5>找<EFBFBD>蝥行<E89DA5>**
|
||||
|
||||
* **体检页：** 选中列后显示红绿灯卡片：“健康度优秀，预计消耗 45k Token”。
|
||||
* **配置页：** 下拉选择“肺癌”+“病理报告”，下方自动列出 5 个关键指标。
|
||||
* **处理页：** 进度环显示“双模型提取中...”，下方日志滚动“DeepSeek 完成... Qwen 完成... 正在交叉比对”。
|
||||
* **验证页 (核心)：**
|
||||
* 顶部：统计条“共 100 条，发现 12 条冲突”。
|
||||
* 主体：类 Excel 表格。冲突单元格内有两个按钮供选择。
|
||||
* 侧边栏：展示当前行的完整病历文本。
|
||||
|
||||
## **四、 技术可行性与约束**
|
||||
|
||||
* **模型选型：**
|
||||
* **主模型 (Model A)：** DeepSeek-V3 (性价比高，擅长中文医疗)。
|
||||
* **辅助模型 (Model B)：** Qwen-Max 或 GPT-4o-mini (用于校验)。
|
||||
* **冲突判定逻辑：**
|
||||
* 字符串完全匹配或基于语义相似度（Embedding Cosine Similarity \> 0.95）判定为一致。
|
||||
* 数值提取需进行单位归一化后再比对（如 3cm vs 3.0 cm 视为一致）。
|
||||
* **性能要求：** 双倍 API 调用会导致成本和时间增加，需在界面上明确告知用户并显示进度。
|
||||
* **璅∪<EFBFBD><EFBFBD>匧<EFBFBD>嚗?*
|
||||
* **銝餅芋<EFBFBD>?(Model A)嚗?* DeepSeek-V3 (<28>找遠瘥娪<E798A5>嚗峕<E59A97><E5B395>蹂葉<E8B982><E89189>龫<EFBFBD>?<3F>?
|
||||
* **颲<EFBFBD>𨭌璅∪<EFBFBD> (Model B)嚗?* Qwen-Max <20>?GPT-4o-mini (<28>其<EFBFBD><E585B6>⊿<EFBFBD>)<29>?
|
||||
* **<EFBFBD>脩<EFBFBD><EFBFBD>文<EFBFBD><EFBFBD>餉<EFBFBD>嚗?*
|
||||
* 摮㛖泵銝脣<EFBFBD><EFBFBD>典龪<EFBFBD>齿<EFBFBD><EFBFBD>箔<EFBFBD>霂凋<EFBFBD><EFBFBD>訾撮摨佗<EFBFBD>Embedding Cosine Similarity \> 0.95嚗匧ế摰帋蛹銝<EFBFBD><EFBFBD>氬<EFBFBD>?
|
||||
* <EFBFBD>啣<EFBFBD>潭<EFBFBD><EFBFBD>㚚<EFBFBD>餈𥡝<EFBFBD><EFBFBD>蓥<EFBFBD>敶雴<EFBFBD><EFBFBD>硋<EFBFBD><EFBFBD>齿<EFBFBD>撖對<EFBFBD>憒?3cm vs 3.0 cm 閫<>蛹銝<E89BB9><E98A9D>湛<EFBFBD><E6B99B>?
|
||||
* **<EFBFBD>扯<EFBFBD>閬<EFBFBD><EFBFBD>嚗?* <20><><EFBFBD>?API 靚<>鍂隡𡁜紡<F0A1819C>湔<EFBFBD><E6B994>砍<EFBFBD><E7A08D>園𡢿憓𧼮<E68693>嚗屸<E59A97><E5B1B8>函<EFBFBD><E587BD>Ｖ<EFBFBD><EFBCB6>𡒊＆<F0A1928A>羓䰻<E7BE93>冽<EFBFBD>撟嗆遬蝷箄<E89DB7>摨艾<E691A8>
|
||||
@@ -1,107 +1,99 @@
|
||||
# **PRD：Tool C \- 科研数据编辑器 (MVP V1.1)**
|
||||
# **PRD嚗関ool C \- 蝘𤑳<EFBFBD><EFBFBD>唳旿蝻𤥁<EFBFBD><EFBFBD>?(MVP V1.1)**
|
||||
|
||||
| 文档版本 | V1.1 (工程细化版) |
|
||||
| <EFBFBD><EFBFBD>﹝<EFBFBD><EFBFBD>𧋦 | V1.1 (撌亦<EFBFBD>蝏<EFBFBD><EFBFBD><EFBFBD>? |
|
||||
| :---- | :---- |
|
||||
| **产品形态** | **Web 端数据编辑器 (AG Grid \+ AI Chat)** |
|
||||
| **核心策略** | **"AI-First" \+ "Server-side State"**。依靠 AI 生成 Python 代码完成清洗；以服务端 DataFrame 为单一数据源，前端负责渲染和轻量编辑。 |
|
||||
| **技术底座** | React \+ AG Grid \+ Node.js BFF \+ Python Sandbox (FastAPI) \+ DeepSeek-V3 |
|
||||
| **变更记录** | V1.1: 增加数据同步机制、撤销回滚策略、会话生命周期定义。 |
|
||||
| **鈭批<EFBFBD>敶Ｘ<EFBFBD>?* | **Web 蝡舀㺭<EFBFBD>桃<EFBFBD>颲穃膥 (AG Grid \+ AI Chat)** |
|
||||
| **<EFBFBD>詨<EFBFBD>蝑𣇉裦** | **"AI-First" \+ "Server-side State"**<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?AI <20><><EFBFBD> Python 隞<><E99A9E>摰峕<E691B0>皜<EFBFBD><E79A9C>嚗𥕢誑<F0A595A2>滚𦛚蝡?DataFrame 銝箏<E98A9D>銝<EFBFBD><E98A9D>唳旿皞琜<E79A9E><E7909C>滨垢韐蠘提皜脫<E79A9C><E884AB>諹蝠<E8ABB9>讐<EFBFBD>颲㻫<E9A2B2>?|
|
||||
| **<EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>摨?* | React \+ AG Grid \+ Node.js BFF \+ Python Sandbox (FastAPI) \+ DeepSeek-V3 |
|
||||
| **<EFBFBD>䀹凒霈啣<EFBFBD>** | V1.1: 憓𧼮<EFBFBD><EFBFBD>唳旿<EFBFBD>峕郊<EFBFBD>箏<EFBFBD><EFBFBD><EFBFBD>伃<EFBFBD><EFBFBD><EFBFBD>墧<EFBFBD>蝑𣇉裦<EFBFBD><EFBFBD><EFBFBD>霂萘<EFBFBD><EFBFBD>賢𪂹<EFBFBD>笔<EFBFBD>銋剹<EFBFBD>?|
|
||||
|
||||
## **一、 MVP 核心目标 (Objectives)**
|
||||
## **銝<EFBFBD><EFBFBD>?MVP <20>詨<EFBFBD><E8A9A8>格<EFBFBD> (Objectives)**
|
||||
|
||||
1. **验证闭环：** 跑通 “自然语言 \-\> Python 代码 \-\> 后端执行 \-\> 前端刷新” 的完整链路。
|
||||
2. **数据一致性：** 确保手动编辑与 AI 操作不冲突，状态可追溯。
|
||||
3. **可用性：** 解决中文乱码、会话超时等实际工程问题。
|
||||
1. **撉諹<EFBFBD><EFBFBD>剔㴓嚗?* 頝煾<E9A09D>?<3F>𡏭䌊<F0A18FAD>嗉祗閮<E7A597> \-\> Python 隞<EFBFBD><EFBFBD> \-\> <EFBFBD>𡒊垢<EFBFBD>扯<EFBFBD> \-\> <20>滨垢<E6BBA8>瑟鰵<E7919F>?<3F><><EFBFBD><EFBFBD>湧曎頝胯<E9A09D>?
|
||||
2. **<EFBFBD>唳旿銝<EFBFBD><EFBFBD>湔<EFBFBD>改<EFBFBD>** 蝖桐<E89D96><E6A190>见𢆡蝻𤥁<E89DBB>銝?AI <20>滢<EFBFBD>銝滚<E98A9D>蝒<EFBFBD><E89D92><EFBFBD>嗆<EFBFBD><E59786>虾餈賣滲<E8B3A3>?
|
||||
3. **<EFBFBD>舐鍂<EFBFBD>改<EFBFBD>** 閫<><E996AB>銝剜<E98A9D>銋梁<E98A8B><E6A281><EFBFBD><EFBFBD>霂肽<E99C82><E882BD>嗥<EFBFBD>摰鮋<E691B0>撌亦<E6928C><E4BAA6>桅<EFBFBD><E6A185>?
|
||||
## **鈭䎚<E988AD>?霂衣<E99C82><E8A1A3>蠘<EFBFBD><E8A098><EFBFBD>瘙?(Functional Requirements)**
|
||||
|
||||
## **二、 详细功能需求 (Functional Requirements)**
|
||||
|
||||
### **1\. 界面框架与会话 (Shell & Session)**
|
||||
|
||||
* **P0: 左右分栏布局：** 左侧 AG Grid (70%)，右侧 AI Chat (30%)。
|
||||
* **P0: 会话初始化 (Session Init):**
|
||||
* 用户上传文件 \-\> 后端开启 Python 进程/容器 \-\> 加载 df \-\> 返回 sessionId。
|
||||
* **编码检测：** 后端必须尝试 utf-8 和 gbk 解码，防止中文乱码。
|
||||
* **P1: 心跳与保活 (Keep-alive):**
|
||||
* 前端每 30s 发送心跳。
|
||||
* **超时策略：** 若超过 30min 无操作，后端释放内存。用户再次操作时，提示“会话已过期，请重新加载文件”。
|
||||
### **1\. <20>屸𢒰獢<F0A292B0>沲銝𦒘<E98A9D>霂?(Shell & Session)**
|
||||
|
||||
* **P0: 撌血𢰧<E8A180><F0A2B0A7><EFBFBD>撣<EFBFBD><E692A3>嚗?* 撌虫儒 AG Grid (70%)嚗<>𢰧靘?AI Chat (30%)<29>?
|
||||
* **P0: 隡朞<E99AA1><E69C9E>嘥<EFBFBD><E598A5>?(Session Init):**
|
||||
* <20>冽<EFBFBD>銝𠹺<E98A9D><F0A0B9BA><EFBFBD>辣 \-\> <20>𡒊垢撘<E59EA2><E69298>?Python 餈𤤿<E9A488>/摰孵膥 \-\> <20>㰘蝸 df \-\> 餈𥪜<E9A488> sessionId<49>?
|
||||
* **蝻𣇉<E89DBB>璉<EFBFBD>瘚页<E7989A>** <20>𡒊垢敹<E59EA2>◆撠肽<E692A0> utf-8 <20>?gbk 閫<><E996AB>嚗屸俈甇Ｖ葉<EFBCB6><E89189>僚<EFBFBD><E5839A><EFBFBD>?
|
||||
* **P1: 敹<>歲銝𦒘<E98A9D>瘣?(Keep-alive):**
|
||||
* <20>滨垢瘥?30s <20>煾<EFBFBD><E785BE><EFBFBD>頝喋<E9A09D>?
|
||||
* **頞<>𧒄蝑𣇉裦嚗?* <20>亥<EFBFBD>餈?30min <20>䭾<EFBFBD>雿頣<E99BBF><E9A0A3>𡒊垢<F0A1928A>𦠜𦆮<F0A6A09C><F0A686AE><EFBFBD><EFBFBD><EFBFBD>鍂<EFBFBD>瑕<EFBFBD>甈⊥<E79488>雿𨀣𧒄嚗峕<E59A97>蝷算<E89DB7>靝<EFBFBD>霂嘥歇餈<E6AD87><E9A488>嚗諹窈<E8ABB9>齿鰵<E9BDBF>㰘蝸<E3B098><E89DB8>辣<EFBFBD>腈<EFBFBD>?
|
||||
### **2\. 頞<>漣蝵烐聢 (The Grid) \- *<2A>滨垢鈭支<E988AD>***
|
||||
|
||||
* **P0: <20>唳旿撅閧內 (View):**
|
||||
* 通过 API 分页拉取数据（预览模式，仅取前 100-500 行）。
|
||||
* **列类型推断：** 前端根据后端返回的 dtypes 渲染列头图标（数值/文本/日期）。
|
||||
* <EFBFBD>朞<EFBFBD> API <EFBFBD><EFBFBD>△<EFBFBD>匧<EFBFBD><EFBFBD>唳旿嚗<EFBFBD><EFBFBD>閫<EFBFBD>芋撘𧶏<EFBFBD>隞<EFBFBD><EFBFBD><EFBFBD>?100-500 銵䕘<EFBFBD><EFBFBD>?
|
||||
* **<EFBFBD>㛖掩<EFBFBD>𧢲綫<EFBFBD>哨<EFBFBD>** <20>滨垢<E6BBA8>寞旿<E5AF9E>𡒊垢餈𥪜<E9A488><F0A5AA9C>?dtypes 皜脫<E79A9C><E884AB>堒仍<E5A092>暹<EFBFBD>嚗<EFBFBD>㺭<EFBFBD>?<3F><>𧋦/<2F>交<EFBFBD>嚗剹<E59A97>?
|
||||
* **P0: <20>见𢆡蝻𤥁<E89DBB> (Manual Edit):**
|
||||
* 支持双击修改单元格。
|
||||
* **关键逻辑（脏数据标记）：** 用户修改后，单元格右标红，数据暂存在前端 dirtyRows 队列中。
|
||||
* <EFBFBD>舀<EFBFBD><EFBFBD><EFBFBD>稬靽格㺿<EFBFBD>訫<EFBFBD><EFBFBD>潦<EFBFBD>?
|
||||
* **<EFBFBD>喲睸<EFBFBD>餉<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>唳旿<EFBFBD><EFBFBD>扇嚗㚁<EFBFBD>** <20>冽<EFBFBD>靽格㺿<E6A0BC>𠬍<EFBFBD><F0A0AC8D>訫<EFBFBD><E8A8AB>澆𢰧<E6BE86><F0A2B0A7>滯嚗峕㺭<E5B395>格<EFBFBD>摮睃銁<E79D83>滨垢 dirtyRows <EFBFBD>笔<EFBFBD>銝准<EFBFBD>?
|
||||
* **P0: <20>嗆<EFBFBD><E59786><EFBFBD> (UI Locking):**
|
||||
* 当 AI 正在执行时，Grid 变为 **只读 (Read-only)**，显示 Loading 遮罩。
|
||||
|
||||
* 敶?AI 甇<EFBFBD>銁<EFBFBD>扯<EFBFBD><EFBFBD>塚<EFBFBD>Grid <20>䀝蛹 **<EFBFBD>芾粉 (Read-only)**嚗峕遬蝷?Loading <EFBFBD>桃蔗<EFBFBD>?
|
||||
### **3\. AI Copilot <20>箄<EFBFBD><E7AE84>拇<EFBFBD> (The Brain) \- *<2A>𡒊垢撽勗𢆡***
|
||||
|
||||
#### **3.1 鈭支<E988AD>瘚<EFBFBD><E7989A> (Chat Loop)**
|
||||
|
||||
1. **用户输入：** “把年龄大于60的设为老年组”。
|
||||
1. **<EFBFBD>冽<EFBFBD>颲枏<EFBFBD>嚗?* <20>𨀣<EFBFBD>撟湧<E6929F>憭找<E686AD>60<36><30>挽銝箄<E98A9D><E7AE84>僑蝏<E58391><E89D8F>腈<EFBFBD>?
|
||||
2. **<EFBFBD>滨蔭<EFBFBD>峕郊 (Auto-Sync):** **(V1.1 <20>啣<EFBFBD>)**
|
||||
* **判定：** 前端检查是否有未保存的手动修改 (dirtyRows).
|
||||
* **动作：** 如果有，先静默发送 PATCH /api/data 将手动修改同步给后端 df。确保 AI 基于最新数据操作。
|
||||
3. **代码生成：** 后端调用 DeepSeek，生成 Pandas 代码。
|
||||
4. **预操作确认 (Action Card):**
|
||||
* 展示：代码预览 \+ 摘要。
|
||||
* 按钮：\[运行\] | \[取消\]。
|
||||
|
||||
#### **3.2 执行与回滚 (Execute & Rollback) \- (V1.1 核心)**
|
||||
* **<EFBFBD>文<EFBFBD>嚗?* <20>滨垢璉<E59EA2><E79289>交糓<E4BAA4>行<EFBFBD><E8A18C>芯<EFBFBD>摮条<E691AE><E69DA1>见𢆡靽格㺿 (dirtyRows).
|
||||
* **<EFBFBD>其<EFBFBD>嚗?* 憒<><E68692><EFBFBD>㚁<EFBFBD><E39A81><EFBFBD><EFBFBD>暺睃<E69ABA><E79D83>?PATCH /api/data 撠<><E692A0><EFBFBD>其耨<E585B6>孵<EFBFBD>甇亦<E79487><E4BAA6>𡒊垢 df<64><66>＆靽?AI <20>箔<EFBFBD><E7AE94><EFBFBD><EFBFBD>唳㺭<E594B3>格<EFBFBD>雿栶<E99BBF>?
|
||||
3. **隞<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?* <20>𡒊垢靚<E59EA2>鍂 DeepSeek嚗𣬚<EFBFBD><EFBFBD>?Pandas 隞<EFBFBD><EFBFBD><EFBFBD>?
|
||||
4. **憸<EFBFBD><EFBFBD>雿𦦵＆霈?(Action Card):**
|
||||
* 撅閧內嚗帋誨<EFBFBD><EFBFBD><EFBFBD>閫?\+ <20>䁅<EFBFBD><E48185>?
|
||||
* <EFBFBD>厰僼嚗䨵[餈鞱<E9A488>\] | \[<5B>𡝗<EFBFBD>\]<5D>?
|
||||
#### **3.2 <20>扯<EFBFBD>銝𤾸<E98A9D>皛?(Execute & Rollback) \- (V1.1 <20>詨<EFBFBD>)**
|
||||
|
||||
* **P0: <20>芸𢆡敹怎<E695B9> (Auto-Checkpoint):**
|
||||
* 在执行 exec(code) 之前，后端必须先对当前 df 进行内存快照（或序列化备份）。
|
||||
* 记录操作日志：ActionID: 101, Type: AI\_CODE, Code: "..."。
|
||||
* <EFBFBD>冽<EFBFBD>銵?exec(code) 銋见<EFBFBD>嚗<EFBFBD><EFBFBD>蝡臬<EFBFBD>憿餃<EFBFBD>撖孵<EFBFBD><EFBFBD>?df 餈𥡝<E9A488><F0A5A19D><EFBFBD><EFBFBD>敹怎<E695B9>嚗<EFBFBD><E59A97>摨誩<E691A8><E8AAA9>硋<EFBFBD>隞踝<E99A9E><E8B89D>?
|
||||
* 霈啣<EFBFBD><EFBFBD>滢<EFBFBD><EFBFBD>亙<EFBFBD>嚗鋫ctionID: 101, Type: AI\_CODE, Code: "..."<EFBFBD>?
|
||||
* **P0: <20>扯<EFBFBD><E689AF>漤<EFBFBD>:**
|
||||
* 成功：返回新的预览数据 \-\> 刷新 Grid \-\> 添加一条“操作成功”消息。
|
||||
* 失败：捕获 Python Traceback \-\> 让 AI 尝试自我修复 (Self-Correction) 一次 \-\> 若仍失败，向用户展示错误原因。
|
||||
* <EFBFBD>𣂼<EFBFBD>嚗朞<EFBFBD><EFBFBD>墧鰵<EFBFBD><EFBFBD><EFBFBD>閫<EFBFBD>㺭<EFBFBD>?\-\> <EFBFBD>瑟鰵 Grid \-\> 瘛餃<EFBFBD>銝<EFBFBD><EFBFBD>﹦<EFBFBD>𨀣<EFBFBD>雿𨀣<EFBFBD><EFBFBD>麨<EFBFBD>脲<EFBFBD><EFBFBD>胯<EFBFBD>?
|
||||
* 憭梯揖嚗𡁏<EFBFBD><EFBFBD>?Python Traceback \-\> 霈?AI 撠肽<EFBFBD><EFBFBD>芣<EFBFBD>靽桀<EFBFBD> (Self-Correction) 銝<EFBFBD>甈?\-\> <EFBFBD>乩<EFBFBD>憭梯揖嚗<EFBFBD><EFBFBD><EFBFBD>冽<EFBFBD>撅閧內<EFBFBD>躰秤<EFBFBD>笔<EFBFBD><EFBFBD>?
|
||||
* **P0: <20>日<EFBFBD><E697A5>滢<EFBFBD> (Undo):**
|
||||
* 聊天框每条成功记录下显示 \[撤销\] 按钮。
|
||||
* 逻辑：调用后端 rollback(action\_id) \-\> 恢复到该操作前的快照 \-\> 刷新 Grid。
|
||||
|
||||
* <EFBFBD>𠰴予獢<EFBFBD><EFBFBD><EFBFBD>⊥<EFBFBD><EFBFBD>蠘扇敶蓥<EFBFBD><EFBFBD>曄內 \[<5B>日<EFBFBD>\] <20>厰僼<E58EB0>?
|
||||
* <EFBFBD>餉<EFBFBD>嚗朞<EFBFBD><EFBFBD>典<EFBFBD>蝡?rollback(action\_id) \-\> <EFBFBD>Ｗ<EFBFBD><EFBFBD>啗砲<EFBFBD>滢<EFBFBD><EFBFBD>滨<EFBFBD>敹怎<EFBFBD> \-\> <EFBFBD>瑟鰵 Grid<EFBFBD>?
|
||||
### **4\. 敹急㭘<E680A5><E3AD98>誘 (Prompt Chips)**
|
||||
|
||||
* **P0:** 顶部工具栏按钮（生成变量、长宽转换等），点击仅作为“快捷短语”填入输入框，不触发独立 UI 逻辑，保持架构统一。
|
||||
|
||||
* **P0:** 憿園<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> UI <20>餉<EFBFBD>嚗䔶<E59A97><E494B6><EFBFBD>沲<EFBFBD><E6B2B2><EFBFBD>銝<EFBFBD><E98A9D>?
|
||||
### **5\. 撖澆枂 (Export)**
|
||||
|
||||
* **P0:** 导出 Excel。
|
||||
* 逻辑：后端直接将当前的 df (包含所有 AI 修改和手动修改) 写入 Excel 流并返回。
|
||||
|
||||
## **三、 异常处理规范 (Error Handling)**
|
||||
* **P0:** 撖澆枂 Excel<EFBFBD>?
|
||||
* <EFBFBD>餉<EFBFBD>嚗𡁜<EFBFBD>蝡舐凒<EFBFBD>亙<EFBFBD>敶枏<EFBFBD><EFBFBD>?df (<28><>鉄<EFBFBD><E98984><EFBFBD>?AI 靽格㺿<E6A0BC>峕<EFBFBD><E5B395>其耨<E585B6>? <20>坔<EFBFBD> Excel 瘚<>僎餈𥪜<E9A488><F0A5AA9C>?
|
||||
## **銝剹<E98A9D>?撘<>虜憭<E8999C><E686AD>閫<EFBFBD><E996AB> (Error Handling)**
|
||||
|
||||
| 撘<>虜<EFBFBD>箸艶 | <20>滨垢銵函緵 | <20>𡒊垢憭<E59EA2><E686AD> |
|
||||
| :---- | :---- | :---- |
|
||||
| **中文乱码** | 提示“编码格式识别失败，请手动选择” | 尝试 chardet 检测，失败则报错 |
|
||||
| **AI 代码报错** | Chat 气泡变红，显示“AI 正在尝试修复...” | 捕获 stderr，将错误反喂给 AI 重试 (Max 1次) |
|
||||
| **会话过期** | 全屏遮罩“会话已过期” | 清理 Redis/内存，返回 401/404 |
|
||||
| **手动修改冲突** | 提示“正在同步数据...” | 优先处理手动 Patch，再执行 AI 任务 |
|
||||
| **銝剜<EFBFBD>銋梁<EFBFBD>** | <EFBFBD>鞟內<EFBFBD>𦦵<EFBFBD><EFBFBD><EFBFBD>聢撘讛<EFBFBD><EFBFBD>怠仃韐伐<EFBFBD>霂瑟<EFBFBD><EFBFBD>券<EFBFBD>㗇𥋘<EFBFBD>?| 撠肽<E692A0> chardet 璉<>瘚页<E7989A>憭梯揖<E6A2AF>蹱𥁒<E8B9B1>?|
|
||||
| **AI 隞<EFBFBD><EFBFBD><EFBFBD>仿<EFBFBD>** | Chat 瘞娍部<EFBFBD>条滯嚗峕遬蝷算<EFBFBD>𦯷I 甇<>銁撠肽<E692A0>靽桀<E99DBD>...<2E>?| <20>閗繮 stderr嚗<72><E59A97><EFBFBD>躰秤<E8BAB0>滚<EFBFBD>蝏?AI <20>滩<EFBFBD> (Max 1甈? |
|
||||
| **隡朞<EFBFBD>餈<EFBFBD><EFBFBD>** | <EFBFBD>典<EFBFBD><EFBFBD>桃蔗<EFBFBD>靝<EFBFBD>霂嘥歇餈<EFBFBD><EFBFBD><EFBFBD>?| 皜<><E79A9C> Redis/<2F><><EFBFBD>嚗諹<E59A97><E8ABB9>?401/404 |
|
||||
| **<EFBFBD>见𢆡靽格㺿<EFBFBD>脩<EFBFBD>** | <EFBFBD>鞟內<EFBFBD>𨀣迤<EFBFBD>典<EFBFBD>甇交㺭<EFBFBD>?..<2E>?| 隡睃<E99AA1>憭<EFBFBD><E686AD><EFBFBD>见𢆡 Patch嚗<68><E59A97><EFBFBD>扯<EFBFBD> AI 隞餃𦛚 |
|
||||
|
||||
## **四、 开发与测试重点 (QA Focus)**
|
||||
## **<EFBFBD>䜘<EFBFBD>?撘<><E69298>睲<EFBFBD>瘚贝<E7989A><E8B49D>滨<EFBFBD> (QA Focus)**
|
||||
|
||||
1. **銝<><E98A9D>湔<EFBFBD>扳<EFBFBD>霂𤏪<E99C82>**
|
||||
* 先手动改一个值，再让 AI 删一行，确认那个值还在不在（或者是否正确被删）。
|
||||
* 先让 AI 改一列，再撤销，确认是否完全恢复。
|
||||
2. **边界测试：**
|
||||
* 上传空文件。
|
||||
* 上传全中文列名的文件。
|
||||
* 让 AI 计算一个不存在的列。
|
||||
3. **性能测试：**
|
||||
* 连续快速发送 5 条指令，确保后端是**串行队列**处理，而不是并发搞乱数据。
|
||||
* <EFBFBD><EFBFBD><EFBFBD><EFBFBD>冽㺿銝<EFBFBD>銝芸<EFBFBD>潘<EFBFBD><EFBFBD>滩悟 AI <20>牐<EFBFBD>銵䕘<E98AB5>蝖株恕<E6A0AA><E68195>葵<EFBFBD>潸<EFBFBD><E6BDB8>其<EFBFBD><E585B6>剁<EFBFBD><E58981>𤥁<EFBFBD><F0A4A581>糓<EFBFBD>行迤蝖株◤<E6A0AA>𩤃<EFBFBD><F0A9A483>?
|
||||
* <EFBFBD><EFBFBD>悟 AI <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>?
|
||||
* 霈?AI 霈∠<EFBFBD>銝<EFBFBD>銝芯<EFBFBD>摮睃銁<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
|
||||
3. **<EFBFBD>扯<EFBFBD>瘚贝<EFBFBD>嚗?*
|
||||
* 餈䂿賒敹恍<EFBFBD>笔<EFBFBD><EFBFBD>?5 <20>⊥<EFBFBD>隞歹<E99A9E>蝖桐<E89D96><E6A190>𡒊垢<F0A1928A>?*銝脰<E98A9D><E884B0>笔<EFBFBD>**憭<><E686AD>嚗諹<E59A97>䔶<EFBFBD><E494B6>臬僎<E887AC>烐<EFBFBD>銋望㺭<E69C9B>柴<EFBFBD>?
|
||||
## **鈭𢛵<E988AD>?<3F><><EFBFBD>嚗𡁏㺭<F0A1818F>桀<EFBFBD>甇?API 摰帋<E691B0> (蝞<><E89D9E>?**
|
||||
|
||||
## **五、 附录：数据同步 API 定义 (简版)**
|
||||
|
||||
* POST /api/sync: 前端 \-\> 后端。发送手动修改的 Diff。
|
||||
* POST /api/sync: <20>滨垢 \-\> <20>𡒊垢<F0A1928A><E59EA2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>其耨<E585B6>寧<EFBFBD> Diff<66>?
|
||||
* Payload: \[{ rowId: "P001", col: "age", value: 66 }\]
|
||||
* POST /api/run: 前端 \-\> 后端。发送 AI 代码执行请求。
|
||||
* POST /api/run: <EFBFBD>滨垢 \-\> <EFBFBD>𡒊垢<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?AI 隞<><E99A9E><EFBFBD>扯<EFBFBD>霂瑟<E99C82><E7919F>?
|
||||
* Payload: { code: "df\['new'\] \= 1", snapshot: true }
|
||||
* POST /api/undo: 前端 \-\> 后端。
|
||||
* POST /api/undo: <EFBFBD>滨垢 \-\> <EFBFBD>𡒊垢<EFBFBD>?
|
||||
* Payload: { step: \-1 }
|
||||
|
||||
\#\#\# 蝏坔<E89D8F><E59D94>穃𣪧<E7A983>毺<EFBFBD>銝<EFBFBD><E98A9D>亥<EFBFBD><E4BAA5>餌<EFBFBD>
|
||||
|
||||
\*\*“V1.1 的核心在于‘状态管理’。请务必保证后端 Python 内存里的 \`DataFrame\` 是唯一的‘真理来源 (Source of Truth)’。前端的所有操作（无论是手改还是 AI 改），本质上都是在向这个真理层发送指令和同步状态。”\*\*
|
||||
\*\*<EFBFBD>𦛼1.1 <EFBFBD><EFBFBD>瓲敹<EFBFBD>銁鈭𢛶<EFBFBD>条𠶖<EFBFBD><EFBFBD>恣<EFBFBD><EFBFBD><EFBFBD>踺<EFBFBD><EFBFBD>窈<EFBFBD>∪<EFBFBD>靽肽<EFBFBD><EFBFBD>𡒊垢 Python <EFBFBD><EFBFBD><EFBFBD><EFBFBD>𣬚<EFBFBD> \`DataFrame\` <EFBFBD>臬𣈲銝<EFBFBD><EFBFBD><EFBFBD><EFBFBD>条<EFBFBD><EFBFBD><EFBFBD>䔉皞?(Source of Truth)<EFBFBD>踺<EFBFBD><EFBFBD><EFBFBD>蝡舐<EFBFBD><EFBFBD><EFBFBD><EFBFBD>㗇<EFBFBD>雿頣<EFBFBD><EFBFBD>㰘捏<EFBFBD>舀<EFBFBD><EFBFBD>寡<EFBFBD><EFBFBD>?AI <20>對<EFBFBD>嚗峕𧋦韐其<E99F90><E585B6>賣糓<E8B3A3>典<EFBFBD>餈嗘葵<E59798>毺<EFBFBD>撅<EFBFBD><E69285><EFBFBD><EFBFBD><EFBFBD>隞文<E99A9E><E69687>峕郊<E5B395>嗆<EFBFBD><E59786><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>?
|
||||
|
||||
@@ -1,105 +1,95 @@
|
||||
# **PRD：Tool C \- 科研数据编辑器 (The Research Editor)**
|
||||
# **PRD<EFBFBD>啜ool C \- 遘醍<EFBFBD>疲焚謐ｮ郛冶ｾ大<EFBFBD>?(The Research Editor)**
|
||||
|
||||
| 文档版本 | V2.1 (扁平化 \+ 长宽转换版) |
|
||||
| 譁<EFBFBD>｡｣迚域悽 | V2.1 (謇∝ｹｳ蛹?\+ 髟ｿ螳ｽ霓ｬ謐｢迚? |
|
||||
| :---- | :---- |
|
||||
| **产品形态** | Web 端在线编辑器（Local-First 架构，类 Excel 体验） |
|
||||
| **核心价值** | 提供比 Excel 更懂科研的轻量级清洗工具。通过“扁平化工具栏”和“智能侧边栏”，让医生在不写代码的情况下完成变量加工、质量治理和样本筛选。 |
|
||||
| **目标用户** | 对数据质量有洁癖的科研人员、临床医生 |
|
||||
| **莠ｧ蜩∝ｽ｢諤?* | Web 遶ｯ蝨ｨ郤ｿ郛冶ｾ大勣<E5A4A7><E58BA3>ocal-First 譫ｶ譫<EFBFBD>ｼ檎ｱｻ Excel 菴馴ｪ鯉ｼ?|
|
||||
| **譬ｸ蠢<EFBFBD>ｻｷ蛟?* | 謠蝉ｾ帶ｯ?Excel 譖ｴ諛らｧ醍<EFBDA7>皮噪霓ｻ驥冗ｺｧ貂<EFBDA7>ｴ怜ｷ･蜈ｷ縲る夊ｿ<E5A48A>懈堰蟷ｳ蛹門ｷ･蜈ｷ譬鞘晏柱窶懈匱閭ｽ萓ｧ霎ｹ譬鞘晢ｼ瑚ｮｩ蛹ｻ逕溷惠荳榊<E88DB3>莉｣遐∫噪諠<E599AA><E8ABA0>荳句ｮ梧<EFBDAE>蜿倬㍼蜉<E38DBC>蟾･縲∬ｴｨ驥乗ｲｻ逅<EFBDBB>柱譬ｷ譛ｬ遲幃峨?|
|
||||
| **逶ｮ譬<EFBFBD>畑謌ｷ** | 蟇ｹ謨ｰ謐ｮ雍ｨ驥乗怏豢∫剿逧<EFBFBD>ｧ醍<EFBFBD>比ｺｺ蜻倥∽ｸｴ蠎雁現逕?|
|
||||
|
||||
## **一、 产品流程图 (User Flow)**
|
||||
## **荳縲?莠ｧ蜩∵ｵ∫ｨ句<EFBDA8>?(User Flow)**
|
||||
|
||||
数据导入(上传/流转) \-\> 性能准入与降采样 \-\> 在线清洗(工具栏全局操作 \+ 侧边栏列操作) \-\> 版本快照 \-\> 导出分析集
|
||||
謨ｰ謐ｮ蟇ｼ蜈･(荳贋ｼ<E8B48B>/豬∬ｽｬ) \-\> 諤ｧ閭ｽ蜃<EFBDBD><E89C83>荳朱剄驥<E58984><E9A9A5>ｷ \-\> 蝨ｨ郤ｿ貂<EFBDBF>ｴ<EFBFBD>(蟾･蜈ｷ譬丞<E8ADAC>螻謫堺ｽ<E5A0BA> \+ 萓ｧ霎ｹ譬丞<E8ADAC>謫堺ｽ<E5A0BA>) \-\> 迚域悽蠢ｫ辣ｧ \-\> 蟇ｼ蜃ｺ蛻<EFBDBA>梵髮?
|
||||
## **莠後?譬ｸ蠢<EFBDB8>粥閭ｽ髴豎?(Functional Requirements)**
|
||||
|
||||
## **二、 核心功能需求 (Functional Requirements)**
|
||||
### **1\. 鬘ｶ驛ｨ謇∝ｹｳ蟾･蜈ｷ譬?(The Flat Toolbar) 窶披?譬ｸ蠢<EFBDB8>ｺ､莠<EFBDA4>**
|
||||
|
||||
### **1\. 顶部扁平工具栏 (The Flat Toolbar) —— 核心交互**
|
||||
|
||||
*不再使用复杂的 Tab 分组，核心科研功能一字排开，所见即所得。*
|
||||
*荳榊<E88DB3>菴ｿ逕ｨ螟肴揩逧?Tab 蛻<>ｻ<EFBFBD>ｼ梧<EFBDBC>ｸ蠢<EFBDB8>ｧ醍<EFBDA7>泌粥閭ｽ荳蟄玲賜蠑<E8A091>梧園隗∝叉謇蠕励?
|
||||
|
||||
#### **1.1 蜿倬㍼蜉<E38DBC>蟾･ (Variable Processing)**
|
||||
|
||||
* **P0: 生成新变量 (Generate Variable):**
|
||||
* **功能：** 弹窗提供公式构建器。
|
||||
* **支持：** 加减乘除、括号、以及 ln() (对数)、exp() 等医学常用函数。
|
||||
* **场景：** 计算 BMI \= weight / (height/100)^2。
|
||||
* **P0: 计算时间差 (Time Delta):**
|
||||
* **功能：** 选择 起始日期列 和 结束日期列，自动生成差值。
|
||||
* **单位：** 支持按 天、月、年 输出。
|
||||
* **场景：** 计算 年龄、住院天数、PFS/OS。
|
||||
* **P0: 长宽转换 (Reshape/Pivot) —— \[V2.1 新增\]:**
|
||||
* **功能：** 将“一人多行（长表）”转换为“一人一行（宽表）”。
|
||||
* **P0: 逕滓<EFBFBD>譁ｰ蜿倬<EFBFBD>?(Generate Variable):**
|
||||
* **蜉溯<EFBFBD><EFBFBD>?* 蠑ｹ遯玲署萓帛<E89093>蠑乗桷蟒ｺ蝎ｨ縲?
|
||||
* **謾ｯ謖<EFBFBD>ｼ?* 蜉<>蜃丈ｹ倬勁縲∵峡蜿ｷ縲∽ｻ･蜿?ln() (蟇ｹ謨ｰ)縲‘xp() 遲牙現蟄ｦ蟶ｸ逕ｨ蜃ｽ謨ｰ縲?
|
||||
* **蝨ｺ譎ｯ<EFBFBD>?* 隶｡邂<EFBDA1> BMI \= weight / (height/100)^2縲?
|
||||
* **P0: 隶｡邂玲慮髣ｴ蟾?(Time Delta):**
|
||||
* **蜉溯<EFBFBD><EFBFBD>?* 騾画叫 襍ｷ蟋区律譛溷<E8AD9B>?蜥?扈捺據譌･譛溷<E8AD9B><E6BAB7>瑚<EFBFBD>蜉ｨ逕滓<E98095>蟾ｮ蛟ｼ縲?
|
||||
* **蜊穂ｽ搾ｼ?* 謾ｯ謖∵<E8AC96>?螟ｩ縲∵怦縲∝ｹｴ 霎灘<E99C8E>縲?
|
||||
* **蝨ｺ譎ｯ<EFBFBD>?* 隶｡邂<EFBDA1> 蟷ｴ鮴<EFBDB4>∽ｽ城劼螟ｩ謨ｰ縲￣FS/OS縲?
|
||||
* **P0: 髟ｿ螳ｽ霓ｬ謐｢ (Reshape/Pivot) 窶披?\[V2.1 譁ｰ蠅杤]:**
|
||||
* **蜉溯<EFBFBD><EFBFBD>?* 蟆<>應ｸ莠ｺ螟夊｡鯉ｼ磯柄陦ｨ<E999A6>俄晁ｽｬ謐｢荳ｺ窶應ｸ莠ｺ荳陦鯉ｼ亥ｮｽ陦ｨ<E999A6>俄昴?
|
||||
* **驟咲ｽｮ鬘ｹ<E9AC98><EFBDB9>**
|
||||
1. **唯一ID (Index):** 如 病人ID。
|
||||
2. **区分列 (Columns):** 如 就诊时间 或 次序 (用于生成后缀)。
|
||||
3. **值列 (Values):** 如 白细胞, B超 (需要铺平的数据)。
|
||||
* **场景：** 处理重复测量数据，为 SPSS 重复测量方差分析做准备。
|
||||
|
||||
1. **蜚ｯ荳ID (Index):** 螯?逞<>ｺｺID縲?
|
||||
2. **蛹ｺ蛻<EFBFBD><EFBFBD>?(Columns):** 螯?蟆ｱ隸頑慮髣ｴ 謌?谺｡蠎<EFBDA1> (逕ｨ莠守函謌仙錘郛)縲?
|
||||
3. **蛟ｼ蛻<EFBFBD> (Values):** 螯?逋ｽ扈<EFBDBD><E68988>? B雜?(髴隕<C280>銅蟷ｳ逧<EFBDB3>焚謐ｮ)縲?
|
||||
* **蝨ｺ譎ｯ<EFBFBD>?* 螟<>炊驥榊､肴ｵ矩㍼謨ｰ謐ｮ<E8AC90>御ｸｺ SPSS 驥榊､肴ｵ矩㍼譁ｹ蟾ｮ蛻<EFBDAE>梵蛛壼㊥螟<E38AA5>?
|
||||
#### **1.2 謨ｰ謐ｮ豐ｻ逅<EFBDBB> (Data Governance)**
|
||||
|
||||
* **P0: 拆分数据集 (Split Dataset):**
|
||||
* **功能：** 按某一列的唯一值（如“中心ID”），将大表拆分为多个 Excel 文件或 Sheet。
|
||||
* **P0: 跨列规则检查 (Cross-column Logic):**
|
||||
* **功能：** 定义逻辑规则（如 IF 性别='男' AND 怀孕='是'），在网格中高亮错误行。
|
||||
|
||||
#### **1.3 样本筛选 (Cohort Selection)**
|
||||
* **P0: 諡<EFBFBD><EFBFBD>謨ｰ謐ｮ髮?(Split Dataset):**
|
||||
* **蜉溯<EFBFBD><EFBFBD>?* 謖画汾荳蛻礼噪蜚ｯ荳蛟ｼ<E89B9F>亥ｦや應ｸｭ蠢オD窶晢ｼ会ｼ悟ｰ<E6829F>､ｧ陦ｨ諡<EFBDA8><E8ABA1>荳ｺ螟壻ｸ?Excel 譁<>ｻｶ謌?Sheet縲?
|
||||
* **P0: 霍ｨ蛻苓ｧ<EFBFBD><EFBFBD>譽譟?(Cross-column Logic):**
|
||||
* **蜉溯<EFBFBD><EFBFBD>?* 螳壻ｹ蛾ｻ霎題ｧ<E9A18C><EFBDA7><EFBFBD>亥ｦ<E4BAA5> IF 諤ｧ蛻ｫ='逕? AND 諤蟄?'譏?<3F>会ｼ悟惠鄂第<E98482>ｼ荳ｭ鬮倅ｺｮ髞呵ｯｯ陦後?
|
||||
#### **1.3 譬ｷ譛ｬ遲幃?(Cohort Selection)**
|
||||
|
||||
* **P0: 譫<>ｻｺ蜈･謗呈<E8AC97><E59188>㊥ (Cohort Builder):**
|
||||
* **功能：** 高级筛选器。支持多条件组合（AND/OR）。
|
||||
* **输出：** 筛选结果可“另存为新数据集”或“标记为排除”。
|
||||
* **蜉溯<EFBFBD><EFBFBD>?* 鬮倡ｺｧ遲幃牙勣縲よ髪謖∝､壽擅莉ｶ扈<EFBDB6>粋<EFBFBD><E7B28B>ND/OR<EFBFBD>峨?
|
||||
* **霎灘<EFBFBD><EFBFBD>?* 遲幃臥ｻ捺棡蜿ｯ窶懷嘗蟄倅ｸｺ譁ｰ謨ｰ謐ｮ髮<EFBDAE>晄<C280>窶懈<E7AAB6><E68788>ｮｰ荳ｺ謗帝勁窶昴?
|
||||
### **2\. 蜿ｳ萓ｧ譎ｺ閭ｽ萓ｧ霎ｹ譬?(Smart Insight Panel) 窶披?莠､莠堤<E88EA0>鬲<EFBFBD>**
|
||||
|
||||
### **2\. 右侧智能侧边栏 (Smart Insight Panel) —— 交互灵魂**
|
||||
*蠖鍋畑謌ｷ轤ｹ蜃ｻ陦ｨ譬ｼ逧<EFBDBC>汾荳蛻玲慮<E78EB2>御ｾｧ霎ｹ譬剰<E8ADAC>蜉ｨ貊大<E8B28A><E5A4A7>梧<EFBFBD>ｹ謐ｮ蛻礼ｱｻ蝙区署萓帷音螳夂噪貂<E599AA>ｴ怜ｷ･蜈ｷ縲?
|
||||
|
||||
*当用户点击表格的某一列时，侧边栏自动滑出，根据列类型提供特定的清洗工具。*
|
||||
#### **2.1 騾我ｸｭ窶懈焚蛟ｼ蝙銀晏<C280><E6998F>亥ｦょｹｴ鮴<EFBDB4>∫區扈<E58D80><E68988><EFBFBD>?*
|
||||
|
||||
#### **2.1 选中“数值型”列（如年龄、白细胞）**
|
||||
|
||||
* **P0: 统计概览：** 显示分布直方图 (Histogram)、最大值、最小值。
|
||||
* **P0: 扈溯ｮ｡讎りｧ茨ｼ?* 譏ｾ遉ｺ蛻<EFBDBA>ｸ<EFBFBD>峩譁ｹ蝗?(Histogram)縲∵怙螟ｧ蛟ｼ縲∵怙蟆丞ｼ縲?
|
||||
* **P0: 蠑ょｸｸ蛟ｼ譽豬具ｼ<E585B7>**
|
||||
* 自动标记偏离分布（如 \> 3σ）的值。
|
||||
* 提供按钮：处理异常（支持截断或置空）。
|
||||
* 閾ｪ蜉ｨ譬<EFBFBD>ｮｰ蛛冗ｦｻ蛻<EFBFBD>ｸ<EFBFBD>ｼ亥ｦ<EFBFBD> \> 3ﾏ<33>ｼ臥噪蛟ｼ縲?
|
||||
* 謠蝉ｾ帶潔髓ｮ<EFBFBD>壼､<EFBFBD>炊蠑ょｸｸ<EFBFBD>域髪謖∵穐譁ｭ謌也ｽｮ遨ｺ<EFBFBD>峨?
|
||||
* **P0: 逕滓<E98095>蛻<EFBFBD>ｱｻ蜿倬㍼ (Binning):**
|
||||
* **功能：** 将连续数值转为分类。
|
||||
* **交互：** 设置切点（如 60），生成新列（\<60, \>=60）。
|
||||
* **P0: 缺失值填补：** 提供 均值、中位数 填补选项。
|
||||
|
||||
#### **2.2 选中“文本/分类”列（如性别、诊断）**
|
||||
|
||||
* **P0: 统计概览：** 显示频次图 (Bar Chart)。
|
||||
* **P0: 数值映射 (Recode):**
|
||||
* **功能：** 将文本转为统计数值。
|
||||
* **交互：** 列出所有唯一值（Male, Female），用户输入目标值（1, 0）。
|
||||
* **P0: 设为敏感字段 (Masking):** 一键脱敏（替换为 \*\*\*\*\*\*）。
|
||||
* **P1: 智能纯化 (Smart Clean):** 若检测到 \>10、\<0.01 等含符号数值，提供一键提取数字功能。
|
||||
* **蜉溯<EFBFBD><EFBFBD>?* 蟆<>ｿ樒ｻｭ謨ｰ蛟ｼ霓ｬ荳ｺ蛻<EFBDBA>ｱｻ縲?
|
||||
* **莠､莠抵ｼ?* 隶ｾ鄂ｮ蛻<EFBDAE>せ<EFBFBD>亥ｦ<E4BAA5> 60<36>会ｼ檎函謌先眠蛻暦ｼ<E69AA6><60, \>=60<EFBFBD>峨?
|
||||
* **P0: 郛ｺ螟ｱ蛟ｼ蝪ｫ陦･<EFBFBD><EFBFBD>** 謠蝉ｾ<E89D89> 蝮<>ｼ縲∽ｸｭ菴肴焚 蝪ｫ陦･騾蛾｡ｹ縲?
|
||||
#### **2.2 騾我ｸｭ窶懈枚譛?蛻<>ｱｻ窶晏<E7AAB6><E6998F>亥ｦよｧ蛻ｫ縲∬ｯ頑妙<E9A091><E5A699>**
|
||||
|
||||
* **P0: 扈溯ｮ｡讎りｧ茨ｼ?* 譏ｾ遉ｺ鬚第ｬ｡蝗?(Bar Chart)縲?
|
||||
* **P0: 謨ｰ蛟ｼ譏<EFBDBC>蟆?(Recode):**
|
||||
* **蜉溯<E89C89><E6BAAF>?* 蟆<>枚譛ｬ霓ｬ荳ｺ扈溯ｮ｡謨ｰ蛟ｼ縲?
|
||||
* **莠､莠抵ｼ?* 蛻怜<E89BBB>謇譛牙髪荳蛟ｼ<E89B9F><EFBDBC>ale, Female<6C>会ｼ檎畑謌ｷ霎灘<E99C8E>逶ｮ譬<EFBDAE>ｼ<C280><EFBDBC>1, 0<>峨?
|
||||
* **P0: 隶ｾ荳ｺ謨乗─蟄玲ｮｵ (Masking):** 荳髞ｮ閼ｱ謨擾ｼ域崛謐｢荳?\*\*\*\*\*\*<2A>峨?
|
||||
* **P1: 譎ｺ閭ｽ郤ｯ蛹<EFBDAF> (Smart Clean):** 闍･譽豬句芦 \>10縲―<0.01 遲牙性隨ｦ蜿ｷ謨ｰ蛟ｼ<E89B9F>梧署萓帑ｸ髞ｮ謠仙叙謨ｰ蟄怜粥閭ｽ縲?
|
||||
### **3\. 雜<>ｺｧ鄂第<E98482>ｼ (The Grid)**
|
||||
|
||||
* **P0: 视觉反馈：**
|
||||
* **空值：** 背景显示淡红色。
|
||||
* **脏数据：** 类型不匹配的值显示紫色文字。
|
||||
* **列头图标：** 明确标识变量类型（\# 数值, A 文本, 📅 日期）。
|
||||
* **P0: 基础操作：** 列宽拖拽、列排序、双击单元格编辑。
|
||||
|
||||
### **4\. 性能与导出 (System)**
|
||||
* **P0: 隗<EFBFBD>ｧ牙渚鬥茨ｼ?*
|
||||
* **遨ｺ蛟ｼ<EFBFBD><EFBFBD>** 閭梧勹譏ｾ遉ｺ豺｡郤｢濶ｲ縲?
|
||||
* **閼乗焚謐ｮ<EFBFBD><EFBFBD>** 邀ｻ蝙倶ｸ榊源驟咲噪蛟ｼ譏ｾ遉ｺ邏ｫ濶ｲ譁<EFBDB2>ｭ励?
|
||||
* **蛻怜､ｴ蝗ｾ譬<EFBFBD>ｼ?* 譏守｡ｮ譬<EFBDAE>ｯ<EFBFBD>序驥冗ｱｻ蝙具ｼ<E585B7># 謨ｰ蛟? A 譁<>悽, <20>套 譌･譛滂ｼ峨?
|
||||
* **P0: 蝓ｺ遑謫堺ｽ懶ｼ?* 蛻怜ｮｽ諡匁郷縲∝<E7B8B2>謗貞ｺ上∝曙蜃ｻ蜊募<E89C8A>譬ｼ郛冶ｾ代?
|
||||
### **4\. 諤ｧ閭ｽ荳主ｯｼ蜃?(System)**
|
||||
|
||||
* **P0: 諤ｧ閭ｽ蜃<EFBDBD><E89C83> (Guardrails):**
|
||||
* 行数 \< 5万：全量加载。
|
||||
* 行数 \> 5万：提示降采样预览，或引导使用后端批处理。
|
||||
* **P1: 自动快照 (Auto-Save):** 每 10 次操作自动保存到 IndexedDB，防止浏览器崩溃丢失。
|
||||
* **P0: 导出定义：**
|
||||
* 导出 Excel/CSV。
|
||||
* **加分项：** 导出时附带变量类型定义（Metadata）。
|
||||
* 陦梧焚 \< 5荳<EFBFBD>ｼ壼<EFBFBD>驥丞刈霓ｽ縲?
|
||||
* 陦梧焚 \> 5荳<EFBFBD>ｼ壽署遉ｺ髯埼㊦譬ｷ鬚<EFBFBD>ｧ茨ｼ梧<EFBFBD>蠑募ｯｼ菴ｿ逕ｨ蜷守ｫｯ謇ｹ螟<EFBFBD>炊縲?
|
||||
* **P1: 閾ｪ蜉ｨ蠢ｫ辣ｧ (Auto-Save):** 豈?10 谺｡謫堺ｽ懆<EFBFBD>蜉ｨ菫晏ｭ伜芦 IndexedDB<44>碁亟豁｢豬剰ｧ亥勣蟠ｩ貅<EFBDA9>ｸ｢螟ｱ縲?
|
||||
* **P0: 蟇ｼ蜃ｺ螳壻ｹ会ｼ?*
|
||||
* 蟇ｼ蜃ｺ Excel/CSV縲?
|
||||
* **蜉<EFBFBD>蛻<EFBFBD>｡ｹ<EFBFBD><EFBFBD>** 蟇ｼ蜃ｺ譌ｶ髯<EFBDB6>ｸｦ蜿倬㍼邀ｻ蝙句ｮ壻ｹ会ｼ<E4BC9A>etadata<EFBFBD>峨?
|
||||
## **荳峨?逡碁擇蜴溷梛蜿り?(UI Reference)**
|
||||
|
||||
## **三、 界面原型参考 (UI Reference)**
|
||||
隸ｷ蜿り?蟾･蜈ｷC\_遘醍<E98198>疲焚謐ｮ郛冶ｾ大勣\_蜴溷梛隶ｾ隶｡\_V2\_貍皮､ｺ.html縲?
|
||||
* **蟶<>ｱ<EFBDB1>?* 鬘ｶ驛ｨ蜊戊｡悟ｷ･蜈ｷ譬?\+ 荳ｭ髣ｴ蜈ｨ螻冗ｽ第<EFBDBD>ｼ \+ 蜿ｳ萓ｧ蜿ｯ謚伜匠萓ｧ霎ｹ譬上?
|
||||
* **莠､莠抵ｼ?* 轤ｹ蜃ｻ窶憺柄螳ｽ霓ｬ謐｢窶晄潔髓ｮ蠑ｹ蜃ｺ驟咲ｽｮ讓｡諤∵｡<E288B5>?
|
||||
## **蝗帙?鬟朱勦隗<E58BA6>∩ (Risk Mitigation)**
|
||||
|
||||
请参考 工具C\_科研数据编辑器\_原型设计\_V2\_演示.html。
|
||||
|
||||
* **布局：** 顶部单行工具栏 \+ 中间全屏网格 \+ 右侧可折叠侧边栏。
|
||||
* **交互：** 点击“长宽转换”按钮弹出配置模态框。
|
||||
|
||||
## **四、 风险规避 (Risk Mitigation)**
|
||||
|
||||
1. **计算精度丢失：**
|
||||
* *解法：* 必须集成 math.js 库进行所有数学运算。
|
||||
2. **Pivot 导致内存溢出：**
|
||||
* *问题：* 长宽转换可能会导致列数爆炸（Column Explosion）。
|
||||
* *解法：* 在执行 Pivot 前，预计算结果列数。如果列数 \> 1000，阻止操作并提示用户减少“区分列”的唯一值数量。
|
||||
1. **隶｡邂礼ｲｾ蠎ｦ荳｢螟ｱ<E89E9F>?*
|
||||
* *隗｣豕包ｼ? 蠢<>｡ｻ髮<EFBDBB><E9ABAE> math.js 蠎楢ｿ幄｡梧園譛画焚蟄ｦ霑千ｮ励?
|
||||
2. **Pivot 蟇ｼ閾ｴ蜀<EFBDB4>ｭ俶ｺ｢蜃ｺ<E89C83>?*
|
||||
* *髣ｮ鬚假ｼ? 髟ｿ螳ｽ霓ｬ謐｢蜿ｯ閭ｽ莨壼ｯｼ閾ｴ蛻玲焚辷<E7849A>ず<EFBFBD><E3819A>olumn Explosion<6F>峨?
|
||||
* *隗｣豕包ｼ? 蝨ｨ謇ｧ陦?Pivot 蜑搾ｼ碁｢<E7A281>ｮ｡邂礼ｻ捺棡蛻玲焚縲ょｦよ棡蛻玲<E89BBB>?\> 1000<30>碁仆豁｢謫堺ｽ懷ｹｶ謠千､ｺ逕ｨ謌ｷ蜃丞ｰ鯛懷玄蛻<E78E84><E89BBB>窶晉噪蜚ｯ荳蛟ｼ謨ｰ驥上
|
||||
@@ -2,88 +2,80 @@
|
||||
|
||||
| 文档版本 | V1.0 (基于原型 V2) |
|
||||
| :---- | :---- |
|
||||
| **产品形态** | Web 端综合仪表盘 (Dashboard) |
|
||||
| **核心价值** | 作为数据清洗模块的统一入口，提供工具启动、异步任务监控、数据资产管理及跨工具流转能力。 |
|
||||
| **目标用户** | 临床医生、科研助理 |
|
||||
| **产å“<EFBFBD>å½¢æ€?* | Web 端综å<C2BC>ˆä»ªè¡¨ç›˜ (Dashboard) |
|
||||
| **æ ¸å¿ƒä»·å€?* | 作为数æ<C2B0>®æ¸…洗模å<C2A1>—的统一入å<C2A5>£ï¼Œæ<C592><C3A6>供工具å<C2B7>¯åŠ¨ã€<C3A3>异æ¥ä»»åŠ¡ç›‘控ã€<C3A3>æ•°æ<C2B0>®èµ„产管ç<C2A1>†å<E280A0>Šè·¨å·¥å…·æµ<C3A6>转能力ã€?|
|
||||
| **ç›®æ ‡ç”¨æˆ·** | 临床医生ã€<C3A3>ç§‘ç ”åŠ©ç<C2A9>?|
|
||||
|
||||
## **一、 产品架构图 (Product Architecture)**
|
||||
## **一ã€?产å“<C3A5>架构å›?(Product Architecture)**
|
||||
|
||||
工作台处于系统的二级导航位置，向下连接三个具体工具，横向连接任务与数据。
|
||||
工作å<EFBFBD>°å¤„于系统的二级导航ä½<EFBFBD>置，å<EFBFBD>‘下连接三个具体工具，横å<EFBFBD>‘连接任务与数æ<EFBFBD>®ã€?
|
||||
全局导航 \-\> **工作å<C593>?(本PRD)** \-\> (工具 A, 工具 B, 工具 C)
|
||||
|
||||
全局导航 \-\> **工作台 (本PRD)** \-\> (工具 A, 工具 B, 工具 C)
|
||||
|
||||
## **二、 核心功能需求 (Functional Requirements)**
|
||||
## **二ã€?æ ¸å¿ƒåŠŸèƒ½éœ€æ±?(Functional Requirements)**
|
||||
|
||||
### **1\. 全局导航集æˆ<C3A6> (Global Navigation)**
|
||||
|
||||
* **P0:** 必须无缝嵌入现有系统顶部导航栏。
|
||||
* **位置：** 位于 知识库 与 智能数据分析 之间。
|
||||
* **状态：** 点击后高亮显示“智能数据清洗”。
|
||||
* **P0:** å¿…é¡»æ— ç¼<EFBFBD>嵌入现有系统顶部导航æ <EFBFBD>ã€?
|
||||
* **ä½<EFBFBD>ç½®ï¼?* ä½<C3A4>于 知识åº?ä¸?智能数æ<C2B0>®åˆ†æž<C3A6> 之间ã€?
|
||||
* **状æ€<EFBFBD>：** 点击å<C2BB>Žé«˜äº®æ˜¾ç¤ºâ€œæ™ºèƒ½æ•°æ<C2B0>®æ¸…æ´—â€<C3A2>ã€?
|
||||
### **2\. 工具å<C2B7>¯åŠ¨åŒ?(The Launcher)**
|
||||
|
||||
### **2\. 工具启动区 (The Launcher)**
|
||||
* **P0:** **三å<E280B0>¡ç‰‡å…¥å<C2A5>£ï¼š** é†’ç›®å±•ç¤ºä¸‰ä¸ªæ ¸å¿ƒå·¥å…·çš„å…¥å<C2A5>£å<C2A3>¡ç‰‡ã€?
|
||||
* **工具 A (超级å<C2A7>ˆå¹¶å™?:** 强调“多æº<C3A6>æ•°æ<C2B0>®å<C2AE>ˆå¹¶ã€<C3A3>ID对é½<C3A9>â€<C3A2>ã€?
|
||||
* **工具 B (病历结构化机器人):** 强调“AI æ<><C3A6>å<EFBFBD>–ã€<C3A3>é<EFBFBD>žç»“构化转结构化â€<C3A2>ã€?
|
||||
* **工具 C (ç§‘ç ”æ•°æ<C2B0>®ç¼–辑å™?:** 强调“在线清洗ã€<C3A3>缺失值处ç<E2809E>†â€<C3A2>ã€?
|
||||
* **交互ï¼?* 点击å<C2BB>¡ç‰‡ï¼Œä»¥**å…¨å±<C3A5>模æ€<C3A6>框**æˆ?*新页é<C2B5>?*å½¢å¼<C3A5>打开对应工具ã€?
|
||||
### **3\. 任务æµ<C3A6>转ä¸å¿ƒ (Task Flow Hub) —â€?æ ¸å¿ƒäº¤äº’**
|
||||
|
||||
* **P0:** **三卡片入口：** 醒目展示三个核心工具的入口卡片。
|
||||
* **工具 A (超级合并器):** 强调“多源数据合并、ID对齐”。
|
||||
* **工具 B (病历结构化机器人):** 强调“AI 提取、非结构化转结构化”。
|
||||
* **工具 C (科研数据编辑器):** 强调“在线清洗、缺失值处理”。
|
||||
* **交互：** 点击卡片，以**全屏模态框**或**新页面**形式打开对应工具。
|
||||
|
||||
### **3\. 任务流转中心 (Task Flow Hub) —— 核心交互**
|
||||
|
||||
* **P0:** **最近任务列表：** 展示用户最近发起的 10 条任务。
|
||||
* **字段定义：** 任务名称 | 所属工具(A/B/C) | 状态(处理中/完成/失败) | 进度条 | 操作。
|
||||
* **P0:** **最近任务列表：** 展示用户最近å<E28098>‘èµ·çš„ 10 æ<>¡ä»»åŠ¡ã€?
|
||||
* **å—段定义ï¼?* 任务å<C2A1><C3A5>称 | 所属工å…?A/B/C) | 状æ€?处ç<E2809E>†ä¸?完æˆ<C3A6>/失败) | 进度æ<C2A6>?| æ“<C3A6>作ã€?
|
||||
* **P0:** **状æ€<C3A6>实时更新：**
|
||||
* **处理中：** 显示动态进度条（如 45%）。
|
||||
* **失败：** 显示红色警告，支持查看错误日志。
|
||||
* **P0:** **智能流转操作 (Smart Action)：**
|
||||
* **处ç<EFBFBD>†ä¸ï¼š** 显示动æ€<C3A6>进度æ<C2A6>¡ï¼ˆå¦‚ 45%）ã€?
|
||||
* **失败ï¼?* 显示红色è¦å‘Šï¼Œæ”¯æŒ<C3A6>查看错误日志ã€?
|
||||
* **P0:** **智能æµ<EFBFBD>转æ“<EFBFBD>作 (Smart Action)ï¼?*
|
||||
* 基于任务类型，动æ€<C3A6>推è<C2A8><C3A8>下一æ¥æ“<C3A6>作：
|
||||
* **工具 A 完成后：** 显示按钮 \[下载\] 和 \[去 AI 提取\] (跳转工具 B)。
|
||||
* **工具 B 完成后：** 显示按钮 \[下载\] 和 \[去清洗\] (跳转工具 C)。
|
||||
* **工具 C 完成后：** 显示按钮 \[下载\]。
|
||||
* **工具 A 完æˆ<C3A6>å<EFBFBD>Žï¼š** 显示按钮 \[下载\] å’?\[åŽ?AI æ<><C3A6>å<EFBFBD>–\] (跳转工具 B)ã€?
|
||||
* **工具 B 完æˆ<C3A6>å<EFBFBD>Žï¼š** 显示按钮 \[下载\] å’?\[去清洗\] (跳转工具 C)ã€?
|
||||
* **工具 C 完æˆ<C3A6>å<EFBFBD>Žï¼š** 显示按钮 \[下载\]ã€?
|
||||
### **4\. æ•°æ<C2B0>®èµ„产åº?(Data Asset Library) —â€?V2 æ ¸å¿ƒå<C692>‡çº§**
|
||||
|
||||
### **4\. 数据资产库 (Data Asset Library) —— V2 核心升级**
|
||||
|
||||
* **P0:** **Tab 分栏视图：**
|
||||
* **P0:** **Tab 分æ <C3A6>视图ï¼?*
|
||||
* **\[全部\]**
|
||||
* **\[处理结果\] (Outputs):** 存放工具 A/B/C 生成的最终文件。图标使用绿色/蓝色区分。
|
||||
* **\[原始上传\] (Inputs):** 存放用户直接上传的底表。图标使用灰色区分。
|
||||
* **P0:** **资产卡片信息：**
|
||||
* 文件名、标签（如“已清洗”、“已脱敏”）、行数、修改时间。
|
||||
* **\[处ç<EFBFBD>†ç»“æžœ\] (Outputs):** å˜æ”¾å·¥å…· A/B/C 生æˆ<C3A6>çš„æœ€ç»ˆæ–‡ä»¶ã€‚å›¾æ ‡ä½¿ç”¨ç»¿è‰?è“<C3A8>色区分ã€?
|
||||
* **\[åŽŸå§‹ä¸Šä¼ \] (Inputs):** å˜æ”¾ç”¨æˆ·ç›´æŽ¥ä¸Šä¼ çš„åº•è¡¨ã€‚å›¾æ ‡ä½¿ç”¨ç<EFBFBD>°è‰²åŒºåˆ†ã€?
|
||||
* **P0:** **资产å<EFBFBD>¡ç‰‡ä¿¡æ<EFBFBD>¯ï¼?*
|
||||
* 文件å<EFBFBD><EFBFBD>ã€<EFBFBD>æ ‡ç¾ï¼ˆå¦‚“已清洗â€<EFBFBD>ã€<EFBFBD>“已脱æ•<EFBFBD>â€<EFBFBD>）ã€<EFBFBD>行数ã€<EFBFBD>修改时间ã€?
|
||||
* **P0:** **å¿«æ<C2AB>·æ“<C3A6>作 (Hover Actions):**
|
||||
* 鼠标悬停在卡片上时，显示操作按钮：
|
||||
* \[下载\]: 下载到本地。
|
||||
* \[去处理\]: 如果是原始文件，点击跳转到工具选择页（或默认工具 A）。
|
||||
* \[分析\]: 如果是处理结果，点击跳转到“智能数据分析”模块（未来规划）。
|
||||
* **P0:** **原始文件上传入口：**
|
||||
* 底部固定按钮 \[+ 上传原始文件到库\]，允许用户将本地 Excel 存入云端备用。
|
||||
* é¼ æ ‡æ‚¬å<EFBFBD>œåœ¨å<EFBFBD>¡ç‰‡ä¸Šæ—¶ï¼Œæ˜¾ç¤ºæ“<EFBFBD>作按钮ï¼?
|
||||
* \[下载\]: 下载到本地�
|
||||
* \[去处ç<EFBFBD>†\]: 如果是原始文件，点击跳转到工具选择页（或默认工å…?A）ã€?
|
||||
* \[分æž<EFBFBD>\]: 如果是处ç<E2809E>†ç»“果，点击跳转到“智能数æ<C2B0>®åˆ†æž<C3A6>â€<C3A2>模å<C2A1>—（未æ<C2AA>¥è§„划）ã€?
|
||||
* **P0:** **åŽŸå§‹æ–‡ä»¶ä¸Šä¼ å…¥å<EFBFBD>£ï¼?*
|
||||
* 底部固定按钮 \[+ ä¸Šä¼ åŽŸå§‹æ–‡ä»¶åˆ°åº“\]，å…<C3A5>许用户将本地 Excel å˜å…¥äº‘端备用ã€?
|
||||
## **三ã€?ç•Œé<C592>¢åŽŸåž‹å<E280B9>‚è€?(UI Reference)**
|
||||
|
||||
## **三、 界面原型参考 (UI Reference)**
|
||||
|
||||
请严格参考 智能数据清洗工作台\_原型演示\_V2.html。
|
||||
|
||||
* **布局：** 顶部为 Launcher，下方分为左右两栏（左 2/3 为任务，右 1/3 为资产）。
|
||||
* **视觉风格：**
|
||||
è¯·ä¸¥æ ¼å<EFBFBD>‚è€?智能数æ<C2B0>®æ¸…洗工作å<C593>°\_原型演示\_V2.htmlã€?
|
||||
* **布局ï¼?* 顶部ä¸?Launcher，下方分为左å<C2A6>³ä¸¤æ <C3A6>（å·?2/3 为任务，å<C592>?1/3 为资产）ã€?
|
||||
* **è§†è§‰é£Žæ ¼ï¼?*
|
||||
* 工具 A：è“<C3A8>色系 (Blue)
|
||||
* 工具 B：紫色系 (Purple)
|
||||
* 工具 C：翠绿色系 (Emerald)
|
||||
* 状态色：处理中(蓝)、成功(绿)、失败(红)、警告(橙)。
|
||||
|
||||
## **四、 数据交互逻辑 (Data Logic)**
|
||||
* 工具 Cï¼šç¿ ç»¿è‰²ç³?(Emerald)
|
||||
* 状æ€<EFBFBD>色：处ç<EFBFBD>†ä¸(è“?ã€<C3A3>æˆ<C3A6>åŠ?ç»?ã€<C3A3>失è´?çº?ã€<C3A3>è¦å‘?æ©?ã€?
|
||||
## **å››ã€?æ•°æ<C2B0>®äº¤äº’逻辑 (Data Logic)**
|
||||
|
||||
1. **任务轮询 (Polling):**
|
||||
* 工作台加载时，调用 GET /api/tasks/recent。
|
||||
* 若列表中有状态为 processing 的任务，每隔 5 秒轮询一次状态更新，直到完成。
|
||||
2. **跨工具流转 (Handoff):**
|
||||
* 当用户点击 \[去 AI 提取\] 时：
|
||||
* 前端获取该任务的 resultFileId。
|
||||
* 跳转路由至 /tools/b?sourceFileId={resultFileId}。
|
||||
* 工具 B 初始化时，自动加载该文件，无需用户重新上传。
|
||||
* 工作å<EFBFBD>°åŠ 载时，调ç”?GET /api/tasks/recentã€?
|
||||
* 若列表ä¸æœ‰çŠ¶æ€<EFBFBD>为 processing 的任务，æ¯<C3A6>éš” 5 秒轮询一次状æ€<C3A6>更新，直到完æˆ<C3A6>ã€?
|
||||
2. **跨工具æµ<EFBFBD>è½?(Handoff):**
|
||||
* 当用户点å‡?\[åŽ?AI æ<><C3A6>å<EFBFBD>–\] 时：
|
||||
* å‰<EFBFBD>端获å<EFBFBD>–该任务的 resultFileIdã€?
|
||||
* 跳转路由�/tools/b?sourceFileId={resultFileId}�
|
||||
* 工具 B åˆ<C3A5>å§‹åŒ–æ—¶ï¼Œè‡ªåŠ¨åŠ è½½è¯¥æ–‡ä»¶ï¼Œæ— éœ€ç”¨æˆ·é‡<C3A9>æ–°ä¸Šä¼ ã€?
|
||||
3. **资产管ç<C2A1>†:**
|
||||
* 工具 A/B/C 产生的最终结果，需自动注册到 DataAsset 表中，并标记 type='output'。
|
||||
* 用户手动上传的文件，注册为 type='input'。
|
||||
* 工具 A/B/C 产生的最终结果，需自动注册åˆ?DataAsset 表ä¸ï¼Œå¹¶æ ‡è®° type='output'ã€?
|
||||
* ç”¨æˆ·æ‰‹åŠ¨ä¸Šä¼ çš„æ–‡ä»¶ï¼Œæ³¨å†Œä¸?type='input'ã€?
|
||||
## **五�埋点与统计需�*
|
||||
|
||||
## **五、 埋点与统计需求**
|
||||
|
||||
* **UV/PV:** 工作台访问量。
|
||||
* **CTR:** 三个工具卡片的点击率（判断哪个工具最常用）。
|
||||
* **流转率:** 用户点击“去 AI 提取”等流转按钮的比例（判断工作流是否顺畅）。
|
||||
* **UV/PV:** 工作å<C593>°è®¿é—®é‡<C3A9>ã€?
|
||||
* **CTR:** 三个工具å<C2B7>¡ç‰‡çš„点击率（判æ–哪个工具最常用）ã€?
|
||||
* **æµ<C3A6>转çŽ?** 用户点击“去 AI æ<><C3A6>å<EFBFBD>–â€<C3A2>ç‰æµ<C3A6>转按钮的比例（判æ–工作æµ<C3A6>是å<C2AF>¦é¡ºç•…）ã€
|
||||
@@ -1,37 +1,34 @@
|
||||
# **总体 PRD：医疗科研智能数据清洗平台 (The Data Cleaning Platform)**
|
||||
# **諤ｻ菴<EFBFBD> PRD<52>壼現逍礼ｧ醍<EFBDA7>疲匱閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ怜ｹｳ蜿?(The Data Cleaning Platform)**
|
||||
|
||||
| 文档版本 | V1.0 (基于工具箱架构) |
|
||||
| 譁<EFBFBD>｡｣迚域悽 | V1.0 (蝓ｺ莠主ｷ･蜈ｷ邂ｱ譫ｶ譫? |
|
||||
| :---- | :---- |
|
||||
| **产品形态** | 企业级 Web SaaS 平台 |
|
||||
| **核心价值** | 为临床医生提供 **“一站式”** 的数据治理能力，解决多源异构数据合并难、病历文本提取难、统计前清洗繁琐的三大痛点。 |
|
||||
| **技术架构** | Node.js \+ React \+ Python/R (统计服务) \+ LLM |
|
||||
| **莠ｧ蜩∝ｽ｢諤?* | 莨∽ｸ夂ｺ?Web SaaS 蟷ｳ蜿ｰ |
|
||||
| **譬ｸ蠢<EFBFBD>ｻｷ蛟?* | 荳ｺ荳ｴ蠎雁現逕滓署萓?**窶應ｸ遶吝ｼ鞘?* 逧<>焚謐ｮ豐ｻ逅<EFBDBB><E98085>蜉幢ｼ瑚ｧ｣蜀ｳ螟壽ｺ仙ｼよ桷謨ｰ謐ｮ蜷亥ｹｶ髫ｾ縲∫羅蜴<E7BE85>枚譛ｬ謠仙叙髫ｾ縲∫ｻ溯ｮ｡蜑肴ｸ<E882B4>ｴ礼ｹ∫瑞逧<E7919E>ｸ牙､ｧ逞帷せ縲?|
|
||||
| **謚譛ｯ譫ｶ譫?* | Node.js \+ React \+ Python/R (扈溯ｮ｡譛榊苅) \+ LLM |
|
||||
|
||||
## **一、 项目背景与目标 (Background & Objectives)**
|
||||
## **荳縲?鬘ｹ逶ｮ閭梧勹荳守岼譬?(Background & Objectives)**
|
||||
|
||||
### **1.1 譬ｸ蠢<EFBDB8>李轤ｹ**
|
||||
|
||||
临床科研数据的准备过程（Data Preparation）通常占据整个科研周期的 80% 时间。医生面临三大阻碍：
|
||||
|
||||
1. **乱 (Messy):** HIS 导出的数据分散在多个 Excel（门诊、住院、检验），ID 对不上，时间线混乱。
|
||||
2. **杂 (Unstructured):** 大量关键信息（如病理诊断、出院小结）存在于文本段落中，无法直接统计。
|
||||
3. **错 (Dirty):** 缺失值、异常值、录入错误频发，不符合统计软件（SPSS/SAS）的格式要求。
|
||||
荳ｴ蠎顔ｧ醍<EFBFBD>疲焚謐ｮ逧<EFBFBD>㊥螟<EFBFBD>ｿ<EFBFBD>ｨ具ｼ<EFBFBD>ata Preparation<6F>蛾壼ｸｸ蜊<EFBDB8>謐ｮ謨ｴ荳ｪ遘醍<E98198>泌捉譛溽<E8AD9B>?80% 譌ｶ髣ｴ縲ょ現逕滄擇荳ｴ荳牙､ｧ髦ｻ遒搾ｼ<E690BE>
|
||||
|
||||
1. **荵?(Messy):** HIS 蟇ｼ蜃ｺ逧<EFBDBA>焚謐ｮ蛻<EFBDAE>淵蝨ｨ螟壻ｸｪ Excel<65>磯葎隸翫∽ｽ城劼縲∵｣鬪鯉ｼ会ｼ栗D 蟇ｹ荳堺ｸ奇ｼ梧慮髣ｴ郤ｿ豺ｷ荵ｱ縲?
|
||||
2. **譚?(Unstructured):** 螟ｧ驥丞<E9A9A5>髞ｮ菫｡諱ｯ<E8ABB1>亥ｦら羅逅<E7BE85>ｯ頑妙縲∝<E7B8B2>髯｢蟆冗ｻ難ｼ牙ｭ伜惠莠取枚譛ｬ谿ｵ關ｽ荳ｭ<E88DB3>梧裏豕慕峩謗･扈溯ｮ｡縲?
|
||||
3. **髞?(Dirty):** 郛ｺ螟ｱ蛟ｼ縲∝ｼょｸｸ蛟ｼ縲∝ｽ募<EFBDBD>髞呵ｯｯ鬚大書<E5A4A7>御ｸ咲ｬｦ蜷育ｻ溯ｮ｡霓ｯ莉ｶ<E88E89><EFBDB6>PSS/SAS<41>臥噪譬ｼ蠑剰ｦ∵ｱゅ?
|
||||
### **1.2 莠ｧ蜩∫岼譬<E5B2BC>**
|
||||
|
||||
构建一个 **“流程化、智能化、低门槛”** 的数据清洗平台：
|
||||
譫<EFBFBD>ｻｺ荳荳?**窶懈ｵ∫ｨ句喧縲∵匱閭ｽ蛹悶∽ｽ朱葎讒帚?* 逧<>焚謐ｮ貂<EFBDAE>ｴ怜ｹｳ蜿ｰ<E89CBF><EFBDB0>
|
||||
|
||||
* **模块化 (Modular):** 将复杂流程拆解为三个独立工具，降低认知负荷。
|
||||
* **可信赖 (Trustworthy):** 通过“双模型验证”和“全过程追溯”，解决对 AI 的信任危机。
|
||||
* **高性能 (Performant):** 支持 10万+ 行数据的流式处理与实时编辑。
|
||||
* **讓｡蝮怜<EFBFBD>?(Modular):** 蟆<EFBFBD>､肴揩豬∫ｨ区究隗｣荳ｺ荳我ｸｪ迢ｬ遶句ｷ･蜈ｷ<EFBFBD>碁剄菴手ｮ､遏･雍溯差縲?
|
||||
* **蜿ｯ菫｡襍?(Trustworthy):** 騾夊ｿ<EFBFBD>懷曙讓｡蝙矩ｪ瑚ｯ≫晏柱窶懷<EFBFBD>霑<EFBFBD>ｨ玖ｿｽ貅ｯ窶晢ｼ瑚ｧ｣蜀ｳ蟇?AI 逧<>ｿ｡莉ｻ蜊ｱ譛ｺ縲?
|
||||
* **鬮俶ｧ閭ｽ (Performant):** 謾ｯ謖<EFBFBD> 10荳? 陦梧焚謐ｮ逧<EFBDAE>ｵ∝ｼ丞､<E4B89E>炊荳主ｮ樊慮郛冶ｾ代?
|
||||
## **莠後?莠ｧ蜩∵ｻ菴捺楔譫<E6A594> (Product Architecture)**
|
||||
|
||||
## **二、 产品总体架构 (Product Architecture)**
|
||||
|
||||
平台采用 **“1 \+ 3”** 架构模式：**1 个统一工作台 \+ 3 个垂直效能工具**。
|
||||
|
||||
### **2.1 架构图**
|
||||
蟷ｳ蜿ｰ驥<EFBFBD>畑 **窶? \+ 3窶?* 譫ｶ譫<EFBDB6>ｨ｡蠑擾ｼ?*1 荳ｪ扈滉ｸ蟾･菴懷<E88FB4>?\+ 3 荳ｪ蝙ら峩謨郁<E8ACA8>蟾･蜈?*縲?
|
||||
### **2.1 譫ｶ譫<EFBDB6><E8ADAB>?*
|
||||
|
||||
graph TD
|
||||
User\[临床医生/科研人员\] \--\> Portal\[智能数据清洗工作台 (Portal)\]
|
||||
User\[荳ｴ蠎雁現逕<EFBFBD>/遘醍<E98198>比ｺｺ蜻禄] \--\> Portal\[譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ怜ｷ･菴懷<E88FB4>?(Portal)\]
|
||||
|
||||
subgraph The\_Toolkit \[謨郁<E8ACA8>蟾･蜈ｷ邂ｱ\]
|
||||
Portal \--\> ToolA\[蟾･蜈ｷ A: 雜<>ｺｧ蜷亥ｹｶ蝎ｨ\]
|
||||
@@ -40,8 +37,8 @@ graph TD
|
||||
end
|
||||
|
||||
subgraph Data\_Flow \[謨ｰ謐ｮ豬∬ｽｬ\]
|
||||
ToolA \--合并后数据--\> ToolB
|
||||
ToolB \--结构化数据--\> ToolC
|
||||
ToolA \--蜷亥ｹｶ蜷取焚謐?-\> ToolB
|
||||
ToolB \--扈捺桷蛹匁焚謐?-\> ToolC
|
||||
ToolC \--貂<>ｴ怜錘謨ｰ謐ｮ髮<EFBDAE>--\> Analysis\[譎ｺ閭ｽ謨ｰ謐ｮ蛻<EFBDAE>梵讓｡蝮予]
|
||||
end
|
||||
|
||||
@@ -55,58 +52,52 @@ graph TD
|
||||
ToolB \-.-\> Engine2
|
||||
ToolC \-.-\> Engine3
|
||||
|
||||
### **2.2 模块定义与边界**
|
||||
### **2.2 讓｡蝮怜ｮ壻ｹ我ｸ手ｾｹ逡?*
|
||||
|
||||
| 讓｡蝮怜錐遘ｰ | 蟇ｹ蠎泌惻譎ｯ | 譬ｸ蠢<EFBDB8>ｻｻ蜉｡ | 蜈ｳ髞ｮ莠ｧ蜃ｺ | 隸ｦ扈<EFBDA6>枚譯｣ |
|
||||
| :---- | :---- | :---- | :---- | :---- |
|
||||
| **工作台 (Portal)** | 全局入口 | 任务监控、资产管理、跨工具流转 | 统一仪表盘 | [PRD\_数据清洗工作台](https://www.google.com/search?q=PRD_%E6%95%B0%E6%8D%AE%E6%B8%85%E6%B4%97%E5%B7%A5%E4%BD%9C%E5%8F%B0.md) |
|
||||
| **蟾･菴懷<EFBFBD>?(Portal)** | 蜈ｨ螻蜈･蜿｣ | 莉ｻ蜉｡逶第而縲∬ｵ<E288AC>ｺｧ邂｡逅<EFBDA1>∬ｷｨ蟾･蜈ｷ豬∬ｽｬ | 扈滉ｸ莉ｪ陦ｨ逶?| [PRD\_謨ｰ謐ｮ貂<EFBDAE>ｴ怜ｷ･菴懷床](https://www.google.com/search?q=PRD_%E6%95%B0%E6%8D%AE%E6%B8%85%E6%B4%97%E5%B7%A5%E4%BD%9C%E5%8F%B0.md) |
|
||||
| **蟾･蜈ｷ A (Merger)** | 螟壽ｺ仙粋蟷ｶ | ID 蟇ｹ鮨舌∬ｮｿ隗<EFBDBF>渕蜃<E6B895>粋蟷ｶ縲∵慮髣ｴ遯玲ｸ<E78EB2>ｴ<EFBFBD> | 螳ｽ陦ｨ (Wide Table) | [PRD\_蟾･蜈ｷA\_雜<5F>ｺｧ蜷亥ｹｶ蝎ｨ\_V2](https://www.google.com/search?q=PRD_%E5%B7%A5%E5%85%B7A_%E8%B6%85%E7%BA%A7%E5%90%88%E5%B9%B6%E5%99%A8_V2.md) |
|
||||
| **工具 B (AI)** | 文本提取 | OCR、实体提取、隐私脱敏、交叉验证 | 结构化字段 | [PRD\_工具B\_病历结构化机器人\_V2](https://www.google.com/search?q=PRD_%E5%B7%A5%E5%85%B7B_%E7%97%85%E5%8E%86%E7%BB%93%E6%9E%84%E5%8C%96%E6%9C%BA%E5%99%A8%E4%BA%BA_V2.md) |
|
||||
| **工具 C (Editor)** | 深度清洗 | 缺失填补、异常处理、变量计算、分箱 | 最终分析集 | [PRD\_工具C\_科研数据编辑器\_V2](https://www.google.com/search?q=PRD_%E5%B7%A5%E5%85%B7C_%E7%A7%91%E7%A0%94%E6%95%B0%E6%8D%AE%E7%BC%96%E8%BE%91%E5%99%A8_V2.md) |
|
||||
| **蟾･蜈ｷ B (AI)** | 譁<EFBFBD>悽謠仙叙 | OCR縲∝ｮ樔ｽ捺署蜿悶<E682B6>嚼遘∬┳謨上∽ｺ､蜿蛾ｪ瑚ｯ?| 扈捺桷蛹門ｭ玲ｮ?| [PRD\_蟾･蜈ｷB\_逞<5F>紙扈捺桷蛹匁惻蝎ｨ莠ｺ\_V2](https://www.google.com/search?q=PRD_%E5%B7%A5%E5%85%B7B_%E7%97%85%E5%8E%86%E7%BB%93%E6%9E%84%E5%8C%96%E6%9C%BA%E5%99%A8%E4%BA%BA_V2.md) |
|
||||
| **蟾･蜈ｷ C (Editor)** | 豺ｱ蠎ｦ貂<EFBFBD>ｴ<EFBFBD> | 郛ｺ螟ｱ蝪ｫ陦･縲∝ｼょｸｸ螟<EFBDB8>炊縲∝序驥剰ｮ｡邂励∝<C280>邂?| 譛扈亥<E68988>譫宣寔 | [PRD\_蟾･蜈ｷC\_遘醍<E98198>疲焚謐ｮ郛冶ｾ大勣\_V2](https://www.google.com/search?q=PRD_%E5%B7%A5%E5%85%B7C_%E7%A7%91%E7%A0%94%E6%95%B0%E6%8D%AE%E7%BC%96%E8%BE%91%E5%99%A8_V2.md) |
|
||||
|
||||
## **三、 核心业务流程 (Core Workflows)**
|
||||
## **荳峨?譬ｸ蠢<EFBDB8>ｸ壼苅豬∫ｨ<E288AB> (Core Workflows)**
|
||||
|
||||
### **3.1 典型全链路场景 (The "Happy Path")**
|
||||
### **3.1 蜈ｸ蝙句<EFBFBD>體ｾ霍ｯ蝨ｺ譎?(The "Happy Path")**
|
||||
|
||||
场景：医生收集了 100 份患者的住院 Excel 和病理报告 PDF，需要进行生存分析。
|
||||
|
||||
1. **合并 (Step 1):** 在 **工作台** 启动 **工具 A**。上传“住院记录”为主表，“检验单”为辅表。系统基于“入院日期 ±7天”的时间窗，将检验数据挂载到住院记录上。
|
||||
2. **提取 (Step 2):** 合并完成后，点击“流转到工具 B”。**工具 B** 自动加载数据。医生选择“肺癌病理模版”，双模型（DeepSeek & Qwen）并发提取“肿瘤大小”和“淋巴结转移”。医生在全景网格中裁决不一致的数据。
|
||||
3. **清洗 (Step 3):** 提取完成后，点击“流转到工具 C”。**工具 C** 打开编辑器。医生通过侧边栏发现“肿瘤大小”有缺失值，一键用均值填补；并新增计算列 BMI。
|
||||
4. **分析 (Step 4):** 数据清洗完毕，保存为“分析集\_V1”。一键发送至系统的“智能数据分析”模块进行 Kaplan-Meier 生存分析。
|
||||
|
||||
## **四、 全局非功能需求 (Non-Functional Requirements)**
|
||||
蝨ｺ譎ｯ<EFBFBD>壼現逕滓噺髮<EFBFBD>ｺ<EFBFBD> 100 莉ｽ謔｣閠<EFBDA3>噪菴城劼 Excel 蜥檎羅逅<E7BE85>冠蜻?PDF<44>碁怙隕∬ｿ幄｡檎函蟄伜<E89F84>譫舌?
|
||||
1. **蜷亥ｹｶ (Step 1):** 蝨?**蟾･菴懷<E88FB4>?* 蜷ｯ蜉ｨ **蟾･蜈ｷ A**縲ゆｸ贋ｼ<E8B48B>窶應ｽ城劼隶ｰ蠖補昜ｸｺ荳ｻ陦ｨ<E999A6>娯懈｣鬪悟黒窶昜ｸｺ霎<EFBDBA>｡ｨ縲らｳｻ扈溷渕莠寂懷<C280>髯｢譌･譛?ﾂｱ7螟ｩ窶晉噪譌ｶ髣ｴ遯暦ｼ悟ｰ<E6829F>｣鬪梧焚謐ｮ謖りｽｽ蛻ｰ菴城劼隶ｰ蠖穂ｸ翫?
|
||||
2. **謠仙叙 (Step 2):** 蜷亥ｹｶ螳梧<EFBFBD>蜷趣ｼ檎せ蜃ｻ窶懈ｵ∬ｽｬ蛻ｰ蟾･蜈ｷ B窶昴?*蟾･蜈ｷ B** 閾ｪ蜉ｨ蜉<EFBDA8>霓ｽ謨ｰ謐ｮ縲ょ現逕滄画叫窶懆ぜ逋檎羅逅<E7BE85>ｨ｡迚遺晢ｼ悟曙讓｡蝙具ｼ<E585B7>eepSeek & Qwen<65>牙ｹｶ蜿第署蜿問懆ち逖､螟ｧ蟆鞘晏柱窶懈ｷ句ｷｴ扈楢ｽｬ遘ｻ窶昴ょ現逕溷惠蜈ｨ譎ｯ鄂第<E98482>ｼ荳ｭ陬∝<E999AC>荳堺ｸ閾ｴ逧<EFBDB4>焚謐ｮ縲?
|
||||
3. **貂<EFBFBD>ｴ<EFBFBD> (Step 3):** 謠仙叙螳梧<EFBFBD>蜷趣ｼ檎せ蜃ｻ窶懈ｵ∬ｽｬ蛻ｰ蟾･蜈ｷ C窶昴?*蟾･蜈ｷ C** 謇灘ｼ郛冶ｾ大勣縲ょ現逕滄夊ｿ<E5A48A>ｾｧ霎ｹ譬丞書邇ｰ窶懆ち逖､螟ｧ蟆鞘晄怏郛ｺ螟ｱ蛟ｼ<E89B9F>御ｸ髞ｮ逕ｨ蝮<EFBDA8>ｼ蝪ｫ陦･<E999A6>帛ｹｶ譁ｰ蠅櫁ｮ｡邂怜<E98282> BMI縲?
|
||||
4. **蛻<EFBFBD>梵 (Step 4):** 謨ｰ謐ｮ貂<EFBFBD>ｴ怜ｮ梧ｯ包ｼ御ｿ晏ｭ倅ｸｺ窶懷<EFBFBD>譫宣寔\_V1窶昴ゆｸ髞ｮ蜿鷹∬<C280>邉ｻ扈溽噪窶懈匱閭ｽ謨ｰ謐ｮ蛻<EFBDAE>梵窶晄ｨ｡蝮苓ｿ幄｡?Kaplan-Meier 逕溷ｭ伜<EFBDAD>譫舌?
|
||||
## **蝗帙?蜈ｨ螻髱槫粥閭ｽ髴豎?(Non-Functional Requirements)**
|
||||
|
||||
### **4.1 逕ｨ謌ｷ菴馴ｪ檎ｭ也払 (UX Strategy)**
|
||||
|
||||
* **去可视化 (De-visualization):** 对于工具 A 和 B，不展示全量 Excel 网格，采用 **“向导配置 \-\> 黑盒处理 \-\> 黄金预览”** 的模式，降低浏览器渲染压力，聚焦结果。
|
||||
* **反馈补偿 (Feedback Loop):** 既然看不见过程，必须增强结果反馈。每个工具必须提供详细的 **“数据质量报告”**（如：丢弃行数、冲突率、空值率）。
|
||||
* **本地优先 (Local-First):** 工具 C 采用 IndexedDB 存储，确保编辑操作（筛选、替换）无网络延迟。
|
||||
|
||||
### **4.2 数据安全与隐私 (Security & Privacy)**
|
||||
|
||||
* **PII 脱敏:** 所有发送给 LLM (工具 B) 的数据，**必须**在后端先经过正则脱敏（姓名、身份证、手机号）。
|
||||
* **数据隔离:** 不同用户的数据严格物理隔离（S3 路径 / DB Row Level Security）。
|
||||
* **蜴ｻ蜿ｯ隗<EFBFBD>喧 (De-visualization):** 蟇ｹ莠主ｷ･蜈ｷ A 蜥?B<>御ｸ榊ｱ慕､ｺ蜈ｨ驥<EFBDA8> Excel 鄂第<E98482>ｼ<EFBFBD>碁㊦逕?**窶懷髄蟇ｼ驟咲ｽ?\-\> 鮟醍將螟<E5B087>炊 \-\> 鮟<>≡鬚<E289A1>ｧ遺?* 逧<>ｨ｡蠑擾ｼ碁剄菴取ｵ剰ｧ亥勣貂ｲ譟灘視蜉幢ｼ瑚★辟ｦ扈捺棡縲?
|
||||
* **蜿埼ｦ郁｡･蛛ｿ (Feedback Loop):** 譌｢辟ｶ逵倶ｸ崎ｧ∬ｿ<EFBFBD>ｨ具ｼ悟ｿ<EFBFBD>｡ｻ蠅槫ｼｺ扈捺棡蜿埼ｦ医よｯ丈ｸｪ蟾･蜈ｷ蠢<EFBFBD>｡ｻ謠蝉ｾ幄ｯｦ扈<EFBFBD>噪 **窶懈焚謐ｮ雍ｨ驥乗冠蜻岩?*<2A>亥ｦゑｼ壻ｸ｢蠑<EFBDA2>｡梧焚縲∝<E7B8B2>遯∫紫縲∫ｩｺ蛟ｼ邇<EFBDBC>ｼ峨?
|
||||
* **譛ｬ蝨ｰ莨伜<EFBFBD> (Local-First):** 蟾･蜈ｷ C 驥<>畑 IndexedDB 蟄伜お<EFBFBD>檎｡ｮ菫晉ｼ冶ｾ第桃菴懶ｼ育ｭ幃峨∵崛謐｢<EFBFBD>画裏鄂醍ｻ懷ｻｶ霑溘?
|
||||
### **4.2 謨ｰ謐ｮ螳牙<E89EB3>荳朱嚼遘?(Security & Privacy)**
|
||||
|
||||
* **PII 閼ｱ謨<EFBDB1>:** 謇譛牙書騾∫ｻ<E288AB> LLM (蟾･蜈ｷ B) 逧<>焚謐ｮ<E8AC90><EFBDAE>**蠢<>｡ｻ**蝨ｨ蜷守ｫｯ蜈育ｻ剰ｿ<E589B0>ｭ｣蛻呵┳謨擾ｼ亥ｧ灘錐縲∬ｺｫ莉ｽ隸√∵焔譛ｺ蜿ｷ<E89CBF>峨?
|
||||
* **謨ｰ謐ｮ髫皮ｦｻ:** 荳榊酔逕ｨ謌ｷ逧<EFBDB7>焚謐ｮ荳･譬ｼ迚ｩ逅<EFBDA9>囈遖ｻ<E98196><EFBDBB>3 霍ｯ蠕<EFBDAF> / DB Row Level Security<74>峨?
|
||||
### **4.3 諤ｧ閭ｽ謖<EFBDBD><E8AC96><EFBFBD> (Performance SLAs)**
|
||||
|
||||
* **文件支持:** 单个文件支持最大 **50MB** 或 **50万行**。
|
||||
* **譁<EFBFBD>ｻｶ謾ｯ謖<EFBFBD>:** 蜊穂ｸｪ譁<EFBDAA>ｻｶ謾ｯ謖∵怙螟?**50MB** 謌?**50荳<30>｡<EFBFBD>**縲?
|
||||
* **蜩榊ｺ秘溷ｺｦ:**
|
||||
* 工具 A 合并（10万行）：\< 60秒。
|
||||
* 工具 B 提取（并发）：取决于 Token 量，需提供进度条。
|
||||
* 工具 C 编辑响应：\< 100ms。
|
||||
|
||||
## **五、 数据标准与流转协议 (Data Standards)**
|
||||
* 蟾･蜈ｷ A 蜷亥ｹｶ<EFBDB9>?0荳<30>｡鯉ｼ会ｼ喀< 60遘偵?
|
||||
* 蟾･蜈ｷ B 謠仙叙<E4BB99>亥ｹｶ蜿托ｼ会ｼ壼叙蜀ｳ莠<EFBDB3> Token 驥擾ｼ碁怙謠蝉ｾ幄ｿ帛ｺｦ譚｡縲?
|
||||
* 蟾･蜈ｷ C 郛冶ｾ大桃蠎費ｼ喀< 100ms縲?
|
||||
## **莠斐?謨ｰ謐ｮ譬<EFBDAE>㊥荳取ｵ∬ｽｬ蜊剰ｮ?(Data Standards)**
|
||||
|
||||
荳ｺ莠<EFBFBD>ｿ晁ｯ∽ｸ我ｸｪ蟾･蜈ｷ閭ｽ鬘ｺ逡<EFBFBD>刻菴懶ｼ悟ｿ<EFBFBD>｡ｻ螳壻ｹ臥ｻ滉ｸ逧<EFBFBD>焚謐ｮ莠､謐｢譬<EFBFBD>㊥<EFBFBD><EFBFBD>
|
||||
|
||||
1. **文件格式:** 内部流转统一使用 **CSV (UTF-8 with BOM)** 或 **JSON Lines**。
|
||||
2. **日期格式:** 所有工具产出的日期列，强制标准化为 YYYY-MM-DD。
|
||||
3. **空值表示:** 统一使用 null 或空字符串 ""，严禁使用 "NA", "-" 等文本混入数值列。
|
||||
4. **流转凭证:** 跨工具跳转时，通过 URL 参数传递 assetId (资产ID)，接收方通过 API 获取文件流，无需前端透传大文件。
|
||||
1. **譁<EFBFBD>ｻｶ譬ｼ蠑<EFBFBD>:** 蜀<>Κ豬∬ｽｬ扈滉ｸ菴ｿ逕ｨ **CSV (UTF-8 with BOM)** 謌?**JSON Lines**縲?
|
||||
2. **譌･譛滓<EFBFBD>ｼ蠑<EFBFBD>:** 謇譛牙ｷ･蜈ｷ莠ｧ蜃ｺ逧<EFBDBA>律譛溷<E8AD9B><E6BAB7>悟ｼｺ蛻ｶ譬<EFBDB6>㊥蛹紋ｸｺ YYYY-MM-DD縲?
|
||||
3. **遨ｺ蛟ｼ陦ｨ遉?** 扈滉ｸ菴ｿ逕ｨ null 謌也ｩｺ蟄礼ｬｦ荳?""<22>御ｸ･遖∽ｽｿ逕?"NA", "-" 遲画枚譛ｬ豺ｷ蜈･謨ｰ蛟ｼ蛻励?
|
||||
4. **豬∬ｽｬ蜃ｭ隸<EFBFBD>:** 霍ｨ蟾･蜈ｷ霍ｳ霓ｬ譌ｶ<E8AD8C>碁夊ｿ<E5A48A> URL 蜿よ焚莨<E7849A>騾?assetId (襍<>ｺｧID)<29>梧磁謾ｶ譁ｹ騾夊ｿ<E5A48A> API 闔ｷ蜿匁枚莉ｶ豬<EFBDB6>ｼ梧裏髴蜑咲ｫｯ騾丈ｼ<E4B888>螟ｧ譁<EFBDA7>ｻｶ縲?
|
||||
## **蜈ｭ縲?髯<>ｽ包ｼ夂沿譛ｬ隗<EFBDAC><E99A97>?(Roadmap)**
|
||||
|
||||
## **六、 附录：版本规划 (Roadmap)**
|
||||
|
||||
* **Phase 1 (MVP):** 上线工作台 \+ 工具 A (基础合并) \+ 工具 C (基础编辑)。工具 B 暂不上线。
|
||||
* **Phase 2 (Intelligence):** 上线 工具 B (单模型提取)。工具 C 增加侧边栏统计。
|
||||
* **Phase 3 (Trust):** 工具 B 升级为双模型交叉验证。工具 A 升级为时间窗合并。
|
||||
* **Phase 1 (MVP):** 荳顔ｺｿ蟾･菴懷<E88FB4>?\+ 蟾･蜈ｷ A (蝓ｺ遑蜷亥ｹｶ) \+ 蟾･蜈ｷ C (蝓ｺ遑郛冶ｾ<E586B6>)縲ょｷ･蜈?B 證ゆｸ堺ｸ顔ｺｿ縲?
|
||||
* **Phase 2 (Intelligence):** 荳顔ｺｿ 蟾･蜈ｷ B (蜊墓ｨ｡蝙区署蜿?縲ょｷ･蜈?C 蠅槫刈萓ｧ霎ｹ譬冗ｻ溯ｮ｡縲?
|
||||
* **Phase 3 (Trust):** 蟾･蜈ｷ B 蜊<>ｺｧ荳ｺ蜿梧ｨ｡蝙倶ｺ､蜿蛾ｪ瑚ｯ√ょｷ･蜈?A 蜊<>ｺｧ荳ｺ譌ｶ髣ｴ遯怜粋蟷ｶ縲
|
||||
Reference in New Issue
Block a user