打包与发布

my_plugin/
├── src/
│   ├── __main__.py      # 插件入口
│   ├── plugin.toml      # 插件清单（manifest v2）
│   ├── requirements.txt # 可选，第三方依赖
│   └── assets/          # 可选，只读资源
└── build/               # pyrsdk package 输出

manifest_version = 2        # 固定为 2
id = "my-plugin"            # 唯一标识符，必须匹配 [A-Za-z0-9][A-Za-z0-9_-]*(:.\w+)*
name = "My Plugin"          # 显示名称（必填）
version = "1.0.0"           # 语义化版本号（必填）
type = "ui"                 # 插件类型：ui / service / data（必填）
protocol_version = 1        # 插件协议版本，固定为 1
python_version = "3.14"     # 可选，目标 Python 版本
author = "Your name"        # 可选，作者
description = "..."         # 可选，插件描述
icons = { full = "assets/icon.png", monochrome = "assets/icon_mono.png" }  # 可选

activation_events = ["onStartup"]     # 激活事件列表
permissions = ["ui.view", "file.read"] # 权限列表
platforms = ["linux", "macos", "windows", "android"]  # 目标平台

[[contributes.navigation_containers]]
id = "my-plugin"
title = "My Plugin"
icon = { material = "extension_outlined" }
location = "primary"     # primary / secondary
order = 0
when = "device.connected == true"   # 可选条件表达式

[[contributes.views]]
id = "my-plugin.main"
container = "my-plugin"   # 必须引用已声明的导航容器
title = "My Plugin"
renderer = "native.form"  # native.tree/virtualList/table/form/markdown/log/outline/variableInspector
order = 0
when = "..."

[[contributes.commands]]
id = "my-plugin.doSomething"
title = "Do Something"
icon = { material = "play_arrow" }

[[contributes.menus]]
location = "view/title"   # view/title | view/context | navigation/context | commandPalette
command = "my-plugin.doSomething"
view = "my-plugin.main"   # 可选
group = "navigation"      # 可选
order = 0

[[contributes.configuration]]
id = "my-plugin.interval"
title = "Poll Interval"
type = "integer"
description = "轮询间隔（毫秒）"
default = 1000
enum = [500, 1000, 2000]
order = 0

manifest_version = 2
id = "my-plugin"
name = "My Plugin"
version = "1.0.0"
type = "ui"
protocol_version = 1
python_version = "3.14"
author = "Your name"
description = "我的第一个插件"
activation_events = ["onStartup"]
permissions = ["ui.view", "file.read", "file.write", "settings.read"]
platforms = ["linux", "macos", "windows", "android"]

[[contributes.navigation_containers]]
id = "my-plugin"
title = "My Plugin"
icon = { material = "extension_outlined" }

[[contributes.views]]
id = "my-plugin.main"
container = "my-plugin"
title = "Main"
renderer = "native.form"

[[contributes.commands]]
id = "my-plugin.refresh"
title = "刷新"
icon = { material = "refresh" }

[[contributes.menus]]
location = "view/title"
command = "my-plugin.refresh"

pyrsdk create <ui|service|data> [目录]

pyrsdk package [源目录] --platform <platform> [选项]

# 最小打包（Windows）
pyrsdk package src --platform Windows

# 指定 Python 版本（由 manifest 的 python_version 决定，也可用环境变量覆盖）
pyrsdk package src --platform Windows

# 带依赖
pyrsdk package src --platform Windows -r requests -r numpy

# 使用 requirements.txt
pyrsdk package src --platform Windows -rf requirements.txt

# Android 指定架构
pyrsdk package src --platform Android --arch arm64-v8a

# 全平台
pyrsdk package src --platform all

# 交互模式
pyrsdk package -i

pyrsdk test [源目录] [--raw-output]