docs: 更新全部 markdown — CLI 子命令语法 + 新功能

- README: 所有 CLI 示例改为 qrgen encode/decode 子命令
- CHANGELOG: 新增 0.3.0 CLI 重构条目(子命令/stdin/退出码/进度条)
- CLAUDE.md: 更新 CLI 构建命令 + 架构描述
- CLI_USAGE.md: 完全重写完整参数列表 + stdin/补全/退出码章节
This commit is contained in:
2026-06-20 17:52:21 +08:00
parent e6a7efc760
commit 8298cd4c9c
4 changed files with 111 additions and 75 deletions
+7 -6
View File
@@ -22,13 +22,13 @@ cargo build -p qr-core
# CLI 构建
cargo build --release -p qrgen
cargo run -p qrgen -- "Hello World"
cargo run -p qrgen -- encode "Hello World"
# Web 服务
cargo run -p qrgen-web # → http://localhost:3000
# CLI 解码
cargo run -p qrgen -- --decode test.png
cargo run -p qrgen -- decode test.png
# GUI 开发模式
cd gui/src-frontend && pnpm dev # 终端1: Vite 热更新
@@ -98,12 +98,13 @@ QRGen/
│ │ ├── placement.rs # 蛇形数据排列
│ │ └── mask.rs # 8 种掩码 + 四规则惩罚评分
│ └── render/
│ ├── png.rs # PNG 输出 (image crate, 直接边界检测 margin)
│ ├── image.rs # 图像输出 (PNG/BMP/JPEG/WebP, image crate)
│ │ # OutputFormat 枚举,支持 Logo 叠加
│ ├── svg.rs # SVG 输出 (预分配容量)
│ └── ascii.rs # 终端 ASCII (██/ )
├── cli/ # CLI 命令行 (依赖 core + clap + anyhow)
│ └── src/main.rs # Args { content, -o, -l, -v, -s, -m, --invert }
│ # 含路径遍历防护(拒绝 .. 组件)
├── cli/ # CLI 命令行 (依赖 core + clap + clap_complete + indicatif)
│ └── src/main.rs # 子命令: encode/decode, stdin 管道, 批量进度条
│ # 含路径遍历防护 + 退出码 + Shell 补全
├── gui/ # Tauri 桌面应用 (依赖 core + tauri-plugin-*)
│ ├── capabilities/default.json # ACL 权限 (store/dialog/clipboard/fs)
│ ├── src/