llm-content-creator 0.1.0

package/README.md

@@ -0,0 +1,309 @@
+# 写作 Agent (Content Creator)
+
+基于 LangGraph 的智能写作 Agent，支持选题搜索、内容生成、质量检查和配图生成，采用 PostgreSQL 数据持久化，支持同步和异步两种执行模式。
+
+---
+
+## 🎯 项目概述
+
+这是一个 AI 驱动的内容创作系统，能够自动完成从选题搜索、内容创作、质量检查到配图生成的完整流程。
+
+**核心特性**：
+- ✅ 智能写作：基于 DeepSeek API 的高质量内容生成
+- ✅ 质量检查：硬规则 + LLM 双层质量保证
+- ✅ 配图生成：自动生成匹配文章的插图
+- ✅ 多种模式：同步（立即返回）和异步（后台处理）
+- ✅ 高并发：支持 100 人同时在线，日处理 3000+ 任务
+- ✅ 高可用：多 Worker 架构，自动故障恢复
+
+---
+
+## 📚 文档导航
+
+完整文档请访问：**[📖 文档中心](./docs/README.md)**
+
+### 核心文档
+
+| 文档 | 说明 |
+|------|------|
+| [🚀 快速开始](./docs/quick-start.md) | 5 分钟快速上手指南 |
+| [📖 用户操作手册](./docs/user-guide.md) | 完整的用户使用指南 |
+| [🏗️ 系统架构设计](./docs/architecture-complete.md) | 完整的系统架构（5500+ 行） |
+| [⚙️ 工作流架构](./docs/workflow-architecture.md) | LangGraph 工作流详解 |
+| [✅ 质量检查架构](./docs/quality-check-architecture.md) | 质量检查系统设计 |
+| [💾 存储机制说明](./docs/storage-guide.md) | PostgreSQL 数据存储 |
+
+### 技术参考
+
+| 文档 | 说明 |
+|------|------|
+| [BullMQ 快速参考](./docs/references/bullmq-quick-reference.md) | 任务队列快速入门 |
+| [监控优化指南](./docs/references/monitoring-optimization-guide.md) | 系统监控和优化 |
+| [性能优化指南](./docs/references/performance-optimization-guide.md) | 应用性能调优 |
+
+### 历史文档
+
+项目开发历史已归档到：[📦 docs/archive/](./docs/archive/)
+
+---
+
+## 🚀 快速开始
+
+### 前置要求
+
+- Node.js 18+ LTS
+- PostgreSQL 14+
+- Redis 7+
+- DeepSeek API Key
+- Doubao API Key（图片生成）
+
+### 1. 克隆项目
+
+```bash
+git clone <repository-url>
+cd content-creator
+```
+
+### 2. 安装依赖
+
+```bash
+pnpm install
+```
+
+### 3. 配置环境变量
+
+复制 `.env.example`（如果存在）或创建 `.env` 文件：
+
+```bash
+# PostgreSQL
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_DB=content_creator
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=your_password
+
+# Redis
+REDIS_URL=redis://:password@localhost:6379
+
+# DeepSeek API
+LLM_BASE_URL=https://api.deepseek.com
+LLM_API_KEY=sk-your-api-key
+LLM_MODEL_NAME=deepseek-chat
+
+# Doubao API
+ARK_API_KEY=your-api-key
+```
+
+### 4. 验证环境
+
+```bash
+pnpm run verify-env
+```
+
+预期输出：
+```
+✅ 所有检查通过 (4/4)
+🎉 环境准备完成，可以开始开发！
+```
+
+### 5. 数据库迁移
+
+```bash
+pnpm run db:migrate
+```
+
+### 6. 启动开发服务器
+
+```bash
+pnpm run dev
+```
+
+---
+
+## 📖 开发指南
+
+### 项目结构
+
+```
+content-creator/
+├── src/
+│   ├── domain/              # 领域层（业务逻辑）
+│   ├── application/         # 应用层（用例编排）
+│   ├── infrastructure/      # 基础设施层
+│   ├── services/            # 服务层（外部集成）
+│   └── presentation/        # 表现层（CLI/API）
+├── tests/                   # 测试
+├── migrations/              # 数据库迁移
+├── scripts/                 # 工具脚本
+└── docs/                    # 文档
+```
+
+### 可用命令
+
+```bash
+# 开发
+pnpm run dev          # 启动开发服务器（热重载）
+pnpm run build        # 构建生产版本
+pnpm run start        # 运行生产版本
+
+# 测试
+pnpm run test         # 运行测试
+pnpm run test:ui      # 测试 UI
+pnpm run test:coverage # 测试覆盖率
+
+# 代码质量
+pnpm run lint         # ESLint 检查
+pnpm run format       # Prettier 格式化
+
+# 数据库
+pnpm run db:migrate   # 运行迁移
+pnpm run db:seed      # 填充测试数据
+
+# Worker 和监控（阶段 3）
+pnpm run worker       # 启动 Worker
+pnpm run monitor      # 启动监控面板
+pnpm run scheduler    # 启动调度器
+
+# 工具
+pnpm run verify-env   # 验证环境配置
+```
+
+---
+
+## 🏗️ 实施路线图
+
+项目分为 4 个阶段渐进式开发，所有阶段已归档到 [docs/archive/phases/](./docs/archive/phases/)
+
+### 阶段 0：环境准备与项目初始化 ✅
+- 安装依赖和工具
+- 配置 TypeScript
+- 验证所有服务连接
+
+### 阶段 1：核心数据层与基础架构 ✅
+- 领域模型定义
+- 数据库迁移
+- Repository 实现
+- 数据访问测试
+
+### 阶段 2：LangGraph 工作流与服务集成 ✅
+- LLM Service 实现
+- LangGraph 工作流
+- 同步执行器
+- CLI 接口
+
+### 阶段 3：异步任务与 Worker 系统 ✅
+- BullMQ 任务队列
+- TaskWorker 实现
+- TaskScheduler 实现
+- Bull Board 监控面板
+
+### 阶段 4：质量检查与监控优化 ✅
+- 质量检查服务
+- 监控与日志
+- 性能优化
+- 安全加固
+
+**详细开发历史**：查看 [docs/archive/phases/](./docs/archive/phases/)
+
+---
+
+## 📊 技术栈
+
+| 类别 | 技术 |
+|------|------|
+| **运行时** | Node.js 18+ |
+| **语言** | TypeScript 5.0+ |
+| **工作流引擎** | LangGraph |
+| **数据库** | PostgreSQL 14+ |
+| **缓存/队列** | Redis 7+ + Bull |
+| **LLM** | DeepSeek API |
+| **图片生成** | Doubao API |
+| **测试** | Vitest |
+| **日志** | Winston |
+| **监控** | Sentry + Prometheus |
+
+---
+
+## 🎯 设计目标
+
+### 功能目标
+- 支持内容类型：技术文章、博客文章、营销文案（可扩展）
+- 核心能力：选题搜索、内容生成、质量检查、配图生成
+- 执行模式：同步（立即返回结果）、异步（后台处理）
+
+### 性能目标
+- 单任务端到端延迟：< 5 分钟
+- 支持并发用户数：100 人同时在线
+- 支持并发任务数：20 个任务同时执行（峰值）
+- 日任务处理能力：500-3000 个任务/天
+
+### 可用性目标
+- 系统可用性：99.9%（每月停机时间 < 43 分钟）
+- Worker 故障自动恢复
+- 数据库主从复制，故障自动切换
+
+---
+
+## 🔒 安全设计
+
+- ✅ API Key 加密存储（AWS KMS）
+- ✅ 环境变量隔离
+- ✅ 内容审核集成（阿里云/腾讯云）
+- ✅ Token 监控与预算告警
+- ✅ 速率限制（防止滥用）
+
+---
+
+## 📈 监控与可观测性
+
+- **日志**：Winston 结构化日志
+- **错误追踪**：Sentry 集成
+- **指标监控**：Prometheus + Grafana
+- **队列监控**：Bull Board UI
+- **Token 监控**：实时用量统计
+
+---
+
+## 💰 成本预估
+
+基于设计目标的容量（3000 任务/天）：
+
+| 项目 | 月度成本 |
+|------|----------|
+| DeepSeek API（LLM） | ¥300-500 |
+| Doubao API（图片生成） | ¥50-100 |
+| 内容审核 | ¥7 |
+| PostgreSQL（云数据库） | ¥100-200 |
+| Redis（云缓存） | ¥50-100 |
+| 对象存储（S3/OSS） | ¥10-20 |
+| 监控服务（Sentry） | 免费额度 |
+| **总计** | **¥500-900/月** |
+
+---
+
+## 🤝 贡献指南
+
+欢迎贡献！请遵循以下步骤：
+
+1. Fork 本仓库
+2. 创建特性分支：`git checkout -b feature/your-feature`
+3. 提交更改：`git commit -m 'Add some feature'`
+4. 推送到分支：`git push origin feature/your-feature`
+5. 提交 Pull Request
+
+---
+
+## 📝 许可证
+
+MIT License
+
+---
+
+## 📞 联系方式
+
+如有问题或建议，请提交 Issue 或 Pull Request。
+
+---
+
+**最后更新**：2026-01-22
+**项目状态**：✅ 核心功能已完成

