如何加入EAC-Desktop社区：问题反馈、贡献流程与DSH插件生态完全指南-迪斯科星球

如何加入EAC-Desktop社区：问题反馈、贡献流程与DSH插件生态完全指南

【免费下载链接】EAC-DesktopEmbracing All Creation (Desktop) — Dedicated to the Harmonious Coexistence of Hundreds of DSH Plugins / 揽尽万象（桌面版） —— 致力于让数百个DSH插件和谐共存项目地址: https://gitcode.com/gh_mirrors/de/EAC-Desktop

EAC-Desktop（揽尽万象，Embracing All Creation）是基于 DeepSeek Harness 的开源 AI 桌面工作台，致力于让数百个DSH 插件和谐共存。无论你是想反馈问题、参与代码贡献，还是探索DSH 插件生态，这篇完全指南都能帮你在几分钟内搞清楚社区的参与路径与玩法。

3分钟看懂 DSH 插件生态：分级来源与统一管理

EAC-Desktop 的核心理念是"开放的是能力，清晰的是边界"。桌面壳负责体验，服务层负责运行，插件则负责扩展更多可能。

插件的三级来源体系

EAC-Desktop 的 DSH 插件采用builtin / recommended / external三级分类：

分级	含义	典型代表
builtin内置	随安装包分发的配套能力	文件协作、上下文压缩、快速配置
recommended推荐	官方推荐目录中的扩展插件	会话管理、桌宠、语音输入
external外部	社区开发的第三方插件	统一插件市场、各类 UI 增强

几个关键入口值得了解：

统一插件市场：dsh-desktop/assets/plugins/dsh-unified-market/ 聚合三源目录，提供一键安装/卸载
插件保护中心：dsh-plugin-shield提供安装前快照、体检与回滚，装错插件也能一键还原
插件账本：.sync/plugin-distribution.json 记录分发规则，dsh-desktop/assets/SOURCES.json 记录每个组件的来源与许可
插件设置面板：界面内的双语设置项继承宿主主题，支持显示状态、自动启动等开关

完整的插件作者与皮肤许可记录见 docs/ECOSYSTEM-CREDITS.md，接入规则详见 docs/adr/0008-plugin-distribution-boundary.md。

问题反馈指南：一份高质量Issue的5要素

遇到问题时，在 GitHub Issues 提交前，请按以下清单整理信息，能让定位效率倍增：

应用版本—— 主窗口左上角即有版本号显示（如 v6.0.0）
操作系统—— Windows / Linux / macOS 及具体版本
包类型—— 完整版 / 精简版 / 便携版 / AppImage 等
复现步骤—— 从启动到出错的操作路径
脱敏日志—— 去除敏感信息后的运行日志

💡 社区处理问题非常严谨——以 docs/bugs/v6-portable/README.md 为例，每个用户反馈都会被逐项记录处理结论与复现条件，"无法复现"的项会明确标注，而不是简单关闭。你的每条反馈都会被认真对待。

从克隆仓库到 Pull Request：贡献流程完整步骤

想参与开发？按照 CONTRIBUTING.md 的规范走即可，核心原则是：任务分支 + Pull Request，main不直接开发。

第一步：准备环境与分支

克隆仓库（含子模块）后，从origin/main创建语义化任务分支：

git clone https://gitcode.com/gh_mirrors/de/EAC-Desktop cd EAC-Desktop git submodule update --init --recursive git checkout -b feat/your-feature origin/main

推荐分支前缀：feat/、fix/、refactor/、test/、docs/、release/。

第二步：按规范提交

采用Conventional Commits格式：

<type>(<scope>): <简短说明>

提交前用git status --short --branch和git diff检查改动范围，未经验证不合并。

第三步：运行最低验证集

功能修改必须跑通对应验证。在dsh-desktop目录下执行类型检查、测试与插件账本检查：

npm run typecheck npm test node scripts/plugin-ledger.mjs node scripts/plugin-sync.mjs validate

测试用例位于 dsh-desktop/test/，覆盖了平台适配、环境隔离、插件同步、包完整性等 70+ 项测试。构建与打包脚本参考 tauri-shell/stage-resources.mjs 和 README.md 中的"开发指南"章节。

第四步：架构归属判断

拿不准改动该放哪一层？项目用明确的三层边界划分职责——L1 原生桌面（Rust）、L2 运行编排（Node）、L3 Harness 内核。阅读 docs/adr/0002-shell-boundary-and-layering.md 与 docs/adr/0003-plugin-isolation-architecture.md 能快速建立全局认知。

社区交流入口一览

渠道	适合场景
GitHub Issues	缺陷复现、功能建议、使用反馈
QQ 群 1083832019	使用技巧交流、插件开发、问题排查
Discord DSH-EAC	国际社区交流
Pull Requests	代码、插件兼容、平台支持与文档改进

延伸阅读资源清单 📚

资源	路径
贡献规范	CONTRIBUTING.md
架构决策记录	docs/adr/
插件分发规范	docs/adr/0008-plugin-distribution-boundary.md
插件来源账本	.sync/plugin-distribution.json
生态致谢与许可	docs/ECOSYSTEM-CREDITS.md
环境隔离设计	docs/adr/0004-eac-install-environment-isolation.md
完整功能与下载	README.md

无论你是提交第一份问题反馈，还是写出第一个插件适配 PR，EAC-Desktop 社区都欢迎你一起"揽尽万象"。🚀

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析