@xopcai/xopc 0.0.286 → 0.0.292

package/dist/src/voice/realtime/runtime.js

@@ -1,6 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_changes, onUserContextChange } from "../../user-context/changes.js";
+import { decodeVoiceUplinkAudioFrame, encodeVoiceAudioFrame } from "../../../packages/realtime-protocol/src/voice-audio.js";
+import { VOICE_REALTIME_HEARTBEAT_INTERVAL_MS, VOICE_REALTIME_MAX_BINARY_FRAME_BYTES, VOICE_REALTIME_START_TIMEOUT_MS, VOICE_REALTIME_WS_PATH, init_voice, parseVoiceClientJsonFrame, parseVoiceClientMessage } from "../../../packages/realtime-protocol/src/voice.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../../providers/model-catalog-store.js";
 import { ALIBABA_REALTIME_TTS_MODEL } from "../tts/providers/alibaba-speech.js";
 import { resolveSpeechProviderChain } from "../tts/factory.js";
@@ -10,8 +12,6 @@ import { resolveSTTProviderChain } from "../stt/factory.js";
 import { mergeSttConfigFromAppConfig } from "../stt/config.js";
 import { voiceConversationInstructions } from "./conversation-context.js";
 import { createPreauthConnectionBudget } from "../../gateway/security/preauth-connection-budget.js";
-import { decodeVoiceUplinkAudioFrame, encodeVoiceAudioFrame } from "../../../packages/realtime-protocol/src/voice-audio.js";
-import { VOICE_REALTIME_HEARTBEAT_INTERVAL_MS, VOICE_REALTIME_MAX_BINARY_FRAME_BYTES, VOICE_REALTIME_START_TIMEOUT_MS, VOICE_REALTIME_WS_PATH, parseVoiceClientJsonFrame, parseVoiceClientMessage } from "../../../packages/realtime-protocol/src/voice.js";
 import { createAgentVoiceEngine } from "./agentEngine.js";
 import { resolveOmniRoute } from "./omniRoute.js";
 import { createOmniVoiceEngine } from "./omniEngine.js";
@@ -19,6 +19,7 @@ import { applyVoiceOutputGain } from "./pcm-output-gain.js";
 import { createRequire } from "node:module";
 import crypto from "node:crypto";
 //#region src/voice/realtime/runtime.ts
+init_voice();
 init_logger();
 init_changes();
 init_model_catalog_store();
