Soln Studio

该分类包含 27 条以 system.studio. 开头的 Runtime 系统命令。

按职责组织页面和脚本

优先使用多个职责清晰的文件，不要把整个功能都放进入口文件。修改前先读取资产目录结构，复用已有的合适模块。

• 页面：src/App.tsx 主要负责页面组合。独立 UI 区块放在 src/client/components/，数据和状态 hooks 放在 src/client/hooks/，服务端动作及业务服务放在 src/server/，可供浏览器使用的类型和纯函数放在 src/shared/。
• **脚本：**已配置的入口主要负责流程编排；校验、业务规则、外部 API 适配和可复用逻辑随复杂度增长拆到本地模块。
• 使用含义明确的英文文件名和相对路径导入。每个文件保持单一职责，接近 500–600 行时优先拆分。这是可维护性建议，不是编译器硬限制；简单、内聚的功能不必机械拆成许多小文件。
• 客户端不能导入服务端模块。共享模块必须适用于所有引用它的运行环境；页面通过 callAction 调用已声明的服务端动作。
• 相关文件与导入关系一起修改，按当前绑定编译完整资产并检查全部诊断，再分别保存和发布。文件写入成功不等于编译或发布成功。

内置 antd 的导入范围和 Runtime 缺包处理见 Soln Studio。

1. 列出资产

完整命令：system.studio.asset.list

列出Soln Studio资产。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio asset list \
  [--keyword value] [--asset-type script|page] \
  [--status unpublished|published] [--include-files] [--cursor value] \
  [--limit n] [--json]

参数：无（除 --json 等通用选项外）。

2. 获取资产

完整命令：system.studio.asset.get

获取Soln Studio资产资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio asset get --asset-id <uuid> [--json]

参数：无（除 --json 等通用选项外）。

3. 创建资产

完整命令：system.studio.asset.create

创建Soln Studio资产资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio asset create \
  (--definition-json json|--definition-file path) [--json]

参数：无（除 --json 等通用选项外）。

4. 更新资产

完整命令：system.studio.asset.update

更新Soln Studio资产资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio asset update \
  --asset-id <uuid> (--definition-json json|--definition-file path) \
  [--json]

参数：无（除 --json 等通用选项外）。

5. 删除资产

完整命令：system.studio.asset.delete

删除Soln Studio资产资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio asset delete --asset-id <uuid> [--json]

参数：无（除 --json 等通用选项外）。

6. 编译资产

完整命令：system.studio.asset.compile

编译Soln Studio资产资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio asset compile \
  --asset-id <uuid> [--runtime-binding-id binding] \
  [--runtime-binding-file path] [--json]

参数：无（除 --json 等通用选项外）。

7. 发布资产

完整命令：system.studio.asset.publish

发布Soln Studio资产资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio asset publish \
  --asset-id <uuid> [--notes value] [--json]

参数：无（除 --json 等通用选项外）。

8. 取消发布资产

完整命令：system.studio.asset.unpublish

取消发布Soln Studio资产资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio asset unpublish --asset-id <uuid> [--json]

参数：无（除 --json 等通用选项外）。

9. 列出资产文件

完整命令：system.studio.asset.file.list

列出Soln Studio资产文件。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio asset file list \
  --asset-id <uuid> [--keyword value] [--path-prefix value] \
  [--cursor value] [--limit n] [--json]

参数：无（除 --json 等通用选项外）。

10. 列出资产文件版本

完整命令：system.studio.asset.file.version.list

列出Soln Studio资产文件版本。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio asset file version list \
  --asset-id <uuid> --file-path value [--cursor value] [--limit n] \
  [--json]

参数：无（除 --json 等通用选项外）。

11. 获取资产版本

完整命令：system.studio.asset.version.get

获取Soln Studio资产版本资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio asset version get \
  --asset-id <uuid> (--version-id <uuid>|--version-no n) [--json]

参数：无（除 --json 等通用选项外）。

12. 打开工作区

完整命令：system.studio.workspace.open

打开Soln Studio工作区资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio workspace open --asset-id <uuid> [--json]

