前言¶
做 DSH 插件的开发者一般有两条路：要么从零写自己的消息入口和任务调度，要么找一个已经实现会话拆分、消息判定和恢复机制的基座来改。SuperAgent General 是第二条路上的一个现成选项。
它没有改写消息入口的底层逻辑，而是改在使用场景上：官方 SuperAgent 原型默认围绕单个 GitHub 仓库的维护与协作，这个插件把它拉回通用任务，并把飞书接入换成了填 APP_ID、APP_SECRET 的官方 SDK 长连接，而不是依赖一个预先配置好的机器人 CLI。下面介绍这个插件是什么、相对原型改了哪些地方、怎么装怎么配。
这是什么¶
SuperAgent General（dsh-superagent-general）是一个面向通用任务的 DSH 插件，由 comeonzhj 维护，社区目录中的分类为「客户端」，GitHub 星标 4，许可证 MIT。插件运行后通过飞书机器人接收私聊和群聊消息，由常驻的 Router 协调任务，在独立的 DSH Worker Session 中执行，主面板沿用 DSH 原生界面。
适用工作包括调研、分析、写作、翻译、资料整理、文件操作及软件开发，实际能力取决于 DSH 提供的工具、模型和用户授权。
它是社区适配项目，基于 DeepSeek Harness 官方 SuperAgent 原型（deepseek-ai/dsh-superagent-prototype）开发，保留上游版权与许可。
相对官方原型的调整¶
插件没有另起一套任务编排，而是在原型基础上改了使用场景、接入方式和初始化。对照如下，逐项来自 README 的表格。
| 项目 | 官方原型 | 当前插件 |
|---|---|---|
| 使用场景 | 单个 GitHub 仓库的维护与协作 | 默认面向通用任务，GitHub 作为可选来源 |
| 飞书接入 | 通过配置好的机器人 lark-cli 接入 |
填写 APP_ID、APP_SECRET，使用官方 SDK 建立长连接并调用 API |
| 初始化 | 需要配置仓库、CLI 账号和运行目录 | 自动提供默认数据目录与任务目录，模型沿用 DSH 设置 |
| 消息过滤 | 来源群、是否被提及、发送者准入与模型评估 | 保留原型准入和评估，增加可配置的关注/忽略关键词 |
| 默认要求 | 以代码修改、PR 和审查为中心 | 通用业务要求优先中文，GitHub 专用要求归入可选场景技能 |
| 场景定制 | 团队提示词与技能 | 为翻译、项目分析、知识库维护等配置适用条件与交付要求 |
| 管理界面 | DSH 原生面板与自动轮询 | 默认概览、执行设置前置、设置标签最后，配置说明用 ? 悬浮提示 |
| 飞书资源操作 | 主要通过机器人 CLI | Worker 通过应用身份的 API 处理获授权的消息、文档、知识库和表格等资源 |
消息过滤里增加的关键词变更会纳入策略版本，也就是说策略和关键词不是各改各的。
保留的核心设计¶
沿用原型的 Engine、Router/Worker 会话、Trigger/Thread、订阅直通、上下文按需读取、SQLite、Effect/Outbox 与恢复机制。src/core/ 保持与上游基线一致，适配改动集中在周边。
主面板可以查看消息、判断、任务、线程与订阅并自动更新。任务详情能打开真实的 worker-… 执行会话，查看推理、工具调用和交付过程；Router 统一回复入口消息。
上游来源、基线提交和适配边界写在仓库的 docs/UPSTREAM.md，给插件找闲话说之前可以先看这份边界。
安装¶
安装方式是装插件包，不是装 npm 包，README 给出的步骤如下。
1、从 Releases 下载预编译的 .tgz 插件包。
https://github.com/comeonzhj/SuperAgent-General/releases
2、在 DSH 的插件页面安装这个压缩包，启用 dsh-superagent-general，打开侧边栏的 SuperAgent。
当前版本基于 DSH 0.2.1-alpha.2 的接口开发，声明的宿主兼容范围见仓库的 package.json；Node.js 要求为 ^22.19.0 或 >=24。仓库自身版本为 0.2.2，运行时依赖包括 @larksuiteoapi/node-sdk 1.76.0、zod 4.4.3 和 proper-lockfile 4.1.2。
如果你要从源码自行打包，README 提供的流程是取干净仓库后依次跑 pnpm install --frozen-lockfile、pnpm check、pnpm pack --pack-destination dist，产物为 dist/dsh-superagent-general-<版本>.tgz。pnpm pack 会先构建再打包，仓库另有 docs/ARCHITECTURE.md、docs/PROMPTS.md 等文档。
配置飞书应用¶
插件装好后需要在侧边栏的 SuperAgent 面板里完成接入。
1、在最后的“设置”标签中连接飞书应用，填写 APP_ID、APP_SECRET，选择接收的群与可交办任务的人。
2、需要时在“更多设置”中添加团队技能，填写场景要求。
飞书应用侧要启用机器人、开启长连接接收消息、申请相应消息权限并发布。如果要读写文档和知识库，目标资源也需要授权，只有消息权限不够。配置说明使用 ? 悬浮提示，介绍内容放在“关于”里，设置标签放在最后。
典型流程¶
装好并接好飞书之后，一次任务大致走四步。
1、飞书侧发消息。私聊或被允许的群内的消息会被机器人接收。
2、Router 判定。Router 负责消息过滤、准入判断和模型评估，决定是否转为任务，并在面板中留下判断记录。
3、Worker 会话执行。被接受的任务在独立的 worker-… 会话里跑，使用 DSH 已有的模型、工具、工作区和权限，产出推理和工具调用记录。
4、在面板里看与回。面板显示任务、线程和订阅状态，任务详情可打开真实执行会话；Router 统一回复入口消息，避免多处回复。
飞书资源的读写走应用身份的 API 工具，落的是插件所属应用的权限范围。
验证与当前边界¶
README 记录的验证范围是：已通过自动化测试、类型检查和构建，并验证了隔离 DSH 中的安装、原生面板、自动更新和主会话入口。飞书真实消息收发和资源读写需要用你自己的应用权限做联调，这一步没有被预先验证过。
从早期版本升级时会迁移接入与模型等配置；旧版任务库保留，历史任务暂未转换到当前原型的领域模型，具体变化见 docs/USER-GUIDE.md。
适用场景与注意¶
一个人或小团队想在飞书里直接派活、又希望执行过程留在 DSH 的 Worker 会话里被看到和被审计，适合用这个插件。已经有自己在用的机器人 CLI、或任务边界与某个 GitHub 仓库强绑定的，更适合留在官方原型上。
需要先明确的几点：
1、插件随 DSH 进程运行，用的是当前 DSH 进程的权限，不是独立沙箱；授权给插件的工具与目录，实际上也是授权给运行它的 DSH 进程，安装前先看源码，确认哪些权限会被用到。
2、飞书侧要准备好一个已发布的应用凭证，并且消息、文档、知识库权限按实际需要授予，插件不会替你申请。
3、当前宿主接口基线是 DSH 0.2.1-alpha.2，package.json 声明的是 ^0.2.1-alpha.2 || ^0.2.2-alpha.3，升级 DSH 前对照一下兼容范围。
来源与许可¶
插件采用 MIT License，是社区适配项目，保留 DeepSeek Harness Team 的上游版权与许可。宿主兼容、依赖版本和包名见仓库 package.json，完整安装步骤与升级说明见 docs/USER-GUIDE.md，接单规则见 docs/PROMPTS.md。
目录页：https://www.skillhub.cn/plugins/comeonzhj/SuperAgent-General
仓库：https://github.com/comeonzhj/SuperAgent-General
