第 2026-05-07 期
API · 在线
DeepSeek TUI
深度求索 · 终端代理
Install →
Section 05 · 参与

Contribute 参与

No CLA. No sponsor lockouts. The maintainer is one person; please be the kind of contributor you'd want to receive. Specifically: small focused PRs, real test coverage, and prose that tells the reviewer what you were thinking.

  1. ①
    选择切入点

    Find a thread to pull

    Browse open issues. The good first issue label means the path is clear. The help wanted label means the path is open but contested. Anything else, ask first.

    Open issues →
  2. ②
    复刻并分支

    Fork and branch

    git clone your fork, then git checkout -b feat/short-name or fix/short-name. We use conventional commits — feat:, fix:, docs:, refactor:, test:, chore:.

    Repo on GitHub →
  3. ③
    本地检查

    Match the local checks

    CI runs cargo fmt --all -- --check, cargo clippy --workspace --all-targets --all-features --locked -- -D warnings, and cargo test --workspace --all-features --locked. Run them before you push.

    Contributing guide →
  4. ④
    提交合并

    Open the PR

    PR description should explain WHY, not WHAT (the diff covers what). Link the issue. The maintainer reviews everything personally — usually within a day.

    PR template →

House rules 规约

Short version: build the thing, don't polish the meta. The fullCode of Conductis the long version.

  • YesBug reports with reproductions, refactors that explain the trade-off, docs PRs that fix a real ambiguity.
  • YesTests that demonstrate the bug — even better than fixes.
  • YesHard questions in Discussions. Even better if you bring data.
  • NoDrive-by AI-generated patches with no understanding of the diff.
  • NoAdding hosted SaaS dependencies, telemetry, or referral links to the codebase or docs.
  • NoRenaming things across the repo to match your preferences.
The dev loop · 开发循环

From clone to merged

The full sequence, copy-pasteable. Stable Rust only — never reach for nightly features.

# fork on github, then:
git clone git@github.com:YOU/deepseek-tui
cd deepseek-tui
git checkout -b feat/your-thing

# build and run locally
cargo build
cargo run --bin deepseek

# checks (matches CI exactly)
cargo fmt --all -- --check
cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
cargo test --workspace --all-features --locked

# parity gates
cargo test -p deepseek-tui-core --test snapshot --locked
cargo test -p deepseek-protocol --test parity_protocol --locked
cargo test -p deepseek-state --test parity_state --locked

# commit + push + PR
git commit -m "feat: short subject in conventional-commit form"
git push -u origin feat/your-thing
gh pr create --fill