AI PASSPORT//
EN

使用指南 / 09

用豆包创造 AI Passport 玩法

在豆包电脑版的「豆包 工作」中打开本地玩法项目，让 Agent 完成开发与固件构建，并了解免费额度的限制。

01

认识 豆包

豆包电脑版是字节跳动推出的 AI 助手，「豆包 工作」模式可以在本地电脑上执行任务：把项目文件夹交给它，Agent 会阅读代码、修改文件并在后台终端运行命令。

  • 开发方：字节跳动
  • 支持系统：本教程在 macOS 上验证，其他系统以官网下载页为准
  • 使用前提：豆包账号；官网写明新用户可领 30 天免费体验套餐，免费额度按近 7 天计算，用完后需要等待恢复或开通订阅
  • 本教程使用的版本：2.34.6
提示
验证环境：macOS 26.6（Apple 芯片），2026 年 11 月 4 日实际安装并运行本教程的示例任务。
02

下载并安装 豆包

从官方网站下载安装包：doubao.com。请只使用官方渠道，不要安装来源不明的打包版本。

豆包电脑版官网下载页
从 doubao.com 下载豆包电脑版
  • 在官网下载页点击「下载豆包电脑版」
  • macOS：打开 .dmg，把豆包拖进「应用程序」文件夹，再从「应用程序」启动；不要直接在安装盘里运行
  • 安装完成后推出安装盘
03

登录并确认模型

首次打开时登录豆包账号，在左侧点击「新工作任务」。输入框下方的运行位置选「本地电脑」，权限保持默认的「按需确认」。右下角是模型菜单：本教程使用「自动」，推理强度「高」。

豆包工作的权限菜单
权限保持默认的「按需确认」
豆包工作的模型菜单
模型菜单：自动、豆包 2.1 Lite、豆包 2.1 Pro 和推理强度
  • 权限有三档：「始终询问」在编辑外部文件和使用互联网时都会询问；「按需确认」只对有风险的操作询问；「全部允许」不受限制地访问互联网和编辑电脑上的任何文件，不建议使用
  • 模型菜单列出「自动」「豆包 2.1 Lite」「豆包 2.1 Pro」（需升级）和「推理强度」（低、中、高）
04

打开 AI Passport 项目

点击输入框下方的「项目」，选择「通过本地文件夹创建项目」，在文件选择窗口中选中 AI Passport 项目文件夹，再在「创建项目」对话框中点击「创建」。完成后输入框下方和左侧「项目」列表都会显示这个文件夹。

豆包工作已选择 doubao-passport 项目
输入框下方显示本地电脑和项目文件夹
提示
可以先在终端运行 git clone https://gitee.com/FoloToy/ai-passport.git 把项目下载到本地；也可以选一个空文件夹，让 Agent 按提示词自己下载项目。
05

发送开发提示词

新建一个会话，把下面的提示词复制到输入框，把【填写应用需求】换成你想做的玩法，再发送。本教程的示例需求如下：

发送给 Agent 的提示词
请基于完整项目 https://gitee.com/FoloToy/ai-passport 开发；本地已有项目则复用。
先读 AGENTS.md 和 docs/README.md，按需查阅相关文档、硬件接口及示例，自行准备环境并安装项目要求的 Skill。
保留已有修改，新建分支开发。复用 BSP，重新设计应用界面，不照搬 demo；中文界面检查字体覆盖。关键需求不明确时询问，其余自主完成。
运行项目验证，交付可从 0x0 刷写的合并固件，说明测试结果与未验证项。完成后主动询问是否刷机测试，未经确认不烧录。
在豆包输入框中粘贴开发提示词
粘贴提示词并填好玩法需求
  • 一个番茄钟：开机进入 25 分钟专注倒计时；确定键开始 / 暂停，上下键在未开始时把时长调整为 5–60 分钟（每次 5 分钟）；倒计时结束时屏幕醒目提示并播放提示音，按确定键回到初始状态
06

让 豆包 完成开发与构建

豆包会先检查本地仓库，安装并核验项目要求的五个 Skill，新建 feature/pomodoro-timer 分支，然后复用电脑上已有的 ESP-IDF 5.5.3，补齐缺少的 Python 环境，编写倒计时状态机和中文界面，并运行主机测试和完整固件构建。右侧「工作进度」显示任务清单，「后台任务」里可以打开正在运行的终端。

豆包正在安装 Skill 并准备构建环境
Agent 安装 Skill、新建分支并准备 ESP-IDF，右侧显示工作进度
  • 本次只弹出一次确认：列出远程仓库中 demo 和 feature 开头的分支，选择允许即可
  • 运行约 4 分半时提示「额度紧张」，这时任务仍在继续
提示
完整开发一个玩法会消耗较多额度。本次示例在用时 19 分 3 秒时用完了近 7 天的免费额度，豆包没有写出最终总结。开始前确认额度充足，或准备好开通订阅。
07

查看结果

本次示例用时 19 分 3 秒。免费额度在最后一步用完，聊天里只显示「近 7 天免费额度已用完」，但后台终端里的构建已经跑完：Firmware build: PASS，合并固件 Merged firmware: PASS（1,012,800 字节，从 0x0 写入），项目里的 build/FoloToy-AI-Passport-full.bin 就是可安装的文件。番茄钟状态机的主机测试也已通过。

豆包提示近 7 天免费额度已用完
免费额度在最后一步用完，聊天里没有最终总结
豆包后台终端显示合并固件构建通过
后台终端里的构建结果：Merged firmware: PASS（1,012,800 字节）
  • 在右侧「后台任务」中点开构建终端，确认看到 Firmware build: PASS 和 Merged firmware: PASS
  • 终端里也会打印一个 /tmp/ai-passport-firmware… 下的路径，那是临时目录；请使用项目里的 build/FoloToy-AI-Passport-full.bin
  • 豆包没有提交代码，改动留在 feature/pomodoro-timer 分支的工作区；也没来得及列出未验证项
  • 中文字体覆盖检查写在固件里，开机时才会运行，安装到设备后要确认文字显示完整；屏幕、按键、提示音和倒计时都还没有在设备上验证
08

安装到 AI Passport 并验证

打开本地玩法安装工具，选择 Agent 交付的合并固件（从 0x0 写入的 .bin 文件），用支持数据传输的 USB-C 线连接 AI Passport 并开始安装。完成后设备自动重启，逐项检查屏幕、按键和声音。

  • 安装新玩法会覆盖设备当前的全部内容；之后可以随时恢复默认固件
  • 安装过程中不要拔线或关闭页面
  • 把与预期不一致的画面和按键表现描述给 Agent，让它继续修改并重新构建
09

常见问题

使用 豆包 开发 AI Passport 玩法时，可能遇到以下情况：

  • 提示「近 7 天免费额度已用完」：任务会停止回复，但已经在后台运行的构建可能已经完成，先到「后台任务」查看终端输出；之后等待额度恢复或开通订阅，再在同一任务中让它补充总结
  • 电脑上同时运行了两个豆包（例如一个从安装盘直接启动）：退出安装盘里的那个并推出安装盘，只保留「应用程序」里的豆包
  • ESP-IDF 已安装但没有激活或缺少 Python 环境：豆包会自己补齐，第一次构建因此更慢
  • 找不到固件：不要用终端里 /tmp 下的临时路径，使用项目里的 build/FoloToy-AI-Passport-full.bin