修改启动脚本

docs/technical/RUST_LOCAL_AND_REMOTE_DEPLOYMENT_SCRIPTS_2026-04-22.md

@@ -1,4 +1,4 @@
-# Rust 本地联调与远端发布脚本方案
+# Rust 本地联调与远端发布脚本方案
 
 日期：`2026-04-22`
 
@@ -9,7 +9,7 @@
 1. 本地一键联调脚本：同时启动本地 SpacetimeDB、Rust `api-server` 与 Web 前端，并通过现有 Vite 代理开关把运行时 API 指向 Rust。
 2. Ubuntu 发布包构建脚本：在仓库根目录生成 `build/<当前时间>/` 发布目录，内含前端 release、Linux `api-server`、SpacetimeDB wasm、启动脚本、停止脚本，以及从仓库根目录复制的 `.env` / `.env.local`，并默认通过 `scp` 上传到目标服务器。
 
-脚本只做部署与联调编排，不改变 HTTP contract、SpacetimeDB schema 命名、对象存储键规划和前端默认 Node 开发入口。
+脚本只做部署与联调编排，不改变 HTTP contract、SpacetimeDB schema 命名和对象存储键规划。
 
 ## 2. 本地脚本
 
@@ -19,13 +19,7 @@
 npm run dev:rust
 ```
 
-跨平台 Bash 入口：
-
-```bash
-npm run dev:rust:sh
-```
-
-Windows 下 `dev:rust:sh`、`deploy:rust:remote` 与 `build:rust:ubuntu` 会通过 `scripts/run-bash-script.mjs` 优先查找 Git Bash；如安装路径不标准，可用 `GENARRATIVE_BASH` 指定 `bash` 可执行文件。
+默认入口直接执行 Bash 版 `scripts/dev-rust-stack.sh`。Windows 下 `dev:rust`、`dev:rust:logs`、`deploy:rust:remote` 与 `build:rust:ubuntu` 会通过 `scripts/run-bash-script.mjs` 优先查找 Git Bash；如安装路径不标准，可用 `GENARRATIVE_BASH` 指定 `bash` 可执行文件。
 
 默认端口：
 
@@ -33,11 +27,12 @@ Windows 下 `dev:rust:sh`、`deploy:rust:remote` 与 `build:rust:ubuntu` 会通
 2. Rust `api-server`：`http://127.0.0.1:8082`
 3. SpacetimeDB standalone：`http://127.0.0.1:3101`
 4. SpacetimeDB database：优先读取仓库根目录 `spacetime.local.json` 的 `database` 字段；没有该字段时才回退到 `genarrative-dev`
+5. SpacetimeDB 本地数据与日志目录：`server-rs/.spacetimedb/local`
 
 默认流程：
 
 1. 检查 `cargo`、`node` 与 `spacetime` CLI。
-2. 启动 `spacetime --root-dir server-rs/.spacetimedb/local start --edition standalone --listen-addr 127.0.0.1:3101`。
+2. 启动 `spacetime --root-dir=server-rs/.spacetimedb/local start --edition standalone --listen-addr 127.0.0.1:3101`，确保本地数据库与 SpacetimeDB 内部日志不会落到开发者全局目录。
 3. 等待 `spacetime server ping http://127.0.0.1:3101` 可用。
 4. 执行 `spacetime publish <本地数据库名> --server http://127.0.0.1:3101 --module-path server-rs/crates/spacetime-module --yes`。
 5. 注入 `GENARRATIVE_API_*` 与 `GENARRATIVE_SPACETIME_*` 后启动 `cargo run -p api-server`；直接运行 `api-server` 时，如未显式设置 `GENARRATIVE_SPACETIME_DATABASE`，服务端也会向上查找 `spacetime.local.json` 作为本地默认库名。
@@ -53,26 +48,35 @@ Vite 代理覆盖范围：
 安全边界：
 
 1. 默认不执行 `--clear-database`。
-2. 只有显式传入 `-ClearDatabase` 或 `--clear-database` 才允许清库重发。
-3. 如需要复用已经启动的 SpacetimeDB，可传 `-SkipSpacetime` / `--skip-spacetime`。
-4. 如只想启动进程不发布模块，可传 `-SkipPublish` / `--skip-publish`。
+2. 只有显式传入 `--clear-database` 才允许清库重发。
+3. 如需要复用已经启动的 SpacetimeDB，可传 `--skip-spacetime`。
+4. 如只想启动进程不发布模块，可传 `--skip-publish`。
 
 常用示例：
 
-```powershell
-.\scripts\dev-rust-stack.ps1
-.\scripts\dev-rust-stack.ps1 -ApiPort 8090 -SpacetimePort 3110 -Database genarrative-dev
-.\scripts\dev-rust-stack.ps1 -SkipSpacetime -SkipPublish
-.\scripts\dev-rust-stack.ps1 -ClearDatabase
-```
-
 ```bash
+npm run dev:rust
 ./scripts/dev-rust-stack.sh
 ./scripts/dev-rust-stack.sh --api-port 8090 --spacetime-port 3110 --database genarrative-dev
 ./scripts/dev-rust-stack.sh --skip-spacetime --skip-publish
 ./scripts/dev-rust-stack.sh --clear-database
 ```
 
+日志提取：
+
+```bash
+npm run dev:rust:logs
+npm run dev:rust:logs -- --follow
+./scripts/spacetime-logs-local.sh --lines 500 --output logs/spacetime/local.log
+```
+
+日志提取规则：
+
+1. SpacetimeDB 模块日志以 `spacetime logs <database>` 为唯一提取入口，脚本不直接读取内部日志文件结构。
+2. 默认读取 `spacetime.local.json` 的 `database` 字段，默认 server 为 `http://127.0.0.1:3101`。
+3. 默认输出到 `logs/spacetime/<database>-<timestamp>.log`，并通过 `tee` 同步显示在终端。
+4. `--follow` 仅用于本地追踪，会持续追加到同一个输出文件；停止时用 `Ctrl+C`。
+
 联调排错补充：
 
 1. 如果首页公开广场出现 `上游服务请求失败`，优先检查 `api-server` 错误详情里的 `ws://.../v1/database/<database>/subscribe` 是否指向了未发布的库。