clickgo 6.10.0 → 6.11.0

package/dist/lib/command/guide.d.ts

@@ -0,0 +1,7 @@
+import type { IAgentInfo } from '../command';
+/**
+ * --- 只介绍接入入口，实时 App ID 和命令参数由代理通过接口发现 ---
+ * @param info 当前环境的接入信息
+ * @returns 可复制的简短英文 Markdown，不嵌入运行实例快照
+ */
+export declare function format(info: IAgentInfo): string;

package/dist/lib/command.d.ts

@@ -1,4 +1,5 @@
-import type * as lCore from './core';
+import * as lCore from './core';
+import * as lNative from './native';
 export { showPalette } from './command/palette';
 /** --- 命令输入与输出可跨浏览器、Native 和协议传输的 JSON 值 --- */
 export type TJson = null | boolean | number | string | TJson[] | {
@@ -106,6 +107,8 @@ export interface IBridge {
 }
 /** --- 框架向网页发布的统一入口；按任务选择应用，只访问明确公开的命令 --- */
 export interface IPageBridge {
+    'getAgentInfo': (taskId?: string) => Promise<IAgentInfo | null | false>;
+    'getAgentGuide': (taskId?: string) => Promise<string | null | false>;
     'listTasks': () => Array<{
         'id': string;
         'name': string;
@@ -115,6 +118,42 @@ export interface IPageBridge {
         'signal'?: AbortSignal;
     }) => Promise<TResult>;
 }
+/** --- 统一接入说明的生成选项；默认不读取或包含 HTTP 凭据 --- */
+export interface IAgentOptions {
+    /** --- 仅供应用主动导出 HTTP 连接设置，仍要求当前 App 已有 root 权限 --- */
+    'includeMcpCredentials'?: boolean;
+}
+/** --- 页面级 WebMCP 接入状态；ready 表示浏览器接口可用，不表示某个 App 的工具已发布 --- */
+export type TWebMcpStatus = 'unsupported' | 'ready';
+/** --- 工具发布诊断状态，不参与页面级接入事件 --- */
+export type TWebMcpRegistrationStatus = 'idle' | 'registering' | 'ready' | 'failed';
+/** --- 可展示或导出的接入信息；命令列表始终从对应入口实时查询 --- */
+export interface IAgentInfo {
+    'schemaVersion': 1;
+    'apps': ReturnType<typeof listTasks>;
+    'targetTaskId': string | null;
+    'browser': {
+        'url': string | null;
+        'api': string;
+    };
+    'webMcp': {
+        'supported': boolean;
+        /** --- 全页面共用的浏览器接入状态，不受目标 App 或工具数量影响 --- */
+        'status': TWebMcpStatus;
+        /** --- 所选 App 的发布诊断；多个 App 时优先报告失败及进行中的注册，不支持时为 null --- */
+        'registrationStatus': TWebMcpRegistrationStatus | null;
+        /** --- 已完成工具发布的 App，不表示这些 App 分别建立了浏览器连接 --- */
+        'publishedTaskIds': string[];
+    };
+    'native': lNative.ICommandEntry | null;
+    /** --- 只有显式导出且通过 root 检查时才包含 HTTP 凭据 --- */
+    'http': lNative.IMcpInfo | null;
+}
+/**
+ * --- 初始化页面级 WebMCP 接入状态，由框架在执行 Boot.main 前自动调用 ---
+ * @returns 无返回值
+ */
+export declare function init(): void;
 /**
  * --- 构造成功结果 ---
  * @param data 可跨入口传输的 JSON 数据
@@ -171,6 +210,20 @@ export declare function listTasks(): Array<{
     'id': string;
     'name': string;
 }>;
+/**
+ * --- 获取当前环境的统一接入信息，不另行维护命令清单或启用服务 ---
+ * @param current 限定目标 App；省略时由代理发现并选择 App
+ * @param options 是否主动导出 HTTP 连接凭据，默认不包含
+ * @returns 独立信息；目标已退出为 null，无权限导出凭据为 false
+ */
+export declare function getAgentInfo(current?: lCore.TCurrent, options?: IAgentOptions): Promise<IAgentInfo | null | false>;
+/**
+ * --- 生成简短英文接入说明，不嵌入临时 App ID；代理通过接口实时发现 ---
+ * @param current 校验当前 App 生命周期与凭据导出权限；省略时生成页面通用说明
+ * @param options 是否主动导出 HTTP 连接凭据，默认不包含
+ * @returns Markdown 说明；目标已退出为 null，无权限导出凭据为 false
+ */
+export declare function getAgentGuide(current?: lCore.TCurrent, options?: IAgentOptions): Promise<string | null | false>;
 /**
  * --- 应用界面直接执行已注册的业务命令 ---
  * @param current 所属任务/Form
@@ -205,13 +258,13 @@ export declare function createBridge(current: lCore.TCurrent): IBridge;
  */
 export declare function createPageBridge(): IPageBridge;
 /**
- * --- 按能力检测接入当前 WebMCP API；没有 API 或注册失败时返回 false ---
+ * --- 显式重同步或重试当前 App 的工具发布；页面接入由框架自动管理 ---
  * @param current 所属应用
- * @returns 是否同步成功
+ * @returns 是否同步成功；浏览器不支持、App 已退出或注册失败时返回 false
  */
 export declare function connectWebMcp(current: lCore.TCurrent): Promise<boolean>;
 /**
- * --- 解除 WebMCP 适配器；内部命令继续可用 ---
+ * --- 撤销当前 App 的 WebMCP 工具；不改变页面级接入状态，下次公开命令注册时自动发布 ---
  * @param current 所属应用
  * @returns 无返回值
  */

package/dist/lib/core.d.ts

@@ -18,6 +18,7 @@ import * as mpegts from 'mpegts.js';
 import * as clickgo from '../clickgo';
 import * as lForm from './form';
 import * as lControl from './control';
+import type * as lCommand from './command';
 import * as lCore from './core';
 /**
  * --- 初始化系统级 ID，仅能设置一次 ---
@@ -107,6 +108,12 @@ export declare abstract class AbstractApp {
     onTaskStarted(taskId: string): void | Promise<void>;
     /** --- 任务结束事件 --- */
     onTaskEnded(taskId: string): void | Promise<void>;
+    /**
+     * --- 页面级 WebMCP 接入状态变化，所有 App 共用同一状态 ---
+     * @param status 浏览器接入状态，与 command.getAgentInfo 的 webMcp.status 一致
+     * @returns 无返回值
+     */
+    onWebMcpStatusChanged(status: lCommand.TWebMcpStatus): void | Promise<void>;
     /**
      * --- Launcher 显示状态改变事件 ---
      * @param state 是否显示
@@ -244,7 +251,7 @@ export interface IAvailArea {
     'oheight': number;
 }
 /** --- 全局事件类型 --- */
-export type TGlobalEvent = 'trayCreated' | 'trayChanged' | 'trayRemoved' | 'error' | 'screenResize' | 'configChanged' | 'formCreated' | 'formRemoved' | 'formTitleChanged' | 'formIconChanged' | 'formStateMinChanged' | 'formStateMaxChanged' | 'formShowChanged' | 'formFocused' | 'formBlurred' | 'formFlash' | 'formShowInSystemTaskChange' | 'formHashChange' | 'taskStarted' | 'taskEnded' | 'launcherShowChanged' | 'launcherFolderNameChanged' | 'hashChanged' | 'keydown' | 'keyup';
+export type TGlobalEvent = 'trayCreated' | 'trayChanged' | 'trayRemoved' | 'error' | 'screenResize' | 'configChanged' | 'formCreated' | 'formRemoved' | 'formTitleChanged' | 'formIconChanged' | 'formStateMinChanged' | 'formStateMaxChanged' | 'formShowChanged' | 'formFocused' | 'formBlurred' | 'formFlash' | 'formShowInSystemTaskChange' | 'formHashChange' | 'taskStarted' | 'taskEnded' | 'webMcpStatusChanged' | 'launcherShowChanged' | 'launcherFolderNameChanged' | 'hashChanged' | 'keydown' | 'keyup';
 /** --- 现场下载 app 的参数 --- */
 export interface ICoreFetchAppOptions {
     'notify'?: number | {

package/dist/lib/form.d.ts

@@ -1,4 +1,5 @@
 import * as lCore from './core';
+import * as lCommand from './command';
 import * as lDom from './dom';
 import * as lControl from './control';
 /**
@@ -324,6 +325,12 @@ export declare abstract class AbstractForm extends AbstractCommon {
     onTaskStarted(taskId: string): void | Promise<void>;
     /** --- 任务结束事件 --- */
     onTaskEnded(taskId: string): void | Promise<void>;
+    /**
+     * --- 页面级 WebMCP 接入状态变化，所有 Form 共用同一状态 ---
+     * @param status 浏览器接入状态，与 command.getAgentInfo 的 webMcp.status 一致
+     * @returns 无返回值
+     */
+    onWebMcpStatusChanged(status: lCommand.TWebMcpStatus): void | Promise<void>;
     /**
      * --- Launcher 显示状态改变事件 ---
      * @param state 是否显示

package/dist/lib/native.d.ts

@@ -10,6 +10,23 @@ export interface IMcpInfo {
     'url': string;
     'token': string;
 }
+/** --- 当前 Native 的公开进程入口，不包含 HTTP 连接凭据 --- */
+export interface ICommandEntry {
+    'name': string;
+    'platform': string;
+    'command': string;
+    'args': string[];
+    'startup': 'existing' | 'auto';
+    'mcp': {
+        'enabled': boolean;
+        'discovery': boolean;
+    };
+}
+/**
+ * --- 取得软件自身的 CLI/stdio 入口和启动要求，无需读取连接凭据 ---
+ * @returns 公开入口信息；普通网页或尚未支持此接口的宿主为 null
+ */
+export declare function getCommandEntry(): Promise<ICommandEntry | null>;
 /**
  * --- 读取 Native 主进程启用的 MCP 连接设置 ---
  * @param current 当前 App