clickgo 6.9.0 → 6.10.0

package/AGENTS.md

@@ -9,7 +9,23 @@
 - Desktop 与 Iconview 共用 `modules.pointer.drag()`；Pointer.js 管理可取消会话、指示器和最上层落点，通过既有 move hooks 同步 iframe 遮罩。保持 pointer 的 fs 载荷及 data-drop 协议兼容，销毁、禁用或取消时不投递 drop。
 - 桌面控件的参数 demo 在 `dist/app/demo/form/control/desktop/`；置底实战 Form 在 `dist/app/demo/form/solution/desktop/`。添加 demo 时同步主 Form 的入口和应用控件配置。
 - Form 的 `viewport` 和 `padding="safe"` 由控件管理布局边界与内容安全区；首次最大化与 `form.refreshMaxPosition()` 统一委托控件刷新，桌面 demo 不手工维护全屏尺寸。
+- 通用命令以 `dist/lib/command.ts` 为执行入口；Form/Panel 的卸载及 task.end 必须清理对应命令，退出等待期间拒绝新注册。跨入口、协议注册与取消回归使用 `npm run test:command`，应用接入方式见 `doc/sc/commands.md`。
+- Demo 应用沿用英文展示，包括 Form 标题、菜单、按钮、提示及命令标题/说明；注释可以使用中文。框架内置界面沿用当前 locale 和英文回退，语言表覆盖 `tool.lang.codes` 全部语种；`npm run test:locale` 检查内置语言表与键完整性。
+- 框架初始化时自动发布 `window['clickgo']['command']`，通过 `listTasks()`、`list(taskId)` 和 `execute(taskId, name, args)` 访问各 App 的公开命令；直接读取任务及命令生命周期状态，宿主不单独发布或清理。Library command Form 展示统一入口，desktop/webpage/cache 和 Native 网页宿主共用该能力。
+- Native 的固定页面命令适配器位于 `dist/lib/command/native.ts`，由 `dist/lib/native.ts` 发布给 Native 主进程；每次请求直接按 taskId 调用 `command.executeAgent()`，保留公开命令限制和 agent 来源。网页及 WebMCP 同样使用此入口；`createBridge()` 仅为需要绑定单个 App 的调用方提供可复用接口。协议服务在 Native 主进程及本仓库的 Native 测试副本中，页面端不监听网络；`native.getMcpInfo(current)` 沿用 root 权限读取连接设置。
 - 验证使用 `npm run check`；位置、指针取消和双向绑定回归使用 `npm run test:desktop`。先用 `npx tsc` 更新生成的运行时代码，再运行依赖该代码的测试。
 - Select 的值同步、搜索、交互和消费控件回归使用 `npm run test:select`；打包后用 `CLICKGO_SELECT_TEST_ARCHIVE=1 npm run test:select` 验证实际控件包。本地列表按完整数据校验，远程结果缺项时保留已选值并补齐标签。
 - 控件 SCSS 使用已有全局 Sass 命令编译，随后运行 `node dist/pack.js`。打包器部分错误会被捕获，必须确认对应控件数量和应用结果，并检查归档内容；需要时执行 `npm run test:archive`。
 - 浏览器入口为 `dist/test/desktop/`；安全上下文和可加载的运行时依赖是有效验收的前提。区分类型、单元回归、浏览器与 Native 桌面验证。
