贡献指南

感谢您考虑为 ZapMyCo 做贡献！

行为准则

本项目采用贡献者公约作为行为准则。参与本项目即表示您同意遵守其条款。

如何贡献

报告 Bug

如果您发现了 Bug，请通过 GitHub Issues 报告。

报告 Bug 时，请包含：

1. 清晰的标题 — 简要描述问题
2. 复现步骤 — 详细说明如何复现
3. 预期行为 — 您期望发生什么
4. 实际行为 — 实际发生了什么
5. 环境信息 — 操作系统、Deno 版本等

建议新功能

我们欢迎新功能建议！请在 Issue 中描述：

1. 功能描述 — 您希望添加什么功能
2. 使用场景 — 为什么需要这个功能
3. 替代方案 — 您考虑过的其他方案

提交代码

开发环境设置

# 克隆仓库
git clone https://github.com/shenjingnan/zapmyco.git
cd zapmyco

# 初始化
deno task dev

分支策略

• main — 主分支，保持稳定
• feature/* — 新功能分支
• fix/* — Bug 修复分支
• docs/* — 文档更新分支

提交规范

遵循 Conventional Commits：

<type>(<scope>): <description>

类型：

• feat — 新功能
• fix — Bug 修复
• docs — 文档
• style — 代码格式
• refactor — 重构
• perf — 性能优化
• test — 测试
• chore — 构建/工具

示例：

feat: add new CLI command
fix(ai): handle empty input in AI agent
docs: update API reference

Pull Request 流程

1. Fork 仓库
2. 创建功能分支（git checkout -b feature/my-feature）
3. 进行更改
4. 确保检查通过：deno task check:all
5. 提交更改
6. 推送分支（git push origin feature/my-feature）
7. 创建 Pull Request

PR 检查清单

• 代码通过所有测试
• 代码通过 lint 检查
• 代码通过类型检查
• 新功能有对应测试
• 文档已更新（如需要）
• Commit 消息遵循规范

开发指南

代码风格

• 2 空格缩进
• 单引号
• 必须有分号
• 行宽 100 字符
• 禁止 any 类型（warn）

质量检查

# 运行所有检查
deno task check:all

# 或逐步执行
deno fmt --check    # 格式检查
deno lint           # 代码检查
deno check          # 类型检查
deno test           # 测试

测试规范

• 测试文件与源码同目录，遵循 src/*_test.ts 惯例
• 使用 Deno 原生测试 API（Deno.test）和 @std/assert
• 运行测试：deno task test
• 覆盖率报告：deno task test:coverage

获取帮助

如果您有任何问题，可以：

• 查看文档站点
• 在 Discussions 提问
• 创建 Issue

许可证

通过贡献代码，您同意您的代码将在 MIT 许可证下发布。