@thinkingai/ae-cli 6.1.25 → 6.1.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/README.md +28 -9
  2. package/README.zh.md +25 -9
  3. package/bin/ae-cli.js +6 -1
  4. package/cli-installation-guide.md +91 -0
  5. package/dist/{auth-LHM7NQPR.js → auth-YHMC3GDH.js} +6 -8
  6. package/dist/automation-NWWVLWG2.js +459 -0
  7. package/dist/{capability-SJI5KOCK.js → capability-3QLLIVFB.js} +6 -6
  8. package/dist/chunk-4655PUNX.js +43 -0
  9. package/dist/{chunk-KS4DE3MX.js → chunk-5XJYLEVC.js} +4 -4
  10. package/dist/{chunk-N4BLPJC7.js → chunk-7QXISROD.js} +1 -1
  11. package/dist/{chunk-7WZACOAI.js → chunk-AP7YP2NX.js} +2 -2
  12. package/dist/{chunk-SO5LKIWP.js → chunk-CT7QDJS6.js} +2 -2
  13. package/dist/chunk-D6ACFILC.js +56 -0
  14. package/dist/{chunk-QYXDJOLA.js → chunk-EOYSKMXN.js} +19 -11
  15. package/dist/{chunk-5XRQ3CZR.js → chunk-FMNNGNYO.js} +43 -8
  16. package/dist/{chunk-DU72X2IO.js → chunk-GIK6EDUG.js} +22 -10
  17. package/dist/chunk-HVHR4SCP.js +133 -0
  18. package/dist/{chunk-2FJM4HRV.js → chunk-KAEHZZH4.js} +3 -3
  19. package/dist/{chunk-BW7JUDEI.js → chunk-KFNMQTZI.js} +514 -213
  20. package/dist/{chunk-KJDOTPYU.js → chunk-PLE722AJ.js} +28 -11
  21. package/dist/chunk-RK6GLDGI.js +27 -0
  22. package/dist/{chunk-GK7WDY7E.js → chunk-S6M42KND.js} +1 -1
  23. package/dist/{chunk-IG3DYEIR.js → chunk-UQ77JXYH.js} +4 -3
  24. package/dist/{chunk-YVGXGTD6.js → chunk-WNGFSIOB.js} +7 -1
  25. package/dist/{chunk-XKIW3QMF.js → chunk-XCHAYMSF.js} +3 -3
  26. package/dist/{community-report-client-6VJDDMJJ.js → community-report-client-PEERQCX2.js} +1 -1
  27. package/dist/{config-XQWOPDHN.js → config-AHPMEW5A.js} +4 -4
  28. package/dist/context-YAE3QXP3.js +136 -0
  29. package/dist/{data-integration-XBTCGXQT.js → data-integration-HESZET7E.js} +6 -6
  30. package/dist/index.js +123 -46
  31. package/dist/{local-data-upload-client-3P7NIVQ4.js → local-data-upload-client-TWMHFLUA.js} +1 -1
  32. package/dist/memory-62BJOULV.js +580 -0
  33. package/dist/{metadata-JRYKNUS5.js → metadata-C7CEDHOJ.js} +7 -7
  34. package/dist/{model-ZS7HVGKN.js → model-SBV2JFJI.js} +9 -5
  35. package/dist/{personal-semantic-preference-IDE2GE5T.js → personal-semantic-preference-QECDPHND.js} +117 -11
  36. package/dist/{project-semantic-36KOCYN7.js → project-semantic-Z4QAMBWF.js} +6 -6
  37. package/dist/{sync-EQLSTUS7.js → sync-SU33KYX7.js} +12 -8
  38. package/dist/{te-agent-Z3HCTKR7.js → te-agent-F5QBZSQA.js} +90 -454
  39. package/dist/{te-analysis-5ZZ6YHVH.js → te-analysis-2ECAAIFK.js} +297 -20
  40. package/dist/{te-community-Z7JACGF3.js → te-community-PFLDLPP4.js} +3 -3
  41. package/dist/{te-dataops-F7GQOIS6.js → te-dataops-FOQSRIAZ.js} +5 -5
  42. package/dist/{te-engage-RNRMYDO3.js → te-engage-QKUGIWSR.js} +6 -6
  43. package/dist/{te-experiment-BTAC2UNK.js → te-experiment-26PXR2UO.js} +6 -6
  44. package/dist/{te-kb-QJLJEX5K.js → te-kb-MHDOST62.js} +494 -214
  45. package/dist/{te-system-IXC43QHZ.js → te-system-J2FQF5ER.js} +6 -6
  46. package/dist/{te-team-BIZIKIHZ.js → te-team-5UOZPTU3.js} +6 -6
  47. package/dist/things-VPPXXLHB.js +1091 -0
  48. package/dist/{update-W2SGQNKT.js → update-EEUTEI6R.js} +59 -51
  49. package/dist/workspace-O3EEIYQM.js +554 -0
  50. package/package.json +21 -9
  51. package/skills/ae-agent/SKILL.md +89 -139
  52. package/skills/ae-agent/references/add-model.md +1 -1
  53. package/skills/ae-agent/references/create-agent.md +1 -1
  54. package/skills/ae-agent/references/find-archived-conversations.md +12 -5
  55. package/skills/ae-agent/references/get-agent.md +1 -1
  56. package/skills/ae-agent/references/list-agents.md +2 -2
  57. package/skills/ae-agent/references/list-models.md +2 -2
  58. package/skills/ae-agent/references/restore-conversation.md +3 -1
  59. package/skills/ae-analysis/SKILL.md +15 -6
  60. package/skills/ae-analysis/references/ai_models/funnel.md +5 -3
  61. package/skills/ae-analysis/references/ai_models.md +27 -0
  62. package/skills/ae-analysis/references/command_index.md +12 -4
  63. package/skills/ae-analysis/references/dashboard_move.md +21 -0
  64. package/skills/ae-analysis/references/dashboard_report_add.md +2 -0
  65. package/skills/ae-analysis/references/dashboard_report_get.md +19 -0
  66. package/skills/ae-analysis/references/dashboard_report_update.md +27 -0
  67. package/skills/ae-analysis/references/dashboard_update.md +1 -1
  68. package/skills/ae-analysis/references/event_report_presentation.md +76 -0
  69. package/skills/ae-analysis/references/feedback_submit.md +37 -0
  70. package/skills/ae-analysis/references/metadata_resolution.md +15 -0
  71. package/skills/ae-analysis/references/personal_semantic_preference_review.md +9 -0
  72. package/skills/ae-analysis/references/personal_semantic_preference_review_list.md +7 -0
  73. package/skills/ae-analysis/references/personal_semantic_preference_submit.md +7 -0
  74. package/skills/ae-analysis/references/project_semantic_knowledge_wiki.md +68 -27
  75. package/skills/ae-analysis/references/project_semantic_knowledge_wiki_plan_schema.md +40 -1
  76. package/skills/ae-analysis/references/report_create.md +13 -3
  77. package/skills/ae-analysis/references/report_get.md +5 -1
  78. package/skills/ae-analysis/references/report_update.md +15 -4
  79. package/skills/ae-analysis/references/system_query_monitor_overview.md +2 -0
  80. package/skills/ae-analysis/references/system_query_task_cancel.md +2 -0
  81. package/skills/ae-analysis/references/system_query_task_export.md +6 -2
  82. package/skills/ae-analysis/references/system_query_task_get.md +2 -0
  83. package/skills/ae-analysis/references/system_query_task_list.md +7 -3
  84. package/skills/ae-analysis/references/system_query_task_options.md +2 -2
  85. package/skills/ae-analysis/references/system_query_task_realtime_list.md +15 -0
  86. package/skills/ae-analysis/references/user_tag_models.md +2 -0
  87. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/build-empty-skeleton.mjs +105 -0
  88. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/build-project-semantic-wiki.mjs +337 -22
  89. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/company-kb.mjs +21 -8
  90. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/default-compile-rules.md +24 -11
  91. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/default-compile-schema.md +66 -0
  92. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/generate-build-ir.mjs +1 -0
  93. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/package-wiki-source-zip.mjs +109 -40
  94. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/plan-kb-source-sync.mjs +1 -1
  95. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/prepare-compile-schema.mjs +64 -0
  96. package/skills/ae-analysis/scripts/project-semantic-knowledge-wiki/refresh-state-parts.mjs +91 -0
  97. package/skills/ae-automation/SKILL.md +16 -0
  98. package/skills/ae-automation/references/cli.md +53 -0
  99. package/skills/ae-automation/references/command_index.md +17 -0
  100. package/skills/ae-capability/SKILL.md +15 -6
  101. package/skills/ae-current-context/SKILL.md +3 -2
  102. package/skills/ae-kb/SKILL.md +62 -12
  103. package/skills/ae-kb/references/analysis-workflow.md +73 -36
  104. package/skills/ae-kb/references/query-workflow.md +67 -33
  105. package/skills/ae-kb/references/schema-import.md +5 -3
  106. package/skills/ae-kb/references/source-mutations.md +6 -4
  107. package/skills/ae-kb/references/text-sources.md +53 -0
  108. package/skills/ae-kb-discovery/SKILL.md +1 -1
  109. package/skills/ae-team/SKILL.md +23 -17
  110. package/skills/ae-things/SKILL.md +85 -0
  111. package/skills/ae-things/references/cli.md +103 -0
  112. package/skills/ae-things-progress/SKILL.md +43 -0
  113. package/skills/ae-things-review/SKILL.md +42 -0
  114. package/skills/ae-workspace/SKILL.md +43 -0
  115. package/skills/ae-workspace/references/commands.md +51 -0
  116. package/dist/chunk-E2JKXMVO.js +0 -29
  117. package/dist/context-M3HDGEIR.js +0 -46
  118. package/dist/memory-6APEB2JB.js +0 -892
  119. package/skills/ae-agent/references/create-automation.md +0 -125
  120. package/skills/ae-agent/references/list-automations.md +0 -56
  121. package/skills/ae-agent/references/update-automation.md +0 -107
