Moyuan Code

Moyuan Code 是面向代码开发全生命周期的多 Agent 编排框架。系统在理解项目代码的基础上，把用户需求完善为可执行的 Issue Graph，调度 Claude CLI、Codex CLI 和多种模型 Provider 分工开发，并通过鉴权、质量门禁、Git、发布投产、Memory、日志和自我修复持续管理项目迭代。

当前已完成 Phase 1 本地 CLI MVP、Beta 控制面能力、Phase 2 到 Phase 27 的主要闭环；Phase 27 已通过 readiness 收口。

核心设计入口见 docs/README.md。 Phase 规划与验收记录见 docs/phases/。

项目信息

• GitHub 账号/维护角色：tiammomo
• 联系邮箱：pearfl@qq.com
• GitHub 仓库：git@github.com:tiammomo/moyuan-code.git

当前实现状态

• 控制面后端：Go。
• 后端框架基线：Gin + GORM，Phase 1 本地 State Store 使用 SQLite。
• 前端控制台：Next.js 16，默认端口 3000。
• 图像生成辅助脚本：Node.js，仅保留在 scripts/。
• Phase 1 已实现最小 CLI 骨架：workspace、auth、logging、git、project comprehension、issue graph、runtime adapter、orchestrator、scheduler、memory、repair、quality gate。
• Beta 到 Phase 27 已推进控制面 API、Issue Graph、批量并发执行、Provider Registry、runtime routing、Git Provider、release candidate、deployment execution、rollback execution、monitor summary、deployment rehearsal、release admission、deployment risk handoff、operations timeline、maintenance policy、post-deployment verification、server resource lifecycle、Console operations dashboard、operations audit export、decision ledger、durable control runner、control runner queue/window、provider write proof contract、Console observability drill-down、Console proof/admission drill-down、write admission policy、provider-specific proof pack、remote execution rehearsal runner、write review packet、control queue review gate、guarded write execution plan、write adapter dispatch scaffold、server resource registry apply receipt、SSH adapter sandbox/rollback binding、write adapter failure recovery record 和 adapter recovery queue binding。
• Runtime 已捕获 before/after git snapshot、changed files、diff summary，并能阻断脏工作区和保护路径变更。
• Claude CLI / Codex CLI 已具备 prompt file、cwd、env allowlist、provider env profile、stdout/stderr、result contract 和失败分类的最小调用契约。
• Orchestrator 已持久化 issue/run 状态机，并支持查询 accepted、needs_rework、runtime 和 quality 状态。
• Quality 已输出结构化 findings 和 review_status，能因敏感文件、保护路径、runtime 风险和大 diff 阻断 accepted。
• API/State Store 已建立 Gin router 和 GORM SQLite 基线，项目注册会同步 .moyuan/state.db。
• Memory 已具备 record gate、staging、dedup、敏感信息阻断和 compact 自动摘要。
• Repair 已具备受控 attempt、最大尝试次数、runtime 执行、quality gate、状态查询和修复经验 Memory 沉淀。
• Batch Execution 已具备 dry-run plan、受控 run、隔离 worktree、质量复核、合入队列和 Console 操作面。
• Release/Deployment 已具备 release candidate、provider preview/publish gate、PR/MR plan、deployment execution、approval proof、rollback preview、monitor summary、deployment rehearsal、release admission 和风险修复 handoff。
• 当前实现重点：Phase 27 已完成 readiness 收口，server_resource_registry_adapter 已支持本地 apply receipt，ssh_deployment_adapter 已支持执行前 sandbox 和 rollback binding，失败/人工 adapter execution 会生成 recovery record 并可绑定 control queue 人工复核；SSH/GitHub/Gitee/cloud 仍不直接执行外部真实写入。

本地运行

go test ./...
go run ./cmd/moyuan --help
./bin/moyuan --help
cd apps/console && npm run dev

如果本机没有全局 Go，可先安装 Go 1.22+ 后再运行以上命令。

