quickwin 2.1.0 → 2.2.0

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
 
@@ -80,11 +80,11 @@ make embed-js JS_EMBED=script.js
 # Embed a script brotli-compressed (smaller exe, decompressed at runtime)
 make embed-js-br JS_EMBED=script.js
 
-# Bundle examples/exec_server.ts and brotli-embed into exec_server.exe
-make exec_server
+# Bundle examples/execd.ts and brotli-embed into execd.exe
+make execd
 
 # Run it (no file argument needed)
-_build/exec_server.exe
+_build/execd.exe
 ```
 
 When run without a script file argument, `qwin.exe` checks for embedded JS at the end of itself. If found, it executes the embedded code. If not, it falls back to `main.js`. Both raw (`QWJS`) and brotli-compressed (`QWBR`) embedded payloads are supported; the compressed form is decompressed at startup.
@@ -198,7 +198,7 @@ that build run `make test TEST=-wasm` to skip WASM tests.
 | `make test` | run all tests |
 | `make test TEST=-net` | skip network tests (fast) |
 | `make test TEST=wasm` | run WASM tests only |
-| `make exec_server` | bundle `examples/exec_server.ts` and brotli-embed into `_build/exec_server.exe` |
+| `make execd` | bundle `examples/execd.ts` and brotli-embed into `_build/execd.exe` |
 | `make embed-js` / `embed-js-br` | embed JS (brotli-compressed) into exe |
 | `make npm-pkg` | package into `dist/quickwin/` |
 | `make gen-const` | regenerate `quickwin_const.d.ts` |

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` 运行这类脚本）。
 
 ## 内嵌脚本
 
@@ -79,11 +78,11 @@ make embed-js JS_EMBED=script.js
 # 内嵌 Brotli 压缩的脚本（exe 更小，运行时解压）
 make embed-js-br JS_EMBED=script.js
 
-# 打包 examples/exec_server.ts 并 brotli 内嵌进 exec_server.exe
-make exec_server
+# 打包 examples/execd.ts 并 brotli 内嵌进 execd.exe
+make execd
 
 # 运行它（不需要文件参数）
-_build/exec_server.exe
+_build/execd.exe
 ```
 
 不带脚本文件参数运行时，`qwin.exe` 会检查自身末尾是否有内嵌 JS：找到则执行内嵌代码，否则回退到 `main.js`。同时支持原始（`QWJS`）与 Brotli 压缩（`QWBR`）两种内嵌格式；压缩格式在启动时解压。
@@ -197,7 +196,7 @@ podman exec quickwin-dev bash -lc 'cd /workspace && make js && make cc64 && make
 | `make test` | 运行全部测试 |
 | `make test TEST=-net` | 跳过网络测试（快速） |
 | `make test TEST=wasm` | 仅运行 WASM 测试 |
-| `make exec_server` | 打包 `examples/exec_server.ts` 并 Brotli 内嵌进 `_build/exec_server.exe` |
+| `make execd` | 打包 `examples/execd.ts` 并 Brotli 内嵌进 `_build/execd.exe` |
 | `make embed-js` / `embed-js-br` | 把 JS（Brotli 压缩）内嵌进 exe |
 | `make npm-pkg` | 打包到 `dist/quickwin/` |
 | `make gen-const` | 重新生成 `quickwin_const.d.ts` |