mofox-plugin-dev-toolkit 0.4.9__tar.gz → 0.5.0__tar.gz

{mofox_plugin_dev_toolkit-0.4.9/mofox_plugin_dev_toolkit.egg-info → mofox_plugin_dev_toolkit-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mofox-plugin-dev-toolkit
-Version: 0.4.9
+Version: 0.5.0
 Summary: 开发工具集，用于快速创建、开发和测试 MoFox-Bot 插件
 Author-email: MoFox-Studio <wwwww95915@qq.com>
 License: GPL-3.0-or-later
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://docs.mofox.studio/mpdt
 Project-URL: Repository, https://github.com/MoFox-Studio/mofox-plugin-toolkit
 Project-URL: Bug Tracker, https://github.com/MoFox-Studio/mofox-plugin-toolkit/issues
 Keywords: mofox,plugin,toolkit,cli,development
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Programming Language :: Python :: 3
@@ -305,7 +305,62 @@ mpdt build --with-docs --bump patch --output release
 
 **说明**：`.mfp` 文件是 Neo-MoFox 的标准插件格式（本质为 ZIP 压缩包），可直接被 loader.py 加载。
 
-### 6. 配置管理
+### 6. 发布到插件市场
+
+MPDT 可以自动完成 GitHub 仓库、tag、Release、资产上传以及中心服务器同步。
+
+准备 GitHub token，至少需要仓库创建和 Release 写入权限：
+
+```bash
+set GITHUB_TOKEN=ghp_xxx
+set PLUGIN_MARKET_BASE_URL=http://127.0.0.1:8787
+set PLUGIN_MARKET_AUTHOR_TOKEN=dev-token
+```
+
+也可以首次发布时传入 token，并在明确确认后保存到 `~/.mpdt/config.toml`，下次会自动读取：
+
+```bash
+mpdt market publish --github-token ghp_xxx --save-github-token --owner your-github-user-or-org
+```
+
+如果只传 `--github-token` 且没有指定 `--save-github-token`，MPDT 会询问是否保存；默认不保存。
+
+在插件目录执行一键发布：
+
+```bash
+mpdt market publish --owner your-github-user-or-org
+```
+
+该命令会依次执行：
+
+1. 读取 `manifest.json`。
+2. 构建 `.mfp` 包并计算 sha256。
+3. 如果 GitHub 仓库不存在则自动创建。
+4. 初始化或复用本地 git 仓库。
+5. 提交当前插件代码。
+6. 创建版本 tag，例如 `v1.0.0`。
+7. 推送分支和 tag 到 GitHub。
+8. 创建或复用 GitHub Release。
+9. 上传 `.mfp` Release 资产。
+10. 注册或更新中心服务器插件元数据。
+11. 提交新版本；如果版本已存在则同步版本元数据。
+
+常用参数：
+
+```bash
+mpdt market publish \
+  --owner MoFox-Studio \
+  --repo my_plugin \
+  --release-notes "First public release"
+```
+
+如果仓库和 tag 已经手动推送，可跳过 git push，仅创建/复用 Release 并同步市场：
+
+```bash
+mpdt market publish --owner MoFox-Studio --skip-push
+```
+
+### 7. 配置管理
 
 ```bash
 # 交互式配置向导

{mofox_plugin_dev_toolkit-0.4.9 → mofox_plugin_dev_toolkit-0.5.0}/README.md

@@ -253,7 +253,62 @@ mpdt build --with-docs --bump patch --output release
 
 **说明**：`.mfp` 文件是 Neo-MoFox 的标准插件格式（本质为 ZIP 压缩包），可直接被 loader.py 加载。
 
-### 6. 配置管理
+### 6. 发布到插件市场
+
+MPDT 可以自动完成 GitHub 仓库、tag、Release、资产上传以及中心服务器同步。
+
+准备 GitHub token，至少需要仓库创建和 Release 写入权限：
+
+```bash
+set GITHUB_TOKEN=ghp_xxx
+set PLUGIN_MARKET_BASE_URL=http://127.0.0.1:8787
+set PLUGIN_MARKET_AUTHOR_TOKEN=dev-token
+```
+
+也可以首次发布时传入 token，并在明确确认后保存到 `~/.mpdt/config.toml`，下次会自动读取：
+
+```bash
+mpdt market publish --github-token ghp_xxx --save-github-token --owner your-github-user-or-org
+```
+
+如果只传 `--github-token` 且没有指定 `--save-github-token`，MPDT 会询问是否保存；默认不保存。
+
+在插件目录执行一键发布：
+
+```bash
+mpdt market publish --owner your-github-user-or-org
+```
+
+该命令会依次执行：
+
+1. 读取 `manifest.json`。
+2. 构建 `.mfp` 包并计算 sha256。
+3. 如果 GitHub 仓库不存在则自动创建。
+4. 初始化或复用本地 git 仓库。
+5. 提交当前插件代码。
+6. 创建版本 tag，例如 `v1.0.0`。
+7. 推送分支和 tag 到 GitHub。
+8. 创建或复用 GitHub Release。
+9. 上传 `.mfp` Release 资产。
+10. 注册或更新中心服务器插件元数据。
+11. 提交新版本；如果版本已存在则同步版本元数据。
+
+常用参数：
+
+```bash
+mpdt market publish \
+  --owner MoFox-Studio \
+  --repo my_plugin \
+  --release-notes "First public release"
+```
+
+如果仓库和 tag 已经手动推送，可跳过 git push，仅创建/复用 Release 并同步市场：
+
+```bash
+mpdt market publish --owner MoFox-Studio --skip-push
+```
+
+### 7. 配置管理
 
 ```bash
 # 交互式配置向导

{mofox_plugin_dev_toolkit-0.4.9 → mofox_plugin_dev_toolkit-0.5.0/mofox_plugin_dev_toolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mofox-plugin-dev-toolkit
-Version: 0.4.9
+Version: 0.5.0
 Summary: 开发工具集，用于快速创建、开发和测试 MoFox-Bot 插件
 Author-email: MoFox-Studio <wwwww95915@qq.com>
 License: GPL-3.0-or-later
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://docs.mofox.studio/mpdt
 Project-URL: Repository, https://github.com/MoFox-Studio/mofox-plugin-toolkit
 Project-URL: Bug Tracker, https://github.com/MoFox-Studio/mofox-plugin-toolkit/issues
 Keywords: mofox,plugin,toolkit,cli,development
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Programming Language :: Python :: 3
@@ -305,7 +305,62 @@ mpdt build --with-docs --bump patch --output release
 
 **说明**：`.mfp` 文件是 Neo-MoFox 的标准插件格式（本质为 ZIP 压缩包），可直接被 loader.py 加载。
 
-### 6. 配置管理
+### 6. 发布到插件市场
+
+MPDT 可以自动完成 GitHub 仓库、tag、Release、资产上传以及中心服务器同步。
+
+准备 GitHub token，至少需要仓库创建和 Release 写入权限：
+
+```bash
+set GITHUB_TOKEN=ghp_xxx
+set PLUGIN_MARKET_BASE_URL=http://127.0.0.1:8787
+set PLUGIN_MARKET_AUTHOR_TOKEN=dev-token
+```
+
+也可以首次发布时传入 token，并在明确确认后保存到 `~/.mpdt/config.toml`，下次会自动读取：
+
+```bash
+mpdt market publish --github-token ghp_xxx --save-github-token --owner your-github-user-or-org
+```
+
+如果只传 `--github-token` 且没有指定 `--save-github-token`，MPDT 会询问是否保存；默认不保存。
+
+在插件目录执行一键发布：
+
+```bash
+mpdt market publish --owner your-github-user-or-org
+```
+
+该命令会依次执行：
+
+1. 读取 `manifest.json`。
+2. 构建 `.mfp` 包并计算 sha256。
+3. 如果 GitHub 仓库不存在则自动创建。
+4. 初始化或复用本地 git 仓库。
+5. 提交当前插件代码。
+6. 创建版本 tag，例如 `v1.0.0`。
+7. 推送分支和 tag 到 GitHub。
+8. 创建或复用 GitHub Release。
+9. 上传 `.mfp` Release 资产。
+10. 注册或更新中心服务器插件元数据。
+11. 提交新版本；如果版本已存在则同步版本元数据。
+
+常用参数：
+
+```bash
+mpdt market publish \
+  --owner MoFox-Studio \
+  --repo my_plugin \
+  --release-notes "First public release"
+```
+
+如果仓库和 tag 已经手动推送，可跳过 git push，仅创建/复用 Release 并同步市场：
+
+```bash
+mpdt market publish --owner MoFox-Studio --skip-push
+```
+
+### 7. 配置管理
 
 ```bash
 # 交互式配置向导

{mofox_plugin_dev_toolkit-0.4.9 → mofox_plugin_dev_toolkit-0.5.0}/mofox_plugin_dev_toolkit.egg-info/SOURCES.txt

@@ -17,12 +17,19 @@ mpdt/commands/check.py
 mpdt/commands/dev.py
 mpdt/commands/generate.py
 mpdt/commands/init.py
+mpdt/commands/market.py
 mpdt/dev/bridge_plugin/__init__.py
 mpdt/dev/bridge_plugin/cleanup_handler.py
 mpdt/dev/bridge_plugin/dev_config.py
 mpdt/dev/bridge_plugin/file_watcher.py
 mpdt/dev/bridge_plugin/manifest.json
 mpdt/dev/bridge_plugin/plugin.py
+mpdt/market/__init__.py
+mpdt/market/client.py
+mpdt/market/config.py
+mpdt/market/git.py
+mpdt/market/github.py
+mpdt/market/manifest.py
 mpdt/templates/__init__.py
 mpdt/templates/action_template.py
 mpdt/templates/adapter_template.py

{mofox_plugin_dev_toolkit-0.4.9 → mofox_plugin_dev_toolkit-0.5.0}/mpdt/__init__.py

@@ -4,7 +4,7 @@ MoFox Plugin Dev Toolkit
 一个用于 MoFox-Bot 插件开发的工具集
 """
 
-__version__ = "0.4.9"
+__version__ = "0.4.11"
 __author__ = "MoFox-Studio"
 __license__ = "GPL-3.0-or-later"
 

{mofox_plugin_dev_toolkit-0.4.9 → mofox_plugin_dev_toolkit-0.5.0}/mpdt/cli.py

@@ -36,7 +36,7 @@ def cli(ctx: click.Context, verbose: bool, no_color: bool) -> None:
 
 @cli.command()
 @click.argument("plugin_name", required=False)
-@click.option("--template", "-t", type=click.Choice(["basic", "action", "tool", "plus_command", "full", "adapter"]),
+@click.option("--template", "-t", type=click.Choice(["basic", "action", "tool", "collection", "router", "plus_command", "event_handler", "full", "adapter", "chatter"]),
               default="basic", help="插件模板类型")
 @click.option("--author", "-a", help="作者名称")
 @click.option("--email", "-e", help="作者电子邮箱")
@@ -69,14 +69,15 @@ def init(ctx: click.Context, plugin_name: str | None, template: str,email: str|
 
 
 @cli.command()
-@click.argument("component_type", type=click.Choice(["action", "tool", "event", "adapter", "plus-command", "router", "chatter", "service", "config"]), required=False)
+@click.argument("component_type", type=click.Choice(["action", "tool", "collection", "event", "adapter", "plus-command", "router", "chatter", "service", "config"]), required=False)
 @click.argument("component_name", required=False)
 @click.option("--description", "-d", help="组件描述")
-@click.option("--output", "-o", type=click.Path(), help="输出目录")
+@click.option("--output", "-o", type=click.Path(), help="插件根目录路径（默认为当前目录）")
 @click.option("--force", "-f", is_flag=True, help="覆盖已存在的文件")
+@click.option("--root", is_flag=True, help="在插件根目录生成组件文件，而不是 components/ 文件夹")
 @click.pass_context
 def generate(ctx: click.Context, component_type: str | None, component_name: str | None, description: str | None,
-             output: str | None, force: bool) -> None:
+             output: str | None, force: bool, root: bool) -> None:
     """生成插件组件(始终生成异步方法)
 
     如果不提供参数，将进入交互式问答模式
@@ -90,6 +91,7 @@ def generate(ctx: click.Context, component_type: str | None, component_name: str
             description=description,
             output_dir=output,
             force=force,
+            use_components_folder=not root,
             verbose=ctx.obj["verbose"],
         )
     except Exception as e:
@@ -187,6 +189,241 @@ def dev(ctx: click.Context, neo_mofox_path: str | None, plugin_path: str | None)
         raise click.Abort()
 
 
+@cli.group()
+def market() -> None:
+    """插件市场命令"""
+    pass
+
+
+@market.command("doctor")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--token", help="中心服务器访问令牌")
+def market_doctor_cmd(market_url: str | None, token: str | None) -> None:
+    """检查中心服务器连通性"""
+    from mpdt.commands.market import market_doctor
+
+    market_doctor(market_url=market_url, token=token)
+
+
+@market.command("register")
+@click.argument("plugin_path", type=click.Path(), required=False, default=".")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--token", help="中心服务器访问令牌")
+@click.option("--repository-url", help="插件 GitHub 仓库地址")
+def market_register_cmd(plugin_path: str, market_url: str | None, token: str | None, repository_url: str | None) -> None:
+    """注册插件到中心服务器"""
+    from mpdt.commands.market import market_register
+
+    market_register(plugin_path=plugin_path, market_url=market_url, token=token, repository_url=repository_url)
+
+
+@market.command("update")
+@click.argument("plugin_path", type=click.Path(), required=False, default=".")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--token", help="中心服务器访问令牌")
+@click.option("--repository-url", help="插件 GitHub 仓库地址")
+def market_update_cmd(plugin_path: str, market_url: str | None, token: str | None, repository_url: str | None) -> None:
+    """更新中心服务器插件元数据"""
+    from mpdt.commands.market import market_update
+
+    market_update(plugin_path=plugin_path, market_url=market_url, token=token, repository_url=repository_url)
+
+
+@market.command("package")
+@click.argument("plugin_path", type=click.Path(), required=False, default=".")
+@click.option("--output", "output_dir", type=click.Path(), default="dist", help="输出目录")
+@click.option("--with-docs", is_flag=True, help="包含文档")
+def market_package_cmd(plugin_path: str, output_dir: str, with_docs: bool) -> None:
+    """生成市场发布产物元数据"""
+    from mpdt.commands.market import market_package
+
+    market_package(plugin_path=plugin_path, output_dir=output_dir, with_docs=with_docs)
+
+
+@market.command("submit-version")
+@click.argument("plugin_path", type=click.Path(), required=False, default=".")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--token", help="中心服务器访问令牌")
+@click.option("--asset-url", help="Release 资产下载地址")
+@click.option("--release-url", help="GitHub Release 页面地址")
+@click.option("--output", "output_dir", type=click.Path(), default="dist", help="输出目录")
+@click.option("--with-docs", is_flag=True, help="包含文档")
+def market_submit_version_cmd(
+    plugin_path: str,
+    market_url: str | None,
+    token: str | None,
+    asset_url: str | None,
+    release_url: str | None,
+    output_dir: str,
+    with_docs: bool,
+) -> None:
+    """打包并提交插件版本"""
+    from mpdt.commands.market import market_submit_version
+
+    market_submit_version(
+        plugin_path=plugin_path,
+        market_url=market_url,
+        token=token,
+        asset_url=asset_url,
+        release_url=release_url,
+        output_dir=output_dir,
+        with_docs=with_docs,
+    )
+
+
+@market.command("sync")
+@click.argument("plugin_path", type=click.Path(), required=False, default=".")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--token", help="中心服务器访问令牌")
+@click.option("--asset-url", help="Release 资产下载地址")
+@click.option("--release-url", help="GitHub Release 页面地址")
+@click.option("--output", "output_dir", type=click.Path(), default="dist", help="输出目录")
+@click.option("--with-docs", is_flag=True, help="包含文档")
+def market_sync_cmd(
+    plugin_path: str,
+    market_url: str | None,
+    token: str | None,
+    asset_url: str | None,
+    release_url: str | None,
+    output_dir: str,
+    with_docs: bool,
+) -> None:
+    """同步插件版本元数据"""
+    from mpdt.commands.market import market_sync
+
+    market_sync(
+        plugin_path=plugin_path,
+        market_url=market_url,
+        token=token,
+        asset_url=asset_url,
+        release_url=release_url,
+        output_dir=output_dir,
+        with_docs=with_docs,
+    )
+
+
+@market.command("publish")
+@click.argument("plugin_path", type=click.Path(), required=False, default=".")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--token", help="中心服务器访问令牌")
+@click.option("--github-token", help="GitHub token；也可使用 GITHUB_TOKEN 或 GH_TOKEN")
+@click.option("--owner", help="GitHub 用户或组织名；默认使用当前 GitHub token 用户")
+@click.option("--repo", help="GitHub 仓库名；默认使用插件 ID")
+@click.option("--private", is_flag=True, help="新建私有仓库")
+@click.option("--output", "output_dir", type=click.Path(), default="dist", help="输出目录")
+@click.option("--with-docs", is_flag=True, help="包含文档")
+@click.option("--release-notes", help="GitHub Release 说明")
+@click.option("--skip-push", is_flag=True, help="跳过 git push，仅创建/复用 Release 并同步市场")
+@click.option("--save-github-token/--no-save-github-token", default=None, help="是否保存本次传入的 GitHub token")
+def market_publish_cmd(
+    plugin_path: str,
+    market_url: str | None,
+    token: str | None,
+    github_token: str | None,
+    owner: str | None,
+    repo: str | None,
+    private: bool,
+    output_dir: str,
+    with_docs: bool,
+    release_notes: str | None,
+    skip_push: bool,
+    save_github_token: bool | None,
+) -> None:
+    """一键发布：建仓库、推送 tag、创建 Release、上传产物并同步市场"""
+    from mpdt.commands.market import market_publish
+
+    market_publish(
+        plugin_path=plugin_path,
+        market_url=market_url,
+        token=token,
+        github_token=github_token,
+        owner=owner,
+        repo=repo,
+        private=private,
+        output_dir=output_dir,
+        with_docs=with_docs,
+        release_notes=release_notes,
+        skip_push=skip_push,
+        save_token=save_github_token,
+    )
+
+
+@market.command("status")
+@click.argument("plugin_path", type=click.Path(), required=False, default=".")
+@click.option("--plugin-id", help="插件 ID，不提供则读取 manifest.json")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--token", help="中心服务器访问令牌")
+def market_status_cmd(plugin_path: str, plugin_id: str | None, market_url: str | None, token: str | None) -> None:
+    """查询插件市场状态"""
+    from mpdt.commands.market import market_status
+
+    market_status(plugin_path=plugin_path, plugin_id=plugin_id, market_url=market_url, token=token)
+
+
+@market.command("yank")
+@click.argument("plugin_path", type=click.Path(), required=False, default=".")
+@click.option("--version", help="插件版本，不提供则读取 manifest.json")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--token", help="中心服务器访问令牌")
+@click.option("--reason", help="撤回原因")
+def market_yank_cmd(plugin_path: str, version: str | None, market_url: str | None, token: str | None, reason: str | None) -> None:
+    """撤回插件版本"""
+    from mpdt.commands.market import market_yank
+
+    market_yank(plugin_path=plugin_path, version=version, market_url=market_url, token=token, reason=reason)
+
+
+@market.command("search")
+@click.argument("query", required=False)
+@click.option("--category", help="分类过滤")
+@click.option("--tag", help="标签过滤")
+@click.option("--limit", type=int, default=20, help="返回数量")
+@click.option("--market-url", help="中心服务器地址")
+def market_search_cmd(query: str | None, category: str | None, tag: str | None, limit: int, market_url: str | None) -> None:
+    """搜索公开插件"""
+    from mpdt.commands.market import market_search
+
+    market_search(query=query, category=category, tag=tag, limit=limit, market_url=market_url)
+
+
+@market.command("info")
+@click.argument("plugin_id")
+@click.option("--market-url", help="中心服务器地址")
+def market_info_cmd(plugin_id: str, market_url: str | None) -> None:
+    """查看公开插件详情"""
+    from mpdt.commands.market import market_info
+
+    market_info(plugin_id=plugin_id, market_url=market_url)
+
+
+@market.command("install-info")
+@click.argument("plugin_id")
+@click.option("--market-url", help="中心服务器地址")
+@click.option("--host-version", help="当前 Neo-MoFox 宿主版本")
+@click.option("--plugin-api-version", help="插件 API 版本")
+@click.option("--platform", help="目标平台，例如 windows/linux/macos")
+@click.option("--include-prerelease", is_flag=True, help="允许推荐预发布版本")
+def market_install_info_cmd(
+    plugin_id: str,
+    market_url: str | None,
+    host_version: str | None,
+    plugin_api_version: str | None,
+    platform: str | None,
+    include_prerelease: bool,
+) -> None:
+    """查看推荐安装版本元数据"""
+    from mpdt.commands.market import market_install_info
+
+    market_install_info(
+        plugin_id=plugin_id,
+        market_url=market_url,
+        host_version=host_version,
+        plugin_api_version=plugin_api_version,
+        platform=platform,
+        include_prerelease=include_prerelease,
+    )
+
+
 @cli.group()
 def config() -> None:
     """配置管理"""