pi-tsgw 1.4.1 → 1.5.1

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.
@@ -2,8 +2,12 @@ import type { Api, ClassifierContext, Model, Usage } from "@earendil-works/pi-ai
2
2
  import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
3
3
  import { isPlainObject, PayloadWriter } from "#tsgw/models/_tools";
4
4
  import { openaiThinking } from "#tsgw/models/vendors/openai";
5
+ import { minimaxThinking } from "#tsgw/models/vendors/minimax";
5
6
  import { DELEGATION_KINDS, resolveDelegationKeys, type DelegationCandidate } from "./policy.ts";
7
+ import { chatFailure, type SelectionFailure } from "./failure.ts";
6
8
 
9
+ export const CHAT_SELECTION_IDS = ["gpt-6-luna", "deepseek-flash", "MiniMax-M3.1-Flash"] as const;
10
+ type ChatSelectionId = (typeof CHAT_SELECTION_IDS)[number];
7
11
  interface ChatSelectionOptions {
8
12
  models: readonly Model<Api>[];
9
13
  signal: AbortSignal;
@@ -13,20 +17,21 @@ interface ChatSelectionOptions {
13
17
  }
14
18
 
15
19
  /**
16
- * 创建前选型的单次聊天通道,不改变原生 classify,也不把 Luna 注册为分类模型。
17
- * 复用宿主认证与 Responses 适配;只发送原分类材料,不携带会话历史、本地工具或搜索。
20
+ * 创建前选型的单次聊天通道,不改变原生 classify,也不将聊天执行器注册为分类模型。
21
+ * 复用宿主认证与各模型原有协议;只发送原分类材料,不携带会话历史、本地工具或搜索。
18
22
  */
19
- export async function selectWithLuna(
23
+ export async function selectWithChat(
20
24
  registry: ExtensionContext["modelRegistry"],
21
25
  context: ClassifierContext,
22
26
  candidates: readonly DelegationCandidate[],
27
+ modelId: ChatSelectionId,
23
28
  options: ChatSelectionOptions,
24
- ): Promise<{ selected: DelegationCandidate; kind: string; model: string } | undefined> {
29
+ ): Promise<{ selected: DelegationCandidate; kind: string; model: string } | { failure: SelectionFailure } | undefined> {
25
30
  const { signal } = options;
26
31
  signal.throwIfAborted();
27
32
  if (typeof registry.streamSimple !== "function") return undefined;
28
33
  // 分类执行器不受子代理输出候选的 scope 限制,但必须尊重宿主可用目录和用户过滤。
29
- const model = options.models.find(entry => entry.provider === "tsgw" && entry.id === "gpt-6-luna" &&
34
+ const model = options.models.find(entry => entry.provider === "tsgw" && entry.id === modelId &&
30
35
  (entry.type === undefined || entry.type === "chat") && entry.input.includes("text"));
31
36
  if (!model) return undefined;
32
37
  // 即使计时器尚未获得执行机会,目录查询耗尽总预算后也不能再发出付费请求。
@@ -46,39 +51,49 @@ export async function selectWithLuna(
46
51
  if (!isPlainObject(payload)) return payload;
47
52
  // 只复用厂商文本策略,不经过会注入 web_search 的公共调度。
48
53
  const writer = new PayloadWriter(payload);
49
- openaiThinking["gpt-6-luna"](writer, {
54
+ const operation = {
50
55
  provider: model.provider, modelId: model.id, api: model.api,
51
- thinkingLevel: "low", tsSearchMode: "cached",
52
- });
53
- // Responses 的格式约束位于 text.format;保留厂商设置的 verbosity。
54
- const text = writer.get("text");
55
- writer.set("text", {
56
- ...(isPlainObject(text) ? text : {}),
57
- format: {
58
- type: "json_schema", name: "delegation_selection", strict: true,
59
- schema: {
60
- type: "object",
61
- properties: {
62
- kind: { type: "string", enum: [...DELEGATION_KINDS] },
63
- selection: { type: "string", enum: [...candidates.map(candidate => candidate.key), "unresolved"] },
56
+ thinkingLevel: "low" as const, tsSearchMode: "cached" as const,
57
+ };
58
+ if (modelId === "MiniMax-M3.1-Flash") {
59
+ minimaxThinking[modelId](writer, operation);
60
+ // 沿用 Anthropic Messages;不假定其支持 Responses 的 text.format。
61
+ // JSON 由提示约束并在响应入口严格校验,与其他通道使用相同硬规则。
62
+ } else {
63
+ if (modelId === "gpt-6-luna") openaiThinking[modelId](writer, operation);
64
+ const text = writer.get("text");
65
+ writer.set("text", {
66
+ ...(isPlainObject(text) ? text : {}),
67
+ format: {
68
+ type: "json_schema", name: "delegation_selection", strict: true,
69
+ schema: {
70
+ type: "object",
71
+ properties: {
72
+ kind: { type: "string", enum: [...DELEGATION_KINDS] },
73
+ selection: { type: "string", enum: [...candidates.map(candidate => candidate.key), "unresolved"] },
74
+ },
75
+ required: ["kind", "selection"], additionalProperties: false,
64
76
  },
65
- required: ["kind", "selection"], additionalProperties: false,
66
77
  },
67
- },
68
- });
78
+ });
79
+ }
69
80
  return writer.result();
70
81
  },
71
82
  }).result();
72
83
  options.onUsage(result.usage);
73
84
  signal.throwIfAborted();
74
- if (result.stopReason !== "stop" || result.content.some(part => part.type === "toolCall")) return undefined;
85
+ if (result.stopReason === "error" || result.stopReason === "aborted") return { failure: chatFailure(result.errorMessage) };
86
+ const invalid: { failure: SelectionFailure } = {
87
+ failure: { failureKind: "invalid_result", reason: "聊天选型结果无效、未决或不符合固定审阅规则。" },
88
+ };
89
+ if (result.stopReason !== "stop" || result.content.some(part => part.type === "toolCall")) return invalid;
75
90
  const text = result.content.flatMap(part => part.type === "text" ? [part.text] : []).join("");
76
91
  try {
77
92
  const answer: unknown = JSON.parse(text);
78
- if (!isPlainObject(answer) || Object.keys(answer).length !== 2 || typeof answer.kind !== "string") return undefined;
93
+ if (!isPlainObject(answer) || Object.keys(answer).length !== 2 || typeof answer.kind !== "string") return invalid;
79
94
  const selected = resolveDelegationKeys(answer.kind, answer.selection, candidates);
80
- return selected ? { selected, kind: answer.kind, model: modelName } : undefined;
95
+ return selected ? { selected, kind: answer.kind, model: modelName } : invalid;
81
96
  } catch {
82
- return undefined;
97
+ return invalid;
83
98
  }
84
99
  }
@@ -4,21 +4,22 @@ export type DelegationFailureKind =
4
4
  | "invalid_response" | "unsupported" | "unknown" | "invalid_input" | "unavailable"
5
5
  | "invalid_result" | "model_unavailable";
6
6
 
7
- interface ClassifierFailure {
7
+ export interface SelectionFailure {
8
8
  failureKind: DelegationFailureKind;
9
9
  reason: string;
10
+ statusCode?: number;
10
11
  }
11
12
 
12
13
  /** 只识别 adapter 的安全类别,不把任意 errorMessage 当作可信展示文本。 */
13
- export function classifierFailure(message: string | undefined, aborted = false): ClassifierFailure {
14
+ export function classifierFailure(message: string | undefined, aborted = false): SelectionFailure {
14
15
  if (aborted) return { failureKind: "cancelled", reason: "分类请求已取消。" };
15
16
  if (message === "分类请求超时。") return { failureKind: "timeout", reason: message };
16
17
  const status = /^分类请求(?:认证失败|被上游限流|失败)(HTTP ([45]\d{2}))。$/.exec(message ?? "")?.[1];
17
18
  if (status) {
18
19
  if (status === "401" || status === "403")
19
- return { failureKind: "authentication", reason: `分类请求认证失败(HTTP ${status})。` };
20
- if (status === "429") return { failureKind: "rate_limit", reason: "分类请求被上游限流(HTTP 429)。" };
21
- return { failureKind: "http", reason: `分类请求失败(HTTP ${status})。` };
20
+ return { failureKind: "authentication", reason: `分类请求认证失败(HTTP ${status})。`, statusCode: Number(status) };
21
+ if (status === "429") return { failureKind: "rate_limit", reason: "分类请求被上游限流(HTTP 429)。", statusCode: 429 };
22
+ return { failureKind: "http", reason: `分类请求失败(HTTP ${status})。`, statusCode: Number(status) };
22
23
  }
23
24
  switch (message) {
24
25
  case "分类请求缺少有效认证信息。":
@@ -36,8 +37,24 @@ export function classifierFailure(message: string | undefined, aborted = false):
36
37
  }
37
38
  }
38
39
 
40
+ /** SDK 错误仅提取 HTTP 状态码;不回显可能含凭据、请求或上游正文的 message。 */
41
+ export function chatFailure(message: string | undefined): SelectionFailure {
42
+ // Responses 使用宿主格式“tsgw API error (状态码):”,Anthropic 保留 SDK 数字前缀。
43
+ const match = /^(?:(?:HTTP\s+)?([45]\d{2})\b|tsgw API error \(([45]\d{2})\):)/i.exec(message ?? "");
44
+ const status = match?.[1] ?? match?.[2];
45
+ if (status) {
46
+ const statusCode = Number(status);
47
+ const failureKind = statusCode === 401 || statusCode === 403 ? "authentication" : statusCode === 429 ? "rate_limit" : "http";
48
+ return { failureKind, reason: `聊天选型请求失败(HTTP ${statusCode})。`, statusCode };
49
+ }
50
+ if (/^(?:request timed out\.?|request timeout\.?)$/i.test(message ?? ""))
51
+ return { failureKind: "timeout", reason: "聊天选型请求超时。" };
52
+ if (/^connection error\.?$/i.test(message ?? ""))
53
+ return { failureKind: "network", reason: "聊天选型连接失败。" };
54
+ return { failureKind: "unknown", reason: "聊天选型请求失败(原因未明)。" };
55
+ }
56
+
39
57
  export function failureGuidance(kind: DelegationFailureKind | undefined): string {
40
- if (kind === "cancelled") return "本次未创建子代理;请尊重取消状态,不自动重新派遣。";
41
- return "自动分类选型暂时无法使用。本次未创建子代理。请由发起调用的主代理按照以下指导选择当前可用模型," +
42
- "显式指定 Agent.model 后重新派遣代理;遵守用户指定和固定审阅要求,不重试分类器或自动更换分类模型。";
58
+ if (kind === "cancelled") return "本次未创建子代理。";
59
+ return "本次未创建子代理。请按以下选型指导处理,不重试自动选型。";
43
60
  }
@@ -9,22 +9,20 @@ import {
9
9
  type DelegationCandidate,
10
10
  } from "./policy.ts";
11
11
  import { failureGuidance, type DelegationFailureKind } from "./failure.ts";
12
- import { raceSelection } from "./selection-race.ts";
12
+ import { raceSelection, type SelectionError } from "./selection-race.ts";
13
13
 
14
14
  const TIMEOUT_MS = 15_000;
15
15
  const MAX_CONTEXT_BYTES = 28 * 1024;
16
- const GUIDANCE = "新建子代理时,直接调用 Agent,写清任务、必要事实、输入与工具条件、关键难点、验收标准和约束;未明确指定模型时省略 model," +
17
- "由 TSGW 在创建前自动分类选型,无需读取长选型表或编写 codemode 分类脚本。" +
18
- "用户指定模型或固定审阅组合时显式传 model;resume 沿用原模型,不重新选型。" +
19
- "分类模型与 gpt-6-luna 聊天模型并行选型,采用首个有效结果并取消另一请求;" +
20
- "两路均失败或总超时时按工具报告的失败类型处理," +
21
- "由发起调用的主代理自行选型并显式指定 Agent.model 再调用;" +
22
- "不重试分类器,调用已取消时不自动重新派遣。";
16
+ const GUIDANCE = "新建子代理时,直接调用 Agent,写清任务、必要事实、输入与工具条件、关键难点、验收标准和约束。" +
17
+ "用户指定模型或固定审阅组合时按要求显式传 model;否则省略 model,由 TSGW 自动补入模型与思考档位。" +
18
+ "resume 沿用原模型,不重新选型。";
23
19
 
24
20
  type Decision = {
25
21
  status: "selected" | "blocked";
26
22
  classifier?: string;
27
23
  chatModel?: string;
24
+ chatModels?: string[];
25
+ selectionErrors?: SelectionError[];
28
26
  selectionSource?: { type: "classifier" | "chat"; model: string };
29
27
  model?: string;
30
28
  kind?: string;
@@ -41,10 +39,16 @@ interface Attempt {
41
39
  candidates?: DelegationCandidate[];
42
40
  }
43
41
 
42
+ function selectionErrorsText(decision: Decision): string {
43
+ return decision.selectionErrors?.length ? "\n选型通道报错(返回前已收到):\n" +
44
+ decision.selectionErrors.map(error => `- ${error.source.model}:${error.reason}`).join("\n") : "";
45
+ }
46
+
44
47
  function failureText(decision: Decision): string {
45
48
  return `TSGW ${decision.reason ?? "分类选型未完成。"}${failureGuidance(decision.failureKind)}` +
46
49
  `\n选型来源:无(未完成有效选型${decision.classifier ? `;已尝试分类模型 ${decision.classifier}` : ""}` +
47
- `${decision.chatModel ? `;已尝试聊天模型 ${decision.chatModel}` : ""})。` +
50
+ `${decision.chatModels?.length ? `;已尝试聊天模型 ${decision.chatModels.join("、")}` : ""})。` +
51
+ selectionErrorsText(decision) +
48
52
  (decision.selectionGuide ? `\n\n${decision.selectionGuide}` : "");
49
53
  }
50
54
 
@@ -139,10 +143,12 @@ export function registerDelegation(pi: ExtensionAPI): void {
139
143
  ...(typeof input.run_in_background === "boolean" ? { run_in_background: input.run_in_background } : {}),
140
144
  };
141
145
  let classifierId: string | undefined;
142
- let chatModelId: string | undefined;
146
+ const chatModelIds: string[] = [];
147
+ const selectionErrors: SelectionError[] = [];
143
148
  const failure = (reason: string, kind: DelegationFailureKind): Decision => {
144
149
  return { ...blocked(reason, kind), ...(classifierId ? { classifier: classifierId } : {}),
145
- ...(chatModelId ? { chatModel: chatModelId } : {}),
150
+ ...(chatModelIds.length ? { chatModel: chatModelIds[0], chatModels: [...chatModelIds] } : {}),
151
+ ...(selectionErrors.length ? { selectionErrors: [...selectionErrors] } : {}),
146
152
  ...(kind === "cancelled" ? {} : { selectionGuide: buildDelegationGuide(attempt.candidates) }) };
147
153
  };
148
154
  try {
@@ -167,9 +173,10 @@ export function registerDelegation(pi: ExtensionAPI): void {
167
173
  models, signal, deadlineMs: started + TIMEOUT_MS,
168
174
  onStart: source => {
169
175
  if (source.type === "classifier") classifierId = source.model;
170
- else chatModelId = source.model;
176
+ else chatModelIds.push(source.model);
171
177
  },
172
178
  onUsage: usage => { attempt.usage = addUsage(attempt.usage, usage); },
179
+ onError: error => { selectionErrors.push(error); },
173
180
  }), signal);
174
181
  if ("failure" in result) return failure(result.failure.reason, result.failure.failureKind);
175
182
  const { selected, kind, source } = result.winner;
@@ -179,7 +186,9 @@ export function registerDelegation(pi: ExtensionAPI): void {
179
186
  if (!current.some(candidate => candidate.model === selected.model))
180
187
  return failure("选定模型或思考档位已不在当前可用候选中。", "model_unavailable");
181
188
  return { status: "selected", classifier: classifierId, model: selected.model,
182
- selectionSource: source, ...(chatModelId ? { chatModel: chatModelId } : {}),
189
+ selectionSource: source,
190
+ ...(chatModelIds.length ? { chatModel: chatModelIds[0], chatModels: [...chatModelIds] } : {}),
191
+ ...(selectionErrors.length ? { selectionErrors: [...selectionErrors] } : {}),
183
192
  ...(kind ? { kind } : {}), durationMs: Date.now() - started };
184
193
  } catch {
185
194
  if (cancellation.aborted) return failure("分类选型已取消(调用或会话已结束)。", "cancelled");
@@ -223,8 +232,9 @@ export function registerDelegation(pi: ExtensionAPI): void {
223
232
  summary = `TSGW 创建前选型:${decision.model};选型来源:${sourceType} ${decision.selectionSource?.model}`;
224
233
  summary += "(并行竞速,采用首个有效结果)";
225
234
  summary += `;${event.isError ? "原 Agent 调用未成功。" : "已交由原 Agent 执行。"}`;
226
- if (decision.classifier && decision.chatModel)
235
+ if ((decision.classifier ? 1 : 0) + (decision.chatModels?.length ?? 0) > 1)
227
236
  summary += " 并行用量仅累计汇总前已报告部分;取消不保证远端停止处理或计费。";
237
+ summary += selectionErrorsText(decision);
228
238
  } else {
229
239
  summary = failureText(decision);
230
240
  }
@@ -113,7 +113,7 @@ export function buildDelegationGuide(candidates: readonly DelegationCandidate[]
113
113
  "选型指导(本次已核验的有效候选)",
114
114
  SELECTION_GUIDELINES,
115
115
  SELECTION_CONSTRAINTS,
116
- "将所选模型与档位完整填入 Agent.model,不填写分类器的 option key 或 unresolved;没有匹配候选或约束不清时交回主代理查证,不猜测型号。本指导不代替授权或创建子代理。",
116
+ "从下表选择符合任务与约束的候选,将首列完整值(provider/modelId:level)填入 Agent.model,保留原任务参数并直接调用 Agent;无匹配项或约束不清时先查证,不猜测型号,不扩大授权。",
117
117
  "| 模型与思考档位(Agent.model) | 适用条件、思考投入与参考成本 |",
118
118
  "| --- | --- |",
119
119
  ...candidates.map(candidate => `| ${candidate.model} | ${candidate.instructions} |`),
@@ -1,16 +1,15 @@
1
1
  import type { Api, ClassifierContext, Model, Usage } from "@earendil-works/pi-ai";
2
2
  import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
3
- import { selectWithLuna } from "./chat-selection.ts";
4
- import { classifierFailure, type DelegationFailureKind } from "./failure.ts";
3
+ import { CHAT_SELECTION_IDS, selectWithChat } from "./chat-selection.ts";
4
+ import { chatFailure, classifierFailure, type SelectionFailure } from "./failure.ts";
5
5
  import { chooseClassifier, resolveDelegationChoice, type DelegationCandidate } from "./policy.ts";
6
6
 
7
7
  export interface SelectionSource {
8
8
  type: "classifier" | "chat";
9
9
  model: string;
10
10
  }
11
- interface SelectionFailure {
12
- reason: string;
13
- failureKind: DelegationFailureKind;
11
+ export interface SelectionError extends SelectionFailure {
12
+ source: SelectionSource;
14
13
  }
15
14
  interface RaceOptions {
16
15
  models: readonly Model<Api>[];
@@ -18,6 +17,7 @@ interface RaceOptions {
18
17
  deadlineMs: number;
19
18
  onStart: (source: SelectionSource) => void;
20
19
  onUsage: (usage: Usage) => void;
20
+ onError: (error: SelectionError) => void;
21
21
  }
22
22
  interface SelectionWinner {
23
23
  selected: DelegationCandidate;
@@ -25,7 +25,7 @@ interface SelectionWinner {
25
25
  source: SelectionSource;
26
26
  }
27
27
 
28
- /** 两路各发一次;失败或非法结果不是胜者,不为等待取消确认延长选型。 */
28
+ /** 四路各发一次;失败或非法结果不是胜者,不为等待取消确认延长选型。 */
29
29
  export async function raceSelection(
30
30
  registry: ExtensionContext["modelRegistry"],
31
31
  context: ClassifierContext,
@@ -39,6 +39,7 @@ export async function raceSelection(
39
39
  reason: "选型结果无效、未决或不符合固定审阅规则。", failureKind: "invalid_result",
40
40
  };
41
41
  const native = async (): Promise<SelectionWinner> => {
42
+ let source: SelectionSource | undefined;
42
43
  try {
43
44
  signal.throwIfAborted();
44
45
  if (typeof registry.classify !== "function") {
@@ -57,7 +58,7 @@ export async function raceSelection(
57
58
  nativeFailure = { reason: "选型预算已耗尽。", failureKind: "timeout" };
58
59
  throw new Error("选型预算已耗尽。");
59
60
  }
60
- const source: SelectionSource = { type: "classifier", model: `${classifier.provider}/${classifier.id}` };
61
+ source = { type: "classifier", model: `${classifier.provider}/${classifier.id}` };
61
62
  options.onStart(source);
62
63
  const result = await registry.classify(classifier, context, { signal, timeoutMs: remaining, maxRetries: 0 });
63
64
  if (result.usage) options.onUsage(result.usage);
@@ -76,25 +77,39 @@ export async function raceSelection(
76
77
  return { selected, kind: answer?.type === "choice" ? answer.choice : undefined, source };
77
78
  } catch {
78
79
  nativeFailure ??= { reason: "分类请求失败(原因未明)。", failureKind: "unknown" };
80
+ if (source && !signal.aborted) options.onError({ source, ...nativeFailure });
79
81
  throw new Error("原生选型通道未提供有效结果。");
80
82
  }
81
83
  };
82
- const chat = async (): Promise<SelectionWinner> => {
83
- const result = await selectWithLuna(registry, context, candidates, {
84
- ...options, signal, onStart: model => options.onStart({ type: "chat", model }),
85
- });
86
- if (!result) throw new Error("聊天选型通道未提供有效结果。");
87
- return { selected: result.selected, kind: result.kind, source: { type: "chat", model: result.model } };
84
+ const chat = async (modelId: (typeof CHAT_SELECTION_IDS)[number]): Promise<SelectionWinner> => {
85
+ let source: SelectionSource | undefined;
86
+ let failure: SelectionFailure | undefined;
87
+ try {
88
+ const result = await selectWithChat(registry, context, candidates, modelId, {
89
+ ...options, signal, onStart: model => {
90
+ source = { type: "chat", model };
91
+ options.onStart(source);
92
+ },
93
+ });
94
+ if (result && !("failure" in result))
95
+ return { selected: result.selected, kind: result.kind, source: { type: "chat", model: result.model } };
96
+ if (result) failure = result.failure;
97
+ } catch (error) {
98
+ failure = chatFailure(error instanceof Error ? error.message : undefined);
99
+ }
100
+ // 未发起的通道和获胜/整体取消导致的中止不作为通道报错。
101
+ if (source && !signal.aborted) options.onError({ source, ...(failure ?? invalid) });
102
+ throw new Error("聊天选型通道未提供有效结果。");
88
103
  };
89
104
  try {
90
- const winner = await Promise.any([native(), chat()]);
105
+ const winner = await Promise.any([native(), ...CHAT_SELECTION_IDS.map(chat)]);
91
106
  options.signal.throwIfAborted();
92
107
  return { winner };
93
108
  } catch {
94
109
  options.signal.throwIfAborted();
95
110
  return { failure: nativeFailure ?? invalid };
96
111
  } finally {
97
- // 只取消两条选型请求,不中断获胜后的目录复核;不保证远端停止处理或计费。
112
+ // 只取消选型请求,不中断获胜后的目录复核;不保证远端停止处理或计费。
98
113
  finished.abort();
99
114
  }
100
115
  }
@@ -35,7 +35,6 @@ import {
35
35
  } from "./status.ts";
36
36
  import type { ThinkingLevel, WebSearchMode } from "#tsgw/models/_tools";
37
37
  import type { TsgwSettings } from "./config.ts";
38
- import { registerRefreshTool } from "./refresh-tool.ts";
39
38
 
40
39
  /**
41
40
  * 在生命周期上下文仍有效时,复制供应商钩子所需的数据。
@@ -185,9 +184,6 @@ export async function registerTsgwProvider(
185
184
  coordinator.stop();
186
185
  directory.invalidate();
187
186
  };
188
- registerRefreshTool(pi, {
189
- refresh: (registry, force, signal) => requestRefresh(registry, force ? "force" : "normal", signal),
190
- });
191
187
  const search = registerSearch(pi, {
192
188
  defaultMode: defaultSearchMode,
193
189
  state: () => requestState,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-tsgw",
3
- "version": "1.4.1",
3
+ "version": "1.5.1",
4
4
  "description": "面向 TOSSP AIH gateway 的 Pi 扩展:按厂商维护聊天与图片模型目录及思考策略,支持四种聊天协议、图片生成与编辑工具,以及原生 System One 分类模型。",
5
5
  "type": "module",
6
6
  "keywords": [
@@ -28,7 +28,7 @@
28
28
  ]
29
29
  },
30
30
  "scripts": {
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/catalog-state.test.js && node dist/extensions/models/gateway-catalog-service.test.js && node dist/extensions/models/gateway-catalog-recovery.test.js && node dist/extensions/provider/catalog-coordinator.test.js && node dist/extensions/provider/catalog-coordination.test.js && node dist/extensions/provider/catalog-recovery.test.js && node dist/extensions/provider/catalog-host.test.js && node dist/extensions/provider/catalog-preemption-host.test.js && node dist/extensions/provider/classifier-host.test.js && node dist/extensions/delegation/policy.test.js && node dist/extensions/delegation/terra-policy.test.js && node dist/extensions/delegation/selection-candidates.test.js && node dist/extensions/delegation/index.test.js && node dist/extensions/delegation/failure.test.js && node dist/extensions/delegation/parallel.test.js && node dist/extensions/delegation/parallel-host.test.js && node dist/extensions/delegation/host-integration.test.js && node dist/extensions/agents/install.test.js && node dist/extensions/agents/host-integration.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/provider/catalog-lifecycle.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/minimax-protocol.test.js && node dist/extensions/models/grok-new.test.js && node dist/extensions/models/openai-terra.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",
31
+ "test": "tsc -p tsconfig.test.json && node scripts/prepare-test-runtime.mjs && node dist/extensions/provider/index.test.js && node dist/extensions/provider/startup-catalog.test.js && node dist/extensions/provider/catalog-state.test.js && node dist/extensions/models/gateway-catalog-service.test.js && node dist/extensions/models/gateway-catalog-recovery.test.js && node dist/extensions/provider/catalog-coordinator.test.js && node dist/extensions/provider/catalog-coordination.test.js && node dist/extensions/provider/catalog-recovery.test.js && node dist/extensions/provider/catalog-host.test.js && node dist/extensions/provider/catalog-preemption-host.test.js && node dist/extensions/provider/classifier-host.test.js && node dist/extensions/delegation/policy.test.js && node dist/extensions/delegation/terra-policy.test.js && node dist/extensions/delegation/selection-candidates.test.js && node dist/extensions/delegation/index.test.js && node dist/extensions/delegation/failure.test.js && node dist/extensions/delegation/parallel.test.js && node dist/extensions/delegation/parallel-host.test.js && node dist/extensions/delegation/host-integration.test.js && node dist/extensions/agents/install.test.js && node dist/extensions/agents/host-integration.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/provider/catalog-lifecycle.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/minimax-protocol.test.js && node dist/extensions/models/grok-new.test.js && node dist/extensions/models/openai-terra.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
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": {
@@ -1,28 +1,23 @@
1
1
  ---
2
2
  name: tsgw-delegate-model-selection
3
- description: 鼓励将适合的任务派给独立后台子代理。直接调用 Agent 并提供完整任务,TSGW 仅在新建且未指定模型时自动分类选型;不需要阅读选型表或编写分类脚本。
3
+ description: 将任务委派给子代理,或协调多个子代理并行工作时使用。
4
4
  license: MIT
5
- compatibility: 自动选型需要 Pi 1.2+、参数兼容的 Agent 工具及宿主可用目录;原生分类与固定 Luna 聊天选型通道至少一路可用。
5
+ compatibility: 自动选型需要 Pi 1.2+ 及参数兼容的 Agent 工具。
6
6
  ---
7
7
 
8
8
  # 子代理派遣
9
9
 
10
- 主代理负责拆分任务,提供目标、必要事实、文件路径、约束和验收标准;判断依赖、并行方式、权限和验收。委派描述应说明实际输入与工具条件、关键不确定性及结果如何验证;步骤清晰不等于问题简单。分类器不读取文件正文或图片,应在提示词中概括已查证的选型相关事实,不为选型复制整段材料或敏感内容。输入未齐备时先查证,不用分类代替授权或依赖验证。
10
+ 主代理负责拆分任务,提供目标、必要事实、文件路径、约束和验收标准,并判断依赖、并行方式与权限。委派描述应说明实际输入与工具条件、关键不确定性及结果如何验证;步骤清晰不等于问题简单。概括已查证的相关事实,不复制整段材料或敏感内容;输入未齐备时先查证,不用委派代替授权或依赖验证。
11
11
 
12
12
  ## 调用
13
13
 
14
- - 当前 PiWeb 将 `Agent`、`get_subagent_result`、`steer_subagent` 注册为 `model-only`,三者只能由主模型直接调用,不得放入 codemode 或其他工具包装器;`tools.get_subagent_result(...)` 等写法无效。出现工具不存在错误时,不猜名称、不重复搜索或重试嵌套调用。独立派遣可在同一回复中发起多个直接 `Agent` 调用。
15
- - 新建子代理:直接调用宿主 `Agent`,填写 `prompt`、`description`、适合的 `subagent_type` 和执行选项。没有明确模型要求时省略 `model`;插件在创建前完成一次分类选型并补入模型和思考档位,原 `Agent` 随即执行。
16
- - 独立任务优先 `run_in_background: true`;前置依赖未完成或存在并发修改冲突时不要假装独立。不要重复派遣已在执行的任务。
17
- - 后台任务完成后,当前 PiWeb 会在主会话空闲时发送结果通知并触发后续处理。派出后继续推进独立工作;没有独立工作时结束当前轮次,等待通知,不反复查询、不习惯性调用 `get_subagent_result({ wait: true })` 占用前台。只有查看中间状态、排障或明确需要同步取结果时才主动查询;通知尚未到达不代表任务未完成,不因此重复派遣。
18
- - 用户指定模型、项目固定模型或审阅组合时,直接显式传入 `model`(`provider/modelId:level`),跳过分类。正式架构/设计文档独立审阅默认 `tsgw/gpt-6-astra:max`;固定双模型审阅分别使用 `tsgw/kimi-k3.1-pro:high` 与 `tsgw/gpt-6-astra:max`,不能把一份双审任务交给一次自动选择。
19
- - 自动选型只适用于创建子代理且未指定 `model`;续接已有会话时传 `resume`,不传新模型,即使续接调用没有 `model` 也不再选型。直接调用 `get_subagent_result` 查询结果、`steer_subagent` 补充指令及子代理后续轮次均不触发分类,也不运行中换模型。
20
- - 插件先核验有效候选,再将同一组选型材料交给原生分类模型与固定 `tsgw/gpt-6-luna` 聊天通道并行处理,各请求一次。首个通过候选、档位及固定审阅约束校验的结果胜出,随后取消另一请求;不比较跨模型置信度、不等两路一致。单路报错、未决或非法结果继续等待另一路;一路缺席或宿主不支持时,只使用另一条可用通道,不轮换其他型号、不追加重试。Luna 以严格 JSON Schema 限定类别与候选枚举,只做选型,不执行任务;作为选型执行器不受子代理候选的会话范围限制,但必须在宿主可用目录中。
21
- - 两路都失败或未提供有效结果、总超时或获胜后的选定模型失效时,本次自动创建被阻止;不静默改选。工具返回具体失败类型和同源选型建议表;发起调用的主代理按指导自行选择当前可用模型,显式指定 `Agent.model` 后重新派遣,不重试分类器或自动更换分类模型。建议表只列本次按宿主可用目录、会话范围和合法档位过滤后的有效候选,与分类材料同源;无候选或核验未完成时只说明原因,不展示静态全表。用户指定和固定审阅要求优先。
22
- - 两路与获胜后的目录复核共用 15 秒选型上限;总预算耗尽、调用取消或会话结束时取消两路,不再启动请求。超时只阻止本次自动创建,不暂停后续独立调用的自动选型。调用取消或会话结束不视为超时,不自动重新派遣。
14
+ - 当前 PiWeb 的 `Agent`、`get_subagent_result`、`steer_subagent` 只能由主模型直接调用,不得放入 codemode 或其他工具包装器。独立派遣可在同一回复中发起多个直接 `Agent` 调用。
15
+ - 新建子代理:填写 `prompt`、`description`、适合的 `subagent_type` 和执行选项;未指定模型时省略 `model`,插件自动补入模型与思考档位,原 `Agent` 随即执行。
16
+ - 用户或项目指定模型、档位及固定审阅组合时,显式传入 `model`(`provider/modelId:level`)。正式架构/设计文档独立审阅默认 `tsgw/gpt-6-astra:max`;固定双审分别使用 `tsgw/kimi-k3.1-pro:high` 与 `tsgw/gpt-6-astra:max`,不能把两次独立复核交给一次自动选择。
17
+ - 续接已有会话时传 `resume`,不传新模型;直接调用 `get_subagent_result` 查询结果、`steer_subagent` 补充指令。
23
18
 
24
- 选型结果、获胜来源(分类模型或聊天模型及其 ID)、实际尝试的两路模型及已报告的累计用量附在原 `Agent` 的工具结果中;失败时注明未完成有效选型,不把尝试记录当作选择来源。只累计工具结果汇总前已报告的用量;不等待迟到响应、不补造取消通道费用,取消不保证远端停止处理或计费。无需编写 codemode 脚本,也不需要先询问分类器再组织第二次 `Agent` 调用。
19
+ ## 后台与依赖
25
20
 
26
- 自动选型不修改任务提示词、档案、后台标志、隔离选项、宿主权限或调度规则。没有兼容宿主工具或低版本 Pi 时不挂接自动选型;需按宿主实际能力显式选择模型,不将技能提示当作已加载运行时代码。
27
-
28
- 固定选型知识及维护边界位于插件的 `extensions/delegation/`,由插件维护,不要求执行任务的主模型查榜、探测型号或读取完整参考资料。候选知识、硬约束和运行时有效候选分开维护;普通任务不设厂商或型号默认优先级,候选顺序不是排名。依据任务与各候选的适用条件、局限和参考成本选择模型及档位;复杂任务不一律使用最高档,不把跨模型档位当作等效能力。两路都可用时,每次自动选型会同时发出两次请求,需承担双发费用;官方定位及隔离回归均不证明实际选型质量、耗时或任务总费用已改善。
21
+ - 独立任务优先 `run_in_background: true`;前置依赖未完成或存在并发修改冲突时,不要假装独立。不要重复派遣已在执行的任务。
22
+ - 当前 PiWeb 会在主会话空闲时发送后台结果通知并触发后续处理。派出后继续推进独立工作;没有独立工作时结束当前轮次等待通知,不反复查询,不习惯性调用 `get_subagent_result({ wait: true })` 占用前台。
23
+ - 只有查看中间状态、排障或明确需要同步取结果时才主动查询;通知尚未到达不代表任务未完成,不因此重复派遣。
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tsgw-git-commit
3
- description: 核验 Git 暂存内容、按功能拆分提交并生成中文提交说明。用户要求 commit、提交代码或跨仓库分批提交时使用;遵循项目提交规范及明确授权范围。
3
+ description: 执行 Git 提交、准备提交说明或跨仓库分批提交时使用。
4
4
  license: MIT
5
5
  compatibility: 需要 Git;附带的只读仓库发现脚本需要 Node.js。
6
6
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tsgw-github
3
- description: "优先使用 gh CLI 处理 GitHub issue、PR、评论、CI 与失败日志、Contents API 读取,以及 Actions 依赖升级核验;适用于需要精确仓库上下文和安全发布 Markdown 正文的任务。"
3
+ description: 处理 GitHub 仓库、issue、PR、评论、Actions 与 CI 排障时使用。
4
4
  license: MIT
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tsgw-gitlab
3
- description: "使用 ts_gitlab MCP 处理砼砼 GitLab(code.tossp.com)的仓库、MR、Issue 与 CI/CD 等任务;该实例的 Git 远程仓库地址统一使用 SSH 表述。"
3
+ description: 处理砼砼 GitLab(code.tossp.com)的仓库、MR、Issue 与 CI/CD 时使用。
4
4
  license: MIT
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tsgw-image-generation
3
- description: 当用户要求生成图片、生图或画图,以及修改图片、参考图创作或蒙版编辑时使用。通过 `codemode` 工具调用 tsgw_generate_image 或 tsgw_edit_image,根据草稿或成稿选择模型与参数,再按用户意图保存、发送、展示或继续编辑。
3
+ description: 生成、绘制或编辑图片时使用,包括参考图创作与蒙版编辑。
4
4
  license: MIT
5
5
  compatibility: 需要 Pi 1.2+、`codemode` 工具、pi-tsgw 图片工具及可用的 tsgw 图片模型。
6
6
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: tsgw-mk-docs
3
3
  license: MIT
4
- description: 用于按设计文档治理规范创建、迁移、验证和维护项目设计文档骨架,明确需求、设计、执行计划、术语与状态证据的分工,并处理文档审阅反馈、修订、复审及获授权后的执行验收记录。
4
+ description: 创建、迁移、维护设计文档,或处理其审阅、修订与验收记录时使用。
5
5
  ---
6
6
 
7
7
  # 设计文档制作与进度管理
@@ -0,0 +1,50 @@
1
+ ---
2
+ name: tsgw-model-test
3
+ description: 测试聊天模型可用性,或模型异常后验证候选替代模型时使用。
4
+ license: MIT
5
+ compatibility: 需要可显式指定模型及思考档位的 Agent 工具;查询宿主模型目录另需 Pi 1.2+ 与 codemode。
6
+ ---
7
+
8
+ # 聊天模型可用性测试
9
+
10
+ 以一次最小真实任务验证指定模型能否回复及完成工具往返,不做性能榜单、全档位扫描或自动故障转移。测试范围以用户指定的型号和用途为准。
11
+
12
+ ## 确定模型和档位
13
+
14
+ - 上下文已知可用型号及支持的思考档位时,直接测试,**不必查询目录**。
15
+ - 信息不足时,才通过 `codemode` 的内置全局对象 `models` 查询宿主目录;它不是独立工具,不需要用 `searchTools()` 查找。
16
+ - 不调用 `tsgw_refresh_models`,也不把目录刷新、重载或修改配置作为测试前置步骤或失败补救。
17
+
18
+ 按需查询示例:将下方 JavaScript 交给 `codemode` 执行。仅查询 tsgw 时可将调用改为 `models.getAvailableOfType("chat", "tsgw")`;知道目标型号时,在输出前筛选即可。
19
+
20
+ ```js
21
+ const entries = await models.getAvailableOfType("chat");
22
+ text(entries.map(model => ({
23
+ provider: model.provider,
24
+ id: model.id,
25
+ reasoning: model.reasoning,
26
+ thinkingLevelMap: model.thinkingLevelMap
27
+ })));
28
+ ```
29
+
30
+ 这里只输出选择所需字段,不打印完整目录项中的端点或其他配置。目录表示宿主已登记且有可用认证,不证明端点或型号的真实调用成功;查询不到也不能据此断言远端模型不可用。
31
+
32
+ `reasoning: false` 时使用 `off`;`thinkingLevelMap` 中的 `null` 表示不支持该档位。缺失项不能直接按“支持所有档位”处理:Pi 1.2 对普通档位采用宿主默认规则,`xhigh`、`max` 需要显式映射。不要凭同系列其他型号推断支持情况,也不要为验证一次可用性遍历所有档位。
33
+
34
+ ## 执行最小真实任务
35
+
36
+ 由主模型**直接调用 `Agent`**,显式填写 `model: "provider/modelId:level"`,不交给自动选型,也不把 `Agent` 包进 codemode。调用及后台结果处理遵循[子代理派遣技能](../tsgw-delegate-model-selection/SKILL.md)。
37
+
38
+ 给子代理的任务保持最小,例如:
39
+
40
+ > 这是一次模型可用性测试。请实际调用一次已有工具:使用 bash 执行 `printf 'MODEL_TOOL_OK\n'`,再报告工具实际输出并简短回复。不要修改文件、读取凭据、请求外部服务或派遣其他子代理。工具缺失或调用失败就直接说明失败,不改用其他测试路径。
41
+
42
+ 使用实际可用且无副作用的工具;已有明确测试任务时沿用该任务,不额外扩展范围。只有收到真实工具结果及后续模型回复,才能认定工具往返通过;子代理启动成功或口头声称调用不算通过。
43
+
44
+ ## 判断和报告
45
+
46
+ - 分别报告文本回复、工具往返是否通过,并列出实际使用的型号和思考档位;宿主若报告了不同的实际档位,应明确说明,不算原指定组合通过。
47
+ - 失败、取消或超时就报告实际阶段和可公开的错误,不主动刷新目录、重试、换档位或换模型。用户另行指定下一次测试时再执行;取消不保证远端停止处理或计费。
48
+ - 未创建子代理、仍在执行或结果未知时如实说明,不把它们写成模型已通过或端点已被证明不可用。
49
+ - 一次通过只证明该型号、档位在本次最小任务中可用,不推广为全部模态、长期稳定性或复杂工程能力已验收。
50
+ - 验证候选模型不等于已经切换主会话或修改默认配置;切换按用户授权另行执行。
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tsgw-programmer-go
3
- description: "用于所有 Go 开发任务:编写、审查、重构、调试 Go 程序及回答 Go 问题。结合 Go 官方文档阅读要点与本技能强制约定,落实 PascalCase JSON、零值省略优先 omitzero,以及真实功能或修复变更中的旧 JSON 标签同步迁移;遇到明确协议或兼容性冲突先暴露并确认。"
3
+ description: 编写、审查、重构、调试 Go 代码或回答 Go 问题时使用。
4
4
  license: MIT
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tsgw-smemo
3
- description: 当用户提到 smemo、Blinko、记忆或笔记时用于判断记录落点;发现外部调研、通用知识、有效资讯及可复用解决方案时主动检索和维护。Blinko 是各设备 PiWeb/OC 共用的统一知识库,不记录个人倾向或具体现场事实;项目资料与本机 ctx 另有职责。
3
+ description: 涉及 smemo、Blinko、记忆或笔记,以及开展外部调研或沉淀通用知识时使用。
4
4
  license: MIT
5
5
  compatibility: Pi / Pi Web and OpenCode with Blinko tools from the ts_tool MCP server
6
6
  metadata:
@@ -0,0 +1,47 @@
1
+ ---
2
+ name: tsgw-synology-dav
3
+ description: 查询或管理群晖日历、日程及联系人时使用,通过 tsn__* MCP 工具读取真实数据,并在明确授权后创建、修改或删除。
4
+ license: MIT
5
+ compatibility: 需要宿主已连接并获准使用提供 tsn__* 工具的 MCP 服务及已有 DAV 账号配置。
6
+ ---
7
+
8
+ # 群晖日历与联系人
9
+
10
+ 涉及用户日程、联系人或空闲时间时,优先查询真实数据,不凭记忆猜测。本技能只指导宿主现有 MCP 调用,不新增 DAV 客户端、认证存储或连接配置。
11
+
12
+ ## 工具发现与连接
13
+
14
+ - 先通过当前宿主的工具发现入口查找 `tsn__calendar_list`、`tsn__calendar_event_list`、`tsn__contacts_search` 等实际工具,再读取其参数 schema。工具可能带服务前缀;以发现的完整名称调用,不猜测名称或参数,不把描述中提及的其他工具视为已经可用。
15
+ - 在 Pi codemode 中可用 `searchTools('tsn__calendar_list', { limit: 3 })` 发现工具,必要时用 `describeTool()` 查看参数,再调用实际返回的 `tools.<完整工具名>(...)`。不得搜索或输出凭据。
16
+ - 提示账号未连接时,可调用 `dav_reconnect` 使用已有配置重连;已知目标账号时显式指定,避免无故重连全部账号。重连后重新查询目标目录或数据;连接成功、发现目录成功和读取真实数据是不同证据。
17
+ - 认证失败立即停止,不反复尝试,不索取或读取保存的密码,也不改用 `dav_connect` 绕过失败。配置缺失、权限不足或工具不可用时明确报告阻塞,不自行安装、登录或修改 MCP 配置。
18
+ - 同时检查工具错误标记及文本结果;不能仅因调用正常返回就断言成功,未连接或业务错误也可能出现在文本中。
19
+
20
+ ## 日历查询
21
+
22
+ 1. 先调用 `calendar_list`,确认实际账号、日历名称和路径。不要硬编码个人目录,也不要将 calendar home 当作具体日历路径。
23
+ 2. 未指定时区时使用 `Asia/Shanghai`;根据当前真实日期将“今天、明天、下周”等转换为具体起止日期。“下周”默认目标周周一 `00:00` 至再下一周周一 `00:00`,即目标周周一至周日;若上下文有其他含义,先澄清。调用时用带时区偏移的 ISO 8601 时间,并在结果中说明具体范围及所用时区。
24
+ 3. 调用 `calendar_event_list`,必传明确的 `start`、`end`。整天查询从当天 `00:00:00+08:00` 到次日 `00:00:00+08:00`,避免用 `23:59:59` 漏掉小数秒;不臆测服务端边界是否包含,必要时核对返回的边界事件。指定日历时使用发现的账号和路径。当前实现中,传 `account` 却省略 `calendar` 只查询该账号的第一个日历,与工具描述的范围不一致;需要覆盖多个日历时,按发现结果逐个显式传 `account` 和 `calendar`,分别检查结果,不依赖省略参数的聚合查询(它可能跳过部分失败)。不把默认主日历当作全部日历。
25
+ 4. 先读取列表摘要,仅在完成任务确有必要且存在相应工具时再取单项详情。注意全天、跨天、重复事件及其例外;不要未经核验把重复规则当作已展开的每次发生记录,也不要把局部列表当作完整空闲证明。
26
+ 5. 查询为空时说明查了哪些日历及哪个时间范围。寻找近期安排或做只读实测时,可合理扩大到前后数周,明确区分各次结果;用户只问某一天时不为证明服务器有数据而无故扩查。不得把“当天无事件”说成“服务器没有数据”。
27
+
28
+ ## 联系人查询
29
+
30
+ - 已有姓名、邮箱或电话线索时优先 `contacts_search`;确实需要浏览列表或做一次只读能力验证时用 `contacts_list`。需要单项详情时,先确认实际存在的工具及目标 UID。
31
+ - 当前搜索会读取地址簿后在本地按姓名、邮箱、电话、组织或备注做不区分大小写的子串筛选,不是廉价的服务端索引查询。避免连续试探大量关键词或反复拉取整本地址簿;先利用已返回的结果,只有线索实质变化才再查询。
32
+ - 账号与地址簿参数按实际 schema 选择;默认主地址簿不代表所有地址簿。查不到时说明查询线索和范围,不断言联系人不存在于整个服务器。
33
+ - 同名或多个匹配结果时,只展示区分目标所需的少量字段;涉及写入则先请用户确认,不能自行挑选。
34
+
35
+ ## 写入授权与核验
36
+
37
+ - 查询可直接执行;创建、修改和删除日程或联系人,必须有用户针对该动作的明确授权。“实测工具”“检查连接”或本技能本身都不是业务写入授权,不为验收创建再删除测试数据。
38
+ - 操作前查询现状,确认账号、具体日历或地址簿、目标 UID、时间与时区,以及用户要求变更的字段。存在重名、重复事件、重复联系人、时间歧义或周期事件单次/整组范围不明时,先询问,不误改其他数据。
39
+ - 新建前在相关时间范围或联系人线索内核对是否已有目标。修改只传明确要求改变的字段;省略字段与空字符串可能含义不同,不用猜测值填满参数。删除前精确定位目标,不仅凭名称执行,也不依赖跨目录模糊搜索。
40
+ - 周期事件、待办或日志类能力,仅在用户确有需求、实际工具支持且获得对应授权时使用;不把日程工具的能力推定为其他类型也支持。
41
+ - 写入返回后,在授权范围内按实际可用查询工具回读核对。请求失败或结果不明时先查询,避免重复创建或重复执行;未确认结果就报告“未确认”,不得声称成功或自动补偿删除。
42
+
43
+ ## 隐私与结果汇报
44
+
45
+ - 只展示完成任务所需的信息,不倾倒整本通讯录或日程。只读实测优先输出查询范围、数量或成功/失败摘要,不展示无关正文;使用 codemode 时在当前调用内处理并精简输出,不把原始工具结果整段 `text()` 回显。
46
+ - 不把凭据、联系人正文或日程正文写入 `store`、日志、额外文件、代码仓库或记忆条目;也不在示例中固化真实姓名、电话、邮箱、UID 或个人目录。
47
+ - 分开汇报连接、目录发现、真实数据读取和写入结果;列出失败及未验证项。空结果不等于故障,也不证明有数据;只读成功不代表创建、修改、删除或周期处理已经通过验收。
@@ -1,58 +0,0 @@
1
- import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
2
- import { Type } from "typebox";
3
- import { PROVIDER_ID } from "#tsgw/models/catalog";
4
- import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS } from "#tsgw/models/gateway-catalog";
5
- import type { CatalogRefreshOutcome } from "./catalog-coordinator.ts";
6
-
7
- /** 工具只向统一目录服务提交一次刷新;缓存校验与目录应用均由协调器完成。 */
8
- export function registerRefreshTool(pi: ExtensionAPI, catalog: {
9
- refresh(
10
- registry: ExtensionContext["modelRegistry"],
11
- force: boolean,
12
- signal?: AbortSignal,
13
- ): Promise<CatalogRefreshOutcome>;
14
- }): void {
15
- pi.registerTool({
16
- name: "tsgw_refresh_models",
17
- label: "刷新 TSGW 模型目录",
18
- description: "获取 AIH 网关可用模型并同步当前目录,默认复用 24 小时内的缓存;force=true 忽略有效期强制联网刷新。并发刷新会自动合并到同一任务,单个调用方取消不会中止其他调用方。单次联网超时 5 秒,不发推理请求、不修改配置、不自动重试。返回缓存文件路径、网关模型数与获取时间;随后读取该文件的 ids 获取完整列表(含插件尚未登记的型号)。不自动登记未知型号。",
19
- parameters: Type.Object({
20
- force: Type.Optional(Type.Boolean({ description: "忽略缓存有效期强制联网刷新,默认 false。" })),
21
- }),
22
- outputSchema: Type.Object({
23
- cacheFilePath: Type.String(), count: Type.Integer(), storedAt: Type.Number(),
24
- }),
25
- exposure: "codemode",
26
- annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
27
- async execute(_id, params, signal, _onUpdate, ctx) {
28
- const caller = signal && ctx.signal && signal !== ctx.signal
29
- ? AbortSignal.any([signal, ctx.signal]) : signal ?? ctx.signal;
30
- const registry = ctx.modelRegistry;
31
- const force = params.force === true;
32
- const startedAt = Date.now();
33
- let outcome: CatalogRefreshOutcome;
34
- try {
35
- caller?.throwIfAborted();
36
- if (!registry.getProviderAuthStatus(PROVIDER_ID).configured) throw new Error("缺少凭据");
37
- // 每个调用方只提交自己的合并信号;并发合并与取消隔离由协调器保证。
38
- outcome = await catalog.refresh(registry, force, caller);
39
- caller?.throwIfAborted();
40
- } catch {
41
- throw new Error(caller?.aborted ? "TSGW 模型刷新已取消。" : "TSGW 模型目录获取失败;请检查宿主凭据、网关与网络。未输出原始错误。");
42
- }
43
- // 即使协调器复用了其他调用方的成功结果,本调用方已取消也不能报告成功。
44
- if (caller?.aborted || outcome.aborted) throw new Error("TSGW 模型刷新已取消。");
45
- if (outcome.errors?.has(PROVIDER_ID))
46
- throw new Error("TSGW 模型目录获取失败,保留原目录;请检查宿主凭据、网关与网络。");
47
- if (force && outcome.networkSucceeded !== true)
48
- throw new Error("TSGW 未完成强制联网刷新;不能将旧缓存当作本次刷新结果。");
49
- const details = outcome.summary;
50
- if (!details)
51
- throw new Error("未确认当前完整网关目录已写入缓存文件;不能将旧文件当作本次刷新结果。provider 可能已经更新。");
52
- // 普通请求要求相对本次开始时间仍新鲜;force 可复用先启动且仍未结束的任务。
53
- if (!force && details.storedAt < startedAt - DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS + 1)
54
- throw new Error("未确认当前完整网关目录已写入缓存文件;不能将旧文件当作本次刷新结果。provider 可能已经更新。");
55
- return { content: [{ type: "text", text: JSON.stringify(details) }], details, structuredContent: { ...details } };
56
- },
57
- });
58
- }