workdsh/docs/plugin-ecosystem.md

# DSH 插件生态倡议书

[English](plugin-ecosystem.en.md) | 中文

DSH 的插件生态正在快速增长。插件越多，它们能否协同工作就越重要：如果每个插件都假设甚至覆盖其他插件的内部实现，装几个插件就会开始冲突，生态会逐渐碎片化。这不是任何人的错，而是缺少共同约定的必然结果。

## 我们的愿景

我们希望构建一个**开放、可组合、可持续**的 DSH 插件生态：

- **开放**：任何作者都可以参与，官方、桌面和第三方插件在同一个平台上平等组合。
- **可组合**：插件按同一套约定扩展，装在一起也能一起工作、互不干扰。
- **可持续**：升级保持向后兼容，生态可以长期演进，不需要推倒重来。

## 我们倡导的三条原则

1. **组合优先**：通过官方 slot、service 和 patch 组合能力，不要假设或覆盖其他插件的内部实现。
2. **声明清晰**：明确声明依赖的 service 和 slot，不依赖运行时巧合。
3. **兼容优先**：升级保持向后兼容，不破坏已有组合。

## 桌面版如何组合插件

WorkDSH Desktop 使用 Electron 承载固定版本的官方 DSH 运行时。桌面壳负责窗口、安装和打包；WorkDSH 功能以 DSH 插件和 Profile 包组合，通过官方扩展接口与其他兼容插件协作。桌面壳本身不是 DSH 插件。

## 活文档，社区共建

这份倡议不是单方面规定，而是一份**活文档**：它随生态实践更新，接受社区讨论和修订。任何作者都可以通过 issue、讨论区或 PR 提出修改。

## 插件市场：让约定成为有利的选择

插件市场上线后，符合本倡议的插件将更容易被发现、安装和信任。我们希望让"按规范开发"成为对每个作者都有利的选择，而不是额外的负担。

## 当前边界

当前插件使用 DSH/Cordis 已发布的公开接口。未来若建立统一的插件声明或目录，应先以真实插件、兼容测试和用户需求验证；能力声明可辅助兼容判断、用户确认与审计，但不能把同进程 JavaScript 描述成安全沙箱。只有具备真实隔离证据的 Host 才能声称权限被技术强制执行。

目前没有在线市场页面或安装器。未来的目录收录只代表满足目录规则，不等于安全审核或推荐。

## 如何参与

- 在[插件开发](plugin-development.md)中了解插件如何编写。
- 在[用户指南](user-guide.md)中了解如何安装和管理插件。
- 通过 issue 和讨论区提出你对本倡议的意见。