这一版默认使用中文界面、系统本地字体和本地直连。飞书是设置中的首选消息入口。已有 Codex、Claude 等工具及 Telegram、Ably、Cloudflare 配置仍兼容；不会自动启用任何未配置的外部服务。
- 在 飞书开放平台 创建企业自建应用，开启机器人能力。
- 添加应用权限
im:message.p2p_msg:readonly（读取单聊消息）和im:message:send_as_bot（以机器人身份发送消息）。 - 打开办公室的“设置 → 飞书机器人”，填 App ID 和 App Secret，勾选启用后保存。界面仅在真实 WebSocket 握手成功后显示“已连接”；凭据不正确或连接超时会给出错误。
- 在飞书的“事件与回调”选择使用长连接接收事件，订阅
im.message.receive_v1。发布应用版本，将自己加入可用范围。 - 私聊机器人发送
我的ID，将返回的ou_…Open ID 加入办公室设置的“允许使用的用户”，再次保存。支持中英文逗号及换行分隔。 - 先在网页里添加成员或组建团队，再向机器人发送
成员，按返回的指令选择成员，然后直接发文字任务。
| 指令 | 功能 |
|---|---|
帮助 |
查看中文说明 |
我的ID |
查询发送者自己的 Open ID |
成员 / 状态 |
查看已加入办公室的成员及状态 |
选择 林悦 |
选定成员；重名时使用列表中的成员 ID |
| 普通文字 | 给当前选中的空闲成员派任务 |
取消 |
停止自己从飞书发起的当前任务 |
同意 审批编号 / 拒绝 审批编号 |
处理属于自己的审批 |
当前接入支持机器人私聊文本，不接收群聊指令、图片或附件。成员忙碌时提示稍后再发。通知仅回传同一发起人的对应任务，不群发其他人的结果。重启网关、停用或重配飞书会清除机器人当前的会话选择与通知路由；网页中的任务历史仍保留。
未填写允许用户时，只能查询自己的 ID，不能运行、取消或批准任务。App Secret 保存于服务端配置，前端只取得“是否已设置”，不回传明文。不要把真实密钥提交进仓库。
实现使用 飞书官方 Node.js SDK 的长连接，无需 Webhook 公网回调、Ably 或 Cloudflare。需要本机能够连接飞书服务，且网关保持运行。
已加入 Qwen Code（通义千问） CLI 适配器，支持任务执行、模型参数以及其沙箱/审批参数。工具未安装或未登录时不能执行真实模型任务；办公室不会代购额度或自动改写其他工具的全局凭据。
按 Qwen Code 官方中文文档 安装、登录并配置服务地址；中国内地使用应选择与账号和套餐对应的国内区域。普通 DashScope 与 Coding Plan 的地址不同，不能混用。配置完成后重启网关，在“设置 → AI 编程工具”检查是否检测到 Qwen Code，再在成员选择里切换到它。
网关保留已有的默认工具。若原默认工具已卸载，才选择实际检测到的工具；新安装且无历史设置时优先检测 Qwen Code。选人窗口遵循网关默认值，不再固定选中 Claude。Qwen Code 当前使用单次纯文本模式，由办公室管理上下文；未接入其原生会话续接。
需要沙箱模式时，应先按 Qwen Code 文档配置其沙箱运行环境。选用的模型、区域、权限与费用由对应 CLI 和服务账号控制。
macOS 启动时会比较 PATH 中的 Codex 与 /Applications、~/Applications 内 ChatGPT / Codex 桌面 App 自带的命令行版本，选用能正常运行的较新版本。启动日志会显示实际版本和路径。其他系统仍使用 PATH 中的 Codex；可用 PIKO_CODEX_PATH 指定可执行文件的绝对路径，指定路径无效时会明确报错。
这不会修改系统全局 Codex、登录凭据或默认模型。成员未单独指定模型时继续读取本机 Codex 配置；指定模型时传给 Codex。安全模式使用 workspace-write 沙箱，负责人使用只读沙箱，无交互执行时自动拒绝越界操作。若接口提示“模型需要更新版 Codex”，先核对日志中的实际版本，更新对应 CLI 或设置新版路径，再重启网关。
同一台电脑直接访问本地网关；同一局域网使用网关启动时显示的局域网地址。飞书消息功能与网页外网访问相互独立。
需要外网访问完整网页时，可在自己的服务器配置 HTTPS 反向代理或 FRP，再通过现有配对码连接。代理需支持 WebSocket 升级，并转发 Host / Origin 等连接信息。这里没有预置第三方中转域名，也没有自动部署穿透服务。原有 Cloudflare Token 入口已收进“原有海外连接（可选）”。
- 首选消息入口：加入飞书的真实收消息、任务转发、进度与结果通知和审批回传；旧海外连接收起为可选。
- 网页字体：移除 Google Fonts 网络请求，采用本机中文字体，页面加载不依赖海外字体站。
- 首页标题、浏览器安装名称、桌面任务完成通知、窗口标题及托盘菜单：补充中文；安装主题色沿用浅色界面。
- AI 工具：加入 Qwen Code，修正选人成员固定默认 Claude 的问题，保留全部原有选项。
- 任务报告：取消“必须英文”的要求，跟随用户语言，默认简体中文；机器解析字段名保持稳定。
- 技能：支持中文名称和文件名，中文角色名可搜索；限制名称为文字、数字、下划线和连字符，避免路径穿越。
- 首次配置和环境变量示例：改为中文、本地直连与飞书说明。
- 保留真实技术标识和开源来源链接：GitHub 项目地址、API 协议名、工具命令和许可证不伪装成国内服务。
验证不使用真实飞书凭据或模型额度：通过本地模拟检查权限、重复事件、跨会话隔离、审批与取消，并验证真实网关配置保存、默认工具下发、构建及原有功能。正式连接仍需由应用所有者填写凭据、开通权限并发布飞书应用。
桌面壳的中文标题和菜单已更新源代码，本次没有重新打包或安装桌面应用。