项目

项目把代码、文档和其他工作文件作为可重复使用的上下文交给 Waker。团队中的多个 Waker 都需要访问时创建公开项目；只供一个 Waker 使用时，在该 Waker 下创建私有项目。 项目配置保存的是工作目录和访问关系，不会复制原始文件。删除项目配置也不会删除磁盘中的目录。

​

选择公开或私有项目

不要为了方便把包含多个无关项目、个人目录或敏感文件的上层目录整体公开。

​

创建公开项目

入口： 左侧导航 →「能力与资源」→「公开项目」。

1. 点击「创建公开项目」。
2. 选择页面支持的本地目录或 Git 仓库来源。
3. 填写清晰名称，能够区分环境、仓库或用途。
4. 检查实际路径、运行设备和访问范围。
5. 保存后从项目列表打开，确认基本信息正确。
6. 在一个测试 Waker 的新对话中选择该项目，先执行只读检查。

完成判断： 项目出现在公开项目列表中，目标 Waker 能选择它，并能在正确设备上读取预期文件。

​

创建 Waker 私有项目

入口：「Waker 管理」→ 目标 Waker →「能力与资源」→「项目」。

1. 点击添加项目。
2. 选择当前 Waker 所在环境可以访问的目录或仓库。
3. 填写名称并保存。
4. 新建该 Waker 的对话，选择项目并执行只读检查。

私有项目适合限制访问范围，但不能代替文件系统权限。仍应在 Waker「权限」中限制可读写目录和高风险操作。

​

在对话中使用项目

1. 打开目标 Waker 或 Group 的新任务。
2. 从工作空间中选择「项目」。
3. 选择目标项目，确认执行设备和分支。
4. 在任务描述中写清允许读取和修改的范围、产物位置、测试及验收要求。
5. 完成后打开实际文件和版本差异检查。

切换项目或主要分支时新建任务，避免旧聊天继续使用之前的路径和上下文。

​

在自主工作中使用项目

自动任务触发时没有人实时修正目录，因此上线前要额外确认：

• 项目路径长期稳定，触发时设备在线。
• 任务使用的分支或目录不会被其他自动任务同时覆盖。
• 写操作、测试和输出位置已经在手动运行中验证。
• 项目需要的连接器和权限不会在无人值守时过期。

项目移动、重命名或权限变化后，编辑自主工作并重新手动运行。

​

在 Group 和 WakerFlow 中使用项目

多个 Waker 访问同一项目时，应明确：

• 哪个 Waker 负责实际修改。
• 哪些 Waker 只分析或评审。
• 是否使用同一分支或不同工作目录。
• 最终由谁汇总和提交产物。

没有隔离的并行写入容易相互覆盖。需要并行修改时，使用独立分支、工作树或目录，并在流程中设置汇总和人工确认步骤。

​

更新或删除项目配置

修改路径、设备或访问范围后：

1. 暂停依赖该项目的自动任务。
2. 更新项目配置。
3. 用新对话执行只读检查，再验证一条小范围写任务。
4. 恢复自动任务和 Group 使用。

删除前检查对话、自主工作、WakerFlow 和 Group 是否仍引用项目。删除配置不会清理原始目录，也不会撤销已经发生的文件修改。

​

常见问题