feat: 初始化AI写作工坊项目

- 实现基于Vue 3 + Vite的模块化架构
- 集成DeepSeek API进行内容生成
- 支持写作范式分析功能
- 添加环境变量配置支持
- 完整的项目结构和文档
This commit is contained in:
empty
2026-01-08 10:04:59 +08:00
commit 9fb3600a6a
17 changed files with 3391 additions and 0 deletions

150
README.md Normal file
View File

@@ -0,0 +1,150 @@
# 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. 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