datex-studio-shared

Datex Studio — 共享参考

这项技能是一个库，而非工作流。其他 datex-studio-* 技能会通过相对路径引用此处的文件（例如 ../datex-studio-shared/branch-setup.md）。它作为独立技能存在，因此 npx skills / skills.sh 可以将其与依赖技能一并安装——这些工具不会复制同级的非技能目录（旧版 shared/）。

何时适用此技能

当你正在使用另一项 Datex Studio 技能，且该技能指向此处时。只阅读父技能指定的参考文件——不要预先加载整个目录树。

如果用户提出的 Datex Studio 问题尚未归属某项更具体的技能（例如“不同 dxs 命令中的分支 ID 如何运作？”、“OData 分页模式是什么？”），请使用下面的索引查找合适的文件。

参考索引

跨技能操作上下文

• configuration-roundtrip.md — 所有组件创建器／编辑器技能通用的权威 dxs configuration get → extract inner .json → edit → upsert 往返流程，以及提取步骤可避免的静默清除错误。分支是事实来源；JSON 文件只是临时草稿。
• branch-setup.md — 活跃组织、存储库、功能分支和 API 连接的选择。分支 ID 策略（复用明确的会话选择，否则询问；绝不自行假定）在此说明。
• studio-management.md — Studio 生命周期：检查状态、在后台启动并验证就绪情况、清理。
• context-navigation.md — 如何获取并读取 dxs -O json … context 响应（后端与前端符号筛选），以及用于发现自定义类型和枚举成员的 nomenclature 注册表（$types.<Package>.*）。
• flow-code-patterns.md — $utils.isDefined()、日期默认值、$shell.Reports.open{ref}()，以及 OData 分页／5000 条记录上限模式。

组件类型参考（尚无专用创建器技能）

• cards.md — 卡片组件（-card.json，cti 11）：列表项重复器原语；$card 命令式接口、跨流程调用陷阱及其窗口辅助函数变通方案、变更→发出→刷新循环、内联编辑模式、预检清单。
• lists.md — 列表组件（-list.json，cti 14）：基于卡片的网格同类组件；datasourceConfig/itemConfig 接线约定、$list 接口、报表卡片刷新、全文搜索下推、预检清单。
• frontend-flows.md — 前端流程（-frontendFlow.json，cti 27）：函数的浏览器层同类组件；错误 cti 导致的失败模式、$frontendFlows 仅限静态分发的规则、按引用传递的对象 inParams，以及浏览器键盘处理规则（zone.js __zone_symbol__ 逃逸方案、KeyboardEvent.code 与 .key 的区别、保留组合键屏蔽列表）。

Datex 应用设计系统（design-system/）

面向手工编写 UI 的 Fluent 2 UI 设计系统——尤其适用于自定义 Angular 组件（参见 custom-angular-component-creator），这类组件不会自动获得 Datex 样式。此处是 Claude Design「Datex Studio App」系统的原样镜像；来源信息及刷新方法见该目录的 README。

• design-system/README.md — 内容、来源和刷新步骤。
• design-system/02-tokens.md — 主题令牌（使用 var(--…)，绝不使用十六进制值）、状态颜色、排版、间距、图标字体。
• design-system/03-components.md — 可组合使用的真实 datex-* 类名（按钮、字段／表单、网格、卡片、组件、工具栏、选项卡）。
• design-system/06-traps.md — 与直觉相悖的编译后 CSS 注意事项。另见 01-principles、04-patterns、05-voice-and-copy。

RDLX-JSON 报表创作（report-authoring/）

供 report-creator 和 report-editor 使用。

• report-authoring/design-standards.md — Datex 设计语言：调色板、字体排印、表格样式、字段标签-值模式、网格对齐、报表类别。
• report-authoring/json-structure.md — 文档模板、元素 JSON 格式、表达式速查。
• report-authoring/design-patterns.md — 坐标系、布局模式、元素尺寸。
• report-authoring/cli-commands.md — 详细的 dxs report CLI 语法：批量操作、tablix、图像、数据集、设置/移动/移除、验证。
• report-authoring/sample-data.md — 用于实时预览的配套 .data.json 文件。
• report-authoring/dataset-rules.md — DataSet 管理：CommandText 规则、集合处理、日期注释、敏感度属性。
• report-authoring/deploy-patterns.md — 上传、预览和验证模式。
• report-authoring/troubleshooting.md — 常见的 RDLX-JSON 和 CLI 错误及修复方法。

给技能作者的说明

当 datex-studio-* 技能需要引用此处的内容时：

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

   depends:
     - datex-studio-shared
   

   depends 字段是面向未来的标记，适用于 vercel-labs/skills#860；在该功能发布之前，请在使用方技能的 README/安装说明中记录依赖，并指导用户运行 npx skills add … --all（或明确列出两个名称）。