# 贡献指南 / Contributing

感谢你有兴趣参与器灵 Soulmate 的社区建设。本仓库定位为**社区与运营入口**，欢迎贡献文档、反馈与协作内容。

## 行为准则

请保持友善、专业、尊重。本仓库不发布产品源码，因此**不要**在此提交或请求产品核心代码、密钥、账号、内部服务器信息等。

## 我们能接受什么贡献

- **文档改进**：修正错别字、优化 README / 文档表述、改进界面文案；
- **Issue 反馈**：Bug 报告、需求建议、使用体验反馈；
- **讨论参与**：在 Discussions 中分享使用经验、提出改进想法；
- **运营协作**：社区模板、协作流程上的改进。

## 我们不能接受什么

- **产品核心源码**：器灵 Soulmate 桌面端核心运行时、编排策略、商业服务端与生产配置保持闭源，请勿在此索取或上传此类内容；
- **敏感信息**：任何密钥、令牌、账号、邮箱、内部服务器地址、绝对本机路径或虚构数据；
- **下载直链 / 破解 / 逆向**：本仓库不提供产品下载直链，也不接受相关请求。

## 提交 Issue

请使用对应的 Issue 模板：

- 报告 Bug → [bug_report.yml](./.github/ISSUE_TEMPLATE/bug_report.yml)
- 提交需求建议 → [feature_request.yml](./.github/ISSUE_TEMPLATE/feature_request.yml)

报告前请先搜索是否已存在类似 Issue，避免重复。

## 提交 Pull Request

1. 先通过 Issue 或 Discussion 讨论你的改动，避免做无用功；
2. Fork 本仓库并创建你的分支；
3. 仅修改与你所提改动相关的文件，不做顺手重构；
4. 保持仓库现有风格（中文为主，必要时附精炼英文）；
5. 使用 [PR 模板](./.github/PULL_REQUEST_TEMPLATE.md) 描述改动；
6. 提交后等待审核与反馈。

## 审核预期

- 我们会尽量及时响应；
- 部分改动可能需要多次往返澄清，请耐心配合；
- 不符合本仓库定位的贡献可能会被礼貌地关闭并说明原因。

## 联系我们

如需进一步沟通产品与下载信息，请访问官方网站：<https://qiling.swcbg.com>。