quickwin 2.0.0 → 2.1.1

package/README.en.md

@@ -41,7 +41,7 @@ quickwin script.js                  # run a script
 quickwin -o CON script.js           # run with console (AllocConsole)
 quickwin -o LOG script.js           # run with auto-generated log file
 quickwin -e "console.log('hi')"     # execute expression
-quickwin -- script.js --flag        # -- stops option parsing
+quickwin script.js --flag           # everything after the script goes to it
 ```
 
 ### Options
@@ -53,10 +53,10 @@ quickwin -- script.js --flag        # -- stops option parsing
 | `-o LOG` | Redirect stdout+stderr to `log_YYYY_MM_DD_HH_MM_SS.txt` (exe directory) |
 | `-o <file>` | Redirect stdout+stderr to specified file |
 | `-d` | Enable HTTP debug logging |
-| `--` | Stop option parsing, remaining args passed to script |
 
-All unknown flags are transparently forwarded to `scriptArgs` — no error,
-no consumption. Script file is the first non-flag argument after option parsing.
+The command line parses in fixed slots: `exe [-d] [-o target] [-e code | file]`;
+everything past the slots reaches `scriptArgs` untouched — no error, no
+consumption. The file slot rejects `-`-leading names (run those as `./-name.js`).
 
 ## Embedded Script
 
@@ -168,8 +168,7 @@ Both sides must set `onmessage = null` when communication is complete. This rele
 
 ### Prerequisites
 
-- MSYS2 UCRT64 or MINGW64
-- Node.js (for TypeScript compilation via tsc)
+- **podman** (dev container; build/test/QEMU verification all run inside the container, consistent with CI)
 - Git (for submodules)
 
 ### Build
@@ -178,38 +177,34 @@ Both sides must set `onmessage = null` when communication is complete. This rele
 git clone --recursive https://github.com/xna00/quickwin.git
 cd quickwin
 
-.\run.ps1 "make wamr"       # build WAMR library (first time only)
-.\run.ps1 "make small"      # build qwin.exe (-Os + LTO, ~1.5MB)
-.\run.ps1 "make js"         # compile TypeScript
-.\run.ps1 "make test"       # run all tests
+./docker/dev-podman.sh up      # start dev container (reuses ghcr.io/xna00/quickwin-dev)
+podman exec quickwin-dev bash -lc 'cd /workspace && make js && make cc64 && make test TEST=-net'
 ```
 
-`make nowasm` produces a smaller `_build/qwin-nowasm.exe` without WASM/WAMR
-(no `WebAssembly` global); run `make test TEST=-wasm` to skip WASM tests on it.
+`make cc64` produces `_build/qwin.exe`. `cc64-nowasm` produces a smaller
+`_build/qwin-nowasm.exe` without WASM/WAMR (no `WebAssembly` global); for
+that build run `make test TEST=-wasm` to skip WASM tests.
 
 ### Build Targets
 
 | Target | Description |
 |--------|-------------|
-| `make` / `make nodebug` | fast build |
-| `make small` | `-Os` + LTO + strip, ~1.5MB (recommended) |
-| `make minimal` | `small` + UPX compression |
-| `make release` | `-O2` + LTO + strip (not `-Os` optimized) |
-| `make debug` | debug build with bridge logs |
-| `make nowasm` | no WASM/WAMR build → `_build/qwin-nowasm.exe` (~1.2MB, no `WebAssembly` global) |
-| `make cc64-small` | cross-compile x86_64 `_build/qwin.exe` (`-Os`, used by CI) |
-| `make cc32-small` | cross-compile i686 `_build/qwin-x86.exe` (`-Os`, XP-compatible, used by CI) |
+| `make cc64` | cross-compile x86_64 → `_build/qwin.exe` (default target, `BUILD=fast`) |
+| `make cc32` | cross-compile i686/XP → `_build/qwin-x86.exe` |
+| `make cc64-nowasm` / `cc32-nowasm` | no WASM/WAMR builds |
+| `BUILD=fast\|small\|debug` | build flavor: `make cc64 BUILD=small` = `-Os`+LTO (~1.5MB, used by CI) |
 | `make js` | compile TypeScript via tsc |