package/README.md CHANGED
@@ -15,8 +15,9 @@ The CLI is designed around:
15
15
  ## Requirements
16
16
 
17
17
  - Node.js 20 or later.
18
+ - macOS, Linux, or native Windows (PowerShell / Command Prompt); WSL is optional.
18
19
  - Access to the npm registry for CLI installation.
19
- - Access to GitHub when installing Skills initially or when the local Skills fallback cannot be used.
20
+ - Access to GitHub only when the bundled Skills source cannot be used.
20
21
 
21
22
  ## Installation
22
23
 
@@ -25,10 +26,12 @@ For setup through Codex, Claude Code, Cursor, or another terminal-capable AI Age
25
26
  Install the public CLI and Agent Skills:
26
27
 
27
28
  ```bash
28
- npm install -g @thinkingai/ae-cli
29
- npx -y skills add ThinkingAIAgenticEngine/ae-cli -g -y
29
+ npx @thinkingai/ae-cli@latest install
30
+ npx @thinkingai/ae-cli@latest install --format json
30
31
  ```
31
32
 
33
+ The installer checks Node.js 20+, installs and verifies the CLI, then installs matching Skills globally in `~/.agents/skills`, writing the shared files once before automatically distributing copies to clients that need their own directory. No Agent selection is needed; Codex and Cursor can share these Skills even when installed later. `--dry-run`, `--format json`, and optional `--host <AE_HOST>` are supported. Unrelated project-only client warnings are hidden after successful verification; missing files and YAML errors remain failures. Being logged out is not an installation failure. See the [installation guide](./cli-installation-guide.md).
34
+
32
35
  The Skills teach supported coding Agents, including Claude Code, Codex, Cursor, and similar tools, how to discover and call `ae-cli`.