package/dist/application/workflow/SyncExecutor.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SyncExecutor - 同步执行器
+ *
+ * 负责任务的端到端同步执行
+ */
+import type { ITaskRepository } from '../../domain/repositories/TaskRepository.js';
+import type { IResultRepository } from '../../domain/repositories/ResultRepository.js';
+import type { IQualityCheckRepository } from '../../domain/repositories/QualityCheckRepository.js';
+import type { CreateTaskParams } from '../../domain/entities/Task.js';
+import { TaskStatus } from '../../domain/entities/Task.js';
+import type { ExecutorConfig, ExecutionResult, ProgressCallback } from './types.js';
+/**
+ * 同步执行器类
+ */
+export declare class SyncExecutor {
+    private taskRepo;
+    private resultRepo?;
+    private qualityCheckRepo?;
+    private config;
+    private progressCallbacks;
+    constructor(taskRepo: ITaskRepository, config?: Partial<ExecutorConfig>);
+    /**
+     * 设置结果仓储
+     */
+    setResultRepository(resultRepo: IResultRepository): void;
+    /**
+     * 设置质量检查仓储
+     */
+    setQualityCheckRepository(qualityCheckRepo: IQualityCheckRepository): void;
+    /**
+     * 创建并执行任务
+     */
+    execute(params: CreateTaskParams): Promise<ExecutionResult>;
+    /**
+     * 创建任务
+     */
+    private createTask;
+    /**
+     * 执行工作流
+     */
+    private executeWorkflow;
+    /**
+     * 保存结果
+     */
+    private saveResults;
+    /**
+     * 注册进度回调
+     */
+    onProgress(taskId: string, callback: ProgressCallback): void;
+    /**
+     * 移除进度回调
+     */
+    removeProgressCallback(taskId: string, callback: ProgressCallback): void;
+    /**
+     * 计算进度百分比
+     */
+    private calculateProgress;
+    /**
+     * 取消任务执行
+     */
+    cancel(taskId: string): Promise<boolean>;
+    /**
+     * 获取任务状态
+     */
+    getStatus(taskId: string): Promise<{
+        status: TaskStatus;
+        currentStep?: string;
+        progress: number;
+    } | null>;
+}
+/**
+ * 创建同步执行器工厂函数
+ */
+export declare function createSyncExecutor(taskRepo: ITaskRepository, config?: Partial<ExecutorConfig>): SyncExecutor;
+//# sourceMappingURL=SyncExecutor.d.ts.map

package/dist/application/workflow/SyncExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncExecutor.d.ts","sourceRoot":"","sources":["../../../src/application/workflow/SyncExecutor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAI3D,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAA0B;IACnD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,iBAAiB,CAA8C;gBAGrE,QAAQ,EAAE,eAAe,EACzB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAmBtC;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIxD;;OAEG;IACH,yBAAyB,CAAC,gBAAgB,EAAE,uBAAuB,GAAG,IAAI;IAI1E;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IA8HjE;;OAEG;YACW,UAAU;IAsBxB;;OAEG;YACW,eAAe;IAgC7B;;OAEG;YACW,WAAW;IA4FzB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAS5D;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAWxE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB9C;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,MAAM,EAAE,UAAU,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;CAYV;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EACzB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,YAAY,CAEd"}