专为开发团队打造的跨平台项目进度管理桌面客户端,基于 Tauri 2 构建。数据本地存储,无需服务器,开箱即用。
当前版本:v2.0.13 | macOS · Windows · Linux
打开应用即可看到全局概览:活跃项目数、进行中迭代、待执行 SQL、近期提交趋势,以及各项目的最新状态汇总。
- 创建项目并关联 GitLab 仓库(支持多分支)
- 一键同步 GitLab 提交记录,自动按作者邮箱过滤
- 项目详情侧边栏:查看关联迭代、待执行 SQL、提交历史
- 创建迭代周期,关联一个或多个项目
- 四阶段状态流转:规划中 → 开发中 → 测试中 → 已上线
- 迭代详情展示关联需求数、SQL 数、提交数
- 录入需求并关联迭代和项目
- 支持需求编号(如
ABC-123),提交同步时自动匹配关联 - 30 分钟内无编号提交按时间邻近自动关联
- 查看每条需求下的关联提交和 SQL 变更
- 登记待执行 SQL,关联项目和迭代
- 自定义多环境配置(如:开发、测试、预发、生产)
- 按环境标记执行状态,支持批量操作和执行撤回
- 执行日志记录操作人和时间
- 选择日期范围,自动汇总该时段的 GitLab 提交
- 按需求维度归类提交,生成结构化工作内容
- 接入 DeepSeek API 进行 AI 润色,生成专业报告
- 月历视图浏览历史报告,支持编辑和 Markdown 渲染
- 支持自定义报告模板
- 配置 DeepSeek API Key 和服务地址
- 配置全局 GitLab Token(项目级 Token 可覆盖)
- 设置 Git 作者邮箱过滤提交
- 数据导入导出(JSON 格式备份)
- 应用更新检查
从 GitHub Releases 下载对应平台的安装包:
| 平台 | 安装包格式 |
|---|---|
| macOS | .dmg |
| Windows | .msi / .exe |
| Linux | .AppImage / .deb |
首次启动后进入设置页面完成基础配置:
| 配置项 | 说明 | 是否必填 |
|---|---|---|
| Git 作者邮箱 | 过滤 GitLab 提交,只显示自己的提交 | 推荐填写 |
| 全局 GitLab Token | 访问 GitLab 仓库,需 read_api 权限 |
使用 GitLab 功能时必填 |
| DeepSeek API Key | AI 日报/周报生成 | 使用 AI 功能时必填 |
| DeepSeek API URL | 默认 https://api.deepseek.com |
可选 |
- 进入项目管理,点击右上角「新增项目」
- 填写项目名称,配置 GitLab 信息:
- GitLab 仓库地址(如
https://gitlab.com) - Access Token(项目级或全局均可)
- GitLab 项目 ID
- 默认同步分支
- GitLab 仓库地址(如
- 保存后点击「同步提交」,拉取历史提交记录
- 进入迭代管理,点击「新增迭代」
- 填写迭代名称、时间范围,选择关联项目
- 根据进度点击状态按钮推进迭代阶段
- 进入日报周报,点击「生成报告」
- 选择「日报」类型和日期
- 系统自动汇总当日 GitLab 提交,按需求归类
- 点击「AI 润色」调用 DeepSeek 生成专业报告
- 支持手动编辑后保存
新增 SQL → 选择项目/迭代 → 填写标题和 SQL 内容
→ 配置环境(开发/测试/预发/生产)
→ 执行后点击对应环境标记已执行
→ 查看执行日志
提交信息中包含需求编号时自动关联:
git commit -m "feat: 用户登录优化 [ABC-123]"
↓ 同步后自动关联到需求 ABC-123
无编号提交按时间邻近(30 分钟内)自动匹配最近的需求。
- 优先从当周已有日报聚合内容
- 无日报时回退到直接汇总 Git 提交
- 支持手动编辑调整
所有数据存储在本地 SQLite 数据库,无需网络连接(GitLab 同步和 AI 生成除外):
| 平台 | 数据库路径 |
|---|---|
| macOS | ~/Library/Application Support/devsync-hub/devsync.db |
| Windows | %APPDATA%/devsync-hub/devsync.db |
| Linux | ~/.local/share/devsync-hub/devsync.db |
导出备份:设置 → 数据管理 → 导出数据,生成 JSON 文件
导入恢复:设置 → 数据管理 → 选择 JSON 文件导入
从 Web 版迁移(PostgreSQL → 桌面版):
# 1. 安装依赖
npm install pg
# 2. 从 PostgreSQL 导出
node scripts/export-pg-data.js \
--host=localhost --port=5432 \
--db=devsync --user=postgres --password=your_password
# 3. 在客户端导入:设置 → 数据管理 → 选择导出的 JSON 文件- 应用启动时自动静默检查更新
- 也可在设置 → 基础设置 → 应用更新手动检查
- 下载安装后重启应用生效
| 层级 | 技术 |
|---|---|
| 桌面框架 | Tauri 2 |
| 后端 | Rust (rusqlite + reqwest + axum) |
| 前端 | React 19 + TypeScript + TailwindCSS |
| 状态管理 | TanStack Query v5 |
| 数据库 | SQLite (本地存储) |
| AI 集成 | DeepSeek API |
# 安装依赖
npm install
# 开发模式(前后端同时启动,支持热更新)
cargo tauri dev
# 生产构建(产物在 src-tauri/target/release/bundle/)
cargo tauri build
# 运行测试
npm run test
cd src-tauri && cargo testMIT