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 安裝。

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

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

小夜