mirror of
https://gh-proxy.org/https://github.com/klinsmaya/workdsh.git
synced 2026-11-08 17:36:57 +08:00
t4we fan
29d8cdcc44
Create docs/plugin-ecosystem(.en).md as the ecosystem manifesto: an open, composable, sustainable vision with composition-first, declare-clearly, and compatibility-first principles, the desktop shell as the first example, living-document community governance, and the marketplace as the trust signal. The root README intro now ends with the co-progress vision and links the manifesto; the docs index and root README tables list it; the plugin-development ecosystem-vision section points to it as the full statement.
2.1 KiB
2.1 KiB
DSH 插件生态倡议书
English | 中文
DSH 的插件生态正在快速增长。插件越多，它们能否协同工作就越重要：如果每个插件都假设甚至覆盖其他插件的内部实现，装几个插件就会开始冲突，生态会逐渐碎片化。这不是任何人的错，而是缺少共同约定的必然结果。
我们的愿景
我们希望构建一个开放、可组合、可持续的 DSH 插件生态：
- 开放：任何作者都可以参与，官方、桌面和第三方插件在同一个平台上平等组合。
- 可组合：插件按同一套约定扩展，装在一起也能一起工作、互不干扰。
- 可持续：升级保持向后兼容，生态可以长期演进，不需要推倒重来。
我们倡导的三条原则
- 组合优先：通过官方 slot、service 和 patch 组合能力，不要假设或覆盖其他插件的内部实现。
- 声明清晰：明确声明依赖的 service 和 slot，不依赖运行时巧合。
- 兼容优先：升级保持向后兼容，不破坏已有组合。
桌面壳是第一个范例
DSH Desktop 是这套方式的第一个实践者：桌面壳本身就是一个普通 DSH 插件，与官方、第三方插件走同一条组合路径，没有任何特权。我们不是魔改上游源码做一个固定外壳，而是让"桌面"也成为插件生态里平等的一员。
活文档，社区共建
这份倡议不是单方面规定，而是一份活文档：它随生态实践更新，接受社区讨论和修订。任何作者都可以通过 issue、讨论区或 PR 提出修改。
插件市场：让约定成为有利的选择
插件市场上线后，符合本倡议的插件将更容易被发现、安装和信任。我们希望让"按规范开发"成为对每个作者都有利的选择，而不是额外的负担。