开始菜单任务
开始菜单任务是 MBAgent 的快捷入口，让您把常用的任务存成按钮，下次直接点击就能运行，不用每次重新描述。
一、什么是开始菜单任务？
开始菜单任务 = 一个保存下来的提示词模板 + 可选的运行环境配置。
| 场景 | 是否适合开始菜单任务 |
|---|---|
| "帮我写一封英文开发信" | ✅ 高频使用 → 存成任务 |
| "查询 223223 店铺今日订单" | ✅ 固定环境 → 存成任务 |
| "整理 D:\Downloads 下的文件" | ✅ 重复操作 → 存成任务 |
| "帮我写一首诗" | ❌ 一次性任务 |
二、打开开始菜单
MBAgent 主界面左侧或顶部都有 "开始菜单" 入口。点击后展示：
🔍[搜索]
📂 账号与浏览器
- 巡检所有账号
- 启动指定环境
📂 数据采集
- 今日订单汇总
- 商品价格采集
📂 文档处理
- 把 Excel 转 Markdown
- PDF 提取文字
📂 自动化脚本
- 运行晨检脚本
- 生成日报
三、运行一个开始菜单任务
第一步：找到任务
- 在开始菜单列表里浏览
- 或在搜索框输入关键词（如"订单"、"报告"）
第二步：点击任务
点击任务按钮，MBAgent 会自动：
- 加载任务描述
- 填入到输入框（您可以修改）
- 设置好运行环境（候鸟环境、模型等）
- 等待您点击发送
第三步：确认并发送
- 检查输入框内容（必要时修改）
- 点击 "发送" 按钮
- AI 开始执行任务
TIP
快速运行：双击任务按钮可以跳过第二步（不显示在输入框），直接开始执行。
四、内置任务分类
MBAgent 自带多个官方任务，按业务场景分类：
1. 账号与浏览器
- 巡检所有账号：检查每个账号的登录状态、Cookie、指纹
- 启动指定环境：通过环境 ID 启动候鸟环境
- 导出环境包：把候鸟环境打包备份
2. 数据采集
- 今日订单汇总：采集所有店铺的今日订单
- 商品价格采集：从指定网站抓取商品价格
- 客户信息整理：从多个数据源汇总客户信息
3. 文档处理
- Excel 转 Markdown：把 Excel 表格转成 markdown 格式
- PDF 提取文字：从 PDF 中提取文字内容
- 批量重命名：按规则批量重命名文件
4. 自动化脚本
- 运行晨检脚本：每天早上自动执行的检查脚本
- 生成日报：基于数据自动生成日报
- 批量发布：把内容发布到多个平台
5. 系统维护
- 检查候鸟浏览器版本：检测候鸟是否为最新
- 清理临时文件：清理工作区临时文件
- 备份重要数据：自动备份 AI 记忆库和 KMS
五、创建自定义任务
第一步：点击 "+" 按钮
在开始菜单顶部点击 "+" 按钮，弹出"新建任务"窗口。
第二步：填写任务信息
| 字段 | 说明 | 示例 |
|---|---|---|
| 任务名称 | 简洁明了 | "今日订单汇总" |
| 任务分类 | 选择或新建分类 | 数据采集 / 报告生成 |
| 任务描述 | AI 收到的提示词 | "汇总今天所有店铺的订单数，按金额降序排列，写入 reports/orders-YYYYMMDD.xlsx" |
| 图标 | 选择一个 emoji 或 codicon | 📊 |
| 运行环境 | 可选 | 候鸟环境 ID / 并发数 / 超时 |
第三步：使用变量（可选）
任务描述里可以用 占位符，运行前会让用户填写：
请把 {{客户名称}} 的 {{订单日期}} 订单整理成表格运行时：
[填入] 客户名称 = 候鸟旗舰店
[填入] 订单日期 = 2026-09-24第四步：保存
点击 "保存" 按钮，任务出现在开始菜单里。
六、编辑 / 删除 / 复制任务
编辑
- 右键点击任务 → "编辑"
- 修改名称、描述、变量等
- 保存
删除
- 右键点击任务 → "删除"
- 确认（不可恢复）
复制
- 右键点击任务 → "复制"
- 自动创建一个新任务（名称加"副本"）
移动到其他分类
- 右键点击任务 → "移动到..."
- 选择目标分类
七、自定义分类
新建分类
- 点击开始菜单的 "+" 按钮 → "新建分类"
- 输入分类名称（如"我的工作流"）
- 选择图标
- 保存
重命名分类
- 右键点击分类标题 → "重命名"
删除分类
- 右键点击分类标题 → "删除分类"
- 分类内的任务会移到"未分类"
八、开始菜单的同步机制
官方任务的更新
候鸟官方维护一份官方开始菜单 XML，发布新版本时会推送给所有 MBAgent 客户端：
mbAgent 本地 official.xml
→ POST /api/mbagent/start_menu_manifest
→ 返回 version + 目录树 + 每个任务 content_hash
→ 本地按 SHA-256 复用未变化 prompt
→ POST /api/mbagent/start_menu_contents
→ 校验每条 prompt 的 SHA-256
→ 重建完整 official.xml
→ 原子替换本地缓存关键设计：
- ✅ 客户端只下载变化的部分，不是整包
- ✅ 校验 SHA-256，确保 prompt 没被篡改
- ✅ 失败时保留旧本地 XML，不破坏体验
自定义任务的同步
自定义任务只存在本地，不会自动同步到云端。
如需多设备共享：
- 手动导出任务列表（JSON）
- 在另一台机器导入
九、快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl + Shift + M | 打开开始菜单 |
↑ / ↓ | 在任务列表里上下移动 |
Enter | 运行当前选中任务 |
Esc | 关闭开始菜单 |
十、最佳实践
任务命名技巧
✅ 好的命名：
- "今日订单汇总"
- "亚马逊店铺巡检"
- "Excel 转 Markdown"
❌ 不好的命名：
- "任务1"
- "新建任务"
- "test"
任务描述写法
✅ 好的描述：
汇总今天所有店铺的订单数（包括订单 ID、金额、客户、状态），
按金额降序排列，写入 reports/orders-{今天日期}.xlsx。
如果有订单金额 > 1000，在备注列标注"大单"。❌ 不好的描述：
汇总订单何时创建任务
- ✅ 每周 / 每天重复做的事
- ✅ 跨团队多人共用的事
- ✅ 复杂、容易忘参数的事
❌ 一次性任务没必要存
任务版本管理
建议在任务描述里加个版本号：
[版本 1.2 - 2026-09-24]
汇总今天所有店铺的订单...方便后续维护。
十一、常见问题
Q1：内置任务不见了 / 被改乱了
解决：在 "设置 → 开始菜单" 里点击 "恢复官方菜单"。
Q2：能不能分享我的自定义任务给同事？
可以：
- 右键点击任务 → "导出" → 保存 JSON
- 发给同事
- 同事右键 → "导入" → 选择 JSON
Q3：任务运行时出错了怎么办？
- 查看错误信息
- 检查任务描述是否清晰
- 检查运行环境配置（候鸟环境是否在线）
- 必要时重新编辑任务
Q4：开始菜单的任务数量有上限吗？
理论无上限，但建议保持 < 50 个，否则查找困难。
下一步：定时任务与循环 → 让 AI 自动按周期干活。