33
36
 
34
37
  Install optional, approved scenario Skills with an interactive category picker:
@@ -57,6 +60,10 @@ ae-cli update
57
60
  ae-cli update --dry-run
58
61
  ```
59
62
 
63
+ Updates use the same global Skills installation and verification as `install`. Older packages need no installer or generated manifest: their bundled Skills define the expected contents. If Skills fail after the CLI installs, the result reports partial completion and can be retried.
64
+
65
+ Automatic synchronization runs during normal commands after login; host version checks are cached for up to 24 hours. `ae-cli update --host <AE_HOST>` checks immediately. After a downgrade, future updates run the older CLI's own updater, including its historical limitations. To use the new installer logic while following an older host, run `npx @thinkingai/ae-cli@latest update --host <AE_HOST>`; the target remains the host-required version.
66
+
60
67
  `ae-cli update` installs the exact version required by the active host rather than npm `latest`. It synchronizes Skills from the installed npm package first and uses the matching GitHub tag only as a fallback.
61
68
 
62
69
  Starting with the `6.0.37` and `6.1.9` release lines, ordinary business commands can automatically upgrade or downgrade the CLI to the host-required version. After a successful synchronization, the old process exits with `AE_CLI_VERSION_SYNCED`; re-run the original command so it executes with the new CLI and Skills. Installation failures are reported without replacing the business command's JSON output.
@@ -135,15 +142,19 @@ The table covers every current root command individually. Use `ae-cli --help` fo
135
142
  | Agent platform | `kb` | Knowledge-base lifecycle, LLM Q&A, and deterministic index/grep/read retrieval |
136
143
  | Agent platform | `agent` | Agents, approvals, automations, models, MCP servers, Skills, attachments, credentials, and sandbox tools |
137
144
  | Agent platform | `context` | Read the current product-page context authorized for the active Agent Run |
138
- | Agent platform | `memory` | User memory, Top-K context writing, and actual-usage accounting |
145
+ | Agent platform | `memory` | AgentSpace memory, drafts, shared review, extraction jobs, revisions, and state transitions |
139
146
  | Agent platform | `team` | Agent Team and TeamRun execution, chat, results, and artifacts |
140
147
  | Agent platform | `system` | Root/admin management of members, sandboxes, tools, models, usage, quotas, and channels |
141
148
  | General tools | `capability` | Capability discovery, schema inspection, validation, dry-run, and generic execution |
142
149
  | General tools | `auth` | Host-scoped login, status, and multi-account management |
143
150
  | General tools | `config` | Add, switch, rename, and remove Host environments |
144
- | General tools | `sync` | Push or pull local Skills and MCPs to/from the Agent application |
145
- | General tools | `model` | Inspect and switch the current workspace model inside an Agent sandbox |
151
+ | General tools | `sync` | Push or pull local Skills and MCPs to/from the Agent application; blocked in AgentSpace context |
152
+ | General tools | `model` | Inspect and switch the current workspace model inside an Agent sandbox; blocked in AgentSpace context |
146
153
  | General tools | `update` | Synchronize CLI and Skills to the version required by the current Host |
154
+ | General tools | `install` | Install and verify CLI and matching global Skills |
155
+ | Agent platform | `workspace` | AgentSpace context, profiles, capabilities, members, activities, and lifecycle |
156
+ | Agent platform | `things` | Workspace issues, collaborators, timeline, archive, and restore |
157
+ | Agent platform | `automation` | Automation configuration, execution, history, and results |
147
158
  <!-- root-command-surface:end -->
148
159
 
149
160
  ## Capability Gateway
@@ -165,6 +176,10 @@ Use `validate` while fixing complex nested input. Use `dry-run` when you need th
165
176
 
166
177
  Gateway-backed features follow the [Capability command admission rules](docs/capability-command-admission.md). Common workflows may have curated commands; long-tail capabilities remain dynamically discoverable.
167
178
 
179
+ Event-report presentation is separate from its query definition: `analysis report create|update --presentation '{"chart_type":"bar","table_layout":"event"}'` sets the source chart/result-table layout, and `report get` returns its effective presentation. On same-model updates, omit presentation to preserve the saved chart and result-table layout. For a table card on an analysis board, use `analysis dashboard-report get|update` with exact project/dashboard/report IDs; `update --chart-type table --table-layout event --date-outside false` changes only that card, preserving the source definition and other boards. This presentation contract currently supports event reports only. See [report update](skills/ae-analysis/references/report_update.md) and [card update](skills/ae-analysis/references/dashboard_report_update.md).
180
+
181
+ Event combination charts use source `presentation.chart_type=combo` and `series` items `{metric_index:1,type:"bar",axis:"primary"}` (`type=bar|line`, `axis=primary|secondary`). Indexes are current 1-based `definition.metrics` positions; updates use the current report version, subset patches, or explicit `series: []`/`chart_type=line` resets. Board trends inherit source series, so source edits affect its other trend cards; `dashboard-report update --chart-type combo` selects existing combo, not a card-local override. Cumulative line is not combo. See [combination-chart scope and safety](skills/ae-analysis/references/event_report_presentation.md).
182
+
168
183
  `analysis user-tag create|update` supports periodic refresh in one command: pass `--auto-refresh-schedule '{"frequency":"daily","time":"02:30"}'` (also weekly/monthly), or `--auto-refresh-cron`. Use `--enable-auto-refresh false` to disable it. Scheduling-only updates do not recompute; omitted settings preserve the existing plan. See the [tag create](skills/ae-analysis/references/user_tag_create.md) and [tag update](skills/ae-analysis/references/user_tag_update.md) references.
169
184
 
170
185
  ## Authentication and Environments
@@ -275,7 +290,7 @@ ae-cli agent +list-agents
275
290
  ae-cli agent +list-models
276
291
  ae-cli agent +list-mcps
277
292
  ae-cli agent +list-skills
278
- ae-cli agent +list-automations
293
+ ae-cli automation list
279
294
  ae-cli agent +list-attachments
280
295
  ae-cli agent approval-type list
281
296
  ae-cli agent approval-request list --status pending
@@ -318,14 +333,17 @@ The npm package includes the same `skills/` directory used by the public reposit
318
333
  | `ae-community` | Community analysis and reporting |
319
334
  | `ae-data-integration` | Local CSV/JSON/Excel inspection, mapping, conversion, upload, and reusable handoff |
320
335
  | `ae-kb`, `ae-kb-discovery` | Knowledge-base lifecycle, Q&A, deterministic retrieval, and read-only knowledge-base discovery |
321
- | `ae-agent`, `ae-system`, `ae-team` | Agent resources and user memory, administration, and TeamRun workflows |
336
+ | `ae-workspace` | AgentSpace context, profiles, capabilities, members, activities, and lifecycle |
337
+ | `ae-things`, `ae-things-progress`, `ae-things-review` | Workspace issues, progress digests, and review summaries |
338
+ | `ae-automation` | Automation configuration, execution, history, and results |
339
+ | `ae-agent`, `ae-system`, `ae-team` | Agent resources, AgentSpace memory, administration, and TeamRun workflows |
322
340
  | `ae-generate-tracking-plan`, `ae-generate-tracking-code` | Tracking-plan and tracking-code generation |
323
341
  | `ae-data-integration-helper` | SDK and LogBus2 integration guidance |
324
342
 
325
343
  Reinstall all public Skills with:
326
344
 
327
345
  ```bash
