修正 live stream 工具验收的运行口径并补进运维文档

仓库根目录没有 Cargo.toml，测试注释里的命令补上 --manifest-path server-rs/Cargo.toml 运维文档补充四个 PLATFORM_LLM_LIVE_* 变量、bash 与 PowerShell 两种执行方式，以及逐协议切换才算覆盖完整的口径明确凭据只从进程环境变量读取，不读 .env.secrets.local，真实 API Key 不得提交进仓库 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-27 03:24:47 +00:00
parent 5af8d59404
commit 5eee11ac0b
2 changed files with 19 additions and 1 deletions
@@ -655,6 +655,20 @@ OpenTelemetry 现阶段默认开启 OTLP traces / metrics / logs，但本地日

 验收证据分为两类：`cargo test -p platform-llm` 的确定性用例验证 checked-in SSE fixture 的 parser 行为；默认忽略的 `tests/live_stream_tool_calls.rs` 只对真实端点做归一后的工具调用 smoke，检查最终工具名、id、完整参数 JSON 和文本增量字符数。该 smoke 不录制或逐事件比较原始 SSE，fixture 即使来源于真实抓包也不能据此宣称转录无偏差。

+真实端点 smoke 由四个环境变量驱动，缺任一个直接失败：`PLATFORM_LLM_LIVE_BASE_URL`、`PLATFORM_LLM_LIVE_API_KEY`、`PLATFORM_LLM_LIVE_MODEL`、`PLATFORM_LLM_LIVE_API_KIND`（取值 `anthropic` / `openai_chat` / `openai_responses`，其它值按 `openai_responses` 处理）。仓库根目录没有 `Cargo.toml`，必须显式指定 workspace manifest：
+
+```bash
+PLATFORM_LLM_LIVE_BASE_URL=https://api.example.com/anthropic \
+PLATFORM_LLM_LIVE_API_KEY=<从密钥管理处取，勿写入仓库> \
+PLATFORM_LLM_LIVE_MODEL=<模型名> \
+PLATFORM_LLM_LIVE_API_KIND=anthropic \
+cargo test -p platform-llm --manifest-path server-rs/Cargo.toml --test live_stream_tool_calls -- --ignored --nocapture
+```
+
+PowerShell 下先用 `$env:PLATFORM_LLM_LIVE_API_KEY = '...'` 赋值再执行同一条 `cargo test`。切换 `PLATFORM_LLM_LIVE_API_KIND` 逐个跑三种协议，才算覆盖完整；`--nocapture` 会打印解析出的工具名、id 和参数，便于核对。
+
+该用例只从进程环境变量读取凭据，不读 `.env.secrets.local`，也不会写入任何文件。真实 API Key 一律不得提交进仓库，也不要写进 `docs/`、脚本默认值或测试 fixture；临时密钥用完应在上游及时吊销。
+
 创意 Agent `gpt-5` 文本链路已从 APIMart 切到 VectorEngine：`api-server` 读取 `VECTOR_ENGINE_BASE_URL` / `VECTOR_ENGINE_API_KEY` 构造 OpenAI-compatible LLM client，并自动补齐 `/v1` 前缀用于 Responses 协议。排查或切换密钥后，可在本地运行：
 创意 Agent `gpt-5.4-mini` 文本链路已从 APIMart 切到 VectorEngine：`api-server` 读取 `VECTOR_ENGINE_BASE_URL` / `VECTOR_ENGINE_API_KEY` 构造 OpenAI-compatible LLM client，并自动补齐 `/v1` 前缀后请求 `/chat/completions`。通用 `/api/llm/chat/completions` 代理使用 `GENARRATIVE_LLM_PROVIDER=openai-compatible`、`GENARRATIVE_LLM_BASE_URL=https://api.vectorengine.cn/v1`、`GENARRATIVE_LLM_MODEL=gpt-5.4-mini`，未单独配置 `GENARRATIVE_LLM_API_KEY` 时可复用 `VECTOR_ENGINE_API_KEY`。排查或切换密钥后，可在本地运行：

@@ -1,13 +1,17 @@
 //! 真实端点的流式工具调用验收。默认 `#[ignore]`，只在显式指定环境变量时运行：
 //!
+//! 仓库根目录没有 Cargo.toml，必须显式指定 workspace manifest：
+//!
 //! ```powershell
 //! $env:PLATFORM_LLM_LIVE_BASE_URL = 'https://api.minimaxi.com/anthropic'
 //! $env:PLATFORM_LLM_LIVE_API_KEY  = '...'
 //! $env:PLATFORM_LLM_LIVE_MODEL    = 'MiniMax-M3'
 //! $env:PLATFORM_LLM_LIVE_API_KIND = 'anthropic'   # 或 openai_chat / openai_responses
-//! cargo test -p platform-llm --test live_stream_tool_calls -- --ignored --nocapture
+//! cargo test -p platform-llm --manifest-path server-rs/Cargo.toml --test live_stream_tool_calls -- --ignored --nocapture
 //! ```
 //!
+//! 凭据只从进程环境变量读取，不要写进仓库内任何文件。
+//!
 //! 本用例是实时端点工具调用 smoke，只验证归一后的工具名、id、完整参数 JSON
 //! 和文本增量字符数；不录制或逐事件比对原始 SSE，也不承担固定 fixture 转录一致性证明。