QuickEngineering 用户指南
QuickEngineering 把一个目标转化为由明确任务、指令、工作者、输入、结果、审阅与可发布成果串联而成的流程。
快速上手
- 创建一个项目，只有当流程需要文件或代码时才选择工作区。
- 创建一个 Flow，然后添加带有明确指令与结果名称的任务。
- 为每个任务选择一个 Agent，并把先前的结果映射到后续输入中。
- 在影响较大的环节添加审阅、人工、数据发送、预算或发布关卡。
- 运行该流程，跟踪 Runs 与 Agent 队列，然后查看 Artifacts 与历史。
小提示： 请为每个结果取一个清晰的名称，让下游映射始终易于理解。
界面概览
| 区域 | 用途 |
|---|---|
| 项目 | 用于存放流程、成果、快照、导入内容与回收站的 .qeng 源容器。 |
| Flow 编辑器 | 任务图、映射、条件、契约、关卡、预算与运行入口。 |
| 提示词工作区 | 提示词、变量、变体、矩阵、评估与可复用资产。 |
| Runs 与 Agent 队列 | 执行、审批、已认领任务、进度、重试、审阅与最终状态。 |
| Artifacts 与历史 | 类型化输出、版本、血缘、评论、差异对比、回滚、导出、发布与审计。 |
任务 → 指令 → Agent → 结果
Flow 编辑器让每个任务的用途、提示词、工作者、输入契约、输出契约与审阅边界都保持可见，而不是把编排逻辑埋进一段对话里。
- Flow 编辑器： 连接任务、输入、结果、映射、契约、条件、预算与关卡。
- 提示词工作区： 管理可复用的提示词、变量、变体、矩阵、评估以及带版本的提示词资产。
- Agent 路由： 可使用系统 AI、本地模型、MCP agent、已配置的云端服务商或人工步骤。
- 持久化 Runs： 跟踪排队中、进行中、已暂停、等待中、失败、已审阅与已完成的工作，并带有重试边界。
- Agent 队列与 MCP： 让权限受限的外部 agent 认领工作、接收上下文并返回进度与结果。
- 成果与审阅： 保留类型化输出、血缘、版本、评论、差异对比、回滚、导出、发布与审计历史。
注意： 外部 agent、服务商、命令与已连接服务可能会影响文件与系统。请在批准前审阅权限范围、目标与输出。
设置
打开设置即可查看以下应用专属控制项：
- Agents、AI 服务商、连接、MCP Host 与工作区权限
- 审批、数据发送、预算、审阅与发布策略
- 键盘快捷键、外观、诊断与恢复
- 项目、成果、触发器、Knowledge 与 Agent Memory 的行为
试用版、免费版与 Pro 版拥有相同的功能集。Pro 版会移除移动端广告和桌面端每日支持提醒。
键盘快捷键
在 Apple 平台上，当应用将显示的 Ctrl 快捷键映射到平台主修饰键时，请使用 Command。以应用内的快捷键页面为准。
| 快捷键 | 操作 |
|---|---|
| F2 / Enter | 重命名或编辑选中的提示词变量项 |
| F4 | 切换选中的提示词变量路径模式 |
| Tab / 右方向键 | 移动到下一个提示词变量片段 |
| 左方向键 | 移动到上一个提示词变量片段 |
| Escape | 取消提示词的行内编辑 |
| 设置 > 键盘快捷键 | 查看当前已注册的全局操作 |
提示 & 技巧
请为每个结果取一个清晰的名称，让下游映射始终易于理解。
在添加外部 Agent 或触发器之前，先用系统 AI 和一个简短的手动流程起步。
当直接访问 agent 工作区未通过探测时，请改用 VFS 中转或仅补丁（Patch-only）方式。
请把密钥保存为引用，并在对外传输前检查数据发送预览。
疑难解答
| 问题 | 排查要点 |
|---|---|
| 某个 Agent 不可用 | 打开 Agents 与连接；检查安装、登录、投递模式、监听器、工作区与探测状态。 |
| 某个 Run 处于等待状态 | 请查看它的任务状态、审批、数据发送审核、人工关卡、预算或缺失的输入。 |
| 某个结果无法应用 | 请检查成果契约、来源修订版本、工作区能力以及审阅/关卡决策。 |
| 后台监听器没有认领任务 | 请确认 MCP Host、项目路由、监听器进程、具体的 Agent 以及当前工作区路径。 |
隐私
- 密钥始终以引用形式保存，不会展开为项目文本。
- 对外传输前，数据发送预览会显示目标与所选载荷。
- Agent 与 MCP 的访问权限受限、需通过能力测试，并会经过审阅边界。
- 审计历史会记录决策与结果，且不会有意暴露原始凭据。
您的责任： 请仅使用获得授权的服务商、工作区、主机、账户与工具；不要绕过审批、审计或安全控制。