适用版本：V1.2.8-open 更新日期：2026-08-03 界面截图：CodeFlowMu PC Panel V1.2.5、V1.2.6-open PWA 截图：CodeFlowMu PWA V1.0.58、V1.0.59
本手册面向首次安装和日常使用 CodeFlowMu Open Dev Team Edition 的用户。Open 版默认在本机运行，团队角色为 PM、DEV、OPS、QA，EVAL 作为独立观察角色。
第一次使用时，按下面顺序操作，不需要先理解所有治理概念：
| 顺序 | 去哪里 | 做什么 | 看到什么表示成功 |
|---|---|---|---|
| 1 | 启动器 | 双击 START-CODEFLOWMU-OPEN.bat |
浏览器可打开 http://127.0.0.1:18765/ |
| 2 | 设置 → 常规 | 填写 Cursor API Key，保存并验证 | 验证状态为绿色，模型列表成功加载 |
| 3 | 设置 → 项目 | 使用默认项目、新建独立项目或添加已有源码，点击“设为当前” | 顶部项目名与页面项目根一致 |
| 4 | 环境预检 | 仅在页面提示时执行初始化或修复 | 没有阻断项，Runtime 已绑定当前项目 |
| 5 | 任务 → 投递审查 | 输入任务，或上传 Markdown 任务书，检查通过后正式发布 | TASK 出现在“正式任务”中 |
| 6 | 仪表盘 / 任务 | 查看 PM 是否派发 DEV、OPS、QA 子任务 | 任务状态开始流转，实时活动出现记录 |
| 7 | 报告 | 查看执行结果、测试和证据 | 对应角色产生 REPORT |
| 8 | 审批 | 仅在系统提出高风险动作请求时审批 | 审批记录显示允许、拒绝或已处理 |
| 9 | 移动端（可选） | 在 PC 获取绑定入口，在 PWA“我的”中绑定 | PWA 顶部 PC 与 Gateway 状态正常 |
任务的最短闭环是：
发布 TASK → PM 分析派发 → DEV / OPS / QA 执行 → 查看 REPORT → PM 验收
下面各章节按照实际页面逐项介绍。PC 截图使用整栏大图；PWA 使用可点击的小尺寸截图，避免手机长图占满文档。
完成安装后，在仓库根目录运行 START-CODEFLOWMU-OPEN.bat（手动安装可使用 npm start），然后打开启动日志给出的 Panel 地址。顶部绿色「已连接」表示浏览器已连接 Shell；版本徽标、当前项目、实例类型和端口用于确认当前运行环境。
仪表盘集中显示任务、报告、运行中事项、待审批、团队状态和 Runtime 告警。首次使用时先确认：
- 顶部为绿色「已连接」；
- 当前项目是准备工作的项目根；
- 团队角色已经显示；
- 运行时告警没有阻断项。
左侧进入「任务」。顶部「正式任务」查看已经进入生命周期的 TASK；「投递审查」用于在正式 TASK 生成前检查任务书。
任务书首次检查发现问题时：在线下修改 Markdown，点击「继续编辑」，在新的任务书写入页重新上传修改后的文件，覆盖旧草稿后再次检查。不要直接重跑未修改的旧文件，也不需要先创建重复 TASK。
任务列表可按主线、关键词和进行中/已归档筛选；「列表」「看板」「任务线」分别适合逐项查看、按状态查看和查看父子关系。
进入「设置 → 项目」可新建独立项目、添加已有项目或将某个项目设为当前。顶部项目下拉与该列表同步。
「设为当前」会让 Runtime、MCP、Watcher 和 Agent 工作目录一起切换到 active project。Shell 安装根不会因此改变。切换后请检查顶部当前项目和页面中的项目根一致；若启动一致性诊断报错，应先修复根绑定，不能继续项目写入。
同一页面下方的「版本更新日志」展示每个版本的具体功能、修复、关联任务和影响范围，可使用搜索框按版本或更新内容检索。
左侧「审批」只处理动作发生前的一次性高风险操作授权，例如破坏性操作、外部写入、发布、凭据或 Runtime 治理边界变更。
TASK、REPORT、REVIEW、事实核查和 EVAL 不进入全局操作审批；它们继续使用任务生命周期。审批通过只表示允许尝试执行，不等于执行已经成功，最终结果仍应查看验证状态和审计记录。
「设置」集中承载运行参数、版本信息、项目管理、发布、Git、数据工具和自动化能力。每个标签都是独立页面，不需要离开 Panel。
常规设置用于确认项目根、界面语言、主题和 API 接入通道；通知设置管理桌面提醒；关于页展示母版、Shell、PWA 与协议版本以及具体更新日志。
项目设置管理本机 active project；PWA 项目设置管理独立 Web 项目的注册、版本和发布入口。二者都不会把 host_root 错当成当前业务项目根。
「设置 → Git 状态」区分产品文件和非母版变更：
- 产品文件未提交会阻止发版；
- 项目工作区与 FCoP/运行配置只显示数量，默认不参与母版提交；
- 提交前应核对分支、远端同步状态和本次变更范围。
不要为了让工作区显示干净而把真实项目、任务、报告、运行日志或本地配置加入产品提交。
「数据导出」用于生成可迁移的数据包；「任务模板」用于维护常用任务书结构。
Windows Use 面向获准的本机 Windows 应用；Browser Use 面向获准的浏览器目标。两项能力默认关闭，必须先登记目标、说明用途，再显式启用。
受保护应用、未登记目标和超出授权范围的操作不会因为启用了能力而自动放行。账号与密码仅保存在项目根的本地环境文件，不进入 Git、任务正文或截图。
团队配置用于设置角色模型、团队身份、审批模式和运行参数。修改模型后只影响后续会话，已经运行的会话继续使用启动时捕获的模型。
「问题」用于查看结构化 ISSUE；「门铃」显示 MCP 工具调用、系统事件和故障记录，适合判断 Agent 是否真正开始工作。
已结案问题可生成公共 GitHub Issue 草稿。默认目标是 joinwell52-AI/CodeFlowMu-open，不携带默认标签。未连接 GitHub 时仅显示预览和下载；点击“连接 GitHub”完成浏览器授权后，可审阅最终标题、正文和标签并申请发布。ADMIN 批准后受控执行器立即发布，成功时显示可点击回执；网络、权限、Issues 关闭或标签缺失会显示中文原因并保留草稿供重试。
EVAL 是独立观察层，不代替 PM、QA 或 ADMIN 验收。技能库展示 Runtime 可匹配的技能包及接入状态；文件浏览用于只读查看 FCoP、文档和项目文件结构。
维护者可在「设置 → 开源版本发版」查看版本号、允许同步的产品变更组、构建状态、类型契约检查和发版记录。
发布前必须先提交母版产品代码，并填写用户可理解的版本名称与具体更新内容。系统随后依次执行版本预审、Open 构建、完整性验证、发行树依赖安装与 TypeScript 契约检查、安全同步、提交和推送。任一步失败都应先修复依赖闭包或审批范围，不能跳过门禁。
PWA 用于在手机上查看团队状态、任务、报告、审批与动态，并可向角色发送消息。首次使用先从 PC Panel 获取绑定入口，在 PWA「我的」中完成设备绑定；状态栏的 PC 与 Gateway 均为绿色后再进行业务操作。
当前 PWA V1.0.59 在「我的」页新增常驻的「本版更新」卡片，直接展示版本名称和具体更新内容；完成更新后仍可随时查看，不再只依赖一次性的升级提示条。下列功能截图拍摄于 V1.0.58，界面主体与 V1.0.59 一致。
任务页支持正式任务、投递审查、列表与任务线视图。发布任务时可手工填写标题和详情，也可导入修改后的 Markdown 任务书；首次检查未通过时，应修改文件后重新上传覆盖旧草稿。
报告页按主任务、子任务和记录筛选；审批页只处理需要明确授权的操作；动态页用于查看角色活动与系统事件。审批通过不等于执行完成，仍应回到报告或任务状态确认结果。
「我的」显示当前 PWA 版本、语言与绑定状态，并提供重新绑定、清缓存和重新加载。公开文档截图不得包含二维码、绑定链接或访问令牌。
| 现象 | 处理 |
|---|---|
| Panel 当前项目正确，但 TASK 查询返回不存在 | 检查 Runtime、MCP 和 Watcher 是否都绑定同一 active project；重启后仍不一致时停止写入并查看启动诊断 |
Runtime writer lock is already owned |
已有实例占用同一 Writer Lock；不要再启动第二个相同实例，回到已有 Panel 或先按受控流程停止原实例 |
| 任务书修复检查仍使用旧内容 | 点击「继续编辑」，重新上传线下修改后的 Markdown，保存覆盖旧草稿后再检查 |
| 开源构建提示相对 import 缺失或 TypeScript 名称缺失 | 将调用方、实现、类型定义和必要测试作为完整 change group 纳入发布，再重新构建 |
| 图片在公开仓库缺失 | 截图必须位于 docs/images/ 且加入 Open include 清单；帮助文档使用相对路径引用 |
更多资料：