pix-cli 0.1.0__tar.gz → 0.1.2__tar.gz

pix_cli-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 uzvg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pix_cli-0.1.2/PKG-INFO

@@ -0,0 +1,250 @@
+Metadata-Version: 2.5
+Name: pix-cli
+Version: 0.1.2
+Summary: Batch AVIF shrink and image-host sync CLI
+Project-URL: Homepage, https://github.com/uzvg/pix
+Project-URL: Repository, https://github.com/uzvg/pix
+Project-URL: Issues, https://github.com/uzvg/pix/issues
+Project-URL: Changelog, https://github.com/uzvg/pix/releases
+Author-email: uzvg <uzvg@qq.com>
+License: MIT
+License-File: LICENSE
+Keywords: avif,cli,image-compression,image-host,rclone
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: System :: Archiving :: Backup
+Requires-Python: >=3.11
+Requires-Dist: pyvips[binary]>=3.2
+Description-Content-Type: text/markdown
+
+# pix
+
+**Batch AVIF shrink and image-host sync CLI.**
+
+`pix` incrementally compresses local image directories to AVIF, mirrors originals to cloud storage, and publishes compressed images to an image host. Compression uses pyvips; sync is delegated to rclone.
+
+[中文](https://github.com/uzvg/pix/blob/main/README.zh-CN.md) · [Architecture](https://github.com/uzvg/pix/blob/main/docs/architecture.md) · [Development](https://github.com/uzvg/pix/blob/main/docs/development.md) · [Decisions](https://github.com/uzvg/pix/blob/main/docs/decisions.md) · [Roadmap](https://github.com/uzvg/pix/blob/main/docs/roadmap.md)
+
+> Status: core commands are implemented and tested. Real R2 and Windows smoke tests are still pending; see the [roadmap](https://github.com/uzvg/pix/blob/main/docs/roadmap.md).
+
+## What pix does
+
+| Command | Purpose |
+|---|---|
+| `pix shrink` | Recursively compress images to AVIF, re-encoding only changed files |
+| `pix backup` | Bidirectionally mirror an original photo directory to a cloud drive |
+| `pix publish` | Bidirectionally mirror AVIF output to an image host; optionally emit public URLs |
+| `pix doctor` | Check Python, libvips, rclone and configuration |
+| `pix config init` | Write a commented default configuration file |
+
+`pix` is deliberately narrow:
+
+- It is not an rclone replacement and does not manage credentials.
+- It does not read repository config or care about version control.
+- It has no one-shot `pix run`; you chain the commands yourself.
+
+## How it works
+
+```text
+photos/ ── shrink (pyvips) ──> out/*.avif + out/.pix/state.json
+                                     │
+                                     └── publish (rclone bisync) ──> r2:images
+photos/ ── backup (rclone bisync) ────────────────────────────────> onedrive:photos
+```
+
+| Command | What actually runs | Who does the work |
+|---|---|---|
+| `shrink` | pyvips thumbnail + AVIF encode | pix |
+| `backup` | `rclone bisync SRC REMOTE` | pix composes arguments, rclone executes |
+| `publish` | `rclone bisync OUT REMOTE`, excluding `.pix/**` | pix + rclone |
+| `doctor` / `config init` | Dependency checks / config scaffold | pix |
+
+**Sync is rclone.** `backup` and `publish` only compose `rclone bisync` arguments; rclone handles authentication, transfers and conflict handling. Configure remotes with `rclone config` before using them. `pix` never reads or writes `rclone.conf`.
+
+`backup` / `publish` are **bidirectional mirrors**, not one-way backups. Deletions propagate in both directions.
+
+## Requirements
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/)
+- rclone >= 1.66 for `backup` / `publish`
+- At least one remote already configured in rclone
+
+`pyvips[binary]` bundles libvips, so no separate vips installation is required.
+
+## Install
+
+Not yet published on PyPI; install from source:
+
+```bash
+git clone https://github.com/uzvg/pix.git
+cd pix
+uv tool install --editable .
+pix --version
+```
+
+Linux installs `~/.local/bin/pix`; Windows installs `%USERPROFILE%\.local\bin\pix.exe`. An editable install picks up source changes immediately. Reinstall with `uv tool install --force --editable .`, or remove it with `uv tool uninstall pix-cli`.
+
+## Configure rclone
+
+Only needed for `backup` / `publish`:
+
+```bash
+rclone config         # create a remote, for example onedrive or r2
+rclone lsd onedrive:  # verify that it works
+```
+
+rclone stores credentials in `~/.config/rclone/rclone.conf` (Windows: `%APPDATA%\rclone\rclone.conf`). `pix` passes the remote name through and does not store or validate credentials.
+
+## Configure pix (optional)
+
+Default configuration paths:
+
+- Linux/macOS: `$XDG_CONFIG_HOME/pix/config.toml`, or `~/.config/pix/config.toml`
+- Windows: `%APPDATA%\pix\config.toml`
+
+If the file is missing, built-in defaults are used. Generate a commented file with:
+
+```bash
+pix config init
+```
+
+Existing files are not overwritten; pass `--force` to replace one. Use `--config PATH` before the subcommand to point at another file.
+
+Common keys:
+
+| Section | Key | Default | Meaning |
+|---|---|---|---|
+| `[shrink]` | `width` | `1920` | Longest edge in pixels |
+| | `quality` | `85` | AVIF quality, 1–100 |
+| | `effort` | `5` | libvips effort, 0–9 |
+| | `min_size` | `0` | Skip sources smaller than this; accepts `500K`, `1M`, `2G` |
+| | `include` | `jpg`, `jpeg`, `png`, `webp` | Extensions to scan, without dots |
+| `[backup]` | `exclude` | `[]` | rclone exclude globs; command-line values are appended |
+| | `max_delete` | `10` | Delete limit as a percentage; `-1` disables, `0` forbids |
+| `[publish]` | `base_url` | `""` | Public URL prefix; must start with `http://` or `https://` |
+| | `urls` | `false` | Emit a JSON URL manifest |
+| | `exclude` | `[]` | Same as backup |
+| | `max_delete` | `10` | Same as backup |
+| `[rclone]` | `binary` | `rclone` | rclone executable name or path |
+
+Precedence is **command line > pix config > built-in defaults**. `--exclude` is appended to config excludes rather than replacing them. `-q` means quality; silence is `--quiet` (no short form).
+
+## Quick start
+
+1. Check the environment:
+
+   ```bash
+   pix doctor
+   ```
+
+2. Compress images:
+
+   ```bash
+   pix shrink -s ~/Pictures -d ~/Pictures-avif --dry-run
+   pix shrink -s ~/Pictures -d ~/Pictures-avif -w 1920 -q 85
+   ```
+
+   The first run encodes everything; later runs skip unchanged files. State lives in `OUT/.pix/state.json`. Changing `width`, `quality` or `effort` triggers a full re-encode. `--dry-run` only prints the plan.
+
+3. Back up originals:
+
+   ```bash
+   pix backup -s ~/Pictures -d onedrive:photos --dry-run
+   pix backup -s ~/Pictures -d onedrive:photos --resync
+   ```
+
+   `--resync` is required on the first run. Always preview with `--dry-run` first.
+
+4. Publish the AVIF output:
+
+   ```bash
+   pix publish -s ~/Pictures-avif -d r2:images \
+     --base-url https://img.example.com --urls > urls.json
+   ```
+
+   `publish` requires at least one `.avif` in the source and always excludes `.pix/**`. The URL manifest is printed to stdout as JSON only after a successful, non-dry-run sync.
+
+5. Re-run later:
+
+   ```bash
+   pix shrink -s ~/Pictures -d ~/Pictures-avif
+   pix backup -s ~/Pictures -d onedrive:photos
+   pix publish -s ~/Pictures-avif -d r2:images --urls
+   ```
+
+   Only changes are encoded and transferred.
+
+## Command cheat sheet
+
+| Task | Command |
+|---|---|
+| Preview compression | `pix shrink -s SRC -d OUT --dry-run` |
+| Re-encode everything | `pix shrink -s SRC -d OUT --force` |
+| Remove outputs whose source is gone | `pix shrink -s SRC -d OUT --prune` |
+| Preview a sync | `pix backup -s SRC -d REMOTE --dry-run` |
+| First run, or after changing excludes | `pix backup -s SRC -d REMOTE --resync` |
+| Emit a URL manifest | `pix publish -s OUT -d REMOTE --base-url https://img.example.com --urls` |
+| Diagnose the environment | `pix doctor` |
+| Generate a config file | `pix config init` |
+
+## Safety rules
+
+| Situation | What happens | Protection |
+|---|---|---|
+| Deletions on either side | Propagated in both directions; accidental deletion is irreversible | Preview with `--dry-run`; default `--max-delete 10` (percentage) |
+| First sync | rclone has no baseline and errors | Add `--resync` explicitly |
+| Excludes changed | The old baseline may treat excluded files as deletions | Run with `--resync` again after changing excludes |
+| Empty source | `backup` / `publish` refuse; `shrink --prune` also refuses | Use `--allow-empty` (plus `--resync` for sync) only when intentional |
+| `a.jpg` and `a.jpeg` both exist | Both map to the same output | Detected before encoding; exits 2 |
+| Two concurrent shrinks | They would write the same state and outputs | `OUT/.pix/lock` blocks the second process |
+| State lost or corrupt | Warning, then a full rebuild | Only causes re-encoding; outputs stay valid |
+
+## Output and exit codes
+
+- Logs and progress go to stderr.
+- stdout carries `doctor` reports, `--dry-run` plans and `--urls` JSON.
+- Exit codes: `0` success, `1` runtime failure, `2` argument or configuration error.
+- `backup` / `publish` return rclone's exit code unchanged.
+
+URL manifest example:
+
+```json
+{
+  "2024/a.avif": "https://img.example.com/2024/a.avif"
+}
+```
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| `pyvips/libvips unavailable` | Reinstall to bring libvips: `uv tool install --force --editable /path/to/pix`; or install libvips manually (Linux: `apt install libvips42`, Windows: libvips release zip on `PATH`) |
+| rclone is older than 1.66 | Upgrade rclone |
+| bisync reports a missing baseline | Add `--resync` on the first run |
+| `OUT/.pix/lock` already exists | Check for another `shrink`, then remove a stale lock |
+| Configuration fails to parse | Run `pix doctor` to locate the file; fix the TOML or remove the file to fall back to defaults |
+| `publish` says the source has no `.avif` | Run `pix shrink` first |
+| URL-related error | `base_url` must start with `http://` or `https://`, and `--urls` requires it |
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run pix --version
+uv build
+```
+
+The code must stay compatible with Python 3.11. See [development.md](https://github.com/uzvg/pix/blob/main/docs/development.md) for tests, packaging and release details. Behavior is specified in [architecture.md](https://github.com/uzvg/pix/blob/main/docs/architecture.md); rationale lives in [decisions.md](https://github.com/uzvg/pix/blob/main/docs/decisions.md).
+
+The detailed docs are currently written in Chinese.

pix_cli-0.1.2/README.md

@@ -0,0 +1,222 @@
+# pix
+
+**Batch AVIF shrink and image-host sync CLI.**
+
+`pix` incrementally compresses local image directories to AVIF, mirrors originals to cloud storage, and publishes compressed images to an image host. Compression uses pyvips; sync is delegated to rclone.
+
+[中文](https://github.com/uzvg/pix/blob/main/README.zh-CN.md) · [Architecture](https://github.com/uzvg/pix/blob/main/docs/architecture.md) · [Development](https://github.com/uzvg/pix/blob/main/docs/development.md) · [Decisions](https://github.com/uzvg/pix/blob/main/docs/decisions.md) · [Roadmap](https://github.com/uzvg/pix/blob/main/docs/roadmap.md)
+
+> Status: core commands are implemented and tested. Real R2 and Windows smoke tests are still pending; see the [roadmap](https://github.com/uzvg/pix/blob/main/docs/roadmap.md).
+
+## What pix does
+
+| Command | Purpose |
+|---|---|
+| `pix shrink` | Recursively compress images to AVIF, re-encoding only changed files |
+| `pix backup` | Bidirectionally mirror an original photo directory to a cloud drive |
+| `pix publish` | Bidirectionally mirror AVIF output to an image host; optionally emit public URLs |
+| `pix doctor` | Check Python, libvips, rclone and configuration |
+| `pix config init` | Write a commented default configuration file |
+
+`pix` is deliberately narrow:
+
+- It is not an rclone replacement and does not manage credentials.
+- It does not read repository config or care about version control.
+- It has no one-shot `pix run`; you chain the commands yourself.
+
+## How it works
+
+```text
+photos/ ── shrink (pyvips) ──> out/*.avif + out/.pix/state.json
+                                     │
+                                     └── publish (rclone bisync) ──> r2:images
+photos/ ── backup (rclone bisync) ────────────────────────────────> onedrive:photos
+```
+
+| Command | What actually runs | Who does the work |
+|---|---|---|
+| `shrink` | pyvips thumbnail + AVIF encode | pix |
+| `backup` | `rclone bisync SRC REMOTE` | pix composes arguments, rclone executes |
+| `publish` | `rclone bisync OUT REMOTE`, excluding `.pix/**` | pix + rclone |
+| `doctor` / `config init` | Dependency checks / config scaffold | pix |
+
+**Sync is rclone.** `backup` and `publish` only compose `rclone bisync` arguments; rclone handles authentication, transfers and conflict handling. Configure remotes with `rclone config` before using them. `pix` never reads or writes `rclone.conf`.
+
+`backup` / `publish` are **bidirectional mirrors**, not one-way backups. Deletions propagate in both directions.
+
+## Requirements
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/)
+- rclone >= 1.66 for `backup` / `publish`
+- At least one remote already configured in rclone
+
+`pyvips[binary]` bundles libvips, so no separate vips installation is required.
+
+## Install
+
+Not yet published on PyPI; install from source:
+
+```bash
+git clone https://github.com/uzvg/pix.git
+cd pix
+uv tool install --editable .
+pix --version
+```
+
+Linux installs `~/.local/bin/pix`; Windows installs `%USERPROFILE%\.local\bin\pix.exe`. An editable install picks up source changes immediately. Reinstall with `uv tool install --force --editable .`, or remove it with `uv tool uninstall pix-cli`.
+
+## Configure rclone
+
+Only needed for `backup` / `publish`:
+
+```bash
+rclone config         # create a remote, for example onedrive or r2
+rclone lsd onedrive:  # verify that it works
+```
+
+rclone stores credentials in `~/.config/rclone/rclone.conf` (Windows: `%APPDATA%\rclone\rclone.conf`). `pix` passes the remote name through and does not store or validate credentials.
+
+## Configure pix (optional)
+
+Default configuration paths:
+
+- Linux/macOS: `$XDG_CONFIG_HOME/pix/config.toml`, or `~/.config/pix/config.toml`
+- Windows: `%APPDATA%\pix\config.toml`
+
+If the file is missing, built-in defaults are used. Generate a commented file with:
+
+```bash
+pix config init
+```
+
+Existing files are not overwritten; pass `--force` to replace one. Use `--config PATH` before the subcommand to point at another file.
+
+Common keys:
+
+| Section | Key | Default | Meaning |
+|---|---|---|---|
+| `[shrink]` | `width` | `1920` | Longest edge in pixels |
+| | `quality` | `85` | AVIF quality, 1–100 |
+| | `effort` | `5` | libvips effort, 0–9 |
+| | `min_size` | `0` | Skip sources smaller than this; accepts `500K`, `1M`, `2G` |
+| | `include` | `jpg`, `jpeg`, `png`, `webp` | Extensions to scan, without dots |
+| `[backup]` | `exclude` | `[]` | rclone exclude globs; command-line values are appended |
+| | `max_delete` | `10` | Delete limit as a percentage; `-1` disables, `0` forbids |
+| `[publish]` | `base_url` | `""` | Public URL prefix; must start with `http://` or `https://` |
+| | `urls` | `false` | Emit a JSON URL manifest |
+| | `exclude` | `[]` | Same as backup |
+| | `max_delete` | `10` | Same as backup |
+| `[rclone]` | `binary` | `rclone` | rclone executable name or path |
+
+Precedence is **command line > pix config > built-in defaults**. `--exclude` is appended to config excludes rather than replacing them. `-q` means quality; silence is `--quiet` (no short form).
+
+## Quick start
+
+1. Check the environment:
+
+   ```bash
+   pix doctor
+   ```
+
+2. Compress images:
+
+   ```bash
+   pix shrink -s ~/Pictures -d ~/Pictures-avif --dry-run
+   pix shrink -s ~/Pictures -d ~/Pictures-avif -w 1920 -q 85
+   ```
+
+   The first run encodes everything; later runs skip unchanged files. State lives in `OUT/.pix/state.json`. Changing `width`, `quality` or `effort` triggers a full re-encode. `--dry-run` only prints the plan.
+
+3. Back up originals:
+
+   ```bash
+   pix backup -s ~/Pictures -d onedrive:photos --dry-run
+   pix backup -s ~/Pictures -d onedrive:photos --resync
+   ```
+
+   `--resync` is required on the first run. Always preview with `--dry-run` first.
+
+4. Publish the AVIF output:
+
+   ```bash
+   pix publish -s ~/Pictures-avif -d r2:images \
+     --base-url https://img.example.com --urls > urls.json
+   ```
+
+   `publish` requires at least one `.avif` in the source and always excludes `.pix/**`. The URL manifest is printed to stdout as JSON only after a successful, non-dry-run sync.
+
+5. Re-run later:
+
+   ```bash
+   pix shrink -s ~/Pictures -d ~/Pictures-avif
+   pix backup -s ~/Pictures -d onedrive:photos
+   pix publish -s ~/Pictures-avif -d r2:images --urls
+   ```
+
+   Only changes are encoded and transferred.
+
+## Command cheat sheet
+
+| Task | Command |
+|---|---|
+| Preview compression | `pix shrink -s SRC -d OUT --dry-run` |
+| Re-encode everything | `pix shrink -s SRC -d OUT --force` |
+| Remove outputs whose source is gone | `pix shrink -s SRC -d OUT --prune` |
+| Preview a sync | `pix backup -s SRC -d REMOTE --dry-run` |
+| First run, or after changing excludes | `pix backup -s SRC -d REMOTE --resync` |
+| Emit a URL manifest | `pix publish -s OUT -d REMOTE --base-url https://img.example.com --urls` |
+| Diagnose the environment | `pix doctor` |
+| Generate a config file | `pix config init` |
+
+## Safety rules
+
+| Situation | What happens | Protection |
+|---|---|---|
+| Deletions on either side | Propagated in both directions; accidental deletion is irreversible | Preview with `--dry-run`; default `--max-delete 10` (percentage) |
+| First sync | rclone has no baseline and errors | Add `--resync` explicitly |
+| Excludes changed | The old baseline may treat excluded files as deletions | Run with `--resync` again after changing excludes |
+| Empty source | `backup` / `publish` refuse; `shrink --prune` also refuses | Use `--allow-empty` (plus `--resync` for sync) only when intentional |
+| `a.jpg` and `a.jpeg` both exist | Both map to the same output | Detected before encoding; exits 2 |
+| Two concurrent shrinks | They would write the same state and outputs | `OUT/.pix/lock` blocks the second process |
+| State lost or corrupt | Warning, then a full rebuild | Only causes re-encoding; outputs stay valid |
+
+## Output and exit codes
+
+- Logs and progress go to stderr.
+- stdout carries `doctor` reports, `--dry-run` plans and `--urls` JSON.
+- Exit codes: `0` success, `1` runtime failure, `2` argument or configuration error.
+- `backup` / `publish` return rclone's exit code unchanged.
+
+URL manifest example:
+
+```json
+{
+  "2024/a.avif": "https://img.example.com/2024/a.avif"
+}
+```
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| `pyvips/libvips unavailable` | Reinstall to bring libvips: `uv tool install --force --editable /path/to/pix`; or install libvips manually (Linux: `apt install libvips42`, Windows: libvips release zip on `PATH`) |
+| rclone is older than 1.66 | Upgrade rclone |
+| bisync reports a missing baseline | Add `--resync` on the first run |
+| `OUT/.pix/lock` already exists | Check for another `shrink`, then remove a stale lock |
+| Configuration fails to parse | Run `pix doctor` to locate the file; fix the TOML or remove the file to fall back to defaults |
+| `publish` says the source has no `.avif` | Run `pix shrink` first |
+| URL-related error | `base_url` must start with `http://` or `https://`, and `--urls` requires it |
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run pix --version
+uv build
+```
+
+The code must stay compatible with Python 3.11. See [development.md](https://github.com/uzvg/pix/blob/main/docs/development.md) for tests, packaging and release details. Behavior is specified in [architecture.md](https://github.com/uzvg/pix/blob/main/docs/architecture.md); rationale lives in [decisions.md](https://github.com/uzvg/pix/blob/main/docs/decisions.md).
+
+The detailed docs are currently written in Chinese.

pix_cli-0.1.2/README.zh-CN.md

@@ -0,0 +1,220 @@
+# pix
+
+**批量 AVIF 压缩与图床同步 CLI。**
+
+`pix` 把本地图片目录增量压缩为 AVIF，把原图双向镜像到云盘，并把压缩结果发布到图床。压缩使用 pyvips，同步交给 rclone。
+
+[English](https://github.com/uzvg/pix/blob/main/README.md) · [行为规格](https://github.com/uzvg/pix/blob/main/docs/architecture.md) · [开发指南](https://github.com/uzvg/pix/blob/main/docs/development.md) · [技术决策](https://github.com/uzvg/pix/blob/main/docs/decisions.md) · [路线图](https://github.com/uzvg/pix/blob/main/docs/roadmap.md)
+
+> 状态：核心命令已实现并通过测试；真实 R2 与 Windows 冒烟测试仍待完成，见[路线图](https://github.com/uzvg/pix/blob/main/docs/roadmap.md)。
+
+## pix 做什么
+
+| 命令 | 作用 |
+|---|---|
+| `pix shrink` | 递归压缩图片为 AVIF，只重新编码变化的文件 |
+| `pix backup` | 把原图目录与云盘做双向镜像 |
+| `pix publish` | 把 AVIF 输出目录与图床做双向镜像，可选输出公开 URL |
+| `pix doctor` | 检查 Python、libvips、rclone 与配置 |
+| `pix config init` | 生成带注释的默认配置文件 |
+
+`pix` 刻意保持边界清晰：
+
+- 不是 rclone 替代品，不管理云盘凭据。
+- 不读取仓库配置，不感知版本控制状态。
+- 没有一键 `pix run`，命令由你自行组合。
+
+## 工作原理
+
+```text
+photos/ ── shrink (pyvips) ──> out/*.avif + out/.pix/state.json
+                                     │
+                                     └── publish (rclone bisync) ──> r2:images
+photos/ ── backup (rclone bisync) ────────────────────────────────> onedrive:photos
+```
+
+| 命令 | 实际执行的内容 | 谁负责 |
+|---|---|---|
+| `shrink` | pyvips 缩放并编码 AVIF | pix |
+| `backup` | `rclone bisync SRC REMOTE` | pix 拼参数，rclone 执行 |
+| `publish` | `rclone bisync OUT REMOTE`，排除 `.pix/**` | pix + rclone |
+| `doctor` / `config init` | 依赖检查 / 配置脚手架 | pix |
+
+**同步由 rclone 执行。** `backup` / `publish` 只负责拼装 `rclone bisync` 参数；认证、传输和冲突处理都由 rclone 完成。使用前请先用 `rclone config` 配好 remote。`pix` 不读取也不写入 `rclone.conf`。
+
+`backup` / `publish` 是**双向镜像**，不是单向备份。删除会双向传播。
+
+## 前置条件
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/)
+- `backup` / `publish` 需要 rclone >= 1.66
+- 已在 rclone 中配置好至少一个 remote
+
+`pyvips[binary]` 自带 libvips，不需要单独安装 vips。
+
+## 安装
+
+尚未发布到 PyPI，从源码安装：
+
+```bash
+git clone https://github.com/uzvg/pix.git
+cd pix
+uv tool install --editable .
+pix --version
+```
+
+Linux 安装到 `~/.local/bin/pix`，Windows 为 `%USERPROFILE%\.local\bin\pix.exe`。editable 安装修改源码后立即生效。重装用 `uv tool install --force --editable .`，卸载用 `uv tool uninstall pix-cli`。
+
+## 配置 rclone
+
+仅 `backup` / `publish` 需要：
+
+```bash
+rclone config         # 新建 remote，例如 onedrive 或 r2
+rclone lsd onedrive:  # 验证是否可用
+```
+
+rclone 把凭据保存在 `~/.config/rclone/rclone.conf`（Windows：`%APPDATA%\rclone\rclone.conf`）。`pix` 只把 remote 名称透传给 rclone，不保存也不校验凭据。
+
+## 配置 pix（可选）
+
+默认配置路径：
+
+- Linux/macOS：`$XDG_CONFIG_HOME/pix/config.toml`，未设置时为 `~/.config/pix/config.toml`
+- Windows：`%APPDATA%\pix\config.toml`
+
+文件不存在时使用内置默认值。生成带注释的配置文件：
+
+```bash
+pix config init
+```
+
+已有文件不会被覆盖；需要替换时加 `--force`。用 `--config PATH`（写在子命令之前）指向其他文件。
+
+常用配置项：
+
+| 段 | 键 | 默认值 | 说明 |
+|---|---|---|---|
+| `[shrink]` | `width` | `1920` | 最长边像素 |
+| | `quality` | `85` | AVIF 质量，1–100 |
+| | `effort` | `5` | libvips effort，0–9 |
+| | `min_size` | `0` | 小于该值的源文件跳过；支持 `500K`、`1M`、`2G` |
+| | `include` | `jpg`、`jpeg`、`png`、`webp` | 扫描扩展名，不带点 |
+| `[backup]` | `exclude` | `[]` | rclone 排除 glob；命令行项会追加 |
+| | `max_delete` | `10` | 删除百分比上限；`-1` 不限制，`0` 禁止删除 |
+| `[publish]` | `base_url` | `""` | 公开 URL 前缀，必须以 `http://` 或 `https://` 开头 |
+| | `urls` | `false` | 是否输出 JSON URL 清单 |
+| | `exclude` | `[]` | 同 `backup` |
+| | `max_delete` | `10` | 同 `backup` |
+| `[rclone]` | `binary` | `rclone` | rclone 可执行文件名或路径 |
+
+优先级为**命令行 > pix 配置 > 内置默认**。`--exclude` 是追加而非覆盖配置项。`-q` 表示 quality，静默模式用 `--quiet`（无短选项）。
+
+## 快速上手
+
+1. 检查环境：
+
+   ```bash
+   pix doctor
+   ```
+
+2. 压缩图片：
+
+   ```bash
+   pix shrink -s ~/Pictures -d ~/Pictures-avif --dry-run
+   pix shrink -s ~/Pictures -d ~/Pictures-avif -w 1920 -q 85
+   ```
+
+   首次全量编码，之后跳过未变化的文件。状态保存在 `OUT/.pix/state.json`。修改 `width`、`quality` 或 `effort` 会触发全量重编码。`--dry-run` 只打印计划。
+
+3. 备份原图：
+
+   ```bash
+   pix backup -s ~/Pictures -d onedrive:photos --dry-run
+   pix backup -s ~/Pictures -d onedrive:photos --resync
+   ```
+
+   首次运行必须显式加 `--resync`。建议先跑 `--dry-run` 预览。
+
+4. 发布 AVIF 输出：
+
+   ```bash
+   pix publish -s ~/Pictures-avif -d r2:images \
+     --base-url https://img.example.com --urls > urls.json
+   ```
+
+   `publish` 要求源目录至少有一个 `.avif`，并固定排除 `.pix/**`。URL 清单只在同步成功且不是 `--dry-run` 时输出到 stdout。
+
+5. 之后重复运行：
+
+   ```bash
+   pix shrink -s ~/Pictures -d ~/Pictures-avif
+   pix backup -s ~/Pictures -d onedrive:photos
+   pix publish -s ~/Pictures-avif -d r2:images --urls
+   ```
+
+   只处理变化的部分。
+
+## 常用命令
+
+| 场景 | 命令 |
+|---|---|
+| 预览压缩 | `pix shrink -s SRC -d OUT --dry-run` |
+| 强制全部重压 | `pix shrink -s SRC -d OUT --force` |
+| 删除源已消失的输出 | `pix shrink -s SRC -d OUT --prune` |
+| 预览同步 | `pix backup -s SRC -d REMOTE --dry-run` |
+| 首次运行或修改排除项后 | `pix backup -s SRC -d REMOTE --resync` |
+| 输出 URL 清单 | `pix publish -s OUT -d REMOTE --base-url https://img.example.com --urls` |
+| 诊断环境 | `pix doctor` |
+| 生成配置文件 | `pix config init` |
+
+## 安全边界
+
+| 情况 | 会发生什么 | 如何防护 |
+|---|---|---|
+| 任意一侧删除文件 | 删除双向传播，误删不可逆 | 先 `--dry-run`；默认 `--max-delete 10`（百分比） |
+| 首次同步 | rclone 没有基线，直接报错 | 显式加 `--resync` |
+| 修改排除项 | 旧基线可能把被排除的文件当成删除传播 | 修改后必须重新 `--resync` |
+| 源目录为空 | `backup` / `publish` 默认拒绝；`shrink --prune` 同样拒绝 | 仅在确认要清空时用 `--allow-empty`（同步还需 `--resync`） |
+| `a.jpg` 与 `a.jpeg` 同时存在 | 映射到同一输出 | 编码前检测并以 2 退出 |
+| 同时运行两个 shrink | 会写同一份状态和输出 | `OUT/.pix/lock` 阻止第二个进程 |
+| 状态文件丢失或损坏 | 告警后全量重建 | 只会重新编码，不会产生错误结果 |
+
+## 输出与退出码
+
+- 日志和进度输出到 stderr。
+- stdout 用于 `doctor` 报告、`--dry-run` 计划和 `--urls` JSON。
+- 退出码：`0` 成功，`1` 运行失败，`2` 参数或配置错误。
+- `backup` / `publish` 原样返回 rclone 的退出码。
+
+URL 清单示例：
+
+```json
+{
+  "2024/a.avif": "https://img.example.com/2024/a.avif"
+}
+```
+
+## 故障排查
+
+| 现象 | 处理 |
+|---|---|
+| 提示 `pyvips/libvips unavailable` | 重装以带入 libvips：`uv tool install --force --editable /path/to/pix`；或手动安装 libvips（Linux：`apt install libvips42`；Windows：下载 libvips release 压缩包并把 `bin` 加入 PATH） |
+| rclone 版本低于 1.66 | 升级 rclone |
+| bisync 报缺少基线 | 首次运行加 `--resync` |
+| `OUT/.pix/lock` 已存在 | 确认没有其他 `shrink` 在运行，再删除陈旧锁 |
+| 配置解析失败 | 运行 `pix doctor` 定位文件；修复 TOML，或删除配置改用默认值 |
+| `publish` 提示源目录没有 `.avif` | 先运行 `pix shrink` |
+| URL 相关报错 | `base_url` 必须以 `http://` 或 `https://` 开头，且 `--urls` 依赖它 |
+
+## 开发
+
+```bash
+uv sync
+uv run pytest
+uv run pix --version
+uv build
+```
+
+代码必须兼容 Python 3.11。测试、打包与发布细节见[开发指南](https://github.com/uzvg/pix/blob/main/docs/development.md)。行为规格见[architecture.md](https://github.com/uzvg/pix/blob/main/docs/architecture.md)，选型原因见[decisions.md](https://github.com/uzvg/pix/blob/main/docs/decisions.md)。

{pix_cli-0.1.0 → pix_cli-0.1.2}/docs/architecture.md

@@ -51,8 +51,8 @@ src/pix/
 ├── __init__.py     # 包版本
 ├── py.typed
 ├── cli.py          # 组合根：parser、main、子命令分派
-├── config.py       # 默认值、TOML 读取与校验、parse_size、config init
-├── default_config.toml  # config init 写入的模板（随包分发）
+├── config.py       # TOML 读取与校验、parse_size、config init
+├── default_config.toml  # 默认值唯一来源，也是 config init 的模板（随包分发）
 ├── logger.py       # stderr 日志
 ├── shrink.py       # shrink 子命令
 ├── rclone.py       # rclone 探测、版本检查与执行
@@ -150,7 +150,7 @@ pix config init [--force]
 - Linux/macOS：`$XDG_CONFIG_HOME/pix/config.toml`，未设置时为 `~/.config/pix/config.toml`。
 - Windows：`%APPDATA%\pix\config.toml`。
 
-文件不存在时使用内置默认值。
+文件不存在时使用内置默认值（即 `src/pix/default_config.toml`）。
 
 ```toml
 [shrink]
@@ -230,6 +230,7 @@ binary = "rclone"
 13. 汇总输出：转换、跳过（状态命中）、跳过（太小）、跳过（空源保护）、失败、删除。
 14. 状态在编码过程中每成功 200 个文件刷新一次（原子写），并在正常结束或 `KeyboardInterrupt` 时通过 `finally` 再写一次，避免 Ctrl-C 丢掉整批进度。写入失败记录错误并返回 1，下次运行会重新编码未记录的文件。
 15. 状态损坏、版本不识别或 JSON 解析失败时输出警告，按空状态全量重建，不中止。
+16. 编码每个文件前在 stderr 输出进度 `processing <序号>/<总数>: <相对路径>`；终端下原地刷新，重定向时逐行输出，`--quiet` 抑制。日志与汇总会先结束进度行。
 
 ### 状态文件
 
@@ -343,7 +344,7 @@ config /home/uzvg/.config/pix/config.toml (ok)
 
 ## 9. 日志与退出码
 
-- 默认：阶段信息和汇总，输出到 stderr。
+- 默认：阶段信息、编码进度和汇总，输出到 stderr。终端下进度原地刷新，重定向时逐行输出。
 - `-v`：输出每个文件的处理/跳过原因，以及 rclone 的进度。
 - `--quiet`：只输出错误。
 - `doctor` 报告输出到 stdout；`--dry-run` 的计划文件列表和 `--urls` 的 JSON 输出到 stdout。

{pix_cli-0.1.0 → pix_cli-0.1.2}/docs/decisions.md

@@ -172,6 +172,6 @@
 
 ## D28. 默认配置用内置模板生成
 
-**决策**：`pix config init` 写出随包分发的 `src/pix/default_config.toml`，而不是把 `DEFAULTS` 序列化成 TOML。目标文件已存在时拒绝覆盖并退出 2，`--force` 才覆盖；该命令在 `load_settings` 之前分派。
+**决策**：随包分发的 `src/pix/default_config.toml` 是默认值的唯一来源：`load_settings` 通过 `load_defaults()` 解析它，`pix config init` 直接复制它（保留注释）。目标文件已存在时拒绝覆盖并退出 2，`--force` 才覆盖；该命令在 `load_settings` 之前分派。
 
-**原因**：Python 3.11 标准库只有 `tomllib`，没有 TOML 写入器；引入 `tomli-w` 违反“仅标准库 + pyvips”的约束。独立文件可以直接带注释，用户打开就能改，编辑器也能按 TOML 高亮；测试把模板解析后与 `DEFAULTS` 比对，防止两者漂移。拒绝覆盖保护用户已经修改过的配置，误覆盖的代价远高于多敲一个 `--force`。提前分派让 `--config` 指向新路径时也能创建工作，而不是被“config file not found”挡住。
+**原因**：Python 3.11 标准库只有 `tomllib`，没有 TOML 写入器；引入 `tomli-w` 违反“仅标准库 + pyvips”的约束。独立文件可以直接带注释，用户打开就能改，编辑器也能按 TOML 高亮；默认值只在这一处维护，避免代码常量与模板漂移。拒绝覆盖保护用户已经修改过的配置，误覆盖的代价远高于多敲一个 `--force`。提前分派让 `--config` 指向新路径时也能创建工作，而不是被“config file not found”挡住。

pix_cli-0.1.2/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "pix-cli"
+version = "0.1.2"
+description = "Batch AVIF shrink and image-host sync CLI"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "uzvg", email = "uzvg@qq.com" }
+]
+keywords = [
+    "avif",
+    "image-compression",
+    "image-host",
+    "rclone",
+    "cli",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Graphics :: Graphics Conversion",
+    "Topic :: System :: Archiving :: Backup",
+]
+requires-python = ">=3.11"
+dependencies = [
+    "pyvips[binary]>=3.2",
+]
+
+[project.scripts]
+pix = "pix.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/uzvg/pix"
+Repository = "https://github.com/uzvg/pix"
+Issues = "https://github.com/uzvg/pix/issues"
+Changelog = "https://github.com/uzvg/pix/releases"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pix"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

{pix_cli-0.1.0 → pix_cli-0.1.2}/src/pix/config.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import argparse
-import copy
 import os
 import re
 import sys
@@ -11,29 +10,6 @@ import tomllib
 from pathlib import Path
 from typing import Any
 
-DEFAULTS: dict[str, Any] = {
-    "shrink": {
-        "width": 1920,
-        "quality": 85,
-        "effort": 5,
-        "min_size": 0,
-        "include": ["jpg", "jpeg", "png", "webp"],
-    },
-    "backup": {
-        "exclude": [],
-        "max_delete": 10,
-    },
-    "publish": {
-        "base_url": "",
-        "urls": False,
-        "exclude": [],
-        "max_delete": 10,
-    },
-    "rclone": {
-        "binary": "rclone",
-    },
-}
-
 _SIZE_RE = re.compile(r"^(\d+)([KMG]?)$", re.IGNORECASE)
 _SIZE_UNITS = {"": 1, "K": 1024, "M": 1024**2, "G": 1024**3}
 
@@ -42,6 +18,18 @@ class ConfigError(Exception):
     """Invalid or unreadable configuration."""
 
 
+def load_defaults() -> dict[str, Any]:
+    """Read the packaged template, the single source of default values."""
+    path = Path(__file__).with_name("default_config.toml")
+    try:
+        with path.open("rb") as handle:
+            return tomllib.load(handle)
+    except OSError as exc:
+        raise ConfigError(f"{path}: {exc}") from exc
+    except tomllib.TOMLDecodeError as exc:
+        raise ConfigError(f"{path}: {exc}") from exc
+
+
 def parse_size(value: str | int) -> int:
     if isinstance(value, int) and not isinstance(value, bool):
         if value < 0:
@@ -97,7 +85,7 @@ def load_settings(explicit: Path | None = None) -> dict[str, Any]:
     if explicit is not None and not path.is_file():
         raise ConfigError(f"config file not found: {path}")
     overrides = load_config(path)
-    settings = copy.deepcopy(DEFAULTS)
+    settings = load_defaults()
     _deep_update(settings, overrides)
     validate_settings(settings)
     return settings

{pix_cli-0.1.0 → pix_cli-0.1.2}/src/pix/logger.py

@@ -9,18 +9,37 @@ class Logger:
     def __init__(self, verbose: bool = False, quiet: bool = False) -> None:
         self.verbose = verbose
         self.quiet = quiet
+        self._progress_active = False
+
+    def _end_progress(self) -> None:
+        if self._progress_active:
+            print(file=sys.stderr)
+            self._progress_active = False
 
     def info(self, message: str) -> None:
         if not self.quiet:
+            self._end_progress()
             print(message, file=sys.stderr)
 
     def detail(self, message: str) -> None:
         if self.verbose and not self.quiet:
+            self._end_progress()
             print(message, file=sys.stderr)
 
     def warning(self, message: str) -> None:
         if not self.quiet:
+            self._end_progress()
             print(f"pix: warning: {message}", file=sys.stderr)
 
     def error(self, message: str) -> None:
+        self._end_progress()
         print(f"pix: error: {message}", file=sys.stderr)
+
+    def progress(self, message: str) -> None:
+        if self.quiet:
+            return
+        if sys.stderr.isatty():
+            print(f"\r{message}\033[K", end="", file=sys.stderr, flush=True)
+            self._progress_active = True
+        else:
+            print(message, file=sys.stderr)

{pix_cli-0.1.0 → pix_cli-0.1.2}/src/pix/shrink.py

@@ -258,9 +258,10 @@ def shrink(args: argparse.Namespace, settings: dict[str, Any], log: Logger) -> i
     status = 0
     pyvips = None
     encoded: set[str] = set()
+    total = len(sources)
 
     try:
-        for src in sources:
+        for index, src in enumerate(sources, 1):
             rel = src.relative_to(source).as_posix()
             try:
                 src_stat = src.stat()
@@ -287,6 +288,8 @@ def shrink(args: argparse.Namespace, settings: dict[str, Any], log: Logger) -> i
                 counters["converted"] += 1
                 continue
 
+            log.progress(f"processing {index}/{total}: {rel}")
+
             if pyvips is None:
                 try:
                     import pyvips as pyvips_module

{pix_cli-0.1.0 → pix_cli-0.1.2}/tests/test_cli.py

@@ -1,3 +1,4 @@
+import io
 import json
 import os
 import tomllib
@@ -7,6 +8,7 @@ import pytest
 
 from pix import cli, doctor, rclone
 from pix import config as pix_config
+from pix.logger import Logger
 
 
 def test_parse_size():
@@ -20,6 +22,22 @@ def test_parse_size():
             pix_config.parse_size(bad)
 
 
+def test_logger_progress_rewrites_on_tty(monkeypatch):
+    class FakeStderr(io.StringIO):
+        def isatty(self):
+            return True
+
+    stream = FakeStderr()
+    monkeypatch.setattr("pix.logger.sys.stderr", stream)
+
+    log = Logger()
+    log.progress("first")
+    log.progress("second")
+    log.info("done")
+
+    assert stream.getvalue() == "\rfirst\033[K\rsecond\033[K\ndone\n"
+
+
 def test_version_exits_zero(capsys):
     assert cli.main(["--version"]) == 0
     assert capsys.readouterr().out.strip() == f"pix {cli.__version__}"
@@ -38,7 +56,7 @@ def test_config_priority_and_defaults(tmp_path: Path):
 
     assert settings["shrink"]["width"] == 1000
     assert settings["shrink"]["quality"] == 70
-    assert settings["shrink"]["effort"] == pix_config.DEFAULTS["shrink"]["effort"]
+    assert settings["shrink"]["effort"] == pix_config.load_defaults()["shrink"]["effort"]
     assert settings["publish"]["max_delete"] == 10
 
 
@@ -74,7 +92,7 @@ def test_config_init_writes_defaults(tmp_path: Path, capsys):
     assert cli.main(["--config", str(config), "config", "init"]) == 0
 
     assert capsys.readouterr().out.strip() == f"wrote {config}"
-    assert tomllib.loads(config.read_text(encoding="utf-8")) == pix_config.DEFAULTS
+    assert tomllib.loads(config.read_text(encoding="utf-8")) == pix_config.load_defaults()
     assert pix_config.load_settings(config)["shrink"]["width"] == 1920
 
 
@@ -94,7 +112,7 @@ def test_config_init_force_overwrites(tmp_path: Path, capsys):
 
     assert cli.main(["--config", str(config), "config", "init", "--force"]) == 0
 
-    assert tomllib.loads(config.read_text(encoding="utf-8")) == pix_config.DEFAULTS
+    assert tomllib.loads(config.read_text(encoding="utf-8")) == pix_config.load_defaults()
     assert capsys.readouterr().out.strip() == f"wrote {config}"
 
 
@@ -142,6 +160,16 @@ def test_shrink_encodes_and_writes_state(tmp_path: Path):
     assert entry["out_size"] == output.stat().st_size
 
 
+def test_shrink_reports_progress(tmp_path: Path, capsys):
+    source = tmp_path / "src"
+    dest = tmp_path / "out"
+    make_png(source / "a.png")
+
+    assert run_shrink(source, dest, "-w", "100") == 0
+
+    assert "processing 1/1: a.png" in capsys.readouterr().err
+
+
 def test_shrink_second_run_skips_unchanged(tmp_path: Path, capsys):
     source = tmp_path / "src"
     dest = tmp_path / "out"

{pix_cli-0.1.0 → pix_cli-0.1.2}/uv.lock

@@ -129,7 +129,7 @@ wheels = [
 
 [[package]]
 name = "pix-cli"
-version = "0.1.0"
+version = "0.1.1"
 source = { editable = "." }
 dependencies = [
     { name = "pyvips", extra = ["binary"] },

pix_cli-0.1.0/PKG-INFO

@@ -1,40 +0,0 @@
-Metadata-Version: 2.5
-Name: pix-cli
-Version: 0.1.0
-Summary: Batch AVIF shrink and image-host sync CLI
-Author-email: uzvg <uzvg@qq.com>
-Requires-Python: >=3.11
-Requires-Dist: pyvips[binary]>=3.2
-Description-Content-Type: text/markdown
-
-# pix
-
-Batch AVIF shrink and image-host sync CLI.
-
-`pix` 把本地图片目录增量压缩为 AVIF，再通过 rclone bisync 备份原图、发布压缩图到图床。只处理显式传入的路径和远端。
-
-```bash
-pix shrink  -s ./photos -d ./out -w 1920 -q 85
-pix backup  -s ./photos -d onedrive:photos --resync
-pix publish -s ./out -d r2:images --base-url https://img.example.com --urls
-pix doctor
-pix config init
-```
-
-`backup` / `publish` 是双向镜像，不是单向备份：删除会双向传播。默认 `--max-delete 10`（删除百分比，即 10%），超过该比例时 rclone 会拒绝；首次运行或修改排除项后必须显式 `--resync`，先跑 `--dry-run` 更安全。
-
-> Status: implementation complete; real R2 and Windows smoke tests pending (see roadmap).
-
-## Docs
-
-- [Architecture](docs/architecture.md) — behavior spec
-- [Development](docs/development.md) — setup, tests, build
-- [Decisions](docs/decisions.md) — technical decisions and rationale
-- [Roadmap](docs/roadmap.md) — status and tasks
-
-## Quick start
-
-```bash
-uv sync
-uv run pytest
-```

pix_cli-0.1.0/README.md

@@ -1,31 +0,0 @@
-# pix
-
-Batch AVIF shrink and image-host sync CLI.
-
-`pix` 把本地图片目录增量压缩为 AVIF，再通过 rclone bisync 备份原图、发布压缩图到图床。只处理显式传入的路径和远端。
-
-```bash
-pix shrink  -s ./photos -d ./out -w 1920 -q 85
-pix backup  -s ./photos -d onedrive:photos --resync
-pix publish -s ./out -d r2:images --base-url https://img.example.com --urls
-pix doctor
-pix config init
-```
-
-`backup` / `publish` 是双向镜像，不是单向备份：删除会双向传播。默认 `--max-delete 10`（删除百分比，即 10%），超过该比例时 rclone 会拒绝；首次运行或修改排除项后必须显式 `--resync`，先跑 `--dry-run` 更安全。
-
-> Status: implementation complete; real R2 and Windows smoke tests pending (see roadmap).
-
-## Docs
-
-- [Architecture](docs/architecture.md) — behavior spec
-- [Development](docs/development.md) — setup, tests, build
-- [Decisions](docs/decisions.md) — technical decisions and rationale
-- [Roadmap](docs/roadmap.md) — status and tasks
-
-## Quick start
-
-```bash
-uv sync
-uv run pytest
-```

pix_cli-0.1.0/pyproject.toml

@@ -1,30 +0,0 @@
-[project]
-name = "pix-cli"
-version = "0.1.0"
-description = "Batch AVIF shrink and image-host sync CLI"
-readme = "README.md"
-authors = [
-    { name = "uzvg", email = "uzvg@qq.com" }
-]
-requires-python = ">=3.11"
-dependencies = [
-    "pyvips[binary]>=3.2",
-]
-
-[project.scripts]
-pix = "pix.cli:main"
-
-[dependency-groups]
-dev = [
-    "pytest>=8",
-]
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/pix"]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]