Skip to content

README.md

Latest commit

 

History

History
107 lines (68 loc) · 4.66 KB

README.md

File metadata and controls

107 lines (68 loc) · 4.66 KB
Raw

byte_code_app

ByteCode 平台的移动客户端——任务审核、通知中心、项目记忆装进口袋，人随时随地规划与验收，Agent 在线执行。

中文 | English

Flutter Platform

ByteCode 是 AI-Native 项目管理平台（数据、记忆与治理中枢），本仓库是它的 Flutter 移动端：对接平台 REST API，面向"人"的移动场景——审工作、看任务、收通知、切环境。

相关仓库

  • byte-code — AI-Native 项目管理平台（Go 后端 + Vue Web 端）
  • byte-code-cli — 平台命令行客户端
  • byte-code-app — 移动客户端（Flutter，本仓库）

界面一览

真机实测（Android 13）：

登录 工作台 任务 任务详情
登录 工作台 任务 任务详情
审核 通知 我的 服务器切换
审核 通知 我的 服务器切换

功能特性

多服务器实例

  • 开发 / 测试 / 生产多环境一键切换，地址 + 备注仅存本机
  • token 与实例绑定：切换实例自动处理登录态（切走登出、切回有效会话自动恢复）

任务全景

  • 工作台四格统计（进行中 / 阻塞 / 待审 / 待处理）、待你审核、我的任务、项目记忆
  • 任务列表六态筛选 + 关键字搜索 + 快速创建
  • 任务详情：描述 / 产出 / 步骤清单（打勾即进展）/ 执行日志 / 评论；认领、完成、上报与解除阻塞

人审工作台

  • Agent 提交的任务集中待审，产出与完成清单一目了然
  • 通过 / 驳回（必填理由），结果自动通知执行方

通知中心

  • 全部 / 未读筛选，类型着色，点击已读、全部已读，未读数角标

项目切换

  • 多项目一键切换，各页面数据联动刷新

快速开始

前置：byte-code 后端已运行（默认 http://<host>:8000，管理员 admin/admin123 首登改密），本机 Flutter 3.47+。

flutter pub get
flutter run                 # 选已连接设备/模拟器
flutter analyze && flutter test   # 15 个单测/组件测试

App 内「服务器管理」添加后端地址即可登录使用。

真机联调后端

后端在本机 Docker（localhost:8000）时，手机经 USB 访问需端口反向：

adb reverse tcp:8000 tcp:8000
# App 服务器管理里添加 localhost:8000；局域网直连可用 <电脑IP>:8000

App 已开启明文 HTTP（usesCleartextTraffic）。

打包与发版

./scripts/build-apk.sh          # 本地一键出包 → dist/byte_code_app_v<版本>.apk
                                # 版本自动取最近 git tag（无 tag 则 0.0.1），可显式传入

CI 发版（tag 驱动，同 byte-code 机制）：Actions 运行 Tag Release（版本按提交语义自动推导：有 feat → minor，仅 fix/chore → patch），tag 推送后自动 analyze + test 门禁 → 构建 release APK（版本经 --build-name 注入，不改 pubspec）→ 生成中文分类 changelog → GitHub Release。详见 .github/workflows/。

release 暂用 debug 签名（可直接安装，不适合公开分发）；正式分发前需在 build.gradle.kts 配置正式签名。

技术栈与架构

Flutter 3.47 / Dart 3，dio + provider + shared_preferences，零原生插件。

lib/
├── main.dart            # 入口：Session 初始化 + 登录态守卫（token 与实例绑定）
├── core/
│   ├── ui.dart          # 设计 token（与 Web 端/原型同源的 #16a34a 主题）、StatusTag 等
│   ├── session.dart     # 全局会话：服务器实例 / token / 当前项目 / 用户（持久化）
│   └── api.dart         # dio 客户端：{code,message,data} 解包、401 处理、中文错误
├── models/models.dart   # Task/Project/Memory/Notification/Comment 实体
└── pages/               # 9 屏：login / server / home_shell(5 Tab) / work / tasks /
                         #        task_detail / review / notify / me / projects