@inf-monkeys-tech/monkeys-cli 0.12.32 → 0.12.33

package/oclif.manifest.json

@@ -20020,5 +20020,5 @@
       "strict": true
     }
   },
-  "version": "0.12.32"
+  "version": "0.12.33"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys-cli",
-  "version": "0.12.32",
+  "version": "0.12.33",
   "packageManager": "bun@1.3.14",
   "description": "Monkeys command-line client for AI agents, automation, and interactive use",
   "type": "module",
@@ -150,5 +150,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "monkeysReleaseCommit": "e7a09666262d1e11b0bfbc7b1ae6dd13241d7053"
+  "monkeysReleaseCommit": "a4d2cde9b10c54d9161e8daac0ba2f60479c5ac9"
 }

package/skills/monkeys-data/SKILL.md

@@ -5,18 +5,18 @@ description: 通过 monkeys CLI 理解并操作 Ontology、View、Asset、Field/
 
 # Monkeys Data
 
-先运行 `monkeys skills read monkeys-shared`，遵循公共 Context、安全、输出与版本规则。
+遵循 `monkeys-shared` 的 Context、安全、输出与版本规则；尚未读取时用 `monkeys skills read monkeys-shared`，同一运行不重复加载。
 
 ## 路由与模型
 
-1. 任何 Data 操作先读取[Data 视角路由](references/data-perspective.md)；概念不明确时读取[Ontology 领域模型](references/ontology-model.md)。
-2. 用户未指定 Studio/Kernel 时省略 `--perspective`，由 CLI Studio-first；以 `perspectiveResolution`、`effectivePerspective`、`teamMode` 与 `resourceLocator` 为真相。
+1. 当前运行尚未确认路由规则时读取[Data 视角路由](references/data-perspective.md)；概念不明确时读取[Ontology 领域模型](references/ontology-model.md)。
+2. 用户或当前任务/数据源已限定 Studio/Kernel 时，所有 Data 命令显式传入对应 `--perspective`，不得改为 auto 或切换视角。未限定时省略 `--perspective`，由 CLI Studio-first；以 `perspectiveResolution`、`effectivePerspective`、`teamMode` 与 `resourceLocator` 为真相。
 3. Kernel 全局读取默认不传 `--team`；数据资源定位只传已确认的 `--resource-team`。Team `0` 是共享/系统数据分区，不是所有 Team。
-4. 首次执行命令先用 `monkeys schema data <domain> <action>` 获取当前参数、风险与 dry-run 合同。
+4. 当前版本命令合同未知或参数不确定时用 `monkeys schema data <domain> <action>` 获取当前参数、风险与 dry-run 合同。
 
 ## 按需读取
 
-- 查询、搜索、抽样、媒体与附件：[Data 读取](references/data-read.md)
+- 查询、搜索、候选批量字段/关系、媒体与附件（含 Studio View 筛选合同）：[Data 读取](references/data-read.md)
 - 按 Feature Column 结构化值检索：[Ontology Feature 结构化检索](references/ontology-feature-search.md)
 - 创建和修改资源：[Data 写入](references/data-write.md)
 - Ontology、Container、Trash 与转换：[Data 初步治理](references/data-governance.md)

package/skills/monkeys-data/references/data-read.md

@@ -13,6 +13,14 @@
 - Feature Value：`data value get`
 - Tag/Tag Group：对应的 `list/get`
 