328
- npx -y skills add ThinkingAIAgenticEngine/ae-cli -g -y
346
+ ae-cli install
329
347
  ```
330
348
 
331
349
  ## Development
@@ -369,6 +387,7 @@ npm run verify:readme
369
387
  npm run verify:auth-credentials
370
388
  npm run verify:update-check
371
389
  npm run verify:version-sync
390
+ npm run verify:install
372
391
  ```
373
392
 
374
393
  ## Changelog
package/README.zh.md CHANGED
@@ -15,8 +15,9 @@ CLI 的核心设计包括:
15
15
  ## 环境要求
16
16
 
17
17
  - Node.js 20 或更高版本。
18
+ - 支持 macOS、Linux 和原生 Windows(PowerShell / CMD),无需安装 WSL。
18
19
  - 安装 CLI 时能够访问 npm 仓库。
19
- - 首次安装 Skills,或本地 Skills 来源不可用时,能够访问 GitHub。
20
+ - 内置 Skills 来源不可用时,能够访问 GitHub。
20
21
 
21
22
  ## 安装
22
23
 
@@ -24,15 +25,17 @@ CLI 的核心设计包括:
24
25
 
25
26
  可直接复制给 Agent,并把 `<AE_HOST>` 替换为你的 AE 地址:
26
27
 
