Merge origin/master into codex/bounded-background-tasks-v2

2026-08-12 15:58:57 +08:00
parent 21b316de23 b423ed15d7
commit 91a2c0bd68
31 changed files with 137 additions and 41 deletions
@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/api-gateway.md
-api-gateway.md: c60793532d621585fc9878b6197497b45015856b
-api-gateway.zh.md: daf46f6ad208f4cb959028ff59d98d9de7a072d6
+api-gateway.md: e2878dce4611af562ebc4f30cbb2c5cb529dd61e
+api-gateway.zh.md: 86e63c6e9a4166a38397a445424704dc9e61821f
@@ -138,7 +138,7 @@ SRC solves only dispatch for a Host process running from source. The Client does

 ## Development mode

-The repository `dsh` script completes the Host, Client, and Web build before starting the source Host. Web development runs that command and the Client plugin watcher in separate terminals:
+Web development prepares current Host, Client, and Web artifacts with `pnpm run build`, then runs the source Host and the Client plugin watcher in separate terminals:

 ```sh
 pnpm dsh web
@@ -138,7 +138,7 @@ SRC 只解决 Host 源码进程的分发问题。Client 不会从运行中的 Ho

 ## 开发模式

-仓库的 `dsh` 脚本会先完成 Host、Client 与 Web 构建，再启动源码 Host。Web 开发需要在两个终端中分别运行该命令和 Client plugin watcher：
+Web 开发先使用 `pnpm run build` 准备当前 Host、Client 与 Web 产物，然后在两个终端中分别运行源码 Host 和 Client plugin watcher：

 ```sh
 pnpm dsh web
@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/development.md
-development.md: d5bd18f83f6f2f8fd3d507ec133eea4d4e06abef
-development.zh.md: 0725cfaad74ec2aa3e52f6523a1dbdbdd9da8a39
+development.md: 8d79756c50f82a840d412f52ee980cb0b505f6f1
+development.zh.md: 285bc0309212694d11077fa590edd199b895fe10
@@ -126,6 +126,12 @@ The root [contributor instructions](../AGENTS.md#commands) summarize common comm

 ### Demos

+Run the repository build separately before using these source-checkout demos:
+
+```sh
+pnpm run build
+```
+
 The one-shot Headless coding agent needs `DEEPSEEK_API_KEY` in the environment or repo-root `.env`:

 ```sh
@@ -126,6 +126,12 @@ keyless [CI 工作流](../.github/workflows/ci.yml) 将独立门禁分组到若

 ### 演示

+从源码 checkout 运行这些演示前，请单独执行仓库构建：
+
+```sh
+pnpm run build
+```
+
 单次运行的 Headless coding agent 需要环境变量或仓库根目录 `.env` 中的 `DEEPSEEK_API_KEY`：

 ```sh