@mearl/app-profiles 3.0.0-beta.4 → 3.0.0-beta.5

package/README.md

@@ -1,15 +1,36 @@
 # @mearl/app-profiles
 
-内置飞猪、淘宝、微信、支付宝的基础 UA/版本档案。四份档案保留当前 UA 格式和版本替换，不内置桥对象、App 设置、scheme 路由、业务响应和完整容器实现。
+核心不内置 App 档案。App UA、版本、桥对象、设置、scheme 路由、业务响应和容器实现均由安装的能力包提供；本包负责声明式档案校验、编译与设置覆盖。
 
 ```ts
-import { resolveAppProfile } from '@mearl/app-profiles';
-const profile = resolveAppProfile('taobao', { os: 'android', appVersion: '10.65.0' });
-console.log(profile.ua);
+import { resolveAppProfileDefinition, type AppProfile } from '@mearl/app-profiles';
+
+export function compileInstalledApp(definition: AppProfile) {
+  return resolveAppProfileDefinition(definition, { os: 'android' });
+}
 ```
 
 宿主可以向 resolveAppProfile 或 resolveAppProfileDefinition 提供已校验的动态定义；编译器保留桥、设置及 pageRuntime 描述，不执行能力代码。定义与选项被复制并绑定 revision，插件升级不直接改写活动文档。
 
 resolveAppProfileUpdate、rebuildAppProfileConfig 和 updateAppProfileSetting 保持显式选项、设备外观及方法覆盖的优先级。preset 默认值由宿主传入，用户已有选择继续优先；能力包安装成功不等于默认配置已经应用。
 
-完整 App 行为由能力包声明并安装到受控页面；真实设备授权仍由相应宿主能力执行。本包与基础运行时的迁入没有切换当前产品的实现来源，完整产品验收进度见 [迁移说明](../../docs/migration.md)。
+完整 App 行为由能力包声明并安装到受控页面；真实设备授权仍由相应宿主能力执行。拆分与验收进度见 [迁移说明](../../docs/migration.md)。
+
+## Agent 能力发现
+
+`mearl get_capabilities`、SDK `getCapabilities()`、MCP `browser_get_capabilities` 查询当前目标浏览器，沿用 browser/session 路由。默认返回动作、设备预设和 App 摘要；传 `{ "app": "package/app" }` 按需展开桥方法、可调设置和默认版本。目录为 partial 或 unsupported 时不能据此断言 App 未安装，available=false 的条目不可启用。方法按声明组分类：responses 为固定回包，noop 为成功空实现，behaviors 为模拟行为；这些都不证明真实业务操作可用。
+
+能力包可在每份 App 定义中声明可选 `usage`，浏览器包与 Node/Skill 插件共用同一格式：
+
+```json
+{
+  "usage": {
+    "description": "WebView 与桥接行为模拟",
+    "limitations": ["真实设备授权需要对应的宿主能力"],
+    "skills": ["example-skill"],
+    "documentation": [{ "title": "使用说明", "url": "https://example.com/docs" }]
+  }
+}
+```
+
+usage 最大 4 KiB；description 最多 512 字符，limitations/skills/documentation 各最多 8 项。文档只接受无凭据的 HTTPS URL。查询只读取已安装元数据，不执行插件刷新、不打开文档、不安装或加载 Skill，也不输出桥接脚本、全局变量值及固定回包内容。Skill 名称是作者提供的入口，不代表该 Skill 已安装；通用调用继续使用 set_app_profile/tab_open，特殊流程才读取配套说明。

package/dist/metadata.d.ts

@@ -1,2 +1,2 @@
-import type { BuiltinAppProfileName } from '@mearl/browser-core';
-export declare const BUILTIN_APP_PROFILE_LABELS: Record<BuiltinAppProfileName, string>;
+/** App labels are supplied by installed capability definitions. */
+export declare const BUILTIN_APP_PROFILE_LABELS: Readonly<Record<string, string>>;

package/dist/metadata.js

