1

docs/technical/RUNTIME_NPC_CHAT_LLM_MIGRATION_2026-04-25.md

@@ -29,6 +29,7 @@
    - 单轮变化限制在 `[-3, 3]`。
 5. `chatDirective.forceExitAfterTurn / closingMode=foreshadow_close` 时不生成建议，返回空数组，并在 `complete.chatDirective.forceExit` 中显式告知前端退出。
 6. LLM 未配置或失败时继续返回后端兜底 SSE，保证相遇和点击聊天链路不断。
+7. 在 Node 已完成平台账号鉴权并通过内部密钥转发到 Rust API 的链路中，`/api/runtime/chat/` 必须纳入 Rust 内部转发鉴权白名单；否则 NPC 主动开场会在进入 `runtime_chat` handler 前被 401 拒绝，前端只能收到“NPC 聊天续写失败”。
 
 ## 暂不落地
 
@@ -46,11 +47,14 @@
    - 优先 `LlmClient.stream_text(...)` 生成 `reply_delta`。
    - 再调用 `request_text(...)` 生成建议。
    - 计算 `affinityDelta / affinityText / chatDirective` 后输出 `complete`。
-3. 修改 `server-rs/crates/api-server/src/main.rs`
+3. 修改 `server-rs/crates/api-server/src/auth.rs`
+   - `allows_internal_forwarded_auth(...)` 允许 `/api/runtime/chat/`，与 big-fish、puzzle 的内部转发鉴权策略保持一致。
+   - 单测覆盖 `/api/runtime/chat/npc/turn/stream`，防止后续新增 runtime 路由时再次遗漏内部转发白名单。
+4. 修改 `server-rs/crates/api-server/src/main.rs`
    - 注册 `runtime_chat_prompt` 模块。
 
 ## 验收
 
 1. `cargo fmt -p api-server`
 2. `cargo check -p api-server`
-3. `node scripts/check-encoding.mjs docs/technical/RUNTIME_NPC_CHAT_LLM_MIGRATION_2026-04-25.md server-rs/crates/api-server/src/runtime_chat.rs server-rs/crates/api-server/src/runtime_chat_prompt.rs server-rs/crates/api-server/src/main.rs`
+3. `node scripts/check-encoding.mjs docs/technical/RUNTIME_NPC_CHAT_LLM_MIGRATION_2026-04-25.md server-rs/crates/api-server/src/auth.rs server-rs/crates/api-server/src/runtime_chat.rs server-rs/crates/api-server/src/runtime_chat_prompt.rs server-rs/crates/api-server/src/main.rs`