65 lines
2.4 KiB
Markdown
65 lines
2.4 KiB
Markdown
# wx-cli Project Rules
|
||
|
||
## After Every Code Change
|
||
|
||
**Rust 代码改动后，必须立刻运行：**
|
||
|
||
```bash
|
||
cargo check
|
||
```
|
||
|
||
不允许在 `cargo check` 通过之前提交或推送。
|
||
|
||
**改动涉及跨平台代码（`#[cfg(...)]` / `Cargo.toml` dependencies）时，额外运行：**
|
||
|
||
```bash
|
||
cargo check --target x86_64-unknown-linux-gnu
|
||
cargo check --target x86_64-pc-windows-gnu # 在 macOS 上用这个，msvc 需要 MSVC 工具链
|
||
```
|
||
|
||
macOS 上需要一次性安装 target 和交叉编译器：
|
||
|
||
```bash
|
||
rustup target add x86_64-pc-windows-gnu
|
||
brew install mingw-w64 # 提供 x86_64-w64-mingw32-gcc，zstd-sys 等 C 依赖需要
|
||
```
|
||
|
||
这两条 check 命令用于提前暴露 Linux/Windows 特有的编译错误，**只做类型检查**（不 link）。
|
||
|
||
## IPC / 跨平台同库约定
|
||
|
||
动任何 IPC / 网络代码时：**两端必须用同一个库、同一套 API**。例如 server 用 `interprocess::local_socket::tokio::Listener`，client 就必须用 `interprocess::local_socket::Stream::connect`，不能用 `std::fs::OpenOptions` 打开同名路径——即使 kernel 名字对上了，底层的 framing / overlapped 模式也不兼容。
|
||
|
||
## Cargo.toml 修改规则
|
||
|
||
- 修改版本号后，必须运行 `cargo update --workspace` 更新 Cargo.lock
|
||
- 添加/移动 `[target.'cfg(...)'.dependencies]` section 时，确认后续依赖没有被意外归入该 section（TOML section 持续到下一个 header）
|
||
- 改完后运行 `cargo check` 验证
|
||
|
||
## Git 规则
|
||
|
||
- 每次 commit 后必须 push（`git push origin main`）
|
||
- 打 tag 前确认 `cargo check` 和 `cargo update --workspace` 都已完成
|
||
- remote 使用 `origin` → `git@github.com:botiverse/wx-cli.git`（SSH）
|
||
- 不要使用已 DMCA 的 `jackwener/wx-cli`
|
||
|
||
## 平台兼容性检查清单
|
||
|
||
改动以下内容时必须做跨平台 check：
|
||
|
||
- [ ] `libc::` 调用 → 确认函数在 Linux 和 macOS 都存在（`__error` 是 macOS 专属，用 `std::io::Error::last_os_error()` 代替）
|
||
- [ ] `#[cfg(unix)]` 块 → unix 包括 macOS 和 Linux，不能用 macOS 专属 API
|
||
- [ ] `Cargo.toml` dependency section 顺序 → 检查是否有 dep 意外落入 target section
|
||
- [ ] Windows named pipe 代码 → 确认函数都已定义，trait import 齐全
|
||
|
||
## CI 结构
|
||
|
||
```
|
||
check job（ubuntu）
|
||
└── cargo check --target linux-x86, linux-arm64, windows-x86
|
||
↓ 通过后
|
||
build jobs（5平台并行）
|
||
↓ 全部通过后
|
||
publish-npm job
|
||
```
|