@finebi/finebi-cli 1.4.0 → 1.6.0

package/skills/finebi-cli-agent/references/scenario-workflows.md

@@ -20,7 +20,7 @@
 6. 对最终选定或新建的分析表调用 `analysis-ds.info` 确认主题归属、引擎类型和字段元数据。DIRECT 不以 `dataStatus`、`updateStatus` 或摘要 `usable` 阻断，不执行数据集 `data-update`，使用只读 `preview` 验证查询能力；SPIDER 保留状态、可用性和 preview 校验。
 7. 用 `subject.info` 和必要的 `widget.info` 确认已有组件引用。
 8. 对 Dashboard 按名称引用的组件，证明每个已有引用全局唯一，并证明待创建组件名称在创建前不存在冲突。
-9. 模型指标集不走数据集搜索。先从 `subject.info` 返回的 `resources.models` 查看摘要，再用 `model.search --subject-id <subjectId>` 遍历主题内候选，并对选定模型调用 `model.info --subject-id <subjectId> --id <modelId>` 获取指标、数据集字段和模型计算字段。若用户要求使用的指标集尚未属于主题，单独用 `public-ds.search` 确认唯一的 `type=METRIC_SET` 来源和目标主题可编辑性；执行 `model.add --subject-id <subjectId> --id <sourceId>` 后，使用响应中的主题内模型 ID 执行 `model.info` 回查，才可构建交接对象。来源 ID 不得传给 `model.info/delete` 或写进 DSL。模型目录命令未出现在实时 capability 时，既有 `widget dsl` 输出中的 `model(...)` 可作为只读证据；否则进入 `BLOCKED`。不得查询同名分析表后改写成 `model(...)`。
+9. 模型指标集按来源探查与主题内模型分别解析。仅探查来源或尚无主题时，用 `public-ds.search` 发现 `type=METRIC_SET` 来源，再以来源 ID 调用 `model.source-info`，读取字段目录与来源展示提示；判读边界见 [Model 工作流](command-workflows.md#76-model-metric-set)。生成制品时，先从 `subject.info` 返回的 `resources.models` 查看摘要，再用 `model.search --subject-id <subjectId>` 遍历主题内候选，并对选定模型调用 `model.info --subject-id <subjectId> --id <modelId>` 获取指标、数据集字段和模型计算字段。若用户要求使用的指标集尚未属于主题，确认唯一来源和目标主题可编辑性；执行 `model.add --subject-id <subjectId> --id <sourceId>` 后，使用响应中的主题内模型 ID 执行 `model.info` 回查，才可构建交接对象。来源 ID 不得传给 `model.info/delete` 或写进 DSL。模型目录命令未出现在实时 capability 时，既有 `widget dsl` 输出中的 `model(...)` 可作为只读证据；否则进入 `BLOCKED`。不得查询同名分析表后改写成 `model(...)`。
 
 不得把公共数据集 ID 当作 Analysis DS ID。物理 DSL 字段语义使用 `analysis-ds.info.name` 返回的表名和字段原始 `name`；模型 DSL 字段语义使用已确认的模型展示名和字段展示名。数据集、模型和字段 ID 仅作为可选验证证据，不进入 DSL。
 

package/skills/finebi-cli-agent/references/web-app.md

@@ -0,0 +1,13 @@
+# 生成动态 HTML 数据应用
+
+用户要求生成动态页面、HTML看板或FineBI Web应用时，先选择同一CLI安装的本地 `app create`，再按生成项目AGENTS.md开发。创建模板不需要连接；读取/绑定FineBI资源才检查认证和实时命令help。
+
+1. `finebi-cli app create --name <name> --path <parent>` 创建工程，不安装/运行/发布。
+2. 用dashboard search/info/data确认唯一来源、板内entryId、结果字段dId、真实控件filterName；样本仅用于理解和测试。
+3. 在public/app-config.json填写非敏感绑定。图表库和UI组件库按页面需求选择，默认实现及替换约定见生成项目的docs/design.md。请求、认证、解析复用模板src/finebi；业务代码按项目指南开发。
+4. `finebi-cli app inspect --path <project>`只校验本地配置，不能证明字段/权限在远端存在。按项目README配置开发身份，再安装、启动、测试与构建。
+5. 浏览器验收实际请求、空/错误/权限状态、图表与刷新；生产部署必须用访问者Cookie，不携带开发身份。
+
+内置CLI同样通过 `node "<skill-dir>/scripts/finebi-cli/src/index.js" app ...` 调用，不走动态业务runner。生产页面不调用CLI。禁止将开发时查到的业务数据或token写入HTML/JS/config；无筛选控件不能伪造服务端过滤。pageLimit不是分页，hasNext和warnings必须呈现。v1不提供发布上传/目录来源/服务端续页，先说明缺口，不发明命令。
+
+模板内置文本、单选/多选、数值选择、日期及日期区间、年月季度、年月区间和已配置时间标签；草稿统一应用，恢复默认与筛选空值分开。配置、状态、请求编码和代理校验共用 src/finebi/filters.js。数值范围、滑块、树/级联和动态候选项暂不支持，不得换成其他类型绕过检查。绑定前核实源控件类型和作用范围，候选项不得冒充完整数据。通用约定、完整支持矩阵、值格式及扩展步骤见生成项目 docs/filters.md。

package/skills/finebi-cli-agent/references/widget-dsl-api-examples.md

@@ -1,7 +1,6 @@
-# Widget DSL 推荐写法示例（`widget-dsl-api.md` §10）
+# Widget DSL 推荐写法示例
 
-> 本文件是 [`widget-dsl-api.md`](widget-dsl-api.md) §10 的独立分册：可运行的推荐写法示例。
-> §1-§9（根入口 / 字段工厂 / Builder / 图表上下文 / SeriesModel / 过滤 / 配色 / 数值格式 / 枚举）留在主册。
+> 本文件是 Widget DSL API 的示例分册：可运行的推荐写法示例，与 API 面分离维护；API 总导航见 [`widget-dsl-api.md`](widget-dsl-api.md)。
 
 ### 10.1 分区折线图
 
@@ -445,7 +444,7 @@ WidgetDsl.create("门店流量")
 
 使用 `finebi-cli widget template --chart-type radar --scenario basic` 获取模板，按响应中的变量元数据
 替换组件名、表名、分类维度及两个不同的数值字段；变量值按 JSON 字面量编码。
-API 与配置边界见 [雷达图编码](widget-dsl-api.md#427-折线雷达图)。
+API 与配置边界见 [雷达图编码](widget-dsl-encodings.md#427-折线雷达图)。
 
 ```javascript
 WidgetDsl.create("手机参数对比").chart().radar()
@@ -455,3 +454,21 @@ WidgetDsl.create("手机参数对比").chart().radar()
     .radarOptions(RadarOptions.polygon().marker(true).symbol("triangle"))
     .build();
 ```
+
+### 隐藏展示字段
+
+设计器"展示字段"开关的 DSL 表达：维度绑定进轴但查看态不展示（`used=false`，槽位保留）。
+`.hidden()` 叠加在维度表达式末尾，可与分组、别名、经纬度组合；回读输出同一后缀。
+
+```js
+WidgetDsl.create("区域销售表")
+    .chart().table()
+    .dimension(from("销售表").dim("地区"))
+    .dimension(from("销售表").dim("月份",
+        DimensionGrouping.dateGranularity("YEAR_MONTH"), "月份").hidden())
+    .measure(from("销售表").sum("销售额"))
+    .build()
+```
+
+适用场景：按隐藏粒度参与分组/计算，但界面只展示地区一级；或反读设计器组件时
+保留其"已关闭展示"的字段设置。同一字段多处引用须 hidden 状态一致，否则保存报错（明细表例外：同字段多列按列独立生效）。