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

package/oclif.manifest.json

@@ -2724,7 +2724,7 @@
           "required": true
         }
       },
-      "description": "Get Asset by exact ID.",
+      "description": "Get Asset by exact ID. For candidate fields and relations, use data asset inspect.",
       "enableJsonFlag": false,
       "flags": {
         "bucket": {
@@ -2776,6 +2776,13 @@
           "summary": "Use only this Data perspective; when omitted, read queries use Studio first and may fall back to Kernel",
           "type": "option"
         },
+        "resource-team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "resource-team",
+          "summary": "Kernel Ontology data resource location Team; does not represent Team filtering and cannot be used simultaneously with --team",
+          "type": "option"
+        },
         "subscription": {
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3294,6 +3301,134 @@
       ],
       "strict": true
     },
+    "data:asset:inspect": {
+      "aliases": [],
+      "args": {},
+      "description": "Batch-read fields and relations for exact candidate Asset IDs without listing or exporting the Ontology. Missing values remain explicit; related assets are not recursively fetched.",
+      "enableJsonFlag": false,
+      "flags": {
+        "asset-ids-file": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "asset-ids-file",
+          "required": true,
+          "summary": "JSON array of 1-1000 exact Asset IDs; duplicates are read once",
+          "type": "option"
+        },
+        "bucket": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "bucket",
+          "summary": "Old Bucket ID (deprecated; new tasks use --ontology)",
+          "type": "option"
+        },
+        "field-id": {
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "name": "field-id",
+          "summary": "Exact Field ID; repeat to select fields; defaults to all fields visible in the chosen scope (maximum 200)",
+          "type": "option"
+        },
+        "jq": {
+          "char": "q",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "jq",
+          "summary": "Filter the JSON result with a jq expression",
+          "type": "option"
+        },
+        "ontology": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "ontology",
+          "summary": "Ontology ID",
+          "type": "option"
+        },
+        "output": {
+          "default": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "output",
+          "options": [
+            "json",
+            "pretty",
+            "table",
+            "ndjson",
+            "csv",
+            "text"
+          ],
+          "summary": "Output format",
+          "type": "option"
+        },
+        "perspective": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "perspective",
+          "options": [
+            "kernel",
+            "studio"
+          ],
+          "summary": "Use only this Data perspective; when omitted, read queries use Studio first and may fall back to Kernel",
+          "type": "option"
+        },
+        "relations": {
+          "allowNo": true,
+          "name": "relations",
+          "summary": "Include normalized incoming/outgoing relations for selected relation fields",
+          "type": "boolean"
+        },
+        "resource-team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "resource-team",
+          "summary": "Kernel Ontology data resource location Team; does not represent Team filtering and cannot be used simultaneously with --team",
+          "type": "option"
+        },
+        "subscription": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "subscription",
+          "summary": "Subscription name",
+          "type": "option"
+        },
+        "team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "team",
+          "summary": "Studio Team context; only used under Kernel for explicit Team filtering",
+          "type": "option"
+        },
+        "view": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "view",
+          "summary": "Exact View scope for View-exclusive fields; omitted reads global fields only",
+          "type": "option"
+        },
+        "yes": {
+          "allowNo": false,
+          "char": "y",
+          "name": "yes",
+          "summary": "Confirm destructive or privileged operations",
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "data:asset:inspect",
+      "isESM": true,
+      "pluginAlias": "@inf-monkeys-tech/monkeys-cli",
+      "pluginName": "@inf-monkeys-tech/monkeys-cli",
+      "pluginType": "core",
+      "relativePath": [
+        "dist",
+        "commands",
+        "data",
+        "asset",
+        "inspect.js"
+      ],
+      "strict": true
+    },
     "data:asset:list": {
       "aliases": [],
       "args": {},
@@ -3533,6 +3668,13 @@
           "summary": "Use only this Data perspective; when omitted, read queries use Studio first and may fall back to Kernel",
           "type": "option"
         },
+        "resource-team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "resource-team",
+          "summary": "Kernel Ontology data resource location Team; does not represent Team filtering and cannot be used simultaneously with --team",
+          "type": "option"
+        },
         "source": {
           "default": "auto",
           "hasDynamicHelp": false,
@@ -3544,7 +3686,7 @@
             "media",
             "thumbnail"
           ],
-          "summary": "Media source; auto select primary, media, thumbnail in sequence",
+          "summary": "Media source; auto tries distinct primary, media, thumbnail sources on recoverable failures",
           "type": "option"
         },
         "subscription": {
@@ -19878,5 +20020,5 @@
       "strict": true
     }
   },
-  "version": "0.12.30"
+  "version": "0.12.32"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys-cli",
-  "version": "0.12.30",
+  "version": "0.12.32",
   "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": "632d473a7d1bbef25c93cd3b0b227f1dbf5c8bdb"
+  "monkeysReleaseCommit": "e7a09666262d1e11b0bfbc7b1ae6dd13241d7053"
 }

package/skills/monkeys-data/SKILL.md

@@ -29,3 +29,5 @@ description: 通过 monkeys CLI 理解并操作 Ontology、View、Asset、Field/
 - 筛选失败或空集合不得触发 View 转换、Raw API、PG 扫描或视角写重放。
 - Data 文件未指定文件格式时按 JSONL；真实导入必须先对同一输入完成全量 dry-run，并获得精确 Subscription、Perspective、Ontology 与文件授权。
 - Asset/附件 URL 只在 CLI 内部使用；不得显示、签名或经普通 HTTP 工具处理。
+
+已选候选需要字段/关系时优先用 `data asset inspect --asset-ids-file <ids.json>`，详见 [读取](references/data-read.md)；不要为少量候选导出整个本体。

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