@@ -45,10 +46,16 @@ function isStreamingProvider(provider) {
 }
 function resolveStreamingStt(config, language) {
 	const sttConfig = mergeSttConfigFromAppConfig(config.tools?.media?.audio, config.tools?.media);
-	for (const entry of resolveSTTProviderChain(sttConfig)) {
+	const configured = config.voice?.realtime?.stt;
+	const chain = configured ? [{
+		id: configured.provider,
+		model: configured.model
+	}] : resolveSTTProviderChain(sttConfig);
+	for (const entry of chain) {
 		const plugin = getMediaUnderstandingProvider(entry.id);
 		if (!isStreamingProvider(plugin)) continue;
-		const model = plugin.streamingAudio.defaultModel;
+		const model = plugin.id === "xopc-cloud" ? config.voice?.realtime?.stt?.model ?? entry.model ?? plugin.streamingAudio.defaultModel : plugin.streamingAudio.defaultModel;
+		if (!plugin.streamingAudio.models.includes(model)) continue;
 		return {
 			plugin,
 			model,
@@ -83,6 +90,7 @@ function resolveStreamingTts(config) {
 			providers: { [selection.provider]: {
 				...apiKey ? { apiKey } : {},
 				...slice.baseUrl ? { baseUrl: slice.baseUrl } : {},
+				...selection.model ? { model: selection.model } : {},
 				...selection.voice ? { voice: selection.voice } : selection.provider === "alibaba" ? { voice: "Cherry" } : {}
 			} }
 		};
@@ -101,7 +109,7 @@ function resolveStreamingTts(config) {
 		else if (provider.plugin.id === "xopc-cloud") {
 			const candidate = typeof provider.providerConfig.model === "string" ? provider.providerConfig.model : void 0;
 			const catalogModel = getModelCatalogStore().getSource("xopc-cloud")?.models.find((entry) => entry.id === candidate);
-			if (!catalogModel?.tts?.streaming || !catalogModel.tts.outputFormats.includes("pcm")) continue;
+			if (catalogModel?.availability !== "available" || !catalogModel.voice?.modes.includes("speech.stream")) continue;
 			model = candidate;
 		} else continue;
 		if (!model) continue;
@@ -205,7 +213,7 @@ var VoiceRealtimeRuntime = class {
 		const sessionId = crypto.randomUUID();
 		const ticket = crypto.randomBytes(32).toString("base64url");
 		const connectionEpoch = crypto.randomInt(1, 4294967296);
-		const maxSessionMs = request.purpose === "conversation" ? Math.min(config.voice.realtime.maxConversationMs, omni?.route.managed ? 30 * 6e4 : Number.MAX_SAFE_INTEGER) : config.voice.realtime.maxDictationMs;
+		const maxSessionMs = request.purpose === "conversation" ? Math.min(config.voice.realtime.maxConversationMs, omni?.maxSessionSeconds ? omni.maxSessionSeconds * 1e3 : Number.MAX_SAFE_INTEGER) : config.voice.realtime.maxDictationMs;
 		const claim = {
 			conversationSessionId,
 			sessionId,

package/dist/src/voice/stt/providers/xopc-cloud-transcription.js

@@ -2,16 +2,16 @@ import { getModelCatalogStore, init_model_catalog_store } from "../../../provide
 import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "../../../providers/xopc-cloud-config.js";
 import { getProviderAuthService, init_provider_auth_service } from "../../../providers/provider-auth-service.js";
 import { compareCatalogModels } from "../../../providers/model-catalog-ranking.js";
+import { openPlatformStt } from "../../platform-streams.js";
+import { platformVoiceModels, requirePlatformVoiceModel } from "../../platform-catalog.js";
 import { registerMediaUnderstandingProvider } from "../../../media-understanding/registry.js";
-import { openDashScopeStreamingStt } from "../../dashscope/streaming-stt-session.js";
 //#region src/voice/stt/providers/xopc-cloud-transcription.ts
 init_model_catalog_store();
 init_provider_auth_service();
 init_xopc_cloud_config();
-const DEFAULT_STREAMING_MODEL = "qwen-audio-3.0-asr-flash-streaming";
 function defaultModel() {
 	const source = getModelCatalogStore().getSource("xopc-cloud");
-	return source?.models.filter((model) => model.availability === "available" && model.kind === "stt").sort((left, right) => compareCatalogModels(left, right, source.recommended?.stt))[0]?.id;
+	return source?.models.filter((model) => model.availability === "available" && model.kind === "stt" && model.voice?.modes.includes("transcription")).sort((left, right) => compareCatalogModels(left, right, source.recommended?.stt))[0]?.id;
 }
 const xopcCloudTranscriptionProvider = {
 	id: "xopc-cloud",
@@ -22,6 +22,7 @@ const xopcCloudTranscriptionProvider = {
 	transcribeAudio: async (request) => {
 		const model = request.model ?? defaultModel();
 		if (!model) throw new Error("No XOPC Cloud speech-to-text model is available");
+		requirePlatformVoiceModel(model, "transcription");
 		const accessToken = await getProviderAuthService().resolveApiKey("xopc-cloud", request.signal);
 		if (!accessToken) throw new Error("XOPC Cloud authorization is unavailable");
 		const source = getModelCatalogStore().getSource("xopc-cloud");
@@ -50,22 +51,28 @@ const xopcCloudTranscriptionProvider = {
 	streamingAudio: {
 		inputSampleRates: [16e3],
 		turnDetection: ["server_vad"],
-		defaultModel: DEFAULT_STREAMING_MODEL,
-		models: [DEFAULT_STREAMING_MODEL]
+		get defaultModel() {
+			return platformVoiceModels("transcription.stream")[0]?.id ?? "";
+		},
+		get models() {
+			return platformVoiceModels("transcription.stream").map((model) => model.id);
+		}
 	},
 	openAudioStream: async (request) => {
+		const catalogModel = requirePlatformVoiceModel(request.model, "transcription.stream");
 		const accessToken = await getProviderAuthService().resolveApiKey("xopc-cloud", request.signal);
 		if (!accessToken) throw new Error("XOPC Cloud authorization is unavailable");
 		const source = getModelCatalogStore().getSource("xopc-cloud");
 		const baseUrl = (request.baseUrl ?? source?.baseUrl ?? resolveXopcModelRouterUrl()).replace(/\/+$/, "");
 		const relayUrl = new URL(`${baseUrl}/audio/transcriptions/realtime`);
 		relayUrl.protocol = relayUrl.protocol === "https:" ? "wss:" : "ws:";
-		relayUrl.searchParams.set("model", request.model || DEFAULT_STREAMING_MODEL);
-		return openDashScopeStreamingStt({
+		relayUrl.searchParams.set("model", request.model);
+		relayUrl.searchParams.set("service_version", String(catalogModel.voice.serviceVersion));
+		return openPlatformStt({
 			...request,
 			apiKey: accessToken,
 			baseUrl: relayUrl.toString(),
-			model: request.model || DEFAULT_STREAMING_MODEL
+			model: request.model
 		});
 	}
 };

package/dist/src/voice/tts/providers/xopc-cloud-speech.js

@@ -3,7 +3,8 @@ import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "../../../prov
 import { getProviderAuthService, init_provider_auth_service } from "../../../providers/provider-auth-service.js";
 import { compareCatalogModels } from "../../../providers/model-catalog-ranking.js";
 import { registerSpeechProvider } from "../speech-registry.js";
-import { openDashScopeStreamingTts } from "../../dashscope/streaming-tts-stream.js";
+import { openPlatformTts } from "../../platform-streams.js";
+import { requirePlatformVoiceModel } from "../../platform-catalog.js";
 //#region src/voice/tts/providers/xopc-cloud-speech.ts
 init_model_catalog_store();
 init_provider_auth_service();
@@ -37,11 +38,11 @@ const xopcCloudSpeechProvider = {
 	resolveConfig: ({ rawConfig }) => {
 		const raw = rawConfig["xopc-cloud"];
 		const slice = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
-		const model = typeof slice.model === "string" ? slice.model : availableModels()[0]?.id;
+		const model = typeof slice.model === "string" ? slice.model : availableModels().find((model) => model.voice?.modes.includes("speech"))?.id;
 		const catalogModel = availableModels().find((entry) => entry.id === model);
 		return {
 			model,
-			voice: typeof slice.voice === "string" ? slice.voice : catalogModel?.tts?.defaultVoice,
+			voice: typeof slice.voice === "string" ? slice.voice : catalogModel?.voice?.defaultVoice,
 			speed: readSpeed(slice.speed),
 			instructions: typeof slice.instructions === "string" && slice.instructions.trim() ? slice.instructions.trim() : void 0,
 			baseUrl: typeof slice.baseUrl === "string" ? slice.baseUrl : getModelCatalogStore().getSource("xopc-cloud")?.baseUrl ?? resolveXopcModelRouterUrl()
@@ -54,18 +55,10 @@ const xopcCloudSpeechProvider = {
 	listVoices: async ({ providerConfig }) => {
 		const config = readConfig(providerConfig ?? {});
 		if (!config.model) return [];
-		const token = await getProviderAuthService().resolveApiKey("xopc-cloud");
-		if (!token) return [];
-		const response = await fetch(`${config.baseUrl.replace(/\/+$/, "")}/audio/voices?model=${encodeURIComponent(config.model)}`, {
-			headers: { authorization: `Bearer ${token}` },
-			signal: AbortSignal.timeout(3e4),
-			redirect: "error"
-		});
-		if (!response.ok) return [];
-		return ((await response.json().catch(() => null))?.data ?? []).filter((voice) => typeof voice.id === "string").map((voice) => ({
-			id: voice.id,
-			...typeof voice.name === "string" ? { name: voice.name } : {}
-		}));
+		return availableModels().find((model) => model.id === config.model)?.voice?.voices.map(({ id, name }) => ({
+			id,
+			name
+		})) ?? [];
 	},
 	synthesize: async (request) => {
 		const config = readConfig(request.providerConfig);
@@ -73,6 +66,7 @@ const xopcCloudSpeechProvider = {
 		const voice = typeof request.providerOverrides?.voice === "string" ? request.providerOverrides.voice : config.voice;
 		if (!model || !voice) throw new Error("XOPC Cloud TTS model or voice is unavailable");
 		const catalogModel = availableModels().find((entry) => entry.id === model);
+		requirePlatformVoiceModel(model, "speech");
 		if (!catalogModel) throw new Error(`XOPC Cloud TTS model is unavailable: ${model}`);
 		const speed = readSpeed(request.providerOverrides?.speed ?? config.speed);
 		const instructions = typeof request.providerOverrides?.instructions === "string" ? request.providerOverrides.instructions.trim() : config.instructions;
@@ -115,18 +109,17 @@ const xopcCloudSpeechProvider = {
 		const model = typeof request.providerOverrides?.model === "string" ? request.providerOverrides.model : config.model;
 		const voice = typeof request.providerOverrides?.voice === "string" ? request.providerOverrides.voice : config.voice;
 		if (!model || !voice) throw new Error("XOPC Cloud realtime TTS model or voice is unavailable");
-		const catalogModel = availableModels().find((entry) => entry.id === model);
-		if (!catalogModel?.tts?.streaming || !catalogModel.tts.outputFormats.includes("pcm")) throw new Error(`XOPC Cloud TTS model does not support PCM streaming: ${model}`);
+		const catalogModel = requirePlatformVoiceModel(model, "speech.stream");
 		const token = await getProviderAuthService().resolveApiKey("xopc-cloud", request.signal);
 		if (!token) throw new Error("XOPC Cloud authorization is unavailable");
 		const relayUrl = new URL(`${config.baseUrl.replace(/\/+$/, "")}/audio/speech/realtime`);
 		relayUrl.protocol = relayUrl.protocol === "https:" ? "wss:" : "ws:";
 		relayUrl.searchParams.set("model", model);
+		relayUrl.searchParams.set("service_version", String(catalogModel.voice.serviceVersion));
 		const instructions = typeof request.providerOverrides?.instructions === "string" ? request.providerOverrides.instructions.trim() : config.instructions;
-		return openDashScopeStreamingTts({
+		return openPlatformTts({
 			apiKey: token,
 			baseUrl: relayUrl.toString(),
-			model,
 			voice,
 			text: request.text,
 			...instructions ? { instructions } : {},

package/dist/src/work-discovery/service.js

@@ -7,14 +7,14 @@ import { ActivityService } from "../activity/service.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_session_key, resolveConversationId } from "../routing/session-key.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
-import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { isLocalModelBaseUrl } from "../providers/model-call.js";
+import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { writeKnowledgeItem } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
 import { createPriorityWindow, createUserGoal } from "../user-model/goals.js";
 import { getAssertionSlot, getUserAssertion, linkAssertionEvidence, reconcileAssertion, setAssertionStatus } from "../user-model/repository.js";
 import "../user-model/index.js";
-import { isLocalModelBaseUrl } from "../providers/model-call.js";
 import { allowsRemoteSourceProcessing } from "../user-context/sources/processing-policy.js";
 import { analyzeUnderstandingSources, analyzeWorkContext, workDiscoveryResultMarkdown } from "./analyzer.js";
 import { createUnderstandingSourceRun, getUnderstandingSourceRun, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceGrantPolicies, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";

package/dist/src/workflows/service/workflow-run-service.js

@@ -1,8 +1,8 @@
 import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
 import { init_conversation_repository, resolveRoutedConversation } from "../../storage/sqlite/conversation-repository.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { extractProfileAgentId, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { extractProfileAgentId, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { getProjectWorkspacePathForSession } from "../../projects/workspace.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.286",
+  "version": "0.0.292",
   "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -166,7 +166,9 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
+    "@xopcai/computer-control-contract": "0.1.0",
     "@xopcai/browser-control-contract": "0.1.0",
+    "@xopcai/endpoint-tools-client": "0.0.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0",
@@ -236,7 +238,8 @@
     "build:extensions-ui": "node scripts/build-extensions-ui.mjs",
     "pack:browser-ext": "pnpm -C packages/browser-ext run pack",
     "sync:browser-ext-version": "node scripts/sync-browser-ext-version.mjs",
-    "electron:native:build": "node scripts/build-voice-hotkey-helper.mjs",
+    "computer:driver:setup": "node scripts/setup-computer-driver.mjs",
+    "electron:native:build": "node scripts/build-voice-hotkey-helper.mjs && node scripts/setup-computer-driver.mjs",
     "electron:dev": "pnpm run electron:native:build && cross-env ELECTRON_ENTRY=out/main/index.js electron-vite dev",
     "electron:vite:build": "cross-env ELECTRON_ENTRY=out/main/index.js electron-vite build",
     "electron:vite:build:package": "cross-env ELECTRON_ENTRY=out/main/index.js ELECTRON_VITE_SKIP_RENDERER=1 electron-vite build",

package/skills/creative/algorithmic-art/SKILL.md

@@ -2,6 +2,13 @@
 name: algorithmic-art
 description: Design reproducible, interactive generative-art studies as self-contained browser artifacts or workspace assets.
 metadata:
+  i18n:
+    en:
+      name: "Algorithmic Art"
+      description: "Design reproducible, interactive generative-art studies as self-contained browser artifacts or workspace assets."
+    zh-CN:
+      name: "算法艺术"
+      description: "设计可复现、可交互的生成艺术作品，并输出为独立浏览器作品或工作区资产。"
   xopc:
     emoji: "✨"
     requires_tools:

package/skills/creative/frontend-design/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: frontend-design
 description: Create distinctive, production-grade frontend interfaces, pages, components, dashboards, and HTML/CSS layouts.
+metadata:
+  i18n:
+    en:
+      name: "Frontend Design"
+      description: "Create distinctive, production-grade frontend interfaces, pages, components, dashboards, and HTML/CSS layouts."
+    zh-CN:
+      name: "前端设计"
+      description: "创建风格鲜明、可用于生产的前端界面、页面、组件、仪表盘及 HTML/CSS 布局。"
 license: Complete terms in LICENSE.txt
 ---
 

package/skills/creative/hatch-pet/SKILL.md

@@ -2,6 +2,13 @@
 name: hatch-pet
 description: Create and install a custom animated xopc desktop pet from a user description.
 metadata:
+  i18n:
+    en:
+      name: "Hatch Pet"
+      description: "Create and install a custom animated XOPC desktop pet from a user description."
+    zh-CN:
+      name: "孵化桌面宠物"
+      description: "根据用户描述创建并安装自定义的 XOPC 动画桌面宠物。"
   xopc:
     activates_capabilities:
       - desktop-pet-authoring

package/skills/creative/theme-factory/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: theme-factory
 description: Apply or generate cohesive color and font themes for artifacts, slides, documents, reports, and landing pages.
+metadata:
+  i18n:
+    en:
+      name: "Theme Factory"
+      description: "Apply or generate cohesive color and font themes for artifacts, slides, documents, reports, and landing pages."
+    zh-CN:
+      name: "主题工厂"
+      description: "为作品、幻灯片、文档、报告和落地页应用或生成协调统一的配色与字体主题。"
 license: Complete terms in LICENSE.txt
 ---
 

package/skills/documents/doc-coauthoring/SKILL.md

@@ -2,6 +2,13 @@
 name: doc-coauthoring
 description: Co-author substantial proposals, specifications, RFCs, and decision documents through context, structure, and reader-focused review.
 metadata:
+  i18n:
+    en:
+      name: "Document Co-authoring"
+      description: "Co-author substantial proposals, specifications, RFCs, and decision documents through context, structure, and reader-focused review."
+    zh-CN:
+      name: "文档协作撰写"
+      description: "通过梳理背景、搭建结构和面向读者的审阅，共同撰写提案、规范、RFC 与决策文档。"
   xopc:
     emoji: "🤝"
     requires_tools:

package/skills/documents/docx/SKILL.md

@@ -2,6 +2,13 @@
 name: docx
 description: Create, inspect, edit, render, and validate Word DOCX artifacts while preserving templates and tracked content.
 metadata:
+  i18n:
+    en:
+      name: "Word Documents"
+      description: "Create, inspect, edit, render, and validate Word DOCX artifacts while preserving templates and tracked content."
+    zh-CN:
+      name: "Word 文档"
+      description: "在保留模板和修订内容的同时，创建、检查、编辑、渲染并验证 Word DOCX 文档。"
   xopc:
     emoji: "📝"
     requires_tools:

package/skills/documents/pdf/SKILL.md

@@ -2,6 +2,13 @@
 name: pdf
 description: Read, create, inspect, combine, split, rotate, and validate PDF artifacts in the current workspace.
 metadata:
+  i18n:
+    en:
+      name: "PDF Documents"
+      description: "Read, create, inspect, combine, split, rotate, and validate PDF artifacts in the current workspace."
+    zh-CN:
+      name: "PDF 文档"
+      description: "在当前工作区中读取、创建、检查、合并、拆分、旋转并验证 PDF 文档。"
   xopc:
     emoji: "📄"
     requires_tools:

package/skills/documents/pptx/SKILL.md

@@ -2,6 +2,13 @@
 name: pptx
 description: Create, inspect, edit, render, and validate PowerPoint PPTX presentations with deliberate visual hierarchy.
 metadata:
+  i18n:
+    en:
+      name: "PowerPoint Presentations"
+      description: "Create, inspect, edit, render, and validate PowerPoint PPTX presentations with deliberate visual hierarchy."
+    zh-CN:
+      name: "PowerPoint 演示文稿"
+      description: "创建、检查、编辑、渲染并验证具有清晰视觉层级的 PowerPoint PPTX 演示文稿。"
   xopc:
     emoji: "📊"
     requires_tools:

package/skills/documents/xlsx/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: xlsx
 description: "Create, read, edit, clean, format, chart, or convert spreadsheet files such as .xlsx, .xlsm, .csv, and .tsv."
+metadata:
+  i18n:
+    en:
+      name: "Spreadsheets"
+      description: "Create, read, edit, clean, format, chart, or convert spreadsheet files such as .xlsx, .xlsm, .csv, and .tsv."
+    zh-CN:
+      name: "电子表格"
+      description: "创建、读取、编辑、清理、格式化、绘图或转换 .xlsx、.xlsm、.csv 和 .tsv 等电子表格文件。"
 license: Proprietary. LICENSE.txt has complete terms
 ---
 
@@ -289,4 +297,4 @@ The script returns JSON with error details:
 **For Excel files themselves**:
 - Add comments to cells with complex formulas or important assumptions
 - Document data sources for hardcoded values
-- Include notes for key calculations and model sections
+- Include notes for key calculations and model sections

package/skills/engineering/build-xopc-local-app/SKILL.md

@@ -2,6 +2,13 @@
 name: build-xopc-local-app
 description: Build and iteratively improve a user-owned local XOPC app while preserving its stable extension identity, UI sandbox, and Phase 1 capability boundary.
 metadata:
+  i18n:
+    en:
+      name: "Build XOPC Local App"
+      description: "Build and iteratively improve a user-owned local XOPC app while preserving its stable extension identity, UI sandbox, and Phase 1 capability boundary."
+    zh-CN:
+      name: "构建 XOPC 本地应用"
+      description: "构建并迭代改进用户拥有的 XOPC 本地应用，同时保持稳定的扩展身份、UI 沙箱和第一阶段能力边界。"
   xopc:
     emoji: "🧩"
     requires_tools:

package/skills/engineering/define-task/SKILL.md

@@ -2,6 +2,13 @@
 name: define-task
 description: Define, create, or refine an explicitly requested persistent xopc Task with a verifiable Task Contract; do not use for ordinary one-off work.
 metadata:
+  i18n:
+    en:
+      name: "Define Task"
+      description: "Define, create, or refine an explicitly requested persistent XOPC Task with a verifiable Task Contract; do not use for ordinary one-off work."
+    zh-CN:
+      name: "定义任务"
+      description: "为用户明确要求的持久 XOPC 任务定义、创建或完善可验证的任务契约；不用于普通的一次性工作。"
   xopc:
     emoji: "🎯"
     requires_tools:

package/skills/engineering/diagnose/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: diagnose
 description: Disciplined reproduce → minimise → hypothesise → instrument → fix loop for hard bugs and performance regressions.
+metadata:
+  i18n:
+    en:
+      name: "Diagnose"
+      description: "A disciplined reproduce, minimize, hypothesize, instrument, and fix loop for difficult bugs and performance regressions."
+    zh-CN:
+      name: "问题诊断"
+      description: "以复现、最小化、提出假设、插桩验证和修复为闭环，诊断疑难缺陷与性能回退。"
 ---
 
 # Diagnose

package/skills/engineering/tdd/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: tdd
 description: Test-driven development using a red-green-refactor loop for features, bug fixes, and integration tests.
+metadata:
+  i18n:
+    en:
+      name: "Test-Driven Development"
+      description: "Test-driven development using a red-green-refactor loop for features, bug fixes, and integration tests."
+    zh-CN:
+      name: "测试驱动开发"
+      description: "使用红灯、绿灯、重构循环完成新功能、缺陷修复和集成测试。"
 ---
 
 # Test-Driven Development

package/skills/tools/find-skills/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: find-skills
 description: Find and evaluate installable agent skills across the XOPC Store, ClawHub, and skills.sh. Use when a user asks whether a skill exists, wants capability recommendations, or wants help choosing a high-value skill.
+metadata:
+  i18n:
+    en:
+      name: "Find Skills"
+      description: "Find and evaluate installable agent skills across the XOPC Store, ClawHub, and skills.sh."
+    zh-CN:
+      name: "查找技能"
+      description: "在 XOPC Store、ClawHub 和 skills.sh 中查找并评估可安装的智能体技能。"
 ---
 
 # Find Skills

package/skills/tools/github/SKILL.md

@@ -3,6 +3,13 @@ name: github
 description: "Interact with GitHub using the `gh` CLI for issues, PRs, CI runs, and advanced API queries."
 license: MIT
 metadata:
+  i18n:
+    en:
+      name: "GitHub"
+      description: "Interact with GitHub using the gh CLI for issues, pull requests, CI runs, and advanced API queries."
+    zh-CN:
+      name: "GitHub"
+      description: "使用 gh CLI 操作 GitHub 的 Issue、拉取请求、CI 任务和高级 API 查询。"
   xopc:
     requires_toolsets: [terminal]
     requires:

package/skills/tools/summarize/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: summarize
 description: Summarize URLs, files, and YouTube videos.
+metadata:
+  i18n:
+    en:
+      name: "Summarize"
+      description: "Summarize URLs, files, and YouTube videos."
+    zh-CN:
+      name: "内容摘要"
+      description: "总结网页链接、文件和 YouTube 视频内容。"
 license: MIT
 ---
 

package/skills/tools/webapp-testing/SKILL.md

@@ -3,6 +3,13 @@ name: webapp-testing
 description: Test local web applications with Playwright scripts, screenshots, browser logs, and UI behavior checks.
 license: Complete terms in LICENSE.txt
 metadata:
+  i18n:
+    en:
+      name: "Web App Testing"
+      description: "Test local web applications with Playwright scripts, screenshots, browser logs, and UI behavior checks."
+    zh-CN:
+      name: "Web 应用测试"
+      description: "使用 Playwright 脚本、截图、浏览器日志和界面行为检查来测试本地 Web 应用。"
   xopc:
     requires_toolsets: [terminal]
 ---
@@ -96,4 +103,4 @@ with sync_playwright() as p:
 - **examples/** - Examples showing common patterns:
   - `element_discovery.py` - Discovering buttons, links, and inputs on a page
   - `static_html_automation.py` - Using file:// URLs for local HTML
-  - `console_logging.py` - Capturing console logs during automation
+  - `console_logging.py` - Capturing console logs during automation