规范与协议

DSH 全生态的规范与协议——这里的「规范」是宽口径的:凡是生态里「大家照着做」的约定都算。有官方定义的形态与协议(profile、插件 bundle、技能包、preset、半端划分);有生态各方共同维护的互操作约定——整合包这一族(manifest、.dspack 容器、市场索引、发布流程、启动器注册表)与社区互操作协议(插件元协议、运行环境元协议);也有跨应用协议(MCP)与工程规范。谁说了算分层次:官方的不由社区改,社区的只约束自愿采纳者,实现方的只管自己那一族——有争议时以对应出处的文件为准,而不是以某个实现或某个包的现状为准。

现行规范

现在照它做就对的那几份。目前收了文件型规范两族:整合包这一族(manifest / pack-structure / index / publishing / launcher-registry / workspace-config)与社区互操作协议;DSH 本体那一侧的契约按概念词条写在各自分区里。

  • DSH 社区生态互操作规范(dsh-ecosystem-spec) —— 社区版互操作协议:由 dsh-TUI 与 DSH-Desktop-EAC 团队联合发起,收录插件元协议 dsh-std(插件如何告诉别人自己的版本、适配的 DSH 版本与兼容性需求)与运行环境元协议 dsh-distribution(多个整合包或独立运行时如何共存、互相通讯并隔离)及相关子协议,另有 registry、governance 与工程规范。项目自我说明为「并非官方标准」,只约束自愿采纳者。72 star / 14 fork(快照 2026-10-02)。
  • DSH-PackForge 规范仓库 —— 现行六份规范都在这一个仓库里:manifest v5(包里声明什么)、pack-structure v3(.dspack 怎么装)、index(市场索引 schemaVersion 2)、publishing v1(怎么被收录)、launcher-registry(启动器 canonical ID 表)、workspace-config v1(.dshpkcfg 格式)。一条词条讲清它们的分工与互相引用。

历史版本

说明与条目(1 条)

旧版本仍然可读:读它是为了理解字段怎么长出来的

  • 历史版本(manifest v1–v4、pack-structure v1–v2) —— 六份现行规范都有前身,保留在仓库里可读。读它们不是为了守着旧写法,而是为了两件事:读旧包(市场里实测仍有包声明 manifestVersion 4,甚至 .tgz 时代的包)与理解字段怎么长出来的(v5 的 type/dshhome、v3 的 home/ 都是前面几版长出问题的答案)。