+
+## Native 联动开发与同步
+
+- `dist/test/native/native.ts` 与 clickgo-native 仓库的 `dist/index.ts` 必须逐字一致；它是完整的 Native 主进程实现，不能只保留旧版测试桩。`dist/test/native/lib/{fs,tool,mcp,instance,client,cli,version}.ts` 和手写的 `dist/test/native/pre.js` 同样对应对方的 `dist/lib/` 与 `dist/pre.js`；`dist/test/native/cli.ts` 对应 `dist/cli.ts`。
+- Native 改动先落在本仓库测试副本，运行 `npx tsc`、`npm run check`、`npm run test:native`，再用 `npm run native` 做真实 Electron 联动验收；涉及无边框或进程保留模式时分别使用 `npm run native2`、`npm run native3`。通过后才将对应源文件同步到 clickgo-native，运行对方构建及相关回归，并用 `cmp` 核对源文件完全一致。生成的 JS/类型声明由各自编译更新。
+- 三个 Native 启动 Demo 均显式调用 `startMcp()`；命令演示从 ClickGo Demo 的 AI interface guide 进入。SDK 在本仓库属于测试用 devDependencies，在 clickgo-native 的服务端属于运行依赖；变更模块时同步两边依赖声明。联动测试至少验证 MCP 调用更新 UI、UI 操作可由 MCP 读取，以及受影响的 App 隔离、取消和窗口退出行为。
+
+- 通用 Node CLI 在 `dist/test/native/cli.ts`，本地使用 `npm run native:cli -- <command>`；stdio 客户端直接启动 `node <绝对路径>/dist/test/native/cli.js mcp --host <软件ID>`，不能让 npm 的输出混入 MCP stdout。三个 Native Demo 使用稳定软件 ID `clickgo-demo`。
+- `lib/instance.ts` 发布/发现同一操作系统用户的临时私有运行记录，CLI 与 stdio 经 `lib/client.ts` 转发到原 HTTP MCP；`lib/mcp.ts` 的工具定义由 HTTP 和 stdio 共用。每次调用读取新记录，不重试修改操作；软件 ID、运行实例 ID 和 App taskId 是三个层次，多个匹配实例必须明确选择，重启后重新发现 taskId。
+- 启用 MCP 默认允许本机同用户发现当前连接凭据，`discovery: false` 可关闭。退出撤销运行记录，崩溃遗留记录按 PID 排除；这不是业务配置持久化。业务设置页、长期凭据与启动偏好由消费应用维护，网页读取凭据仍要求 root。接入与参数说明见 `dist/test/native/README.md`。
+
+- MCP 客户端及 HTTP/stdio 服务端的框架版本共用 `lib/version.ts`，从模块所属包的 `package.json` 读取，不复制版本常量，也不使用消费软件的 `app.getVersion()`；ClickGo 测试副本读取 ClickGo 包版本。升级包版本后重启即可生效。

package/README.md

@@ -90,6 +90,10 @@ $ npm i jszip --save-dev
 $ npm i vue --save-dev
 ```
 
+## Shared commands and AI integration
+
+Register business commands once with `clickgo.command.register()` and let buttons, menus, shortcuts and agents use the shared executor. ClickGo publishes the browser JavaScript command interface automatically and can connect available WebMCP. See the [command guide](./doc/sc/commands.md) (Simplified Chinese) for registration and lifecycle details, and the [ClickGo Native integration guide](https://github.com/maiyun/clickgo-native#local-mcp) for the complete App registration, HTTP MCP, stdio and CLI setup.
+
 ## Notes
 
 ClickGo auto-loads Vue, jszip. **Don't** include them manually.

package/dist/clickgo.d.ts

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import * as lTool from './lib/tool';
+import * as lCommand from './lib/command';
 import * as lControl from './lib/control';
 import * as lCore from './lib/core';
 import * as lDom from './lib/dom';
@@ -166,4 +167,4 @@ export declare function showBrowserWarning(text: {
  * @param boot 启动类
  */
 export declare function launcher(boot: AbstractBoot): Promise<void>;
-export { lControl as control, lCore as core, lDom as dom, lForm as form, lFs as fs, lNative as native, lStorage as storage, lTask as task, lTheme as theme, lTool as tool, lZip as zip };
+export { lCommand as command, lControl as control, lCore as core, lDom as dom, lForm as form, lFs as fs, lNative as native, lStorage as storage, lTask as task, lTheme as theme, lTool as tool, lZip as zip };