# Contributing

## 版本控制

本仓库使用 **[Jujutsu (jj)](https://jj-vcs.dev/)**。请勿使用 `git` 命令。

```bash
jj log          # 查看历史
jj status       # 查看状态
jj new          # 创建新变更
jj commit       # 提交
jj rebase       # 变基
jj squash       # 合并提交
jj git push     # 推送到远端
```

详见 [AGENTS.md](AGENTS.md) 的「版本控制」章节。

## 本地开发

```bash
# 复制环境变量
cp deploy/.env.example .env

# 填写数据库连接等配置后
cargo build
cargo test --locked
```

## 提交前检查

每次提交前必须通过：

```bash
cargo fmt -- --check
cargo clippy --locked -- -D warnings
cargo test --locked
```

或使用脚本：

```bash
./scripts/release-check.sh
```

## 发版规则

当前仓库已切换到 v3 架构，不再围绕 `secrets-mcp` 做单独发版。

提交前请至少保证：

1. `cargo fmt -- --check`
2. `cargo clippy --locked -- -D warnings`
3. `cargo test --locked`

详见 [AGENTS.md](AGENTS.md) 中最新的仓库说明。