参与开发

感谢参与 DSH Dock。仓库的目标是为未经修改的 DeepSeek Harness Web UI提供 Windows 桌面壳与独立插件增强；不要 fork、patch 或提交官方 Web UI / 运行时生成文件。

开始之前

• 使用 Windows 10/11，以及 Node.js 22.19.x 或 24.x。
• 从最新 main 创建短期分支；main 只通过 Pull Request 更新。
• 修改插件前必须阅读 plugins/PLUGIN_STANDARDS.md 和 docs/PLUGIN-README-TEMPLATE.md。
• 保持变更聚焦，不混入版本升级、全仓库格式化或无关重构。

npm ci
git switch -c <type>/<short-description>

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

开发约束

• 桌面增强优先放在 plugins/dsh-desktop-*，并优先使用官方 DSH/Cordis 扩展点。
• 不修改 node_modules、打包后的运行时内容或官方 DSH Web UI。
• 新插件必须包含符合模板的 README 和适当的 host/client 测试。
• 保留 Cordis 生命周期与 disposer 语义；持久化遵循插件规范，不使用被禁止的 localStorage。
• 不使用破坏性 Git 命令；只暂存本次变更的明确路径。

提交前验证

所有 PR 必须通过统一质量门禁：

npm run check

影响打包、运行时准备、Electron 主进程或发布工作流时，还应运行：

npm run dist:offline

若环境无法完成构建，必须在 PR 中明确说明限制；不要声称未实际运行的检查已经通过。

提交与 Pull Request

• 提交信息使用仓库现有的 Conventional Commit 风格，例如 feat:、fix:、chore:、test:。
• 一个 PR 只解决一个逻辑问题，说明行为影响、风险和验证结果。
• 产品行为变更必须有测试；新增或改变仓库契约时更新对应文档。
• 不在普通 PR 中修改版本号、创建标签或发布 Release，除非任务本身就是发布。
• 等待必需 CI 检查通过并解决所有讨论后再合并；优先 squash merge，保持 main 线性清晰。

编码 Agent 还应遵循根目录 AGENTS.md。