mcpField
D
datex-studio-runtime

datex-studio-runtime

github.com/datex开发92 次安装
代码仓库

关于 datex-studio-runtime

Datex Studio 的运行时语义与执行模型参考 skill，供组件创建 skill 查阅指定文档。它汇总平台全局变量、调用规则、控件类型和计划任务等参考索引，不是操作工作流。

主要功能

  1. 01索引运行时参考文档
  2. 02说明平台注入的全局变量
  3. 03记录执行层级与调用规则
  4. 04涵盖控件类型和控件配置
  5. 05提供计划任务 API 参考

适用场景

  1. 01查找 flow 代码可用的运行时全局变量
  2. 02核对不同执行层之间的调用限制
  3. 03了解控件配置或计划任务的语义

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/datex/skills --skill datex-studio-runtime

安装后在 Claude Code 中输入/datex-studio-runtime确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

calling-conventions.md
control-types.md
runtime-globals.md
scheduled-jobs.md

详细介绍

Datex Studio — 运行时语义与执行模型

此技能是一个库，而非工作流。Datex Studio 组件创建技能会通过相对路径（例如 ../datex-studio-runtime/calling-conventions.md）引用此处的文件。它作为独立技能存在，这样 npx skills / skills.sh 就能在安装使用它的技能时一并安装它——这些工具不会复制同级的非技能目录。

此技能适用的情况

当你正在遵循 Datex Studio 组件创建技能，且该技能引导你查阅此处时。只阅读父技能指定的特定参考文件——不要预先加载整个目录树。

如果有人询问的运行时问题尚未归入更具体的技能范围（例如“操作能否调用函数？”、“数据源的层级规则是什么？”、“$utils.isDefined 的语义是什么？”、“codeBoxConfig 有哪些字段？”），请使用下方索引查找合适的文件。

参考索引

  • runtime-globals.md — 平台注入的全局变量参考表（平台在流程代码中暴露的所有 $... 全局变量，及其结构和层级限制），以及 $utils 辅助函数的重要语义（isDefined 会检查集合；isDefinedTrimmed 会检查空白字符）。
  • calling-conventions.md — 三种执行层级（函数 / 操作 / UI 组件）、各层级的调用方→被调用方允许/禁止矩阵、数据源层级规则、存储层级规则（$db 仅限函数层级），以及通用 CRUD 操作集（Utilities 软件包中的 crud_create_entity / crud_update_entity / crud_delete_entity）。
  • control-types.md — 表单 / 编辑器 / hub 筛选器 / 网格单元格中的 controlConfig.type 值；同级配置块保持为 null 的规则；通过交叉链接 ../datex-studio-conventions/file-format.md 了解声明式字符串槽编码；通过流程代码在 $<container>.fields.<id>.control.<prop> 接口上进行动态变更；详细的 codeBox 章节，以及 textBox、numberBox、dateBox、checkBox、selectBox、button、label、text、image、draw、progressBar、matrix 的简介。
  • scheduled-jobs.md — 深入介绍 $services.jobs：提交与计划 API 接口（.submit、.schedule.create/update/list/activate/deactivate）、ScheduleConcurrency、计划名称规范、幂等初始化与启用/禁用切换的生命周期模式、同步/异步分发器模式，以及后台作业功能的上线前检查清单。

给技能作者的说明

当 Datex Studio 创建技能需要引用此处内容时：

  1. 使用相对路径链接：../datex-studio-runtime/<file>.md。
  2. 在使用方的 SKILL.md frontmatter 中声明依赖： 
    depends:
  - datex-studio-runtime

此技能与 datex-studio-conventions（涵盖 file-format、naming-conventions 和 defaults）以及 datex-studio-shared（涵盖 Datex Studio CLI 操作上下文——分支选择、Studio 生命周期、设计器上下文导航、报告编写）同级。这三个共享参考技能按关注点划分了跨领域的平台知识。

评论

支持 Markdown