# Remote Cli **Repository Path**: sunshinewithmoonlight/remote-cli ## Basic Information - **Project Name**: Remote Cli - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-02-28 - **Last Updated**: 2026-11-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # remote-cli ## 这是什么 `remote-cli` 是把飞书机器人接入本机 AI 运行时的常驻服务,并提供可信设备远程控制与浏览器 Agent 能力。 你可以在飞书中向主机上的 Codex 下达任务、提交附件,并通过流式卡片查看执行进展与结果;也可以让它在已授权的设备和浏览器中执行操作。它负责消息接入、会话管理和任务执行衔接,不是模型服务本身。 ## 项目功能 - 飞书消息接入 Codex RPC,多 Bot 独立运行时,按 Bot/chat 隔离会话。 - 可选 URL 聊天入口复用指定 Bot 的同一 chat 绑定与串行队列,提供纯文本流、分段拉取和 turn-local 额外表达约束。 - 流式交互卡片、异步标题、工具调用计数、固定间隔刷新和失败状态展示。 - 同一会话连续消息通过 active-turn steer 处理;支持 `/new`、会话恢复、空闲维护、rollover 和 completed history。 - 原生 `/goal` 目标、会话 Heartbeat、系统定时任务,以及显式跨会话目录、消息注入和只读查询。 - 附件下载与一次性提交,可选图片/PDF OCR、音频转写和 Prompt Recall CSV 热加载。 - 可信设备 Agent 的命令执行、文件传输、自启动管理和远程升级。 - Safari Userscript 与 Chrome/Firefox 浏览器 Agent 的 DOM、JavaScript、输入和网络观察。 - 本机服务管理、LaunchAgent 自启动、健康检查、固定版本内嵌 Codex app-server 与签名发布构建。 部署、命令示例、架构及版本资料统一从 [文档目录](docs/README.md) 查阅;实现行为见 [会话与卡片](docs/chat-behavior.md)。 ## macOS 快捷指令(无密钥版) [146 动作无密钥快捷指令 v0.9.12-fix](https://gitee.com/sunshinewithmoonlight/remote-cli/releases/download/v0.9.12-fix/remote-cli-url-chat-keyless-146-v0.9.12-fix.shortcut) 可在导入后连接已启用的 URL 会话入口。它的 `Result URL` 完全省略 `timeout_s`,不会在约 5 分钟时因旧的 300 秒窗口返回空响应。 签名附件 SHA-256:`a79b40895f958507c853384858291d291e4639abb34658b9d99f87acff694a48` 导入时会依次询问四项配置: - `URL token text`:填写你自己的 remote-cli URL API token。它不是模型密钥或 Bot secret;公开分享副本会保持为空。 - `Base URL / IP text`:填写完整服务地址,包括协议、IP 或主机名和端口,例如 `http://127.0.0.1:6231`。 - `BOT ID text`:填写目标机器人的 App ID,不是群 `chat_id`。 - `extra prompt text`:填写每次请求附加的表达要求,不是提问内容,也不是密钥。 发布文件已使用 `shortcuts sign --mode anyone` 签名,并核验 146 个动作、四项导入问题索引 `2/4/6/9`、空白 token/Base URL/Bot ID、状态错误守卫和无正文继续等待分支。iPhone、HomePod、Siri 实机运行以及 2 至 3 秒收音停顿尚未验证。 Submit 请求仍显式使用 `timeout_s=60` 限制接收等待;`Result URL` 不设置 `timeout_s`,会读取到正文、终态、客户端断开或服务停止。该快捷指令不使用 `ack_text`,所以 POST 返回值继续作为 request ID。详见 [URL API](docs/url-api.md)。 ## 配置模板说明 [config.example.yaml](config.example.yaml) 是完整的标准配置模板,使用占位凭据,不是可直接投入运行的真实配置。`setup` 默认生成 `~/.runtime/remote-cli-service/remote-cli.yaml`,权限为 `0600`;手工复制模板后也应限制权限。不要提交或在日志中输出真实凭据。 下表的示例值以模板为准,不等同于字段省略时的程序默认值。完整规则与兼容迁移分别见 [配置详解](docs/configuration.md) 和 [版本迁移](docs/version-migrations.md)。 ### 服务与会话 | 模板字段 | 含义 | | --- | --- | | `port` | 本机 HTTP、健康检查与控制入口监听端口;模板为 `6230`。 | | `codex_full_access` | 模板为 `true`,允许 Codex 不受普通沙箱隔离限制地操作主机,仅用于可信环境。 | | `latest-reply-only` | 最新回复展示策略的高级兼容字段,模板为 `true`。 | | `codex_rpc_proxy_ip` / `codex_rpc_proxy_port` | Codex 子进程 HTTP 代理;模板为空和 `0`,表示直连。 | | `current-card-color` | 飞书卡片 header template;模板为 `blue`,也支持列表加权随机或单独的 `all`。同一 native session 保持同色。 | | `main_chat_history_auto_resume` | 是否使用持久化 native thread 并在服务重启后尝试恢复;模板为 `true`。 | | `chat_session_rollover_after_completed_sec` | 严格整数。`0` 为终态历史落盘且 thread 排空后立即轮换;正数按最终卡 ACK 后空闲秒数轮换;省略或负数关闭。rollover 保留历史,`/new` 与 renew 清空历史。 | | `main_chat_auto_renew_idle_timeout_h` | 空闲后新开会话的小时数;模板为 `2`,程序省略时默认为 `24`。 | | `main_chat_auto_compact_idle_timeout_h` | 空闲后调用原生 compact 的小时数;模板为 `0`,关闭自动 compact。 | | `prompt_recall_csv_path` | Prompt Recall CSV 路径;空值禁用。三列表头为 `RE表达式,回忆,描述`。后台约每 1 秒检测,并在每次实际匹配前安全刷新;坏更新保留上一份有效快照。正常启动可降级,`--dry-run` 仍严格校验。 | | `debug_codex_stream` | Codex 中间事件调试日志开关;模板为 `false`。 | | `card_title_generation` | 独立临时 thread 异步总结卡片标题;模板为 `true`。卡片先显示脱敏预览,生成失败不阻塞主 turn。 | | `refresh_card_interval_sec` | 同一卡片成功刷新之间的固定秒数,模板为 `1`;接受正的有限整数或小数,无效值回退为 `1`。首卡立即发送。 | | `url_port` | 可选独立 URL 会话入口端口;省略关闭。仅十进制 `1..65535` 启用,无效值只禁用该子服务。 | | `url_host` | URL 子服务监听地址,默认 loopback `127.0.0.1`;非 loopback 需要独立高熵 token。 | | `url_token` | 可选 Bearer token;不能复用 Bot、模型或 Relay 秘密。详见 [URL API](docs/url-api.md)。 | ### 飞书与附件 | 模板字段 | 含义 | | --- | --- | | `feishu-api.timeout_s` | 轻量飞书 OpenAPI 请求超时,模板为 `8` 秒。 | | `feishu-api.upload_timeout_s` | 上传超时,模板为 `120` 秒,不能小于轻量请求超时。 | | `immediately-process.image` / `audio` | 模板为 `true`,附件上传后立即处理。 | | `immediately-process.file` / `media` | 模板为 `false`,等首次文本消费待提交草稿;附件不会自动用于后续 turn。 | | `paddle-OCR.status` / `access-token` | OCR 开关和凭据;模板关闭,启用时 token 必填。 | | `paddle-OCR.base-url` / `model` | OCR 服务地址和模型;模板使用 PaddleOCR 服务与 `PaddleOCR-VL-1.6`。 | | `paddle-OCR.request-timeout-s` / `poll-timeout-s` | OCR 请求及轮询超时,模板分别为 `300` / `600` 秒。 | | `paddle-OCR.max-result-chars` | OCR 结果 Unicode 字符数上限;模板 `0` 表示不截断。 | | `audio-doubao-STT.status` / `app-id` / `access-token` | 豆包音频转写开关和凭据;模板关闭,启用时两项凭据必填。 | ### Bot 与运行目录 | 模板字段 | 含义 | | --- | --- | | `bots[].bot-type` / `id` / `secret` | 飞书 Bot 类型、App ID 和 App Secret;至少配置一个 Bot,模板为 `feishu`。 | | `bots[].codex.base_url` / `api_key` | 对应 Bot 的模型 provider 地址和凭据;模板地址为本机 `8788/v1`。 | | `bots[].codex.model` / `reasoning_effort` | 对应 Bot 的模型名和推理强度;模板示例为 `gpt-5.5` / `xhigh`,并非可用性承诺。 | | `bots[].codex.auto_compact_length` | 注释中的可选正整数 token 上限;省略则沿用 app-server 默认压缩阈值。 | | `bots[].codex.chat_session_continue_with_rollover_after_inner_failed` | 注释中的可选布尔值,默认 `false`;启用后对结构化可恢复的内部重试错误执行有界无进展恢复,确认旧 turn 停止后保留历史并隐藏续接一次。 | | `bots[].prompt_per_turn` | 对应 Bot 的每轮运行策略,作为 operator note 注入,不是用户原文。 | | `schedule.system_tasks_root` | 系统任务和运行时根目录;空值使用 `~/Library/Application Support/remote-cli`。各 Bot 的 `CODEX_HOME` 在其 `codex-home/` 下隔离。 | | `heartbeat.renew_before_run` | Heartbeat 默认是否先新建会话;模板为 `false`,只有明确 renew 才清理旧会话。 | | `remote-agent.enabled` | 是否启用远程 Agent 控制,模板为 `false`。 | | `remote-agent.server-relay.cloudflare-workers-url` / `key` | 控制端 relay 地址和 control relay key;设备/浏览器使用另一类 agent relay key,不得混用或提交真实 key。 |