@sugarforever/dsh-lark

配置长连接事件

1. 进入“事件与回调”或“事件订阅”。
2. 在事件接收方式中选择“使用长连接接收事件”。
3. 不要填写 Webhook 请求地址。
4. 添加事件 im.message.receive_v1。
5. 保存配置。

长连接模式由插件主动连接飞书，因此本地电脑、内网服务器和没有公网入口的开发环境都可以运行。

配置环境变量

在启动 Harness 的同一个终端中设置凭据：

export FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
export FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

也可以把变量放进仅限当前用户读取的启动脚本或服务配置中。不要提交包含真实凭据的 .env、YAML 或 Shell 文件。

如果使用国际版 Lark，变量名仍然可以保持不变，平台由后面的 domain 配置决定。

完整配置

下面的例子包含目前支持的所有配置项：

- id: lark-channel
  disabled: false
  config:
    appId: !!js process.env.FEISHU_APP_ID
    appSecret: !!js process.env.FEISHU_APP_SECRET
    domain: feishu
    requireMention: true
    dmMode: open
    groupAllowlist:
      - oc_xxxxxxxxxxxxxxxx
    dmAllowlist:
      - ou_xxxxxxxxxxxxxxxx
    provider: deepseek-official
    model: deepseek-v4-flash
    workspace: /absolute/path/to/workspace
    agentPreset: coding
    errorMessage: 抱歉，处理这条消息时遇到了问题，请稍后重试。

配置项	必填	默认值	说明
appId	是	无	飞书或 Lark 应用的 App ID
appSecret	是	无	应用的 App Secret，建议从环境变量读取
domain	否	feishu	中国版使用 feishu，国际版使用 lark
requireMention	否	true	群聊是否必须 @机器人
dmMode	否	open	单聊策略：open、allowlist 或 disabled
groupAllowlist	否	[]	允许使用机器人的群 chat_id 列表；空数组表示不限制
dmAllowlist	否	[]	dmMode: allowlist 时允许访问的用户 open_id 列表
provider	否	Harness 默认值	为这个渠道指定模型 Provider
model	否	Harness 默认值	为这个渠道指定模型
workspace	否	第一个已注册 Workspace；没有时为 DSH 进程工作目录	Agent 使用的工作目录；显式路径优先
agentPreset	否	Harness 当前默认 Preset	Agent 使用的 Preset，决定工具、系统提示等组合
errorMessage	否	内置中文提示	Agent 执行失败时返回给用户的文本，最长 500 个字符

provider 和 model 建议同时设置。如果都不设置，插件会读取 Harness 当前的默认模型配置。

Workspace 和 Agent Preset

飞书会话创建 Agent 时会沿用 Harness Web 客户端的两项关键行为：挂载 Agent Preset，并把 Session 关联到 Workspace。Preset 提供该会话的工具、系统提示和其他 Agent 级能力；Workspace 提供 cwd，并让会话出现在对应工作区中。

• 未配置 workspace：使用 Harness Workspace 列表中的第一个工作区。
• 已配置 workspace：始终使用该路径；如果它已经注册为 Workspace，Session 同时关联到该 Workspace。
• Harness 尚无 Workspace：回退到启动 DSH 时的进程工作目录。
• 未配置 agentPreset：解析 Harness 当前默认 Preset。
• 已配置 agentPreset：使用指定 Preset；名称不存在时，本次会话创建会失败并向飞书返回安全错误提示。

如果希望机器人始终操作固定项目，建议显式配置：

workspace: /Users/you/github/project
agentPreset: coding

升级到包含 Workspace/Preset 关联的版本后，同一飞书聊天会创建新的 v2 Session；旧版本产生的未关联 Session 不会被继续复用。

修改配置后没有生效

停止并重新启动 Harness。插件实例和 WebSocket 连接在 Profile 启动时创建，修改 YAML 后需要重新加载。