跳转到内容

后端 web-contracts-src-backend:MarketplaceSigningKey – sameHostInstance

本页由当前 SDK 声明自动生成。 导入入口:@woohaa3/contracts。

返回接口索引

MarketplaceSigningKey · MarketplaceSourceDetails · MarketplaceVersionInfo · ProviderCredentialView · ProviderCredentialsSnapshot · ProviderCredentialsWriteRequest · decodeChatGptGenerateRequest · decodeChatGptRequestIdQuery · decodeGenerationModelsWrite · decodeProviderCredentialsWrite · isChatGptAuthState · isChatGptGenerationMode · isChatGptReasoningEffort · isMarketplaceFailureCode · sameHostInstance

MarketplaceSigningKey

来源可选的发布签名公钥(来源声明;本机是否信任由本机配置决定,D7)。

export type MarketplaceSigningKey = {
readonly keyId: string;
readonly label?: string;
readonly publicKey: string;
};

MarketplaceSourceDetails

来源的可选扩展能力:版本详情与发布公钥。MarketplaceSource 的最小形状(search / resolve / download) 不变;实现了这两个方法的来源,本机宿主可以展示版本列表与「信任此公钥」入口。

export type MarketplaceSourceDetails = {
getExtension?(extensionId: string, signal: AbortSignal, includeVersions?: readonly string[]): Promise<MarketplaceExtensionInfo | null>;
signingKeys?(signal: AbortSignal): Promise<readonly MarketplaceSigningKey[]>;
};

关联类型:MarketplaceExtensionInfo · MarketplaceSigningKey

成员说明:

  • getExtension:includeVersions:请来源同时带回这些版本的状态(含已撤回),供已撤回提示使用;来源可忽略。

MarketplaceVersionInfo

来源侧的一个可见版本(展示用;来源返回的状态与 keyId 不参与信任判定)。

export type MarketplaceVersionInfo = {
readonly version: string;
readonly engines?: ExtensionEngines;
readonly dependencies?: Readonly<Record<string, string>>;
readonly packageDigest: string;
readonly size: number;
readonly keyId?: string;
readonly signerKeyId?: string;
readonly certificateId?: string;
readonly publisherId?: string;
readonly trustDomain?: string;
readonly publishedAt?: string;
readonly state?: string;
readonly yankReason?: string;
};

关联类型:ExtensionEngines

成员说明:

  • keyId:发布签名公钥 keyId(sha256(SPKI DER) 前 16 hex;v1 兼容展示口径)。
  • signerKeyId:证书包(v2)的完整公钥指纹、证书、发布者与信任域;裸 key 版本为空。
  • state:来源声明的状态(如 approved / yanked);客户端只展示。
  • yankReason:来源声明的撤回原因(仅已撤回版本;来源不提供时缺省)。

ProviderCredentialView

一个 Provider 的公开凭据状态(不含明文)。

export type ProviderCredentialView = {
providerId: string;
label: string;
description?: string;
fields: Array<{
key: string;
label: string;
fixedBaseUrl?: string;
placeholder?: string;
}>;
configured: boolean;
};

成员说明:

  • fields:只读展示的连接地址(由插件固定)。
  • configured:是否已在后端内存中有该 Provider 的凭据。

ProviderCredentialsSnapshot

export type ProviderCredentialsSnapshot = {
providers: ProviderCredentialView[];
};

关联类型:ProviderCredentialView

ProviderCredentialsWriteRequest

凭据写入请求:只接受字段值;地址字段被服务端忽略。

export type ProviderCredentialsWriteRequest = {
fields: Record<string, string>;
};

decodeChatGptGenerateRequest

解码生成请求(结构校验;字段级语义在服务端校验)。

export function decodeChatGptGenerateRequest(body: unknown): DecodeResult<ChatGptGenerateRequest>;

关联类型:DecodeResult · ChatGptGenerateRequest

decodeChatGptRequestIdQuery

解码 requestId 查询参数(回执恢复)。

export function decodeChatGptRequestIdQuery(value: string | null | undefined): DecodeResult<{ requestId: string; }>;

关联类型:DecodeResult

decodeGenerationModelsWrite

export function decodeGenerationModelsWrite(body: unknown): DecodeResult<GenerationModelsWriteRequest>;

关联类型:DecodeResult · GenerationModelsWriteRequest

decodeProviderCredentialsWrite

export function decodeProviderCredentialsWrite(body: unknown): DecodeResult<ProviderCredentialsWriteRequest>;

关联类型:DecodeResult · ProviderCredentialsWriteRequest

isChatGptAuthState

export function isChatGptAuthState(value: unknown): value is ChatGptAuthState;

关联类型:ChatGptAuthState

isChatGptGenerationMode

export function isChatGptGenerationMode(value: unknown): value is ChatGptGenerationMode;

关联类型:ChatGptGenerationMode

isChatGptReasoningEffort

export function isChatGptReasoningEffort(value: unknown): value is ChatGptReasoningEffort;

关联类型:ChatGptReasoningEffort

isMarketplaceFailureCode

export function isMarketplaceFailureCode(value: unknown): value is MarketplaceFailureCode;

关联类型:MarketplaceFailureCode

sameHostInstance

判定两份身份是否同一个实例。

判据是 instanceId 相等:它已经把数据目录与启动时刻合并进指纹,所以「同一数据目录被重启」 会被判成不同实例(这正是想要的——重启后挂载状态之外的内存态都变了)。

export function sameHostInstance(left: HostIdentity, right: HostIdentity): boolean;

关联类型:HostIdentity