pi-tsgw 1.1.0 → 1.2.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
|
@@ -1,446 +1,28 @@
|
|
|
1
1
|
# pi-tsgw
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
(openai-completions、openai-responses、anthropic-messages、google-generative-ai),
|
|
5
|
-
并按厂商对请求体执行相应操作,使思考级别、推理格式和可选的内置网络搜索在网关上正常工作。
|
|
6
|
-
图片模型通过 Pi 原生图片 API 调度,插件适配网关的 Images 接口,不经过 MCP。
|
|
7
|
-
分类模型通过 Pi 原生 classifier API 和内置 System One 适配器调度,复用同一 tsgw 认证。
|
|
8
|
-
|
|
9
|
-
本项目不包含私有 API 密钥或网关端点。静态目录包含模型元数据和公开价格估算;
|
|
10
|
-
这些价格并非你的网关计费费率。
|
|
11
|
-
|
|
12
|
-
## 项目结构
|
|
13
|
-
|
|
14
|
-
包清单的 `pi.extensions` 指向根 `./index.ts`,作为能力装配总入口;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 索引。
|
|
17
|
-
|
|
18
|
-
```text
|
|
19
|
-
index.ts # 包总入口
|
|
20
|
-
index.test.ts # 宿主集成总测试
|
|
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/ # 分类桥接与对应测试
|
|
32
|
-
extensions/search/ # 搜索注册、代理与相邻测试
|
|
33
|
-
extensions/delegation/ # 子代理创建前分类选型、固定知识与相邻测试
|
|
34
|
-
extensions/images/ # 图片工具、schema、本地文件与宿主集成测试
|
|
35
|
-
extensions/prompts.ts # registerPrompts
|
|
36
|
-
prompts/memory.ts # 记忆提示词正文
|
|
37
|
-
extensions/upload/ # 本地上传及安全说明
|
|
38
|
-
skills/ # 随包技能
|
|
39
|
-
```
|
|
3
|
+
自用的 Pi 扩展,为 TOSSP AIH gateway 提供模型目录、请求适配、联网搜索、图片生成与编辑、分类模型及配套工作流。以 MIT 许可证公开。
|
|
40
4
|
|
|
41
5
|
## 安装
|
|
42
6
|
|
|
43
|
-
```bash
|
|
44
|
-
pi install git:github.com/tossp/pi-tsgw
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
或通过 npm 安装:
|
|
48
|
-
|
|
49
7
|
```bash
|
|
50
8
|
pi install npm:pi-tsgw
|
|
51
9
|
```
|
|
52
10
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
## 配置
|
|
11
|
+
也可使用 `pi install git:github.com/tossp/pi-tsgw`,安装后执行 `/reload`。
|
|
56
12
|
|
|
57
|
-
|
|
58
|
-
插件不读取环境变量;API 密钥仅由 Pi 自身的凭据解析机制处理。
|
|
13
|
+
## 最小配置
|
|
59
14
|
|
|
60
|
-
|
|
15
|
+
在 Pi 用户目录的 `settings.json` 中设置网关地址(默认目录为 `~/.pi/agent`):
|
|
61
16
|
|
|
62
17
|
```json
|
|
63
18
|
{
|
|
64
19
|
"tsgw": {
|
|
65
|
-
"baseUrl": "https://aih.example.
|
|
66
|
-
"tsSearch": "live",
|
|
67
|
-
"traceHeaders": false,
|
|
68
|
-
"excludeModels": ["gpt-*", "claude-*"],
|
|
69
|
-
"includeModels": ["gpt-6-*"]
|
|
20
|
+
"baseUrl": "https://aih.example.com"
|
|
70
21
|
}
|
|
71
22
|
}
|
|
72
23
|
```
|
|
73
24
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
`baseUrl` 指向你的 AIH 网关(可以是公共实例或自托管实例)。规范化时会去掉 `/v1` 后缀。
|
|
77
|
-
未设置时使用一个中性的占位根地址,该地址无法实际使用。
|
|
78
|
-
|
|
79
|
-
### API 密钥
|
|
80
|
-
|
|
81
|
-
扩展将凭据读取和解析交由 Pi 处理:
|
|
82
|
-
|
|
83
|
-
1. **`/login`** — 选择 `tsgw` 提供商并输入密钥;pi 将其存储在
|
|
84
|
-
`~/.pi/agent/auth.json` 中(推荐方式)。
|
|
85
|
-
2. **`TSGW_API_KEY` 环境变量** — 未存储凭据时由 Pi 回退使用。
|
|
86
|
-
|
|
87
|
-
初始化通过 Pi 的已存储凭据 API 校验并读取本地目录;后续刷新使用宿主提供的凭据。
|
|
88
|
-
两条解析路径不保证完全等价:仅通过环境变量认证时,初始化可能先登记零模型,
|
|
89
|
-
会话就绪后再由宿主解析凭据并恢复目录,不回退静态模型。
|
|
90
|
-
|
|
91
|
-
### 选项
|
|
92
|
-
|
|
93
|
-
| 设置(`settings.json` 中的 `tsgw.*`) | 默认值 | 含义 |
|
|
94
|
-
| --- | --- | --- |
|
|
95
|
-
| `baseUrl` | 占位地址 | 网关根地址(规范化时去掉 `/v1` 后缀) |
|
|
96
|
-
| `tsSearch` | `live` | GPT:`cached` 或 `live`;未设置、旧值 `off` 和无效值均回退到 `live`。受支持的 Grok 模型始终使用实时搜索。 |
|
|
97
|
-
| `traceHeaders` | `false` | 添加 `AH-Thread-Id` / `AH-Trace-Id` 请求头,用于网关侧追踪 |
|
|
98
|
-
| `includeModels` | 未设置 | 重新纳入的覆盖规则:匹配的模型 ID 即使也被 `excludeModels` 匹配,仍会保留(精确 ID 或 `prefix-*` 通配模式) |
|
|
99
|
-
| `excludeModels` | 未设置 | 黑名单:匹配的模型 ID 会被移除,除非通过 `includeModels` 重新纳入(精确 ID 或 `prefix-*` 通配模式) |
|
|
100
|
-
|
|
101
|
-
## 模型目录
|
|
102
|
-
|
|
103
|
-
模型规格由厂商分片(`extensions/models/vendors/`)维护。聊天目录涵盖 11 个厂商系列:
|
|
104
|
-
DeepSeek、GLM(智谱)、MiMo(小米)、MiniMax、Kimi(Moonshot)、Qwen(阿里巴巴)、
|
|
105
|
-
GPT(OpenAI)、Gemini(Google)、Claude(Anthropic)、LongCat 和 Grok(xAI)。
|
|
106
|
-
另有厂商 **TypeSafe** 的 **Jev** 分类模型系列,规格位于 `vendors/typesafe.ts`,
|
|
107
|
-
由分类能力入口单独组装,不放进聊天目录。
|
|
108
|
-
静态目录会持续调整,不代表网关实时可用模型数量。
|
|
109
|
-
厂商文件包含文档链接和元数据注意事项。别名映射、输出限制和共享思考策略并未全部
|
|
110
|
-
针对网关端点逐项验证;公开价格估算不构成计费保证。
|
|
111
|
-
MiMo 使用 `mimo-v2.6-pro` 和 `mimo-v2.6-flash`;不再注册原有 V2.5 ID。
|
|
112
|
-
请将显式模型选择或过滤规则更新为新 ID。
|
|
113
|
-
|
|
114
|
-
精选目录保留 DeepSeek `deepseek-flash` 和 V4 Pro;GLM 5.2+,以及明确例外
|
|
115
|
-
`glm-4.5-air`;MiniMax M3+;Kimi K3;GPT 6+;以及 Gemini 3.5+ 和无版本号的
|
|
116
|
-
`gemini-flash` / `gemini-pro` 别名。当前裁剪移除了 Qwen `qwen3.7-max`、`qwen3.6-plus`、
|
|
117
|
-
`qwen3.5-plus`,Claude `claude-fable-5`,以及 Grok `grok-4.20`、`grok-4.20-fast`、
|
|
118
|
-
`grok-4.3-low`、`grok-4.3-medium`、`grok-4.3-high`。Qwen 仅保留 `qwen3.7-plus` 及其
|
|
119
|
-
完整请求策略,作为厂商最后一个接入参考;它仍须命中网关目录才会登记,并非可绕过网关
|
|
120
|
-
交集的默认模型。Grok 保留 `grok-4.5` 并新增 `grok-4.7`;Claude 当前仅保留 Opus 和 Sonnet。
|
|
121
|
-
其他已移除的 ID 及其专用请求策略不再注册;即使网关仍列出这些 ID,纳入规则也无法恢复它们。
|
|
122
|
-
现有显式模型选择若引用了已移除的 ID,需要更新。
|
|
123
|
-
|
|
124
|
-
新增 `grok-4.7`、`gemini-3.5-flash-lite`、`gemini-3.8-flash-high` 和 `longcat-2.5-preview`:
|
|
125
|
-
|
|
126
|
-
| ID | 协议与端点后缀 | 思考映射 | 2026-10-17 最小真实验收 |
|
|
127
|
-
| --- | --- | --- | --- |
|
|
128
|
-
| `grok-4.7` | Responses,`/v1` | low/medium/high/xhigh;不支持 off,max→xhigh | 文本通过;函数调用未通过;原生搜索无事件/来源,故不加入搜索支持名单 |
|
|
129
|
-
| `gemini-3.5-flash-lite` | Completions,`/v1` | minimal/low/medium/high;off→minimal,xhigh/max→high | 文本、函数调用与默认工具选择下的结果往返通过;显式 tool_choice:none 的结果轮曾超时 |
|
|
130
|
-
| `gemini-3.8-flash-high` | Google,`/gemini/v1beta` | low/medium/high;off/minimal→low,xhigh/max→high | 文本、函数调用与工具结果往返通过 |
|
|
131
|
-
| `longcat-2.5-preview` | Completions,`/v1` | off 关闭,其他档开启;无已确认深度映射 | 上游额度耗尽,推理及工具验收阻塞 |
|
|
132
|
-
|
|
133
|
-
上述验收仅覆盖短文本与最小工具夹具,不代表全部模态、上下文容量或七档已逐项验证。
|
|
134
|
-
两款 Gemini 的旧 `/gemini` 路径均不可用;仅新型号按实测选择协议与版本路径,不修改旧型号。
|
|
135
|
-
3.8 的网关 ID 后缀 `high` 不作为已确认的固定档位契约;规格/价格继承官方基础型号。
|
|
136
|
-
3.8 采用截至 2026-12-31 的介绍价,2027-01-01 起应复核更新;Grok 4.7 采用输入少于
|
|
137
|
-
200K 的公开价,达到 200K 后输入、缓存与输出均加倍。LongCat 使用国内限时价并按
|
|
138
|
-
固定 0.1475 USD/CNY 折算;公开价格只用于估算,不代表网关实际计费。
|
|
139
|
-
Grok 4.7 的官方文本输出不设独立上限,目录以 500K 上下文作为输出容量上界,
|
|
140
|
-
不代表可同时填满输入与输出。LongCat 2.5 输出上限按逐型号参数页采用 256K;
|
|
141
|
-
官方快速开始仍写 128K,图像更新说明也与纯文本 API schema 存在差异,当前保守登记文本输入。
|
|
142
|
-
|
|
143
|
-
Kimi 提供 `kimi-k3` 和网关变体 `kimi-k3-256k`,后者显示为
|
|
144
|
-
**Kimi K3 (256K)**,上下文窗口为 262,144 个 token。其余元数据、价格估算和思考策略
|
|
145
|
-
继承自 K3;131,072 个 token 的输出设置与上下文大小彼此独立。
|
|
146
|
-
这些继承值不代表已逐项验证该端点,也不保证该变体的计费费率。
|
|
147
|
-
|
|
148
|
-
目录还包含 `MiniMax-M3.1-Flash-Preview`、`glm-5.3`、`glm-5.3-flash` 和
|
|
149
|
-
`glm-5.3-flashx`。这四个模型都要求启用思考:MiniMax 使用 low/medium/high/xhigh/max;
|
|
150
|
-
GLM 使用 low/high/max。模型元数据中禁用了不受支持的 `off`,过时的 off/minimal 请求
|
|
151
|
-
会映射到 low,而不是静默选择默认的 max。MiniMax 和 GLM Flash/FlashX 支持图像输入;
|
|
152
|
-
GLM 5.3 仅支持文本。注册并不证明网关支持推理或工具调用。
|
|
153
|
-
|
|
154
|
-
截至 2026-10-16 的核查,MiniMax 已公布 M3.1 Flash Preview 的订阅访问方式,
|
|
155
|
-
但未公布按 token 计费的价格。其费用字段为零表示**未知**,而非免费,因此用量费用总计
|
|
156
|
-
会遗漏其实际收费。GLM 5.3 的价格估算使用国内公开费率和现有的固定 USD/CNY 换算率;
|
|
157
|
-
临时免费的缓存存储记为零,不代表永久计费保证。
|
|
158
|
-
|
|
159
|
-
使用宽泛的 `excludeModels` 规则排除模型系列,再用精确的 `includeModels` 规则
|
|
160
|
-
重新纳入指定模型。`includeModels` 不是全局白名单:两个列表都未匹配的模型仍然可用。
|
|
161
|
-
若只想注册指定模型,使用 `"excludeModels": ["*"]`,再通过 `includeModels` 重新纳入。
|
|
162
|
-
两个列表均区分大小写,仅支持精确 ID 或末尾 `*` 前缀匹配(不支持通用通配模式);
|
|
163
|
-
请保留 `MiniMax-*` 的大小写。网关目录可用时,先与静态目录取交集,再应用过滤。
|
|
164
|
-
纳入规则无法添加未知或不可用的 ID。
|
|
165
|
-
|
|
166
|
-
插件初始化只读取本地缓存、完成 provider 注册,**不等待网络**:有可用缓存就先加载,
|
|
167
|
-
包括过期缓存;无有效缓存则先登记零个模型,不回退静态目录,也不阻塞宿主启动。
|
|
168
|
-
所有入口统一使用 **24 小时**新鲜窗口;内存与磁盘同时存在时选择获取时间更新的快照,
|
|
169
|
-
命中缓存和失败回退均不更新原始获取时间。
|
|
170
|
-
|
|
171
|
-
会话就绪且宿主允许联网后,缺少缓存或缓存过期时后台获取目录。单次请求超时 **5 秒**,
|
|
172
|
-
失败后间隔 **5 秒**重试;整轮请求与等待合计最多 **60 秒**。同进程的实例共用恢复轮次与重试序列,
|
|
173
|
-
后来加入不延长共享截止;每个实例仍以自身启动的一分钟窗口约束本地准备、等待与登记。
|
|
174
|
-
获取始终通过仍活跃实例的宿主服务执行,以保留联网许可和凭据解析。成功后各实例通过宿主同步自己的模型登记,
|
|
175
|
-
停止重试并清除异常状态。缺少凭据或认证失败直接提示,不等待一分钟;宿主禁止联网时不绕过许可。
|
|
176
|
-
一分钟内仍未获取成功则停止自动请求,通过 `ui.notify(..., "error")` 发出红色 Pi Web Toast,
|
|
177
|
-
同时保留红色异常状态。有旧目录时提示正在沿用缓存,无缓存时提示当前无可用模型。
|
|
178
|
-
同一轮失败只提醒一次;Toast 不代表用户已读,非 UI 模式使用安全日志提示。
|
|
179
|
-
会话退出或实例替换时取消恢复;不建立常驻轮询,不自动重试推理。
|
|
180
|
-
|
|
181
|
-
运行 `/tsgw-refresh` 可绕过缓存强制刷新,无需重启或重新加载 Pi;手动刷新不自动重试。
|
|
182
|
-
单个插件实例发起的后台恢复、命令和工具刷新共用一个登记调度器:同类请求合并;普通获取已经联网时,
|
|
183
|
-
后来的强制刷新复用同一请求,不再重复 GET;尚未决定读取缓存时,强制意图提升本轮网络阶段。
|
|
184
|
-
已命中缓存并完成的普通获取不能满足新的强制刷新。实际获取层也合并已进入插件的宿主回调,
|
|
185
|
-
一个调用方取消只退出自己的等待,仍有其他调用方等待时不取消共享任务。
|
|
186
|
-
Pi Web 多会话和后台 runtime 可分别加载插件;同一 JS 全局环境、同一 agent-dir 的实例
|
|
187
|
-
通过进程级服务共用原始目录与实际 GET,即使模块被重新导入也不重复建立获取任务。
|
|
188
|
-
各实例仍分别应用模型过滤与宿主能力、同步自己的登记和 UI;退出一个实例不取消其他实例的等待。
|
|
189
|
-
仅共享获取不代表所有宿主登记入口已全局串行。宿主在首次回调之前
|
|
190
|
-
自行进行的刷新重组不属于插件可观察的队列。
|
|
191
|
-
Pi Web 的目录刷新入口与聊天会话使用独立 runtime;并发获取在共享服务合并,
|
|
192
|
-
结果分别登记到对应 runtime,不把两者假设成同一个宿主刷新队列。
|
|
193
|
-
动态刷新失败保留原目录。旧版宿主若不转发强制刷新参数,未确认实际联网时只提示未完成刷新,
|
|
194
|
-
不误报成功;不提高聊天最低宿主版本。另一个会话更新缓存后,当前会话在下次目录检查时吸收更新,
|
|
195
|
-
不提供跨会话实时广播。
|
|
196
|
-
|
|
197
|
-
模型可通过 codemode 调用 `tools.tsgw_refresh_models({})` 自动获取,
|
|
198
|
-
或 `tools.tsgw_refresh_models({ force: true })` 强制刷新。
|
|
199
|
-
工具返回 `cacheFilePath`、`count` 与 `storedAt`,随后读取该文件的 `ids` 即为完整网关列表,
|
|
200
|
-
包括尚未静态登记的型号;不会把完整列表重复塞入工具返回值,也不会自动登记未知型号。
|
|
201
|
-
工具每次都经宿主刷新流程同步当前目录,缓存是否可用统一由 provider 判断。
|
|
202
|
-
返回的文件必须属于当前配置且对应已应用的完整快照;强制刷新时要求本次写入。
|
|
203
|
-
取消、获取失败或未确认落盘时,不会把旧文件报成本次刷新成功。
|
|
204
|
-
|
|
205
|
-
插件仅注册一个 `tsgw` provider,使用一个当前密钥。缓存文件固定为
|
|
206
|
-
`<agent-dir>/tsgw/models-cache.json`,不提供多配置或多槽位管理。
|
|
207
|
-
网关地址与密钥仅以 SHA-256 摘要校验,避免更换配置后误用旧缓存,不存储明文凭据。
|
|
208
|
-
旧版无摘要缓存会被忽略,并在获取成功后替换。
|
|
209
|
-
进程内请求排序可防止较晚返回的结果覆盖更新的缓存写入;这不是跨进程锁机制。
|
|
210
|
-
|
|
211
|
-
## 原生图片生成
|
|
212
|
-
|
|
213
|
-
Pi 1.2+ 可在现有 `tsgw` provider 中注册 `gpt-image-2.5-flare` 和
|
|
214
|
-
`gpt-image-2.5-sunburst` 两个 `type: image` 模型。它们复用相同的 `baseUrl`、TSGW
|
|
215
|
-
凭据及 `$TSGW_API_KEY`;由 Pi 宿主解析 `options.apiKey`。图片目录受静态目录、网关目录
|
|
216
|
-
与 `includeModels` / `excludeModels` 的交集及过滤规则约束;不会自动登记裸别名
|
|
217
|
-
`gpt-image-2.5` 或其他图片模型。需要按前缀纳入时可用 `"includeModels": ["gpt-image-2.5*"]`,
|
|
218
|
-
但 include 不能突破目录交集。
|
|
219
|
-
|
|
220
|
-
图片能力提供两个直接工具:`tsgw_generate_image` 从文字生成图片,`tsgw_edit_image` 使用原图和可选蒙版编辑。
|
|
221
|
-
它们共用宿主 `modelRegistry.generateImages()` 和同一图片适配器,不要求启用 codemode。
|
|
222
|
-
默认使用 Sunburst 生成一张 PNG,草稿任务可选 Flare;质量、尺寸、格式、压缩、数量、背景及流式参数可按需覆盖。
|
|
223
|
-
工具返回图片和保存原始字节的临时路径;编辑支持本地文件、图片 URL/data URI 或上游文件 ID。
|
|
224
|
-
图片模型不进入聊天选择器或搜索代理。原生 codemode 调用仍可用;调用、文件权限、超时及结果边界见
|
|
225
|
-
[图片生成维护与使用说明](extensions/images/README.md);该说明描述工具与文件层,协议实现位于 `extensions/models/adapter/images/`。
|
|
226
|
-
|
|
227
|
-
随包 [tsgw-image-generation](skills/tsgw-image-generation/SKILL.md) 技能提供生成、编辑、模型选型和参数示例;
|
|
228
|
-
可以直接描述需要的图片,也可使用 `/skill:tsgw-image-generation` 显式加载技能。
|
|
229
|
-
|
|
230
|
-
图片价格显示为 0 表示尚未映射准确价格,不是免费;usage 只统计上游已报告的有效 tokens。
|
|
231
|
-
隔离测试不替代真实网关对各参数、编辑、流式和图片展示的逐项验收。
|
|
232
|
-
|
|
233
|
-
## 原生分类模型
|
|
234
|
-
|
|
235
|
-
厂商为 **TypeSafe**,模型系列为 **Jev**。Pi 1.2.0 及以上稳定版本登记
|
|
236
|
-
`jev-latest`、`jev-preview` 两个 `type: classifier` 模型,复用现有 `tsgw` provider、网关根地址及宿主认证,端点为 `/v1/systemone`。
|
|
237
|
-
旧宿主不登记分类模型,聊天最低兼容版本不变。不将 Jev 放入聊天选择器、图片目录或搜索代理候选;
|
|
238
|
-
它们和其他模型一样受静态目录、网关目录交集及 `includeModels` / `excludeModels` 过滤约束。
|
|
239
|
-
仅登记这两个已验收 ID,不登记 `Kev-4B`、`SemIf` 或 Luna 的 Decisions 身份。
|
|
240
|
-
|
|
241
|
-
通过宿主 codemode 调用(需启用 codemode;不需要新增 MCP 服务):
|
|
242
|
-
|
|
243
|
-
```javascript
|
|
244
|
-
const model = await models.getModelOfType("classifier", "tsgw", "jev-latest");
|
|
245
|
-
if (!model) throw new Error("分类模型未登记,请检查网关目录和过滤配置。");
|
|
246
|
-
const result = await models.classify(model, {
|
|
247
|
-
state: { message: "订单被重复扣款,请今天处理。" },
|
|
248
|
-
questions: {
|
|
249
|
-
urgent: { type: "bool", instructions: "是否需要今天处理?",
|
|
250
|
-
criteria: { true: "今天处理", false: "可以等待" } },
|
|
251
|
-
department: { type: "choice", instructions: "由哪个团队处理?",
|
|
252
|
-
criteria: { billing: "付款和退款", technical: "故障", other: "其他" } },
|
|
253
|
-
severity: { type: "score", instructions: "严重程度如何?",
|
|
254
|
-
criteria: ["轻微", "有替代方案", "完全阻塞"] },
|
|
255
|
-
},
|
|
256
|
-
});
|
|
257
|
-
text(result.stopReason === "stop" ? result.answers : { error: result.errorMessage });
|
|
258
|
-
```
|
|
259
|
-
|
|
260
|
-
扩展也可直接调用 `ctx.modelRegistry.classify()`,不依赖 codemode。bool 映射为线上的
|
|
261
|
-
`noul` 并返回成立概率;choice 返回选项、概率分布与置信度;score 返回从 0 开始的等级
|
|
262
|
-
索引期望值(可以是小数),不是整数标签。分类适配由 `extensions/models/adapter/classifiers/adapter.ts`
|
|
263
|
-
桥接宿主内置 SystemOne,登记能力门位于 `extensions/models/capabilities.ts`;适配器不复制 HTTP 或结果解析,
|
|
264
|
-
始终禁用自动重试、不自动换模型,错误只输出脱敏摘要,调用者应检查 `stopReason`。
|
|
265
|
-
|
|
266
|
-
当前仅声明文本输入,总请求窗口采用官方 64,000 tokens;官方单题窗口为 32K,不能把总窗口
|
|
267
|
-
当作每题预算。未开启实验图片或长上下文。输入参考价为 $0.042/百万 tokens、输出参考价
|
|
268
|
-
为零(2026-10-18,来源:[TypeSafe Models](https://docs.typesafe.ai/models),资料见 Blinko 950),
|
|
269
|
-
不代表网关实际扣费。usage 保留上游实际报告的 tokens,不因输出参考价为零就抹去输出量。
|
|
270
|
-
两 ID 都是可移动别名,不推定网关底层版本。此前短文本 bool/choice/score 已经宿主原生
|
|
271
|
-
解析验收;不代表长上下文、中文质量或概率校准已验收。隔离回归不替代真实能力验证。
|
|
272
|
-
|
|
273
|
-
## 状态栏与会话控制
|
|
274
|
-
|
|
275
|
-
支持 `command:/…` 状态的 Pi Web 客户端会将其渲染为可点击按钮;终端 CLI 显示状态文本,
|
|
276
|
-
并接受相同命令:
|
|
277
|
-
|
|
278
|
-
- **`TSGW · N`**(`/tsgw`):在同一菜单中**刷新模型目录**和**查看诊断信息**。
|
|
279
|
-
数量表示过滤后已注册的聊天、图片与分类目录条目数,而非健康推理端点的数量。
|
|
280
|
-
🟢 表示新鲜的目录结果;🟡 表示静态/过期目录;🔴 表示获取失败;⚠️ 表示缺少凭据或网关配置;
|
|
281
|
-
⏳ 表示正在刷新。
|
|
282
|
-
- **内置联网**(`/tsgw-search`):GPT 仅为当前会话提供 `cached / live`,默认为 `live`。
|
|
283
|
-
受支持的 Grok 模型固定使用实时搜索:此命令只显示提示,不提供选择器,也不改变 GPT
|
|
284
|
-
的会话模式。其他 TSGW 模型通过 `tsgw_search` 使用**委托搜索**,前提是有效目录中
|
|
285
|
-
仍有支持搜索的模型。状态显示 `代理`(live)或 `代理缓存`(cached);对其他提供商隐藏。
|
|
286
|
-
|
|
287
|
-
对于原生 GPT 或 GPT 委托模型,输入 `/tsgw-search cached` 或 `/tsgw-search live`;
|
|
288
|
-
不再接受 `off`。这些控制不会修改 `settings.json`,也不会在重新加载或新会话后保留;
|
|
289
|
-
`tsgw.tsSearch` 仍是启动默认值。现有 `cached` 配置会保留;未设置、旧值 `off` 和
|
|
290
|
-
无效配置现在均默认使用 `live`。
|
|
291
|
-
|
|
292
|
-
注入仍仅限于现有的模型/协议支持列表。GPT Responses 追加一个 `web_search` 工具
|
|
293
|
-
(`cached` 时 `external_web_access` 为 false,`live` 时为 true);Grok Completions
|
|
294
|
-
追加 `search_parameters: { mode: "on" }`。绝不覆盖现有搜索工具/字段。
|
|
295
|
-
此设置不控制 Qwen 的厂商策略、外部工具或思考模式,也不是全局网络访问开关。
|
|
296
|
-
|
|
297
|
-
当当前 TSGW 模型缺少原生搜索能力时,插件会启用 `tsgw_search`:当前模型用搜索问题
|
|
298
|
-
调用它,由支持搜索的模型执行内置网络搜索,再将答案/来源返回当前模型。
|
|
299
|
-
对话模型不会改变。仅发送问题,不发送会话历史或本地工具。原生搜索模型不暴露此代理工具。
|
|
300
|
-
|
|
301
|
-
委托模型从过滤后的有效目录中选择,优先顺序为 **GPT 6 Luna**,其次是 GPT 6 Sol、
|
|
302
|
-
GPT 6.1 Sol、GPT 6 Astra,然后是受支持的 Grok 模型。没有候选模型时搜索不可用。
|
|
303
|
-
推理失败会直接报告,不会静默改用更昂贵的模型重试。每次工具调用都会额外产生一次模型请求,
|
|
304
|
-
以及网关可能收取的搜索费用。GPT 委托模型遵循 `cached/live`;Grok 委托模型始终实时搜索。
|
|
305
|
-
此工具由当前模型按需调用,不会在每条用户消息后自动搜索。
|
|
306
|
-
|
|
307
|
-
委托搜索要求 `modelRegistry.streamSimple`(已在 Pi 1.1.0 上测试)。
|
|
308
|
-
它复用 Pi 的注册表认证和适配器,包括 token 用量/费用统计;不会自行解析 HTTP 响应或凭据。
|
|
309
|
-
委托请求不继承主会话的请求/请求头钩子(包括 `traceHeaders`)。
|
|
310
|
-
可用时从适配器流元数据中收集来源 URL;同时也会要求搜索模型提供链接。
|
|
311
|
-
状态显示或请求成功都不能证明端点确实执行了搜索或返回了可靠引用。
|
|
312
|
-
不会恢复旧的 `ts_search` 工具。`ts_oht.search` 等外部工具仍然独立。
|
|
313
|
-
|
|
314
|
-
诊断信息显示目录来源、最初获取时间、缓存新鲜度、配置是否存在以及安全的刷新错误摘要,
|
|
315
|
-
绝不显示 API 密钥或 URL。诊断不会额外发起网络请求。状态会随会话/模型活动和目录刷新更新;
|
|
316
|
-
不会在后台轮询健康状态。
|
|
317
|
-
|
|
318
|
-
图标使用 Emoji/Unicode:Pi Web 目前会移除命令按钮中的 ANSI 颜色。
|
|
319
|
-
会话忙碌时按钮不可用。终端 CLI 以文本显示相同状态;请在那里使用斜杠命令。
|
|
320
|
-
Pi Web 可能要等会话运行时启动后才显示扩展状态。
|
|
321
|
-
|
|
322
|
-
## 随包技能
|
|
323
|
-
|
|
324
|
-
| 技能 | 用途 |
|
|
325
|
-
| --- | --- |
|
|
326
|
-
| [tsgw-image-generation](skills/tsgw-image-generation/SKILL.md) | 通过两个图片工具生成或编辑图片,按草稿/成稿选择模型,并说明默认值和完整可选参数。 |
|
|
327
|
-
| [tsgw-git-commit](skills/tsgw-git-commit/SKILL.md) | 暂存内容核验、分批提交与中文提交说明;包含支持 worktree 的只读仓库发现脚本。 |
|
|
328
|
-
| [tsgw-github](skills/tsgw-github/SKILL.md) | 使用 gh 查询与维护 issue、PR、CI,安全发布正文并核验 Actions 升级。 |
|
|
329
|
-
| [tsgw-mk-docs](skills/tsgw-mk-docs/SKILL.md) | 需求、设计、执行计划、术语和状态证据的文档治理,含参考清单与模板,不依赖审阅插件。 |
|
|
330
|
-
| [tsgw-programmer-go](skills/tsgw-programmer-go/SKILL.md) | Go 编码与审查;自产 JSON 使用 PascalCase、零值省略优先 omitzero,真实变更中同步迁移相关旧标签。 |
|
|
331
|
-
| [tsgw-smemo](skills/tsgw-smemo/SKILL.md) | Blinko 共享知识的检索、沉淀与维护,含原有维护授权和操作参考。 |
|
|
332
|
-
|
|
333
|
-
技能从本地维护的工作流整理并适配 Pi,按本项目 MIT 许可证提供;不包含第三方 gitmoji 数据集。
|
|
334
|
-
项目规则和用户授权优先,不安装 Git hook,不自动推送或发布。已有同类用户级技能时,建议择一启用,避免重复指导。
|
|
335
|
-
|
|
336
|
-
### 子代理编排与模型选型
|
|
337
|
-
|
|
338
|
-
本包附带精简的 [tsgw-delegate-model-selection](skills/tsgw-delegate-model-selection/SKILL.md)。
|
|
339
|
-
Pi 1.2+ 在兼容的 `model-only Agent` 执行前,**只对新建且未指定模型的调用分类一次**:
|
|
340
|
-
主代理直接提交任务提示词,插件使用内置选型知识补入 `Agent.model`,随后继续原工具执行。
|
|
341
|
-
不需要主代理读取长表、编写分类代码或收到分类结果后再派遣一次。
|
|
342
|
-
|
|
343
|
-
分类器从生效的 `tsgw` 文本分类目录动态选择,不固定 ID;按已知非零输入+输出参考价排序,
|
|
344
|
-
未知/零价排后,同价按 provider/ID 字典序。聊天候选取已维护模型/档位与生效目录及会话范围的交集,
|
|
345
|
-
分类后再次校验。价格只是参考,不是网关实扣价。分类增加一次请求的耗时和费用。
|
|
346
|
-
|
|
347
|
-
显式 `model`、`resume`、结果查询、补充指令及后续轮次不介入,不运行中换模型。
|
|
348
|
-
固定 Kimi+Astra 双审由主代理分别显式指定 `tsgw/kimi-k3:high`、`tsgw/gpt-6-astra:max`;
|
|
349
|
-
正式架构/设计文档独立审阅默认 Astra/max。任务拆分、依赖、并行、权限和验收仍由主代理负责。
|
|
350
|
-
分类失败、未决、取消、无候选或选定模型失效时,阻止本次自动创建并提示显式指定模型,
|
|
351
|
-
不静默使用父模型、不自动重试或换分类器;分类等待最多 15 秒,材料上限 28 KiB,超限不截断任务。
|
|
352
|
-
|
|
353
|
-
原 `Agent` 的调用 ID、宿主调度和子会话关联保持不变;工具结果附选型摘要,
|
|
354
|
-
`details.tsgwDelegation` 保留追踪信息,已报告分类用量合入原工具 `usage`。
|
|
355
|
-
选型知识和原参考表已迁入 [创建前选型维护说明](extensions/delegation/README.md) 与 `policy.ts`,
|
|
356
|
-
不要求主代理查榜或读取维护资料。隔离回归不证明真实选型质量或 Pi Web 展示已验收。
|
|
357
|
-
|
|
358
|
-
安装并执行 `/reload` 后,Pi 会通过包清单发现随包技能,除非宿主/包设置禁用或过滤了技能。
|
|
359
|
-
可以使用 `/skill:tsgw-git-commit` 等命令显式加载;仅加载根 `index.ts` 不会加载包内技能。
|
|
360
|
-
包设置中的 `skills: []` 可禁用全部技能,`skills: ["skills/tsgw-git-commit"]` 可仅加载指定技能,
|
|
361
|
-
或用 `skills: ["!skills/tsgw-git-commit/**"]` 排除该技能;由宿主处理,不是 `tsgw` 配置项。
|
|
362
|
-
|
|
363
|
-
模型选型需要兼容的子代理工具及可用的 `tsgw` 分类/聊天模型;旧宿主或无兼容工具时不挂接自动选型。
|
|
364
|
-
图片生成技能需要 Pi 1.2+、图片工具与可用的 `tsgw` 图片模型。通用开发技能不绑定模型 provider。
|
|
365
|
-
禁用随包技能不会关闭扩展中的创建前选型钩子;显式指定 `Agent.model` 可跳过选型。
|
|
366
|
-
本包不提供子代理工具,也不改变调度设置、用户规则文件或宿主权限。
|
|
367
|
-
|
|
368
|
-
### 记忆规则注入
|
|
369
|
-
|
|
370
|
-
常驻提示词正文集中在 `prompts/`,与扩展注册入口分开维护。提示词由 `extensions/prompts.ts` 的
|
|
371
|
-
`registerPrompts` 统一注册;记忆提示词正文位于 `prompts/memory.ts`。
|
|
372
|
-
|
|
373
|
-
插件在 `before_agent_start` 中注入原用户规则中的记忆体系与既有条目维护授权,
|
|
374
|
-
不绑定当前模型 provider,不新增配置,不改写用户规则文件。
|
|
375
|
-
详细流程保留在 `tsgw-smemo` 技能及其参考资料中;`ctx_memory` 仍称为“系统记忆”,
|
|
376
|
-
smemo/Blinko 仍称为“记忆系统”。技能迁移不操作 Blinko 数据或改变宿主认证与权限。
|
|
377
|
-
从本地 `smemo` 迁入时,确认新版本插件与随包技能加载生效后,再移除原技能和用户规则中的重复内容。
|
|
378
|
-
|
|
379
|
-
## MCP 服务配置
|
|
380
|
-
|
|
381
|
-
插件不再自动登记 `ts_oht` 或 `ts_tool`,也不会自动写入任何配置。需要使用时,请由用户自行在
|
|
382
|
-
`~/.pi/agent/mcp.json` 配置;以下示例保留服务原名、原 URL,并以 `codemode` 暴露:
|
|
383
|
-
|
|
384
|
-
```json
|
|
385
|
-
{
|
|
386
|
-
"mcpServers": {
|
|
387
|
-
"ts_oht": {
|
|
388
|
-
"url": "https://xn--oht.cc/mcp",
|
|
389
|
-
"exposure": "codemode"
|
|
390
|
-
},
|
|
391
|
-
"ts_tool": {
|
|
392
|
-
"url": "https://mcp.tossp.com/mm/ts/mcp",
|
|
393
|
-
"exposure": "codemode"
|
|
394
|
-
}
|
|
395
|
-
}
|
|
396
|
-
}
|
|
397
|
-
```
|
|
398
|
-
|
|
399
|
-
Pi 宿主管理 MCP 连接、OAuth 登录和凭据;可通过设置页或 `pi mcp login ts_oht` /
|
|
400
|
-
`pi mcp login ts_tool` 完成登录。迁移时保持相同名称和精确 URL 可复用已有认证记录;
|
|
401
|
-
记录失效时仍需重新授权。旧的 `tsgw.mcpUrl` 已移除,不再生效。配置变更后请重新加载或重启。
|
|
402
|
-
插件不自建 MCP
|
|
403
|
-
客户端或认证逻辑,不读写 `mcp.json` / `mcp-auth.json`,也不携带凭据。
|
|
404
|
-
上传工具仍复用宿主已连接且可调用的 `ts_oht`,不会自行连接或绕过禁用、权限及认证状态。
|
|
405
|
-
|
|
406
|
-
## 本地文件上传
|
|
407
|
-
|
|
408
|
-
`upload_local_file` 工具使用已连接的 `ts_oht` MCP 进行签名,将 Pi 宿主上已获授权的文件
|
|
409
|
-
直接上传到 S3。它支持单次 PUT 和流式分片上传、显式恢复、自定义下载有效期,
|
|
410
|
-
以及 inline/attachment 链接。它使用宿主管理的连接,不存储凭据。
|
|
411
|
-
|
|
412
|
-
上传功能要求宿主支持 `ctx.executeTool`(已在 Pi 1.1.0 和 1.2.0 上测试),
|
|
413
|
-
且 `ts_oht` 上传工具可调用。在 Pi 1.2+ 上,`reachesTools` 允许宿主在发现/重连期间
|
|
414
|
-
等待这两个依赖;旧宿主仍要求工具已经连接。它不会绕过禁用的工具、权限或认证。
|
|
415
|
-
文件访问使用宿主操作系统权限,而非沙箱。在含有敏感文件的环境中启用前,
|
|
416
|
-
请阅读[上传用法与安全边界](extensions/upload/README.md)。
|
|
417
|
-
|
|
418
|
-
## 开发
|
|
419
|
-
|
|
420
|
-
```bash
|
|
421
|
-
npm ci
|
|
422
|
-
npm test
|
|
423
|
-
npm exec -- tsc -p tsconfig.json
|
|
424
|
-
npm pack --dry-run --json
|
|
425
|
-
```
|
|
426
|
-
|
|
427
|
-
Pi 作为开发依赖安装;锁文件定义测试基线(Pi SDK 1.2.0,结构约束(schema)测试使用 TypeBox 1.3.37)。
|
|
428
|
-
SDK 保留其自身的 TypeBox 1.3.27 验证器,因此不假设结构约束构造与宿主验证使用相同版本。
|
|
429
|
-
Pi AI/MCP 显式列为开发依赖,供类型检查和测试使用;分类功能运行时通过 Pi 宿主的
|
|
430
|
-
loader 映射复用其内置 AI adapter,不由插件安装或携带第二份实现。未新增运行时依赖,
|
|
431
|
-
提供商的对等依赖最低版本保持不变。
|
|
432
|
-
测试使用临时代理目录隔离配置和凭据。单元测试使用模拟宿主;宿主集成测试通过真实 Pi SDK
|
|
433
|
-
加载扩展并模拟 HTTP 响应,不发起生产请求。它们不验证上游推理、原生搜索结果或 Pi Web
|
|
434
|
-
渲染效果。升级 Pi 后请运行完整测试套件。
|
|
435
|
-
|
|
436
|
-
## 技术细节
|
|
437
|
-
|
|
438
|
-
- [厂商配置](https://github.com/tossp/pi-tsgw/tree/main/extensions/models/vendors):模型元数据、兼容性标志和思考映射。
|
|
439
|
-
- [请求操作](https://github.com/tossp/pi-tsgw/blob/main/extensions/models/operations.ts):写时复制分派;DeepSeek/Claude 响应仍由 Pi 的适配器处理。
|
|
440
|
-
- [内置搜索](https://github.com/tossp/pi-tsgw/blob/main/extensions/models/web-search.ts):精确的模型/协议支持范围和仅追加注入。
|
|
441
|
-
- [扩展总入口](https://github.com/tossp/pi-tsgw/blob/main/index.ts):包加载入口;[provider 集成](https://github.com/tossp/pi-tsgw/tree/main/extensions/provider):注册、配置、刷新、命令和生命周期快照。延迟执行的请求回调不得访问过期的会话上下文。
|
|
442
|
-
- [图片协议实现](extensions/models/adapter/images/) 与 [分类桥接](extensions/models/adapter/classifiers/):图片六个协议文件与分类适配器;工具注册与参数 schema 仍位于 [images](extensions/images/),[能力门](extensions/models/capabilities.ts) 判定图片与分类各自的宿主最低版本。
|
|
443
|
-
- [提示词注册](https://github.com/tossp/pi-tsgw/blob/main/extensions/prompts.ts):`registerPrompts` 统一入口;记忆正文位于 `prompts/memory.ts`。
|
|
25
|
+
将占位地址替换为实际网关地址,通过 `/login` 选择 `tsgw` 配置密钥,然后执行 `/reload`。
|
|
26
|
+
使用 `/tsgw` 查看目录状态,`/tsgw-refresh` 强制刷新。图片与分类能力需要 Pi 1.2+。
|
|
444
27
|
|
|
445
|
-
|
|
446
|
-
`AGENTS.md` 中的开发规则仅用于仓库,不属于 npm 包。
|
|
28
|
+
开发维护约定见 [AGENTS.md](https://github.com/tossp/pi-tsgw/blob/main/AGENTS.md)。
|
|
@@ -42,7 +42,7 @@ export function normalizeRoot(value = DEFAULT_ROOT): string {
|
|
|
42
42
|
return url.toString().replace(/\/$/, "");
|
|
43
43
|
}
|
|
44
44
|
|
|
45
|
-
/**
|
|
45
|
+
/** 模型黑白名单不区分大小写。`exclude` 负责排除;`include` 可拉回匹配项(拉回优先)。 */
|
|
46
46
|
export interface ModelFilter {
|
|
47
47
|
include?: readonly string[];
|
|
48
48
|
exclude?: readonly string[];
|
|
@@ -55,7 +55,11 @@ function matches(pattern: string, id: string): boolean {
|
|
|
55
55
|
}
|
|
56
56
|
|
|
57
57
|
function compilePatterns(patterns: readonly string[]): (id: string) => boolean {
|
|
58
|
-
|
|
58
|
+
const normalizedPatterns = patterns.map((pattern) => pattern.toLowerCase());
|
|
59
|
+
return (id) => {
|
|
60
|
+
const normalizedId = id.toLowerCase();
|
|
61
|
+
return normalizedPatterns.some((pattern) => matches(pattern, normalizedId));
|
|
62
|
+
};
|
|
59
63
|
}
|
|
60
64
|
|
|
61
65
|
/** 按“拉回优先”语义过滤模型目录;无过滤条件时原样返回。 */
|
|
@@ -6,18 +6,20 @@ import { type PayloadWriter, type ThinkingApplier, type ThinkingLevel } from "..
|
|
|
6
6
|
* MiniMax 系列。
|
|
7
7
|
* 国内官方依据:
|
|
8
8
|
* https://platform.minimaxi.com/docs/api-reference/text-chat (输出上限)
|
|
9
|
-
* 2026-10-
|
|
9
|
+
* 2026-10-20 正式版 M3.1 核验(不能关闭思考,支持五档思考深度):
|
|
10
10
|
* https://platform.minimax.cn/docs/guides/text-generation
|
|
11
11
|
* https://platform.minimax.cn/docs/api-reference/text-openai-api
|
|
12
12
|
* https://platform.minimax.cn/docs/api-reference/text-chat (最大输出 524288)
|
|
13
|
-
*
|
|
13
|
+
* https://platform.minimax.cn/docs/pricing/overview (正式版输入/输出/缓存读取 ¥1/4/0.1 每百万词元)
|
|
14
|
+
* 按项目固定 0.1475 USD/CNY 折算,公开估价不代表网关实扣;未列缓存写入价用零占位。
|
|
15
|
+
* 旧 Preview ID 保留原规格与未知零价,不将正式版价格追溯应用到预览版。
|
|
14
16
|
*/
|
|
15
17
|
export function minimaxModels(root: string): ProviderModelConfig[] {
|
|
16
18
|
const v1 = `${root}/v1`;
|
|
17
19
|
return [
|
|
18
|
-
{
|
|
19
|
-
id
|
|
20
|
-
name:
|
|
20
|
+
...["MiniMax-M3.1-Flash", "MiniMax-M3.1-Flash-Preview"].map((id): ProviderModelConfig => ({
|
|
21
|
+
id,
|
|
22
|
+
name: id,
|
|
21
23
|
api: "openai-completions",
|
|
22
24
|
baseUrl: v1,
|
|
23
25
|
reasoning: true,
|
|
@@ -31,12 +33,13 @@ export function minimaxModels(root: string): ProviderModelConfig[] {
|
|
|
31
33
|
max: "max",
|
|
32
34
|
},
|
|
33
35
|
input: ["text", "image"],
|
|
34
|
-
|
|
35
|
-
|
|
36
|
+
cost: id === "MiniMax-M3.1-Flash"
|
|
37
|
+
? { input: 0.1475, output: 0.59, cacheRead: 0.01475, cacheWrite: 0 }
|
|
38
|
+
: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
|
36
39
|
contextWindow: 1000000,
|
|
37
40
|
maxTokens: 524288,
|
|
38
41
|
compat: OPENAI_COMPLETIONS_COMPAT,
|
|
39
|
-
},
|
|
42
|
+
})),
|
|
40
43
|
{
|
|
41
44
|
id: "MiniMax-M3",
|
|
42
45
|
name: "MiniMax-M3",
|
|
@@ -73,6 +76,7 @@ function applyMiniMax31(writer: PayloadWriter, level: ThinkingLevel): void {
|
|
|
73
76
|
}
|
|
74
77
|
|
|
75
78
|
export const minimaxThinking = {
|
|
79
|
+
"MiniMax-M3.1-Flash": (w, c) => applyMiniMax31(w, c.thinkingLevel),
|
|
76
80
|
"MiniMax-M3.1-Flash-Preview": (w, c) => applyMiniMax31(w, c.thinkingLevel),
|
|
77
81
|
"MiniMax-M3": (w, c) => applyMiniMax(w, c.thinkingLevel),
|
|
78
82
|
} satisfies Record<string, ThinkingApplier>;
|
package/package.json
CHANGED
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
# 创建前子代理选型
|
|
2
|
-
|
|
3
|
-
`index.ts` 在 Pi 1.2+ 接入兼容的 `model-only Agent`,`policy.ts` 承载固定问题、模型/思考档位候选和必要校验。主模型仍负责拆任务、权限、依赖、后台执行方式及验收;插件只补新建时的模型参数,不创建或管理子会话。
|
|
4
|
-
|
|
5
|
-
## 执行边界
|
|
6
|
-
|
|
7
|
-
- 只处理顶层 `Agent` 新建、没有非空 `model`、没有非空 `resume` 的调用。显式模型、续接、查询、steer、嵌套调用及子代理内部轮次不参与。`session_start` 通过公共 `getEntries()` 识别 Pi Web 的 `pi-web:subagent` custom 标记,子会话不注入用法或选型;普通 fork 的 `parentSession` 不作为角色证据。该标记是 Pi Web 宿主约定,不冒称适用于所有子代理宿主。
|
|
8
|
-
- 不新增工具,也不经 `ctx.executeTool` 嵌套调用 `Agent`。保留原调用 ID、任务提示词、档案、后台/隔离选项及宿主生命周期。
|
|
9
|
-
- 固定分类请求直接使用已有任务提示词和少量调用元数据;不发送会话历史,不读 `input_files` 内容,不要求主模型编写问题或代码。分类材料超过 28 KiB 时阻止自动创建,不截断原任务。
|
|
10
|
-
- 候选来自生效的 `tsgw` 聊天目录,并在配置了会话模型范围时进一步取交集;范围显式指定的思考档位同样限制候选。仅使用已维护的候选/档位,复用宿主支持档位判断。目录可用不等于端点健康。
|
|
11
|
-
- 分类器从生效的 `tsgw` 文本分类目录动态选择:已知非零输入+输出参考价较低者优先,未知/零价排后,同价按 provider/ID 字典序确定;不按目录数组顺序、不固定模型 ID。价格用于确定性选择,不代表网关实扣价。
|
|
12
|
-
- 一次分类同时给出任务类型和候选选择。不按未经校准的置信度阈值、复杂度分数或 AA 分数自动映射档位;无法判断选择 `unresolved`。
|
|
13
|
-
- 正式架构/设计文档独立审阅只接受 Astra/max。固定 Kimi+Astra 双审必须由主代理分别显式指定模型,不由一次分类发明额外子任务。自然语言类型判断仍是模型判断,不将其宣传成形式化安全保证。
|
|
14
|
-
- 分类与目录查询共享 15 秒取消窗口;无自动重试、无失败换模型。缺分类器、无候选、失败、未决、取消或选定模型已撤下时阻止本次自动创建,提示显式指定模型;不会静默使用父模型。分类成功后再次验证目录及档位。
|
|
15
|
-
- 原 `Agent` 的结果追加选型摘要,`details.tsgwDelegation` 记录分类器、目标模型、任务类型、耗时或安全错误原因;不保存原始分类响应、地址或凭据。已报告用量合入原工具 `usage`,不是重复计算子代理用量。
|
|
16
|
-
- 钩子原地修改参数后宿主不重新做 schema 验证,因此候选/档位由插件校验。后续钩子能看到选型后的参数并可阻止执行;更早的钩子不会自动重跑,不声称已经重做全部权限判断。
|
|
17
|
-
- 会话退出/重载中止本实例等待,迟到结果不能派遣;原 `Agent` 仍决定前台取消、后台任务和完成通知的语义。插件不让后台子代理随分类阶段的 signal 误停。
|
|
18
|
-
|
|
19
|
-
## 维护选型知识
|
|
20
|
-
|
|
21
|
-
以下是从原技能迁入的参考资料,不要求主代理读取。运行时使用 `policy.ts` 的提炼描述和有效候选,不逐次查榜或探测后端。更新模型目录/档位/选型依据时同步检查策略、这里的资料与简短技能说明;只给逻辑变化补测试,不锁定正文措辞或表格快照。
|
|
22
|
-
|
|
23
|
-
评分为原技能采用的 AA Intelligence Index v4.3.2 原始分;参考价格单位为美元/百万 tokens,不是订阅扣费。尚未验证这些排序能提升本地派遣质量。
|
|
24
|
-
|
|
25
|
-
| 任务等级 | 模型 | Pi 思考档位 | 参考评分 | 输入价 | 输出价 |
|
|
26
|
-
| --- | --- | --- | ---: | ---: | ---: |
|
|
27
|
-
| 轻量执行 | `MiniMax-M3` | high | 29† | 0.30 | 1.20 |
|
|
28
|
-
| 轻量执行 | `gpt-6-luna` | high | 33 | 0.10 | 0.50 |
|
|
29
|
-
| 通用工程 | `glm-5.3` | low | 34 | 1.18 | 4.13 |
|
|
30
|
-
| 通用工程 | `glm-5.3` | high | 待评 | 1.18 | 4.13 |
|
|
31
|
-
| 通用工程 | `glm-5.3` | max | 45 | 1.18 | 4.13 |
|
|
32
|
-
| 通用工程 | `gpt-6-luna` | max | 38 | 0.10 | 0.50 |
|
|
33
|
-
| 通用工程低成本备选 | `glm-5.3-flash` | max | 42 | 0.118 | 0.413 |
|
|
34
|
-
| 通用工程 | `gpt-6.1-sol` | medium | 48 | 2.00 | 10.00 |
|
|
35
|
-
| 通用工程优先候选 | `deepseek-flash` | high | 待评‡ | 0.1475–0.295 | 0.59–1.18 |
|
|
36
|
-
| 复杂实现优先候选 | `deepseek-flash` | max | 待评‡ | 0.1475–0.295 | 0.59–1.18 |
|
|
37
|
-
| 复杂任务 | `gpt-6.1-sol` | high | 50 | 2.00 | 10.00 |
|
|
38
|
-
| 高难任务 | `gpt-6.1-sol` | xhigh | 51 | 2.00 | 10.00 |
|
|
39
|
-
| 高难任务 | `gpt-6-astra` | high | 51 | 10.00 | 50.00 |
|
|
40
|
-
| 高难任务 | `gpt-6-astra` | xhigh | 52 | 10.00 | 50.00 |
|
|
41
|
-
| 极难任务 | `gpt-6.1-sol` | max | 52 | 2.00 | 10.00 |
|
|
42
|
-
| 极难任务、正式设计审阅 | `gpt-6-astra` | max | 53 | 10.00 | 50.00 |
|
|
43
|
-
| 双审专用,显式指定 | `kimi-k3` | high | 待评 | 3.00 | 15.00 |
|
|
44
|
-
|
|
45
|
-
- † MiniMax M3 的 high 映射为 adaptive;非 off 档位不代表不同能力档。29 分为模型级参考,不推广到 M3.1 Flash Preview。只派步骤明确的小任务。
|
|
46
|
-
- ‡ DeepSeek 旧 39 分不用于 1017 更新版。原资料为 2026-10-16 核对的国内价(Blinko 604):输入 1–2 元、输出 4–8 元,固定按 0.1475 USD/CNY 折算;区间为低谷/高峰价,静态目录采用高端,不按时段切换。高峰为北京时间工作日(不含法定假期)9–12、14–18。
|
|
47
|
-
- GLM 原资料为 Blinko 929,采用相同换算率。GLM 5.3 low/high/max 三档始终思考,medium 映射 high、xhigh 映射 max;FlashX 是未定档备选,不据此自动加入固定候选。FlashX 参考价 0.295/1.0325。
|
|
48
|
-
- GPT 价对应输入 ≤272K,超过后输入 ×2、输出 ×1.5;MiniMax 输入超过 512K 为 0.60/2.40。上下文大小不等于输出上限;`gpt-6.1-sol` 的网关 Codex 上下文为 500000,最大输出 128000。
|
|
49
|
-
- DeepSeek 常规工程优先 high、复杂实现优先 max。Sol 复杂任务优先 high,只有确需深入推理才选 xhigh/max,不保证升档提升。Astra 正式架构/设计文档独立审阅和最终复核默认 max,局部检查不等同正式审阅。
|
|
50
|
-
- Kimi 不承担长程执行;双模型复核固定 Kimi/high+Astra/max,独立审阅同一材料,不由自动单次选型决定是否新增第二个子任务。
|
|
51
|
-
- 原选型依据包括 [DeepSeek 官方更新日志](https://api-docs.deepseek.com/updates/)(2026-10-17)的 V4.1 Flash-1017 及 DeepSWE v1.1 77.0%(Mini-SWE-V2)。这是官方评测,既非 AA 同口径综合分,也非 Pi 或网关实测。官方别名更新不证明网关后端已同步;每任务费用不等于本表 token 单价,不承诺本地通过率/耗时。
|
|
52
|
-
- `grok-4.7`、`gemini-3.5-flash-lite`、`gemini-3.8-flash-high`、`longcat-2.5-preview` 不进入自动候选:Grok 工具往返未通过,LongCat 受额度阻塞,两款 Gemini 仅最小文本/工具往返,尚无本表同口径依据。登记不等于长期工程选型资格。
|
|
53
|
-
|
|
54
|
-
## 验证
|
|
55
|
-
|
|
56
|
-
纯策略与钩子测试使用合成注册表。宿主集成使用真实 Pi SDK/加载器/认证/分类 adapter 和模拟 HTTP、合成 `model-only Agent` 执行器;不启动付费分类或真实子会话,不读取个人配置。隔离测试不能替代真实网关选型质量、子会话创建或 Pi Web UI 验收。
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
# 图片生成与编辑
|
|
2
|
-
|
|
3
|
-
本目录维护 `tsgw` 的两个直接图片工具、参数 schema 与本地文件处理。工具通过 Pi 模型注册表和供应商认证,调用 `extensions/models/adapter/images/` 的同一套请求/响应实现,不另建凭据解析或 HTTP SDK。
|
|
4
|
-
|
|
5
|
-
## 入口与模型
|
|
6
|
-
|
|
7
|
-
- `tsgw_generate_image`:从文字生成图片,只有 `prompt` 必填。
|
|
8
|
-
- `tsgw_edit_image`:根据 `prompt` 和 `images` 编辑图片,`mask` 可选且对应第一张参考图。
|
|
9
|
-
- 两个工具默认直接向模型声明,不要求启用 codemode;仅 Pi 1.2.0 或更高稳定版登记,旧宿主保持聊天能力,不提高最低 peer。
|
|
10
|
-
- 只登记 `gpt-image-2.5-flare` 和 `gpt-image-2.5-sunburst` 两款 `type: image` 模型,输入为文本/图片,输出为图片。草稿/速度优先选 Flare,成稿/质量优先选 Sunburst;工具默认 Sunburst,不自动选择另一型号重试。
|
|
11
|
-
- 图片目录仍取静态目录与网关目录的交集,再应用 include/exclude。`includeModels: ["gpt-image-2.5*"]` 不能突破交集;图片不进入聊天模型选择器或联网代理候选。
|
|
12
|
-
|
|
13
|
-
工具输入示例及完整可选参数表见随包[图片技能](../../skills/tsgw-image-generation/SKILL.md)。技能用于任务选型与参数使用,不代替实际工具执行;图片目录是否登记由 `extensions/models/capabilities.ts` 的版本门判定。
|
|
14
|
-
|
|
15
|
-
## 请求与参数
|
|
16
|
-
|
|
17
|
-
生成使用 `POST /v1/images/generations`;编辑使用 `POST /v1/images/edits` 的 JSON `images[]` / `mask` 引用形式。不创建上游 Files 对象,不自动改用 multipart 重试。两种请求沿用 provider 的 `baseUrl`,由宿主解析现有 TSGW 认证并传入 `options.apiKey`。
|
|
18
|
-
|
|
19
|
-
默认值是使用便利,不是功能限制:
|
|
20
|
-
|
|
21
|
-
- `quality`、`size`、`background`、`moderation` 默认 `auto`;`n` 默认 1,可选 1–10。
|
|
22
|
-
- `output_format` 默认 `png`,也支持 `jpeg` / `webp`;JPEG/WebP 可用 `output_compression: 0..100`,省略采用上游默认 100。PNG 不发送压缩参数,透明背景不能配 JPEG。
|
|
23
|
-
- `quality` 支持 `auto/low/medium/high/xhigh/max`。尺寸支持 auto 或符合上游边长、像素、16 倍数和宽高比条件的 `宽x高`;超过 3686400 像素为上游实验范围。
|
|
24
|
-
- `stream` 默认 false;`partial_images` 默认 0,仅流式时可指定 0–3。流式响应中的过程图不计作额外生成图;当前接口返回最终图片,不承诺 Pi Web 渐进预览。
|
|
25
|
-
- `safety_identifier` 默认省略,最多 128 字符;`user` 仅为上游废弃字段兼容保留。不自动采集或生成用户身份。
|
|
26
|
-
- `response_format`、`style`、`standard/hd` 是旧模型字段或取值,不混入这两款能力;`input_fidelity` 没有两款 2.5 的明确支持证据,不据共享 schema 自动开放。
|
|
27
|
-
|
|
28
|
-
未知参数、无效取值和冲突组合在请求前报错。`onPayload` 可改变有效参数,序列化后仍核对实际发送内容和端点边界,不允许换模型、把生成悄悄变成编辑或绕过验证。
|
|
29
|
-
|
|
30
|
-
## 原图、蒙版与本地权限
|
|
31
|
-
|
|
32
|
-
每个 `images[]` 或 `mask` 来源必须且只能选择一种:
|
|
33
|
-
|
|
34
|
-
- `{ path: "source.png" }`:Pi 主机本地普通文件,相对路径按 `ctx.cwd` 解析;直接读取原始字节,不经内置 `read` 的缩放或转码。
|
|
35
|
-
- `{ image_url: "https://…" }`:无用户名密码的 HTTP(S) URL,或 PNG/JPEG/WebP 的 base64 data URI。
|
|
36
|
-
- `{ file_id: "file-…" }`:调用方已有的上游图片文件 ID。
|
|
37
|
-
|
|
38
|
-
参考图 1–16 张,保持顺序。蒙版不占参考图张数;可读取的蒙版须有 alpha 通道,并与第一张图的尺寸、格式匹配。
|
|
39
|
-
|
|
40
|
-
本地文件和内联图片每个严格小于 50 MB,参考图与蒙版合计不超过 100 MB;这是插件资源预算,不代表上游最大业务容量。只读普通文件,核对读取前后身份与大小;不修改输入、不转码或丢弃透明通道。URL/file_id 交上游解析,不在插件内下载,无法本地检查的尺寸/蒙版条件由上游验证。
|
|
41
|
-
|
|
42
|
-
文件读取及外传由图片工具整体和宿主工具钩子控制,使用 Pi 进程的操作系统权限,**不等于内置 read 的审批或文件沙箱**。输入引用可能含临时签名,结果和普通错误不复述这些值。
|
|
43
|
-
|
|
44
|
-
## 原生程序化入口
|
|
45
|
-
|
|
46
|
-
原生 `models.generateImages(model, context)` 仍可用,只有两个参数。`context.tsgw` 是本插件增加的供应商参数,不是 Pi 通用 ImagesContext 的标准字段;TypeScript 调用方可使用 `TsgwImagesContext` 类型。
|
|
47
|
-
|
|
48
|
-
```js
|
|
49
|
-
// @options: {"timeout_ms": 660000}
|
|
50
|
-
const model = await models.getModelOfType("image", "tsgw", "gpt-image-2.5-sunburst");
|
|
51
|
-
const result = await models.generateImages(model, {
|
|
52
|
-
input: [{ type: "text", text: "横版水墨山水,远山薄雾,一叶扁舟,不要文字" }],
|
|
53
|
-
tsgw: { quality: "high", size: "1536x1024", output_format: "webp", output_compression: 85 },
|
|
54
|
-
});
|
|
55
|
-
if (result.stopReason !== "stop") throw new Error(result.errorMessage);
|
|
56
|
-
for (const block of result.output) if (block.type === "image") image(block);
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
原生 `input` 的图片块用于参考图编辑,也可使用 `tsgw.images` 的上游引用;两者不能同时提供。显式 `tsgw.operation` 为 `generate` / `edit`,省略时按是否有参考图决定;工具始终明确指定操作。蒙版通过 `tsgw.mask` 提供。原生调用不直接读取本地 path,读取原文件由工具层负责。
|
|
60
|
-
|
|
61
|
-
codemode 原生桥接不传第三参数,不会通过修改 model 对象转发参数。宿主 SDK 的 `ctx.modelRegistry.generateImages()` 仍可在 options 中传 `timeoutMs`、signal 和钩子。
|
|
62
|
-
|
|
63
|
-
## 超时、输出与用量
|
|
64
|
-
|
|
65
|
-
请求默认 600000ms,可通过工具的 `timeout_ms` 或 SDK 的 `options.timeoutMs` 显式缩短或延长,最大不超过 Node timer 范围。codemode 包装脚本应留余量,例如默认请求配 660000ms;它不是请求超时参数。取消、超时或失败都不自动重试或改用其他模型,也不保证上游停止处理或计费。
|
|
66
|
-
|
|
67
|
-
成功结果包含实际图片块和原始文件临时路径。原始文件以唯一临时目录、排他创建写入,不覆盖用户文件;保存失败保留上游用量及可用图片,明确区别“生成成功但保存失败”。预览进入会话后可能由宿主缩放/转码;后续精确编辑应使用保存的原始文件。
|
|
68
|
-
|
|
69
|
-
响应读取有界:普通 JSON 按每张 32 MiB 预算扩展,流式按单事件 32 MiB 及总流预算控制。返回图片单边不超过 3840,总像素不超过 8294400。PNG/JPEG/WebP 校验容器、必要头、尺寸等;PNG 保留 CRC 验证,不声称完整解码压缩像素流。JPEG 接受常见 Huffman 顺序/渐进编码,WebP 不接受动画容器。
|
|
70
|
-
|
|
71
|
-
usage 仅取上游报告的有效 tokens;坏图、断流等失败路径仍尽量保留已报告用量。多图 SSE 的逐事件用量是否共享、累计或重复汇总尚无明确契约,工具以 `usage_reports` 保留有效报告并标注 `usage_note`,不相加、不当作请求总量计入会话,也不因计量不明而丢弃有效图片;原生结果以 `tsgwUsage` 携带此扩展信息。图片价格 0 表示未映射准确价格,不表示免费。模型登记、参数注入和合成 SDK 测试都不等于真实端点、全部组合或 UI 行为验收。
|
|
72
|
-
|
|
73
|
-
## 维护与验证
|
|
74
|
-
|
|
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` 全局,不将模块加载与能力登记混为一谈。
|
|
78
|
-
|
|
79
|
-
接口与模型证据见记忆系统 942;用户确认网关编辑端点兼容,不替代本插件新组合的独立验收。测试不读取个人配置或请求真实网关,真实推理另需授权。
|
|
@@ -1,128 +0,0 @@
|
|
|
1
|
-
# 本地文件上传
|
|
2
|
-
|
|
3
|
-
`upload_local_file` 是一个本地 Pi 工具。它编排宿主现有的 `ts_oht.upload_file` 和
|
|
4
|
-
`ts_oht.get_file_url` MCP 工具,然后将原始字节以流式方式直接传输到返回的 S3 目标。
|
|
5
|
-
不会引入新的 MCP 服务器/客户端、S3 SDK、运行时依赖、MCP 密钥存储或 S3 凭据。
|
|
6
|
-
|
|
7
|
-
## 要求与授权
|
|
8
|
-
|
|
9
|
-
- Pi 需支持 `ctx.executeTool`(已在 1.1.0 和 1.2.0 上测试)。本包较低的提供商兼容性
|
|
10
|
-
最低版本不代表承诺在旧宿主上支持上传。
|
|
11
|
-
- 插件不自动登记 `ts_oht`。使用上传前,用户需自行在 `~/.pi/agent/mcp.json` 配置
|
|
12
|
-
`ts_oht`(`https://xn--oht.cc/mcp`,`codemode`),示例及 `ts_tool` 配置见根目录
|
|
13
|
-
[README](../../README.md#MCP-服务配置)。Pi 宿主管理连接和 OAuth;上传工具仅通过
|
|
14
|
-
`reachesTools` 声明其两个上传/URL 依赖。在 Pi 1.2+ 上,宿主可在执行父工具前等待这些
|
|
15
|
-
依赖的 MCP 连接/发现或重连。旧宿主忽略此提示,仍要求工具已经连接。隐藏、禁用、被阻止
|
|
16
|
-
或失败的工具仍不可用;插件不会启用它们、创建自己的连接,或读取/修改 MCP 配置。
|
|
17
|
-
就绪不等于通过认证或获得权限。
|
|
18
|
-
- 要求当前服务的 `mode` / `uploads[]` 协议约定。不支持仅有 `uploadUrl` 的旧协议约定。
|
|
19
|
-
- 工具使用 Pi 进程的操作系统文件权限,而非沙箱或内置 `read` 工具的路径审批。
|
|
20
|
-
授权的是**文件外传**,而非仅读取。必要时在权限扩展中管控 `upload_local_file`;
|
|
21
|
-
外层工具和嵌套 MCP 调用都会经过宿主权限钩子。
|
|
22
|
-
- 路径属于插件所在的机器/容器,不一定是浏览器所在的计算机。相对路径以会话 cwd 为基准;
|
|
23
|
-
`~/` 展开为宿主的主目录。符号链接解析为其规范路径对应的普通文件;
|
|
24
|
-
目录/设备/FIFO 会被拒绝。不存在隐式的仅限 cwd 白名单。
|
|
25
|
-
- 服务器声明规划/完成操作的时限为 300 秒。必要时将宿主 MCP 超时配置为至少 330 秒。
|
|
26
|
-
插件无法逐次调用覆盖该配置,也绝不编辑用户设置。宿主默认值可能更早结束调用。
|
|
27
|
-
本地 330 秒 MCP 截止时限约束的是嵌套 MCP 等待,不约束远端工作或宿主执行前的就绪等待。
|
|
28
|
-
在 Pi 1.2 的隔离空闲 `ctx.executeTool` 测试中,取消不会立即结束就绪等待;
|
|
29
|
-
发现完成后,宿主会阻止已取消的父工具执行。不要将取消理解为远端任务已取消。
|
|
30
|
-
|
|
31
|
-
## 工具接口
|
|
32
|
-
|
|
33
|
-
```ts
|
|
34
|
-
upload_local_file({
|
|
35
|
-
path: string,
|
|
36
|
-
contentType?: string,
|
|
37
|
-
expiresIn?: number, // 整数,范围 1–604800;默认 86400
|
|
38
|
-
disposition?: "inline" | "attachment", // 默认 inline
|
|
39
|
-
resume?: string // 失败调用返回的原样恢复凭条
|
|
40
|
-
})
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
`contentType` 不得包含 charset 或其他参数。默认值尽力根据扩展名映射,无法匹配时
|
|
44
|
-
回退到 `application/octet-stream`;这不是内容嗅探。程序读取真实大小和时间戳,
|
|
45
|
-
绝不从模型提供的参数中获取这些值。文件名必须满足服务的 UTF-8 名称限制。
|
|
46
|
-
结构约束(schema)与 MIME 语法/长度以及恢复凭条的 base64url 字符集/长度保持一致;
|
|
47
|
-
运行时验证仍会检查凭条内容、文件身份和远端协议。
|
|
48
|
-
|
|
49
|
-
Pi 在规范化/强制类型转换后验证工具参数。在 Pi 1.1/1.2 宿主集成测试中,
|
|
50
|
-
`expiresIn: "3600"` 变为 `3600`,`expiresIn: 1.5` 变为 `1`,可选的 `null` 字段会被移除。
|
|
51
|
-
直接调用业务逻辑会拒绝非整数有效期,但无法拒绝已被宿主转换的原始小数。
|
|
52
|
-
结构约束并不保证对原始输入进行严格验证。
|
|
53
|
-
|
|
54
|
-
- 1 字节至 32 MiB:读取有界快照,并发送一次原始 PUT。
|
|
55
|
-
- 超过 32 MiB、直至服务当前 5 TiB 安全上限:最多使用 **3 个并发工作单元**流式传输返回的
|
|
56
|
-
分片范围,不会将整个文件或整个大分片缓存在内存中。后端可能施加更低限制;
|
|
57
|
-
这个极限大小是协议边界,不表示端点一定接受或具备相应性能。
|
|
58
|
-
- 验证模式、key/uid、分片布局、分片编号唯一性、大小、HTTP 方法、请求头和有效期。
|
|
59
|
-
仅剩一个分片的计划仍属于分片上传。
|
|
60
|
-
- 不跟随重定向,不自动重试 PUT。目标必须使用端口 443 上的公共 HTTPS。
|
|
61
|
-
每次 PUT 都会检查并固定 DNS 地址;拒绝私有/本地目标、凭据类/逐跳请求头及非 PUT 方法。
|
|
62
|
-
下载与上传目标必须同源。
|
|
63
|
-
- 所有分片 PUT 完成后,使用相同元数据调用 `upload_file` **一次**,核对状态并完成上传。
|
|
64
|
-
只有服务返回的 `uploaded:true` 才算分片对象已完成。不使用自动完成循环。
|
|
65
|
-
- 默认请求会复用服务提供的 24 小时 inline URL,前提是它仍有效。
|
|
66
|
-
attachment/自定义有效期(或默认链接已过期)仅在上传成功后通过 `get_file_url` 签名。
|
|
67
|
-
|
|
68
|
-
预签名 PUT 的截止时限同时受签名有效期和按大小确定的总超时约束。用户取消会停止本地 PUT,
|
|
69
|
-
并等待所有工作单元结束后才释放文件/锁。取消 MCP **不保证**服务端工作被取消。
|
|
70
|
-
插件不重试 MCP 调用;宿主传输层可以独立重连/重新认证。
|
|
71
|
-
|
|
72
|
-
## 失败与显式恢复
|
|
73
|
-
|
|
74
|
-
结果包含 `uploaded`(`true`、`false`,或结果未知时的 `null`)、`uploadStatus`、
|
|
75
|
-
`phase`、`linkStatus` 和安全的错误信息。绝不能仅因收到 key 或签名 URL 就认定上传已完成。
|
|
76
|
-
|
|
77
|
-
| 情况 | 结果 / 恢复方式 |
|
|
78
|
-
| --- | --- |
|
|
79
|
-
| 输入无效、文件缺失或 MCP 不可用 | 报错;不自动连接、不改用其他认证方式、不重试 |
|
|
80
|
-
| 分片失败、超时或取消 | 停止该批次;已知时保留 `key`、`uid` 和 `resume`;不自动重新签名或重试 |
|
|
81
|
-
| 完成响应丢失 | 结果未知,而非失败;显式恢复时先检查原有 key |
|
|
82
|
-
| 上传成功但链接签名失败 | `uploaded:true`、`linkStatus:failed`;保留 key 和 resume;仍有效的默认链接标记为 `fallback`,而非所请求的链接 |
|
|
83
|
-
| 单次 PUT 结果未知 | 恢复时仅检查旧 key;绝不重复 PUT 或请求新对象 |
|
|
84
|
-
|
|
85
|
-
恢复时,使用返回的 `resume` 凭条、原始路径和所需链接选项再次调用同一工具。
|
|
86
|
-
凭条包含元数据/身份信息和对象 key,**不含 URL、凭据或文件内容**。
|
|
87
|
-
它是不透明的恢复记录,不是认证令牌。不要编辑它,也不要丢弃它后盲目重新上传。
|
|
88
|
-
|
|
89
|
-
恢复时首先为旧 key 调用 `get_file_url`。若对象存在,则直接返回链接,不读取/重新上传文件
|
|
90
|
-
(即使本地文件之后已被删除也可用)。只有远端明确返回 `not-found`,才允许继续未完成的
|
|
91
|
-
分片上传。其他错误会使结果保持未知。已完成上传的对象若被删除,不会重新创建。
|
|
92
|
-
|
|
93
|
-
分片恢复要求文件的规范路径、设备/inode、大小、mtime、ctime 和内容类型仍然一致。
|
|
94
|
-
服务按原始元数据重新规划,仅返回缺失的分片。客户端要求 **key 和 uid 均与原先相同**,
|
|
95
|
-
才会发送字节。如果服务已不再保留旧任务,可能在此次查询中创建不同的计划;
|
|
96
|
-
客户端会拒绝该计划且不上传字节,并由服务器现有清理机制处理它。
|
|
97
|
-
服务端没有按 uid 恢复的端点,因此无法避免此规划副作用。
|
|
98
|
-
|
|
99
|
-
工具在流式传输各范围前后以及完成上传前检查文件身份和时间戳。这能检测常规修改,
|
|
100
|
-
但不能防范恶意时间戳伪造;对可变的大文件而言,它不构成内容哈希或快照保证。
|
|
101
|
-
不要修改正在上传的文件。源文件变化会阻止完成操作;客户端绝不会自行删除或中止对象/任务。
|
|
102
|
-
服务端清理机制仍可能独立核对并处理已上传的分片。
|
|
103
|
-
|
|
104
|
-
进程内元数据锁防止通过此模块发起的调用相互重叠,包括已超时的宿主调用仍在收尾期间。
|
|
105
|
-
它**不是**跨进程/客户端锁。恢复前请停止其他客户端,并等待尚未结束的 PUT 完成。
|
|
106
|
-
服务器在所有获授权客户端之间共享存储桶访问权限;不存在按用户隔离对象的机制。
|
|
107
|
-
|
|
108
|
-
## 链接、存储与验证
|
|
109
|
-
|
|
110
|
-
下载 URL 是临时持有者凭据。任何持有链接的人都能访问对象。工具结果会有意包含所请求的链接,
|
|
111
|
-
但插件绝不记录签名 URL、请求头、原始 MCP 结果或网络错误,也绝不将恢复状态持久化到磁盘。
|
|
112
|
-
宿主会话记录和受信任的工具钩子可以看到工具结果;处理/导出时请据此采取措施。
|
|
113
|
-
`inline` 可在存储域名下执行 HTML 等活动内容;必要时使用 `attachment`。
|
|
114
|
-
|
|
115
|
-
私有临时存储桶中的对象会在约七天后清理。重新签名 URL 不会延长对象保留时间;
|
|
116
|
-
对象删除/凭据过期可能导致链接早于其标示的有效期失效。
|
|
117
|
-
|
|
118
|
-
自动化测试分别检查原始结构约束、真实宿主的输入规范化,以及实际成功/失败/恢复输出是否符合结构约束。
|
|
119
|
-
就绪测试延迟真实的 JSON-RPC 发现响应,覆盖冷启动、重连、连接失败、已禁用服务器和取消。
|
|
120
|
-
测试使用合成文件以及隔离的宿主/MCP 测试环境;绝不使用个人配置或生产网关。
|
|
121
|
-
真实端点验证必须获得明确授权,并与模拟宿主测试分开报告。
|
|
122
|
-
|
|
123
|
-
获得授权后,`TSGW_UPLOAD_LIVE=1 npm run test:upload:live` 会运行真实 Pi SDK,
|
|
124
|
-
使用宿主现有的 `ts_oht` 配置/认证和本地测试模型(不发送推理请求)。
|
|
125
|
-
它创建两个小文件和一个 33 MiB 的分片对象,验证下载内容的 SHA-256、inline/attachment
|
|
126
|
-
和自定义有效期,中断一个分片批次,并在显式恢复前模拟完成响应丢失。
|
|
127
|
-
它不修改客户端/服务器配置,也不删除远端对象;由现有服务器保留策略清理它们。
|
|
128
|
-
本地测试文件和内存中的会话状态会被丢弃。不打印任何签名链接。
|