跳转到内容

后端 web-contracts-src-backend:ChatGptReasoningEffort – MarketplaceFailureCode

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

返回接口索引

ChatGptReasoningEffort · DEFAULT_CHATGPT_BASE_PATH · DEFAULT_GENERATION_MODELS_BASE_PATH · DEFAULT_GITHUB_MARKETPLACE_REPOS · DEFAULT_PROVIDERS_BASE_PATH · EXTENSION_INSTALL_PHASES · ExtensionInstallFailure · ExtensionInstallJobStatus · ExtensionInstallJobView · ExtensionInstallOutcome · ExtensionInstallPhase · ExtensionTrust · FORBIDDEN_CREDENTIAL_FIELDS · GenerationModelPolicyView · GenerationModelsSnapshot · GenerationModelsWriteRequest · HOST_IDENTITY_PATH · HostIdentity · MARKETPLACE_FAILURE_CODES · MARKETPLACE_LOCAL_FILE_SOURCE_ID · ManagedVersionStatusView · MarketplaceExtensionDetailView · MarketplaceExtensionInfo · MarketplaceFailureCode

ChatGptReasoningEffort

export type ChatGptReasoningEffort = (typeof CHATGPT_REASONING_EFFORTS)[number];

关联类型:CHATGPT_REASONING_EFFORTS

DEFAULT_CHATGPT_BASE_PATH

export const DEFAULT_CHATGPT_BASE_PATH: "/api/oauth-agent";

DEFAULT_GENERATION_MODELS_BASE_PATH

export const DEFAULT_GENERATION_MODELS_BASE_PATH: "/api/generation-models";

DEFAULT_GITHUB_MARKETPLACE_REPOS

缺省市场仓库(公开仓):GitHub Release 来源开箱即用的候选仓库。 配置 extensions.marketplace.github.repos 可整体替换它。

export const DEFAULT_GITHUB_MARKETPLACE_REPOS: "woohaa3/woohaa3-marketplace";

DEFAULT_PROVIDERS_BASE_PATH

export const DEFAULT_PROVIDERS_BASE_PATH: "/api/providers";

EXTENSION_INSTALL_PHASES

安装流水线阶段(design D6)。migrate 本期只预留,声明了即拒绝。

export const EXTENSION_INSTALL_PHASES: readonly ["queued", "resolve", "download", "verify", "stage", "preflight", "commit", "reload", "observe"];

ExtensionInstallFailure

export type ExtensionInstallFailure = {
readonly code: MarketplaceFailureCode;
readonly message: string;
readonly issues?: readonly string[];
};

关联类型:MarketplaceFailureCode

成员说明:

  • message:安全的中文说明,不含密钥或远端正文。
  • issues:MARKETPLACE_PREFLIGHT_FAILED 时附预检错误。

ExtensionInstallJobStatus

任务终态与中间态。

export type ExtensionInstallJobStatus = "running" | "succeeded" | "failed" | "cancelled";

ExtensionInstallJobView

GET /api/extensions/install/:jobId 的视图。

export type ExtensionInstallJobView = {
readonly jobId: string;
readonly action: "install" | "uninstall" | "rollback";
readonly sourceId: string;
readonly extensionId?: string;
readonly version?: string;
readonly status: ExtensionInstallJobStatus;
readonly phase: ExtensionInstallPhase;
readonly progress?: number;
readonly outcome?: ExtensionInstallOutcome;
readonly failure?: ExtensionInstallFailure;
readonly startedAt: string;
readonly finishedAt?: string;
};

关联类型:ExtensionInstallJobStatus · ExtensionInstallPhase · ExtensionInstallOutcome · ExtensionInstallFailure

成员说明:

  • progress:0–1;阶段内无法估算时缺省。

ExtensionInstallOutcome

成功时的结果:

  • installed:纯前端扩展已热登记;
  • restart-required:含后端代码,需要受控重启后生效;
  • already-current:已是当前版本,未改 revision。
export type ExtensionInstallOutcome = "installed" | "restart-required" | "already-current";

ExtensionInstallPhase

export type ExtensionInstallPhase = (typeof EXTENSION_INSTALL_PHASES)[number];

关联类型:EXTENSION_INSTALL_PHASES

ExtensionTrust

