🚀 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/

💡 产品哲学

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