27
- > 请阅读 https://raw.githubusercontent.com/ThinkingAIAgenticEngine/ae-cli/main/cli-installation-guide.md 并按说明帮我安装或升级 AE CLI。我的 AE 地址是 `<AE_HOST>`。只安装 AE CLI 和配套 Skills,不要修改当前项目;遇到登录授权或需要管理员权限时请暂停并提示我。
28
+ > 请按[安装指南](./cli-installation-guide.md)中的“AI installation prompt”帮助我安装 AE CLI;全局安装 Skills,并根据最终 CLI/Skills 验证结果判断成功。
28
29
 
29
30
  安装公开版 CLI 和 Agent Skills:
30
31
 
31
32
  ```bash
32
- npm install -g @thinkingai/ae-cli
33
- npx -y skills add ThinkingAIAgenticEngine/ae-cli -g -y
33
+ npx @thinkingai/ae-cli@latest install
34
+ npx @thinkingai/ae-cli@latest install --format json
34
35
  ```
35
36
 
37
+ 安装器检查 Node.js 20+、安装并验证 CLI,再将同版本 Skills 全局安装到 `~/.agents/skills`,公共文件只写入一次,再自动向需要独立目录的客户端分发副本,无需选择 Agent;之后安装的 Codex、Cursor 也可共享这些 Skills。支持 `--dry-run`、`--format json` 和可选的 `--host <AE_HOST>`。验证成功后不显示无关的项目级客户端告警;文件缺失和 YAML 错误仍判为失败。未登录不算安装失败。详见[安装指南](./cli-installation-guide.md)。
38
+
36
39
  Skills 会帮助 Claude Code、Codex、Cursor 等编码 Agent 理解、发现并调用 `ae-cli`。
37
40
 
38
41
  按业务分类交互安装可选的已准出场景 Skill:
@@ -61,6 +64,10 @@ ae-cli update
61
64
  ae-cli update --dry-run
