感谢参与 DSHBox。开始前请先阅读 项目边界、架构与开发指南。复现环境问题时可先查故障排查。
- 先搜索已有 issue,较大的功能或会改变用户习惯的交互先讨论。
- 保持薄外壳边界:不 fork、patch 或复制 dsh 内核与 Web UI。
- 使用英文 Conventional Commits,例如
fix: ...、feat: ...、docs: ...。 - 提交信息只记录实际改动、原因与用户影响,不写本机路径、私有信息、对话指令或具体辅助工具与工作流程名称。
- 新逻辑补测试;新文案补齐中英文;修改 UI 检查深浅色和减弱动态效果。
- 提交前运行:
npm run check
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
cargo test --manifest-path src-tauri/Cargo.toml --all-targetsPR 请说明用户影响、设计取舍、测试结果和已知负面影响。涉及右键菜单、更新、凭据、插件自动安装或文件替换时,请单列回归与恢复方案。不要提交构建产物、日志、凭据或私人会话数据。
安全问题不要提交公开 issue 或 PR,按 SECURITY.md 私密报告。