+## Studio View 筛选与结果复用
+
+- 已知数据源的 Ontology/View/Team 时直接验证并使用该入口，不先枚举全部本体。未知 View 用 `data view tree`；字段和标签元数据用 `data field list`、`data tag list`。Studio 不使用 Kernel 专属 `ontology get/export` 探测结构。
+- 查询某个 Studio View 时，`data asset search` 的 `--filter-json` 必须包含 `{"viewId":"实际可读View ID"}`，并用 `--expression-json` 或 `--expression-file` 传筛选。省略 View 不是等价的 View 查询，可能返回空结果；不要将未定位 View 的空结果当成完整业务结论。
+- 标签叶子为 `{"op":"tagGroup","allOf":["标签ID"]}`；可替代选项用 `{"op":"or","filters":[...]}`，同时满足的条件组用 and。标签别名和多个时间段是否取并集由业务问题决定，不把互斥标签错误地全部 AND。`relation` 表达式表示用户/团队权限关系，不表示任意商品业务关联；业务关联从候选 inspect 的 relations 读取。
+- search 的 `--page-size` 最大 100；完整结果使用有界 `--page-all --page-limit`，核验 pageInfo.hasMore，不把截断分页当完整覆盖。列表分页合同见 monkeys-shared。
+- 在同一身份、Context、视角、Ontology/View 和筛选下复用已保存的元数据、候选、inspect 与图片；已有候选直接批量补字段/关系，不扫描全库。只读取任务需要的响应摘要，失败时依据结构化错误修正，不重复执行仍在运行的命令。
+
 ## 流程
 
 1. 用户明确要求 Kernel 时用 `data ontology list --scope all --perspective kernel`；明确要求 Studio 时用 `data ontology list --scope visible --perspective studio --team <Team ID>`。`visible|creatable|all` 是固定语义入口，不在它们之间自动改写。目标 Ontology 已知、用户未指定视角时，后续双视角查询省略 `--perspective`，由 CLI 执行 Studio-first。
@@ -48,6 +56,6 @@ monkeys data view rows --ontology <Ontology ID> --view <View ID> --resource-team
 
 ## 候选 Asset 的完整字段与关系
 
-已得到候选 ID 后，使用 `monkeys data asset inspect --ontology <Ontology ID> --asset-ids-file <ids.json> --perspective kernel --resource-team <已确认 Team> --subscription <Subscription> --output json`。ids.json 是最多1000个精确ID的JSON数组，CLI去重并按100条分批读取；不扫描无关商品或全量导出。默认读取当前作用域全部字段（最多200列）及关系，`--field-id <ID>` 可重复指定。View专属字段须传 `--view <View ID>`；未传View时仅读取全局字段，并列出被排除的作用域字段。
+已得到候选 ID 后，使用 `monkeys data asset inspect --ontology <Ontology ID> --asset-ids-file <ids.json> --perspective <当前已确认视角> --subscription <Subscription> --output json`。Studio 传已确认的 `--team <Team ID>`，Kernel 子资源定位传 `--resource-team <数据 Team>`；不要把示例视角当作切换授权。ids.json 是最多1000个精确ID的JSON数组，CLI去重并按100条分批读取；不扫描无关商品或全量导出。默认读取当前作用域全部字段（最多200列）及关系，`--field-id <ID>` 可重复指定。View专属字段须传 `--view <View ID>`；未传View时仅读取全局字段，并列出被排除的作用域字段。
 
-结果包含字段ID/名称/类型、每个候选的values、missingFieldIds、valueStatus、relations及实际数据请求数。false、0、null不等同于缺失；row-missing不等于空关系，也不能当作资源存在证明。关联目标按返回的Ontology和Asset ID另批读取，避免无界递归。原始结果存工作目录并复用，模型只读取任务需要的摘要；已选候选不要使用全量asset export补字段。
+JSON envelope 中 `.data.fields` 是字段元数据，`.data.items[].assetId/values/relations` 是候选记录；不要将 values 误当成顶层 fields。结果包含字段ID/名称/类型、每个候选的values、missingFieldIds、valueStatus、relations及实际数据请求数。false、0、null不等同于缺失；row-missing不等于空关系，也不能当作资源存在证明。关联目标按返回的Ontology和Asset ID另批读取，避免无界递归。原始结果存工作目录并复用，模型只读取任务需要的摘要；已选候选不要使用全量asset export补字段。