62
65
  ```
63
66
 
67
+ 更新与 `install` 复用全局 Skills 安装和校验。旧包无需包含安装器或生成的清单,直接以目标包内置 Skills 为准。CLI 安装后 Skills 失败会返回部分成功信息,修复后可重复执行。
68
+
69
+ 自动同步在登录后的普通命令中触发,集群版本检查最长缓存 24 小时;`ae-cli update --host <AE_HOST>` 可立即查询。降级后,后续更新由旧版 CLI 自身执行,也受旧版实现限制。需要用新安装逻辑匹配旧集群时,可运行 `npx @thinkingai/ae-cli@latest update --host <AE_HOST>`,目标仍是集群要求的版本。
70
+
64
71
  `ae-cli update` 安装当前 Host 要求的精确版本,不依赖 npm `latest`。更新时优先从已安装的 npm 包同步 Skills,本地来源失败后才回退到对应的 GitHub tag。
65
72
 
66
73
  从 `6.0.37` 和 `6.1.9` 维护线开始,普通业务命令可以自动升级或降级到环境要求的版本。同步成功后,旧进程会返回 `AE_CLI_VERSION_SYNCED`;重新执行原命令,即可使用新的 CLI 和 Skills。安装失败会给出提示,但不会用安装输出污染业务命令的 JSON 结果。
@@ -139,15 +146,19 @@ ae-cli capability list --domain analysis --jq '.data.capabilities[] | .id'
139
146
  | Agent 平台 | `kb` | 知识库生命周期、LLM 问答及确定性的 index/grep/read 检索 |
140
147
  | Agent 平台 | `agent` | Agent、审批、自动化、模型、MCP、Skills、附件、凭证和沙盒工具 |
141
148
  | Agent 平台 | `context` | 读取当前 Agent Run 已授权的产品页面上下文 |
142
- | Agent 平台 | `memory` | 用户记忆、Top-K 上下文写入和实际采用计数 |
149
+ | Agent 平台 | `memory` | AgentSpace 记忆、草稿、共享审核、提取任务、版本与状态治理 |
143
150
  | Agent 平台 | `team` | Agent Team 和 TeamRun 的执行、对话、结果及产物 |
144
151
  | Agent 平台 | `system` | root/admin 的成员、沙盒、工具、模型、用量、配额和渠道管理 |
145
152
  | 通用工具 | `capability` | 能力发现、Schema 查看、参数校验、dry-run 和通用执行 |
146
153
  | 通用工具 | `auth` | 按 Host 登录、查看状态及管理同一 Host 的多个账号 |
147
154
  | 通用工具 | `config` | 添加、切换、重命名和删除 Host 环境 |
148
- | 通用工具 | `sync` | 在本地工作区与 Agent 应用之间推送或拉取 Skills 和 MCP |
149
- | 通用工具 | `model` | 在 Agent 沙盒中查看并切换当前工作区模型 |
155
+ | 通用工具 | `sync` | 在本地工作区与 Agent 应用之间推送或拉取 Skills 和 MCP;在 AgentSpace 上下文中禁用 |
156
+ | 通用工具 | `model` | 在 Agent 沙盒中查看并切换当前工作区模型;在 AgentSpace 上下文中禁用 |
150
157
  | 通用工具 | `update` | 将 CLI 和 Skills 同步到当前 Host 要求的版本 |
158
+ | 通用工具 | `install` | 一键安装、验证 CLI 和同版本全局 Skills |
159
+ | Agent 平台 | `workspace` | AgentSpace 上下文、资料、能力、成员、动态与生命周期 |
160
+ | Agent 平台 | `things` | 工作空间事项、协作成员、时间线、归档与恢复 |
161
+ | Agent 平台 | `automation` | 自动化配置、执行、历史和结果 |
151
162
  <!-- root-command-surface:end -->
152
163
 
153
164
  ## Capability Gateway
@@ -169,6 +180,10 @@ ae-cli capability run analysis.report.list --input input.json
169
180
 
170
181
  Gateway 命令遵循 [Capability 命令收录规则](docs/capability-command-admission.md)。常见工作流可以提供精选命令,长尾能力则保持动态发现。
171
182
 
183
+ 事件报表的展示配置与查询定义分开:`analysis report create|update --presentation '{"chart_type":"bar","table_layout":"event"}'` 设置原报表图形及结果表布局,`report get` 返回实际生效的展示配置。同模型更新时省略 presentation 可保留原有图形和结果表布局。看板表格卡片使用 `analysis dashboard-report get|update`,明确项目、看板和报表 ID;`update --chart-type table --table-layout event --date-outside false` 只改变该卡片,保留原报表定义及其他看板。本次展示配置契约仅支持事件报表。详见[报表更新](skills/ae-analysis/references/report_update.md)和[卡片更新](skills/ae-analysis/references/dashboard_report_update.md)。
184
+
185
+ 事件组合图使用原报表 `presentation.chart_type=combo` 和 `series` 项 `{metric_index:1,type:"bar",axis:"primary"}`(`type=bar|line`,`axis=primary|secondary`)。索引是当前 `definition.metrics` 从 1 开始的位置;更新使用当前报表版本,支持部分指标补丁及显式 `series: []` / `chart_type=line` 重置。看板趋势图继承原报表系列,修改源系列会影响该报表的其他趋势卡片;`dashboard-report update --chart-type combo` 选择已有组合图,不提供卡片独立覆盖。累计折线不等于组合图。详见[组合图作用域与安全规则](skills/ae-analysis/references/event_report_presentation.md)。
186
+
172
187
  `analysis user-tag create|update` 支持一次配置自动更新:传入 `--auto-refresh-schedule '{"frequency":"daily","time":"02:30"}'`(也支持每周、每月),或使用 `--auto-refresh-cron`。用 `--enable-auto-refresh false` 关闭自动更新。仅修改调度计划不触发即时重算;省略调度参数则保留原计划。详见[创建标签](skills/ae-analysis/references/user_tag_create.md)和[更新标签](skills/ae-analysis/references/user_tag_update.md)。
173
188
 
174
189
  ## 认证与多环境
@@ -279,7 +294,7 @@ ae-cli agent +list-agents
279
294
  ae-cli agent +list-models
280
295
  ae-cli agent +list-mcps
281
296
  ae-cli agent +list-skills
282
- ae-cli agent +list-automations
297
+ ae-cli automation list
283
298
  ae-cli agent +list-attachments
284
299
  ae-cli agent approval-type list
285
300
  ae-cli agent approval-request list --status pending
@@ -329,7 +344,7 @@ npm 包内包含与公开仓库一致的 `skills/` 目录:
329
344
  重新安装全部公开 Skills:
330
345
 
331
346
  ```bash
332
- npx -y skills add ThinkingAIAgenticEngine/ae-cli -g -y
347
+ ae-cli install
333
348
  ```
334
349
 
335
350
  ## 开发
@@ -373,6 +388,7 @@ npm run verify:readme
373
388
  npm run verify:auth-credentials
374
389
  npm run verify:update-check
375
390
  npm run verify:version-sync
391
+ npm run verify:install
376
392
  ```
377
393
 
378
394
  ## 更新日志
