前言¶
DeepSeek Harness 以插件方式扩展本地智能体的使用入口。dsh-feishu-bot 解决的是另一个常见需求：把本地 agent 的交互延伸到飞书私聊。它允许用户从 Feishu（Lark）私聊中发送命令、查看会话、处理审批，并与 Web GUI 共享会话。
下面介绍它的定位、已核实能力、安装方式和部署注意事项。
这是什么¶
dsh-feishu-bot 是一个 DeepSeek Harness 插件，包名为 @tingrudeng/dsh-feishu-bot，当前包版本为 0.1.0-rc.11，许可证为 MIT，由 TingRuDeng 维护。
它的定位是 Feishu（Lark）private-chat frontend：从飞书私聊中驱动、监控和审批 DeepSeek Harness 的本地 agent，并与 Web GUI 共享 sessions。
版本状态¶
当前 0.1.0-rc.11 声明兼容 DSH 0.1.2-alpha.2。
已核实信息表明，rc.11 包含：
rc.9 S4 Markdown escaping unificationM7.0-M7.3 model/effort selectionsession-persistence ownership fence
在通过真实飞书验收前，它仍是本地候选。
核心功能¶
私聊命令¶
插件提供飞书私聊命令，用于创建、绑定、查询和控制会话：
/new [cwd]：在允许的 workspace 下创建会话并绑定/ls：查看未归档会话，两级卡片先选择 workspace，再点真实 session 标题绑定/use <sessionId|n>：绑定已有会话，作为/ls的文本 fallback/stop：取消当前正在运行的 turn，保留已排队的 follow-ups/status：查看状态/effort <id>：选择 effort/model：查看或处理模型相关状态/release：停止任务卡与任务级持久结果同步/help：查看帮助
文本与审批¶
普通非命令飞书消息会作为单个用户文本块进入已绑定会话，bridge 不重写其内容。
插件支持审批卡片，并与 approval/asked 事件配对。飞书或 Web 的决定可解析正常审批请求。
模型行为边界¶
插件不注入系统提示词、模型指令或工具 schema。模型与工具行为仍由 DeepSeek Harness 拥有。
已核实配置项¶
已核实的网关和桥接配置项包括：
appIdRef
appSecretRef
sendRetryBaseMs
sendMaxAttempts
sendCircuitCooldownMs
disposeDrainTimeoutMs
allowedOpenIds
allowedWorkspaces
defaultWorkspace
这些配置项分别涉及凭据引用、发送重试、冷却、关闭排水、允许用户、允许 workspace 和默认 workspace。已核实资料未给出完整配置参考，因此这里不展开为完整配置表。
安装与启用¶
registry 安装¶
在已有 web profile 中安装 scoped RC：
dsh plugin --profile web add @tingrudeng/dsh-feishu-bot@latest
安装后可以用下面命令查看配置面，预期看到 gateway、bridge、registry 和 invariant 相关行：
dsh --profile web --dump-config
旧无 scope 源包¶
如果当前 profile 仍包含旧无 scope 源包，需要先移除，再安装 scoped RC：
dsh plugin --profile web remove dsh-feishu-bot
dsh plugin --profile web add @tingrudeng/dsh-feishu-bot@latest
飞书侧准备¶
凭据¶
需要设置飞书应用凭据：
FEISHU_APP_ID
FEISHU_APP_SECRET
仓库不包含 secret。
飞书控制台¶
需要订阅事件并启用权限：
- 订阅
im.message.receive_v1事件 - 启用
im:message.p2p_msg:readonly - 如果使用审批卡片，启用
card.action.trigger回调 - 每次修改后发布应用版本
典型用法¶
下面是已核实的常用操作：
/new [cwd]
/ls
/use <sessionId|n>
/stop
/status
/effort <id>
/model
/release
/help
当你发送普通文本时，消息会进入已绑定会话。会话绑定时，任务卡和任务级持久结果会在飞书中同步；使用 /release 可以停止这种同步。
如果希望确认本地配置是否暴露出插件相关行，可以执行：
dsh --profile web --dump-config
适用场景与注意¶
dsh-feishu-bot 适合希望在飞书私聊中操作 DeepSeek Harness 本地 agent 的使用者，尤其是需要与 Web GUI 共享同一批会话，并在飞书中处理指令、状态和审批的场景。
使用前需要注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 rc.11在通过真实飞书验收前仍是本地候选。- bundle patch 在部署配置提供
allowedOpenIds和allowedWorkspaces前保持 fail-closed。 - 如果配置了
defaultWorkspace，它必须解析到允许的根内。 - 完整配置参考未在本次已核实资料中展开，部署时应以仓库文档和实际
dsh --dump-config输出为准。
