前言¶
在 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 安裝。