@mearl/setup 2.15.2 → 2.16.0

package/README.md

@@ -31,7 +31,7 @@ mearl yuque read "https://aliyuque.antfin.com/group/book/doc"
 
 安装参数透传给 `npx -y ali-skills add`，末尾统一追加 `--global --install-mode symlink`；不接受会截断后置选项的 `--` 参数分隔符，
 确保 skill 存放在 `~/.agents/skills` 并共享给所选 agent。安装日志实时显示，保留交互；
-setup 从 `Installed … skill(s)` 成功区块提取路径，仅注册本次安装且包含 `scripts/main.mjs` 的 skill。
+setup 从 `Installed … skill(s)` 成功区块提取路径，仅注册本次安装且包含 `scripts/main.mjs` 或 `scripts/main.py` 的 skill；两者同时存在时使用 JavaScript 入口。
 普通 skill 正常安装。输出格式无法识别时提示手动注册，不扫描其他 skill 或猜测安装结果。
 
 默认 `install` 和 `update` 完成后，setup 会用最多 5 秒的 `npm ping` 检查阿里内网 registry。
@@ -41,8 +41,8 @@ setup 从 `Installed … skill(s)` 成功区块提取路径，仅注册本次安
 
 Mearl client 内置官方插件名称与安装来源目录。CLI、SDK、MCP 或另一个插件首次调用尚未注册的官方插件时，会通过内部幂等流程安装并重试一次；未知名称不会触发安装。
 
-自动注册默认使用安装目录名；入口可用 `export const name = 'yuque'` 指定简短命令名。
-重装会刷新同名绑定。每个入口必须默认导出 `register(app)`；完整协议见
+自动注册默认使用安装目录名；入口可声明 `name` 指定简短命令名。
+重装会刷新同名绑定。JavaScript 入口必须默认导出 `register(app)`，Python 入口必须导出 `register(app)` 函数；完整协议见
 [Skill 插件规范](../skills/mearl-skill-creator/references/cli-plugin.md)。
 
 已通过其他渠道分发的 skill 或自定义入口，可以直接传入路径注册：
@@ -52,7 +52,7 @@ npx @mearl/setup plugin yuque /absolute/path/to/yuque-doc-fetch
 npx @mearl/setup plugin custom ./skills/custom/entry.mjs
 ```
 
-path 接受目录或具体文件；目录默认读取 `scripts/main.mjs`，相对路径基于调用工作目录解析。
+path 接受目录或具体文件；目录默认读取 `scripts/main.mjs` 或 `scripts/main.py`，相对路径基于调用工作目录解析。Python 插件要求 `python3 >= 3.9`，可通过 `MEARL_PYTHON` 指定解释器路径；setup 只验证入口可加载，不安装 Python，也不执行 `pip install`。
 命令检查入口注册函数，然后保存绝对入口路径，同名注册更新绑定。
 两种注册流程都会检查本机 `@mearl/client` 和 `@mearl/native-host`：缺失或低于当前 setup 版本时，
 复用已有包管理器安装 setup 的对应版本，更新后再次验证；更高版本保持不动。

package/dist/plugin.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, rmdirSync, statSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
-import { assertPluginName, findOfficialPlugin, findPluginEntry, findPluginRegistration, listPluginNames, loadPlugin, OFFICIAL_PLUGIN_MANAGER, registerPlugin, resolvePluginEntry, unregisterPlugin, } from '@mearl/client/plugin';
+import { assertPluginName, findPluginDirectoryEntry, findOfficialPlugin, findPluginEntry, findPluginRegistration, listPluginNames, loadPlugin, OFFICIAL_PLUGIN_MANAGER, registerPlugin, resolvePluginEntry, unregisterPlugin, } from '@mearl/client/plugin';
 import { ensurePluginRuntime } from './pluginRuntime.js';
 import { resolveAliSkillsInvocation, stripAnsi } from './aliSkills.js';
 import { findExecutable, prependNodePath, runCommand } from './process.js';
@@ -178,8 +178,8 @@ export async function installPlugins(args, runner = runCommand, options = {}) {
     for (const skillPath of paths) {
         if (!statSync(join(skillPath, 'SKILL.md')).isFile())
             throw new Error(`安装结果缺少 SKILL.md: ${skillPath}`);
-        const entry = join(skillPath, 'scripts', 'main.mjs');
-        if (!existsSync(entry))
+        const entry = findPluginDirectoryEntry(skillPath);
+        if (!entry)
             continue;
         const plugin = await loadPlugin(entry, registrationContext);
         const name = plugin.name ?? basename(skillPath);
@@ -189,7 +189,7 @@ export async function installPlugins(args, runner = runCommand, options = {}) {
         plugins.set(name, { entry, description: plugin.description });
     }
     if (plugins.size === 0) {
-        console.error('未找到 scripts/main.mjs 插件入口；自定义入口可用 setup plugin <name> <path> 注册。');
+        console.error('未找到 scripts/main.mjs 或 scripts/main.py 插件入口；自定义入口可用 setup plugin <name> <path> 注册。');
         return 0;
     }
     await ensurePluginRuntime(runner);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/setup",
-  "version": "2.15.2",
+  "version": "2.16.0",
   "description": "One-shot environment setup and configuration for Mearl",
   "type": "module",
   "main": "dist/index.js",
@@ -61,8 +61,8 @@
     "commander": "^15.0.0",
     "extract-zip": "^2.0.1",
     "ws": "^8.18.3",
-    "@mearl/client": "2.15.2",
-    "@mearl/provider": "2.15.2"
+    "@mearl/client": "2.16.0",
+    "@mearl/provider": "2.16.0"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",