后端 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[];};成员说明:
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];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[];};MarketplaceFailureCode
export type MarketplaceFailureCode = (typeof MARKETPLACE_FAILURE_CODES)[number];