pi-tsgw 0.6.0 → 1.0.0

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.
package/README.md CHANGED
@@ -4,21 +4,33 @@
4
4
  (openai-completions、openai-responses、anthropic-messages、google-generative-ai),
5
5
  并按厂商对请求体执行相应操作,使思考级别、推理格式和可选的内置网络搜索在网关上正常工作。
6
6
  图片模型通过 Pi 原生图片 API 调度,插件适配网关的 Images 接口,不经过 MCP。
7
+ 分类模型通过 Pi 原生 classifier API 和内置 System One 适配器调度,复用同一 tsgw 认证。
7
8
 
8
9
  本项目不包含私有 API 密钥或网关端点。静态目录包含模型元数据和公开价格估算;
9
10
  这些价格并非你的网关计费费率。
10
11
 
11
12
  ## 项目结构
12
13
 
13
- 包清单的 `pi.extensions` 指向根 `./index.ts`,作为约 15 行的总入口;provider 注册与生命周期位于 `extensions/provider/`,模型模块位于 `extensions/models/`。搜索模块及相邻测试位于 `extensions/search/`,提示词由 `extensions/prompts.ts` 的 `registerPrompts` 统一注册,正文位于 `prompts/`。宿主集成总测试为根 `index.test.ts`;provider 和搜索测试与对应模块相邻,共享测试夹具仍位于 `extensions/`。技能及其测试路径保持在 `skills/` 和 `extensions/`。
14
+ 包清单的 `pi.extensions` 指向根 `./index.ts`,作为约 15 行的总入口;provider 注册与生命周期位于 `extensions/provider/`,模型模块位于 `extensions/models/`,图片协议实现位于该目录下的 `adapter/images/`,分类桥接位于 `adapter/classifiers/`,图片工具、参数 schema 与本地文件仍由 `extensions/images/` 承担。搜索模块及相邻测试位于 `extensions/search/`,提示词由 `extensions/prompts.ts` 的 `registerPrompts` 统一注册,正文位于 `prompts/`。宿主集成总测试为根 `index.test.ts`;provider、模型与搜索的测试与对应模块相邻,图片工具测试与 `extensions/images/` 中的实现相邻,共享测试夹具仍位于 `extensions/`。技能及其测试路径保持在 `skills/` 和 `extensions/`。
15
+
16
+ 跨模块源码引用统一使用 package 子路径别名 `#tsgw/*`(映射到 `extensions/`)与 `#tsgw-prompts/*`(映射到 `prompts/`),别名不带 `.ts` 后缀;模块内部继续用相对 `.ts` 路径,由 tsc 改写为 `.js`。真实入口文件(含各 `index.ts`)继续承担实际装配职责,不为聚合再导出新增 barrel 索引。
14
17
 