-| `make wasm` | compile WAT → WASM fixtures |
+| `make wasm` | compile `test/*.wat` → WASM fixtures |
 | `make test` | run all tests |
 | `make test TEST=-net` | skip network tests (fast) |
 | `make test TEST=wasm` | run WASM tests only |
-| `make wamr` | rebuild WAMR library |
-| `make embed-js` | embed `embed.js` into exe (use `JS_EMBED=file.js`) |
-| `make embed-js-br` | embed brotli-compressed JS into exe |
-| `make exec_server` | Bundle `examples/exec_server.ts` and brotli-embed into `_build/exec_server.exe` |
+| `make exec_server` | bundle `examples/exec_server.ts` and brotli-embed into `_build/exec_server.exe` |
+| `make embed-js` / `embed-js-br` | embed JS (brotli-compressed) into exe |
 | `make npm-pkg` | package into `dist/quickwin/` |
-| `make clean` | clean build artifacts |
+| `make gen-const` | regenerate `quickwin_const.d.ts` |
+| `make clean` / `distclean` | clean (wipes all of `_build/`; afterwards run `make js wasm`) |
+
+Build and troubleshooting details: `.agents/DEVELOPMENT_WORKFLOW.md`.
 
 ## License
 

package/README.md

@@ -41,7 +41,7 @@ quickwin script.js                  # 运行脚本
 quickwin -o CON script.js           # 带控制台运行（AllocConsole）
 quickwin -o LOG script.js           # 自动生成日志文件运行
 quickwin -e "console.log('hi')"     # 执行表达式
-quickwin -- script.js --flag        # -- 停止选项解析
+quickwin script.js --flag           # 槽位之后的参数全部传给脚本
 ```
 
 ### 选项
@@ -53,9 +53,8 @@ quickwin -- script.js --flag        # -- 停止选项解析
 | `-o LOG` | 将 stdout+stderr 重定向到 `log_YYYY_MM_DD_HH_MM_SS.txt`（exe 所在目录） |
 | `-o <file>` | 将 stdout+stderr 重定向到指定文件 |
 | `-d` | 开启 HTTP 调试日志 |
-| `--` | 停止选项解析，其余参数传给脚本 |
 
-所有未知参数都会透明转发给 `scriptArgs` —— 不报错、不消费。选项解析后的第一个非参数即脚本文件。
+命令行按固定槽位解析：`exe [-d] [-o 目标] [-e code | 脚本文件]`；槽位之后的所有参数原样进入 `scriptArgs`，不报错、不消费。文件槽不接受 `-` 开头的文件名（用 `./-name.js` 运行这类脚本）。
 
 ## 内嵌脚本
 
@@ -170,8 +169,6 @@ parent.onmessage = (e) => {
 - **podman**（开发容器；构建/测试/QEMU 验证都在容器内完成，与 CI 一致）
 - Git（用于子模块）
 
-> 也支持 MSYS2 原生直接 `make`，详见 `.agents/DEVELOPMENT_WORKFLOW.md`。
-
 ### 构建
 
 ```bash
@@ -195,7 +192,7 @@ podman exec quickwin-dev bash -lc 'cd /workspace && make js && make cc64 && make
 | `make cc64-nowasm` / `cc32-nowasm` | 无 WASM/WAMR 版 |
 | `BUILD=fast\|small\|debug` | 构建 flavor：`make cc64 BUILD=small` = `-Os`+LTO（约 1.5MB，CI 用） |
 | `make js` | 通过 tsc 编译 TypeScript |
-| `make wasm` / `make wat` | 编译 WAT → WASM fixtures |
+| `make wasm` | 编译 `test/*.wat` → WASM fixtures |
 | `make test` | 运行全部测试 |
 | `make test TEST=-net` | 跳过网络测试（快速） |
 | `make test TEST=wasm` | 仅运行 WASM 测试 |