SuperAPI AI 工具集

duoduo-ambient

办公与效率

查看项目

更新于 10-16 03:10

技能介绍

用途:从零到一驱动搭建 ambient 频道,使所有者能从多多随身 App 和 FoloToy AI Passport 与 duoduo 交谈。频道运行在本机,连接所有者可访问的 cerebellum,并通过 tailscale serve 向 tailnet 上的一个 pocket 房间提供 HTTPS 访问。所有者只需在终端提供 cerebellum 令牌、逐项批准变更,并在手机和 Passport 上完成操作。

前置条件(非本技能工作):可访问的 cerebellum(wss:// URL 与令牌)、iPhone 上的多多随身 App(TestFlight 测试版)、可选的刷了 pocket 固件的 FoloToy AI Passport、本机的 Tailscale 及手机使用的同一 tailnet 账号。

主要步骤:0) 检查 duoduo daemon 状态、已装频道、tailscale 状态与 serve 状态,确认各前置条件。1) 安装频道:duoduo channel install @openduo/channel-ambient。2) 配置环境变量:在 ~/.config/duoduo/.env 中写入 AMBIENT_HTTP_PORT、AMBIENT_CEREBELLUM_URL,令牌由所有者本人写入,绝不经过聊天。3) 创建 pocket 房间:duoduo channel ambient room add <room_id> --workspace <绝对路径> --runtime <runtime> --name "<显示名>" --pocket。4) 发布到 tailnet:tailscale serve --bg --https=443 http://127.0.0.1:<port>,并配置 AMBIENT_HTTP_HOSTS 与 AMBIENT_HTTP_ORIGINS。5) 启动并验证:duoduo channel ambient start,检查 healthz 与 api/state。6) 连接手机 App,字段为频道主机、端口 443(HTTPS 开启)、房间名。7) 配对 Passport。8) 编写交接说明。

限制与政策:仅限 tailnet,禁止公网入口;不得改动既有 serve 路由、tailnet 策略或防火墙,只增不改;令牌不得出现在聊天、日志或输出中;每项变更须所有者逐项确认;一个房间一个频道、一部手机一个房间;传输健康不等于语音验收,验收由所有者实际完成。故障排查见 references/channel.md,操作与回滚见 references/operations.md。