通用智能体套件 Bryan-cmf/dsh-general-agentics

dsh-general-agentics

General Agentics 发行套件（bundle）for DeepSeek Harness (DSH)。

你先安装 DSH，再安装本套件，一次获得：

1. 贴牌：侧边栏 mark/wordmark、对话首页 hero 文字 logo、品牌主色、分页标题、favicon（皆为执行期替换，不修改、不破坏已安装的 DSH）
2. 自带技能：ga-identity（教导智能体以 General Agentics 身分自介与签署产出）
3. MCP 预配置：策劃中的 MCP 服务器清单（见 mcp/）
4. 精选第三方插件：机制保留（依赖＋显式 insert row 随套件启用）；目前策劃清单为空，profile 端另行精选安装

Built on DeepSeek Harness (DSH), MIT licensed.

设计原则

- 只走官方缝隙：品牌透过三个 generic brand slot 佔位（priority: -1 阴影覆盖官方 occupants——slot 规则是「同 cell 最低 priority 者渲染」），不停用 ui-brand-official，不修改任何 DSH 档案。
- 不破签章、不怕升级：本套件存在于 profile（~/.dsh/profiles/<name>/node_modules），DSH 升级不会覆盖它；解除安装即完全还原官方品牌。
- 手写、零建置：lib/client.js 采用 shell module loader 的 lazy-CJS 形状（与 dsh-pomodoro 等第三方出货格式一致），无需 repo 内未发布的 build preset。

覆盖范围（诚实清单）

| 表面 | 本套件 | 备注 |
| 侧边栏 mark / wordmark | ✅ | slot 佔位；2026-10-13 浏览器实测（干净 profile）确认渲染 |
| 对话首页 hero mark | ✅ | slot 佔位；实测确认我们的 wordmark 渲染 |
| 品牌主色 | ✅ | theme.overrideTokens（light/dark 成对，契约要求）。注意 token 写在 <body> 的 inline style 上，不是 :root；量测时别探 document.documentElement |
| 分页标题 | ✅ | 执行期改写 + MutationObserver 抵抗 shell 重设；实测 document.title === "General Agentics" |
| favicon | ✅ | 执行期替换 link[rel=icon]；实测两个 link 皆为 data URI 且含品牌色 |
| PWA 名称 | ⚠️ 尽力 | manifest link 换 data URI，浏览器是否采纳视实作 |
| 首跑 Preview Notice 弹窗 | ❌ 未覆盖 | client 树内字串，一次点名 DeepSeek Harness 三次，是客户第一眼看到的画面。2026-10-13 浏览器实测发现；client.js 修得到（尚未修） |
| Hero tagline「Into the Unknown」 | ❌ 未覆盖 | 与我们的 hero wordmark 并排显示；同为 client 树内字串，尚未修 |
| 桌面壳（Dock icon／选单／About） | ❌ | 在签章保护的 app.asar 内，本套件不碰 |
| host 端字串（system prompt、User-Agent） | ❌ | 硬编码；以 ga-identity skill 于任务层补偿 |

安装

方式一：GUI（App 运行中）——侧栏 Plugins → Add plugin → 贴包名或本机路径 dsh-general-agentics # npm 包名（发布后） /path/to/dsh-general-agentics # 本机 clone 的绝对路径

方式二：模型侧工具（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 half（侧边栏 mark/wordmark、hero 文字 logo 与致敬行、主色、分页标题、favicon、输入框下方的 START HERE 模组）
- 新建的 session 会获得 ga-identity 等 14 个技能与 mcp__ga-status__ga_bundle_info 工具（MCP 服务器于组合套用时即由 host spawn）
- 完全重启 App 亦无妨

解除安装／停用：停用（保留档案）：GUI Plugins 页关闭 bundle，或在 profile 的 cordis.patch.yml 写：
- id: general-agentics
disabled: true
解除安装：GUI Plugins → Remove，或退出 App 后 CLI：
dsh plugin --profile desktop remove dsh-general-agentics

开发迭代：以 link: 指向本机 clone 安装——改 lib/client.js 后重新整理页面即生效；改 cordis.patch.yml 或 lib/index.js（host 半）则套用新组合（HMR live）。
内容变更后重新以 file: 安装时记得升版号——pnpm 对同版号的 file: 包可能不重新解包。
离线验证组合用抛弃式 profile：见 docs/ops-lessons.md rule 13。

发布前注意：
- LICENSE 已在 repo 根目录（npm 自动收入 tarball）
- MCP row 已是可携形式（process.execPath + baseUrl，见 cordis.patch.yml；实测纪录在 docs/ops-lessons.md rule 14）
- 对外表述维持 "Built on DeepSeek Harness (DSH), MIT licensed"

套件结构

dsh-general-agentics/
├── package.json # dsh.bundle.patch + dsh.client 宣告＋精選插件 dependencies ├── cordis.patch.yml # 本套件 Loader row＋MCP row＋精選插件 insert rows ├── lib/ │ ├── index.js # host half：技能 provider（掃 skills/ 註冊） │ └── client.js # browser half：品牌 slot、主題、標題/favicon、START HERE ├── brand/ │ ├── mark.svg # 佔位 mark 設計檔（client.js 內有對應 inline 版本） │ └── wordmark.svg # 佔位 wordmark 設計檔 ├── skills/ │ ├── ga-identity/ # 自帶技能：General Agentics 身分與簽署 │ ├── (13 個方法論技能) # vendored from obra/superpowers @ bb92a77（MIT，逐字未改） │ ├── superpowers/ # 上游 LICENSE + UPSTREAM-SHA（無 SKILL.md，不註冊） │ └── THIRD-PARTY.md # 署名與更新指引 ├── mcp/ │ └── ga-status-server.mjs # ga_bundle_info 狀態回報（零依賴 stdio MCP server） └── test/ └── skill-provider.test.mjs # node --test，零依賴

換正式品牌素材

| 要換什麼 | 改哪裡 |
| 產品名稱 | lib/client.js 的 PRODUCT_NAME / PRODUCT_SHORT_NAME |
| mark 圖形 | lib/client.js 的 GAMark（paths）＋ brand/mark.svg |
| wordmark | lib/client.js 的 GAName |
| 品牌色 | lib/client.js 的 BRAND_COLOR / FAVICON_COLOR（light/dark 成對） |
| favicon | lib/client.js 的 faviconHref() |

隨附技能（bundled skills）

14 個技能隨包註冊（ctx.skills.registerProvider，bundled rank 600——用戶自帶同名技能一律優先）：

- ga-identity：以 General Agentics 身分自介與簽署產出
- 13 個方法論技能 vendored 自 obra/superpowers（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（其「任何回應前必查技能」規則與 ga-identity 的身分主導權衝突）與 using-git-worktrees（團隊 git 工作流）刻意不入，理由見 skills/THIRD-PARTY.md。

感謝：Jesse Vincent (obra) 與 superpowers 貢獻者；詳見 skills/THIRD-PARTY.md。

合規備忘

- 本套件 MIT；散布時保留 DSH 的 MIT 與 THIRD_PARTY_NOTICES.md（DSH 端授權義務）。
- 對外表述使用 "Built on DeepSeek Harness (DSH)"；不以 DeepSeek Harness 作為產品名，不使用官方 logo。
- ga-identity skill 內含給 agent 的對外表述規則。