# AI 写作工坊 - 模块化版本

一个基于 Vue 3 + Vite 的专业 AI 写作辅助工具，支持结构化内容生成和写作范式分析。

## 技术栈

- **框架**: Vue 3 (Composition API)
- **构建工具**: Vite
- **状态管理**: Pinia
- **HTTP 客户端**: Axios
- **Markdown 解析**: Marked
- **样式**: Tailwind CSS

## 项目结构

```
src/
├── components/          # Vue 组件
│   ├── WriterPanel.vue    # 写作面板
│   ├── AnalysisPanel.vue  # 范式分析面板
│   └── MainContent.vue    # 主内容区
├── stores/              # Pinia 状态管理
│   └── app.js            # 应用主状态
├── api/                 # API 接口
│   └── deepseek.js       # DeepSeek API 封装
├── utils/               # 工具函数
│   └── promptBuilder.js  # Prompt 构建器
├── App.vue              # 根组件
└── main.js              # 入口文件
```

## 架构演进与优化

### 1. 流式输出增强 (Stream Optimization)
项目在 `DeepSeekAPI.js` 中实现了稳健的 SSE (Server-Sent Events) 解析器：
- **逐行扫描**：放弃简单的 `split` 分割，改用逐字符缓冲区扫描，确保处理被网络分包截断的 JSON 数据。
- **协议兼容**：完美支持标准 SSE 协议，兼容 data: 后有无空格的各种情况。
- **状态管理**：通过 `appStore` 统一管理生成状态，实现组件间的数据实时同步，保证 UI 渲染无延迟。

### 2. 状态管理重构
- **逻辑收拢**：将所有 API 调用和业务逻辑（生成、分析）移入 Pinia Store (`appStore.js`)。
- **组件纯粹化**：`WriterPanel` 和 `AnalysisPanel` 仅负责 UI 渲染和用户交互，不再包含核心业务逻辑。

### 3. 深度集成
- **应用到写作**：实现了从"范式分析"到"写作工坊"的深度数据迁移，包括原文引用、风格约束注入和范式模板自动匹配。

## 核心功能升级：写作第一性原理

本项目已基于写作的"第一性原理"进行了深度重构，旨在解决 AI 写作的本质矛盾：

### 1. 语义锚定 (Semantic Anchoring) - 解决"写什么"
- **大纲模式 (Outline Mode)**：提供结构化输入（核心主题、目标受众、关键观点），强制用户提供逻辑骨架，有效防止 AI 幻觉和跑题。
- **原理**：通过高确定性的逻辑约束（Logic）来引导 AI 的概率采样，实现熵减。

### 2. 风格对齐 (Style Alignment) - 解决"怎么写"
- **风格显性化**：自动分析参考案例，提取关键风格标签（如 #短句为主 #语气犀利），并在 UI 中可视化展示。
- **向量特征注入**：将提取的风格标签作为显性特征注入 Prompt，强迫 AI 输出向参考案例的向量空间偏移。

### 3. 认知模拟 (Cognition Simulation) - 解决"深度"
- **深度模式 (Deep Mode)**：引入 Agentic Workflow（智能体工作流），模拟人类"初稿 -> 批判 -> 润色"的思维链。
- **过程可视化**：在界面上实时展示 AI 的"反思"（Critique）和"修正"（Refine）过程，用计算换质量。

## 功能特性

### 1. AI 写作工坊
- 自定义写作任务输入
- 参考案例管理
- 输出规范标签系统
- 实时流式内容生成
- Prompt 调试预览

### 2. 写作范式分析
- 预设写作范式库
- 文章智能分析
- 结构化结果展示

### 3. 配置管理
- API 地址配置
- API Key 管理
- 支持多种中继平台

## 快速开始

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run dev
```

### 构建生产版本

```bash
npm run build
```

### 预览生产版本

```bash
npm run preview
```

## 配置说明

### 环境变量配置
1. 复制环境变量示例文件：
```bash
cp .env.example .env
```

2. 编辑 `.env` 文件，配置您的 API 信息：
```env
# DeepSeek API 配置
VITE_API_URL=https://api.deepseek.com/chat/completions
VITE_API_KEY=your_actual_api_key_here
```

### 支持的模型
- deepseek-chat（默认）
- 可扩展支持其他兼容 OpenAI 格式的模型

### 安全提示
- `.env` 文件已添加到 `.gitignore`，不会被提交到版本控制
- 生产环境请使用服务器环境变量或密钥管理服务

## 开发指南

### 添加新的写作范式
在 `src/components/AnalysisPanel.vue` 中的 `paradigms` 数组添加新范式：

```javascript
{
  type: 'new-type',
  name: '新范式名称',
  icon: '🎯',
  description: '描述信息',
  tags: ['标签1', '标签2'],
  tagClass: 'bg-color-900/30 text-color-300'
}
```

### 扩展 API 支持
在 `src/api/` 目录下创建新的 API 类，继承基础接口：

```javascript
import BaseAPI from './base.js'

export default class NewAPI extends BaseAPI {
  // 实现具体方法
}
```

### 自定义 Prompt 模板
在 `src/utils/promptBuilder.js` 中修改 `buildPrompt` 函数：

```javascript
export const buildPrompt = (task, constraints, references) => {
  // 自定义构建逻辑
}
```

## 部署建议

### 静态部署
- Vercel
- Netlify
- GitHub Pages

### 服务器部署
- Nginx + PM2
- Docker 容器化
- CDN 加速

## 许可证

MIT License