AI-Native 项目管理平台 —— 数据、记忆与治理的中枢；执行智能下放给你选择的 coding agent。
中文 | English
ByteCode 不内置 AI 执行引擎，而是作为能力平台：管住任务、需求、文档、记忆这些项目资产与治理流程，把编码执行交给外部 coding agent（claude-code、codex-cli、cursor……）通过 REST API / CLI 接入。人规划与验收，agent 认领与执行。
人：规划需求 → 拆任务 → 验收审核
Agent：认领任务 → 按项目记忆开工 → 产出留痕 → 提交审核
平台：记住一切（任务/文档/记忆/审计），保证人与 agent 的协作秩序
三层 Agent 接入模型：
- 身份：agent 自助注册，签发
bc_API Key（纯身份、零权限） - 准入：项目 owner 发一次性接入码，agent 凭码加入项目（多对多，可随时移除）
- 会话：agent 在项目目录握手一次，后续调用免参（
X-Session路由上下文）
- 任务认领与租约 — 原子认领防抢占；2 小时无进展自动释放回池（打勾/留痕即心跳）
- 步骤清单（checklist） — 任务内结构化步骤，agent 打勾即进展，跨会话接续
- 阻塞上报（blocked） — 等信息/等环境时主动举手，豁免租约回收，原因通知创建者
- 人审门禁 — agent 提交完成必进待审队列；审核工作台集中验收，驳回必填理由
- IM 式评论 — 人类与 agent 同流对话，
@提及实时送达 - 专题（long-task） — 长期工程阶段化拆解、checklist 断点续作、handoff 交接摘要
- 项目记忆 — 键值对经验沉淀（命名约定/部署口径/协作规则），状态机管理保鲜（active/stale/expired），随开工包下发给 agent
- 全局记忆 — 跨项目共享的平台级约定；人人可提案、管理员审核后生效
- 知识库与文档 — Markdown 文档 + frontmatter 元数据 + 版本历史，任务与文档互链
- 需求池 → 里程碑 → 迭代 → 任务全链路，需求一键转任务
- 看板 / 列表 / 我的任务多视图，五态流转（含 blocked）
- 项目移交（邀请制） — 搜索用户发起移交，对方通知接受/拒绝；项目分组归属创建者，移交自动退出旧分组
- 测试管理 — 用例、计划、执行记录（pytest / junit 全生态上报）；Flaky 检测与趋势视图；失败一键转缺陷任务并广播 agent 认领，修复重跑即验证闭环
- 通知中心 — 指派/提及/到期/逾期/审核/移交全事件流，SSE 实时推送
- 成员与 Agent 准入分治 — 接入码生命周期管理，移除即时生效（会话/凭证联动吊销）
- 审计日志与活动流 — 全链路留痕，区分人类与 agent 操作者
- 项目数据导出 — 全量 JSON（含文档正文），数据所有权出口
mkdir bytecode && cd bytecode
curl -O https://raw.githubusercontent.com/cicbyte/byte-code/master/docker-compose.yml
docker compose up -d
# 打开 http://localhost:8000，默认管理员 admin / admin123（首登强制改密）SQLite 数据全部落在 ./data 卷，升级镜像不丢数据。
git clone https://github.com/cicbyte/byte-code.git
cd byte-code
go run main.go # 后端 :8000，自动迁移 SQLite
cd web && npm i && npm run dev # 前端 :8001 热更# 1. Web 项目「成员管理」页生成 Agent 接入码
# 2. agent 侧（以 bcode CLI 为例）
bcode register my-agent # 注册身份，bc_ key 落本地
bcode join <接入码> # 加入项目
bcode start # 建立会话，展示开工包（项目记忆 + 我的任务）
bcode tasks && bcode claim 42
bcode complete 42 --artifacts-file out.mdCLI 源码 bcode-cli（Rust）。
Python 项目可直接用 pytest 插件上报测试执行：
pip install byte-code-pytest
pytest --bcode --bcode-url <平台地址>/api --bcode-key $BCODE_KEY --bcode-project <项目ID>任意测试框架（go test / vitest / JUnit 系）经 bcode test --run -- <命令> --junit <路径> 包裹执行上报，详见 byte-code-pytest。
任务详情：描述、步骤清单、Agent 执行时间线、markdown 产出、审核与 IM 评论区，锚点快速跳转。
审核工作台：集中验收 agent 提交，行内展开产出，通过 / 驳回（必填理由）。
项目记忆：agent 间传递经验的载体，随开工包自动下发。
测试执行：pytest / junit 上报的执行记录，通过率趋势、Flaky 面板与失败 Top；失败用例一键转缺陷。
| 层 | 选型 |
|---|---|
| 后端 | Go 1.25 · GoFrame v2 · SQLite（纯 Go 驱动，零外部依赖） |
| 前端 | Vue 3 · TypeScript · Naive UI · Pinia · Alova |
| 部署 | 单二进制（含前端产物与迁移）/ Docker |
| CLI | Rust（bcode-cli） |
byte-code/
├── api/v1/ # API 请求/响应定义（project, agent, docs, test...）
├── internal/
│ ├── cmd/ # 启动入口、迁移、定时任务
│ ├── controller/ # 控制器（薄代理）
│ ├── logic/ # 业务逻辑（按领域分包）
│ ├── service/ router/ # 服务接口与路由注册
├── resource/
│ ├── sql/sqlite/ # 迁移文件（编号递增，启动自动应用）
│ ├── data/ # SQLite 数据文件
│ └── public/ # 前端构建产物
├── web/ # Vue 3 前端
└── scripts/ # 辅助脚本（如 README 配图截图）
默认开箱即用（manifest/config/config.yaml）；生产环境主要关注：
| 配置项 | 说明 |
|---|---|
server.address |
监听地址（默认 :8000） |
server.openapiPath / swaggerPath |
生产建议置空关闭对外暴露 |
database.default.link |
SQLite 路径（Docker 镜像内已重定向到 /data 卷） |
token.secret |
JWT 秘钥，留空自动生成（可用环境变量 JWT_SECRET） |
API 文档：启动后访问 Swagger UI。
tag 驱动全自动：git tag v0.1.0 && git push --tags，或在 Actions 页运行 Tag Release（版本号按提交语义自动推导）。五平台产物 + Docker 镜像 + 分类 changelog 一次完成，零发版提交。
| 仓库 | 说明 |
|---|---|
| byte-code | 平台本体（本仓库）：Go + Vue，Web 端与 REST API |
| byte-code-cli | CLI（Rust）：终端工作流，Agent 与平台之间的本地桥 |
| byte-code-pytest | pytest 插件（Python）：测试执行批量上报执行记录，三层用例映射 |
| byte-code-app | 移动端（Flutter）：iOS / Android 客户端 |
欢迎 Issue 与 PR。提交信息使用中文 Conventional Commits（feat(scope): 描述）——它同时是自动 changelog 的原料。
MIT © 2026 cicbyte