pi-tsgw 1.5.1 → 1.5.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.
- package/README.md +3 -1
- package/extensions/delegation/index.ts +1 -4
- package/extensions/delegation/policy.ts +1 -1
- package/extensions/images/tool-schema.ts +7 -7
- package/extensions/images/tools.ts +6 -8
- package/extensions/models/adapter/images/adapter.ts +3 -3
- package/extensions/models/capabilities.ts +1 -1
- package/extensions/search/proxy.ts +1 -1
- package/extensions/upload/index.ts +4 -5
- package/package.json +5 -5
- package/skills/tsgw-image-generation/SKILL.md +26 -109
- package/skills/tsgw-model-test/SKILL.md +1 -1
- package/skills/tsgw-smemo/SKILL.md +6 -37
package/README.md
CHANGED
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
|
|
5
5
|
## 安装
|
|
6
6
|
|
|
7
|
+
需要 Pi 1.2.0 或以上稳定版。
|
|
8
|
+
|
|
7
9
|
```bash
|
|
8
10
|
pi install npm:pi-tsgw
|
|
9
11
|
```
|
|
@@ -23,7 +25,7 @@ pi install npm:pi-tsgw
|
|
|
23
25
|
```
|
|
24
26
|
|
|
25
27
|
将占位地址替换为实际网关地址,通过 `/login` 选择 `tsgw` 配置密钥,然后执行 `/reload`。
|
|
26
|
-
使用 `/tsgw` 查看目录状态,`/tsgw-refresh`
|
|
28
|
+
使用 `/tsgw` 查看目录状态,`/tsgw-refresh` 强制刷新。
|
|
27
29
|
|
|
28
30
|
`/insagent` 显式安装标准子代理:覆盖当前定义,删除已退出清单的 `tsgw-*.md`,在代理目录的 `settings.json` 中启用 Agent 并停用 Pi Web 内置代理,最后自动重载当前会话;其他自定义代理和无关设置保留。
|
|
29
31
|
|
|
@@ -230,10 +230,7 @@ export function registerDelegation(pi: ExtensionAPI): void {
|
|
|
230
230
|
if (decision.status === "selected") {
|
|
231
231
|
const sourceType = decision.selectionSource?.type === "chat" ? "聊天模型" : "分类模型";
|
|
232
232
|
summary = `TSGW 创建前选型:${decision.model};选型来源:${sourceType} ${decision.selectionSource?.model}`;
|
|
233
|
-
summary += "
|
|
234
|
-
summary += `;${event.isError ? "原 Agent 调用未成功。" : "已交由原 Agent 执行。"}`;
|
|
235
|
-
if ((decision.classifier ? 1 : 0) + (decision.chatModels?.length ?? 0) > 1)
|
|
236
|
-
summary += " 并行用量仅累计汇总前已报告部分;取消不保证远端停止处理或计费。";
|
|
233
|
+
if (event.isError) summary += ";Agent 调用未成功。";
|
|
237
234
|
summary += selectionErrorsText(decision);
|
|
238
235
|
} else {
|
|
239
236
|
summary = failureText(decision);
|
|
@@ -42,7 +42,7 @@ export interface DelegationCandidate {
|
|
|
42
42
|
|
|
43
43
|
function candidateInstructions(row: (typeof DELEGATION_KNOWLEDGE)[number]): string {
|
|
44
44
|
return `模型:${row.id},思考档位:${row.level}。` +
|
|
45
|
-
`任务适用性:${row.suitability}
|
|
45
|
+
`任务适用性:${row.suitability}。思考投入与成本特征:${row.effort}。` +
|
|
46
46
|
`参考成本:输入 ${row.inputPrice} 美元/百万 tokens,输出 ${row.outputPrice} 美元/百万 tokens。` +
|
|
47
47
|
row.note;
|
|
48
48
|
}
|
|
@@ -9,32 +9,32 @@ const IMAGE_MODELS = ["gpt-image-2.5-sunburst", "gpt-image-2.5-flare"] as const;
|
|
|
9
9
|
const optional = <T extends import("typebox").TSchema>(schema: T) => Type.Optional(Type.Union([schema, Type.Null()]));
|
|
10
10
|
|
|
11
11
|
export const imageSourceSchema = Type.Union([
|
|
12
|
-
Type.Object({ path: Type.String({ minLength: 1, description: "Pi 主机本地普通文件;相对路径以会话 cwd
|
|
12
|
+
Type.Object({ path: Type.String({ minLength: 1, description: "Pi 主机本地普通文件;相对路径以会话 cwd 为基准。" }) }, { additionalProperties: false }),
|
|
13
13
|
Type.Object({ image_url: Type.String({ minLength: 1, description: "无用户名密码的 HTTP(S) URL,或 PNG/JPEG/WebP 的 base64 data URI。本工具不下载远程 URL。" }) }, { additionalProperties: false }),
|
|
14
14
|
Type.Object({ file_id: Type.String({ minLength: 1, description: "上游已有图片的文件 ID。" }) }, { additionalProperties: false }),
|
|
15
15
|
], { description: "恰好一个来源:path、image_url 或 file_id;不可混用。" });
|
|
16
16
|
|
|
17
17
|
// Type.Enum 仅输出 enum;Moonshot 拒绝联合分支中缺 type 的枚举,使用宿主显式 string 表达。
|
|
18
18
|
const common = {
|
|
19
|
-
prompt: Type.String({ minLength: 1, maxLength: 32_000, description: "
|
|
19
|
+
prompt: Type.String({ minLength: 1, maxLength: 32_000, description: "图片生成或编辑要求。" }),
|
|
20
20
|
model: Type.Optional(StringEnum(IMAGE_MODELS, { description: "默认 gpt-image-2.5-sunburst,适合成稿;AI 草稿任务可选 gpt-image-2.5-flare,常配 quality=low。" })),
|
|
21
21
|
quality: optional(StringEnum(["auto", "low", "medium", "high", "xhigh", "max"], { description: "质量,默认 auto;选择 Flare 不会自动改为 low。" })),
|
|
22
22
|
size: optional(Type.String({ description: "默认 auto;也可宽x高,均为16倍数、边≤3840、宽高比≤3、像素655360..8294400。" })),
|
|
23
23
|
background: optional(StringEnum(["auto", "opaque", "transparent"], { description: "背景,默认 auto。透明背景需 PNG/WebP。" })),
|
|
24
24
|
output_format: optional(StringEnum(["png", "jpeg", "webp"], { description: "输出格式,默认 png;原始字节不转码。" })),
|
|
25
25
|
output_compression: optional(Type.Integer({ minimum: 0, maximum: 100, description: "仅用于 JPEG/WebP 的压缩质量;省略采用上游默认100。" })),
|
|
26
|
-
n: optional(Type.Integer({ minimum: 1, maximum: 10, description: "
|
|
26
|
+
n: optional(Type.Integer({ minimum: 1, maximum: 10, description: "返回图片数量,默认1。" })),
|
|
27
27
|
moderation: optional(StringEnum(["auto", "low"], { description: "审核强度,默认 auto。" })),
|
|
28
|
-
stream: optional(Type.Boolean({ description: "
|
|
28
|
+
stream: optional(Type.Boolean({ description: "是否使用流式响应,默认 false;仅返回最终图片。" })),
|
|
29
29
|
partial_images: optional(Type.Integer({ minimum: 0, maximum: 3, description: "仅 stream=true 时使用;默认0。最终仅返回完成图。" })),
|
|
30
|
-
safety_identifier: optional(Type.String({ maxLength: 128, description: "
|
|
30
|
+
safety_identifier: optional(Type.String({ maxLength: 128, description: "可选安全标识。" })),
|
|
31
31
|
user: optional(Type.String({ description: "已废弃的上游 user 参数,仅为兼容保留。" })),
|
|
32
|
-
timeout_ms: Type.Optional(Type.Number({ minimum: 0, maximum: MAX_IMAGE_TIMEOUT_MS, description: "
|
|
32
|
+
timeout_ms: Type.Optional(Type.Number({ minimum: 0, maximum: MAX_IMAGE_TIMEOUT_MS, description: "调用超时毫秒数,默认600000。" })),
|
|
33
33
|
};
|
|
34
34
|
|
|
35
35
|
export const generateImageSchema = Type.Object(common, { additionalProperties: false });
|
|
36
36
|
export const editImageSchema = Type.Object({ ...common,
|
|
37
|
-
images: Type.Array(imageSourceSchema, { minItems: 1, maxItems: 16, description: "
|
|
37
|
+
images: Type.Array(imageSourceSchema, { minItems: 1, maxItems: 16, description: "每个本地/内联图片小于50 MB,含 mask 合计最多100 MB。" }),
|
|
38
38
|
mask: optional(imageSourceSchema),
|
|
39
39
|
}, { additionalProperties: false });
|
|
40
40
|
|
|
@@ -23,10 +23,8 @@ export function registerImageTools(pi: ExtensionAPI): void {
|
|
|
23
23
|
name: operation === "generate" ? "tsgw_generate_image" : "tsgw_edit_image",
|
|
24
24
|
label: operation === "generate" ? "TSGW 生成图片" : "TSGW 编辑图片",
|
|
25
25
|
description: (operation === "generate" ? "根据 prompt 生成图片,只需填写 prompt。" : "根据 prompt 和 images 编辑图片,可选 mask;蒙版对应第一张参考图。") +
|
|
26
|
-
"
|
|
27
|
-
"
|
|
28
|
-
(operation === "edit" ? "本地图片以 Pi 进程操作系统权限直接只读原始字节并外传,不经过内置 read 审批,不是沙箱;仅普通文件,每个小于50 MB、含蒙版合计最多100 MB。不下载远程 URL;远程蒙版的格式与尺寸交上游验证。" : "") +
|
|
29
|
-
"返回实际图片块与唯一临时文件路径,不需 codemode 或 image()。请求可能计费;不自动重试或换模型,失败、取消或超时都不保证停止上游处理或未计费。",
|
|
26
|
+
(operation === "edit" ? "仅使用获授权的图片;本地原文件会外传。" : "") +
|
|
27
|
+
"返回图片与临时文件路径。失败、取消或超时后不自动重试或换模型。",
|
|
30
28
|
parameters: operation === "generate" ? generateImageSchema : editImageSchema,
|
|
31
29
|
outputSchema: imageToolResultSchema,
|
|
32
30
|
exposure: "direct",
|
|
@@ -59,13 +57,13 @@ export function registerImageTools(pi: ExtensionAPI): void {
|
|
|
59
57
|
usage = response.usage;
|
|
60
58
|
if (response.tsgwUsage?.status === "unaggregated") {
|
|
61
59
|
usage = undefined;
|
|
62
|
-
details.usage_note = "
|
|
60
|
+
details.usage_note = "多图流式用量未汇总,未计入会话总量。";
|
|
63
61
|
details.usage_reports = response.tsgwUsage.reports.map(report => ({ ...report }));
|
|
64
62
|
}
|
|
65
63
|
if (response.stopReason !== "stop") {
|
|
66
64
|
details.requestStatus = "unknown";
|
|
67
65
|
throw new ImageToolFileError(response.stopReason === "aborted" ? "aborted" : "request-failed",
|
|
68
|
-
response.stopReason === "aborted" ? "
|
|
66
|
+
response.stopReason === "aborted" ? "图片调用已取消或超时,结果未知;请勿自动重试。" : "图片调用未成功,结果未知;请勿自动重试,请检查宿主模型认证与网关。");
|
|
69
67
|
}
|
|
70
68
|
details.requestStatus = "succeeded";
|
|
71
69
|
details.phase = "output";
|
|
@@ -80,10 +78,10 @@ export function registerImageTools(pi: ExtensionAPI): void {
|
|
|
80
78
|
} else {
|
|
81
79
|
// 不转发供应商异常、输入 URL、base64 或文件系统原始异常。
|
|
82
80
|
details.error = caller.aborted
|
|
83
|
-
? { code: "aborted", message: details.requestStatus === "not-started" ? "图片工具已取消,尚未调用上游。" : "
|
|
81
|
+
? { code: "aborted", message: details.requestStatus === "not-started" ? "图片工具已取消,尚未调用上游。" : "图片调用已取消,结果未知;请勿自动重试。" }
|
|
84
82
|
: details.phase === "validate" || details.phase === "input"
|
|
85
83
|
? { code: "invalid-parameters", message: "图片工具参数无效;请检查字段白名单、数值范围、图片来源与参数组合。未调用上游。" }
|
|
86
|
-
: { code: "request-unknown", message: "
|
|
84
|
+
: { code: "request-unknown", message: "图片调用异常,结果未知;未自动重试,请检查宿主与网关。" };
|
|
87
85
|
}
|
|
88
86
|
}
|
|
89
87
|
return {
|
|
@@ -7,7 +7,7 @@ import { readImageResponse } from "./stream-response.ts";
|
|
|
7
7
|
|
|
8
8
|
const DEFAULT_TIMEOUT_MS = 600_000;
|
|
9
9
|
const MAX_TIMEOUT_MS = 2_147_483_647;
|
|
10
|
-
const
|
|
10
|
+
const FAILURE_NOTE = "未自动重试。";
|
|
11
11
|
function mergeHeaders(apiKey: string | undefined, ...sources: (ProviderHeaders | undefined)[]): Headers {
|
|
12
12
|
const headers = new Headers({ "Content-Type": "application/json" });
|
|
13
13
|
if (apiKey?.trim()) headers.set("Authorization", `Bearer ${apiKey}`);
|
|
@@ -104,9 +104,9 @@ export const generateImages: ProviderImages["generateImages"] = async (model, co
|
|
|
104
104
|
if (!controller.signal.aborted && Date.now() >= deadline) { timedOut = true; controller.abort(); }
|
|
105
105
|
if (controller.signal.aborted) {
|
|
106
106
|
result.stopReason = timedOut ? "error" : "aborted";
|
|
107
|
-
result.errorMessage = `${timedOut ? "图片请求超时。" : "图片请求已取消。"}${
|
|
107
|
+
result.errorMessage = `${timedOut ? "图片请求超时。" : "图片请求已取消。"}${FAILURE_NOTE}`;
|
|
108
108
|
} else {
|
|
109
|
-
result.errorMessage = `${error instanceof ImageFailure ? error.message : "图片请求失败,请检查认证、网络及请求钩子。"}${
|
|
109
|
+
result.errorMessage = `${error instanceof ImageFailure ? error.message : "图片请求失败,请检查认证、网络及请求钩子。"}${FAILURE_NOTE}`;
|
|
110
110
|
}
|
|
111
111
|
return result;
|
|
112
112
|
} finally {
|
|
@@ -12,7 +12,7 @@ export function supportsImageModels(version: string): boolean {
|
|
|
12
12
|
return supportsStablePi12(version);
|
|
13
13
|
}
|
|
14
14
|
|
|
15
|
-
/**
|
|
15
|
+
/** 分类目录与桥接沿用插件的 Pi 1.2 稳定版基线。 */
|
|
16
16
|
export function supportsClassifierModels(version: string): boolean {
|
|
17
17
|
return supportsStablePi12(version);
|
|
18
18
|
}
|
|
@@ -58,7 +58,7 @@ export function registerSearchProxyTool(pi: ExtensionAPI, options: SearchProxyOp
|
|
|
58
58
|
if (!delegate) throw new Error("TSGW 搜索没有可供当前模型使用的代理模型。");
|
|
59
59
|
const registry = ctx.modelRegistry;
|
|
60
60
|
if (typeof registry.streamSimple !== "function")
|
|
61
|
-
throw new Error("TSGW
|
|
61
|
+
throw new Error("TSGW 代理搜索需要宿主支持 modelRegistry.streamSimple。");
|
|
62
62
|
const model = registry.find("tsgw", delegate.modelId);
|
|
63
63
|
if (!model || builtinSearchSupport(model.id, model.api) !== delegate.kind)
|
|
64
64
|
throw new Error("TSGW 搜索代理模型已不再以受支持的协议注册。");
|
|
@@ -12,16 +12,15 @@ export function registerUploadTool(pi: ExtensionAPI, dependencies: Pick<UploadDe
|
|
|
12
12
|
name: "upload_local_file",
|
|
13
13
|
label: "上传本地文件",
|
|
14
14
|
description: "通过已连接的 ts_oht MCP,将明确授权的本地文件从 Pi 主机上传到私有 S3。" +
|
|
15
|
-
"
|
|
16
|
-
"返回持有者即可使用的临时下载 URL(默认有效期 24 小时,inline 展示;HTML 可能执行)。存储内容约 7 天后清理。" +
|
|
15
|
+
"返回持有者即可使用的临时下载 URL(inline 展示 HTML 可能执行)。存储内容约 7 天后清理。" +
|
|
17
16
|
"不会自动重试。失败或结果未知时,请保留 key 和 resume 恢复凭条;仅在明确要求恢复时使用返回的凭条," +
|
|
18
17
|
"切勿盲目发起全新上传。恢复前,请停止其他客户端对同一文件的上传。不要记录预签名 URL。",
|
|
19
18
|
parameters: Type.Object({
|
|
20
19
|
path: Type.String({ minLength: 1, description: "插件运行环境中的路径;相对路径以会话 cwd 为基准。仅支持普通文件。" }),
|
|
21
20
|
contentType: Type.Optional(Type.String({ minLength: 3, maxLength: 127, pattern: CONTENT_TYPE_PATTERN.source, description: "不带 charset 的 MIME 类型;默认根据扩展名推断,无法推断时使用 application/octet-stream。" })),
|
|
22
21
|
expiresIn: Type.Optional(Type.Integer({ minimum: 1, maximum: 604800, description: "下载 URL 的有效期,单位为秒;默认 86400。不会延长存储保留时间。" })),
|
|
23
|
-
disposition: Type.Optional(Type.Union([Type.Literal("inline"), Type.Literal("attachment")])),
|
|
24
|
-
resume: Type.Optional(Type.String({ minLength: 1, maxLength: 8192, pattern: RESUME_PATTERN.source, description: "
|
|
22
|
+
disposition: Type.Optional(Type.Union([Type.Literal("inline"), Type.Literal("attachment")], { description: "默认 inline;attachment 用于下载。" })),
|
|
23
|
+
resume: Type.Optional(Type.String({ minLength: 1, maxLength: 8192, pattern: RESUME_PATTERN.source, description: "原样使用上次失败调用返回的恢复凭条。" })),
|
|
25
24
|
}),
|
|
26
25
|
outputSchema: Type.Object({
|
|
27
26
|
uploaded: Type.Union([Type.Boolean(), Type.Null()]),
|
|
@@ -41,7 +40,7 @@ export function registerUploadTool(pi: ExtensionAPI, dependencies: Pick<UploadDe
|
|
|
41
40
|
...dependencies,
|
|
42
41
|
async call(name, args, operationSignal) {
|
|
43
42
|
if (typeof ctx.executeTool !== "function" || !Array.isArray(ctx.tools))
|
|
44
|
-
throw new UploadError("unsupported-host", "
|
|
43
|
+
throw new UploadError("unsupported-host", "上传工具需要宿主支持 ctx.executeTool。");
|
|
45
44
|
if (![UPLOAD_TOOL, URL_TOOL].includes(name) || !ctx.tools.some(tool => tool.name === name))
|
|
46
45
|
throw new UploadError("mcp-unavailable", "所需的 ts_oht 工具尚未连接或不可调用。请在主机中启用它;本工具未创建连接。");
|
|
47
46
|
const outcome = await ctx.executeTool(name, args, { signal: operationSignal });
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-tsgw",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.2",
|
|
4
4
|
"description": "面向 TOSSP AIH gateway 的 Pi 扩展:按厂商维护聊天与图片模型目录及思考策略,支持四种聊天协议、图片生成与编辑工具,以及原生 System One 分类模型。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"keywords": [
|
|
@@ -32,13 +32,13 @@
|
|
|
32
32
|
"test:upload:live": "tsc -p tsconfig.test.json && node scripts/prepare-test-runtime.mjs && node dist/extensions/upload/live.test.js"
|
|
33
33
|
},
|
|
34
34
|
"peerDependencies": {
|
|
35
|
-
"@earendil-works/pi-coding-agent": ">=
|
|
35
|
+
"@earendil-works/pi-coding-agent": ">=1.2.0",
|
|
36
36
|
"typebox": "*"
|
|
37
37
|
},
|
|
38
38
|
"devDependencies": {
|
|
39
|
-
"@earendil-works/pi-ai": "
|
|
40
|
-
"@earendil-works/pi-coding-agent": "
|
|
41
|
-
"@earendil-works/pi-mcp": "
|
|
39
|
+
"@earendil-works/pi-ai": "1.4.0",
|
|
40
|
+
"@earendil-works/pi-coding-agent": "1.4.0",
|
|
41
|
+
"@earendil-works/pi-mcp": "1.4.0",
|
|
42
42
|
"typebox": "^1.3.37",
|
|
43
43
|
"typescript": "^7.0.2"
|
|
44
44
|
}
|
|
@@ -18,133 +18,50 @@ compatibility: 需要 Pi 1.2+、`codemode` 工具、pi-tsgw 图片工具及可
|
|
|
18
18
|
|
|
19
19
|
## 通过 `codemode` 工具调用
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
生成和编辑都通过 `codemode` 工具脚本调用 `tools.tsgw_generate_image()` 或 `tools.tsgw_edit_image()`;不要直接调用图片工具。检查调用状态与返回文件,按用户意图保存、发送、继续编辑或展示,不强制预览。保存、发送或编辑直接使用返回文件;仅需在对话中展示时,才用 `tools.read()` 读取并调用 `image(block)`。`text(result)` 只报告状态和路径,不代表后续交付已完成;不要打印图片 base64。工具不可用时说明条件不足,不改用其他调用方式或擅自修改配置。
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
收到生成任务后实际调用并检查结果;没有工具结果不得声称已生成。生成完成以 `requestStatus: succeeded`、`phase: complete` 和返回文件为依据;展示、保存或发送等后续步骤分别核实,失败时保留已有文件,只处理失败步骤,不重新生图。读取、保存与外传受图片工具及宿主权限控制,不绕过限制。
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
- 图片工具有 `outputSchema`,`codemode` 工具内嵌调用返回结构化状态和文件列表。保存、发送或继续编辑可以直接使用返回文件,无需先 `read` 或 `image()`;需要在对话中展示时,才读取文件并显式执行 `image(block)`。`text(result)` 仅报告状态和路径,不等于展示、发送或最终存储已完成;不要打印图片 base64。
|
|
27
|
-
- 工具本身直接调用时会返回图片块,但本技能使用 `codemode` 工具的结构化返回与文件处理流程;不要把内嵌调用等同于已向对话输出图片。
|
|
28
|
-
|
|
29
|
-
完整生成示例(一次请求,默认 Sunburst):将下方 JavaScript 作为 `code` 参数传给 `codemode` 工具。默认只返回文件;**任务需要在对话中展示时,将 `display` 改为 `true`**。若已有生成结果,只处理已有文件,不要重新运行生图调用。
|
|
25
|
+
生成示例(默认参数):
|
|
30
26
|
|
|
31
27
|
```js
|
|
32
28
|
// @options: {"timeout_ms": 660000, "max_output_tokens": 2000}
|
|
33
|
-
const
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
result = await tools.tsgw_generate_image({
|
|
37
|
-
prompt: "横版中国水墨山水画,远山、薄雾、一叶扁舟,不要文字、题款、印章或水印。",
|
|
38
|
-
size: "1536x1024"
|
|
39
|
-
});
|
|
40
|
-
} catch {
|
|
41
|
-
text({ error: "图片调用未正常返回;请检查已有工具结果。上游是否已处理或计费可能未知,不自动重试或换模型。" });
|
|
42
|
-
return;
|
|
43
|
-
}
|
|
29
|
+
const result = await tools.tsgw_generate_image({
|
|
30
|
+
prompt: "横版水墨山水,远山薄雾,一叶扁舟,不要文字"
|
|
31
|
+
});
|
|
44
32
|
text(result);
|
|
45
|
-
|
|
46
|
-
if (result?.requestStatus !== "succeeded" || result.phase !== "complete") {
|
|
47
|
-
text({ error: result?.requestStatus === "succeeded"
|
|
48
|
-
? "上游已成功,但结果处理或保存未完成;不要重新生成。"
|
|
49
|
-
: "未确认生成完成;按工具结果说明状态,不自动重试。" });
|
|
50
|
-
return;
|
|
51
|
-
}
|
|
52
|
-
if (!Array.isArray(result.files) || result.files.length === 0) {
|
|
53
|
-
text({ error: "工具报告完成但没有返回文件,无法继续交付;不要重新生成。" });
|
|
54
|
-
return;
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
if (!display) return; // 返回文件可用于保存、发送或继续编辑,不必读图预览。
|
|
58
|
-
let displayed = 0;
|
|
59
|
-
for (const file of result.files) {
|
|
60
|
-
try {
|
|
61
|
-
const block = await tools.read({ path: file.path });
|
|
62
|
-
if (block && typeof block === "object" && block.type === "image") {
|
|
63
|
-
image(block);
|
|
64
|
-
displayed++;
|
|
65
|
-
} else {
|
|
66
|
-
text({ error: "文件已生成,但未能读取为图片", path: file.path });
|
|
67
|
-
}
|
|
68
|
-
} catch {
|
|
69
|
-
text({ error: "文件已生成,但读取或展示失败;保留此路径,不要重新生成", path: file.path });
|
|
70
|
-
}
|
|
71
|
-
}
|
|
72
|
-
text({ generated: true, imagesEmitted: displayed, fileCount: result.files.length });
|
|
33
|
+
// 核对状态与 files;再按用户意图处理返回文件。
|
|
73
34
|
```
|
|
74
35
|
|
|
75
36
|
### 按意图处理返回文件
|
|
76
37
|
|
|
77
38
|
| 用户意图 | 后续操作 |
|
|
78
39
|
| --- | --- |
|
|
79
|
-
| 展示图片 | 对返回文件执行 `tools.read()`,再 `image(block)
|
|
80
|
-
| 保存图片 |
|
|
81
|
-
| 发送或上传 |
|
|
82
|
-
| 继续编辑 | 将原始文件路径用于下一次 `images[].path
|
|
83
|
-
|
|
84
|
-
后续读取、展示、保存或发送失败,与图片生成失败分开报告;保留已生成文件,只处理失败的后续步骤,不重新生图。
|
|
40
|
+
| 展示图片 | 对返回文件执行 `tools.read()`,再 `image(block)` |
|
|
41
|
+
| 保存图片 | 将原始文件保存到用户要求的位置;临时路径不等于已持久保存到指定位置 |
|
|
42
|
+
| 发送或上传 | 在已有授权范围内交给相应工具,并依据结果确认完成 |
|
|
43
|
+
| 继续编辑 | 将原始文件路径用于下一次 `images[].path`,无需先读预览 |
|
|
85
44
|
|
|
86
|
-
##
|
|
45
|
+
## 编辑参考图
|
|
87
46
|
|
|
88
|
-
|
|
47
|
+
编辑时传入修改要求与 `images`;局部编辑可加 `mask`:
|
|
89
48
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
}
|
|
49
|
+
```js
|
|
50
|
+
// @options: {"timeout_ms": 660000, "max_output_tokens": 2000}
|
|
51
|
+
const result = await tools.tsgw_edit_image({
|
|
52
|
+
prompt: "把蒙版区域改为盛开的荷花,保留原图其余构图和水墨风格",
|
|
53
|
+
images: [{ path: "source.png" }],
|
|
54
|
+
mask: { path: "mask.png" }
|
|
55
|
+
});
|
|
56
|
+
text(result);
|
|
96
57
|
```
|
|
97
58
|
|
|
98
|
-
|
|
59
|
+
`images` 保留参考图顺序,每个来源选择 `path`、`image_url`、`file_id` 其中之一。`path` 是 Pi 运行主机上的文件路径,相对路径以会话工作目录为准;`image_url` 接受 HTTP(S) URL 或图片 data URI,`file_id` 使用上游已有文件 ID。蒙版可省略;提供时,与第一张原图保持格式及尺寸一致,并带透明通道,用透明区域指示编辑范围。继续编辑应使用原始文件而非可能缩放或转码的预览。
|
|
99
60
|
|
|
100
|
-
|
|
101
|
-
{
|
|
102
|
-
"prompt": "极简咖啡馆标志草稿,咖啡杯与山峰结合,无文字",
|
|
103
|
-
"model": "gpt-image-2.5-flare",
|
|
104
|
-
"quality": "low",
|
|
105
|
-
"size": "1024x1024"
|
|
106
|
-
}
|
|
107
|
-
```
|
|
61
|
+
## 参数选择与结果边界
|
|
108
62
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
```json
|
|
112
|
-
{
|
|
113
|
-
"prompt": "把蒙版标出的区域改为盛开的荷花,保留原图其余构图和水墨风格",
|
|
114
|
-
"images": [{ "path": "source.png" }],
|
|
115
|
-
"mask": { "path": "mask.png" }
|
|
116
|
-
}
|
|
117
|
-
```
|
|
63
|
+
只填写任务需要覆盖的参数。按画面需要选择 `size`、`background`、`output_format`、图片数量等;透明背景使用支持透明的 PNG 或 WebP。尺寸限制及所有默认值、上下限以图片工具字段说明为准。
|
|
118
64
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
## 可选参数
|
|
122
|
-
|
|
123
|
-
生成和编辑共用下列可选参数,省略时使用默认值;只填写任务需要覆盖的项。
|
|
124
|
-
|
|
125
|
-
| 参数 | 默认值 | 用途与取值 |
|
|
126
|
-
| --- | --- | --- |
|
|
127
|
-
| `model` | `gpt-image-2.5-sunburst` | 草稿用 Flare,正式成图用 Sunburst |
|
|
128
|
-
| `quality` | `auto` | `low`、`medium`、`high`、`xhigh`、`max`、`auto`;`xhigh`/`max` 用于确实需要额外细节的任务 |
|
|
129
|
-
| `size` | `auto` | `宽x高`;例如 `1024x1024`、`1536x1024`、`1024x1536`、`2048x1152`、`3840x2160` |
|
|
130
|
-
| `background` | `auto` | `auto`、`opaque`、`transparent`;透明输出搭配 PNG 或 WebP |
|
|
131
|
-
| `output_format` | `png` | `png`、`jpeg`、`webp` |
|
|
132
|
-
| `output_compression` | JPEG/WebP 使用 `100` | `0–100` 整数,用于 JPEG/WebP |
|
|
133
|
-
| `n` | `1` | 一次请求生成 `1–10` 张图片 |
|
|
134
|
-
| `moderation` | `auto` | `auto` 或 `low` |
|
|
135
|
-
| `stream` | `false` | 是否使用上游流式响应;工具处理完成后返回最终图片 |
|
|
136
|
-
| `partial_images` | `0` | 流式请求中希望收到的过程图数量,`0–3` |
|
|
137
|
-
| `safety_identifier` | 省略 | 应用需要时提供稳定的匿名用户标识,最多 128 字符 |
|
|
138
|
-
| `user` | 省略 | 上游旧用户标识字段;新接入使用 `safety_identifier` |
|
|
139
|
-
| `timeout_ms` | `600000` | 单次调用等待时间,单位毫秒;可按任务覆盖。通过 `codemode` 工具调用时,脚本截止应留余量,例如默认请求配 `660000` |
|
|
140
|
-
|
|
141
|
-
自定义尺寸:宽高都是 16 的倍数,单边至多 3840,长短边比例至多 3,总像素为 655360–8294400;超过 3686400 像素属于上游实验范围。
|
|
142
|
-
|
|
143
|
-
## 超时、安全与结果
|
|
144
|
-
|
|
145
|
-
- 生成可能耗时数分钟。工具请求默认 `600000ms`;`codemode` 工具的示例脚本用 `660000ms` 为调用、读图和输出留余量。延长请求的 `timeout_ms` 时,脚本截止也要相应留余量;脚本超时可能无法进入示例的 catch,仍应核对已有结果而不是再次生图。
|
|
146
|
-
- 请求失败、取消或超时不代表上游未处理或未计费;不自动重试或换模型。费用显示为 0 表示尚未映射准确价格,不表示免费。
|
|
147
|
-
- `requestStatus: succeeded`、`phase: complete` 和返回文件是生成完成的依据。生成成功不代表展示、发送或指定位置的保存也成功;只有任务要求的后续操作实际完成,才能作相应声明。没有展示要求时,不把未展示视为失败。
|
|
148
|
-
- 实际格式及尺寸以工具返回的 `files[].mimeType/width/height` 为准,不把请求的 `size` 直接当作最终尺寸。`read` 预览可能缩放或转码;继续编辑时使用原始文件的 `images[].path`,不要把预览当作原图。
|
|
149
|
-
- 本地/内联图片每个小于 50 MB,参考图与蒙版合计不超过 100 MB。原文件读取和外传由图片工具及宿主权限控制,不等于内置 `read` 的审批或沙箱;不绕过宿主对读图或工具的限制。
|
|
65
|
+
- 生成耗时较长时,脚本截止时间应比请求的 `timeout_ms` 留有处理余量;超时或结果未知时先核对已有结果,不自动重试或换模型。
|
|
66
|
+
- 以工具返回的 `files[].mimeType/width/height` 判断实际格式和尺寸,不将请求的 `size` 当作最终结果。生成成功不代表展示、发送或指定位置保存也成功;只有任务要求的后续操作实际完成,才能相应声明。没有展示要求时,不把未展示视为失败。
|
|
150
67
|
- 若结果带 `usage_note`,按其说明报告计量状态;多图流式的逐事件用量可能无法确定汇总值。
|
|
@@ -44,7 +44,7 @@ text(entries.map(model => ({
|
|
|
44
44
|
## 判断和报告
|
|
45
45
|
|
|
46
46
|
- 分别报告文本回复、工具往返是否通过,并列出实际使用的型号和思考档位;宿主若报告了不同的实际档位,应明确说明,不算原指定组合通过。
|
|
47
|
-
-
|
|
47
|
+
- 失败、取消或超时就报告实际阶段和可公开的错误,不主动刷新目录、重试、换档位或换模型。用户另行指定下一次测试时再执行。
|
|
48
48
|
- 未创建子代理、仍在执行或结果未知时如实说明,不把它们写成模型已通过或端点已被证明不可用。
|
|
49
49
|
- 一次通过只证明该型号、档位在本次最小任务中可用,不推广为全部模态、长期稳定性或复杂工程能力已验收。
|
|
50
50
|
- 验证候选模型不等于已经切换主会话或修改默认配置;切换按用户授权另行执行。
|
|
@@ -54,22 +54,9 @@ metadata:
|
|
|
54
54
|
- 对其他重复笔记,先提取仍有价值的差异内容,合并写入主记录
|
|
55
55
|
- 可自主修正标签、更新或合并记录、归档或删除无价值重复记录及恢复误归档记录;方向或范围不同的外部知识应独立且互相关联,不得错误合并。
|
|
56
56
|
|
|
57
|
-
### 标签
|
|
57
|
+
### 标签
|
|
58
58
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
- 从笔记内容中提取多个关键词作为标签
|
|
62
|
-
- 用词保持一致:避免 "#Linux" 和 "#linux" 混用
|
|
63
|
-
- 实践中自然生长:不需要预设复杂标签体系
|
|
64
|
-
|
|
65
|
-
### 层级结构
|
|
66
|
-
|
|
67
|
-
```
|
|
68
|
-
技术类: #windows #linux #debian #python
|
|
69
|
-
运维类: #运维/晨云 #运维/川大 #运维信息
|
|
70
|
-
技巧类: #技巧/windows #技巧/linux #技巧/ntp
|
|
71
|
-
业务类: #晨云 #川大 #水利
|
|
72
|
-
```
|
|
59
|
+
从笔记内容提取多个关键词,形成多维度关联;标签用词保持一致(如统一使用 `#Linux`,不混用 `#linux`)。按实际内容自然使用普通标签或层级标签,例如 `#python`、`#技巧/linux`、`#运维/晨云`,不预设复杂体系。命中且复用时校验标签,补齐内容关键词并修正不一致用词。
|
|
73
60
|
|
|
74
61
|
### 查询策略 (MUST)
|
|
75
62
|
|
|
@@ -79,14 +66,6 @@ metadata:
|
|
|
79
66
|
- 对明确的外部调研任务,命中记录不得自动停止外部调研;按本次问题开展当前外部补充或事实核验。已有记忆可决定检索范围和强度,但不能替代事实核验;核验强度应与知识的风险和时效相关,无须每次无差别从零开始。
|
|
80
67
|
- 命中条目时检查其来源、适用边界、状态和时效信息,并为后续比较保留稳定条目 ID 或链接。
|
|
81
68
|
|
|
82
|
-
### 标签校验
|
|
83
|
-
|
|
84
|
-
**命中且复用时校验**:
|
|
85
|
-
|
|
86
|
-
- 搜索命中的笔记,检查内容关键词是否反映在标签中
|
|
87
|
-
- 如果笔记提到 "dify" 但没有 "#dify" 标签 → 添加
|
|
88
|
-
- 如果笔记是关于 Linux 但用了根级 "linux" 而不是 "#技巧/linux" → 修正
|
|
89
|
-
|
|
90
69
|
### 维护、清理与验证 (MUST)
|
|
91
70
|
|
|
92
71
|
- **持续维护授权包含删除**:与当前任务或知识维护直接相关的创建、单条或批量更新、标签调整、合并、归档、恢复及删除(含永久删除),模型可自主判断执行,无须逐条确认;不强制先标记 `#待删除`、归档或备份。
|
|
@@ -158,20 +137,10 @@ metadata:
|
|
|
158
137
|
## 分流与维护示例
|
|
159
138
|
|
|
160
139
|
```text
|
|
161
|
-
|
|
162
|
-
→
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
→ 回写该项目正式资料,按需更新本机 ctx,不写入 Blinko。
|
|
166
|
-
|
|
167
|
-
归纳用户个人沟通风格/行为倾向
|
|
168
|
-
→ 属原生 user-profile 机制;明确执行规范归用户级规则,不写入 Blinko。
|
|
169
|
-
|
|
170
|
-
确认重复条目含少量独有信息
|
|
171
|
-
→ 合入主记录并回读验证,再自主归档或删除重复条目,回报 ID 与理由。
|
|
172
|
-
|
|
173
|
-
用户要求每天提醒
|
|
174
|
-
→ 属定时任务意图,核对具体范围后处理,不借普通条目维护权限自行建任务。
|
|
140
|
+
外部调研或通用知识 → 按 MUST 规则检索、核验并沉淀 Blinko。
|
|
141
|
+
项目现场/个人倾向/敏感内容 → 分别归项目资料/user-profile/受保护位置,不写入 Blinko。
|
|
142
|
+
发现重复条目 → 合并独有价值、验证主记录,再按授权决定归档或删除并回报。
|
|
143
|
+
用户明确要求定时任务 → 核对范围后处理;不从普通条目维护授权推定可操作定时任务。
|
|
175
144
|
```
|
|
176
145
|
|
|
177
146
|
## 参考资料
|