受管扩展的信任级别。signed / certified 为已验证;unsigned 是用户确认后安装的未验证包。

export type ExtensionTrust = `signed:${string}` | `certified:${string}:${string}` | "unsigned";

FORBIDDEN_CREDENTIAL_FIELDS

服务端固定拒绝的地址字段:由插件写死,不接受用户输入。

export const FORBIDDEN_CREDENTIAL_FIELDS: readonly ["baseURL", "baseUrl", "apiBaseURL", "appBaseURL", "endpoint", "url"];

GenerationModelPolicyView

单个模型策略(公开视图)。

export type GenerationModelPolicyView = {
modelKey: string;
providerId: string;
modelType: "language" | "image" | "video" | "audio" | "motion";
title?: string;
enabled: boolean;
isDefault: boolean;
order?: number;
taskTimeoutMs?: number;
interaction?: {
id: string;
version: number;
};
tombstone?: boolean;
executable: boolean;
extensionId?: string;
notice?: string;
};

成员说明:

  • executable:是否在注册表中可执行(未注册 = 不可执行,仅策略占位)。
  • extensionId:提供该模型的宿主插件 id。 由注册表投影得出:Provider 注册时声明的 extensionId。设置页用它把没有 providers.<id> 配置段的 Provider(例如「服务端接入」)的模型归到自己的卡片。 策略里残留的历史行(Provider 已卸载)没有这个字段。缺省 = 旧宿主 / 历史策略行。
  • notice:模型行上的短标签(来自 Provider 的 GenerationModelDefinition.notice)。 缺省 = 不显示;只在「需要解释这个模型为什么还在这里/来自哪」时使用。

GenerationModelsSnapshot

export type GenerationModelsSnapshot = {
revision: number;
initialized: boolean;
models: GenerationModelPolicyView[];
catalogRevision?: number;
};

关联类型:GenerationModelPolicyView

成员说明:

  • catalogRevision:当前任务目录修订。 浏览器已经周期轮询本快照;Provider 注册/可用性/模型描述版本变化时该值单调前进, 前端据此使任务目录缓存失效。缺省视为「无此信号」(旧宿主)。

GenerationModelsWriteRequest

管理写入请求(expectedRevision 并发控制)。

export type GenerationModelsWriteRequest = {
expectedRevision: number;
models: Array<{
modelKey: string;
enabled: boolean;
isDefault?: boolean;
title?: string;
order?: number;
taskTimeoutMs?: number;
interaction?: {
id: string;
version: number;
};
tombstone?: boolean;
}>;
};

HOST_IDENTITY_PATH

宿主身份端点的路径:扫描器与所有客户端共用这一个常量。

export const HOST_IDENTITY_PATH: "/api/host/identity";

HostIdentity

一次身份应答的载荷。

全部字段都是可比较的事实,不含任何可写能力:

  • instanceId:实例指纹的稳定部分。同一份数据目录在同一进程生命周期内不变;
  • dataDir:数据目录绝对路径。它是「这份数据归谁」最直接的判据;
  • startedAt:本次进程启动时刻。同一数据目录被重启后 instanceId 变,据此能区分「同一份数据的两次启动」;
  • version:宿主应用版本;与 protocolVersion 分开,后者是内部协议兼容性。
export type HostIdentity = {
instanceId: string;
dataDir: string;
startedAt: string;
version: string;
protocolVersion: number;
};

成员说明:

  • instanceId:实例指纹:由数据目录与启动时刻派生,用于跨端口合并同一实例的多个面。
  • dataDir:数据目录绝对路径(本机路径,不含任何凭据)。
  • startedAt:本次进程启动时刻(ISO)。
  • version:宿主应用版本;取不到时为空串(开发构建常见)。
  • protocolVersion:内部协议版本;与 WOOHAA3_PROTOCOL_VERSION 同源。

MARKETPLACE_FAILURE_CODES

安装失败码(design D11)。稳定短标识,前端据此给出中文原因。

