bihangchi9-creator/dsh-lark-bridge

插件Plugin ⭐ 35 NOASSERTION codingecosystemsocialweb-ui

A native DeepSeek Harness (dsh) plugin bridging dsh coding agents to Feishu/Lark group chats — one group, one project directory.

编辑导读Editor's Brief

## 核心特性
- 来自飞书或 Lark 的入站消息会通过宿主 agents 服务驱动 DeepSeek Harness 智能体,回复会以流式方式回传到实时更新的飞书消息中。
- 每个聊天标识符都会映射到配置的工作区根目录下一个稳定的项目目录,为每个群聊或私聊会话创建独立文件夹。
- 会话使用固定的每个聊天会话标识符,允许每个聊天会话在重启后恢复,而不是从空上下文开始。
- 首次启动且没有凭据时,插件可以显示二维码注册向导,在扫码后创建飞书应用凭据并本地存储。
- 斜杠命令包括 /help/new/where/model,用于显示帮助、清除聊天上下文、显示项目目录,以及显示或切换模型。

## 使用场景
- 团队可以通过将一个飞书群分配给一个工作区文件夹,并行运行多个独立编码项目。
- 启用私聊处理后,开发者可以通过飞书私聊与 dsh 编码智能体交互。
- 用户可以将对话式编码提示与独立的 Lark CLI 工作流结合,用于文档、表格、消息或日历操作。

## 技术细节
- 插件通过长连接 WebSocket 连接飞书,因此无需公网 IP 地址或回调 URL。
- 凭据可从内联插件配置、环境变量或注册向导写入的本地文件中读取。
- 该包使用 pnpm 从源码安装,将源码构建到 lib,并通过 Cordis 补丁加载到 dsh,该补丁会注入 agents、sessions、agentPresets 和 agentDefaultModel。
- 运行时配置包括面向 feishu.cn 或 larksuite.com 的租户选择、模型和提供方覆盖、工作区根目录、私聊开关,以及群聊提及要求。

## 注意事项
- 宿主需要可用的 DeepSeek Harness 代码检出、Node.js ^22.19.0 || >=24.0.0 和一个 DeepSeek API 密钥。
- 飞书机器人注册按用户进行,且在不转移机器人控制权的情况下无法共享 app secret。
- 设置 DSH_PERMISSION_MODE=danger-full-access 会禁用智能体审批提示;这是必需的,因为飞书用户无法批准本地提示。

## Core Features
- Inbound Feishu or Lark messages drive a DeepSeek Harness agent through the host agents service, and replies stream back into a live-updating Feishu message.
- Each chat identifier maps to a stable project directory under a configured workspace root, creating an isolated folder for every group or direct message conversation.
- Conversations use fixed per-chat session identifiers, allowing each chat session to resume after restarts instead of starting from an empty context.
- On first launch without credentials, the plugin can display a QR registration wizard that creates Feishu app credentials and stores them locally after scanning.
- Slash commands include /help, /new, /where, and /model for showing help, clearing chat context, showing the project directory, and showing or switching the model.

## Use Cases
- Teams can run separate coding projects in parallel by assigning one Feishu group to one workspace folder.
- Developers can interact with a dsh coding agent from Feishu direct messages when direct message handling is enabled.
- Users can combine conversational coding prompts with separate Lark CLI workflows for documents, sheets, messaging, or calendar operations.

## Technical Details
- The plugin connects to Feishu over a long-lived WebSocket, so no public IP address or callback URL is required.
- Credentials are read from inline plugin configuration, environment variables, or the local file written by the registration wizard.
- The package installs from source with pnpm, builds source into lib, and loads into dsh through a Cordis patch that injects agents, sessions, agentPresets, and agentDefaultModel.
- Runtime configuration includes tenant selection for feishu.cn or larksuite.com, model and provider overrides, workspace root, direct-message toggle, and group mention requirement.

## Notes
- The host requires a working DeepSeek Harness checkout, Node.js ^22.19.0 || >=24.0.0, and a DeepSeek API key.
- Feishu bot registration is per user, and the app secret cannot be shared without transferring control of the bot.
- Setting DSH_PERMISSION_MODE=danger-full-access disables agent approval prompts, which is required because Feishu users cannot approve local prompts.

安装Install

dsh plugin --profile web add github:bihangchi9-creator/dsh-lark-bridge

bihangchi9-creator/dsh-lark-bridge 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

上一个 Prev dsh-codex 下一个 Next dsh-message-edit