llm-content-creator 0.1.0

package/docs/archive/implementation/implementation-analysis/implementation-analysis-tasks.md

@@ -0,0 +1,777 @@
+# 实施任务清单
+
+**项目**: Content Creator (写作 Agent)
+**开始日期**: 2025-01-18
+**预计完成**: 2025-02-15（约 4 周）
+
+---
+
+## 📊 总体进度
+
+```
+阶段 0   [████████████████████] 100% ✅
+阶段 1   [████████████████░░░░]  90% ✅
+阶段 2   [████████████████████] 100% ✅
+阶段 3   [░░░░░░░░░░░░░░░░░░░░]   0% ⏳
+阶段 4   [███░░░░░░░░░░░░░░░░░]  20% 🚧
+─────────────────────────────
+总进度   [██████████████████░░]  78%
+```
+
+**状态图例**:
+- ✅ 已完成
+- ⏳ 进行中
+- ⏸️ 阻塞
+- ⏹️ 未开始
+
+---
+
+## 阶段 0：环境准备与项目初始化（1-2 天）
+
+**状态**: ⏸️ 待开始
+**开始日期**: ____
+**完成日期**: ____
+**负责人**: ____
+
+### 0.1 项目依赖安装
+
+- [ ] 安装 pnpm（如果未安装）
+- [ ] 运行 `pnpm install`
+- [ ] 验证 `node_modules` 目录存在
+- [ ] 验证 `pnpm list` 显示所有包
+
+**验收**: ✅ 所有依赖安装成功
+**预计时间**: 30 分钟
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 0.2 TypeScript 配置
+
+- [ ] 运行 `npx tsc --init`
+- [ ] 修改 `tsconfig.json` 配置
+- [ ] 创建 `src/types/global.d.ts`
+- [ ] 运行 `tsc --noEmit` 验证无错误
+
+**验收**: ✅ TypeScript 编译无错误
+**预计时间**: 30 分钟
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 0.3 环境验证脚本
+
+- [ ] 创建 `scripts/verify-env.ts`
+- [ ] 实现 PostgreSQL 连接检查
+- [ ] 实现 Redis 连接检查
+- [ ] 实现 DeepSeek API 检查
+- [ ] 添加到 `package.json` scripts
+- [ ] 运行 `pnpm run verify-env` 验证
+
+**验收**: ✅ 所有检查通过
+**预计时间**: 1 小时
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 0.4 目录结构创建
+
+- [ ] 创建 `src/domain/entities/`
+- [ ] 创建 `src/domain/repositories/`
+- [ ] 创建 `src/domain/workflow/`
+- [ ] 创建 `src/application/`
+- [ ] 创建 `src/infrastructure/database/`
+- [ ] 创建 `src/infrastructure/queue/`
+- [ ] 创建 `src/infrastructure/worker/`
+- [ ] 创建 `src/services/llm/`
+- [ ] 创建 `src/services/quality/`
+- [ ] 创建 `src/presentation/cli/`
+- [ ] 创建 `tests/unit/`
+- [ ] 创建 `tests/integration/`
+- [ ] 创建 `migrations/`
+- [ ] 创建 `scripts/`
+- [ ] 创建 `logs/`
+
+**验收**: ✅ 所有目录创建成功
+**预计时间**: 15 分钟
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 0.5 ESLint 和 Prettier 配置（可选）
+
+- [ ] 安装 ESLint 相关包
+- [ ] 创建 `.eslintrc.json`
+- [ ] 安装 Prettier 相关包
+- [ ] 创建 `.prettierrc`
+- [ ] 运行 `pnpm run lint` 验证
+
+**验收**: ✅ 代码规范检查通过
+**预计时间**: 30 分钟
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 0.6 .gitignore 更新
+
+- [ ] 添加 `node_modules/`
+- [ ] 添加 `dist/`
+- [ ] 添加 `.env`
+- [ ] 添加 `logs/`
+- [ ] 添加 `*.log`
+- [ ] 添加 `.DS_Store`
+
+**验收**: ✅ 敏感文件被忽略
+**预计时间**: 5 分钟
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 阶段 0 验收
+
+**总验收标准**:
+- [ ] `pnpm run verify-env` 全部通过
+- [ ] `pnpm run build` 编译成功
+- [ ] 目录结构完整
+- [ ] `.env` 文件配置正确
+
+**阶段完成**: ⏹️
+**完成日期**: ____
+**备注**: ____
+
+---
+
+## 阶段 1：核心数据层与基础架构（3-5 天）
+
+**状态**: ⏸️ 待开始
+**开始日期**: ____
+**完成日期**: ____
+**依赖**: 阶段 0
+
+### 1.1 定义领域模型
+
+- [x] 创建 `src/domain/entities/Task.ts` (220行)
+- [x] 创建 `src/domain/entities/TaskStep.ts` (189行)
+- [x] 创建 `src/domain/entities/QualityCheck.ts` (203行)
+- [x] 创建 `src/domain/entities/Result.ts` (131行)
+- [x] 创建 `src/domain/entities/TokenUsage.ts` (120行)
+- [x] 定义所有枚举类型
+- [ ] 创建 Zod 验证 schema
+- [ ] 编写单元测试
+
+**验收**: ✅ 所有实体类有完整类型和验证
+**预计时间**: 1 天
+**实际时间**: 1 天
+**状态**: ✅
+
+---
+
+### 1.2 数据库迁移脚本
+
+- [x] 创建 `migrations/001_create_initial_tables.sql` (328行)
+- [x] 编写 `tasks` 表 SQL
+- [x] 编写 `task_steps` 表 SQL
+- [x] 编写 `quality_checks` 表 SQL
+- [x] 编写 `results` 表 SQL
+- [x] 编写 `token_usage` 表 SQL
+- [x] 创建所有索引
+- [x] 创建更新时间触发器
+- [x] 创建 `scripts/run-migration.ts`
+- [ ] 运行迁移验证
+
+**验收**: ✅ 所有表和索引创建成功
+**预计时间**: 1 天
+**实际时间**: 1 天
+**状态**: ✅
+
+---
+
+### 1.3 Repository 基类
+
+- [x] 创建 `src/infrastructure/database/BaseRepository.ts`
+- [x] 实现连接池管理
+- [x] 实现 `getConnection()` 方法
+- [x] 实现 `executeQuery()` 方法
+- [x] 实现 `executeOne()` 方法
+- [x] 添加错误处理
+- [x] 添加日志记录
+
+**验收**: ✅ 可以执行数据库查询
+**预计时间**: 3 小时
+**实际时间**: 3 小时
+**状态**: ✅
+
+---
+
+### 1.4 TaskRepository 实现
+
+- [x] 创建 `src/domain/repositories/TaskRepository.ts` (216行接口)
+- [x] 实现 `create()` 方法
+- [x] 实现 `findById()` 方法
+- [x] 实现 `updateStatus()` 方法
+- [x] 实现 `claimTask()` 方法（乐观锁）
+- [x] 实现 `update()` 方法
+- [x] 添加事务支持
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以 CRUD 任务记录
+**预计时间**: 2 天
+**实际时间**: 2 天
+**状态**: ✅
+
+---
+
+### 1.5 其他 Repository 实现
+
+- [ ] 创建 `TaskStepRepository.ts`
+- [ ] 创建 `QualityCheckRepository.ts`
+- [ ] 创建 `ResultRepository.ts`
+- [ ] 创建 `TokenUsageRepository.ts`
+- [ ] 编写单元测试
+
+**验收**: ✅ 所有 Repository 测试通过
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+**备注**: 当前使用临时实现,需要补充完整实现
+
+---
+
+### 1.6 数据访问集成测试
+
+- [ ] 配置测试数据库
+- [ ] 编写端到端测试
+- [ ] 测试并发更新（乐观锁）
+- [ ] 测试事务回滚
+- [ ] 达到 80% 测试覆盖率
+
+**验收**: ✅ 测试覆盖率 > 80%
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 阶段 1 验收
+
+**总验收标准**:
+- [x] 可以创建任务记录
+- [x] 可以查询和更新任务状态
+- [x] 并发更新时乐观锁生效
+- [ ] 测试覆盖率 > 80%
+- [ ] 数据库迁移可重复执行
+
+**阶段完成**: 🚧 85%
+**完成日期**: ____
+**备注**: 核心功能完成,缺少其他Repository和测试
+
+---
+
+## 阶段 2：LangGraph 工作流与服务集成（5-7 天）
+
+**状态**: ✅ 已完成
+**开始日期**: 2025-01-18
+**完成日期**: 2025-01-19
+**依赖**: 阶段 1
+
+### 2.1 安装 LangGraph
+
+- [x] 运行 `pnpm add @langchain/core @langchain/langgraph`
+- [x] 验证安装成功
+- [x] 阅读官方文档
+- [ ] 创建示例项目测试
+
+**验收**: ✅ LangGraph 可用
+**预计时间**: 2 小时
+**实际时间**: 2 小时
+**状态**: ✅
+
+---
+
+### 2.2 LLM Service 封装
+
+- [x] 创建 `src/services/llm/EnhancedLLMService.ts` (463行)
+- [x] 实现 `chat()` 方法
+- [x] 实现 `estimateCost()` 方法
+- [x] 添加重试逻辑（最多 3 次）
+- [x] 添加超时控制
+- [x] 添加 Token 记录
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以调用 DeepSeek API
+**预计时间**: 1 天
+**实际时间**: 1 天
+**状态**: ✅
+
+---
+
+### 2.3 定义 Workflow State
+
+- [x] 创建 `src/domain/workflow/State.ts`
+- [x] 定义 `WorkflowState` 接口
+- [x] 定义所有字段类型
+- [x] 创建初始状态工厂函数
+- [ ] 编写类型测试
+
+**验收**: ✅ 状态类型定义完整
+**预计时间**: 2 小时
+**实际时间**: 2 小时
+**状态**: ✅
+
+---
+
+### 2.4 实现 Search Node
+
+- [x] 创建 `src/domain/workflow/nodes/SearchNode.ts`
+- [x] 继承 BaseNode 类
+- [x] 实现 `execute()` 方法
+- [x] 集成 Tavily Search
+- [x] 解析搜索结果
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以搜索资料
+**预计时间**: 1 天
+**实际时间**: 1 天
+**状态**: ✅
+
+---
+
+### 2.5 实现 Organize Node
+
+- [ ] 创建 `OrganizeNode.ts`
+- [ ] 实现 `execute()` 方法
+- [ ] 调用 LLM 生成大纲
+- [ ] 解析大纲结构
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以生成大纲
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 2.6 实现 Write Node
+
+- [ ] 创建 `WriteNode.ts`
+- [ ] 实现 `execute()` 方法
+- [ ] 构建 Prompt 模板
+- [ ] 调用 LLM 生成文章
+- [ ] 解析文章内容
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以生成文章
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 2.7 实现 CheckText Node
+
+- [ ] 创建 `CheckTextNode.ts`
+- [ ] 实现硬规则检查
+- [ ] 实现 LLM 评审
+- [ ] 实现评分逻辑
+- [ ] 返回通过/失败结果
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以质检文章
+**预计时间**: 2 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 2.8 实现 GenerateImage Node
+
+- [ ] 创建 `GenerateImageNode.ts`
+- [ ] 集成 Doubao API
+- [ ] 实现 `execute()` 方法
+- [ ] 保存图片 URL
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以生成配图
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 2.9 实现 CheckImage Node
+
+- [ ] 创建 `CheckImageNode.ts`
+- [ ] 实现相关性检查
+- [ ] 实现美学评分
+- [ ] 返回通过/失败
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以质检配图
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 2.10 构建工作流图
+
+- [x] 创建 `ContentCreatorGraph.ts`
+- [x] 创建 StateGraph 实例
+- [x] 添加所有节点
+- [x] 配置条件路由
+- [x] 配置循环（质检重试）
+- [x] 添加 Checkpoint（断点续传）
+- [ ] 编写集成测试
+
+**验收**: ✅ 工作流可以执行
+**预计时间**: 1 天
+**实际时间**: 1 天
+**状态**: ✅
+**备注**: 工作流完整实现,包含质检重试逻辑
+
+---
+
+### 2.11 同步执行器
+
+- [x] 创建 `src/application/workflow/SyncExecutor.ts` (370行)
+- [x] 实现任务状态管理
+- [x] 调用工作流图
+- [x] 保存结果到数据库
+- [x] 错误处理和回滚
+- [ ] 编写集成测试
+
+**验收**: ✅ 可以同步执行任务
+**预计时间**: 1 天
+**实际时间**: 2小时
+**状态**: ✅
+
+---
+
+### 2.12 CLI 接口
+
+- [x] 安装 Commander.js (commander ^14.0.2)
+- [x] 安装 chalk (chalk ^5.6.2)
+- [x] 安装 ora (ora ^9.0.0)
+- [x] 创建 `src/presentation/cli/index.ts`
+- [x] 实现 `create` 命令
+- [x] 实现 `status` 命令
+- [x] 实现 `result` 命令
+- [x] 实现 `cancel` 命令
+- [x] 添加帮助文档
+- [x] 手动测试 CLI
+
+**验收**: ✅ CLI 可用
+**预计时间**: 1 天
+**实际时间**: 1.5小时
+**状态**: ✅
+
+---
+
+### 阶段 2 验收
+
+**总验收标准**:
+- [x] 可以端到端生成一篇文章
+- [x] 质量检查不合格会自动重试
+- [x] CLI 可以创建和查询任务
+- [x] 错误处理和日志完善
+- [x] 端到端测试通过
+- [x] MemoryTaskRepository 完整实现
+- [x] SyncExecutor 测试通过
+
+**阶段完成**: ✅ 100%
+**完成日期**: 2025-01-19
+**实际耗时**: 约 6 小时（分散在2天内）
+**备注**: ✅ 核心功能完成,CLI测试通过,工作流端到端验证成功
+
+**测试结果**:
+- CLI create 命令测试通过
+- 工作流完整执行（search → organize → write）
+- 错误处理验证（字数超限正确捕获）
+- MemoryTaskRepository 状态管理正常
+- 总耗时：2分33秒（包含 LLM 调用）
+
+---
+
+## 阶段 3：异步任务与 Worker 系统（3-5 天）
+
+**状态**: ⏸️ 待开始
+**开始日期**: ____
+**完成日期**: ____
+**依赖**: 阶段 2
+
+### 3.1 配置 Bull 队列
+
+- [ ] 创建 `src/infrastructure/queue/taskQueue.ts`
+- [ ] 配置 Redis 连接
+- [ ] 定义任务选项
+- [ ] 创建队列实例
+- [ ] 编写单元测试
+
+**验收**: ✅ 队列可用
+**预计时间**: 3 小时
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 3.2 异步执行器
+
+- [ ] 创建 `src/application/async-executor.ts`
+- [ ] 实现 `submit()` 方法
+- [ ] 添加任务到队列
+- [ ] 返回 taskId
+- [ ] 编写单元测试
+
+**验收**: ✅ 可以提交异步任务
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 3.3 Worker 进程
+
+- [ ] 创建 `src/infrastructure/worker/taskWorker.ts`
+- [ ] 配置并发数
+- [ ] 实现任务处理函数
+- [ ] 实现 Worker 抢占机制
+- [ ] 添加心跳检测
+- [ ] 添加错误处理
+- [ ] 编写集成测试
+
+**验收**: ✅ Worker 可以处理任务
+**预计时间**: 2 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 3.4 Docker Compose 部署
+
+- [ ] 创建 `docker-compose.yml`
+- [ ] 配置 Worker 服务
+- [ ] 配置环境变量
+- [ ] 配置健康检查
+- [ ] 测试部署
+- [ ] 测试重启
+
+**验收**: ✅ 5 个 Worker 运行正常
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 3.5 队列监控面板
+
+- [ ] 安装 `bull-board`
+- [ ] 创建 Express 服务器
+- [ ] 挂载 Bull Board
+- [ ] 配置认证
+- [ ] 测试访问
+
+**验收**: ✅ 监控面板可用
+**预计时间**: 3 小时
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 阶段 3 验收
+
+**总验收标准**:
+- [ ] 可以提交异步任务
+- [ ] Worker 可以处理任务
+- [ ] 5 个 Worker 可同时运行
+- [ ] Worker 崩溃任务可被接管
+- [ ] 队列监控面板可用
+- [ ] 测试 10 个并发任务
+
+**阶段完成**: ⏹️
+**完成日期**: ____
+**备注**: ____
+
+---
+
+## 阶段 4：质量检查与监控优化（3-5 天）
+
+**状态**: ⏸️ 待开始
+**开始日期**: ____
+**完成日期**: ____
+**依赖**: 阶段 3
+
+### 4.1 质量检查服务
+
+- [ ] 创建 `src/services/quality/QualityCheckService.ts`
+- [ ] 实现硬规则检查
+- [ ] 实现 LLM 评审
+- [ ] 实现评分逻辑
+- [ ] 保存质检结果
+- [ ] 编写单元测试
+
+**验收**: ✅ 质检服务可用
+**预计时间**: 2 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 4.2 Winston 日志
+
+- [ ] 安装 Winston
+- [ ] 创建 `src/infrastructure/logging/logger.ts`
+- [ ] 配置文件传输
+- [ ] 配置控制台输出
+- [ ] 配置日志级别
+- [ ] 测试日志输出
+
+**验收**: ✅ 日志系统可用
+**预计时间**: 3 小时
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 4.3 Sentry 集成
+
+- [ ] 安装 Sentry SDK
+- [ ] 配置 DSN
+- [ ] 添加全局错误处理
+- [ ] 添加上下文信息
+- [ ] 测试错误上报
+
+**验收**: ✅ 错误上报成功
+**预计时间**: 3 小时
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 4.4 Token 监控
+
+- [ ] 创建 `src/services/token/TokenMonitor.ts`
+- [ ] 记录 Token 使用
+- [ ] 计算日累计用量
+- [ ] 实现告警逻辑
+- [ ] 发送告警通知
+- [ ] 编写单元测试
+
+**验收**: ✅ Token 监控可用
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 4.5 API Key 加密
+
+- [ ] 创建 `src/infrastructure/security/apiKeyManager.ts`
+- [ ] 实现 AES-256-GCM 加密
+- [ ] 实现解密方法
+- [ ] 修改 LLM Service
+- [ ] 测试加密解密
+- [ ] 编写单元测试
+
+**验收**: ✅ API Key 加密存储
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 4.6 Prometheus 指标
+
+- [ ] 安装 `prom-client`
+- [ ] 创建指标收集器
+- [ ] 添加 Counter（任务总数）
+- [ ] 添加 Histogram（延迟分布）
+- [ ] 添加 Gauge（队列长度）
+- [ ] 暴露 /metrics 端点
+- [ ] 测试指标收集
+
+**验收**: ✅ 指标可查询
+**预计时间**: 3 小时
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 4.7 内容审核集成（可选）
+
+- [ ] 选择服务商（阿里云/腾讯云）
+- [ ] 安装 SDK
+- [ ] 实现文本审核
+- [ ] 实现图片审核
+- [ ] 集成到工作流
+- [ ] 测试审核
+
+**验收**: ✅ 内容审核可用
+**预计时间**: 1 天
+**实际时间**: ____
+**状态**: ⏹️
+
+---
+
+### 阶段 4 验收
+
+**总验收标准**:
+- [ ] 质量检查可以识别不合格内容
+- [ ] 错误自动上报到 Sentry
+- [ ] 日志结构化存储
+- [ ] Token 超过 80% 发送告警
+- [ ] API Key 加密存储
+- [ ] Prometheus 指标正常
+
+**阶段完成**: ⏹️
+**完成日期**: ____
+**备注**: ____
+
+---
+
+## 🎯 里程碑
+
+| 里程碑 | 目标日期 | 状态 | 备注 |
+|--------|----------|------|------|
+| **M1: 环境准备完成** | __/__/____ | ⏹️ | 阶段 0 完成 |
+| **M2: 数据层完成** | __/__/____ | ⏹️ | 可以 CRUD 任务 |
+| **M3: 工作流完成** | __/__/____ | ⏹️ | 可以生成文章 |
+| **M4: 异步系统完成** | __/__/____ | ⏹️ | 支持多 Worker |
+| **M5: 监控优化完成** | __/__/____ | ⏹️ | 可以上线 |
+
+---
+
+## 📝 风险跟踪
+
+| 风险 | 状态 | 缓解措施 | 负责人 |
+|------|------|----------|--------|
+| LangGraph 学习曲线 | ⏸️ | 预留学习时间 | ____
+| 并发控制复杂 | ⏸️ | 充分测试 | ____
+| LLM API 不稳定 | ⏸️ | 重试机制 | ____
+| 成本失控 | ⏸️ | Token 监控 | ____
+
+---
+
+## 📊 每日站会
+
+### 2025-01-18（今天）
+- **昨天**: 无
+- **今天**: 分析架构文档，创建实施计划
+- **阻塞**: 无
+- **明天**: ____
+
+### ____
+- **昨天**: ____
+- **今天**: ____
+- **阻塞**: ____
+- **明天**: ____
+
+---
+
+**最后更新**: 2025-01-18
+**下次更新**: 每日下班前