151 lines
2.9 KiB
Markdown
151 lines
2.9 KiB
Markdown
# 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
|