dsh-general-agentics:一次安装获得贴牌、精选插件与方法论技能

前言

在 DeepSeek Harness(DSH)里做智能体或团队交付,常见做法是分别安装品牌定制、若干社区插件、技能包和 MCP 配置,再逐项对齐版本与 profile 补丁。步骤多、升级时还要担心覆盖官方文件或破坏签章。

下面介绍维护者 Bryan-cmf 发布的 dsh-general-agentics(npm 包名 dsh-general-agentics)。它是一个面向 DSH 的 General Agentics 发行套件(bundle):用户先安装 DSH,再安装本套件,一次获得贴牌界面、14 个随附技能、MCP 预配置,以及 13 个精选第三方插件的自动安装与启用。项目基于 DSH 构建,MIT 许可;在 SkillHub 上归类为「工作流」。

这是什么

dsh-general-agentics 不是单一功能插件,而是通过 dsh.bundle.patch 与 cordis.patch.yml 向 profile 注入组合配置的 distribution bundle。host 半在 lib/index.js 注册技能 provider;browser 半在 lib/client.js 做品牌 slot、主题与 START HERE 等执行期替换,不修改 DSH 本体文件。

设计原则在 README 中写得很明确:品牌走三个 generic brand slot(priority: -1 阴影覆盖官方 occupant),不停用 ui-brand-official;套件落在 ~/.dsh/profiles/<name>/node_modules,DSH 升级不会覆盖 bundle,卸载即可还原官方品牌。

核心功能

贴牌(执行期替换)

安装并刷新页面后,可在不破坏已安装 DSH 的前提下覆盖:

  • 侧栏 mark / wordmark
  • 对话首页 hero 文字 logo 与致敬行
  • 品牌主色(theme.overrideTokens,light/dark 成对)
  • 分页标题、favicon
  • 输入框下方的 START HERE 模块

README 中的「覆盖范围」表也诚实列出了尚未覆盖项:例如首跑 Preview Notice 弹窗、Hero tagline「Into the Unknown」、桌面壳与 host 端硬编码字串等;后者可通过随附的 ga-identity 技能在任务层补偿。

换正式品牌素材时,主要改 lib/client.js 中的 PRODUCT_NAME、GAMark、GAName、BRAND_COLOR 等,并同步 brand/ 下 SVG。

14 个随附技能

host 通过 ctx.skills.registerProvider 注册,bundled rank 为 600(用户同名技能优先):

  1. ga-identity:以 General Agentics 身分自介与签署产出
  2. 13 个方法论技能:自 obra/superpowers vendoring(MIT,逐字未改),包括 brainstorming、writing-plans、executing-plans、test-driven-development、systematic-debugging、verification-before-completion、writing-skills、diagnosing-superpowers、subagent-driven-development、dispatching-parallel-agents、requesting-code-review、receiving-code-review、finishing-a-development-branch

上游 15 个技能中取 13 个;using-superpowers 与 using-git-worktrees 刻意未纳入,理由见仓库内 skills/THIRD-PARTY.md。

MCP 预配置:ga-status

组合套用时 host 会 spawn MCP 服务器 mcp/ga-status-server.mjs(零依赖 stdio),提供:

  • ga_bundle_info:bundle 身分回報
  • ga_health_check:安装健康自检

新建 session 后可使用工具名形如 mcp__ga-status__ga_bundle_info。

设定面板

Settings → General Agentics 分页用于查看 bundle 版本、13 个精选插件的声明范围与实际安装版本、14 个随附技能,并支持重新检查更新、一键更新(二次确认)及失败时的手动指令复制。面板语言跟随浏览器(zh/en),可用 localStorage['general-agentics/lang'] 覆写。

13 个精选第三方插件

随套件 dependencies 与 cordis.patch.yml insert row 安装并启用(row id 以 ga- 为前缀,避免与用户直装同名插件冲突)。摘要如下:

插件 作用 可见或生效条件
dshmarket 插件市集 设定 → Plugin Market
dsh-better-sidebar 侧栏文件树、编辑器等 基本即有
dsh-comments 划选回复、逐段点评 立即可用
dsh-promptimizer 一键改写草稿 prompt 需可用模型
dsh-sentinel 排程监看面板 立即可用
dsh-cost-meter 会话费用统计 本套件已预设详细用量
@changfenhuang/dsh-genui 回复内嵌互动 UI 本套件已预设区块
dsh-context 上下文洞察 本套件已预设 fleet 分页
@liustack/modsearch 网页与 X 搜索聚合 本套件接管 web.searchProvider
@ricardochen1996/dsh-browser-use 浏览器自动化 需 uv
@xmanrui/dsh-im IM 桥接 需 IM 应用凭证
@liustack/modlens 纯文字 LLM 视觉能力 需 Antigravity CLI(未随包)
dsh-mobile 手机/局域网访问 占用 TCP 埠(默认 3443)

