☰
lark-coding-agent-bridge 斜杠命令完整清单:15+ 条命令玩转远程编程
2026/10/4 8:28:47 网站建设 项目流程

lark-coding-agent-bridge 斜杠命令完整清单:15+ 条命令玩转远程编程

【免费下载链接】lark-coding-agent-bridgeBot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI. Streaming cards, per-chat sessions, multiple workspaces项目地址: https://gitcode.com/gh_mirrors/fe/lark-coding-agent-bridge

lark-coding-agent-bridge 是一款把飞书 / Lark 消息与本地 Claude Code 或 Codex CLI 打通的轻量级 Bot:一条命令启动、扫码绑定应用,就能在飞书里指挥本机编程助手。本文带你完整速览飞书内的全部 15+ 条斜杠命令,从会话管理到访问控制,快速玩转远程编程 🚀

lark-coding-agent-bridge 是什么?

简单来说,它是一个"飞书 ↔ 本机 Agent"的桥:

  • 📩 在飞书私聊直接发消息,或群里@bot,任务自动转给本机 Claude Code / Codex CLI
  • 🃏流式卡片:回复文本和工具调用实时更新在同一张卡片上
  • 🧵会话隔离:每个聊天、话题或文档评论各自拥有独立会话,互不串台
  • 📂多工作空间:随时切换项目目录、保存常用目录别名
  • 🖼️ 图片、文件可以直接发给 Bot,bridge 会下载到本地交给 Agent 处理

详细背景可以查看项目说明:README.zh.md。所有斜杠命令的分发逻辑集中在 src/commands/index.ts,想深入源码的同学可以从这里读起。

斜杠命令总览速查表

分类命令一句话说明
会话/new、/reset清空当前会话(可中断进行中的任务)
会话/new chat [名称]一键新建群聊并绑定新会话
会话/resume、/resume use <code>查看 / 恢复历史会话
会话/stop终止当前正在运行的任务
目录/cd <path>切换工作目录并重置会话
目录/ws list / save / use / remove管理命名工作空间
状态/status查看 profile、目录、会话、队列等状态
状态/doctor [描述]自助诊断
状态/timeout [N\|off\|default]设置当前会话空闲看门狗
状态/reconnect强制重连 WebSocket
配置/config交互式表单改各种偏好
配置/account、/account change查看 / 更换应用凭据
权限/invite、/remove管理白名单与管理员
进程/ps、/exit <id\|#>列出 / 关闭本机 Bot 进程
帮助/help交互式帮助卡片

速查表也可以直接对照官方文档:README.zh.md

会话管理命令:让对话随时可控

/new 与 /reset:一键开新会话

私聊里直接发/new(别名/reset)即可清空当前会话。如果当时 Agent 正在跑任务,它会先中断任务再开新会话,避免"新指令被旧上下文带偏"。

另外还有个彩蛋命令:/new chat [名称]会自动新建一个群聊并把你拉进去,新群直接继承当前工作目录,非常适合"一个项目一个群"的多线并行玩法。

/resume:找回历史会话

发/resume会列出当前工作目录下最近的历史会话(默认 5 条,/resume 10可看 10 条),返回一张带按钮的交互卡片,点"恢复此会话"即可续聊;也可以手动发/resume use <code>恢复。注意两点:

  • 历史会话只能在私聊里查看和选择(群里不会展示会话详情)
  • 恢复候选码 10 分钟内有效,过期重新/resume即可

/stop:紧急刹车

Agent 跑偏了?发/stop立刻终止当前任务,也可以直接点流式卡片底部的 ⏹ 按钮。管理员还可以发/stop comment:<scopeHash>精确停止某个云文档评论任务。

工作目录命令:多项目一键切换

/cd:切换工作目录

/cd /Users/me/project-a /cd ~/code/project-b

切目录会同时重置会话(因为上下文跟着项目走)。路径必须是绝对路径或~/开头,bridge 还会自动拦截/、home 根目录这类范围过大的危险位置。

/ws:常用目录存成别名

天天/cd太长?用/ws把目录存成命名工作空间:

命令作用
/ws list列出所有命名工作空间(交互卡片)
/ws save <name>把当前目录保存为别名,如/ws save main
/ws use <name>切换到别名对应目录
/ws remove <name>删除别名

/ws list返回的卡片上每个工作空间都带"切换到此处"和"删除"按钮,点一点就能换项目,完全不用手敲路径 📂

状态与排障命令:问题定位三件套

/status:一眼看懂 Bot 现状

/status返回一张状态卡片,包含:profile 名称、当前 cwd、会话 ID(是否过期)、Agent 类型、权限模式、lark-cli 身份、正在运行的任务、并发队列占用情况。卡片底部还挂了"新会话 / 恢复会话 / 工作目录 / 帮助"四个快捷按钮。

Bot 突然不理人?先发/status—— FAQ 里也推荐这个姿势:通常要么是本地claude/codex没登录,要么是当前会话指向了已不存在的目录,发个/new就能修复。