package/bin/ae-cli.js CHANGED
@@ -1,2 +1,7 @@
1
1
  #!/usr/bin/env node
2
- import '../dist/index.js';
2
+ if (Number(process.versions.node.split('.')[0]) < 20) {
3
+ console.error('AE CLI requires Node.js 20 or later. Select a supported Node.js runtime and rerun.');
4
+ process.exitCode = 1;
5
+ } else {
6
+ await import('../dist/index.js');
7
+ }
@@ -0,0 +1,91 @@
1
+ # AE CLI Installation Guide
2
+
3
+ Use the same one-command installer from a terminal or an AI Agent:
4
+
5
+ ```bash
6
+ npx @thinkingai/ae-cli@latest install
7
+ ```
8
+
9
+ No Agent selection is required. Optional usage:
10
+
11
+ ```bash
12
+ npx @thinkingai/ae-cli@latest install --format json
13
+ npx @thinkingai/ae-cli@latest install --host <AE_HOST>
14
+ npx @thinkingai/ae-cli@latest install --dry-run
15
+ ```
16
+
17
+ ## Requirements and global Skills
18
+
19
+ Node.js 20 or later, npm, and npx must be available. The installer does not change the default Node version, use sudo, or modify project dependencies. macOS, Linux, and native Windows are supported. On Windows, use PowerShell or Command Prompt; WSL is optional. Global Skills are installed under the current user's home directory on each platform.
20
+
21
+ The running package determines the exact CLI version to install. The global executable is verified with `ae-cli --version`; PATH problems include the verified absolute path. Local npm links are protected by a small guard. Other installation conflicts use normal npm errors; the installer does not migrate existing installations.
22
+
23
+ Skills are installed globally in `~/.agents/skills`. The shared files are installed once, then the Skills tool automatically distributes copies to detected clients that require their own directory. Shared-directory targets are skipped during distribution. Existing per-Skill links are replaced with copies when needed. Codex and Cursor support this shared directory, so installing Cursor later does not require a separate copy of the Skills. A client that only reads its own directory may need the same install command run again after that client is installed. User-global installation does not promise availability in remote/cloud clients or for every future client.
24
+
25
+ The external tool is pinned to `skills@1.5.12` to preserve Node 20 support and skip copying a Skill onto its own source directory. The installer does not maintain its own Agent catalog, ask users to select clients, or select clients based on the invoking AI. Unrelated user Skills are retained.
26
+
27
+ ## Verification and output
28
+
29
+ The installed CLI package's `skills/` directory defines the expected Skills and contents at runtime, including for historical packages without an installer or generated manifest. A failed shared-directory installation can retry the exact release tag `ThinkingAIAgenticEngine/ae-cli#v<CLI_VERSION>`; it never falls back to the default branch. Missing or invalid bundled Skills are reported rather than guessing the expected set from another version. Client distribution failures do not trigger a source download retry. If the local source and fallback both fail, the top-level error retains the first cause, and `skills.attempts` records both attempts with their stage, source, cause, and failures.
30
+
31
+ Verification parses YAML/frontmatter and compares expected files in the shared global directory with the target package. Merely finding a directory, an `ae-*` name, or an exit code of zero is insufficient. Failures reported by the pinned tool for supported clients are also treated as failures, even when shared files exist.
32
+
33
+ - Complete verification: `ok: true`.
34
+ - Partial installation: `ok: false`, preserving the CLI result and listing failed Skills and reasons.
35
+ - Unrelated PromptScript/Eve project-only diagnostics and their failure summary are handled internally and not displayed as user warnings after verification succeeds.
36
+ - YAML errors, missing or stale files, supported-client installation errors, CLI version mismatch, and unsuccessful processes remain failures.
37
+
38
+ `--format json` emits one report on stdout. Progress goes to stderr; raw subprocess logs are not forwarded. Reports include `ok`, `dry_run`, `cli.package/version/path/verified`, `skills.directory/expected_count/installed_count/missing/source/version/failures/attempts`, `auth.host/authenticated`, and `next_steps`. Counts refer to unique Skills in the global directory. Use `--format table` for a human summary. Dry runs make no subprocess calls or installation/configuration writes.
39
+
40
+ ## Host and login
41
+
42
+ `--host` is optional. It delegates status checks to the existing auth command; it does not independently save credentials or change the active host. Being logged out does not make a verified installation fail.
43
+
44
+ ```bash
45
+ ae-cli auth login --host <AE_HOST> --no-wait
46
+ ```
47
+
48
+ Show the returned `verification_url` to the user. After browser authorization:
49
+
50
+ ```bash
51
+ ae-cli auth login --host <AE_HOST> --device-code <DEVICE_CODE>
52
+ ae-cli auth status --host <AE_HOST>
53
+ ```
54
+
55
+ Never print, copy, or manually save any token.
56
+
57
+ ## Host-compatible upgrades and downgrades
58
+
59
+ ```bash
60
+ ae-cli update --host <AE_HOST>
61
+ ae-cli update --target 6.0.40 --dry-run
62
+ ```
63
+
64
+ The target is the exact `aeCliVersion` returned by the host, not npm latest or the cluster's general product version. CLI and Skills follow that target together. Existing automatic synchronization eligibility, locking, retry limits, and pending-Skills recovery are retained. Automatic changes apply only to the public distribution, after login and during normal commands; help, version, auth, config, install, update, CI, and configured sandbox/skip modes do not initiate automatic synchronization.
65
+
66
+ Host checks are cached for up to 24 hours. A cluster upgrade is discovered on a later eligible command after refresh, not by a background updater. Explicit `ae-cli update --host <AE_HOST>` queries immediately. A successful automatic switch asks the caller to rerun the original command.
67
+
68
+ For example, a CLI with this installer can switch from 6.0.50 to an older 6.0.40 package using that package's bundled Skills. After the switch, the installed 6.0.40 CLI runs future updates with its own historical code; new validation and diagnostic handling do not survive the downgrade. The published 6.0.40 already has automatic upgrade/downgrade support, but invokes an unpinned Skills tool and does not perform this installer's complete verification. Successful version selection does not guarantee historical Skills tooling will work in every Node/network environment.
69
+
70
+ To use the newer installer while still respecting the current host version, including to repair an older updater's failed Skills step:
71
+
72
+ ```bash
73
+ npx @thinkingai/ae-cli@latest update --host <AE_HOST>
74
+ ```
75
+
76
+ The newer command orchestrates the work; the installed target remains the host-required version. Required package versions and fallback tags must be published and accessible. Global CLI installation follows one target at a time; switching between differently versioned hosts can switch that installation again.
77
+
78
+ ## Advanced manual troubleshooting
79
+
80
+ Prefer the unified installer. For a specific client or source diagnosis, advanced users can still invoke the external Skills tool directly:
81
+
82
+ ```bash
83
+ npx -y skills@1.5.12 add <INSTALLED_CLI_SKILLS_PATH> -g -y --agent codex
84
+ npx -y skills@1.5.12 list -g --json
85
+ ```
86
+
87
+ Raw manual-tool output is not the AE installer's final result. Do not infer completeness from the list alone, delete unrelated Skills, or overwrite a source link to resolve a conflict.
88
+
89
+ ## AI installation prompt
90
+
91
+ > Install AE CLI and its matching Skills globally. Check Node.js 20+, npm, and npx without changing my default Node version. Run `npx @thinkingai/ae-cli@latest install --format json`, adding `--host <AE_HOST>` only if I supplied a host. No Agent selection is needed. Judge success by the installer's final `ok`, CLI verification, and global Skills verification. The installer handles unrelated project-only client diagnostics internally. If installation fails, report the named Skills and reasons; do not hide YAML errors, missing files, or actual installation failures. Do not modify project files, delete unrelated Skills, use sudo, overwrite an npm source link, or print/copy/save tokens. After successful installation, guide me through device-code login if needed and wait for browser authorization. Then use `ae-cli update --host <AE_HOST>` to match the environment. If an older CLI cannot finish its update, use `npx @thinkingai/ae-cli@latest update --host <AE_HOST>` to retain exact host-version selection. Report the installed version, global Skills directory, verified Skill count, and authentication status.
@@ -7,17 +7,15 @@ import {
7
7
  missingAeHostGuidance,
8
8
  missingAeHostHint
9
9
  } from "./chunk-6ZIQV5GW.js";