export const MARKETPLACE_FAILURE_CODES: readonly ["MARKETPLACE_SOURCE_UNAVAILABLE", "MARKETPLACE_SOURCE_NOT_FOUND", "MARKETPLACE_ENGINES_INCOMPATIBLE", "MARKETPLACE_DEPENDENCY_UNSATISFIED", "MARKETPLACE_BUILTIN_CONFLICT", "MARKETPLACE_PUBLISHER_CHANGED", "MARKETPLACE_DOWNLOAD_FAILED", "MARKETPLACE_PACKAGE_TOO_LARGE", "MARKETPLACE_DIGEST_MISMATCH", "MARKETPLACE_SIGNATURE_INVALID", "MARKETPLACE_SIGNATURE_UNTRUSTED", "MARKETPLACE_UNSIGNED_REJECTED", "MARKETPLACE_ARCHIVE_UNSAFE", "MARKETPLACE_PREFLIGHT_FAILED", "MARKETPLACE_FORBIDDEN_DECLARATION", "MARKETPLACE_VERSION_CONTENT_CONFLICT", "MARKETPLACE_REVISION_CONFLICT", "MARKETPLACE_RESTART_UNSUPPORTED", "MARKETPLACE_NOT_INSTALLED", "MARKETPLACE_NO_PREVIOUS_VERSION", "MARKETPLACE_WRITER_LOCKED", "MARKETPLACE_INSTALLATIONS_CORRUPT", "MARKETPLACE_UNINSTALL_DRAINING", "MARKETPLACE_UNAVAILABLE", "MARKETPLACE_CANCELLED", "MARKETPLACE_PACKAGE_INVALID", "MARKETPLACE_SWAP_FAILED"];

MARKETPLACE_LOCAL_FILE_SOURCE_ID

核心自带的本地文件来源(上传 .wxt)。

export const MARKETPLACE_LOCAL_FILE_SOURCE_ID: "local-file";

ManagedVersionStatusView

受管扩展当前版本在来源侧的状态。

  • available:该版本仍在来源可用版本中;
  • withdrawn:来源标记为已撤回,或扩展仍在但该版本已不在可用列表中(来源只对普通用户返回已审核版本);
  • unknown:来源不可用 / 查询失败 / 来源不提供版本详情——设置面不显示任何提示。 只用于展示:不强制卸载,不影响已安装副本运行。
export type ManagedVersionStatusView = {
readonly extensionId: string;
readonly version: string;
readonly sourceId: string;
readonly status: "available" | "withdrawn" | "unknown";
readonly reason?: string;
readonly latest?: string;
readonly checkedAt: string;
};

成员说明:

  • latest:来源当前最高可用版本(高于已装版本时设置面提示升级)。

MarketplaceExtensionDetailView

GET /api/extensions/marketplace/extension 的视图(本机宿主投影)。

export type MarketplaceExtensionDetailView = {
readonly sourceId: string;
readonly extension: MarketplaceExtensionInfo;
readonly trustedKeyIds: readonly string[];
readonly signingKeys: readonly (MarketplaceSigningKey & {
readonly trusted: boolean;
})[];
readonly installedVersion?: string;
readonly installedKind?: "builtin" | "managed";
readonly latestVersion?: string;
readonly updateAvailable?: boolean;
};

关联类型:MarketplaceExtensionInfo · MarketplaceSigningKey

成员说明:

  • trustedKeyIds:版本 keyId → 本机是否已信任(extensions.marketplace.trustedKeys)。
  • signingKeys:来源声明的发布公钥(只用于「信任此公钥」入口展示指纹;不自动信任)。
  • installedVersion:本机当前生效的版本(受管优先;没有受管版本时取内置版本)。 内置与受管同 id 时,只有更高的受管版本才会覆盖内置版本。
  • installedKind:当前生效版本来自哪里:builtin 为随客户端打包的内置版本,managed 为市场安装的受管版本。
  • latestVersion:来源当前可安装的最高已审核版本(仅展示;撤回/待审不参与)。
  • updateAvailable:是否存在比本机当前版本更高的可安装版本(严格 semver)。

MarketplaceExtensionInfo

export type MarketplaceExtensionInfo = {
readonly extensionId: string;
readonly label: string;
readonly description?: string;
readonly icon?: string;
readonly versions: readonly MarketplaceVersionInfo[];
};

关联类型:MarketplaceVersionInfo

MarketplaceFailureCode

export type MarketplaceFailureCode = (typeof MARKETPLACE_FAILURE_CODES)[number];

关联类型:MARKETPLACE_FAILURE_CODES