@qingflow-tech/qingflow-cli 1.1.56 → 1.1.57

package/README.md

@@ -7,7 +7,7 @@ Qingflow CLI 是轻流面向开发者和 AI Agent 的命令行工具。它把轻
 ## 安装
 
 ```bash
-npm install @qingflow-tech/qingflow-cli@1.1.56
+npm install @qingflow-tech/qingflow-cli@1.1.57
 ```
 
 推荐从官网复制这一条一键安装 Qingflow CLI：
@@ -21,7 +21,7 @@ npx qingflow-cli@latest install
 ## 运行
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-cli@1.1.56 qingflow
+npx -y -p @qingflow-tech/qingflow-cli@1.1.57 qingflow
 ```
 
 全局安装后可以直接运行：
@@ -62,7 +62,7 @@ qingflow-skills install --agent codex --scope user
 如果你通过一次性 `npx -p` 执行 skills 安装，建议加 `--copy`，避免 symlink 指向 npm 临时执行缓存：
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-cli@1.1.56 qingflow-skills install --agent codex --scope user --copy
+npx -y -p @qingflow-tech/qingflow-cli@1.1.57 qingflow-skills install --agent codex --scope user --copy
 ```
 
 `qingflow-skills install` 默认使用 symlink，且遇到同名 skill 不会覆盖；只有显式传入 `--force` 才会替换。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-cli",
-  "version": "1.1.56",
+  "version": "1.1.57",
   "description": "Human-friendly Qingflow command line interface for auth, record operations, import, tasks, and stable builder flows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "1.1.56"
+version = "1.1.57"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/skills/qingflow-cli/reference/builder/50-views.md

@@ -31,7 +31,8 @@ qingflow builder views apply --app-key APP_KEY --schema-version v1alpha1 --view-
 - 当前记录带到另一个应用用 `action: "add_data"`（`target_app_key` + `field_mappings`，通常 `source_field: "数据ID"`）。只打开页面用 `action: "link"` 加 `url`。审批、状态流转、关闭任务走流程，不要用普通按钮假装。
 - `default_values` 的 key 和 `field_mappings[].target_field` 是目标应用字段。选项必须是目标字段的原文或 option id。不确定就不要编造；`CUSTOM_BUTTON_DEFAULT_VALUE_UNSUPPORTED` 时用 patch 改默认值，不要重建视图。
 - `action_buttons_mode` 默认 `merge`。`replace` 加空数组只清绑定，不删按钮本体。已有按钮先 `builder button get --button-text`，唯一命中后用 `buttons[]` 的 `button_id` 绑定。
-- 数据权限默认 `{"type":"custom","scope":"all"}`。`filters` 只在 `type=custom` 且 `scope=custom` 时是数据范围。不要把 `filters` 叠在 `config` 或预设范围上，也不要把它当查询栏。
+- 写出 `data_permission` 时 `type` 和 `scope` 都必填，优先 `{"type":"custom","scope":"all"}`。整段省略时创建路径才用这个默认。`filters` 只在 `type=custom` 且 `scope=custom` 时是数据范围。不要把 `filters` 叠在 `config` 或预设范围上，也不要把它当查询栏。
+- 写出 `visibility` 时 `mode` 必填。`mode=specific` 必须带 `selectors`（各列表不单独必填，空对象表示尚未配置成员）。`mode=everyone` 时 `external_mode` 必须是 `workspace`。`external_mode=specific` 必须带 `external_selectors`。整段省略时创建路径按工作区可见。
 - 查询栏不要放 relation、attachment、subtable、address、Q-Linker、code-block。
 - 不要新建名为 `全部数据`、`我的数据`、`我发起的`、`待办`、`已办`、`抄送` 的视图。要改它们，先读 raw `view_key` 再 patch。`view_key` 不要加 `custom:` 前缀。
 - 未带 `view_key` 时，唯一同名视图会被更新，重名返回 `AMBIGUOUS_VIEW`。局部修改用 patch，不要用只含少数字段的完整对象去覆盖。

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/complete.json

