feat: add LAN web sharing

Author: zengyufei

Cargo.lock

@@ -4,7 +4,7 @@ exclude = ["vendor/iroh", "vendor/suppaftp"]
 resolver = "3"
 
 [workspace.package]
-version = "0.1.16"
+version = "0.1.17"
 edition = "2024"
 rust-version = "1.91"
 license = "MIT"
@@ -35,6 +35,7 @@ md5 = { package = "md-5", version = "0.10" }
 percent-encoding = "2"
 postcard = { version = "1", features = ["use-std"] }
 quick-xml = "0.41"
+qrcodegen = "1.8.0"
 rustls = { version = "0.23.33", default-features = false, features = ["ring"] }
 reqwest = { version = "0.13", default-features = false, features = ["rustls-no-provider", "stream"] }
 digest_auth = "0.3"

Cargo.toml

@@ -23,6 +23,7 @@
 
 - The sender serves one successful receive by default, then exits
 - It briefly probes for a usable path through complex networks, with S3, WebDAV, FTP, and SFTP backend options
+- `ii send <file-or-folder> --web` opens a temporary LAN download page
 - Receives resume automatically by default
 - Existing files with the same MD5 are skipped
 - Folders can be sent directly
@@ -124,6 +125,15 @@ Receive to stdout:
 ii recv ii1k7v...x9a --stdout > project.tar.gz
 ```
 
+Open a temporary LAN download page:
+
+```powershell
+ii send .\video.mp4 --web
+ii send .\my-folder --web
+```
+
+The command displays a QR code directly above the primary LAN URL for opening the download page, then lists the remaining physical and virtual adapter IPv4 URLs under `other:`. The QR code at the top of that page points directly to `/download` for phone downloads. Folders download as `.tar` archives. Press `Ctrl+C` to stop the server. This mode has no authentication and is intended only for short-lived, trusted LAN sharing.
+
 Prefer local network paths and avoid public relays:
 
 ```powershell

README.en.md

@@ -25,6 +25,8 @@
 
 自动找路 / 局域网优先 / 可公网中继或 `--s3` / `--webdav` / `--ftp` / `--sftp` 中继
 
+也可用 `ii send <文件或文件夹> --web` 临时开一个局域网下载页
+
 断点续收 / 秒传跳过 / 冲突覆盖 / 支持传完清理中转
 
 进度速率 / 完成耗时 / 支持诊断本机 / 支持自建中继
@@ -126,6 +128,15 @@ tar czf - .\project | ii send --name project.tar.gz
 ii recv ii1k7v...x9a --stdout > project.tar.gz
 ```
 
+临时开局域网下载页：
+
+```powershell
+ii send .\video.mp4 --web
+ii send .\my-folder --web
+```
+
+命令行会在主局域网 URL 上方显示进入下载页的二维码，并在 `other:` 下列出其余物理和虚拟网卡的 IPv4 URL；下载页顶部的二维码则直达 `/download`，方便手机扫码下载。目录会下载为 `.tar`。按 `Ctrl+C` 关闭服务。该模式没有鉴权，只适合临时、可信的局域网。
+
 局域网优先，不走公网中继：
 
 ```powershell

README.md

@@ -1,8 +1,7 @@
 # Binary Size Ledger
 
 The release artifact is the UPX-compressed CLI executable. The release workflow
-verifies the packed artifact and enforces a `1,048,576` byte limit on Windows,
-Linux, and macOS.
+verifies the packed artifact and reports its size on Windows, Linux, and macOS.
 
 ## Windows x86_64
 
@@ -24,9 +23,19 @@ All measurements use `cargo build -p ii --release --locked` followed by UPX
 | Rejected: relay rate-limit feature split | 5,952,000 | 2,154,496 | +1,536 | Full `ii` regression suite (66 tests), full relay-library feature compile, `upx -t`; reverted because packed size grew |
 | Final release reproduction | 5,956,096 | 2,153,472 | -512 | `cargo test -p ii --locked` (66 tests), `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
 | Single-thread Tokio runtime | 5,946,368 | 2,148,864 | -4,608 | `cargo test -p ii --locked` (66 tests), `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
