# 🚀 DevFlow 使用手册

"本地优先的个人创作流程驾驶舱"

### 核心流程

想法到创作成果的完整链路

    想法池 → 对抗评估 → 创作（代码/文档/PPT） → 发布/分享

评估 创作 执行 发布

## 🏃 快速开始

💻
运行应用
`bun install`
`bun run tauri dev`
💡
一句话功能
你的创作流程，本地跑，AI 辅助，数据不出门

## 🎯 核心价值链

想法 → 评估 → 创作 → 发布

💡
想法管理
收集、分类、评估创作想法
支持多种类型的创作灵感
⚖️
对抗评估
正方观点 + 反方观点 + 分析师建议
确保创作质量和价值
🎨
创作执行
代码、文档、PPT 等多种创作形式
AI 辅助和模板支持
📤
发布分享
多格式导出、版本管理
一键发布到各平台

## 📋 功能模块

聚焦核心，拒绝过设计

🤖
AI Chat
单 Provider 简化配置
工具调用：代码生成、文件操作、Git 操作
流式响应：实时输出
💡
想法池
轻量版：聚焦核心
预留对抗评估：后续升级
📂
项目管理
多项目支持
与 Git 分支联动
📚
知识库（收藏夹）
静态收集：个人经验碎片
分类管理：审查规则、Prompt 模板、踩坑经验
⚙️
设置
AI 配置：Provider、模型选择
通用设置：主题、语言

## 🌟 特色功能

🏠
本地优先
SQLite 本地数据库
基础功能离线可用
代码不出本地
⚡
实时监控
WebSocket 实时更新
工作流执行进度
错误原因分析
🔧
工作流节点
Script：执行 Shell 命令
Human：人工审批
Condition：条件判断
Parallel：并行执行

## 🎨 界面说明

颜色系统
紫色（主色）
青绿（成功）
琥珀（警告）
珊瑚（危险）
图标含义
📋 待开始 🔨 进行中 👀 待审查 ✅ 已合并 🗑️ 已废弃

## ⚠️ 注意事项

🔗
Git 集成
必须初始化 Git 仓库
配置用户邮箱和姓名
保持分支命名规范
🔌
AI 配置
需要有效的 API Key
检查网络连接
关注 Token 使用量
⚙️
工作流设计
避免长时间阻塞操作
设置合理的超时时间
保留人工干预接口

## 🔄 更新日志

✅
v1.0 (2026-06-11)
完成核心功能
任务管理系统
工作流引擎
AI Chat 集成
本地数据存储
🔄
计划功能
想法对抗式评估
更多工作流节点
团队协作功能

## ⚙️ 配置指南

AI 配置
🤖
Provider 设置
支持 OpenAI、Anthropic、DeepSeek
配置 API Key 和模型选择
⚙️
高级参数
Temperature: 0-2（创造性）
Max Tokens: 限制回答长度
Git 集成
🔗
基础配置
git config user.name/email
自动分支创建：feature/任务名
工作流配置
🔄
节点类型
script: Shell 命令
human: 人工审批
condition: 条件判断

## ❓ 常见问题

安装启动
🚀
无法启动
检查 Node.js >= 18
bun clean + bun install
确认端口 1420 可用
功能使用
💡
任务不显示
确认选中项目
刷新页面
查看控制台错误
🤖
AI 无响应
检查 API Key
确认网络连接
切换 Provider 测试
数据管理
💾
存储位置
Windows: %APPDATA%\devflow\
macOS: ~/Library/Application Support/devflow/
Linux: ~/.config/devflow/
🔧
数据备份
备份数据库：cp devflow.db backup/
备份配置：cp config.json backup/

## 💡 产品哲学

🎯
聚焦核心
不是全流程操作系统
专注于本地任务流程
简单、实用、可靠
👨‍💻
开发者第一
功能设计以开发者需求为中心
避免过工程化的设计
保留必要的扩展性