@@ -311,7 +311,8 @@
     "DataPermission": {
       "type": "object",
       "additionalProperties": false,
-      "dataPermissionDescription": "先选来源 type，再在 type=custom 时选 scope。默认且优先写 custom + all。filters 只在 type=custom 且 scope=custom 时作为数据范围，不会叠在 config 或预设范围上。",
+      "required": ["type", "scope"],
+      "dataPermissionDescription": "写出本对象时 type 与 scope 都必填。优先写 custom + all。整段 data_permission 省略时，创建路径才按 custom + all。filters 只在 type=custom 且 scope=custom 时作为数据范围，不会叠在 config 或预设范围上。",
       "properties": {
         "type": {
           "type": "string",
@@ -320,7 +321,7 @@
             "custom"
           ],
           "default": "custom",
-          "dataPermissionDescription": "数据权限来源，默认 custom。未声明时按 custom + all 创建。config=跟随应用成员授权的数据权限，本视图的 scope 与 filters 不参与查询。custom=使用本视图自己的数据范围(scope)。别名 dataPermissionType(CONFIG/CUSTOM)。",
+          "dataPermissionDescription": "数据权限来源。写出 data_permission 时必填。config=跟随应用成员授权的数据权限，本视图的 scope 与 filters 不参与查询。custom=使用本视图自己的数据范围(scope)。别名 dataPermissionType(CONFIG/CUSTOM)。",
           "x-backend": "dataPermissionType(CONFIG|CUSTOM)"
         },
         "scope": {
@@ -333,7 +334,7 @@
             "custom"
           ],
           "default": "all",
-          "dataScopeDescription": "仅 type=custom 时生效，默认 all。all=不追加数据范围；oneself=仅自己发起；dept=所在部门发起；subordinate=下属发起；custom=用 filters 作为数据范围。type=config 时不要用 scope 选择应用权限，应用授权组的范围写在成员授权上。",
+          "dataScopeDescription": "写出 data_permission 时必填，且只在 type=custom 时生效。all=不追加数据范围；oneself=仅自己发起；dept=所在部门发起；subordinate=下属发起；custom=用 filters 作为数据范围。type=config 时不要用 scope 选择应用权限，应用授权组的范围写在成员授权上。",
           "x-backend": "dataScope(ALL|ONESELF|DEPT|SUBORDINATE|CUSTOM)"
         }
       }
