贡献指南

从公开仓库开始

克隆 tokendance-code，读取当前分支规则，再基于 Rust workspace 修改。文档站是独立的 tokendance-code-web 仓库。

验证源码改动

完整测试会执行 PowerShell。Windows 使用 powershell.exe；Linux 和 macOS 需要将 PowerShell 7 的 pwsh 加入 PATH。构建本身和 CLI 模拟会话不需要 PowerShell。

当前 Rust 检查为：

cargo fmt --all -- --check
cargo test --workspace

pnpm verify 当前执行上述 Cargo 检查。修改 wrapper 时还可使用仓库中的 pnpm release:rust:plan:check 与 pnpm smoke:rust-wrapper；运行前查看当前定义。较早的 TypeScript 打包命令不能代替 Rust 发行检查。

准确描述用户可用能力

新增适配器或 SDK 方法后，需要单独检查暴露该能力的 CLI 或消费入口。文档应说明版本、支持的调用方式、预期输出与剩余限制。公开契约改变时，同步维护中英文指南。

准备发行

源码合并与检查通过不会自动发布软件包。遵从当前发布准备指南，在记录 npm 安装命令之前验证 registry 可用性。