Web Console 本地端口为 127.0.0.1:3000，Go/Gin API 本地端口为 127.0.0.1:8080。

Phase 1 示例

./bin/moyuan project add --local /path/to/repo --root /path/to/repo
./bin/moyuan auth whoami --root /path/to/repo
./bin/moyuan requirement plan --text "add backend API to inspect issue graph with go test verification" --root /path/to/repo
./bin/moyuan issue graph phase1-epic --root /path/to/repo
./bin/moyuan orchestrator plan phase1-epic --root /path/to/repo
./bin/moyuan runtime invoke local_shell --prompt "printf ok" --root /path/to/repo
./bin/moyuan api serve --addr 127.0.0.1:8080 --root /path/to/repo
./bin/moyuan memory add --summary "项目事实" --root /path/to/repo
./bin/moyuan memory candidates --root /path/to/repo
./bin/moyuan repair signal --type test_failure --summary "测试失败" --root /path/to/repo
./bin/moyuan repair run <repair-plan-id> --prompt "修复命令" --root /path/to/repo
./bin/moyuan repair status <repair-attempt-id> --root /path/to/repo
./bin/moyuan quality check phase1-001 --root /path/to/repo
./bin/moyuan review merge-decision phase1-001 --root /path/to/repo
./bin/moyuan model provider add --id glm-main --vendor zhipu --api-type openai-compatible --auth-ref env:GLM_API_KEY --root /path/to/repo
./bin/moyuan model route --role backend --repo-edit --root /path/to/repo
./bin/moyuan model provider add --id minimax-m27-claude --vendor minimax --api-type anthropic-compatible --base-url https://api.minimaxi.com/anthropic --auth-ref env:MINIMAX_API_KEY --runtime claude_cli --model MiniMax-M2.7 --use-case frontend --allow-sensitive-code --allow-project-memory --root /path/to/repo
./bin/moyuan runtime invoke claude_cli --provider minimax-m27-claude --prompt "实现前端 issue" --root /path/to/repo
./bin/moyuan runtime recovery list --root /path/to/repo
./bin/moyuan visuals diagram plan --type multi-agent --root /path/to/repo
./bin/moyuan git provider plan phase1-001 --root /path/to/repo
./bin/moyuan release suggest --version v0.1.0 --root /path/to/repo
./bin/moyuan resources add --id dev-1 --environment test_dev --host 10.0.0.10 --provider local_vm --owner dev --auth-ref env:DEV_SERVER_SSH_KEY --root /path/to/repo
./bin/moyuan resources deployment-refs --root /path/to/repo
./bin/moyuan deploy plan <release-id> --environment test_dev --resource dev-1 --root /path/to/repo
./bin/moyuan deploy verify create --execution-id <deployment-execution-id> --environment test_dev --root /path/to/repo
./bin/moyuan operations audit-export --format markdown --environment test_dev --root /path/to/repo
./bin/moyuan operations decision-ledger --source-type release_admission --root /path/to/repo
./bin/moyuan operations write-proofs --operation-type deployment_execution --root /path/to/repo
./bin/moyuan operations write-admissions --operation-type deployment_execution --root /path/to/repo
./bin/moyuan operations write-review-packets create --operation-id <deployment-execution-id> --root /path/to/repo
./bin/moyuan operations write-execution-plans create --review-packet-id <write-review-packet-id> --mode preview --root /path/to/repo
./bin/moyuan operations write-adapter-executions create --execution-plan-id <write-execution-plan-id> --mode preview --root /path/to/repo
./bin/moyuan operations write-adapter-recoveries list --root /path/to/repo
./bin/moyuan control-loop queue add --adapter-recovery-id <write-adapter-recovery-id> --maintenance-window always --root /path/to/repo
./bin/moyuan control-loop run --idempotency-key daily-ops --step resource_health_scan --step decision_ledger_refresh --environment test_dev --root /path/to/repo

所有被管理项目的配置、状态、日志、项目理解和质量报告都会写入项目内 .moyuan/。