/doctor:让 Agent 帮你诊断 Agent

/doctor [问题描述]会执行一套低敏自检:工作目录是否可用、访问策略是否放行、Agent 回显检查(echo check)……结果会流式推送到卡片上;在群里发起时,详细报告会私信发给你,避免暴露给群成员。同一用户 30 秒内只能触发一次,防止误刷。

/timeout 与 /reconnect:保活与重连

  • /timeout 15:当前会话设置 15 分钟空闲看门狗,Agent 卡死超过 15 分钟自动杀掉并标注原因;/timeout off关闭,/timeout default清除会话级覆盖回退全局
  • /reconnect:网络抖动后 Bot 失联时的强制 WebSocket 重连开关,加--wait可以等当前任务跑完再重连

配置与账号命令:/config 和 /account

/config:一张表单搞定所有偏好

/config会弹出一张交互式表单卡片,不用改任何配置文件即可调整:

  • 消息回复方式:流式卡片 or 纯文本一次性发送
  • 工具调用显示:最终回复里是否展示工具块
  • COT 过程消息:关闭 / 简略 / 详细三档,决定过程信息展示粒度
  • 模型选择、最大并发任务数(1-50)、全局空闲超时
  • 群里是否需要 @:关掉后群里不用 @ 也能触发(会自动引导补充所需权限)
  • lark-cli 身份策略:bot-only(只用应用身份)或user-default(可用已授权的用户身份)
  • 访问控制名单:直接维护允许用户、响应群、管理员

表单底部还有本地 Web 控制台入口(如果启用了 supervisor)。提交后卡片原地翻转为"已保存"结果,失败会自动回滚并提示原因。

/account:更换应用凭据

/account查看当前绑定的 App ID / Bot 名称;/account change弹表单输入新的 appId 和 secret,校验通过后凭据加密落盘,bridge 自动用新凭据重连。适合应用迁移或 secret 泄露后快速换绑。

访问控制命令:谁可以用你的 Bot?

默认策略:只有创建者本人能用(就是扫码绑定应用的那个人),其他人的消息会被静默忽略,不会收到"权限不足"的提示。要放人进来,用下面两条命令(仅创建者和管理员可执行,权限判定见 src/policy/access.ts):

命令作用
/invite user @某人允许对方私聊使用 Bot
/invite admin @某人添加管理员(可改配置、任意群里可用)
/invite group把当前群加入响应群名单(对该群所有人开放)
/invite all group一键把 Bot 所在的所有群加入名单
/remove user @某人//remove admin @某人//remove group对应的移除操作

注意@指向的是目标用户而不是 Bot,Bot 会自动解析 @ 到对方身份,你不需要碰任何 open_id。改动即时生效,不用重启 🎯

进程管理命令:/ps 与 /exit

跑多个 profile(比如一个 Claude Bot + 一个 Codex Bot)时:

  • /ps:列出本机所有在跑的 bridge 进程表格,标注"当前正在回复你的那个"
  • /exit <id|#>:用/ps里的短 ID 或序号关闭指定 Bot;退出自己则优雅断开后退出

新手推荐工作流:5 步上手

  1. 启动后私聊发/cd /path/to/project,把 Bot 指到你的项目
  2. /ws save main存个别名,下次/ws use main秒切
  3. 直接甩需求、甩图片文件,盯着流式卡片看 Agent 干活
  4. 跑完发/status确认状态;下次继续用/resume找回上下文
  5. 卡住了依次试/doctor、/new、/reconnect

完整命令分发实现见 src/commands/index.ts,帮助卡片的文案模板在 src/card/templates.ts,命令相关测试集中在 tests/commands/ 目录,供进阶阅读。

常见问题小抄

  • ❓群里 Bot 不响应?默认需要@bot(@all无效);且该群必须先/invite group加入名单
  • ❓命令提示"仅管理员可用"?/cd、/config、/invite等敏感命令被纳入了管理员白名单,普通用户执行会被拒绝
  • ❓数据都在哪?配置在~/.lark-channel/config.json,各 profile 的会话、工作空间、日志在~/.lark-channel/profiles/<name>/下
  • ❓私聊要 @ 吗?不用,群聊才要

加入反馈群

使用 lark-coding-agent-bridge 斜杠命令过程中遇到问题或有新想法?扫码加入官方反馈群,和其他玩家一起交流远程编程玩法 👇

掌握这套 15+ 条斜杠命令后,你的飞书聊天框就是一个随时待命的编程工作站:开会时甩个 bug 描述,通勤路上切工作空间,回家再看流式卡片里的执行结果。上手只需一条/help,剩下的交给 Bot ⚡

【免费下载链接】lark-coding-agent-bridgeBot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI. Streaming cards, per-chat sessions, multiple workspaces项目地址: https://gitcode.com/gh_mirrors/fe/lark-coding-agent-bridge

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询