路线图

版本历史

项目的全部已发布版本记录于 CHANGELOG.md，格式遵循Keep a Changelog， 版本号遵循语义化版本 2.0.0。每个版本按六大类组织：新增 / 变化 / 修复 / 移除 / 弃用 / 安全。

来源：CHANGELOG.md · site/src/data/content.json

当前版本亮点

当前版本 v0.6.1 于 2026-10-07 发布，主题为「OpenCode V2 兼容激进清理」。

v0.6.1「OpenCode V2 兼容激进清理」

• 移除 tui.json（V2 靠自动发现）
• permission 转 native V2（permissions 数组）
• 移除 V1 类型包 @opencode-ai/plugin
• 新增 v1-compat 分支 + V2 形态回归守护
• 修 site 编译错误 + seroval 安全漏洞

以下为 v0.4.0（历史）版本的发布亮点回顾。

v0.4.0「半自动化 GitHub 开发工作流 + 工程加固」

• 半自动化 GitHub 开发工作流：新增 /gh-issue 命令、gh-flow/ 远程工作区与 .github/workflows/agent-run.yml，实现「本地意图 → 云端执行 → 人工 merge」
• 新用户默认 OpenCode Zen 免费模型 + 自动引导：零成本开箱即用，降低启动门槛
• Agent 提示词与行为规范优化：全 6 角色 system prompt、行为准则与 OpenCode 集成重构
• 安装 / 验证 / 工作流加固：BOM 兼容、卸载 tui.json 清理、verify 路径解析修正、agent-run 三处缺陷修复

v0.3.2「侧边栏全局化」

• install.mjs --global：把 @cgartlab/men 注册进 OpenCode 全局 tui.json，任意目录打开 OpenCode 即显示 Men 侧边栏
• 仅改 tui.json：不触碰 CC Switch 管理的 opencode.json，模型与密钥托管不受影响
• 补 exports 与 @opentui 依赖：根 package.json 补 exports["./server"]/exports["./tui"]，OpenCode 启动自动安装 npm 包后加载侧边栏

以下为 v0.3.0（历史）版本的发布亮点回顾。

v0.3.0「一行命令安装」

• npm 包发布与 npx 一行安装：任意目录执行 npx @cgartlab/men，自动完成 scaffold + 依赖 + .env + 端到端验证
• 安装指令准确性修复：一键脚本 URL 硬编码、install.astro 标签修复、.opencode/package.json 纳入版本控制、4 个 MCP 服务器补齐 transport 全部可加载
• 文档与站点全面同步：事件 14 种、技能 15 个、MCP×7、版本引用 v0.3.0
• 定位澄清：Men 是 OpenCode 插件，模型与密钥由 CC Switch 本地托管，安装无需密钥

以下内容为 v0.2.0（历史）版本的发布亮点回顾。

M5 文档完善

补齐核心文档：产品需求文档（PRD）、架构说明（含 D1–D17 技术决策记录）、快速上手指南、 里程碑进度、版本发布方案等，为新人提供理解项目的第一入口。

M6 GitHub 开源基础设施

• 标准文档全套：LICENSE（MIT）、CONTRIBUTING.md、SECURITY.md（承诺 72 小时响应）、CODE_OF_CONDUCT.md
• PR / Issue 模板、CODEOWNERS 自动分派、FUNDING.yml、Dependabot 依赖自动更新
• CI 工作流：每次 push / PR 自动执行脚本语法检查 + verify + release dry-run + installer smoke
• 团队治理文档：docs/governance.md 定义角色权限、决策流程、变更管理与发布策略

M7 自主学习回路

• 学习循环：learn.mjs 在每次 /ultrawork 后从 events.jsonl 提取经验，写入 knowledge/errors/ 与 knowledge/patterns/
• 评估指标：eval-metrics.mjs 在 /verify 后计算 8 项 KPI（通过率、回归率等）
• 知识库：3 条决策记录（M0/M6/M7）、3 条初始协作模式、1 条自动提取错误
• MCP 工具扩充：由 3 个增加到 7 个（新增 fetch / github-mcp-server / memory / sequential-thinking）

发布时的验证结果

来源：CHANGELOG.md · docs/guide/milestones.md

里程碑进度

项目以里程碑（M0–M7）推进，全部已收官。以下为官方进度表述（来自content.json 的 milestones 数组）：

来源：site/src/data/content.json（milestones）· docs/guide/milestones.md

发布流程

版本发布遵循 docs/guide/release.md，版本载体为根目录 package.json + CHANGELOG.md + git tag。

版本号约定（SemVer 2.0.0）

一键发布

npm run release            # patch（默认）
npm run release:minor      # 0.2.1 → 0.3.0
npm run release:major      # 0.1.0 → 1.0.0
npm run release:all        # 全部 = --push + --gh-release + --npm

scripts/release.mjs 自动完成以下步骤：

1. 读取 package.json 的 version 并校验 SemVer（非法退出码 2）
2. bump 版本号并写回 package.json
3. 在 CHANGELOG.md 的 [Unreleased] 下插入新版本节，迁移已整理条目
4. 同步版本号到 JSON/文本文件（opencode.json、configure.astro、AGENTS.md 等 8 处）
5. 若已 git init：git add + git commit -m "chore(release): vX.Y.Z" + git tag vX.Y.Z
6. 用 scripts/release-notes.mjs 提取只含当前版本的 release notes

GitHub Releases 关联

使用 --gh-release flag 时，脚本自动调用 gh release create 创建 GitHub Release， release notes 使用 release-notes.mjs 提取的只含当前版本内容。 也可手动使用 scripts/release-notes.mjs 提取后创建：

# 自动（推荐）
node scripts/release.mjs patch --push --gh-release

# 手动提取 + 创建
node scripts/release-notes.mjs --output /tmp/release-notes.md
gh release create vX.Y.Z --title "vX.Y.Z — 主题" --notes-file /tmp/release-notes.md

CI 自动验证

.github/workflows/ci.yml 的 validate job 在每次 push / PR 时执行node scripts/release.mjs --dry-run（release dry-run）， 确保发版脚本本身可通过机械验证；另有 PR 自动打标与指派。

来源：docs/guide/release.md · .github/workflows/ci.yml

未来规划

里程碑文档（docs/guide/milestones.md）在「下一步」中列出了 M8+ 的规划方向， 尚未确定版本号与发布日期：

• 跨运行时 adapter：当前仅适配 OpenCode，规划适配 Codex / OpenClaw 等运行时
• 插件化封装：将 agent / skill / command 体系封装为可复用插件
• Agent 团队扩展：扩展更多角色与协作模式

来源：docs/guide/milestones.md（下一步）· docs/architecture.md（决策 D2）