10
- import {
11
- getLocalCliPackageInfo
12
- } from "./chunk-E2JKXMVO.js";
13
10
  import {
14
11
  resolveHost
15
- } from "./chunk-N4BLPJC7.js";
12
+ } from "./chunk-7QXISROD.js";
16
13
  import {
14
+ getLocalCliPackageInfo,
17
15
  printError,
18
16
  printOutput,
19
17
  runHostCompatCheck
20
- } from "./chunk-BW7JUDEI.js";
18
+ } from "./chunk-KFNMQTZI.js";
21
19
  import {
22
20
  CliTokenValidationUnavailableError,
23
21
  CredentialStoreUnreadableError,
@@ -33,17 +31,17 @@ import {
33
31
  saveCredential,
34
32
  updateCredentialMetadata,
35
33
  validateCliTokenOnServer
36
- } from "./chunk-DU72X2IO.js";
34
+ } from "./chunk-GIK6EDUG.js";
37
35
  import {
38
36
  getFallbackCliToken,
39
37
  loadConfig,
40
38
  normalizeUrl,
41
39
  saveConfig
42
- } from "./chunk-IG3DYEIR.js";
40
+ } from "./chunk-UQ77JXYH.js";
43
41
  import {
44
42
  PermissionError,
45
43
  logger
46
- } from "./chunk-YVGXGTD6.js";
44
+ } from "./chunk-WNGFSIOB.js";
47
45
 
48
46
  // src/core/device-auth.ts
49
47
  import { execFileSync } from "child_process";