@@ -341,6 +342,34 @@
     "Visibility": {
       "type": "object",
       "additionalProperties": false,
+      "required": ["mode"],
+      "visibilityDescription": "写出 visibility 时 mode 必填。mode=specific 时必须带 selectors；selectors 各列表都不是单独必填，空对象表示指定范围但尚未配置成员。mode=everyone 时 external_mode 必须为 workspace。external_mode=specific 时必须带 external_selectors。整段省略时创建路径按 workspace + external_mode=not。",
+      "allOf": [
+        {
+          "if": {
+            "properties": { "mode": { "const": "specific" } },
+            "required": ["mode"]
+          },
+          "then": { "required": ["selectors"] }
+        },
+        {
+          "if": {
+            "properties": { "mode": { "const": "everyone" } },
+            "required": ["mode"]
+          },
+          "then": {
+            "required": ["external_mode"],
+            "properties": { "external_mode": { "const": "workspace" } }
+          }
+        },
+        {
+          "if": {
+            "properties": { "external_mode": { "const": "specific" } },
+            "required": ["external_mode"]
+          },
+          "then": { "required": ["external_selectors"] }
+        }
+      ],
       "properties": {
         "mode": {
           "type": "string",
@@ -373,6 +402,7 @@
     "VisibilitySelectors": {
       "type": "object",
       "additionalProperties": false,
+      "visibilitySelectorsDescription": "成员、部门、角色用不同列表表达，没有任何一个列表单独必填。mode=specific 时本对象本身必填；空对象是合法回读，表示指定范围但尚未配置成员。要真正授权时，至少填一个非空列表。",
       "properties": {
         "member_uids": {
           "type": "array",

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/data-permission.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://qingflow.com/schemas/builder/views/v1alpha1/details/data-permission.json",
   "title": "Qingflow Views data permission configuration",
-  "dataPermissionDescription": "视图数据权限片段(schema_kind=data-permission)。默认且优先写 data_permission {type: custom, scope: all}。type 选来源，scope 只在 type=custom 时生效；filters 只在 type=custom 且 scope=custom 时作为数据范围。字段直接并入完整视图声明。",
+  "dataPermissionDescription": "视图数据权限片段(schema_kind=data-permission)。写出 data_permission 时 type 与 scope 都必填，优先 {type: custom, scope: all}。整段省略时创建路径才按 custom + all。type 选来源，scope 只在 type=custom 时生效；filters 只在 type=custom 且 scope=custom 时作为数据范围。字段直接并入完整视图声明。",
   "type": "object",
   "additionalProperties": false,
   "properties": {
@@ -36,7 +36,7 @@
       "fieldSchema": "字段类型、默认值等表单侧细节用 app_form_schema 传 schema_kind=field 和 field_type 获取(CLI: builder app-form schema --schema-kind field --field-type TYPE)。"
     }
   },
-  "x-qingflow-apply-semantics": "新建视图默认且应优先写 data_permission type=custom、scope=all。只有要跟随应用成员授权时才用 type=config，此时不要用 scope 表达范围。filters 仅在 type=custom 且 scope=custom 时作为数据范围；省略 filters 表示保留现有规则，空数组表示清空。",
+  "x-qingflow-apply-semantics": "写出 data_permission 时 type 与 scope 都必填，优先 type=custom、scope=all。整段省略时创建路径才按 custom + all。只有要跟随应用成员授权时才用 type=config，此时不要用 scope 表达范围。filters 仅在 type=custom 且 scope=custom 时作为数据范围；省略 filters 表示保留现有规则，空数组表示清空。",
   "x-qingflow-mode-requirements": {
     "default": "未声明 data_permission 时按 custom + all 创建。需要限制行时再改 scope，不要默认改成 config。",
     "config": "跟随应用成员授权的数据权限。视图上的 scope、filters 不参与查询。应用授权组自己可以是全部、自己、部门、下属或自定义公式，那些规则写在成员授权上，不写在视图声明里。",

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/summary.json

@@ -199,7 +199,8 @@
     "DataPermission": {
       "type": "object",
       "additionalProperties": false,
-      "dataPermissionDescription": "先选来源 type，再在 type=custom 时选 scope。默认且优先写 custom + all。filters 只在 type=custom 且 scope=custom 时作为数据范围，不会叠在 config 或预设范围上。",
+      "required": ["type", "scope"],
+      "dataPermissionDescription": "写出本对象时 type 与 scope 都必填。优先写 custom + all。整段 data_permission 省略时，创建路径才按 custom + all。filters 只在 type=custom 且 scope=custom 时作为数据范围，不会叠在 config 或预设范围上。",
       "properties": {
         "type": {
           "type": "string",
@@ -208,7 +209,7 @@
             "custom"
           ],
           "default": "custom",
-          "dataPermissionDescription": "数据权限来源，默认 custom。未声明时按 custom + all 创建。config=跟随应用成员授权的数据权限，本视图的 scope 与 filters 不参与查询。custom=使用本视图自己的数据范围(scope)。别名 dataPermissionType(CONFIG/CUSTOM)。",
+          "dataPermissionDescription": "数据权限来源。写出 data_permission 时必填。config=跟随应用成员授权的数据权限，本视图的 scope 与 filters 不参与查询。custom=使用本视图自己的数据范围(scope)。别名 dataPermissionType(CONFIG/CUSTOM)。",
           "x-backend": "viewgraph.dataPermissionType(CONFIG|CUSTOM)"
         },
         "scope": {
@@ -221,7 +222,7 @@
             "custom"
           ],
           "default": "all",
-          "dataScopeDescription": "仅 type=custom 时生效，默认 all。all=不追加数据范围；oneself=仅自己发起；dept=所在部门发起；subordinate=下属发起；custom=用 filters 作为数据范围(规则在 complete 或 schema_kind=data-permission)。type=config 时不要用 scope 选择应用权限，应用授权组的范围写在成员授权上。dataset-v0 实测分布:all×560 / custom×74 / oneself×71。",
+          "dataScopeDescription": "写出 data_permission 时必填，且只在 type=custom 时生效。all=不追加数据范围；oneself=仅自己发起；dept=所在部门发起；subordinate=下属发起；custom=用 filters 作为数据范围(规则在 complete 或 schema_kind=data-permission)。type=config 时不要用 scope 选择应用权限，应用授权组的范围写在成员授权上。dataset-v0 实测分布:all×560 / custom×74 / oneself×71。",
           "x-backend": "viewgraph.dataScope(ALL|ONESELF|DEPT|SUBORDINATE|CUSTOM)"
         }
       }