参数：无（除 --json 等通用选项外）。

13. 读取工作区快照

完整命令：system.studio.workspace.snapshot

生成快照Soln Studio工作区。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio workspace snapshot \
  --asset-id <uuid> --session-id <uuid> [--json]

参数：无（除 --json 等通用选项外）。

14. 读取工作区文件

完整命令：system.studio.workspace.file.read

读取Soln Studio工作区文件资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio workspace file read \
  --asset-id <uuid> --session-id <uuid> --file-path value [--json]

参数：无（除 --json 等通用选项外）。

15. 搜索工作区文件

完整命令：system.studio.workspace.file.search

搜索Soln Studio工作区文件。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio workspace file search \
  --asset-id <uuid> --session-id <uuid> --query value [--case-sensitive] \
  [--limit n] [--json]

参数：无（除 --json 等通用选项外）。

16. 移动工作区文件

完整命令：system.studio.workspace.file.move

移动Soln Studio工作区文件资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio workspace file move \
  --asset-id <uuid> --session-id <uuid> --base-revision n \
  --from-path value --to-path value --expected-content-file path \
  [--no-compile] [--json]

参数：无（除 --json 等通用选项外）。

17. 更新工作区

完整命令：system.studio.workspace.patch

更新Soln Studio工作区。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio workspace patch \
  --asset-id <uuid> --session-id <uuid> --base-revision n \
  --patch-file path [--no-compile] [--json]

参数：无（除 --json 等通用选项外）。

18. 应用工作区配方

完整命令：system.studio.workspace.recipe.apply

应用Soln Studio工作区配方资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio workspace recipe apply \
  --session-id <uuid> --base-revision n \
  (--definition-json json|--definition-file path) [--no-compile] \
  [--json]

参数：无（除 --json 等通用选项外）。

19. 编译工作区

完整命令：system.studio.workspace.compile

编译Soln Studio工作区资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio workspace compile \
  --asset-id <uuid> --session-id <uuid> [--runtime-binding-id binding] \
  [--runtime-binding-file path] [--json]

参数：无（除 --json 等通用选项外）。

20. 保存工作区

完整命令：system.studio.workspace.save

保存Soln Studio工作区资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio workspace save \
  --asset-id <uuid> --session-id <uuid> [--json]

参数：无（除 --json 等通用选项外）。

21. 丢弃工作区

完整命令：system.studio.workspace.discard

丢弃Soln Studio工作区资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio workspace discard \
  --asset-id <uuid> --session-id <uuid> [--json]

参数：无（除 --json 等通用选项外）。

22. 执行工作区

完整命令：system.studio.workspace.execute

执行Soln Studio工作区资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio workspace execute \
  --asset-id <uuid> --session-id <uuid> --base-revision n \
  [--entry value] [--action-name value] [--payload-json json] [--json]

参数：无（除 --json 等通用选项外）。

23. 执行资产

完整命令：system.studio.asset.execute

执行Soln Studio资产资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio asset execute \
  --asset-id <uuid> [--entry value] [--payload-json json] [--json]

参数：无（除 --json 等通用选项外）。

24. 预览页面

完整命令：system.studio.page.preview

预览Soln Studio页面资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio page preview --asset-id <uuid> [--entry value] [--json]

参数：无（除 --json 等通用选项外）。

25. 执行页面操作

完整命令：system.studio.page.action.execute

执行Soln Studio页面操作资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system studio page action execute \
  --asset-id <uuid> --action-name value [--workspace-app-code value] \
  [--payload-json json] [--json]

参数：无（除 --json 等通用选项外）。

26. 列出执行

完整命令：system.studio.execution.list

列出Soln Studio执行。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio execution list \
  [--asset-id <uuid>] [--file-path value] \
  [--status running|succeeded|failed] [--keyword value] [--cursor value] \
  [--limit n] [--json]

参数：无（除 --json 等通用选项外）。

27. 获取执行

完整命令：system.studio.execution.get

获取Soln Studio执行资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system studio execution get --log-id <uuid> [--json]

参数：无（除 --json 等通用选项外）。