wx-cli-again: Instructions file for Claude Code

wx-cli Project Rules

After Every Code Change

Rust 代码改动后，必须立刻运行：

cargo check

不允许在 cargo check 通过之前提交或推送。

改动涉及跨平台代码（#[cfg(...)] / Cargo.toml dependencies）时，额外运行：

cargo check --target x86_64-unknown-linux-gnu
cargo check --target x86_64-pc-windows-gnu   # 在 macOS 上用这个，msvc 需要 MSVC 工具链

macOS 上需要一次性安装 target 和交叉编译器：

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 → [email protected]: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