MAWflow 项目空间

MAWflow Project Space 是 MAWflow 的业务项目执行底座。它将项目目标、需求、工作项、AI 执行记录、人工确认、验收结果和交付证据组织在统一项目上下文中，支撑项目从需求到交付持续推进。

Project Space 随项目直接使用，已提供本地项目手册、云端项目入口、编辑请求差异预览、审批后任务调度、执行证据回写、验收关闭，以及本地/云端/混合模式下的同步计划、冲突决策和回滚。生产发布、真实客户环境与跨设备规模体验仍按开通范围单独验收。

Project Space 承载业务项目执行闭环：创建或导入项目时应用 Seed 协作规范，Project Space 把需求、任务、执行、验收和交付证据纳入同一条项目链路；项目需要启动时再由 Host Base 宿主机节点或获批平台节点提供运行资源。Lite、Studio、Enterprise 是同一项目空间的三档能力，升级不复制项目。

Project Space 不负责安装命令行、升级本机底座或开放本机插件；这些属于 Host Base 的本机技术运行底座职责。Project Space 负责把项目目标、需求、任务、审批、审计、证据和交付材料组织成业务项目可持续推进的空间。

它解决什么

Project Space 面向的是“项目如何持续推进”：

项目事实	Project Space 如何组织
项目目标	写入项目手册，明确用户、范围、非目标和风险。
需求	从 Project Clinic、Prompt Hub、人工输入或 PM 主账本进入项目空间。
工作项	拆成可执行、可验证、可追踪的任务。
AI 执行记录	记录 AI 做了什么、读了什么、验证了什么、哪里需要人工确认。
人工确认和审批	把关键决定、风险接受、验收和回修请求留在项目链路里。
审计和验收	连接 Audit Center、Evidence、PM 和交付材料，形成可复核证据。

和 Host Base 的分工

底座	侧重点	负责什么
Host Base 本机技术运行底座	本机安装、升级和能力运行	通过 @mawflow/cli 提供全局 mawflow 入口，安装 mawflow-host、升级命令、启动本机控制台、开放内置指令、基础功能模块和插件能力。
Project Space 业务项目执行底座	项目业务链路和协作语境	组织项目说明、需求、工作项、AI 协作记录、审批、审计、证据、验收和交付材料。

两者配合使用时，Host Base 让本机能力可安装、可升级、可运行；Project Space 让业务项目可理解、可追踪、可验收。

项目空间包含什么

区域	作用
项目手册	项目目标、用户、范围、非目标、风险、运行方式和关键资料摘要。
项目初始化	通过 mawflow project init 从官方 Seed 模板、GitHub、Gitee、Git URL 或本机模板创建项目起点。
需求与工作项	Project Clinic、Prompt Hub、人工需求和 MAWflow PM 工作项。
AI 协作记录	AI 执行摘要、人工接管点、检查结果、失败原因和后续动作。
审批与授权	需要人工确认的任务、变更、风险接受和高风险动作。
审计与整改	Audit Center 的批注、finding、修复批次和回审结论。
交付证据	验收结论、交付摘要、测试结果、复盘和可公开案例候选。

项目空间不是把所有资料复制到一个新系统里，而是把已有事实源组织成用户能理解的项目链路。PM、审计、任务、证据和移动端仍各司其职，Project Space 负责把它们放到同一个项目语境中。

AI、人和项目如何协作

角色	在 Project Space 中做什么
人	定义目标、确认范围、审批风险、判断验收和决定交付。
AI	在明确边界内执行任务、整理资料、辅助验证和输出证据。
项目	提供持续更新的目标、需求、任务、审批、审计、验收和交付上下文。

Project Space 的价值不是让 AI 无人自动开发完整软件，而是让 AI 负责有边界的执行，人负责目标和审计，项目持续留下可验证、可交付的证据。

项目初始化放在哪里

项目初始化是 Project Space 的项目起点，不作为顶层独立产品入口展示。第一次创建项目时可以执行：

mawflow project init my-project
cd my-project

默认会从 MAWflow 官网 Python 包源获取官方 Seed 模板包。需要 GitHub、Gitee、Git URL 或本机模板来源时，继续阅读 Project Init 用户手册。

三种运行形态

