@deepseek-ai/dsh-llm-mock-server 0.1.5-rc.2 → 0.1.6-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.i18n.yaml +1 -1
  2. package/README.zh.md +8 -8
  3. package/package.json +1 -1
package/README.i18n.yaml CHANGED
@@ -3,4 +3,4 @@
3
3
  # after editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/test-support/llm-mock-server/README.md
5
5
  README.md: be311d9c83bcd35ad5bd0c003f6e95861b6d6976
6
- README.zh.md: 4c8dd1fffcb38be36d6e67420fa6be2370b89484
6
+ README.zh.md: 7a022131d9ef09d9ef89c91cae418f093f77aca1
package/README.zh.md CHANGED
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "用于在无提供方密钥的情况下测试 LLM 适配器与恢复策略的可编脚本 OpenAI 兼容故障服务器，面向测试作者与演示。"
2
+ description: "用于在无提供方密钥的情况下测试 LLM（大语言模型）适配器与恢复策略的可通过脚本控制的 OpenAI 兼容故障服务器，面向测试作者与演示。"
3
3
  kind: "package-library"
4
4
  ---
5
5
 
@@ -9,7 +9,7 @@ kind: "package-library"
9
9
 
10
10
  ## 概述
11
11
 
12
- 本包为测试与演示提供可编脚本的 OpenAI 兼容 HTTP／SSE 端点，使其无需提供方密钥即可检验模型提供方的失败与成功。每个已接受的 `/chat/completions` 请求依次消费下一个脚本行为，包括重置、停滞、畸形分片、限流、服务器错误、补全与工具调用。测试作者可以通过 `pnpm run mock:llm` 运行服务器，也可以调用 `startMockLlmServer`，后者会返回捕获的请求供断言使用。带种子的 `random` 行为支持可复现的混合故障压力运行。
12
+ 本包为测试与演示提供可编脚本的 OpenAI 兼容 HTTP／SSE（Server-Sent Events）端点，使其无需提供方密钥即可检验模型提供方的失败与成功。每个已接受的 `/chat/completions` 请求依次消费下一个脚本行为，包括重置、停滞、畸形分片、限流、服务器错误、补全与工具调用。测试作者可以通过 `pnpm run mock:llm` 运行服务器，也可以调用 `startMockLlmServer`，后者会返回捕获的请求供断言使用。带种子的 `random` 行为支持可复现的混合故障压力运行。
13
13
 
14
14
  ## 目录
15
15
 
@@ -25,7 +25,7 @@ kind: "package-library"
25
25
  <a id="use-this-package"></a>
26
26
  ## 使用本包
27
27
 
28
- 本包让测试或演示无需提供方即可讲提供方协议：启动服务器，脚本化你想检验的协议行为，然后把真实 LLM（大语言模型）适配器指向它的 base URL。
28
+ 本包让测试或演示无需实际提供方即可使用提供方协议进行通信：启动服务器，脚本化你想检验的协议行为，然后把真实 LLM 适配器指向它的 base URL。
29
29
 
30
30
  ### 独立运行
31
31
 
@@ -64,7 +64,7 @@ pnpm dsh --profile headless "test provider recovery"
64
64
  | `malformed_json` / `malformed_event` | 发送无效 SSE JSON 或无效提供方分片形态 |
65
65
  | `rate_limit` / `server_error` / `service_unavailable` | 返回面向重试的 429/500/503 JSON 错误 |
66
66
  | `auth_error` / `invalid_request` / `context_overflow` / `quota_exceeded` | 返回终止性错误或需要单独恢复的提供方错误 |
67
- | `success` / `slow_success` / `reasoning_success` | 流式发送完整文本响应，可选延迟或先发送 reasoning |
67
+ | `success` / `slow_success` / `reasoning_success` | 流式发送完整文本响应，可选延迟或先发送推理（reasoning） |
68
68
  | `tool_call_success` / `max_tokens` | 以工具调用或结束原因 `length` 完成 |
69
69
  | `wrong_content_type` | 以 `application/json` 内容类型发送有效 SSE 正文 |
70
70
  | `random` | 按带权重的种子随机选择具体请求行为 |
@@ -88,7 +88,7 @@ pnpm run mock:llm \
88
88
 
89
89
  ### 时序与内容控制
90
90
 
91
- CLI 公开 `--success-text`、`--partial-text`、`--reasoning-text`、`--chunk-size`、`--chunk-delay-ms`、`--disconnect-delay-ms`、`--retry-after-ms`、`--request-id`、`--tool-name` 与 `--tool-arguments`。毫秒延迟是 Node timer 范围内的有界整数；`retryAfterMs` 还必须为正数。库接受相同的 camel-case 选项。可选的精确 `apiKey` 验证 `Authorization: Bearer <token>`；省略时接受任何 token。
91
+ CLI 公开 `--success-text`、`--partial-text`、`--reasoning-text`、`--chunk-size`、`--chunk-delay-ms`、`--disconnect-delay-ms`、`--retry-after-ms`、`--request-id`、`--tool-name` 与 `--tool-arguments`。毫秒延迟是 Node 定时器范围内的有界整数；`retryAfterMs` 还必须为正数。库接受相同的 camel-case 选项。可选的 `apiKey` 会精确验证 `Authorization: Bearer <token>`；省略时接受任何 token。
92
92
 
93
93
  ### 可能出什么问题
94
94
 
@@ -114,10 +114,10 @@ CLI 公开 `--success-text`、`--partial-text`、`--reasoning-text`、`--chunk-s
114
114
 
115
115
  | 文件 | 职责 |
116
116
  |---|---|
117
- | [`src/index.ts`](src/index.ts) | `startMockLlmServer`：listener、行为表、种子随机、遥测、捕获的请求记录 |
117
+ | [`src/index.ts`](src/index.ts) | `startMockLlmServer`：listener、行为表、种子随机、遥测（telemetry）、捕获的请求记录 |
118
118
  | [`src/cli.ts`](src/cli.ts) | `--sequence` 与时序/内容选项解析、JSONL stdout 遥测 |
119
119
  | [`src/bin.ts`](src/bin.ts) | `pnpm run mock:llm` 源入口 |
120
- | — | 不发布运行时不变式伴生入口；协议行为通过 HTTP 测试检验。 |
120
+ | — | 不发布运行时不变式伴生组件；该独立测试服务器不拥有 Cordis 事件流或共享数据；其协议行为和生命周期通过直接 HTTP 测试及组装后的循环测试进行检验。 |
121
121
 
122
122
  ### 协议流程
123
123
 
@@ -130,7 +130,7 @@ CLI 公开 `--success-text`、`--partial-text`、`--reasoning-text`、`--chunk-s
130
130
  <a id="further-exploration"></a>
131
131
  ## 进一步探索
132
132
 
133
- 当包级约定不够用时阅读以下页面。它们从故障服务器逐步进入它所检验的适配器约定，以及用于已记录成功 transcript 的无密钥替代方案。
133
+ 当包级约定不够用时阅读以下页面。它们从故障服务器逐步进入它所检验的适配器约定，以及用于已记录成功 transcript（文本记录）的无密钥替代方案。
134
134
 
135
135
  - [LLM 包](../../llm/llm/README.zh.md)——本服务器所检验的提供方流约定与重试策略。
136
136
  - [llm-replay](../llm-replay/README.zh.md)——回放已记录成功 transcript 而非制造故障的无密钥替代方案。
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-llm-mock-server",
3
3
  "description": "Scriptable OpenAI-compatible HTTP/SSE fault server for LLM recovery tests",
4
- "version": "0.1.5-rc.2",
4
+ "version": "0.1.6-alpha.2",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },