openyida 2026.7.13 → 2026.7.14-1

package/README.md

@@ -55,10 +55,10 @@ If Codex is already installed, OpenYida also imports a local Codex plugin during
 Run this from the AI coding workspace where you want OpenYida to operate:
 
 ```bash
-openyida agent-capabilities --json
+openyida agent-capabilities --summary-json
 ```
 
-OpenYida detects the active agent environment, workspace path, login state, organization context, command manifest, and side-effect hints in one machine-readable snapshot. `openyida commands --json` remains available when an agent only needs the command manifest.
+OpenYida returns a compact machine-readable summary with the version, login state, workspace/cache paths, and command manifest digest. `openyida agent-capabilities --json` is the full diagnostic snapshot, where compact `workdir` maps to `active.projectRoot` and `workdir_exists` maps to `active.projectRootExists`. `openyida commands --json` remains available when an agent only needs the command manifest.
 
 ### 3. Log In
 
@@ -457,7 +457,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | Command | Description |
 |---------|-------------|
 | `openyida commands [--json]` | Output machine-readable command manifest |
-| `openyida agent-capabilities [--json]` | Output one-shot agent capability snapshot |
+| `openyida agent-capabilities [--json] [--summary-json\|--compact]` | Output one-shot agent capability snapshot |
 | `openyida a2a <serve\|agent-card> [options]` | Start local read-only A2A adapter or print Agent Card |
 | `openyida bridge start [--token <pair-token>] [--port 6736] [--origin https://demo.aliwork.com] [--open\|--no-open]` | Start OpenYida local web bridge service |
 | `openyida copy [--force]` | Copy project working directory |

package/lib/core/agent-capabilities.js

@@ -1,5 +1,6 @@
 'use strict';
 
+const crypto = require('crypto');
 const path = require('path');
 const { version } = require('../../package.json');
 const { t } = require('./i18n');
@@ -14,6 +15,79 @@ function redactLogin(login) {
   return redacted;
 }
 