形态	适合场景	用户能获得什么
本地项目空间	个人开发者、已有本地项目、Lite 增强	完整资料优先留在本机，项目空间只展示安全摘要、项目健康、任务辅助和本地边界。
云端项目空间	一人公司、小团队、Studio 项目闭环	在云端持续推进需求、任务、AI 授权、验收和交付证据。
混合项目空间	企业、敏感项目、本地代码不宜上传的项目	本地保留完整代码和资料，云端只保留脱敏摘要、状态、审批和证据引用。

和 Lite、Studio、Enterprise 的关系

产品形态	项目空间侧重点
MAWflow Lite	本地项目空间：帮助已有项目整理项目说明、运行方式、验证方式、安全边界和宿主机绑定状态。
MAWflow Studio	云端协作项目空间：把需求调研、工作项、AI 执行、验收和交付证据放进持续推进的项目闭环。
MAWflow Enterprise	企业治理预览与验证路径：当前先评估多项目、多成员、审批、审计、统一登录和私有化目标。

Studio 面向团队、跨设备和远程协作；Enterprise 面向完整 MAWflow 私有化、组织治理、私有资源和定制交付。两者可以复用同一套项目业务语言，但 Enterprise 不是“私有部署 Studio”。

和 Seed 的区别

Seed 是开源 AI 项目导航系统，用来建立项目地图、模块地图、技术地图、任务说明、检查方式和公开协作规范。Project Space 是业务项目执行底座，用来把需求、任务、执行、审批、审计和证据持续组织起来。

Seed 解决“项目如何被 AI 稳定理解和执行”。
Project Space 解决“业务项目如何被人持续推进、验收和治理”。

安全边界

项目空间坚持几个公开边界：

• 不默认上传完整源码、真实密钥、未脱敏日志或客户敏感资料。
• 不把私有项目资料打包进官网静态页面。
• 不让网页或 AI 工具绕过审批直接修改项目、发布生产或接受高风险结果。
• 不替代 MAWflow PM、Audit Center、交付证据和用户自己的项目管理流程。
• Lite、Studio、Enterprise 是三个产品方案；它们可以共享 Project Space 的业务语言，但获得方式、运行范围和验收边界分别管理。

从一个 Manual block 完成第一次闭环

在已开通的项目工作台中打开 /projects/{project-key}/space，按以下顺序体验：

1. 初始化空间并生成 Manual；选择一个具体 block，确认页面显示来源路径、版本、anchor 和内容 hash。
2. 填写建议替换内容并先点“预览差异”。此时应看到不可变 diff 和“尚未执行”，仓库内容不会被页面直接修改。
3. 提交编辑请求，在 Edit Request Lifecycle 中查看 pending 请求、Approval、Task 和统一时间线。
4. 未批准时尝试调度应被拒绝；批准后再调度，任务才进入 ready/执行链路。
5. 任务完成并写入执行记录与产物证据后点“刷新证据”。没有新版 Manual 或证据时不能验收关闭。
6. 生成包含改动的新 Manual 版本，回到请求详情核对原 anchor、diff 和证据，再执行“验收关闭”。

这条路径的完成信号不是“请求已创建”，而是同一请求能追溯到审批、真实任务、执行证据、新 Manual 版本和关闭结论。刷新页面后仍应从服务端恢复相同状态。

验证三方同步与恢复

Three-way Sync Center 使用 base / local / remote 三个 head 生成同步计划。先使用空变更验证 clean 路径；再让本地和远端对同一 block_key 提交不同 text_hash，验证 conflict 路径。

• “预览决策”只计算选择和确认串，不修改投影。
• “确认应用”要求精确确认后才写入脱敏同步投影。
• 已应用计划提供“回滚”，只恢复 Project Space 同步投影，不反向修改源仓库。
• 离线队列用 client request id 保持幂等；重新联网后先比较三个 head，不做最后写入覆盖。
• 云端变更只允许 block key、来源路径、操作类型、hash、状态和安全摘要；不得包含完整源码、原始提示词、真实密钥或未脱敏日志。

复杂 diff 和冲突解决建议使用桌面端；移动端适合阅读手册、查看审批摘要、确认和检查证据。

下一步

• 想今天开始：阅读 快速开始。
• 想看能力矩阵：阅读 产品功能。
• 想用 Studio 做项目管理：进入 MAWflow Studio 用户手册。
• 想确认安全边界：阅读 信任中心。