package/skills/monkeys-shared/SKILL.md

@@ -9,13 +9,15 @@ description: 通过 monkeys CLI 选择 Subscription、Context、Team 与 Identit
 
 ## 公共执行流程
 
-1. 运行 `monkeys version show`；若 `_notice.update` 存在，只报告升级提示，得到用户授权后才运行 `monkeys update`。
-2. 运行 `monkeys context show --subscription <Subscription>` 核对 endpoint、tenant、credential kind、Surface 与 Team。Subscription 不明确时先用 `monkeys subscription list`，Team 或 Identity 不明确时用 `monkeys team list`、`monkeys identity list`，禁止猜测。
-3. 第一次使用命令或参数不确定时运行 `monkeys schema <command path>`；领域导航不明确时运行 `monkeys --help`。
+1. 同一运行首次使用时确认 CLI 版本；若运行环境已提供已校验的安装版本，直接复用，否则运行 `monkeys version show`。若 `_notice.update` 存在，只报告升级提示，得到用户授权后才运行 `monkeys update`。
+2. 从当前运行 Context 核对 endpoint、tenant、credential kind、Surface 与 Team；缺失或变化时才运行 `monkeys context show --subscription <Subscription>`。Subscription 不明确时先用 `monkeys subscription list`，Team 或 Identity 不明确时用 `monkeys team list`、`monkeys identity list`，禁止猜测。
+3. 当前版本的命令合同未知或参数不确定时运行 `monkeys schema <command path>`；领域导航不明确时运行 `monkeys --help`。
 4. 默认消费 JSON envelope：成功从 stdout 读取 `.data`，失败从 stderr 读取 `.error`，系统提示读取 `._notice`。需要窄字段时使用 `--jq`；面向人展示时才用 `--output table|text`。错误永远不经过 `--jq`。
 5. 写操作先运行 `--dry-run`，回显精确 Subscription、Team、目标 ID 与风险。只有 schema 标记需要确认时才传 `--yes`，不得自动重放结果未知的写请求。
 6. 返回结果、关键资源 ID 与 Context Fingerprint；失败时返回 error code、recovery、retryable 和副作用是否未知。
 
+已读取的 Skill、Schema 与 Context 在同一运行和相同版本/身份/数据范围内复用，不因每条命令重复读取；版本、身份或作用域变化时重新核验。业务 Skill 负责业务选择和报告格式，不复制 CLI 参数与返回结构。工作中间文件放运行环境指定的工作目录；已有结果落盘复用，未结束命令继续等待/读取，不重复启动。
+
 ## 按需读取
 
 - 平台领域与命令入口：[平台能力地图](references/platform-overview.md)

package/skills/monkeys-shared/references/compatibility.md

@@ -1,7 +1,7 @@
 # 兼容性
 
 - 本 Skill 面向命令 Schema Major `4`，最低 CLI 版本 `0.12.0`。
-- 开始任务时运行 `monkeys version show --output json`。
+- 同一运行确认版本一次；可复用运行环境提供的已校验安装版本，否则运行 `monkeys version show --output json`，版本变化时重新核验。
 - 任意结构化输出中的 `_notice.update` 表示 npm `latest` 高于当前 CLI；报告 `current`、`latest` 与 `command`。可用 `monkeys update --check --output json` 实时复核，只有用户明确授权后才运行 `monkeys update` 或 `monkeys update --force`。
 - `monkeys update` 只更新由 npm 或 pnpm 实际拥有的安装，精确安装目标版本，并验证 shell PATH、版本 envelope、全部 8 个同版本 Skills 的实际发现路径与校验和。任一最终验证失败都回滚到精确旧版本并返回结构化错误；用 `monkeys skills status` 检查实际漂移，用 `monkeys skills sync` 只重同步 Skills。
 - CLI Major、命令 Schema Major 或 Skill 声明不兼容时停止写操作，升级匹配版本后再继续。