+function compactLogin(login) {
+  return {
+    status: login.status,
+    can_auto_use: login.can_auto_use === true,
+  };
+}
+
+function canonicalize(value) {
+  if (Array.isArray(value)) {
+    return value.map(canonicalize);
+  }
+  if (!value || typeof value !== 'object') {
+    return value;
+  }
+
+  return Object.keys(value)
+    .sort()
+    .reduce((result, key) => {
+      result[key] = canonicalize(value[key]);
+      return result;
+    }, {});
+}
+
+function buildCommandManifestDigest(manifest) {
+  const digestPayload = {
+    schema_version: manifest.schema_version,
+    command_prefix: manifest.command_prefix,
+    summary: {
+      command_count: manifest.summary.command_count,
+      group_count: manifest.summary.group_count,
+      side_effect_counts: manifest.summary.side_effect_counts,
+      permission_mode_counts: manifest.summary.permission_mode_counts,
+      core_workflows: manifest.summary.core_workflows,
+    },
+    commands: manifest.commands.map(entry => ({
+      id: entry.id,
+      usage: entry.usage,
+      requires_login: entry.requires_login,
+      output: entry.output,
+      side_effect_kind: entry.side_effect && entry.side_effect.kind,
+      permission_mode: entry.permission && entry.permission.mode,
+      permission_effect: entry.permission && entry.permission.effect,
+    })),
+  };
+
+  return crypto
+    .createHash('sha256')
+    .update(JSON.stringify(canonicalize(digestPayload)))
+    .digest('hex');
+}
+
+function buildAgentCapabilitiesSummary() {
+  const envSnapshot = buildEnvironmentSnapshot();
+  const loginStatus = checkLoginOnly({ includeSecrets: false });
+  const manifest = buildCommandManifest({ t, version });
+  const projectRoot = envSnapshot.active.projectRoot;
+
+  return {
+    schema_version: 1,
+    name: 'openyida-agent-capabilities-summary',
+    version,
+    login: compactLogin(loginStatus),
+    workdir: projectRoot,
+    workdir_exists: !!envSnapshot.active.projectRootExists,
+    cache_dir: path.join(projectRoot, '.cache'),
+    openyida_task_cache_dir: path.join(projectRoot, '.cache', 'openyida'),
+    command_manifest_digest: buildCommandManifestDigest(manifest),
+    command_manifest_digest_algorithm: 'sha256',
+    command_count: manifest.summary.command_count,
+    full_capabilities_command: 'openyida agent-capabilities --json',
+  };
+}
+
 function buildAgentCapabilities() {
   const envSnapshot = buildEnvironmentSnapshot();
   const loginStatus = redactLogin(checkLoginOnly({ includeSecrets: false }));
@@ -32,7 +106,8 @@ function buildAgentCapabilities() {
     active: envSnapshot.active,
     login: loginStatus,
     recommended: {
-      preflight_command: 'openyida agent-capabilities --json',
+      preflight_command: 'openyida agent-capabilities --summary-json',
+      full_capabilities_command: 'openyida agent-capabilities --json',
       mutation_guard: 'Run mutating commands only when login.status is ok or after a successful openyida login.',
       workdir: projectRoot,
       cache_dir: path.join(projectRoot, '.cache'),
@@ -58,7 +133,7 @@ function buildAgentCapabilities() {
     },
     sideEffects: {
       read_only_preflight: [
-        'openyida agent-capabilities --json',
+        'openyida agent-capabilities --summary-json',
         'openyida env --json',
         'openyida login --check-only --json',
         'openyida commands --json',
@@ -80,11 +155,20 @@ function buildAgentCapabilities() {
   };
 }
 
-async function run() {
-  console.log(JSON.stringify(buildAgentCapabilities(), null, 2));
+function shouldUseSummary(args = []) {
+  return args.includes('--summary-json') || args.includes('--compact');
+}
+
+async function run(args = []) {
+  const payload = shouldUseSummary(args)
+    ? buildAgentCapabilitiesSummary()
+    : buildAgentCapabilities();
+  console.log(JSON.stringify(payload, null, 2));
 }
 
 module.exports = {
   buildAgentCapabilities,
+  buildAgentCapabilitiesSummary,
+  buildCommandManifestDigest,
   run,
 };

package/lib/core/command-manifest.js

@@ -871,7 +871,7 @@ const COMMAND_GROUPS = [
         requiresLogin: false,
         output: 'json',
       }),
-      command('agent-capabilities', ['agent-capabilities'], 'agent-capabilities [--json]', 'help.cmd_agent_capabilities', {
+      command('agent-capabilities', ['agent-capabilities'], 'agent-capabilities [--json] [--summary-json|--compact]', 'help.cmd_agent_capabilities', {
         requiresLogin: false,
         output: 'json',
       }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.7.13",
+  "version": "2026.7.14-1",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "bin/yida.js",

package/scripts/postinstall.js

@@ -206,10 +206,14 @@ description: >
 在执行任何会创建、修改或发布真实宜搭资源的操作前，先运行只读检查：
 
 \`\`\`bash
-openyida agent-capabilities --json
+openyida agent-capabilities --summary-json
 \`\`\`
 
-该命令一次返回版本、当前工作目录、AI 工具环境、登录态摘要和命令清单，避免反复探测 \`which\`、\`--version\`、\`--help\`、\`env\` 和 \`login --check-only\`。
+该 compact 命令一次返回版本、登录态摘要、工作目录、缓存目录和命令 manifest digest，避免大 JSON 被宿主 offload，也避免反复探测 \`which\`、\`--version\`、\`--help\`、\`env\` 和 \`login --check-only\`。
+
+\`openyida agent-capabilities --json\` 是 full capabilities，只用于命令契约排障或深度诊断；不要放进完整应用 \`fast_build\` 默认链路。
+
+字段映射：compact 输出的 \`workdir\` 对应 full capabilities 的 \`active.projectRoot\`；\`workdir_exists\` 对应 \`active.projectRootExists\`。
 
 如果 \`openyida\` 不存在，先提醒用户需要安装，或在用户同意后执行：
 

package/yida-skills/SKILL.md

@@ -26,7 +26,11 @@ description: >
 
 > ⚡ **前置门槛**：确认 openyida 已安装、Node/npm 依赖达标、登录态就绪。**未通过只读验证前，禁止创建应用/页面/表单或发布等任何真实资源操作。**
 
-**怎么做**：优先跑一次 `openyida agent-capabilities --json`。该命令一次返回 version、cwd、AI 工具环境、推荐工作目录、登录态摘要、commands、command count、sideEffects 和默认 `fast_build` 契约，避免反复 `which openyida`、`openyida --version`、`openyida --help`、`openyida env`、`login --check-only`。
+**怎么做**：优先跑一次 `openyida agent-capabilities --summary-json`。该 compact 命令只返回 version、`login.status`、`login.can_auto_use`、`workdir`、`workdir_exists`、`cache_dir`、`openyida_task_cache_dir`、`command_count` 和 `command_manifest_digest` 等 agent 必需字段，避免 stdout 过大导致宿主 offload 或误判未读到结果，也避免反复 `which openyida`、`openyida --version`、`openyida --help`、`openyida env`、`login --check-only`。
+
+`openyida agent-capabilities --json` 是 full capabilities，只在命令契约排障、manifest 差异诊断或深度调试时使用；不要把 full capabilities 放进 `fast_build` 默认链路。
+
+字段映射：compact 输出的 `workdir` 对应 full capabilities 的 `active.projectRoot`；`workdir_exists` 对应 `active.projectRootExists`。
 
 若当前 OpenYida 版本还没有 `agent-capabilities`，退回跑 `openyida env --json` 和 `openyida login --check-only --json`。旧版本地 agent 不需要认识 `skills-index.json`，也不需要支持 `agent-capabilities` 才能继续执行。
 
@@ -35,7 +39,7 @@ description: >
 | 命令跑不了（`command not found`） | openyida 未安装 → `npm install -g openyida` |
 | Node/npm 版本不达标 | 先升级 Node（≥16）再装/升级 openyida |
 | `login.status` 不是 `ok` 且 `login.can_auto_use` 不是 true | 未登录 → `openyida login`（指定入口带 URL 或 flag） |
-| `active.projectRootExists` 为 false | 无工作目录 → `openyida copy` 初始化 |
+| `workdir_exists` / `active.projectRootExists` 为 false | 无工作目录 → `openyida copy` 初始化 |
 
 **👉 环境异常、登录失败、悟空降级、Codex handoff 等特殊分支 → [references/setup-and-env.md](references/setup-and-env.md)。正常 `agent-capabilities` 通过时不要默认读取该 reference。**
 

package/yida-skills/skills/sls-log-workbench/SKILL.md

@@ -32,7 +32,7 @@ metadata:
 ### 使用前置校验
 
 1. 检查用户当前消息是否提供第一个词作为授权口令；同一会话首次通过脚本校验后可复用。
-2. 运行 `openyida env --json` 或 `openyida agent-capabilities --json`，读取当前登录态 corpId。
+2. 运行 `openyida env --json` 读取当前登录态 corpId；只需确认登录状态时可用 `openyida agent-capabilities --summary-json`。
 3. corpId 必须精确匹配 `ding328fe145009a4328f2c783f7214b6d69`。
 4. 任一校验失败，立即终止，不打开页面、不调用 API、不展示部分查询信息。