@@ -24,8 +24,8 @@
 7. 只有用户明确要求简略列表、资源元数据或低上下文投影时，才使用 `data asset list --view <View ID>`。默认单页有界；只有用户确实需要时扩大范围。
 8. 抽样使用 `data asset sample` 的有界样本，不自行无限翻页后随机。
 9. 只复用同一 Context、Team 模式、Data 合同、Ontology、View 和查询生成的 Cursor；CLI Cursor 会保留自动路由后的实际 Data Perspective，游标不匹配时重新查询。
-10. 用户需要读取、查看或保存 Asset 封面图片/媒体时，使用 `monkeys data asset media download <Asset ID> --ontology <Ontology ID> --out <本地路径> --subscription <Subscription> --output json`；用户明确指定视角时再补 `--perspective studio|kernel`。`--source auto` 默认依次选择 `primaryContent.value`、`media`、`thumbnail`；需要特定来源时显式传 `--source`。
-11. 用户需要 View Feature 中的 PDF/文件时，使用 `monkeys data asset attachment download <Asset ID> --ontology <Ontology ID> --view <View ID> --field <Field ID 或唯一精确名称> --out <本地路径> --subscription <Subscription> --output json`；用户明确指定视角时再补 `--perspective studio|kernel`。历史 Field 类型可能是 `img`，仍应按实际 Content-Type/文件内容称为 PDF 或附件，不要误称为图片。
+10. 用户需要读取、查看或保存 Asset 封面图片/媒体时，使用 `monkeys data asset media download <Asset ID> --ontology <Ontology ID> --out <本地路径> --subscription <Subscription> --output json`；明确 Kernel 时补 `--perspective kernel --resource-team <已确认的数据 Team>`，明确 Studio 时补 `--perspective studio --team <Team ID>`，不要混传两种 Team 参数。`--source auto` 按 `primaryContent.value`、`media`、`thumbnail` 顺序尝试不同地址；网络、5xx 或非媒体响应等可恢复错误会继续下一来源，同一地址只下载一次。显式指定来源时不自动换源；权限、签名校验、重定向、文件大小和本地写入错误仍直接报告。
+11. 用户需要 View Feature 中的 PDF/文件时，使用 `monkeys data asset attachment download <Asset ID> --ontology <Ontology ID> --view <View ID> --field <Field ID 或唯一精确名称> --out <本地路径> --subscription <Subscription> --output json`；明确 Kernel 时补 `--perspective kernel --resource-team <已确认的数据 Team>`，明确 Studio 时补 `--perspective studio --team <Team ID>`，不要混传两种 Team 参数。历史 Field 类型可能是 `img`，仍应按实际 Content-Type/文件内容称为 PDF 或附件，不要误称为图片。
 12. 下载成功后依据 CLI 返回的本地 `path` 展示或处理文件，并向用户报告来源 Field、大小和 SHA-256；不要把二进制正文塞入 JSON 或聊天文本。
 13. 两种下载都由 CLI 内部处理对象地址：公开 HTTPS 对象使用匿名、无身份 Header、无重定向、有界原子下载；对象明确返回 401/403/404 时，CLI 才请求 Server 生成短期签名并重试。CLI 不自行签名，任何规范或签名 URL 都不得进入结构化输出或聊天。网络错误、重定向、异常 Content-Type、超限或签名失败必须直接报告，不得使用普通 HTTP、Raw API 或手工 URL 兜底。
 14. 覆盖本地已有文件前必须得到用户对该精确路径的授权，并同时传 `--overwrite --yes`。默认最大 50 MiB；只有任务确有需要时才提高 `--max-bytes`，不得超过 1 GiB。
@@ -45,3 +45,9 @@ monkeys data view rows --ontology <Ontology ID> --view <View ID> --resource-team
 前两类输出应为 `teamMode=filter`、`effectiveTeamId=0`；第三类仍为 `teamMode=none`，并通过 `resourceLocator.teamId=0` 报告后端分区定位。不要同时传 `--team 0` 与 `--resource-team 0`，也不要把任一形式解释为“查询所有 Team”。
 
 `visible` 只表示当前身份可以读取，不代表可以创建、更新或治理。`data bucket` 和 `--bucket` 只用于旧脚本/旧部署兼容；新任务不得优先使用。
+
+## 候选 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/名称/类型、每个候选的values、missingFieldIds、valueStatus、relations及实际数据请求数。false、0、null不等同于缺失；row-missing不等于空关系，也不能当作资源存在证明。关联目标按返回的Ontology和Asset ID另批读取，避免无界递归。原始结果存工作目录并复用，模型只读取任务需要的摘要；已选候选不要使用全量asset export补字段。

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

@@ -72,3 +72,7 @@ Ontology 全局 Asset 导出会遍历 View，默认合并多 View Membership 和
 - Ontology 映射报告最大 32 MiB。全局 Membership 导出使用磁盘分区；单分区超过 16 MiB 或 100,000 条时显式失败，应缩小到 View 作用域或拆分迁移，不得放宽内存门禁后自动重试。
 - XLSX 只使用 `data` 工作表，任何公式 Cell 都拒绝导入。
 - 本能力不打包图片、PDF 或其他附件二进制。附件仍按 Data 读取 Skill 使用专用下载命令处理。
+
+## 同一目标的重复导出
+
+导出持有目标文件的排他锁；返回 `DATA_TRANSFER_IN_PROGRESS` 时等待已有进程，不因最终文件尚未出现而重启。成功后读取已有结果。进程异常退出留下锁时，先确认原进程已终止再移除该精确锁文件；不要自动按时长抢锁。