chore: tidy local debug scripts

This commit is contained in:
npc0-hue
2026-07-23 16:09:12 +08:00
parent c07994c417
commit 8cc741ba19
15 changed files with 86 additions and 42 deletions
+6 -6
View File
@@ -76,17 +76,17 @@ Run the API-backed local debug workspace when you need platform, run, platform_w
```bash
git clone git@git.npc0.com:admin343/run.git run # once, if the ignored local checkout is missing
scripts/local-debug-start.sh
scripts/local-debug-smoke.sh
scripts/dev-start.sh
scripts/dev-smoke.sh
```
See `docs/local-debug-workspace.md` for ports, disposable data roots, log files, reset steps, smoke evidence, and the required browser walkthrough. This workflow treats frontend local auth fallback as a verification failure.
Use `LOCAL_DEBUG_SELF_START=true scripts/local-debug-smoke.sh` when you need the smoke command to own the temporary local stack for the duration of the verification.
Use `LOCAL_DEBUG_SELF_START=true scripts/dev-smoke.sh` when you need the smoke command to own the temporary local stack for the duration of the verification.
For local debug, prefer the managed scripts because they snapshot run source into the closed `.local-debug` build bucket and start the bootstrap worker from the built binary:
```bash
scripts/local-debug-start.sh
scripts/dev-start.sh
```
## Docker Deployment
@@ -154,8 +154,8 @@ Typical local debugging:
cp platform/.env.example platform/.env
cp platform_web/.env.example platform_web/.env
scripts/local-debug-start.sh
scripts/local-debug-smoke.sh
scripts/dev-start.sh
scripts/dev-smoke.sh
```
Most common edits: