# 一刻工坊 (KKmusic) - LLM 文档索引
# 更新时间: 2025-12-21
# 版本: V3.1

> 本文件专为大语言模型设计，提供一刻工坊文档站的结构化索引。

## 关于一刻工坊

一刻工坊是一个 AI 驱动的短视频内容创作平台，核心价值是"让内容生产从手工作坊进化为智能工厂"。

### 核心能力
- 日产能提升 25 倍（2条/天 → 50条/天）
- 成本节约 99%（¥50/条 → ¥0.5/条）
- 培训周期缩短 90%（2周 → 1天）

### 技术栈
- 前端: Vue 3 + Element Plus + Vite
- 后端: Node.js + Express + Sequelize
- AI: LangGraph + OpenAI/甄甄 + RAG
- 外部服务: ComfyUI + Fish Audio + Suno

---

## 文档目录

### 1. 产品书 (Product Book)
路径: /product_book/
内容: 产品定位、用户画像、功能架构、业务逻辑
适合: 产品经理、投资人、合作伙伴
重点章节:
- 品牌与定位体系
- 用户画像与场景（3类用户、6大垂类）
- 核心功能模块（7大模块详解）
- 系统边界与非目标

### 2. 技术白皮书 (Tech Whitepaper)
路径: /tech_whitepaper/
内容: 系统架构、数据流、核心功能技术实现
适合: 后端开发、架构师、DevOps
重点章节:
- 系统架构（前后端分离、微服务）
- 关键数据流（任务执行、知识库问答）
- 任务状态机与重试策略
- 核心功能技术实现（9.1-9.7）
- 性能基准（QPS、P95延迟、GPU利用率）

### 3. 使用手册 (User Manual)
路径: /user_manual/
内容: 操作指南、最佳实践、避坑指南
适合: 内容创作者、新媒体运营
重点章节:
- 10分钟出第一条视频
- 灵感采集与批量导入
- 知识库构建与RAG问答
- 多端协同（PC+手机）
- 常见问题FAQ

### 4. 部署手册 (Deployment Guide)
路径: /deployment_guide/
内容: 环境配置、部署步骤、监控告警
适合: 运维工程师、SRE
重点章节:
- 服务依赖与版本要求
- 完整环境变量表（40+配置项）
- 完整部署实战（8.1-8.6）
- 监控告警配置（Prometheus+Grafana）

### 5. 方案书 (Business Deck)
路径: /business_deck/
内容: 商业提案、定价策略、客户案例
适合: 销售、商务拓展、MCN负责人
重点章节:
- 痛点与量化数据
- 解决方案与技术壁垒
- 6大垂类场景案例
- 完整定价表（5个档位）
- 真实客户案例（3个）

### 6. 功能矩阵 (Feature Matrix)
路径: /feature_matrix
内容: 完整功能清单、前后端代码文件对照
适合: 全员

---

## 完整文档获取

如需获取所有文档的完整内容（适合 RAG 向量化或批量分析），请访问：

完整文档合集: /llms-full.md
格式: Markdown
大小: 约 5000+ 行
内容: 产品书 + 技术白皮书 + 使用手册 + 部署手册 + 方案书

---

## 关键技术概念

### RAG 知识库
- Markdown-Aware Sliding Window 分块算法
- 窗口大小: 1000字符，重叠: 180字符
- Mandatory Citation 强制引用机制
- Rerank 二次排序提升召回率

### 任务状态机
PENDING → QUEUED → RUNNING → SUCCESS/FAILED
- 重试策略: 指数退避（1s → 2s → 4s）
- 幂等保护: Request ID 去重
- 断点续传: Redis 缓存中间结果

### AI Agent 体系
- StrategyAgent: 策略蓝图生成
- VisualAgent: 视觉设计与分镜
- WritingAgent: 脚本二创
- SchedulerAgent: 任务调度
- PostProductionAgent: 后期合成

### 工作流引擎
- Node (简单任务)
- LangGraph (复杂多步骤)
- N8N (定时触发)
- Flowise (RAG对话)

---

## API 接口概览

### 核心接口
- POST /api/auth/login - 用户登录
- GET /api/projects - 获取项目列表
- POST /api/tasks - 创建任务
- POST /api/knowledge/ask - 知识库问答
- POST /api/langgraph/run - 执行 LangGraph 工作流

### 批量操作
- POST /api/batch/collect - 批量采集
- POST /api/batch/run - 执行批量任务
- GET /api/batch/:id/status - 查询批量任务状态

### 内容生成
- POST /api/generate/script - 生成脚本
- POST /api/generate/visual - 生成视觉方案
- POST /api/voiceover/generate - 生成配音

---

## 联系方式

- 文档站: https://landi.asia
- 技术文档: /tech_whitepaper/
- API文档: /tech_whitepaper/#api-接口
- 部署支持: /deployment_guide/

---

# 使用说明

本文件 (llms.txt) 提供站点结构索引。
如需完整内容，请读取 /llms-full.md 文件。

建议用法:
1. 先读取本文件了解文档结构
2. 根据需要读取特定章节或完整文档
3. 使用 /llms-full.md 进行向量化或批量分析