15
18
  ```text
16
19
  index.ts # 包总入口
17
20
  index.test.ts # 宿主集成总测试
18
- extensions/provider/ # provider 注册、配置、状态及其测试
19
- extensions/models/ # 模型目录、策略与联网支持
21
+ extensions/provider/ # provider 注册、配置、状态与刷新
22
+ extensions/models/
23
+ catalog.ts # 聊天目录与最终混合目录的纯汇总/过滤
24
+ capabilities.ts # 图片与分类的宿主版本门
25
+ gateway-catalog.ts # 网关网络/磁盘缓存
26
+ operations.ts # 聊天请求改写
27
+ web-search.ts # 内置联网
28
+ vendors/ # 厂商规格(含 openai 图片、typesafe 分类)
29
+ adapter/
30
+ images/ # 图片协议实现与对应测试
31
+ classifiers/ # 分类桥接与对应测试
20
32
  extensions/search/ # 搜索注册、代理与相邻测试
21
- extensions/images/ # 原生图片生成适配与宿主集成测试
33
+ extensions/images/ # 图片工具、schema、本地文件与宿主集成测试
22
34
  extensions/prompts.ts # registerPrompts
23
35
  prompts/memory.ts # 记忆提示词正文
24
36
  extensions/upload/ # 本地上传及安全说明
@@ -86,9 +98,11 @@ pi install npm:pi-tsgw
86
98
 
87
99
  ## 模型目录
88
100
 
89
- 目录由各厂商的分片(`extensions/models/vendors/`)组装而成,涵盖 11 个厂商系列:
101
+ 模型规格由厂商分片(`extensions/models/vendors/`)维护。聊天目录涵盖 11 个厂商系列:
90
102
  DeepSeek、GLM(智谱)、MiMo(小米)、MiniMax、Kimi(Moonshot)、Qwen(阿里巴巴)、
91
103
  GPT(OpenAI)、Gemini(Google)、Claude(Anthropic)、LongCat 和 Grok(xAI)。
104
+ 另有厂商 **TypeSafe** 的 **Jev** 分类模型系列,规格位于 `vendors/typesafe.ts`,
105
+ 由分类能力入口单独组装,不放进聊天目录。
92
106
  静态目录会持续调整,不代表网关实时可用模型数量。
93
107
  厂商文件包含文档链接和元数据注意事项。别名映射、输出限制和共享思考策略并未全部
94
108
  针对网关端点逐项验证;公开价格估算不构成计费保证。
@@ -184,7 +198,7 @@ Pi 1.2+ 可在现有 `tsgw` provider 中注册 `gpt-image-2.5-flare` 和
184
198
  默认使用 Sunburst 生成一张 PNG,草稿任务可选 Flare;质量、尺寸、格式、压缩、数量、背景及流式参数可按需覆盖。
185
199
  工具返回图片和保存原始字节的临时路径;编辑支持本地文件、图片 URL/data URI 或上游文件 ID。
186
200
  图片模型不进入聊天选择器或搜索代理。原生 codemode 调用仍可用;调用、文件权限、超时及结果边界见
187
- [图片生成维护与使用说明](extensions/images/README.md)。
201
+ [图片生成维护与使用说明](extensions/images/README.md);该说明描述工具与文件层,协议实现位于 `extensions/models/adapter/images/`。
188
202
 
189
203
  随包 [tsgw-image-generation](skills/tsgw-image-generation/SKILL.md) 技能提供生成、编辑、模型选型和参数示例;
190
204
  可以直接描述需要的图片,也可使用 `/skill:tsgw-image-generation` 显式加载技能。
@@ -192,13 +206,53 @@ Pi 1.2+ 可在现有 `tsgw` provider 中注册 `gpt-image-2.5-flare` 和
192
206
  图片价格显示为 0 表示尚未映射准确价格,不是免费;usage 只统计上游已报告的有效 tokens。
193
207
  隔离测试不替代真实网关对各参数、编辑、流式和图片展示的逐项验收。
194
208
 
209
+ ## 原生分类模型
210
+
211
+ 厂商为 **TypeSafe**,模型系列为 **Jev**。Pi 1.2.0 及以上稳定版本登记
212
+ `jev-latest`、`jev-preview` 两个 `type: classifier` 模型,复用现有 `tsgw` provider、网关根地址及宿主认证,端点为 `/v1/systemone`。
213
+ 旧宿主不登记分类模型,聊天最低兼容版本不变。不将 Jev 放入聊天选择器、图片目录或搜索代理候选;
214
+ 它们和其他模型一样受静态目录、网关目录交集及 `includeModels` / `excludeModels` 过滤约束。
215
+ 仅登记这两个已验收 ID,不登记 `Kev-4B`、`SemIf` 或 Luna 的 Decisions 身份。
216
+
217
+ 通过宿主 codemode 调用(需启用 codemode;不需要新增 MCP 服务):
218
+
219
+ ```javascript
220
+ const model = await models.getModelOfType("classifier", "tsgw", "jev-latest");
221
+ if (!model) throw new Error("分类模型未登记,请检查网关目录和过滤配置。");
222
+ const result = await models.classify(model, {
223
+ state: { message: "订单被重复扣款,请今天处理。" },
224
+ questions: {
225
+ urgent: { type: "bool", instructions: "是否需要今天处理?",
226
+ criteria: { true: "今天处理", false: "可以等待" } },
227
+ department: { type: "choice", instructions: "由哪个团队处理?",
228
+ criteria: { billing: "付款和退款", technical: "故障", other: "其他" } },
229
+ severity: { type: "score", instructions: "严重程度如何?",
230
+ criteria: ["轻微", "有替代方案", "完全阻塞"] },
231
+ },
232
+ });
233
+ text(result.stopReason === "stop" ? result.answers : { error: result.errorMessage });
234
+ ```
235
+
236
+ 扩展也可直接调用 `ctx.modelRegistry.classify()`,不依赖 codemode。bool 映射为线上的
237
+ `noul` 并返回成立概率;choice 返回选项、概率分布与置信度;score 返回从 0 开始的等级
238
+ 索引期望值(可以是小数),不是整数标签。分类适配由 `extensions/models/adapter/classifiers/adapter.ts`
239
+ 桥接宿主内置 SystemOne,登记能力门位于 `extensions/models/capabilities.ts`;适配器不复制 HTTP 或结果解析,
240
+ 始终禁用自动重试、不自动换模型,错误只输出脱敏摘要,调用者应检查 `stopReason`。
241
+
242
+ 当前仅声明文本输入,总请求窗口采用官方 64,000 tokens;官方单题窗口为 32K,不能把总窗口
243
+ 当作每题预算。未开启实验图片或长上下文。输入参考价为 $0.042/百万 tokens、输出参考价
244
+ 为零(2026-10-18,来源:[TypeSafe Models](https://docs.typesafe.ai/models),资料见 Blinko 950),
245
+ 不代表网关实际扣费。usage 保留上游实际报告的 tokens,不因输出参考价为零就抹去输出量。
246
+ 两 ID 都是可移动别名,不推定网关底层版本。此前短文本 bool/choice/score 已经宿主原生
247
+ 解析验收;不代表长上下文、中文质量或概率校准已验收。隔离回归不替代真实能力验证。
248
+
195
249
  ## 状态栏与会话控制
196
250
 
197
251
  支持 `command:/…` 状态的 Pi Web 客户端会将其渲染为可点击按钮;终端 CLI 显示状态文本,
198
252
  并接受相同命令:
199
253
 
200
254
  - **`TSGW · N`**(`/tsgw`):在同一菜单中**刷新模型目录**和**查看诊断信息**。
201
- 数量表示过滤后已注册的聊天与图片目录条目数,而非健康推理端点的数量。
255
+ 数量表示过滤后已注册的聊天、图片与分类目录条目数,而非健康推理端点的数量。
202
256
  🟢 表示新鲜的目录结果;🟡 表示静态/过期目录或刷新失败;⚠️ 表示缺少凭据或网关配置;
203
257
  ⏳ 表示正在刷新。
204
258
  - **内置联网**(`/tsgw-search`):GPT 仅为当前会话提供 `cached / live`,默认为 `live`。
@@ -335,7 +389,9 @@ npm pack --dry-run --json
335
389
 
336
390
  Pi 作为开发依赖安装;锁文件定义测试基线(Pi SDK 1.2.0,结构约束(schema)测试使用 TypeBox 1.3.37)。
337
391
  SDK 保留其自身的 TypeBox 1.3.27 验证器,因此不假设结构约束构造与宿主验证使用相同版本。
338
- Pi AI/MCP 是明确仅用于测试的开发依赖;运行时依赖和提供商的对等依赖最低版本保持不变。
392
+ Pi AI/MCP 显式列为开发依赖,供类型检查和测试使用;分类功能运行时通过 Pi 宿主的
393
+ loader 映射复用其内置 AI adapter,不由插件安装或携带第二份实现。未新增运行时依赖,
394
+ 提供商的对等依赖最低版本保持不变。
339
395
  测试使用临时代理目录隔离配置和凭据。单元测试使用模拟宿主;宿主集成测试通过真实 Pi SDK
340
396
  加载扩展并模拟 HTTP 响应,不发起生产请求。它们不验证上游推理、原生搜索结果或 Pi Web
341
397
  渲染效果。升级 Pi 后请运行完整测试套件。
@@ -346,6 +402,7 @@ Pi AI/MCP 是明确仅用于测试的开发依赖;运行时依赖和提供商
346
402
  - [请求操作](https://github.com/tossp/pi-tsgw/blob/main/extensions/models/operations.ts):写时复制分派;DeepSeek/Claude 响应仍由 Pi 的适配器处理。
347
403
  - [内置搜索](https://github.com/tossp/pi-tsgw/blob/main/extensions/models/web-search.ts):精确的模型/协议支持范围和仅追加注入。
348
404
  - [扩展总入口](https://github.com/tossp/pi-tsgw/blob/main/index.ts):包加载入口;[provider 集成](https://github.com/tossp/pi-tsgw/tree/main/extensions/provider):注册、配置、刷新、命令和生命周期快照。延迟执行的请求回调不得访问过期的会话上下文。
405
+ - [图片协议实现](extensions/models/adapter/images/) 与 [分类桥接](extensions/models/adapter/classifiers/):图片六个协议文件与分类适配器;工具注册与参数 schema 仍位于 [images](extensions/images/),[能力门](extensions/models/capabilities.ts) 判定图片与分类各自的宿主最低版本。
349
406
  - [提示词注册](https://github.com/tossp/pi-tsgw/blob/main/extensions/prompts.ts):`registerPrompts` 统一入口;记忆正文位于 `prompts/memory.ts`。
350
407
 
351
408
  这些源码链接描述仓库当前的 main 分支;已安装的发行版可能有所不同。
@@ -1,6 +1,6 @@
1
1
  # 图片生成与编辑
2
2
 
3
- 本目录维护 `tsgw` 的原生图片适配及两个直接工具。两者都复用 Pi 模型注册表、供应商认证与同一套请求/响应实现,不另建凭据解析或 HTTP SDK。
3
+ 本目录维护 `tsgw` 的两个直接图片工具、参数 schema 与本地文件处理。工具通过 Pi 模型注册表和供应商认证,调用 `extensions/models/adapter/images/` 的同一套请求/响应实现,不另建凭据解析或 HTTP SDK。
4
4
 
5
5
  ## 入口与模型
6
6
 
@@ -10,7 +10,7 @@
10
10
  - 只登记 `gpt-image-2.5-flare` 和 `gpt-image-2.5-sunburst` 两款 `type: image` 模型,输入为文本/图片,输出为图片。草稿/速度优先选 Flare,成稿/质量优先选 Sunburst;工具默认 Sunburst,不自动选择另一型号重试。
11
11
  - 图片目录仍取静态目录与网关目录的交集,再应用 include/exclude。`includeModels: ["gpt-image-2.5*"]` 不能突破交集;图片不进入聊天模型选择器或联网代理候选。
12
12
 
13
- 工具输入示例及完整可选参数表见随包[图片技能](../../skills/tsgw-image-generation/SKILL.md)。技能用于任务选型与参数使用,不代替实际工具执行。
13
+ 工具输入示例及完整可选参数表见随包[图片技能](../../skills/tsgw-image-generation/SKILL.md)。技能用于任务选型与参数使用,不代替实际工具执行;图片目录是否登记由 `extensions/models/capabilities.ts` 的版本门判定。
14
14
 
15
15
  ## 请求与参数
16
16
 
@@ -72,10 +72,8 @@ usage 仅取上游报告的有效 tokens;坏图、断流等失败路径仍尽
72
72
 
73
73
  ## 维护与验证
74
74
 
75
- - `tools.ts` / `tool-schema.ts` / `tool-files.ts`:工具、参数声明、原图与输出文件。
76
- - `parameters.ts` / `request.ts`:参数、引用、生成/编辑请求及最终序列化验证。
77
- - `adapter.ts`:宿主凭据、HTTP、钩子与取消/超时。
78
- - `response.ts` / `image-data.ts` / `stream-response.ts`:用量、格式校验、普通/流式响应。
79
- - `host-integration.test.ts`:原生模型与 codemode 回归;`tools-host.test.ts`:无 codemode 的真实 SDK 工具回归,HTTP 使用隔离 fixture。
75
+ - 本目录只承担图片工具与文件处理:`tools.ts` / `tool-schema.ts` / `tool-files.ts` 与对应 `tools.test.ts` / `tool-files.test.ts` / `tools-host.test.ts` / `host-integration.test.ts`。
76
+ - 图片协议实现位于 `extensions/models/adapter/images/`:`adapter.ts`(宿主凭据、HTTP、钩子与取消/超时)、`parameters.ts` / `request.ts`(参数、引用、生成/编辑请求及序列化)、`response.ts` / `image-data.ts` / `stream-response.ts`(用量、格式校验、普通/流式响应)及对应单测;共享原图夹具 `image-fixtures.test.ts` 随协议层迁移,工具层继续跨目录复用而不复制数据。
77
+ - `extensions/models/capabilities.ts` 提供纯版本判断,由根入口和 provider 决定图片工具、模型与适配器是否登记;它不读 `VERSION` 全局,不将模块加载与能力登记混为一谈。
80
78
 
81
79
  接口与模型证据见记忆系统 942;用户确认网关编辑端点兼容,不替代本插件新组合的独立验收。测试不读取个人配置或请求真实网关,真实推理另需授权。
@@ -3,8 +3,8 @@ import { mkdtemp, open, realpath, rm, stat, unlink, type FileHandle } from "node
3
3
  import { join, resolve } from "node:path";
4
4
  import { tmpdir } from "node:os";
5
5
  import type { ImageContent } from "@earendil-works/pi-ai";
6
- import { inspectImage } from "./image-data.ts";
7
- import { MAX_IMAGE_INPUT_BYTES, MAX_IMAGE_INPUT_TOTAL_BYTES, type ImageFormat, type ImageReference } from "./parameters.ts";
6
+ import { inspectImage } from "#tsgw/models/adapter/images/image-data";
7
+ import { MAX_IMAGE_INPUT_BYTES, MAX_IMAGE_INPUT_TOTAL_BYTES, type ImageFormat, type ImageReference } from "#tsgw/models/adapter/images/parameters";
8
8
  import { plainObject } from "./tool-schema.ts";
9
9
 
10
10
  // 与适配器共用十进制字节预算;保留工具测试的导出入口。
@@ -1,5 +1,5 @@
1
1
  import { Type } from "typebox";
2
- import { normalizeImageParameters, type ImageOperation } from "./parameters.ts";
2
+ import { normalizeImageParameters, type ImageOperation } from "#tsgw/models/adapter/images/parameters";
3
3
 
4
4
  export const DEFAULT_IMAGE_MODEL = "gpt-image-2.5-sunburst";
5
5
  export const DEFAULT_IMAGE_TIMEOUT_MS = 600_000;
@@ -1,6 +1,6 @@
1
1
  import type { AssistantImages, ImageContent } from "@earendil-works/pi-ai";
2
2
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
3
- import { normalizeImageParameters, type ImageOperation, type TsgwImagesContext, type TsgwImagesResult, type ImageUsageReport } from "./parameters.ts";
3
+ import { normalizeImageParameters, type ImageOperation, type TsgwImagesContext, type TsgwImagesResult, type ImageUsageReport } from "#tsgw/models/adapter/images/parameters";
4
4
  import { DEFAULT_IMAGE_MODEL, editImageSchema, generateImageSchema, imageToolResultSchema, prepareImageToolParameters } from "./tool-schema.ts";
5
5
  import { ImageToolFileError, resolveImageSources, saveImageOutput, validateImageOutput, type ImageFileResult } from "./tool-files.ts";
6
6
 
@@ -7,7 +7,7 @@
7
7
 
8
8
  import type { ProviderModelConfig } from "@earendil-works/pi-coding-agent";
9
9
 
10
- // Pi 1.x 还包含图像/分类器配置;本目录仅包含聊天模型。
10
+ // Pi 1.x 还包含图片/分类配置;此类型仅提取聊天模型。
11
11
  // 通过结构提取,保持与旧版仅含聊天模型的类型兼容。
12
12
  export type ChatModelConfig = Extract<ProviderModelConfig, { reasoning: boolean }>;
13
13
 
@@ -0,0 +1,111 @@
1
+ import type {
2
+ ClassifierApi,
3
+ ClassifierModel,
4
+ ClassifierResult,
5
+ ProviderClassifier,
6
+ } from "@earendil-works/pi-ai";
7
+ import { TYPESAFE_CLASSIFIER_API as CLASSIFIER_API, TYPESAFE_CLASSIFIER_MODEL_IDS as CLASSIFIER_MODEL_IDS } from "#tsgw/models/vendors/typesafe";
8
+
9
+ type Classify = ProviderClassifier["classify"];
10
+
11
+ const CANCELLED = "分类请求已取消。";
12
+ const UNSUPPORTED_MODEL = "不支持的分类模型或协议。";
13
+ const MISSING_IMPLEMENTATION = "当前宿主未提供可用的 System One 分类实现,请升级 Pi 后重试。";
14
+ const GENERIC_ERROR = "分类请求失败,请检查认证、网络及请求参数。";
15
+
16
+ let loaded: Promise<Classify | undefined> | undefined;
17
+
18
+ /**
19
+ * 仅在真正分类时加载宿主的内置 provider。旧宿主没有 providers/all 或分类实现时
20
+ * 只返回安全错误,不在模块加载阶段触碰新 API。
21
+ */
22
+ function nativeClassify(): Promise<Classify | undefined> {
23
+ loaded ??= (async () => {
24
+ try {
25
+ const { builtinProviders } = await import("@earendil-works/pi-ai/providers/all");
26
+ const provider = builtinProviders().find((entry) => entry.id === "typesafe");
27
+ return provider?.classify?.bind(provider);
28
+ } catch {
29
+ return undefined;
30
+ }
31
+ })();
32
+ return loaded;
33
+ }
34
+
35
+ function supported(model: ClassifierModel<ClassifierApi>): boolean {
36
+ return model.type === "classifier" && model.api === CLASSIFIER_API &&
37
+ CLASSIFIER_MODEL_IDS.some((id) => id === model.id);
38
+ }
39
+
40
+ function errorResult(
41
+ model: ClassifierModel<ClassifierApi>,
42
+ errorMessage: string,
43
+ aborted = false,
44
+ ): ClassifierResult {
45
+ return {
46
+ api: model.api,
47
+ provider: model.provider,
48
+ model: model.id,
49
+ answers: {},
50
+ stopReason: aborted ? "aborted" : "error",
51
+ errorMessage,
52
+ timestamp: Date.now(),
53
+ };
54
+ }
55
+
56
+ /**
57
+ * 原生分类 adapter 的错误会附带上游响应正文;这里只保留可安全展示的中文类别、
58
+ * HTTP 状态和必要的可操作提示,不把正文、URL 或凭据带出到结果。
59
+ */
60
+ function safeErrorMessage(message: string | undefined, aborted: boolean): string {
61
+ if (aborted) return CANCELLED;
62
+ const text = message ?? "";
63
+ if (/timeout|timed?\s*out|超时/i.test(text)) return "分类请求超时。";
64
+ const status = /(?:\(|returned\s+|status(?:Code|\s+code)?\s*[:=]?\s*)([45]\d{2})(?:\)|\b)/i
65
+ .exec(text)?.[1];
66
+ if (status) {
67
+ if (status === "401" || status === "403") return `分类请求认证失败(HTTP ${status})。`;
68
+ if (status === "429") return `分类请求被上游限流(HTTP ${status})。`;
69
+ return `分类请求失败(HTTP ${status})。`;
70
+ }
71
+ if (/no api key|api key|unauthor|forbidden|auth/i.test(text))
72
+ return "分类请求缺少有效认证信息。";
73
+ if (/does not support image|image input/i.test(text))
74
+ return "当前分类模型不支持图片输入。";
75
+ if (/unsupported classifier api|no classifier implementation/i.test(text))
76
+ return MISSING_IMPLEMENTATION;
77
+ if (/unexpected response|invalid|did not return|malformed|parse|schema/i.test(text))
78
+ return "分类服务返回了无效响应。";
79
+ if (/fetch failed|network|econn|enotfound|eai_again|connection|socket|terminated/i.test(text))
80
+ return "分类网络请求失败。";
81
+ return GENERIC_ERROR;
82
+ }
83
+
84
+ /**
85
+ * 复用宿主内置 TypeSafe System One classify;不解析 HTTP、不复制分类协议。
86
+ * 模型、context、认证、signal、timeout、请求/响应钩子全部透传,始终禁用
87
+ * 自动重试且不自动切换模型,避免失败请求产生额外费用。
88
+ */
89
+ export const classify: ProviderClassifier["classify"] = async (model, context, options) => {
90
+ if (options?.signal?.aborted) return errorResult(model, CANCELLED, true);
91
+ if (!supported(model)) return errorResult(model, UNSUPPORTED_MODEL);
92
+
93
+ let implementation: Classify | undefined;
94
+ try {
95
+ implementation = await nativeClassify();
96
+ } catch {
97
+ implementation = undefined;
98
+ }
99
+ if (!implementation) return errorResult(model, MISSING_IMPLEMENTATION);
100
+
101
+ try {
102
+ const result = await implementation(model, context, { ...options, maxRetries: 0 });
103
+ if (result.stopReason !== "error" && result.stopReason !== "aborted") return result;
104
+ const aborted = result.stopReason === "aborted" || options?.signal?.aborted === true;
105
+ return { ...result, stopReason: aborted ? "aborted" : "error", errorMessage: safeErrorMessage(result.errorMessage, aborted) };
106
+ } catch (error) {
107
+ if (options?.signal?.aborted) return errorResult(model, CANCELLED, true);
108
+ const message = error instanceof Error ? error.message : "";
109
+ return errorResult(model, safeErrorMessage(message, false));
110
+ }
111
+ };
@@ -1,5 +1,5 @@
1
1
  import type { ProviderHeaders, ProviderImages } from "@earendil-works/pi-ai";
2
- import { IMAGE_API, IMAGE_MODEL_IDS } from "./models.ts";
2
+ import { OPENAI_IMAGE_API as IMAGE_API, OPENAI_IMAGE_MODEL_IDS as IMAGE_MODEL_IDS } from "#tsgw/models/vendors/openai";
3
3
  import { abortable, ImageFailure, parseUsage, record } from "./response.ts";
4
4
  import type { TsgwImagesResult } from "./parameters.ts";
5
5
  import { createImageRequest, serializeImageRequest } from "./request.ts";
@@ -0,0 +1,18 @@
1
+ /** 只判断稳定版宿主基线,不读取宿主运行时或用户配置。 */
2
+ function supportsStablePi12(version: string): boolean {
3
+ const match = /^(\d+)\.(\d+)\.(\d+)(?:\+.*)?$/.exec(version);
4
+ if (!match) return false;
5
+ const major = Number(match[1]);
6
+ const minor = Number(match[2]);
7
+ return major > 1 || (major === 1 && minor >= 2);
8
+ }
9
+
10
+ /** 图片目录与适配器以 Pi 1.2 稳定版为已验证登记基线。 */
11
+ export function supportsImageModels(version: string): boolean {
12
+ return supportsStablePi12(version);
13
+ }
14
+
15
+ /** 分类目录与桥接沿用 Pi 1.2 稳定版基线,不提高聊天最低 peer。 */
16
+ export function supportsClassifierModels(version: string): boolean {
17
+ return supportsStablePi12(version);
18
+ }
@@ -1,3 +1,4 @@
1
+ import type { ProviderModelConfig as AnyModelConfig } from "@earendil-works/pi-coding-agent";
1
2
  import type { ChatModelConfig as ProviderModelConfig } from "./_tools.ts";
2
3
  import { anthropicModels } from "./vendors/anthropic.ts";
3
4
  import { deepseekModels } from "./vendors/deepseek.ts";
@@ -8,7 +9,8 @@ import { kimiModels } from "./vendors/kimi.ts";
8
9
  import { longcatModels } from "./vendors/longcat.ts";
9
10
  import { mimoModels } from "./vendors/mimo.ts";
10
11
  import { minimaxModels } from "./vendors/minimax.ts";
11
- import { openaiModels } from "./vendors/openai.ts";
12
+ import { openaiImageModels, openaiModels } from "./vendors/openai.ts";
13
+ import { typesafeClassifierModels } from "./vendors/typesafe.ts";
12
14
  import { qwenModels } from "./vendors/qwen.ts";
13
15
 
14
16
  export const PROVIDER_ID = "tsgw";
@@ -76,7 +78,7 @@ export function filterModels<T extends { id: string }>(
76
78
  }
77
79
 
78
80
  /**
79
- * TSGW 的权威模型目录:按固定顺序拼接各厂商分片,
81
+ * TSGW 的聊天模型目录:按固定顺序拼接各厂商分片,
80
82
  * 然后根据配置的黑白名单进行过滤。
81
83
  *
82
84
  * 新增模型 → 改对应 vendors 文件;新增供应商 → 这里增加导入与展开。
@@ -100,3 +102,31 @@ export function modelsForRoot(
100
102
  ];
101
103
  return filterModels(models, filter);
102
104
  }
105
+
106
+ /** 网关允许精确 ID 或带厂商前缀的同名 ID,匹配区分大小写。 */
107
+ function gatewayHasModel(gatewayIds: ReadonlySet<string>, id: string): boolean {
108
+ if (gatewayIds.has(id)) return true;
109
+ const suffix = `/${id}`;
110
+ for (const gatewayId of gatewayIds)
111
+ if (gatewayId.endsWith(suffix)) return true;
112
+ return false;
113
+ }
114
+
115
+ /** 全类型目录:按宿主能力拼接,再取网关交集并应用用户过滤。 */
116
+ export function effectiveModelsForGateway(
117
+ root: string,
118
+ filter: ModelFilter | undefined,
119
+ gatewayIds: ReadonlySet<string> | undefined,
120
+ imagesEnabled: boolean,
121
+ classifiersEnabled: boolean,
122
+ ): AnyModelConfig[] {
123
+ const staticModels: AnyModelConfig[] = [
124
+ ...modelsForRoot(root),
125
+ ...(imagesEnabled ? openaiImageModels(root) : []),
126
+ ...(classifiersEnabled ? typesafeClassifierModels(root) : []),
127
+ ];
128
+ const intersected = gatewayIds
129
+ ? staticModels.filter((model) => gatewayHasModel(gatewayIds, model.id))
130
+ : [];
131
+ return filterModels(intersected, filter);
132
+ }
@@ -0,0 +1,31 @@
1
+ import type { ProviderModelConfig } from "@earendil-works/pi-coding-agent";
2
+
3
+ /** TypeSafe 是厂商,Jev 是其分类模型系列;厂商目录不混入聊天目录。 */
4
+ export const TYPESAFE_CLASSIFIER_API = "typesafe-system-one";
5
+ export const TYPESAFE_CLASSIFIER_MODEL_IDS = ["jev-latest", "jev-preview"] as const;
6
+ export type TypeSafeClassifierModelConfig = Extract<ProviderModelConfig, { type: "classifier" }>;
7
+
8
+ const MODEL_NAMES = {
9
+ "jev-latest": "TypeSafe Jev Latest",
10
+ "jev-preview": "TypeSafe Jev Preview",
11
+ } as const;
12
+
13
+ /**
14
+ * TypeSafe 官方来源(2026-10-18):https://docs.typesafe.ai/models
15
+ * Jev 仅声明文本输入,总请求窗口按 64,000 登记;官方单题窗口为 32K,
16
+ * 不能把总窗口当作每题预算。别名可移动,不推定本网关的底层版本。
17
+ * 公开参考输入价 0.042 USD/Mtok,输出与缓存为 0,仅用于估算,不代表网关实扣。
18
+ */
19
+ export function typesafeClassifierModels(root: string): TypeSafeClassifierModelConfig[] {
20
+ const baseUrl = `${root.replace(/\/+$/, "")}/v1`;
21
+ return TYPESAFE_CLASSIFIER_MODEL_IDS.map((id) => ({
22
+ type: "classifier" as const,
23
+ id,
24
+ name: MODEL_NAMES[id],
25
+ api: TYPESAFE_CLASSIFIER_API,
26
+ baseUrl,
27
+ input: ["text"],
28
+ contextWindow: 64_000,
29
+ cost: { input: 0.042, output: 0, cacheRead: 0, cacheWrite: 0 },
30
+ }));
31
+ }
@@ -1,5 +1,5 @@
1
1
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
- import { MEMORY_RULES } from "../prompts/memory.ts";
2
+ import { MEMORY_RULES } from "#tsgw-prompts/memory";
3
3
 
4
4
  export function registerPrompts(pi: ExtensionAPI): void {
5
5
  pi.on("before_agent_start", (event) => {
@@ -14,23 +14,25 @@ import { randomUUID } from "node:crypto";
14
14
  import {
15
15
  DEFAULT_ROOT,
16
16
  PROVIDER_ID,
17
- filterModels,
18
- modelsForRoot,
17
+ effectiveModelsForGateway,
19
18
  normalizeRoot,
20
19
  type ModelFilter,
21
- } from "../models/catalog.ts";
22
- import { getGatewayModelIds, STARTUP_GATEWAY_MODEL_CACHE_TTL_MS } from "../models/gateway-catalog.ts";
23
- import { applyModelOperations } from "../models/operations.ts";
24
- import { registerSearch } from "../search/index.ts";
25
- import { IMAGE_API, imageModelsForRoot, supportsImageModels } from "../images/models.ts";
26
- import { generateImages } from "../images/adapter.ts";
20
+ } from "#tsgw/models/catalog";
21
+ import { getGatewayModelIds, STARTUP_GATEWAY_MODEL_CACHE_TTL_MS } from "#tsgw/models/gateway-catalog";
22
+ import { applyModelOperations } from "#tsgw/models/operations";
23
+ import { registerSearch } from "#tsgw/search/index";
24
+ import { supportsClassifierModels, supportsImageModels } from "#tsgw/models/capabilities";
25
+ import { OPENAI_IMAGE_API as IMAGE_API } from "#tsgw/models/vendors/openai";
26
+ import { TYPESAFE_CLASSIFIER_API as CLASSIFIER_API } from "#tsgw/models/vendors/typesafe";
27
+ import { generateImages } from "#tsgw/models/adapter/images/adapter";
28
+ import { classify } from "#tsgw/models/adapter/classifiers/adapter";
27
29
  import {
28
30
  catalogLabel,
29
31
  catalogDiagnostics,
30
32
  searchLabel,
31
33
  type CatalogStatus,
32
34
  } from "./status.ts";
33
- import type { ThinkingLevel, WebSearchMode } from "../models/_tools.ts";
35
+ import type { ThinkingLevel, WebSearchMode } from "#tsgw/models/_tools";
34
36
  import type { TsgwSettings } from "./config.ts";
35
37
  import { registerRefreshTool } from "./refresh-tool.ts";
36
38
 
@@ -96,36 +98,11 @@ function isTsgwTraceTarget(state: RequestState, root: string): boolean {
96
98
  }
97
99
  }
98
100
 
99
- /** 网关 id 匹配:精确匹配,或允许带供应商前缀变体(google/gemini-3.5-flash 匹配 gemini-3.5-flash)。 */
100
- function gatewayHasModel(gatewayIds: ReadonlySet<string>, id: string): boolean {
101
- if (gatewayIds.has(id)) return true;
102
- const suffix = `/${id}`;
103
- for (const gatewayId of gatewayIds)
104
- if (gatewayId.endsWith(suffix)) return true;
105
- return false;
106
- }
107
-
108
101
  /** 模型缓存文件:<agent-dir>/tsgw/models-cache.json。 */
109
102
  function gatewayModelCachePath(): string {
110
103
  return join(getAgentDir(), "tsgw", "models-cache.json");
111
104
  }
112
105
 
113
- function effectiveModelsForGateway(
114
- root: string,
115
- filter: ModelFilter | undefined,
116
- gatewayIds: ReadonlySet<string> | undefined,
117
- imagesEnabled: boolean,
118
- ): ProviderModelConfig[] {
119
- const staticModels: ProviderModelConfig[] = [
120
- ...modelsForRoot(root),
121
- ...(imagesEnabled ? imageModelsForRoot(root) : []),
122
- ];
123
- const intersected = gatewayIds
124
- ? staticModels.filter((model) => gatewayHasModel(gatewayIds, model.id))
125
- : [];
126
- return filterModels(intersected, filter);
127
- }
128
-
129
106
  /**
130
107
  * 三层模型过滤:静态目录 ∩ 网关实际列表 ∩ 用户黑白名单。
131
108
  * 无网关目录时不登记模型,避免将静态登记误认为网关可用。
@@ -135,6 +112,7 @@ async function resolveEffectiveModels(
135
112
  filter: ModelFilter | undefined,
136
113
  cacheFilePath: string,
137
114
  imagesEnabled: boolean,
115
+ classifiersEnabled: boolean,
138
116
  ): Promise<{
139
117
  models: ProviderModelConfig[];
140
118
  gatewayIds: ReadonlySet<string> | undefined;
@@ -175,7 +153,7 @@ async function resolveEffectiveModels(
175
153
  }
176
154
  }
177
155
  if (catalog.error) console.warn(`TSGW: ${catalog.error}`);
178
- const models = effectiveModelsForGateway(root, filter, gatewayIds, imagesEnabled);
156
+ const models = effectiveModelsForGateway(root, filter, gatewayIds, imagesEnabled, classifiersEnabled);
179
157
  return { models, gatewayIds, catalog: { ...catalog, count: models.length } };
180
158
  }
181
159
 
@@ -184,6 +162,7 @@ export async function registerTsgwProvider(
184
162
  ): Promise<void> {
185
163
  const root = rootForRuntime(settings.baseUrl);
186
164
  const imagesEnabled = supportsImageModels(VERSION);
165
+ const classifiersEnabled = supportsClassifierModels(VERSION);
187
166
  const defaultSearchMode: WebSearchMode =
188
167
  settings.tsSearch === "cached" || settings.tsSearch === "live"
189
168
  ? settings.tsSearch
@@ -210,6 +189,7 @@ export async function registerTsgwProvider(
210
189
  modelFilter,
211
190
  cacheFilePath,
212
191
  imagesEnabled,
192
+ classifiersEnabled,
213
193
  );
214
194
  const { models } = initial;
215
195
  let latestModels = models;
@@ -253,6 +233,7 @@ export async function registerTsgwProvider(
253
233
  apiKey: "$TSGW_API_KEY",
254
234
  models,
255
235
  ...(imagesEnabled ? { images: { [IMAGE_API]: { generateImages } } } : {}),
236
+ ...(classifiersEnabled ? { classifiers: { [CLASSIFIER_API]: { classify } } } : {}),
256
237
  async refreshModels(context) {
257
238
  // 启动获取已完成;宿主的额外自动同步不再追加联网请求。
258
239
  // 工具检查 24 小时窗口,必要时与命令一样显式传入 force。
@@ -276,7 +257,7 @@ export async function registerTsgwProvider(
276
257
  throw new Error("TSGW 刷新失败;保留上次成功获取的目录。");
277
258
  if (revision === refreshRevision) {
278
259
  startupNotice = undefined;
279
- latestModels = effectiveModelsForGateway(root, modelFilter, new Set(gateway.ids), imagesEnabled);
260
+ latestModels = effectiveModelsForGateway(root, modelFilter, new Set(gateway.ids), imagesEnabled, classifiersEnabled);
280
261
  search.sync();
281
262
  catalog = {
282
263
  count: latestModels.length,
@@ -323,7 +304,8 @@ export async function registerTsgwProvider(
323
304
  }
324
305
  const count = () => typeof ctx.modelRegistry.getModelsOfType === "function"
325
306
  ? ctx.modelRegistry.getModelsOfType("chat", PROVIDER_ID).length +
326
- ctx.modelRegistry.getModelsOfType("image", PROVIDER_ID).length
307
+ ctx.modelRegistry.getModelsOfType("image", PROVIDER_ID).length +
308
+ ctx.modelRegistry.getModelsOfType("classifier", PROVIDER_ID).length
327
309
  : ctx.modelRegistry.getAvailable().filter((model) => model.provider === PROVIDER_ID).length;
328
310
  const before = count();
329
311
  revision = refreshRevision;
@@ -1,7 +1,7 @@
1
1
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
2
  import { Type } from "typebox";
3
- import { PROVIDER_ID } from "../models/catalog.ts";
4
- import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS, readGatewayModelCacheSummary } from "../models/gateway-catalog.ts";
3
+ import { PROVIDER_ID } from "#tsgw/models/catalog";
4
+ import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS, readGatewayModelCacheSummary } from "#tsgw/models/gateway-catalog";
5
5
 
6
6
  /** 默认检查缓存时间;需要联网时复用宿主 provider 的强制刷新。 */
7
7
  export function registerRefreshTool(pi: ExtensionAPI, cacheFilePath: string): void {
@@ -1,5 +1,5 @@
1
- import type { WebSearchMode } from "../models/_tools.ts";
2
- import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS } from "../models/gateway-catalog.ts";
1
+ import type { WebSearchMode } from "#tsgw/models/_tools";
2
+ import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS } from "#tsgw/models/gateway-catalog";
3
3
 
4
4
  export interface CatalogStatus {
5
5
  count: number;
@@ -1,7 +1,7 @@
1
1
  import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
2
- import { builtinSearchSupport, resolveSearchDelegate } from "../models/web-search.ts";
3
- import type { WebSearchMode } from "../models/_tools.ts";
4
- import { searchLabel, type SearchSupport } from "../provider/status.ts";
2
+ import { builtinSearchSupport, resolveSearchDelegate } from "#tsgw/models/web-search";
3
+ import type { WebSearchMode } from "#tsgw/models/_tools";
4
+ import { searchLabel, type SearchSupport } from "#tsgw/provider/status";
5
5
  import { registerSearchProxyTool, SEARCH_PROXY_TOOL } from "./proxy.ts";
6
6
 
7
7
  interface SearchOptions {
@@ -1,9 +1,9 @@
1
1
  /** 搜索代理复用 Pi 的注册表、身份认证与协议适配器。 */
2
2
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
3
3
  import { Type } from "typebox";
4
- import { isPlainObject, type WebSearchMode } from "../models/_tools.ts";
5
- import { applyModelOperations } from "../models/operations.ts";
6
- import { builtinSearchSupport, type SearchDelegate } from "../models/web-search.ts";
4
+ import { isPlainObject, type WebSearchMode } from "#tsgw/models/_tools";
5
+ import { applyModelOperations } from "#tsgw/models/operations";
6
+ import { builtinSearchSupport, type SearchDelegate } from "#tsgw/models/web-search";
7
7
 
8
8
  export const SEARCH_PROXY_TOOL = "tsgw_search";
9
9
  interface SearchProxyOptions {
package/index.ts CHANGED
@@ -1,15 +1,15 @@
1
1
  import { VERSION, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
- import { supportsImageModels } from "./extensions/images/models.ts";
3
- import { registerPrompts } from "./extensions/prompts.ts";
4
- import { readTsgwSettings } from "./extensions/provider/config.ts";
5
- import { registerTsgwProvider } from "./extensions/provider/index.ts";
6
- import { registerUploadTool } from "./extensions/upload/index.ts";
2
+ import { supportsImageModels } from "#tsgw/models/capabilities";
3
+ import { registerPrompts } from "#tsgw/prompts";
4
+ import { readTsgwSettings } from "#tsgw/provider/config";
5
+ import { registerTsgwProvider } from "#tsgw/provider/index";
6
+ import { registerUploadTool } from "#tsgw/upload/index";
7
7
 
8
8
  /** 插件总入口:保持能力注册顺序,实现由各模块维护。 */
9
9
  export default async function registerTsgw(pi: ExtensionAPI): Promise<void> {
10
10
  registerUploadTool(pi);
11
11
  if (supportsImageModels(VERSION)) {
12
- const { registerImageTools } = await import("./extensions/images/tools.ts");
12
+ const { registerImageTools } = await import("#tsgw/images/tools");
13
13
  registerImageTools(pi);
14
14
  }
15
15
  registerPrompts(pi);
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "pi-tsgw",
3
- "version": "0.6.0",
4
- "description": "面向 TOSSP AIH gateway 的 Pi 扩展:按厂商维护聊天与图片模型目录及思考策略,支持四种聊天协议与图片生成、编辑工具。",
3
+ "version": "1.0.0",
4
+ "description": "面向 TOSSP AIH gateway 的 Pi 扩展:按厂商维护聊天与图片模型目录及思考策略,支持四种聊天协议、图片生成与编辑工具,以及原生 System One 分类模型。",
5
5
  "type": "module",
6
6
  "keywords": [
7
7
  "pi",
@@ -15,6 +15,10 @@
15
15
  "type": "git",
16
16
  "url": "git+https://github.com/tossp/pi-tsgw.git"
17
17
  },
18
+ "imports": {
19
+ "#tsgw/*": "./extensions/*.ts",
20
+ "#tsgw-prompts/*": "./prompts/*.ts"
21
+ },
18
22
  "pi": {
19
23
  "extensions": [
20
24
  "./index.ts"
@@ -24,8 +28,8 @@
24
28
  ]
25
29
  },
26
30
  "scripts": {
27
- "test": "tsc -p tsconfig.test.json && node dist/extensions/provider/index.test.js && node dist/extensions/provider/refresh-tool.test.js && node dist/extensions/provider/startup-catalog.test.js && node dist/extensions/prompts.test.js && node dist/extensions/provider/status.test.js && node dist/extensions/search/index.test.js && node dist/extensions/search/proxy.test.js && node dist/extensions/search/host-integration.test.js && node dist/extensions/provider/status-integration.test.js && node dist/extensions/models/gateway-catalog-metadata.test.js && node dist/extensions/models/gateway-catalog-policy.test.js && node dist/extensions/models/operations.test.js && node dist/extensions/models/catalog.test.js && node dist/extensions/models/web-search.test.js && node dist/extensions/models/gateway-catalog.test.js && node dist/extensions/models/gateway-catalog-isolation.test.js && node dist/extensions/models/vendor-strategies.test.js && node dist/extensions/models/grok-new.test.js && node dist/extensions/models/gemini-new.test.js && node dist/extensions/models/longcat-new.test.js && node dist/extensions/images/models.test.js && node dist/extensions/images/parameters.test.js && node dist/extensions/images/input-budget.test.js && node dist/extensions/images/edit-request.test.js && node dist/extensions/images/image-data.test.js && node dist/extensions/images/response.test.js && node dist/extensions/images/stream-response.test.js && node dist/extensions/images/adapter.test.js && node dist/extensions/images/tool-files.test.js && node dist/extensions/images/tools.test.js && node dist/extensions/images/host-integration.test.js && node dist/extensions/images/tools-host.test.js && node dist/index.test.js && node dist/extensions/skills.test.js && node dist/extensions/skill-resources.test.js && node dist/extensions/upload/protocol.test.js && node dist/extensions/upload/schema.test.js && node dist/extensions/upload/uploader.test.js && node dist/extensions/upload/transport.test.js && node dist/extensions/upload/host-integration.test.js && node dist/extensions/upload/readiness-host.test.js",
28
- "test:upload:live": "tsc -p tsconfig.test.json && node dist/extensions/upload/live.test.js"
31
+ "test": "tsc -p tsconfig.test.json && node scripts/prepare-test-runtime.mjs && node dist/extensions/provider/index.test.js && node dist/extensions/provider/refresh-tool.test.js && node dist/extensions/provider/startup-catalog.test.js && node dist/extensions/provider/classifier-host.test.js && node dist/extensions/prompts.test.js && node dist/extensions/provider/status.test.js && node dist/extensions/search/index.test.js && node dist/extensions/search/proxy.test.js && node dist/extensions/search/host-integration.test.js && node dist/extensions/provider/status-integration.test.js && node dist/extensions/models/gateway-catalog-metadata.test.js && node dist/extensions/models/gateway-catalog-policy.test.js && node dist/extensions/models/operations.test.js && node dist/extensions/models/catalog.test.js && node dist/extensions/models/web-search.test.js && node dist/extensions/models/gateway-catalog.test.js && node dist/extensions/models/gateway-catalog-isolation.test.js && node dist/extensions/models/vendor-strategies.test.js && node dist/extensions/models/grok-new.test.js && node dist/extensions/models/gemini-new.test.js && node dist/extensions/models/longcat-new.test.js && node dist/extensions/models/capabilities.test.js && node dist/extensions/models/classifier-catalog.test.js && node dist/extensions/models/adapter/classifiers/adapter.test.js && node dist/extensions/models/image-catalog.test.js && node dist/extensions/models/adapter/images/parameters.test.js && node dist/extensions/models/adapter/images/input-budget.test.js && node dist/extensions/models/adapter/images/edit-request.test.js && node dist/extensions/models/adapter/images/image-data.test.js && node dist/extensions/models/adapter/images/response.test.js && node dist/extensions/models/adapter/images/stream-response.test.js && node dist/extensions/models/adapter/images/adapter.test.js && node dist/extensions/images/tool-files.test.js && node dist/extensions/images/tools.test.js && node dist/extensions/images/host-integration.test.js && node dist/extensions/images/tools-host.test.js && node dist/index.test.js && node dist/extensions/skills.test.js && node dist/extensions/skill-resources.test.js && node dist/extensions/upload/protocol.test.js && node dist/extensions/upload/schema.test.js && node dist/extensions/upload/uploader.test.js && node dist/extensions/upload/transport.test.js && node dist/extensions/upload/host-integration.test.js && node dist/extensions/upload/readiness-host.test.js",
32
+ "test:upload:live": "tsc -p tsconfig.test.json && node scripts/prepare-test-runtime.mjs && node dist/extensions/upload/live.test.js"
29
33
  },
30
34
  "peerDependencies": {
31
35
  "@earendil-works/pi-coding-agent": ">=0.82.0",
@@ -25,7 +25,8 @@ compatibility: 需要宿主提供子代理工具及可用的 tsgw 模型。
25
25
  | 通用工程 | `gpt-6-luna` | `max` | 38 | 0.10 | 0.50 |
26
26
  | 通用工程(低成本备选) | `glm-5.3-flash` | `max` | 42 | 0.118 | 0.413 |
27
27
  | 通用工程 | `gpt-6.1-sol` | `medium` | 48 | 2.00 | 10.00 |
28
- | 按量付费补位 | `deepseek-flash` | `max` | 39 | 0.1475–0.295 | 0.59–1.18 |
28
+ | 通用工程(优先候选) | `deepseek-flash` | `high` | 待评‡ | 0.1475–0.295 | 0.59–1.18 |
29
+ | 复杂实现(优先候选) | `deepseek-flash` | `max` | 待评‡ | 0.1475–0.295 | 0.59–1.18 |
29
30
  | 复杂任务 | `gpt-6.1-sol` | `high` | 50 | 2.00 | 10.00 |
30
31
  | 高难任务 | `gpt-6.1-sol` | `xhigh` | 51 | 2.00 | 10.00 |
31
32
  | 高难任务 | `gpt-6-astra` | `high` | 51 | 10.00 | 50.00 |
@@ -35,6 +36,7 @@ compatibility: 需要宿主提供子代理工具及可用的 tsgw 模型。
35
36
  | 双模型复核专用 | `kimi-k3` | `high` | 待评 | 3.00 | 15.00 |
36
37
 
37
38
  - † MiniMax 的 29 分为模型级参考,Pi high 映射为 adaptive;待评项不借用其他型号或档位的分数。
39
+ - ‡ DeepSeek 原有 39 分不作为 1017 更新版的评分;更新版及各档位暂无本表同口径评分。
38
40
  - GLM 5.3 三型号始终思考,实际 effort 为 low/high/max;Pi medium 映射 high,xhigh 映射 max。FlashX 可作未定档备选,评分待评,输入/输出参考价为 0.295/1.0325。
39
41
  - `gpt-6.1-sol` 按用户确认的网关 Codex 接入采用 500000 tokens 上下文;最大输出仍为 128000,不与上下文窗口混淆。
40
42
  - GPT 价格对应输入 ≤272K,超过后输入 ×2、输出 ×1.5;MiniMax 输入超过 512K 为 0.60/2.40。
@@ -46,10 +48,23 @@ compatibility: 需要宿主提供子代理工具及可用的 tsgw 模型。
46
48
  LongCat 受上游额度阻塞;两款 Gemini 仅通过最小文本/工具往返,尚无本表同口径评分。
47
49
  登记不等于适合长期工程委派,不借用同族评分。
48
50
 
51
+ ## 工程任务选型补充
52
+
53
+ 代码修改、缺陷修复、补测试等常规工程任务,优先考虑 `deepseek-flash` / `high`;复杂实现使用 `max`。GLM 5.3 / Flash 仍是工程候选,结合套餐、速度与任务匹配选择,不设固定派遣路线。MiniMax、Luna 保留步骤明确的轻量执行分工。
54
+
55
+ 复杂任务选择 `gpt-6.1-sol` 时优先 `high`;仅在任务确需更深推理时考虑 `xhigh` / `max`,不把提高档位当作必然提升。通用工程的 `medium` 仍保留,Astra 与 Kimi 的审阅分工遵循下文。
56
+
57
+ 依据与适用范围:
58
+
59
+ - [DeepSeek 官方更新日志](https://api-docs.deepseek.com/updates/)(2026-10-17)确认官方 API 的 `deepseek-flash` 已升级为 V4.1 Flash-1017,并报告 DeepSWE v1.1 为 77.0%;该评测使用 Mini-SWE-V2,不是 Pi 子代理实测。
60
+ - 用户提供的 DeepSWE v1.1 通过率/每任务费用图用于工程选型参考,与上表 AA 综合能力评分分开,不混用分数,也不将某个代码评测推广为设计审阅能力排名。
61
+ - 官方 API 的别名更新不证明网关已经同步;当前未独立确认网关的具体后端版本,不将 77.0% 当作网关实测成绩,不新增猜测的模型 ID。选型模型直接参考本表及这些限制,无需自行查榜或探测版本。
62
+ - 图中每任务费用受评测框架、token 用量、定价及汇率影响,不等于本表 token 单价或用户网关实际扣费,也不保证本地任务的通过率与耗时。
63
+
49
64
  ## 必要边界
50
65
 
51
66
  - **MiniMax-M3** 只承担步骤明确的小任务。参考使用 Pi 的 high;非 off 档位均映射为 adaptive,不代表不同能力档。adaptive 不是 Pi 档位,此映射不适用于 M3.1 Flash Preview。
52
- - **deepseek-flash** 作为按量付费补位时使用 max。
67
+ - **deepseek-flash** 常规工程默认 high,复杂实现使用 max;这是选型指导,不自动切换模型、修改用户启用配置或触发付费探测。
53
68
  - **Astra 审阅档位**:架构设计、正式设计文档的独立审阅与最终复核,默认使用 `gpt-6-astra` / `max`,不因材料篇幅短或范围明确而自动降档。局部检查、定向复审可按范围降低档位。
54
69
  - **Kimi** 不承担长程执行;双模型复核固定为 **Kimi+Astra**,独立审查同一份材料。Kimi 使用 kimi-k3 / high,Astra 遵循上述审阅档位规则;其他任务的深度按任务选择。
55
70
  - 不可用的模型或档位如实说明。
@@ -1,16 +0,0 @@
1
- // 厂商型号与能力仍由 vendor 维护;图片模块提供能力入口和宿主基线判断。
2
- export {
3
- OPENAI_IMAGE_API as IMAGE_API,
4
- OPENAI_IMAGE_MODEL_IDS as IMAGE_MODEL_IDS,
5
- openaiImageModels as imageModelsForRoot,
6
- type OpenAIImageModelConfig as ImageModelConfig,
7
- } from "../models/vendors/openai.ts";
8
-
9
- /** 混合模型目录和图片实现登记以 Pi 1.2 为已验证基线;旧宿主保持聊天目录。 */
10
- export function supportsImageModels(version: string): boolean {
11
- const match = /^(\d+)\.(\d+)\.(\d+)(?:\+.*)?$/.exec(version);
12
- if (!match) return false;
13
- const major = Number(match[1]);
14
- const minor = Number(match[2]);
15
- return major > 1 || (major === 1 && minor >= 2);
16
- }