@@ -1,3 +1,2 @@
-export const BUILTIN_APP_PROFILE_LABELS = {
-    fliggy: '飞猪', taobao: '手机淘宝', wechat: '微信', alipay: '支付宝',
-};
+/** App labels are supplied by installed capability definitions. */
+export const BUILTIN_APP_PROFILE_LABELS = Object.freeze({});

package/dist/profiles.d.ts

@@ -8,7 +8,9 @@ export declare function validateAppBridgeConfig(value: unknown): AppBridgeConfig
 export declare function mergeAppBridgeConfigs(...configs: Array<AppBridgeConfig | undefined>): AppBridgeConfig | undefined;
 /** 将声明式方法覆盖编译进运行时动作表，不修改档案的静态数据。 */
 export declare function applyAppBridgeConfig(actions: BridgeActionMap, config?: AppBridgeConfig): BridgeActionMap;
-export declare const APP_PROFILES: Record<BuiltinAppProfileName, AppProfile>;
+/** Built-ins provide UA/version identity; full environments come from capability packages. */
+/** Profiles are supplied by installed capabilities; the core has no App defaults. */
+export declare const APP_PROFILES: Readonly<Partial<Record<BuiltinAppProfileName, AppProfile>>>;
 export interface ResolveAppProfileOptions extends AppProfileOptions {
     os?: AppProfileOs;
     appVersion?: string;

package/dist/profiles.js

@@ -1,5 +1,4 @@
 import { DEVICE_PRESETS, APP_BRIDGE_BEHAVIORS, appProfileRevision, validateAppProfileDefinition, resolveEmulationConfig, } from '@mearl/browser-core';
-import { BUILTIN_APP_PROFILE_LABELS } from './metadata.js';
 function emptyActions() {
     return {
         open: [],
@@ -174,16 +173,8 @@ export function applyAppBridgeConfig(actions, config) {
     return out;
 }
 /** Built-ins provide UA/version identity; full environments come from capability packages. */
-function basicProfile(name, appName, defaultAppVersion, uaTokens, uaFamily) {
-    return { name, label: BUILTIN_APP_PROFILE_LABELS[name], appName, defaultAppVersion, uaTokens,
-        ...(uaFamily && { uaFamily }), globals: {}, bridges: [], activeEvents: [], actions: emptyActions(), schemes: [] };
-}
-export const APP_PROFILES = {
-    fliggy: basicProfile('fliggy', 'LX', '10.0.9', ['AliTrip/{v}', 'WindVane/8.7.0']),
-    taobao: basicProfile('taobao', 'TB', '10.65.0', ['WindVane/8.7.0']),
-    wechat: basicProfile('wechat', 'WeChat', '8.0.58', [], 'wechatMiniProgram'),
-    alipay: { ...basicProfile('alipay', 'AP', '10.8.0', ['AlipayClient/{v}']), policies: { navigatorLanguage: true, defaultLanguage: 'zh-CN' } },
-};
+/** Profiles are supplied by installed capabilities; the core has no App defaults. */
+export const APP_PROFILES = Object.freeze({});
 /** 构造容器 UA。os 默认 ios；uaTokens 中的 {v} 替换为 appVersion */
 export function buildAppProfileUa(profile, options = {}) {
     const os = options.os ??
@@ -199,36 +190,21 @@ export function buildAppProfileUa(profile, options = {}) {
             .replaceAll('{deviceModel}', deviceModel)
             .replaceAll('{language}', options.language ?? profile.policies?.defaultLanguage ?? 'zh-Hans');
     }
-    if (profile.uaFamily === 'wechatMiniProgram') {
-        if (os === 'android') {
-            return `Mozilla/5.0 (Linux; Android 17; ${deviceModel}; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/152.0.0.0 Mobile MicroMessenger/${version} WeChat/arm64 NetType/WIFI Language/zh_CN miniProgram`;
-        }
-        return `Mozilla/5.0 (iPhone; CPU iPhone OS 18_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MicroMessenger/${version} NetType/WIFI Language/zh_CN miniProgram`;
-    }
-    const tokens = profile.uaTokens.map(t => t.replaceAll('{v}', version)).filter(Boolean);
-    const tail = `${tokens.length > 0 ? ` ${tokens.join(' ')}` : ''}${profile.policies?.navigatorLanguage ? ` Language/${options.language ?? profile.policies.defaultLanguage ?? 'zh-CN'}` : ''}`;
-    if (os === 'android') {
-        return `Mozilla/5.0 (Linux; Android 17; ${deviceModel}) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/152.0.0.0 Mobile Safari/537.36 AliApp(${profile.appName}/${version})${tail}`;
-    }
-    return `Mozilla/5.0 (iPhone; CPU iPhone OS 18_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) AliApp(${profile.appName}/${version})${tail}`;
+    return os === 'android'
+        ? `Mozilla/5.0 (Linux; Android 17; ${deviceModel}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Mobile Safari/537.36`
+        : 'Mozilla/5.0 (iPhone; CPU iPhone OS 18_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.6 Mobile/15E148 Safari/604.1';
 }
 /**
  * 解析容器档案为可下发配置。
  * @throws profile 名不存在时抛错，错误信息列出全部可用档案
  */
 export function listBuiltinAppProfiles() {
-    return Object.values(APP_PROFILES).map(definition => ({
-        id: definition.name,
-        label: definition.label,
-        source: 'builtin',
-        revision: appProfileRevision(definition),
-        definition,
-    }));
+    return [];
 }
 export function resolveAppProfile(name, options = {}, pinnedDefinition) {
     const definition = pinnedDefinition ?? APP_PROFILES[name];
     if (!definition || definition.name !== name) {
-        throw new Error(`Unknown app profile "${name}". Available: ${Object.keys(APP_PROFILES).join(', ')}`);
+        throw new Error(`Unknown app profile "${name}". Install an App simulation capability first.`);
     }
     return resolveAppProfileDefinition(definition, options);
 }
@@ -257,7 +233,7 @@ export function resolveAppProfileDefinition(definition, options = {}) {
     if (options.language !== undefined &&
         profile.policies?.languages &&
         !profile.policies.languages.includes(options.language)) {
-        throw new Error(`Unsupported ${profile.settingsGroup === 'alipay' ? 'Alipay' : profile.label} language. Use ${profile.policies.languages.join(', ')}.`);
+        throw new Error(`Unsupported ${profile.label} language. Use ${profile.policies.languages.join(', ')}.`);
     }
     const os = options.os ??
         (options.devicePreset ? DEVICE_PRESETS[options.devicePreset]?.appProfileOs : undefined) ??
@@ -272,10 +248,9 @@ export function resolveAppProfileDefinition(definition, options = {}) {
     });
     const deviceModel = options.deviceModel ?? DEVICE_PRESETS[devicePreset].appProfileModel;
     const globals = profile.pageRuntime || profile.bridges.length > 0 || Object.keys(profile.globals).length > 0 ? {
-        ...profile.globals,
+        ...Object.fromEntries(Object.entries(profile.globals).map(([key, value]) => [key, value.replaceAll('{deviceModel}', deviceModel).replaceAll('{v}', version)])),
         __APP_NAME__: profile.appName,
         __APP_VERSION__: version,
-        __FLI_DEVICE_MODEL__: deviceModel,
         __DEVICE_MODEL__: deviceModel,
     } : {};
     const ua = buildAppProfileUa(profile, { ...options, os, deviceModel });
@@ -294,6 +269,8 @@ export function resolveAppProfileDefinition(definition, options = {}) {
             },
             policies: profile.policies ?? {},
             settings: profile.settings ?? [],
+            settingsUi: profile.settingsUi,
+            settingsGroup: profile.settingsGroup,
             profile: profile.name,
             label: profile.label,
             globals,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mearl/app-profiles",
-  "version": "3.0.0-beta.4",
-  "description": "Basic App user agents and declarative profile compilation",
+  "version": "3.0.0-beta.5",
+  "description": "Declarative App profile compilation for installed capabilities",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,7 +24,7 @@
   ],
   "license": "Apache-2.0",
   "dependencies": {
-    "@mearl/browser-core": "3.0.0-beta.4"
+    "@mearl/browser-core": "3.0.0-beta.5"
   },
   "devDependencies": {
     "typescript": "^5.8.3"