bundle 的 package.json 中直接声明的 npm 依赖目前包含 dsh-comments、dsh-promptimizer;其余精选插件由 bundle manifest 与 patch 一并拉取,以仓库 cordis.patch.yml 与 README 为准。

DSH 版本相容性

自 DSH 0.2.1 起,安装时会读插件 manifest 做相容性闸道:有 engines.dsh 则只认它。本套件声明:

"engines": {
  "dsh": ">=0.2.1-rc.2"
}

发布前可用仓库脚本 npm run check-dsh-compat 核对精选清单。README 说明 @michengai/dsh-agency-agents 与 dsh-web-search-pro 在 0.2.1 上无法通过闸道,故未纳入 bundle;需要时可按文档使用 dsh plugin allow-version ... --accept-risk 自行承担风险安装。

安装与启用

DSH 社区插件目录页:https://www.skillhub.cn/plugins/Bryan-cmf/dsh-general-agentics。源码与说明:https://github.com/Bryan-cmf/dsh-general-agentics。

方式一:GUI(App 运行中)
侧栏 Plugins → Add plugin,粘贴包名或本机路径:

dsh-general-agentics
/path/to/dsh-general-agentics

方式二:模型侧工具(App 运行中)
在对话中请 agent 执行:plugin_manager { action: "install_bundle", target: "dsh-general-agentics" }

方式三:CLI(desktop profile 须先完全退出桌面 App)

dsh plugin --profile desktop add dsh-general-agentics

安装后:

  1. 网页刷新一次(如 Cmd+R),加载品牌 client 半。
  2. 新建 session,获得 14 个技能与 ga-status MCP 工具。
  3. 完全重启 App 亦可。

停用或卸载:

# 停用:GUI Plugins 页关闭 bundle,或在 cordis.patch.yml 写 disabled: true
# 卸载:GUI Remove,或退出 App 后:
dsh plugin --profile desktop remove dsh-general-agentics

开发迭代可用 link: 指向本机 clone;改 lib/client.js 后刷新页面生效,改 host 半则组合 HMR 生效。

典型用法

确认 bundle 装了什么

  1. 打开 Settings → General Agentics,看状态总览与精选插件列表。
  2. 在新 session 中调用 MCP ga_bundle_info 或 ga_health_check,核对身分与健康状态。

用随附技能组织开发流程

新建 session 后,模型可加载 ga-identity 统一身分表述,并按任务选用 superpowers 系列技能(例如先 brainstorming / writing-plans,再 executing-plans 或 test-driven-development)。具体触发方式遵循 DSH 技能机制与各技能目录下的 SKILL.md。

更新 bundle 与精选插件

在 General Agentics 设定页使用「重新检查」与「一键更新」(desktop profile 优先用面板按钮,CLI 可能被 Electron 独占)。注意:bundle 升版不会自动 bump 各精选插件的 npm 版本;插件版本以 bundle 依赖与 patch 声明为准,面板会标「有新版 / 最新 / 未提供 / 直装重复」等状态。

适用场景与注意

适合谁: 希望在 DSH 上快速搭一套「贴牌 + 常用插件 + 方法论技能 + 状态 MCP」交付环境的工作流或团队,又不想手改 DSH 签章保护内的文件。

权限与安全: 插件(含 bundle 内所有精选插件)以当前 DSH 进程权限运行,并可访问你配置的工作区与凭证。安装前应阅读 GitHub 源码与 MIT 许可证,并理解 MCP、IM、浏览器自动化等插件的外部依赖风险。

依赖与局限: 部分精选插件需要 uv、IM 凭证、Antigravity CLI 或独立 TCP 端口;设定面板的「需要注意」区块会提示缺失依赖与可复制修复命令。PWA 名称、Preview Notice、桌面壳等表面 README 已标明未覆盖或仅尽力覆盖。

生态说明: DSH 理念是「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。本介绍事实均来自上述仓库 README 与 package.json(当前文档版本 0.3.0-alpha.3)。

结尾

dsh-general-agentics 把贴牌、13 个精选插件、14 个技能与 ga-status MCP 收成一次安装,并尽量只走官方 slot 与 profile 补丁,便于升级与卸载还原。若你要在 DSH 上搭 General Agentics 风格的工作流底座,可从目录页或 GitHub 查看说明后,用文档中的 dsh plugin add 或 GUI 安装。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