翻译:

图书馆在每一块 鸡尾酒。 。 。 .
应用程序构建器、功能范围、多个扩展共享的设置和设置屏幕 Alt+S屏幕是它给Pi添加的.

npm install @adeildo/pi-kit

这是一个图书馆,而不是一个皮包。 它的API跟随包裹的需求,对其他人没有承诺.

应用程序和其中的特征

import { createApp, defineFeature, matching, setting } from "@adeildo/pi-kit";
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";

export const version = setting({
    id: "subscription.claudeCodeVersion",
    default: "2.1.280",
    decoder: matching(/^\d+\.\d+\.\d+$/, "a version like 2.1.280"),
});

export const subscription = defineFeature({
    id: "subscription",
    description: "Bill Anthropic OAuth requests to the Claude plan",
    settings: [version],
    setup(scope) {
        scope.on("before_provider_headers", (event) => {
            event.headers["user-agent"] = `claude-cli/${version.get(scope)}`;
        });
    },
});

export default function (pi: ExtensionAPI): void {
    createApp(pi, { name: "pi-harness" }).use(subscription).build();
}

每个软件包声明的扩展是一个具有一个或多个特性的应用程序. 应用程序 name 在每一个警告之前。 吊带宣布每个功能一个延伸,所以 pi config 自动关闭, 他们都读取相同的设置文件 .

有个什么特点

setup 获得该特性的范围。 它延伸 ExtensionAPI,所以每一种pi方法都在那里, 这些线到特征:

A 类 setup 投出一个警告 其它的特征仍然在上升 如果一个 Pi 进程中的两个应用程序挂载相同的特性 id, 第一个运行它, 第二个日志谁拥有它 .

还有什么可以分享的

除了应用程序和设置之外,套件还持有每套件会写出两次的东西.

设置

每个应用程序都读 ~/.pi/agent/extensions/pi-harness/settings.json设置 id 它的路径在那个文件中。 一个商店只读取它自己宣布的特性的设置,所以属于另一个应用程序的密钥从不产生警告.

store.set 写入一个值和 store.setAll 在一个传中数个,这就是一个特性在保存一个完整的配置对象时所做的. 已经读取了相同内容的值没有被写入,所以文件持有的是被决定的,而不是每个默认的复制件,这样就会被冻结.

一个设置 project: true 也读作 <project>/.pi/extensions/pi-harness/settings.json,但只有一次Pi信任项目,项目价值在那里获胜. 没有这道旗的任何东西都是全球性的,试图设置它的项目文件都会得到警告,所以一个被克隆的寄存器不能不询问就放松运行.

无法解码的值会被忽略,警告名称为文件和密钥 .

设置屏幕

Alt+S 或者说 /harness 打开它。 每个功能都是分页,行从两个位置来.

带有 ui 获得一行 :

export const cursor = setting({
    id: "look.frame.cursor",
    default: "bar",
    decoder: literal("block", "bar", "underline"),
    ui: { section: "Editor", label: "Cursor", description: "The editor's cursor." },
});

解码器取出编辑器: boolean 是一个切换, literal 一个选择, integer 一个数字, stringList 名单. ui.control 标签选项或添加预设.

还有什么要说的 scope.screen数字 : value 为会话状态, action 为了跑步, info 说实话.

scope.screen.action({
    id: "judge.test",
    section: "Judge",
    label: "Test the judge",
    description: "Sends one real request.",
    run: (ctx) => probe(ctx),
});

屏幕上输入的值通过与文件相同的解码器. 特性选项 tab 财务报告和审定财务报表 sections 设置标签名称和分区顺序.

关闭一个特性

每个功能也得到 features.<id>.enabled,默认情况下。 一个从未运行的功能 setup,所以它记录什么也没有损失。 变化在接下来 /reload。 。 。 .

事件和合同

// contracts/accounts.ts
export const ACCOUNT = defineContract<AccountState, string>("accounts:state", decoder);

ACCOUNT.provide(scope, (provider) => inUse(provider)); // the owner answers
ACCOUNT.current(scope, "anthropic"); // a reader asks while drawing
ACCOUNT.changed(scope, state, "anthropic"); // the owner announces a change
ACCOUNT.onChanged(scope, (state, provider) => …); // a bridge follows it

合同是一个特征所知道的,另一个特征所读的。 它走过来了 pi.events,询问 harness:<name> 并公布于 harness:<name>:changed 有了全新的价值,所以桥梁可以跟随每份合同而无需投票. 带有密钥的合同,如呼叫的裁决或提供者的账户,将密钥作为又一个论据. 无论是共享一个应用还是来自不同的软件包,有两个特性的行为都是一样的. 该值可能出自另一个包的更古老或更新版本,因此在到达时会被解码,而一个不解码的则会被以警告的方式丢出.

这些规则适用于每一项合同:

• 它被宣布为 contracts/ 在这里,从来没有在包 拥有国家。 读者则不依赖主人,两者均不相干.
• 值是普通的JSON,没有函数、类或 Date,所以远程控制或网络UI可以转发任何合同而不知道里面有什么.
• 价值可以获得田地,但永不丧失.

要显示的会话是例外: a SessionSource 是一个具有函数的对象, 因此它在原始通道上运行 harness:sources远程回答. sourceFor 当会话在此机器上时, 将返回到会话文件 。 屏幕上显示一个就完了 contracts/views.ts数字 : openView 询问 harness:view.open,以及 canOpenView 有谁愿意.

测试

@adeildo/pi-kit/testing 已经 fakePi(), (中文(简体) ), fakeScope() 财务报告和审定财务报表 fakeContext()。两个假的一 createEventBus() 在同一 Pi 进程中表现为两个扩展,以及 fire 运行处理器的顺序 并返回每个返回的东西.

鸡尾酒 由 adeildo.dev (英语)