Lite 快速开始
本页面面向已经完成 Host Base 安装、登录、项目绑定和本地 Project Space 建立的用户。目标是完成 Lite 六步路径的最后两步:运行第一条任务辅助,并留下验证与证据。
如果你还没有走到这里,先按 Lite 安装与开通 完成安装 Host Base、登录、初始化或绑定项目和本地 Project Space。
准备条件
- 本地项目可以打开。
- 已经完成 Seed 安装,并能登录 MAWflow Account。
- 本机 Host Base 已安装并能运行
mawflow host status和mawflow status。 - 你知道至少一个启动命令、检查命令或人工验收方式。
- 本次任务足够小,最好只涉及一个页面、一个接口或一份文档。
1. 打开 Lite 首页并选择一个小任务
打开 http://127.0.0.1:8765/#lite-home-section。确认页面状态至少到达 ready_for_first_task;如果页面显示 blocker,先按恢复入口完成登录、权益刷新、项目绑定或目录恢复。
第一次不要选择“整体重构”“全部优化”或“帮我看看项目”。建议选择用户可见、范围清楚的小任务:
| 小任务 | 为什么适合第一次 |
|---|---|
| 给列表增加搜索 | 用户结果清楚,验证路径简单。 |
| 修正文档入口 | 修改范围清楚,不需要复杂运行环境。 |
| 调整一个表单提示 | 页面和验收标准容易判断。 |
| 补一条最小测试说明 | 能练习检查和收口。 |
2. 确认项目事实
先在本地 Project Space 检查这段,不要让 AI 从全仓猜:
项目目标:
当前任务:
主要目录:
启动命令:
检查命令:
允许读取:
禁止读取:
完成后验证:3. 写任务说明
把小任务写成可执行输入:
# 本地项目小任务
## 目标
说明这次完成后用户能看到什么。
## 允许修改
列出本次允许修改的目录或文件。
## 禁止修改
列出不要碰的目录、配置、密钥和无关模块。
## 验收标准
说明怎样判断完成。
## 验证方式
写出命令或人工检查项。
## 收口要求
请说明变更、验证、未验证原因、风险和下一步。4. 运行第一条任务辅助
在 Lite 首页填写任务标题、目标、范围、允许修改路径和验证项,点击“生成任务预览”。确认页面显示的任务标识与版本,再用精确口令确认这一版任务说明。此步骤只锁定结构化任务版本,不会自动修改项目。
人工确认后,再让当前 AI 工具读取 Project Space 安全上下文和任务相关文件并执行。执行过程中如果它准备读取无关目录、跳过验证或把未确认内容写成事实,及时补充说明。
可复制补充格式:
补充:<复制 AI 可见过程里的原话> 这句不对,应该是<写清正确口径>5. 运行验证
先运行任务说明中的最小检查或人工验收,不要把“代码已改”当成“任务已完成”。记录命令、结果和未运行原因。
6. 查看验证与证据
回到 Lite 首页记录 passed、failed 或 unknown。无法运行验证时如实选择 unknown 并说明依赖缺失,不要伪造通过。然后确认最终说明和证据摘要包含:
- 改了什么。
- 用户能看到什么结果。
- 跑了哪些检查或人工验证。
- 哪些验证没有跑,原因是什么。
- 哪些风险要后续处理。
- 是否需要发布或进入 Studio 项目闭环。
完成信号:另一个人不需要重新读完整聊天,就能从任务说明、改动摘要、验证结果、风险和下一步判断本次任务是否完成。
本地产品工作台重启后,绑定项目、已确认任务版本和证据摘要会从本机私有状态恢复;页面不会向云端返回绝对项目路径、完整源码或原始日志。
常见错误
| 错误 | 修正方式 |
|---|---|
| 一开始让 AI 全仓搜索 | 先写允许读取和禁止读取。 |
| 任务太大 | 拆成一个可验证小目标。 |
| 只写“优化一下” | 写清目标、范围和验收标准。 |
| 未验证却写成通过 | 要求 AI 写明未验证原因。 |
| 把本机资料写进公开内容 | 改成脱敏描述或只留在本机。 |
下一步
继续阅读 Lite 新手路径,用“博客搜索”案例把项目事实、上下文、任务辅助和收口串起来。