+| LAN web-share QR SVG and terminal QR | 5,970,944 | 2,161,152 | +12,288 | `cargo test -p ii --locked` (76 tests), `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
+| Web download QR and responsive share page | 5,975,040 | 2,159,616 | -1,536 | `cargo test -p ii --locked` (76 tests), `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
+| Web-share other IPv4 URL list | 5,979,648 | 2,160,640 | +1,024 | `cargo test -p ii --locked` (77 tests), isolated `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
 
-The current artifact remains `1,100,288` bytes above the `1 MiB` budget. Equivalent
-release rebuilds have varied by up to `1,536` UPX bytes; the latest measurement is
-recorded with the pinned `5.1.0` packer. No
-release is considered size-compliant until every target satisfies the workflow
-budget check.
+Equivalent release rebuilds have varied by up to `1,536` UPX bytes; the latest
+measurement is recorded with the pinned `5.1.0` packer.
+
+## QR Dependency Audit
+
+`D:\cache\n0-scan` contains `--depth 1` clones of all 120 public
+`n0-computer` repositories. `squiggle` is an empty GitHub repository; all 119
+non-empty repositories were scanned with `git grep` for QR-code dependencies and
+source usage. The only direct generator found was `iroh-live`'s `qrcode 0.14.1`,
+which depends on `image`. `ii` uses `qrcodegen 1.8.0` instead: it only supplies
+the QR matrix, while `ii` emits its own inline SVG with no image or front-end
+dependency chain.

SIZE.md

@@ -9,7 +9,7 @@
 ## 命令总览
 
 ```text
-ii send [<path>] [--name <name>] [-t] [-c] [-o <path>] [--s3 | --webdav | --ftp | --sftp] [--profile <name>] [-d] [-p] [--local] [--relay <https-url> [-k]] [--no-relay]
+ii send [<path>] [--name <name>] [-t] [-c] [-o <path>] [--web | --s3 | --webdav | --ftp | --sftp] [--profile <name>] [-d] [-p] [--local] [--relay <https-url> [-k]] [--no-relay]
 ii recv <ticket> [-o <dir>] [--stdout] [--overwrite] [--resume] [--local] [--trace]
 ii relay (--public <https-url> | --tls <domain> --cert <path> --key <path>) [-H <bind-port>]
 ii doctor
@@ -74,9 +74,12 @@ tar czf - .\project | ii send --name project.tar.gz
   Windows 使用 `clip.exe`，macOS 使用 `pbcopy`，Linux 会依次尝试 `wl-copy`、`xclip`、`xsel`。
 
 `-o <path>`
-: 把完整的 `ii recv ...` 命令写到指定文件路径。  
+: 把完整的 `ii recv ...` 命令写到指定文件路径。
   如果文件已存在，会覆盖。这个 `-o` 属于 `ii send`，不影响 `ii recv -o <dir>` 的保存目录语义。
 
+`--web`
+: 在局域网内临时开放一个无鉴权 HTTP 下载页。执行后会在主 URL 上方展示进入下载页的二维码，随后在 `other:` 下列出其余物理和虚拟网卡的 IPv4 URL；下载页顶部二维码直达 `/download`。按 `Ctrl+C` 停止服务。文件直接下载；文件夹会按原目录名打包为 `.tar` 下载。它不生成 ticket，不能和 `-c`、`-o`、`--s3`、`--webdav`、`--ftp`、`--sftp`、`--local`、`--relay`、`--no-relay` 同时使用。
+
 `--local`
 : 只走局域网优先路径，不走公网发现，不走公网 relay。
 
@@ -122,7 +125,7 @@ tar czf - .\project | ii send --name project.tar.gz
 
 ### 路径规则
 
