安装 harness-lark 飞书插件

harness-lark 是 deepseek-harness 的飞书/Lark 频道插件。有三种安装方式，任选其一。

方式 A：用自带插件的 Docker 镜像（推荐）

直接用 release 发布的 ghcr.io/huoxue1/deepseek-harness-lark 镜像，插件已内置：

export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=secret

docker run -d --name dsh-web \
  -p 3080:3080 \
  -v dsh-data:/root/.dsh \
  -e FEISHU_APP_ID=$FEISHU_APP_ID \
  -e FEISHU_APP_SECRET=$FEISHU_APP_SECRET \
  ghcr.io/huoxue1/deepseek-harness-lark:latest

首次启动时容器自动执行 dsh plugin --profile web add file:/plugins/harness-lark 并生成 profile 配置，之后每次重启跳过。

方式 B：在已有 dsh 上通过 dsh 命令一键安装（推荐非 Docker 场景）

插件已发布到 npm（harness-lark）。设置凭据后，用仓库提供的一键脚本（或直接 dsh 命令）安装：

# 方式 B1：一键脚本（安装 + 生成配置 + 启动）
git clone https://github.com/huoxue1/harness-lark.git   # 或直接下载 scripts/install-dsh.sh
cd harness-lark
export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=secret
bash scripts/install-dsh.sh web harness-lark             # 等价于下面三条命令

# 方式 B2：逐步 dsh 命令
dsh plugin --profile web add harness-lark                # 1. 安装插件（npm 包）
# 2. 编辑 $DSH_HOME/profiles/web/cordis.patch.yml（见下方配置项）
# 3. 启动
dsh --profile web

本地源码安装：bash scripts/install-dsh.sh web /path/to/harness-lark（先 pnpm install && pnpm run build）。

方式 C：从源码安装

git clone https://github.com/huoxue1/harness-lark.git
cd harness-lark
pnpm install
pnpm run build
# 把 lib 产物与 cordis.patch.yml 放到 dsh 可发现的位置后：
dsh plugin --profile web add file:/path/to/harness-lark

飞书开放平台准备

  1. 到 飞书开放平台 创建企业自建应用，获得 App ID 与 App Secret。
  2. 在「权限管理」开通插件所需权限：
    • 基础：im:message:send_as_bot、im:message.p2p_msg:readonly、im:message.group_at_msg:readonly、im:resource、im:chat:read、im:message.reactions:read、im:message.reactions:write_only（表情回复）等；
    • 云文档/多维表格/云表格/日历/任务等用户数据权限（如 docx:document、base:*、sheets:spreadsheet、calendar:*、task:*）——用户授权时会自动按「应用已开通 ∩ 需要的」过滤，未开通的不会出现在同意页。
  3. 「事件与回调」→ 订阅方式选择使用长连接接收事件（插件默认 connectionMode: websocket，无需公网回调地址）。
  4. 发布应用版本并确保审核通过。

配置项

profile 的 cordis.patch.yml（镜像方式由 entrypoint 生成，可自行修改）：

- id: lark
  config:
    appId: !!js process.env.FEISHU_APP_ID
    appSecret: !!js process.env.FEISHU_APP_SECRET
    brand: feishu            # feishu | lark
    connectionMode: websocket
    dmPolicy: open           # open | pairing | allowlist | disabled
    groupPolicy: open        # open | allowlist | disabled
    requireMentionInGroups: true   # 群聊是否必须 @机器人
    respondToMentionAll: false     # 是否响应 @所有人
    replyMode: streaming     # auto | static | streaming
    topicSeparateSession: true     # 话题群按 thread 独立会话
    # allowlist: [ou_xxx]    # open_id 白名单
    # dedupTtlMs: 43200000   # 消息去重窗口

镜像方式的环境变量（由容器 entrypoint 消费，非插件配置）：

变量 说明
DSH_TRUSTED_HOSTS 空格分隔的 Host 列表，通过 --trusted-host 加入 dsh 的 /api 信任围栏。局域网 IP 访问 Web UI 时设置（如 192.168.10.251），否则 /api 返回 403
DSH_WEB_FORWARD 设为 0 可关闭容器内的端口转发器（默认开启；dsh 只绑容器回环，需要它才能经 Docker 发布端口访问 UI）

用户授权（一次性）

要让机器人以你的身份读写你的云文档/表格/日历，在飞书私聊里发送：

/feishu auth

按提示打开链接输入用户码完成授权。授权后：

诊断请用 /feishu doctor。

下一步