随身任务终端 slinxiaosun-blip/ai-passport-dsh

简体中文 · English

DSH Passport

把 FoloToy AI Passport 变成 DeepSeek Harness（DSH）的口袋任务终端。

直接在设备上管理电脑里跑着的 AI 任务：

| 能做什么 | 说明 |
| 任务面板 | 浏览、切换、新建 DSH 任务；正在跑的任务会显示当前步骤和正在执行的操作 |
| 完成提醒 | 任务结束时弹出横幅并播放提示音，成功、失败、中断各有不同音效；有未读任务时显示红点 |
| 审批工具调用 | 电脑上的 AI 碰到文件或要执行命令时，设备弹出授权页；用上下键选择允许或拒绝；倒计时结束默认拒绝 |
| 说话下指令 | 按住录音，松开结束；中文语音转成文字，填进电脑的输入框 |
| 查看余额 | 按住下键查看 DeepSeek 余额概览 |

连接方式是直接蓝牙连到电脑：不用 Wi-Fi，不用配网，不用密码。首次配对时设备显示 6 位数字，在电脑上输入一次即可；每次开机数字都会变。

需要配套的电脑端插件

这份固件只覆盖设备这一半；完整体验还需要电脑端插件：

电脑端插件：slinxiaosun-blip/dsh-ai-passport-plugin

它负责蓝牙链路、任务桥接、语音识别和桌面小组件。
安装时克隆那个仓库，运行 npm run install-plugin（macOS 和 Windows 是同一条命令，安装脚本会自动适配两个平台）。细节见那个仓库 README 的「Quick Start」。

固件和插件的协议版本必须一致（目前是 protocol v1）。
固件不挑宿主平台：同一份镜像在 macOS 和 Windows 的 DSH 客户端上都能用，刷一次就够。设备是纯 BLE 外设，分包按协商好的 MTU 走，配对用应用层数字码——这些都不依赖宿主操作系统。

下载固件（无需自行编译）

最新固件在 Releases 页面；下载 FoloToy-AI-Passport-full.bin，从 0x0 一次刷入：

macOS / Linux (serial ports look like /dev/cu.usbserial-XXXX or /dev/cu.wchusbserial-XXXX)
esptool.py -p /dev/cu.usbserial-XXXX write_flash 0x0 FoloToy-AI-Passport-full.bin

Windows (serial ports look like COM5; check Device Manager)
esptool.py -p COM5 write_flash 0x0 FoloToy-AI-Passport-full.bin

刷机会覆盖设备上已有的固件，也不保证原有设置能保留。刷之前先记下当前固件版本，以便你可以回滚。要恢复出厂固件，请使用 AI Passport Web Flasher。

自行构建

需要 ESP-IDF v5.5.3（安装在仓库之外，路径不能带空格）：

Repository checks + logic tests (seconds, no hardware needed)
./tools/validate.sh --static

Full build producing a merged image flashable from 0x0 (minutes)
./tools/validate.sh --firmware

产物：build/FoloToy-AI-Passport-full.bin

烧录（会覆盖设备上的固件）：

macOS / Linux
esptool.py -p /dev/cu.usbserial-XXXX write_flash 0x0 build/FoloToy-AI-Passport-full.bin

Windows
esptool.py -p COM5 write_flash 0x0 build/FoloToy-AI-Passport-full.bin

要恢复出厂固件，请使用 AI Passport Web Flasher。
构建环境搭建、常见偏差、插件安装，以及启用语音模型，见插件仓库的 docs/03 build and flash guide。

版本

固件版本来自 version.txt（当前为 1.1.0）；构建时会自动追加一段短 git hash，例如 1.1.0+g1a2b3c4-dirty。握手时会把该字符串上报给电脑，小组件的信息单元格会显示设备上实际运行的版本。

- 1.1.0 — 与插件 1.1.0 一同发布（插件侧现在同时适配 macOS 和 Windows 的 DSH 客户端）。固件行为与 1.0.0 完全一致；本次发布只是对齐版本号，一次烧录即可覆盖两个主机平台。
- 1.0.0 — 首个完整版本（任务板 / 审批 / 余额 / 语音 / 配对）。

来源与许可

本仓库由 slinxiaosun-blip 基于上游 FoloToy/ai-passport main @ 0b9e4c8（MIT）二次开发。所有改动都在 feature/dsh-passport 分支上：

- 新增：main/app_*.c/.h 设备应用（蓝牙链路、任务板、审批、问答、语音、配对、设置）
- 侵入式改动：components/bsp 中的四处，以及 main/CMakeLists.txt、 main/main.c、sdkconfig.defaults、tests/bsp_stubs、tools/
- 上游 main 分支与 FoloToy/ai-passport 保持同步，不包含本项目的任何改动

按上游 MIT 许可发布；原始版权归 FoloToy 所有。