refactor(terminology): 统一术语标准并优化代码类型安全

- 将B2B统一为TOB术语 - 将状态值统一为大写格式 - 优化类型声明，避免使用any - 将float类型替换为decimal以提高精度 - 新增术语标准化文档 - 优化路由结构和菜单分类 - 添加TypeORM实体类 - 增强加密模块安全性 - 重构前端路由结构 - 完善任务模板和验收标准
2026-03-20 09:43:50 +08:00
parent eafa1bbe94
commit 48a78137c5
132 changed files with 13767 additions and 2140 deletions
--- a/docs/05_AI/00_AI_Index.md
+++ b/docs/05_AI/00_AI_Index.md
@@ -11,7 +11,6 @@
 |------|------|------|
 | [01_Strategy](01_Strategy.md) | AI策略设计 | ✅ |
 | [02_Rules](02_Rules.md) | AI协作规则 | ✅ |
-| [03_Module_List](03_Module_List.md) | AI模块列表 | ✅ |

 ---

--- a/docs/05_AI/03_Implementation_Strategy.md
+++ b/docs/05_AI/03_Implementation_Strategy.md
@@ -0,0 +1,252 @@
+# AI功能分阶段实现策略
+
+## 1. 总体目标
+
+本策略旨在分阶段实现项目所需的AI功能，确保功能迭代有序推进，同时保证系统稳定性和性能。
+
+## 2. 分阶段实现计划
+
+### 2.1 第一阶段：核心AI功能优化（1-2周）
+
+**目标**：优化已实现的核心AI功能，提升性能和可靠性。
+
+**技术栈**：
+- TypeScript
+- OpenAI API (GPT-4o)
+- Redis 缓存
+- Express.js
+
+**具体任务**：
+1. **优化AIService中的API调用**
+   - 实现API调用的重试机制
+   - 添加请求超时控制
+   - 实现批量API调用，减少网络请求次数
+
+2. **优化缓存策略**
+   - 改进CoreEngineService中的缓存键生成算法
+   - 实现缓存过期策略
+   - 增加缓存命中率监控
+
+3. **提升多模态处理性能**
+   - 优化图像处理流程
+   - 实现图像压缩和预处理
+   - 减少API调用延迟
+
+**性能指标**：
+- API响应时间 < 2秒
+- 缓存命中率 > 80%
+- 错误率 < 1%
+
+**验收标准**：
+- 所有核心AI功能正常运行
+- 性能指标达标
+- 代码通过TypeScript编译
+- 无运行时错误
+
+### 2.2 第二阶段：扩展AI功能（2-3周）
+
+**目标**：实现缺失的重要AI功能，扩展系统能力。
+
+**技术栈**：
+- TypeScript
+- OpenAI API (GPT-4o)
+- TensorFlow.js (可选)
+- Redis 缓存
+
+**具体任务**：
+1. **实现视频自动切片与卖点提取**
+   - 视频内容分析
+   - 自动识别关键帧
+   - 生成卖点描述
+
+2. **实现风格自动对齐**
+   - 分析商品图像风格
+   - 生成风格一致的营销素材
+   - 应用于商品列表和详情页
+
+3. **增强语义漂移检测**
+   - 优化语义漂移算法
+   - 实现自动修正机制
+   - 提供可视化分析工具
+
+**性能指标**：
+- 视频处理时间 < 10秒/分钟
+- 风格对齐准确率 > 90%
+- 语义漂移检测准确率 > 85%
+
+**验收标准**：
+- 新功能通过功能测试
+- 性能指标达标
+- 代码质量符合规范
+- 文档完善
+
+### 2.3 第三阶段：高级AI功能（3-4周）
+
+**目标**：实现高级AI功能，提升系统智能化水平。
+
+**技术栈**：
+- TypeScript
+- OpenAI API (GPT-4o)
+- 联邦学习框架
+- 图神经网络 (可选)
+
+**具体任务**：
+1. **实现联邦学习模型**
+   - 设计联邦学习架构
+   - 实现模型训练和聚合
+   - 提供模型性能监控
+
+2. **增强AGI功能**
+   - 实现多任务协同
+   - 提升决策能力
+   - 实现自主学习机制
+
+3. **安全相关AI功能**
+   - 增强侵权风险检测
+   - 实现内容安全审核
+   - 提供安全风险评估
+
+**性能指标**：
+- 联邦学习模型准确率 > 95%
+- AGI任务完成率 > 90%
+- 安全检测准确率 > 98%
+
+**验收标准**：
+- 高级功能通过集成测试
+- 性能指标达标
+- 系统稳定性良好
+- 文档和测试覆盖完整
+
+## 3. 技术实现要点
+
+### 3.1 代码结构优化
+
+1. **模块化设计**
+   - 将AI功能按模块划分
+   - 实现松耦合的服务架构
+   - 提供统一的API接口
+
+2. **性能优化**
+   - 实现异步处理
+   - 优化内存使用
+   - 减少网络延迟
+
+3. **可靠性保障**
+   - 实现错误处理和重试机制
+   - 提供降级方案
+   - 增加监控和日志
+
+### 3.2 数据管理
+
+1. **数据预处理**
+   - 实现数据清洗和标准化
+   - 优化数据存储结构
+   - 提供数据质量监控
+
+2. **模型管理**
+   - 实现模型版本控制
+   - 提供模型性能评估
+   - 支持模型部署和回滚
+
+### 3.3 安全性
+
+1. **API安全**
+   - 实现API密钥管理
+   - 提供请求频率限制
+   - 增加安全审计日志
+
+2. **数据安全**
+   - 实现数据加密
+   - 提供访问控制
+   - 符合数据隐私法规
+
+## 4. 风险评估与应对策略
+
+### 4.1 技术风险
+
+1. **API调用限制**
+   - 风险：OpenAI API调用频率限制
+   - 应对：实现请求队列和节流机制
+
+2. **模型性能**
+   - 风险：模型预测准确性不足
+   - 应对：持续模型评估和优化
+
+3. **系统稳定性**
+   - 风险：AI功能可能影响系统稳定性
+   - 应对：实现隔离机制和监控
+
+### 4.2 业务风险
+
+1. **功能效果**
+   - 风险：AI功能可能不符合业务预期
+   - 应对：持续业务反馈和调整
+
+2. **成本控制**
+   - 风险：API调用成本可能过高
+   - 应对：实现成本监控和优化
+
+3. **合规性**
+   - 风险：AI功能可能涉及合规问题
+   - 应对：遵守相关法规和最佳实践
+
+## 5. 实施计划
+
+### 5.1 资源需求
+
+1. **人力资源**
+   - 前端开发：1人
+   - 后端开发：2人
+   - AI专家：1人
+
+2. **硬件资源**
+   - 开发服务器：2台
+   - 测试环境：1套
+   - 生产环境：按需扩展
+
+### 5.2 时间规划
+
+| 阶段 | 时间 | 主要任务 |
+|------|------|----------|
+| 第一阶段 | 1-2周 | 核心AI功能优化 |
+| 第二阶段 | 2-3周 | 扩展AI功能 |
+| 第三阶段 | 3-4周 | 高级AI功能 |
+| 测试与部署 | 1周 | 系统测试和部署 |
+
+### 5.3 质量保证
+
+1. **测试策略**
+   - 单元测试：覆盖核心功能
+   - 集成测试：验证模块间交互
+   - 性能测试：确保性能指标达标
+
+2. **代码审查**
+   - 代码质量检查
+   - 安全漏洞扫描
+   - 性能瓶颈分析
+
+3. **监控与维护**
+   - 实时监控系统运行状态
+   - 定期性能评估
+   - 及时响应和修复问题
+
+## 6. 预期成果
+
+1. **功能成果**
+   - 优化后的核心AI功能
+   - 新增的扩展AI功能
+   - 实现的高级AI功能
+
+2. **性能成果**
+   - 提升的系统响应速度
+   - 降低的API调用成本
+   - 提高的系统稳定性
+
+3. **业务成果**
+   - 增强的用户体验
+   - 提升的业务效率
+   - 增加的竞争优势
+
+## 7. 结论
+
+本分阶段实现策略旨在有序推进AI功能的开发和优化，确保系统稳定性和性能的同时，满足业务需求。通过明确的目标、技术栈选择、性能指标和验收标准，确保功能迭代的质量和效率。
--- a/docs/05_AI/03_Module_List.md
+++ b/docs/05_AI/03_Module_List.md
@@ -1,173 +0,0 @@
-# AI模块清单与说明
-
-## 已实现的方法
-1. **chat** - 处理AI对话/命令
-   - 路径: `POST /ai/chat`
-   - 说明: 接收用户消息，调用AGI服务处理指令，返回AI回复和可执行建议
-
-## 未实现的方法（抽象或过时）
-
-### 核心AI功能
-2. **getFederatedMetrics** - 联邦学习指标
-   - 路径: `GET /ai/federated/metrics`
-   - 说明: 获取联邦学习相关指标
-
-3. **getAnalysisContext** - AI经营分析上下文
-   - 路径: `GET /ai/analysis/context`
-   - 说明: 获取AI经营分析的上下文信息
-
-4. **getAnalysisPrompt** - AI经营分析提示
-   - 路径: `GET /ai/analysis/prompt`
-   - 说明: 获取AI经营分析的提示信息
-
-### AI决策可解释性
-5. **getDecisionLogicChain** - AI决策逻辑链
-   - 路径: `GET /ai/decision/logic/:traceId`
-   - 说明: 获取AI决策的逻辑链
-
-6. **getDecisionNarrative** - AI决策叙述
-   - 路径: `GET /ai/decision/narrative/:traceId`
-   - 说明: 获取AI决策的叙述性解释
-
-7. **getDecisionTraces** - AI决策追踪
-   - 路径: `GET /ai/decision/traces`
-   - 说明: 获取AI决策的追踪记录
-
-8. **getDecisionSummary** - AI决策摘要
-   - 路径: `GET /ai/decision/summary`
-   - 说明: 获取AI决策的摘要信息
-
-9. **streamNarrative** - 流式叙述
-   - 路径: `GET /ai/decision/narrative/:traceId/stream`
-   - 说明: 流式输出AI决策的叙述
-
-### 情感分析与评论生成
-10. **analyzeSentiment** - 情感分析
-    - 路径: `POST /ai/sentiment/analyze`
-    - 说明: 分析文本的情感倾向
-
-### 风格自动对齐
-11. **alignStyle** - 风格对齐
-    - 路径: `POST /ai/style/align`
-    - 说明: 自动对齐商品风格
-
-### 视频自动切片与卖点提取
-12. **processVideo** - 视频处理
-    - 路径: `POST /ai/video/highlight`
-    - 说明: 自动切片视频并提取卖点
-
-### 语义漂移检测
-13. **detectSemanticDrift** - 语义漂移检测
-    - 路径: `POST /ai/semantic/drift-detect`
-    - 说明: 检测语义的漂移情况
-
-### 安全相关
-14. **scanPrompt** - Prompt安全扫描
-    - 路径: `POST /ai/security/prompt-scan`
-    - 说明: 扫描Prompt指令的安全性
-
-15. **runTEEProtectedTask** - TEE硬件隔离任务
-    - 路径: `POST /ai/security/tee-execute`
-    - 说明: 在TEE环境中执行任务
-
-16. **initiateDIDHandshake** - DID安全握手
-    - 路径: `POST /ai/security/did-handshake`
-    - 说明: 执行DID安全握手
-
-17. **toggleKillSwitch** - AGI熔断控制
-    - 路径: `POST /ai/security/agi-kill-switch`
-    - 说明: 切换AGI熔断器
-
-### AGI相关
-18. **checkQuota** - 配额与熔断检查
-    - 路径: `POST /governance/quota-check`
-    - 说明: 检查配额和熔断状态
-
-19. **performStrategicAudit** - 执行战略审计
-    - 路径: `POST /agi/meta/audit`
-    - 说明: 执行战略层面的审计
-
-20. **generateLiveScript** - 生成数字人直播剧本
-    - 路径: `POST /agi/avatar/script`
-    - 说明: 生成直播脚本
-
-21. **joinSourcingAlliance** - 加入采购联盟
-    - 路径: `POST /agi/alliance/join`
-    - 说明: 加入采购联盟
-
-22. **auditContract** - 审计贸易契约
-    - 路径: `POST /agi/legal/audit`
-    - 说明: 审计贸易契约
-
-23. **performGeopoliticalAudit** - 执行地缘政治风险审计
-    - 路径: `POST /agi/geo/audit`
-    - 说明: 审计地缘政治风险
-
-24. **publishResource** - 发布跨主权资源
-    - 路径: `POST /agi/sovereign/resource/publish`
-    - 说明: 发布跨主权资源
-
-25. **findOptimalResource** - 查找最优资源
-    - 路径: `GET /agi/sovereign/resource/match`
-    - 说明: 查找最优资源
-
-26. **dispatchProductionOrder** - 分配生产任务
-    - 路径: `POST /agi/manufacturing/dispatch`
-    - 说明: 分配生产任务
-
-27. **initiateSettlement** - 启动结算流程
-    - 路径: `POST /agi/settlement/initiate`
-    - 说明: 启动结算流程
-
-28. **issueCarbonCredit** - 签发碳信用
-    - 路径: `POST /agi/sovereign/carbon/issue`
-    - 说明: 签发碳信用
-
-29. **detectCrisis** - 检测潜在危机
-    - 路径: `POST /agi/sovereign/crisis/detect`
-    - 说明: 检测潜在危机
-
-30. **injectCapital** - 注入资本
-    - 路径: `POST /agi/sovereign/fund/inject`
-    - 说明: 注入资本
-
-31. **generateReputationToken** - 生成声誉令牌
-    - 路径: `POST /agi/sovereign/reputation/token`
-    - 说明: 生成声誉令牌
-
-32. **performStrategyAudit** - 进行策略审计
-    - 路径: `POST /agi/strategy/audit`
-    - 说明: 进行策略审计
-
-33. **adoptStrategyPivot** - 采用策略转折
-    - 路径: `POST /agi/strategy/adopt`
-    - 说明: 采用策略转折
-
-34. **orchestrateFulfillment** - 编排履约流程
-    - 路径: `POST /agi/fulfillment/orchestrate`
-    - 说明: 编排履约流程
-
-### 数据湖相关
-35. **optimizeDataLake** - 优化数据湖
-    - 路径: `POST /datalake/optimize`
-    - 说明: 优化数据湖
-
-36. **migrateColdData** - 迁移冷数据
-    - 路径: `POST /datalake/tiering`
-    - 说明: 迁移冷数据
-
-37. **reportMetric** - 上报指标
-    - 路径: `POST /metrics/report`
-    - 说明: 上报指标
-
-## 建议
-
-这些未实现的方法大多是：
-1. **高度抽象的AGI功能** - 如自我进化、认知画像等
-2. **复杂的企业级功能** - 如跨主权资源共享、危机管理等
-3. **高级AI功能** - 如视频处理、语义漂移检测等
-
-**建议删除这些未实现的路由**，因为：
-1. 它们导致编译错误
-2. 没有实际功能实现
-3. 阻碍后端服务器启动