pi-tsgw 0.0.18 → 0.1.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.
- package/README.md +22 -2
- package/extensions/prompts.ts +13 -0
- package/extensions/provider/config.ts +33 -0
- package/extensions/{index.ts → provider/index.ts} +9 -44
- package/extensions/{status.ts → provider/status.ts} +2 -2
- package/extensions/{search.ts → search/index.ts} +4 -4
- package/extensions/{search-proxy.ts → search/proxy.ts} +3 -3
- package/index.ts +15 -0
- package/package.json +3 -3
- package/{extensions → prompts}/memory.ts +0 -13
- package/skills/tsgw-github/SKILL.md +1 -1
package/README.md
CHANGED
|
@@ -7,6 +7,22 @@
|
|
|
7
7
|
本项目不包含私有 API 密钥或网关端点。静态目录包含模型元数据和公开价格估算;
|
|
8
8
|
这些价格并非你的网关计费费率。
|
|
9
9
|
|
|
10
|
+
## 项目结构
|
|
11
|
+
|
|
12
|
+
包清单的 `pi.extensions` 指向根 `./index.ts`,作为约 15 行的总入口;provider 注册与生命周期位于 `extensions/provider/`,模型模块位于 `extensions/models/`。搜索模块及相邻测试位于 `extensions/search/`,提示词由 `extensions/prompts.ts` 的 `registerPrompts` 统一注册,正文位于 `prompts/`。宿主集成总测试为根 `index.test.ts`;provider 和搜索测试与对应模块相邻,共享测试夹具仍位于 `extensions/`。技能及其测试路径保持在 `skills/` 和 `extensions/`。
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
index.ts # 包总入口
|
|
16
|
+
index.test.ts # 宿主集成总测试
|
|
17
|
+
extensions/provider/ # provider 注册、配置、状态及其测试
|
|
18
|
+
extensions/models/ # 模型目录、策略与联网支持
|
|
19
|
+
extensions/search/ # 搜索注册、代理与相邻测试
|
|
20
|
+
extensions/prompts.ts # registerPrompts
|
|
21
|
+
prompts/memory.ts # 记忆提示词正文
|
|
22
|
+
extensions/upload/ # 本地上传及安全说明
|
|
23
|
+
skills/ # 随包技能
|
|
24
|
+
```
|
|
25
|
+
|
|
10
26
|
## 安装
|
|
11
27
|
|
|
12
28
|
```bash
|
|
@@ -191,7 +207,7 @@ GLM 指导使用 5.3,并以 Flash 和 FlashX 为备选。思考级别使用 Pi
|
|
|
191
207
|
与其其他非 off 级别一样,映射为 adaptive。
|
|
192
208
|
|
|
193
209
|
安装并执行 `/reload` 后,Pi 会通过包清单发现随包技能,除非宿主/包设置禁用或过滤了技能。
|
|
194
|
-
可以使用 `/skill:tsgw-git-commit`
|
|
210
|
+
可以使用 `/skill:tsgw-git-commit` 等命令显式加载;仅加载根 `index.ts` 不会加载包内技能。
|
|
195
211
|
包设置中的 `skills: []` 可禁用全部技能,`skills: ["skills/tsgw-git-commit"]` 可仅加载指定技能,
|
|
196
212
|
或用 `skills: ["!skills/tsgw-git-commit/**"]` 排除该技能;由宿主处理,不是 `tsgw` 配置项。
|
|
197
213
|
|
|
@@ -200,6 +216,9 @@ GLM 指导使用 5.3,并以 Flash 和 FlashX 为备选。思考级别使用 Pi
|
|
|
200
216
|
|
|
201
217
|
### 记忆规则注入
|
|
202
218
|
|
|
219
|
+
常驻提示词正文集中在 `prompts/`,与扩展注册入口分开维护。提示词由 `extensions/prompts.ts` 的
|
|
220
|
+
`registerPrompts` 统一注册;记忆提示词正文位于 `prompts/memory.ts`。
|
|
221
|
+
|
|
203
222
|
插件在 `before_agent_start` 中注入原用户规则中的记忆体系与既有条目维护授权,
|
|
204
223
|
不绑定当前模型 provider,不新增配置,不改写用户规则文件。
|
|
205
224
|
详细流程保留在 `tsgw-smemo` 技能及其参考资料中;`ctx_memory` 仍称为“系统记忆”,
|
|
@@ -264,7 +283,8 @@ Pi AI/MCP 是明确仅用于测试的开发依赖;运行时依赖和提供商
|
|
|
264
283
|
- [厂商配置](https://github.com/tossp/pi-tsgw/tree/main/extensions/models/vendors):模型元数据、兼容性标志和思考映射。
|
|
265
284
|
- [请求操作](https://github.com/tossp/pi-tsgw/blob/main/extensions/models/operations.ts):写时复制分派;DeepSeek/Claude 响应仍由 Pi 的适配器处理。
|
|
266
285
|
- [内置搜索](https://github.com/tossp/pi-tsgw/blob/main/extensions/models/web-search.ts):精确的模型/协议支持范围和仅追加注入。
|
|
267
|
-
- [
|
|
286
|
+
- [扩展总入口](https://github.com/tossp/pi-tsgw/blob/main/index.ts):包加载入口;[provider 集成](https://github.com/tossp/pi-tsgw/tree/main/extensions/provider):注册、配置、刷新、命令和生命周期快照。延迟执行的请求回调不得访问过期的会话上下文。
|
|
287
|
+
- [提示词注册](https://github.com/tossp/pi-tsgw/blob/main/extensions/prompts.ts):`registerPrompts` 统一入口;记忆正文位于 `prompts/memory.ts`。
|
|
268
288
|
|
|
269
289
|
这些源码链接描述仓库当前的 main 分支;已安装的发行版可能有所不同。
|
|
270
290
|
`AGENTS.md` 中的开发规则仅用于仓库,不属于 npm 包。
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import { MEMORY_RULES } from "../prompts/memory.ts";
|
|
3
|
+
|
|
4
|
+
export function registerPrompts(pi: ExtensionAPI): void {
|
|
5
|
+
pi.on("before_agent_start", (event) => {
|
|
6
|
+
if (event.systemPromptOptions) {
|
|
7
|
+
event.systemPromptOptions.sections.tsgw_memory = MEMORY_RULES;
|
|
8
|
+
return;
|
|
9
|
+
}
|
|
10
|
+
// 保留已声明支持的旧宿主提示词接口。
|
|
11
|
+
return { systemPrompt: `${event.systemPrompt}\n\n${MEMORY_RULES}` };
|
|
12
|
+
});
|
|
13
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { getAgentDir } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import { readFileSync } from "node:fs";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* 扩展配置来自 Pi 设置文件(settings.json)的 `tsgw` 命名空间。
|
|
7
|
+
* 所有插件配置均放在此处;插件不读取环境变量
|
|
8
|
+
* (密钥仅由 Pi 自身的凭据解析机制处理)。
|
|
9
|
+
*/
|
|
10
|
+
export interface TsgwSettings {
|
|
11
|
+
baseUrl?: string;
|
|
12
|
+
mcpUrl?: string;
|
|
13
|
+
tsSearch?: string;
|
|
14
|
+
traceHeaders?: boolean;
|
|
15
|
+
includeModels?: string[];
|
|
16
|
+
excludeModels?: string[];
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export function readTsgwSettings(): TsgwSettings {
|
|
20
|
+
try {
|
|
21
|
+
const raw: unknown = JSON.parse(
|
|
22
|
+
readFileSync(join(getAgentDir(), "settings.json"), "utf8"),
|
|
23
|
+
);
|
|
24
|
+
if (raw === null || typeof raw !== "object" || Array.isArray(raw))
|
|
25
|
+
return {};
|
|
26
|
+
const tsgw = (raw as { tsgw?: unknown }).tsgw;
|
|
27
|
+
if (tsgw === null || typeof tsgw !== "object" || Array.isArray(tsgw))
|
|
28
|
+
return {};
|
|
29
|
+
return tsgw as TsgwSettings;
|
|
30
|
+
} catch {
|
|
31
|
+
return {};
|
|
32
|
+
}
|
|
33
|
+
}
|
|
@@ -7,7 +7,6 @@ import {
|
|
|
7
7
|
getAgentDir,
|
|
8
8
|
readStoredCredential,
|
|
9
9
|
} from "@earendil-works/pi-coding-agent";
|
|
10
|
-
import { readFileSync } from "node:fs";
|
|
11
10
|
import { join } from "node:path";
|
|
12
11
|
import { randomUUID } from "node:crypto";
|
|
13
12
|
import {
|
|
@@ -17,20 +16,18 @@ import {
|
|
|
17
16
|
modelsForRoot,
|
|
18
17
|
normalizeRoot,
|
|
19
18
|
type ModelFilter,
|
|
20
|
-
} from "
|
|
21
|
-
import { getGatewayModelIds } from "
|
|
22
|
-
import { applyModelOperations } from "
|
|
23
|
-
import { registerSearch } from "
|
|
19
|
+
} from "../models/catalog.ts";
|
|
20
|
+
import { getGatewayModelIds } from "../models/gateway-catalog.ts";
|
|
21
|
+
import { applyModelOperations } from "../models/operations.ts";
|
|
22
|
+
import { registerSearch } from "../search/index.ts";
|
|
24
23
|
import {
|
|
25
24
|
catalogLabel,
|
|
26
25
|
catalogDiagnostics,
|
|
27
26
|
searchLabel,
|
|
28
27
|
type CatalogStatus,
|
|
29
28
|
} from "./status.ts";
|
|
30
|
-
import type { ThinkingLevel, WebSearchMode } from "
|
|
31
|
-
import {
|
|
32
|
-
import { registerTsgwMcp } from "./mcp.ts";
|
|
33
|
-
import { registerMemoryRules } from "./memory.ts";
|
|
29
|
+
import type { ThinkingLevel, WebSearchMode } from "../models/_tools.ts";
|
|
30
|
+
import type { TsgwSettings } from "./config.ts";
|
|
34
31
|
|
|
35
32
|
/**
|
|
36
33
|
* 在生命周期上下文仍有效时,复制供应商钩子所需的数据。
|
|
@@ -51,36 +48,6 @@ interface RequestModel {
|
|
|
51
48
|
baseUrl: string;
|
|
52
49
|
}
|
|
53
50
|
|
|
54
|
-
/**
|
|
55
|
-
* 扩展配置来自 Pi 设置文件(settings.json)的 `tsgw` 命名空间。
|
|
56
|
-
* 所有插件配置均放在此处;插件不读取环境变量
|
|
57
|
-
* (密钥仅由 Pi 自身的凭据解析机制处理)。
|
|
58
|
-
*/
|
|
59
|
-
interface TsgwSettings {
|
|
60
|
-
baseUrl?: string;
|
|
61
|
-
mcpUrl?: string;
|
|
62
|
-
tsSearch?: string;
|
|
63
|
-
traceHeaders?: boolean;
|
|
64
|
-
includeModels?: string[];
|
|
65
|
-
excludeModels?: string[];
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
function readTsgwSettings(): TsgwSettings {
|
|
69
|
-
try {
|
|
70
|
-
const raw: unknown = JSON.parse(
|
|
71
|
-
readFileSync(join(getAgentDir(), "settings.json"), "utf8"),
|
|
72
|
-
);
|
|
73
|
-
if (raw === null || typeof raw !== "object" || Array.isArray(raw))
|
|
74
|
-
return {};
|
|
75
|
-
const tsgw = (raw as { tsgw?: unknown }).tsgw;
|
|
76
|
-
if (tsgw === null || typeof tsgw !== "object" || Array.isArray(tsgw))
|
|
77
|
-
return {};
|
|
78
|
-
return tsgw as TsgwSettings;
|
|
79
|
-
} catch {
|
|
80
|
-
return {};
|
|
81
|
-
}
|
|
82
|
-
}
|
|
83
|
-
|
|
84
51
|
function rootForRuntime(configured: string | undefined): string {
|
|
85
52
|
try {
|
|
86
53
|
return normalizeRoot(configured);
|
|
@@ -198,11 +165,9 @@ async function resolveEffectiveModels(
|
|
|
198
165
|
return { models, gatewayIds, catalog: { ...catalog, count: models.length } };
|
|
199
166
|
}
|
|
200
167
|
|
|
201
|
-
export
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
const settings = readTsgwSettings();
|
|
205
|
-
registerTsgwMcp(pi, settings.mcpUrl);
|
|
168
|
+
export async function registerTsgwProvider(
|
|
169
|
+
pi: ExtensionAPI, settings: TsgwSettings,
|
|
170
|
+
): Promise<void> {
|
|
206
171
|
const root = rootForRuntime(settings.baseUrl);
|
|
207
172
|
const defaultSearchMode: WebSearchMode =
|
|
208
173
|
settings.tsSearch === "cached" || settings.tsSearch === "live"
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import type { WebSearchMode } from "
|
|
2
|
-
import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS } from "
|
|
1
|
+
import type { WebSearchMode } from "../models/_tools.ts";
|
|
2
|
+
import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS } from "../models/gateway-catalog.ts";
|
|
3
3
|
|
|
4
4
|
export interface CatalogStatus {
|
|
5
5
|
count: number;
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
2
|
-
import { builtinSearchSupport, resolveSearchDelegate } from "
|
|
3
|
-
import type { WebSearchMode } from "
|
|
4
|
-
import { searchLabel, type SearchSupport } from "
|
|
5
|
-
import { registerSearchProxyTool, SEARCH_PROXY_TOOL } from "./
|
|
2
|
+
import { builtinSearchSupport, resolveSearchDelegate } from "../models/web-search.ts";
|
|
3
|
+
import type { WebSearchMode } from "../models/_tools.ts";
|
|
4
|
+
import { searchLabel, type SearchSupport } from "../provider/status.ts";
|
|
5
|
+
import { registerSearchProxyTool, SEARCH_PROXY_TOOL } from "./proxy.ts";
|
|
6
6
|
|
|
7
7
|
interface SearchOptions {
|
|
8
8
|
defaultMode: WebSearchMode;
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
/** 搜索代理复用 Pi 的注册表、身份认证与协议适配器。 */
|
|
2
2
|
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
3
3
|
import { Type } from "typebox";
|
|
4
|
-
import { isPlainObject, type WebSearchMode } from "
|
|
5
|
-
import { applyModelOperations } from "
|
|
6
|
-
import { builtinSearchSupport, type SearchDelegate } from "
|
|
4
|
+
import { isPlainObject, type WebSearchMode } from "../models/_tools.ts";
|
|
5
|
+
import { applyModelOperations } from "../models/operations.ts";
|
|
6
|
+
import { builtinSearchSupport, type SearchDelegate } from "../models/web-search.ts";
|
|
7
7
|
|
|
8
8
|
export const SEARCH_PROXY_TOOL = "tsgw_search";
|
|
9
9
|
interface SearchProxyOptions {
|
package/index.ts
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import { registerTsgwMcp } from "./extensions/mcp.ts";
|
|
3
|
+
import { registerPrompts } from "./extensions/prompts.ts";
|
|
4
|
+
import { readTsgwSettings } from "./extensions/provider/config.ts";
|
|
5
|
+
import { registerTsgwProvider } from "./extensions/provider/index.ts";
|
|
6
|
+
import { registerUploadTool } from "./extensions/upload/index.ts";
|
|
7
|
+
|
|
8
|
+
/** 插件总入口:保持能力注册顺序,实现由各模块维护。 */
|
|
9
|
+
export default async function registerTsgw(pi: ExtensionAPI): Promise<void> {
|
|
10
|
+
registerUploadTool(pi);
|
|
11
|
+
registerPrompts(pi);
|
|
12
|
+
const settings = readTsgwSettings();
|
|
13
|
+
registerTsgwMcp(pi, settings.mcpUrl);
|
|
14
|
+
await registerTsgwProvider(pi, settings);
|
|
15
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-tsgw",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "面向 TOSSP AIH gateway 的 Pi 扩展:按厂商维护模型目录与思考策略,支持 openai-completions、openai-responses、anthropic-messages 和 google-generative-ai 协议。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"keywords": [
|
|
@@ -17,14 +17,14 @@
|
|
|
17
17
|
},
|
|
18
18
|
"pi": {
|
|
19
19
|
"extensions": [
|
|
20
|
-
"./
|
|
20
|
+
"./index.ts"
|
|
21
21
|
],
|
|
22
22
|
"skills": [
|
|
23
23
|
"./skills"
|
|
24
24
|
]
|
|
25
25
|
},
|
|
26
26
|
"scripts": {
|
|
27
|
-
"test": "tsc -p tsconfig.test.json && node dist/extensions/index.test.js && node dist/extensions/
|
|
27
|
+
"test": "tsc -p tsconfig.test.json && node dist/extensions/provider/index.test.js && node dist/extensions/prompts.test.js && node dist/extensions/provider/status.test.js && node dist/extensions/search/index.test.js && node dist/extensions/search/proxy.test.js && node dist/extensions/search/host-integration.test.js && node dist/extensions/provider/status-integration.test.js && node dist/extensions/models/gateway-catalog-metadata.test.js && node dist/extensions/models/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/index.test.js && node dist/extensions/mcp.test.js && node dist/extensions/mcp-host-integration.test.js && node dist/extensions/skills.test.js && node dist/extensions/skill-resources.test.js && node dist/extensions/upload/protocol.test.js && node dist/extensions/upload/schema.test.js && node dist/extensions/upload/uploader.test.js && node dist/extensions/upload/transport.test.js && node dist/extensions/upload/host-integration.test.js && node dist/extensions/upload/readiness-host.test.js",
|
|
28
28
|
"test:upload:live": "tsc -p tsconfig.test.json && node dist/extensions/upload/live.test.js"
|
|
29
29
|
},
|
|
30
30
|
"peerDependencies": {
|
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
-
|
|
3
1
|
/** 从用户规则迁入的记忆体系与既有维护授权。 */
|
|
4
2
|
export const MEMORY_RULES = `## 记忆体系
|
|
5
3
|
|
|
@@ -19,14 +17,3 @@ export const MEMORY_RULES = `## 记忆体系
|
|
|
19
17
|
- 工具细则以实时提示和技能为准;规则与技能在获准范围内跨端统一维护,单端修改不代表已经同步。
|
|
20
18
|
|
|
21
19
|
- smemo 条目内容维护(含永久删除)的持续授权见 \`skill:tsgw-smemo\`,不由此放宽文件、Git、服务、凭据或权限操作边界。`;
|
|
22
|
-
|
|
23
|
-
export function registerMemoryRules(pi: ExtensionAPI): void {
|
|
24
|
-
pi.on("before_agent_start", (event) => {
|
|
25
|
-
if (event.systemPromptOptions) {
|
|
26
|
-
event.systemPromptOptions.sections.tsgw_memory = MEMORY_RULES;
|
|
27
|
-
return;
|
|
28
|
-
}
|
|
29
|
-
// 保留已声明支持的旧宿主提示词接口。
|
|
30
|
-
return { systemPrompt: `${event.systemPrompt}\n\n${MEMORY_RULES}` };
|
|
31
|
-
});
|
|
32
|
-
}
|
|
@@ -75,7 +75,7 @@ gh api 'repos/OWNER/REPO/contents/docs/Guide%20%28CI%29.md?ref=feature%2Fci'
|
|
|
75
75
|
gh release view TAG --repo OWNER/ACTION
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
3.
|
|
78
|
+
3. 项目明确策略优先。新增或升级 GitHub Actions 引用时,默认采用经核验的官方最新稳定主版本浮动引用 `owner/repo@vN`,不自动改成完整 SHA 或精确补丁版本。项目策略或用户明确要求固定版本时遵循其要求;SHA 应核对其与官方目标版本的对应关系。非依赖升级任务不顺手修改引用;既有固定策略的依据不明时先核验,不擅自解除固定。
|
|
79
79
|
4. 主版本升级前比较输入、输出、权限、最低 Runner 版本、托管或自托管 Runner 兼容性及 Action 自身的 Node 运行时。项目 `setup-node` 的版本与运行 Action 的 Node 版本不是一回事;可复用工作流还要核对输入、secrets 与调用契约。
|
|
80
80
|
5. 修改后重新静态枚举 `uses:`,逐项核对预期 ref;除迁移确有必要的变更外,保留 `with`、jobs、permissions、secrets 和触发行为。运行已有的本地验证,不擅自安装验证工具;远程 CI、发布验证仅在授权内执行。
|
|
81
81
|
6. 汇报引用前后值、官方依据、兼容性检查及未验证项。离线时不宣称“最新”或“已通过远程 CI”。
|