Lite 安装与开通
Lite 是新账号的默认档位，不以安装 Host Base 为开通条件。本页只处理项目需要本机执行时的宿主机安装路径：先在产品工作台创建或导入项目并应用 Seed 协作规范，再安装 Host Base → 登录当前账号 → 在“宿主机与节点”中确认主脑/验收/执行节点 → 绑定项目并运行任务。
官网手册只说明公开流程和准备事项，不保存你的本地项目资料，也不会要求你把登录授权码写入仓库、脚本或截图。
准备条件
- 你有一个本地代码仓库，或准备创建一个新项目，并且知道项目大致做什么。
- 本机可以使用 Node.js / npm 和 Python 3.11+。
- 你已经注册 MAWflow Account 并进入产品工作台；新账号默认使用 Lite。
- 如果你在 macOS / Linux 上准备后台运行 Host Base，先安装
tmux；Windows 后台模式不需要tmux。
1. 安装并启动 Host Base
如果当前机器还没有可用的 mawflow 命令，先安装 npm 全局入口。它会准备 Host Base 专用 Python 虚拟环境，避免把包安装到系统 Python、操作系统发行版管理的 Python 或 uv 管理的全局 Python。
macOS / Linux 后台模式依赖 tmux。常见安装命令如下：
sudo apt-get update && sudo apt-get install -y tmux
brew install tmux安装 @mawflow/cli：
npm install -g @mawflow/cli --registry=https://mawflow.com/npm/
mawflow --help确认命令可用：
mawflow --help
mawflow host status如果 npm 全局入口不可用，可以按 Host Base 用户手册 的 Python 兜底路径安装 mawflow-host。如果兜底安装时报 externally-managed-environment，说明你正在改全局 Python。请回到专用虚拟环境安装，不要使用 --break-system-packages。
首次安装后先初始化，再启动 Host Base：
mawflow host install
mawflow host start -d如果只想在当前终端前台运行，可去掉 -d：
mawflow host start完成信号：mawflow host status 返回服务状态，启动命令给出本机管理入口；如果未启动，先按 Host Base 用户手册 的诊断步骤处理。
2. 登录当前账号并绑定宿主机
进入 产品工作台个人空间 登录。登录后，个人空间可以查看设备登录记录、生成登录授权码，并对指定设备强制下线；“宿主机与节点”页可设置默认宿主机或移除宿主机，移除会使目标设备会话失效。
登录 Host Base：
mawflow login --service-url https://mawflow.com命令会返回一个登录 URL 并尝试打开浏览器。登录个人空间后确认本机设备，Host Base 会自动写入登录激活 cache，并成为当前账号绑定的宿主机。Lite 在账号登录时已经可用。
无浏览器环境：
mawflow login --code <登录授权码> --service-url https://mawflow.com登录授权码在个人空间生成，明文只在生成时返回一次；一个码只能使用一次，成功后绑定首次登录的设备。
查看状态：
mawflow status
mawflow plugins list安装包不会自动启动服务、不会注册系统服务、不会登录账号、不会写登录授权码。只有你显式运行 mawflow project init、mawflow host start、mawflow host start -d、mawflow host stop、mawflow login 或 mawflow logout 时，才会进入项目初始化、启动、停止、登录或退出登录动作。
完成信号：mawflow status 能看到账号、设备登录和 Lite 权益状态，个人空间能看到对应设备。
3. 初始化或绑定项目
创建新项目时运行：
mawflow project init my-project --source github --repo mawflow/mawflow-seed --ref v0.2.31国内网络可改用 --source gitee；GitHub 与 Gitee 的 v0.2.31 已验证为相同公开内容。
已有项目不要整包覆盖。按 现有项目接入 Seed 先审计项目事实，再增量加入协作结构；随后打开 http://127.0.0.1:8765/#projects，在本地产品工作台的“我的项目”选择真实项目目录。Lite 不限制本地项目数量，第一次使用可先连接一个项目完成闭环。
项目接入采用两阶段确认：
- 预检项目只识别项目名、Git 摘要、
.maw状态和敏感/排除类别计数，不读取或返回源码内容，也不会改项目。 - 核对项目指纹与扫描摘要后，使用页面给出的精确口令确认绑定。绑定记录只写入本地产品工作台的本机私有状态；重复确认是幂等的。
完成信号：项目目录和入口可识别，真实 README、运行配置、业务代码和本机私有边界没有被覆盖。
4. 建立本地 Project Space
打开 Host Base 启动命令给出的本地产品工作台，在首页和“我的项目”读取 mawflow.lite_readiness.v1 就绪态。页面按项目、AI 服务、宿主机与节点、安全设置组织检查结果，并把阻塞原因对应到可执行的恢复入口。
绑定项目后点击“读取安全上下文”。Lite 直接复用本地 Project Space，仅展示上下文版本、来源/页面/block 数量、内容哈希和 Git 摘要；不会返回完整源码、绝对项目路径、原始 Prompt、密钥或未脱敏日志。
第一次只需要确认：
| 字段 | 建议写法 |
|---|---|
| 项目名称 | 用你自己能识别的名称。 |
| 项目目标 | 一两句话说明这个项目服务谁、解决什么问题。 |
| 当前阶段 | 例如整理文档、修复问题、开发一个小功能或准备验收。 |
| 本机系统 | Windows、macOS 或 Linux。 |
| 预计接入项目数 | 第一次建议只接入 1 个项目。 |
本地 Project Space 用于保存项目说明、运行入口、验证方式和后续协作摘要；不要把完整源码、密钥或客户资料直接粘贴到说明里。Studio 按当前开放范围和产品内访问流程提供，Enterprise 按企业验证与审批范围提供。
补齐项目事实：
绑定成功后，选择一个本地项目目录，并补齐项目事实：
项目目标：
主要目录：
启动命令：
检查命令：
允许读取：
禁止读取：
本次希望 AI 帮什么：
完成后验证：第一次只接入一个小项目或一个小任务。不要一开始要求 AI 全仓阅读，也不要把生产配置、真实密钥、客户资料、未脱敏日志或私有资料目录放进允许范围。
完成信号：项目空间能显示项目目标、真实目录、启动/检查命令、允许范围和禁止范围。
5. 运行第一条任务辅助
进入本地产品工作台“我的项目”或按 Lite 快速开始 选择一个页面、接口或文档级小任务。填写标题、目标、范围、允许修改路径和验证项；先生成只读预览，再使用页面给出的版本口令确认。没有 AI Credits 时自动使用本地规则辅助，不会阻塞本地流程，也不会在确认步骤自动修改项目。
完成信号：第一条任务足够小，AI 不需要全仓猜测，任务说明能直接用于执行和验收。
6. 查看验证与证据
运行项目已有的最小检查，并在“Lite 首页”记录 passed、failed 或 unknown 结论。Lite 只保存安全摘要和检查状态，不接收 stdout、stderr 或原始日志。Project Space 或任务记录中应保留：
- 这次改了什么，用户能看到什么结果。
- 跑了哪些命令或人工检查，结果是什么。
- 哪些验证没有运行，原因是什么。
- 还有哪些风险、待确认事项和下一步。
- 是否需要发布，或是否需要用 Studio 承接持续项目闭环。
完成信号：人可以仅凭任务说明、验证结果和证据摘要判断本次任务是否完成。
常见分流
| 情况 | 建议 |
|---|---|
mawflow 命令不可用 | 回到第 1 步补装 @mawflow/cli，或使用 Host Base 手册的 Python 兜底路径。 |
| Host Base 无法启动 | 运行 mawflow host status，按 Host Base 用户手册 检查本机依赖和端口。 |
| 登录或设备确认失败 | 回到个人空间重新生成一次性登录授权码，不要把授权码写入仓库或截图。 |
Lite 首页显示 login_required | 完成 Host Base 登录后刷新页面；若已登录仍异常，运行 mawflow status 检查本机登录状态缓存。 |
Lite 首页显示 lite_entitlement_missing | 在个人空间刷新或申请 Lite 权益；仍不可用时进入项目的“访问与权益”页面查看申请状态。 |
Lite 首页显示 project_limit_reached | 继续使用已绑定项目；需要更多项目时查看 Studio 当前开放范围并判断是否适合。 |
| 没有 AI Credits | 继续使用 Lite 的本地规则任务辅助；只有远程模型调用或执行需要 Credits/Studio。 |
| 项目目录离线或已移动 | 恢复原目录后刷新；不要在不可确认指纹的情况下重新绑定到另一个目录。 |
| 已有项目担心被覆盖 | 使用 现有项目接入 Seed 的审计和增量接入路径。 |
| 已有本地项目，只想让 AI 做一次小任务 | 完成本页前 4 步后进入 Lite 快速开始。 |
| 需要长期需求、任务、验收和交付证据 | 继续评估 MAWflow Studio。 |
| 需要团队权限、审批、审计或私有部署 | 直接看 MAWflow Enterprise。 |
下一步
继续阅读 Lite 快速开始，用一个本地项目完成第一次增强闭环。