前言¶
在 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(用户同名技能优先):
- ga-identity:以 General Agentics 身分自介与签署产出
- 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
安装后:
- 网页刷新一次(如 Cmd+R),加载品牌 client 半。
- 新建 session,获得 14 个技能与 ga-status MCP 工具。
- 完全重启 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 装了什么¶
- 打开 Settings → General Agentics,看状态总览与精选插件列表。
- 在新 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 安装。