mirror of
https://gh-proxy.org/https://github.com/klinsmaya/workdsh.git
synced 2026-11-09 18:07:02 +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.
38 lines
2.1 KiB
Markdown
38 lines
2.1 KiB
Markdown
# DSH 插件生态倡议书
|
|
|
|
[English](plugin-ecosystem.en.md) | 中文
|
|
|
|
DSH 的插件生态正在快速增长。插件越多，它们能否协同工作就越重要：如果每个插件都假设甚至覆盖其他插件的内部实现，装几个插件就会开始冲突，生态会逐渐碎片化。这不是任何人的错，而是缺少共同约定的必然结果。
|
|
|
|
## 我们的愿景
|
|
|
|
我们希望构建一个**开放、可组合、可持续**的 DSH 插件生态：
|
|
|
|
- **开放**：任何作者都可以参与，官方、桌面和第三方插件在同一个平台上平等组合。
|
|
- **可组合**：插件按同一套约定扩展，装在一起也能一起工作、互不干扰。
|
|
- **可持续**：升级保持向后兼容，生态可以长期演进，不需要推倒重来。
|
|
|
|
## 我们倡导的三条原则
|
|
|
|
1. **组合优先**：通过官方 slot、service 和 patch 组合能力，不要假设或覆盖其他插件的内部实现。
|
|
2. **声明清晰**：明确声明依赖的 service 和 slot，不依赖运行时巧合。
|
|
3. **兼容优先**：升级保持向后兼容，不破坏已有组合。
|
|
|
|
## 桌面壳是第一个范例
|
|
|
|
DSH Desktop 是这套方式的第一个实践者：桌面壳本身就是一个普通 DSH 插件，与官方、第三方插件走同一条组合路径，没有任何特权。我们不是魔改上游源码做一个固定外壳，而是让"桌面"也成为插件生态里平等的一员。
|
|
|
|
## 活文档，社区共建
|
|
|
|
这份倡议不是单方面规定，而是一份**活文档**：它随生态实践更新，接受社区讨论和修订。任何作者都可以通过 issue、讨论区或 PR 提出修改。
|
|
|
|
## 插件市场：让约定成为有利的选择
|
|
|
|
插件市场上线后，符合本倡议的插件将更容易被发现、安装和信任。我们希望让"按规范开发"成为对每个作者都有利的选择，而不是额外的负担。
|
|
|
|
## 如何参与
|
|
|
|
- 在[插件开发](plugin-development.md)中了解插件如何编写。
|
|
- 在[用户指南](user-guide.md)中了解如何安装和管理插件。
|
|
- 通过 issue 和讨论区提出你对本倡议的意见。
|