dsh-lark

https://github.com/ChengqianHuang/dsh-lark · topic: dsh-plugin

个人侧 Lark/飞书桥接 bundle：在飞书里给机器人发消息，消息实时驱动本机 dsh 会话，会话跑完把最终回答回复到聊天里。飞书是遥控器，dsh 是引擎，lark-cli 是两侧的传输层。

安装与使用见 dsh 用户文档 docs/user/develop/basic/publish.md。设计决策见 DESIGN.md。

安装（dsh 源码运行模式下）

本仓库 clone（或 link）到任意位置后，在 dsh 仓库根目录安装进 profile：

# 从本仓库的本地 clone 安装（link 模式，源码即生效）
pnpm dsh plugin --profile web add /path/to/dsh-lark
pnpm dsh --profile web --dump-config               # 验证出现 "# == dsh-lark" 层
pnpm dsh web                                       # 启动后从飞书对话

卸载：pnpm dsh plugin --profile web remove dsh-lark。

前置条件（加载时逐项响亮校验）：

lark-cli 在 PATH 中（或用 larkCliPath 指定绝对路径），且应用已开通「接收消息」事件（im.message.receive_v1）；
配置里的 workspacePath 会自动创建。

配置（可选，写进 profile 的 cordis.patch.yml 或由默认值兜底）：

- id: lark
  name: dsh-lark
  config:
    # larkCliPath: lark-cli              # 默认走 PATH
    # identity: bot                      # 收消息用 bot 身份，无需 auth login
    allowedSenders: [ou_c4198d18421b0749d2a7c79409a76ef3]   # 建议显式配置
    # allowedChats: []                   # 空 = 机器人能听到的所有会话
    # workspacePath: ~/.dsh/lark/workspace
    # sessionIdleMinutes: 30             # 聊天闲置多久后，下一条消息开新会话
    # restartDelayMs: 3000               # 消费进程崩溃后的重启延迟
    # maxReplyChars: 4000                # 回复长度上限，超出截断
    # titlePrefix: "[lark] "             # web UI 会话标题前缀
    # agentPreset: coder                 # 可选：挂进驱动会话的 agent preset
    # permissionPreset: yolo             # 可选：驱动会话的权限 preset

触发规则

私聊：机器人收到的每条文本消息都是命令。
群聊：只有 @机器人 的文本消息是命令（飞书本身也只向机器人推送 @它的群消息）。
消息原文（含 @前缀）原样进入会话；event_id 去重，重连补投不会重复执行。
allowedSenders / allowedChats 为空表示不限制；个人机建议配白名单。

斜杠命令

以 / 开头的消息（群聊里 @机器人后跟命令）控制桥接本身，不进入 agent：

/new — 结束当前会话，下一条消息开始新会话
/stop — 立即停止正在运行的回合（旁路排队，即时生效）
/status — 查看当前会话与闲置倒计时
/help — 显示可用命令

未知命令会回复提示，不会转发给 agent。@前缀按机器人显示名精确剥离（加载时自动从 API 获取，botName 配置可覆盖；拿不到名字时退化为首 token 启发式），所以发给 agent 的文本不再带 @机器人 噪声。被停止的回合回复「已停止本轮」。

会话映射与回复

每个 chat 最多挂一个活跃会话；首条消息创建会话（出现在 web UI 的 workspace 列表，标题带 titlePrefix）。
会话空闲超过 sessionIdleMinutes 后，该聊天下一条消息开新会话，旧会话正常释放。
每条消息是一次独立的 followup 回合；会话运行中再来的消息由 agent 自行排队。
回合结束后取最后一段 assistant 文本，优先 +messages-reply 回到触发消息，失败则退回 +messages-send 发到聊天；超过 maxReplyChars 截断。
创建会话、回合执行、回复发送失败都会把错误文本发回聊天，不静默。

构建 / 测试

(cd dsh-lark && pnpm install --ignore-workspace --config.auto-install-peers=false)
(cd dsh-lark && pnpm exec tsdown)                    # 产出 lib/index.mjs
pnpm exec vitest run --config dsh-lark/vitest.config.ts
pnpm exec tsc -p dsh-lark/tsconfig.json --noEmit

修改源码后重新 pnpm exec tsdown 即可（profile 里是 link，指向本目录）。类型检查读取 DSH 各依赖包的声明文件；首次运行前需先构建上层 DSH 仓库。

dsh-lark

同名套件的其他儲存庫

安裝

說明文件

dsh-lark

安装（dsh 源码运行模式下）

触发规则

斜杠命令

会话映射与回复

构建 / 测试