README
DSH Go
DSH Go 是面向 DeepSeek Harness 生态的 原生包管理器 + Registry/Distribution 基础设施 + Marketplace。当前架构以 Package Protocol V2、Manifest V2、Registry V4、Resolver V2、Runtime State V4、API V2 为唯一权威,不保留旧接口兼容层。
API 权威入口:https://dsh-go.pages.dev/
核心边界:Marketplace/Edge 只负责发现、查询、解析和生成安装计划;Local Runtime 是唯一有权执行安装、更新、回滚、状态写入和激活的组件。远程页面/API 不能修改用户机器,也不会自动重启客户端。
最终架构
Package Protocol V2 / Manifest V2
↓
Discovery → Candidate / Quarantine
↓
Registry V4
↓
Trust + Policy Engine
↓
Resolver V2
↓
Resolution Plan
↓
Runtime Supervisor
↓
CAS + Transaction
↓
Runtime State V4
↓
Activation Manager
↓
Runtime Adapter ABI
↓
Health / LKG
三条对外入口严格分层:
CLI / Desktop / Deep Link / Local Host
↓
Runtime Supervisor
API V2 / MCP Tools V2 / Marketplace
↓
discovery + resolve only
横向基础能力包括 Secrets/Config、Audit/Observability、Environment Lock/Recovery。完整设计见:
docs/architecture/dsh-go-v4-final-architecture.mddocs/architecture/dsh-go-v4-hardened-runtime-architecture.mddocs/plan/dsh-go-v4-architecture-hardening-optimization-plan.md
架构原则
- 唯一 Package Contract:Plugin / MCP / Skill / Agent 均使用
(type,id)身份和统一 SemVer/Channel 规则。 - 唯一 Manifest:可安装包只认
dsh-package.json(Manifest V2);其他历史 manifest 最多作为发现线索,不具备安装权威。 - 唯一 Registry 权威:Registry V4 保存 package/release/immutable commit/artifact/security 元数据;Candidate/Quarantine 不是安装权威。
- 唯一 Resolver:Edge 与 Local Runtime 共用
packages/resolver,Resolver 本身不访问网络、不写磁盘。 - 唯一 Runtime 写入口:所有本地 mutation 必须经过 Runtime Supervisor;CLI、Desktop、Deep Link、Local Host 都不能直接写 Runtime State。
- 事务安装:解析 → Policy → Security → CAS → Transaction → Runtime State,一次失败不得产生半安装状态。
- 显式激活:安装/更新完成后进入 pending activation;Activation Manager 执行预检、Adapter 绑定、健康检查和 Last-Known-Good 回退。
- 可信度不造假:Stars、SHA256、声明存在 signature 都不等于 Trusted;Trusted 必须来自已验证 Publisher Ownership + 真正的 cryptographic signer verification,并受 Trust Root/revocation 约束。
- 不自动重启:任何包操作都不会自动重启 DSH 客户端。
Package Protocol V2
标准坐标:
plugin:owner/package@^1.2.0
mcp:owner/server@2.0.0
skill:owner/skill@*
agent:owner/agent@~3.1.0
支持 channel:stable、beta、nightly、dev。类型必须显式提供,不存在隐式 plugin,也不存在 github: 安装坐标。
Local Runtime / CLI
# 查询/解析
dsh package plan plugin:owner/package@^1.2.0
dsh package info plugin:owner/package@1.2.3
dsh package list
# 本地 mutation 必须显式确认
dsh package install plugin:owner/package@^1.2.0 --yes
dsh package update plugin:owner/package@^1.3.0 --yes
dsh package rollback plugin:owner/package --yes
dsh package remove plugin:owner/package --yes
# Runtime / Registry / Environment
dsh runtime status --json
dsh runtime activate --yes
dsh registry status --json
dsh environment lock
dsh environment verify-lock
dsh environment restore --yes
Canonical Deep Link:
dsh://package/install?spec=plugin%3Aowner%2Fpackage%40%5E1.2.0&channel=stable
Deep Link 不能覆盖本地 Registry,最终安装仍需 Local Runtime 明确批准。
API V2 / MCP Tools V2
远程接口只提供 discovery / resolve / install-plan:
| 接口 | 用途 |
|---|---|
GET /api/v2 |
API capability map |
GET /api/v2/health |
Registry V4 健康状态与 revision |
GET /api/v2/packages |
包查询 |
GET /api/v2/packages/:type/:id |
包与 release 详情 |
GET /api/v2/search?q= |
Registry/Search Index 查询 |
POST /api/v2/resolve |
Resolver V2 依赖解析 |
POST /api/v2/install-plan |
生成本地安装计划,不执行安装 |
GET /api/v2/publishers |
Publisher 信息 |
GET /api/v2/advisories |
安全公告 |
GET /api/v2/registry/revision |
Registry revision |
GET /api/v2/registry/delta |
Distribution V2 增量协商 |
POST /api/v2/mcp |
MCP Tools V2 JSON-RPC |
机器客户端应先读取 /.well-known/dsh-marketplace.json。OpenAPI 位于 /openapi.json。
Registry / Distribution
公开机器数据:
/catalog/registry-v4.json
/catalog/registry-v4/index.json
/catalog/search-index-v3.json
/.well-known/dsh-marketplace.json
/schemas/dsh-marketplace-discovery-v2.schema.json
外部 GitHub 发现数据必须先经过 Candidate/Quarantine。缺少 Manifest V2、无法解析 immutable commit、身份冲突或安全条件不满足的资源可以继续在发现层显示,但不会进入可安装 Registry authority。
Marketplace
Marketplace 是人类发现平面,不拥有安装权限。当前站点支持 English、简体中文、日本語、한국어、Español;搜索使用 Search Index V3。详情页只为满足当前详情阈值策略且存在安全 release 的包生成,低阈值资源直接回到源码/发现入口,避免生成大量无效详情页。
🔥 最近热门推荐(300-5000★)
自动生成 · 仅收录命名含 dsh / deepseek-harness 的 DSH 原生插件(排除 awesome 盘点型仓库),并固定推荐 modlens / dsh-better-sidebar · 按最近更新排序 · Top20(每次同步后刷新)
更多「主题与皮肤」插件
dsh-qq2006
作者 laplaceyoung
DSH (DeepSeek Harness) 的 QQ2006 皮肤插件:注册 qq2006 主题、镜像 body[data-ds-skin]、全局皮肤表与完整素材
dsh-beauty-skins
作者 xierw
给 DeepSeek Harness 用的美女系列皮肤:设置里从 哲风壁纸 拉预览网格,点一张即应用,配色从壁纸提取。支持动态壁纸,也保留自定义选图。
deepseek-harness-skin
作者 heigeai
DeepSeek Harness 换肤系统:21 套内置皮肤 + 一张图生成整套配色的自定义皮肤。数据源驱动,保对比度推导,构建期校验可读性。
whaleisle
作者 chisaalter
鲸屿 Whale Isle · DeepSeek Harness 开源社区桌面版:AI 对话、终端与 Git、鲸桥 API/订阅接入、主题壁纸、鲸鱼娘桌宠、用量统计与手机远程连接。Community-enhanced DeepSeek Harness desktop client.