-- `--s3`、`--webdav`、`--ftp`、`--sftp`、`--local`、`--relay`、`--no-relay` 互斥。
+- `--web`、`--s3`、`--webdav`、`--ftp`、`--sftp`、`--local`、`--relay`、`--no-relay` 互斥。
 - 默认不需要用户选 relay。
 - 如果没有局域网或直连可用，默认会自动退到公网 relay。
 - 指定 `--relay https://...` 后，当前发送会强制走 HTTPS relay-only，不使用默认公网 relay。

ii.md

@@ -29,6 +29,7 @@ pub struct SendArgs {
     pub profile: Option<String>,
     pub webdav: bool,
     pub sftp: bool,
+    pub web: bool,
     pub portable_webdav: bool,
     pub local: bool,
     pub relay: Option<iroh::RelayUrl>,
@@ -170,6 +171,7 @@ fn parse_send(args: Vec<String>) -> Result<SendArgs, ParseAction> {
                 "--profile" => out.profile = Some(iter.value("--profile")?),
                 "--webdav" => out.webdav = true,
                 "--sftp" => out.sftp = true,
+                "--web" => out.web = true,
                 "-p" => out.portable_webdav = true,
                 "--local" => out.local = true,
                 "--relay" => out.relay = Some(parse_relay_url(&iter.value("--relay")?)?),
@@ -315,6 +317,7 @@ fn validate_send(args: &SendArgs) -> Result<(), ParseAction> {
         args.ftp,
         args.webdav,
         args.sftp,
+        args.web,
         args.local,
         args.relay.is_some(),
         args.no_relay,
@@ -325,7 +328,7 @@ fn validate_send(args: &SendArgs) -> Result<(), ParseAction> {
 
     if backend_count > 1 {
         return Err(ParseAction::error(
-            "--s3, --webdav, --ftp, --sftp, --local, --relay and --no-relay conflict with each other",
+            "--s3, --webdav, --ftp, --sftp, --web, --local, --relay and --no-relay conflict with each other",
         ));
     }
 
@@ -335,6 +338,12 @@ fn validate_send(args: &SendArgs) -> Result<(), ParseAction> {
     if args.accept_self_signed_relay && args.relay.is_none() {
         return Err(ParseAction::error("-k requires --relay <https-url>"));
     }
+    if args.web && args.path.is_none() {
+        return Err(ParseAction::error("--web requires a file or folder path"));
+    }
+    if args.web && (args.copy || args.output.is_some()) {
+        return Err(ParseAction::error("--web cannot be used with -c or -o"));
+    }
 
     Ok(())
 }
@@ -463,6 +472,7 @@ Options:
   --webdav
   --ftp
   --sftp
+  --web
   -p
   -d
   --profile <name>
@@ -570,6 +580,30 @@ mod tests {
         }
     }
 
+    #[test]
+    fn send_accepts_web_for_a_file_or_folder() {
+        let cli = Cli::parse_from(["ii", "send", "photos", "--web"]);
+        match cli.command {
+            Command::Send(args) => {
+                assert!(args.web);
+                assert_eq!(args.path, Some(PathBuf::from("photos")));
+            }
+            _ => panic!("expected send command"),
+        }
+    }
+
+    #[test]
+    fn send_rejects_web_without_a_path_or_with_another_mode() {
+        assert!(matches!(
+            parse_args(["ii", "send", "--web"]),
+            Err(ParseAction::Print { code: 2, .. })
+        ));
+        assert!(matches!(
+            parse_args(["ii", "send", "file.txt", "--web", "--local"]),
+            Err(ParseAction::Print { code: 2, .. })
+        ));
+    }
+
     #[test]
     fn send_accepts_ftp_and_sftp_storage_options() {
         let ftp = Cli::parse_from(["ii", "send", "--ftp", "-p", "-d", "file.txt"]);