@cloudhal/agent-runtime

中文文档

0.6.5发布于 2026/11/09Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 4509

Cloudhal代理运行时间:政策引擎(演员、范围、批准)、技能装载器、审计日志

@ cloudhal/ 代理运行时间

何以管理代理人——这里没有MCP SDK(ADR-0011).

PolicyEngine —— 说 evaluate(principal, tool, { confirmed }) → allow | deny | approval-required。对照工具的范围检查校长的范围,将调用限制于校长所申报的技能的范围,并要求批准标记的工具 requiresApproval附加说明 destructiveHint,或者在技能中列出 cloudhal.approval。。。 . defaultScopes(actor): 人类/系统获得 *;代理获得读取,内容写取,预览和上传,从不发布或回滚(确切列表在函数中).
loadSkill(dir) 编号 : loadSkills(root) - SKILL.md 前置物品经验证与 skill-manifest 合同; 平面 Cloudhal 数据 metadata 键cloudhal.schemaVersion, (中文(简体) ), cloudhal.requiresCapabilities, (中文(简体) ), cloudhal.scopes, (中文(简体) ), cloudhal.approval) (中文(简体) ). 机构和 references/*.md 改为懒惰(逐步披露).
AuditLog — 只附则 audit 表格(移徙) 0003_agent:谁(演员),什么(工具,投入),决定+理由,技能,结果,快照标识,持续时间.

范围 (单位:千美元)src/policy.ts, RFC-0005 §1)是引擎, REST, MCP 和 Studio 使用的单列表 :

KEY_SCOPES 代理密钥可以携带什么(网站、内容、预览、发布、回滚、资产、分析、评论、时间表和发布,若干有 :own 限于自己节点的变体;
PERSON_SCOPES 仅由人们通过作用持有,从未被存储在钥匙上(成员、设置、代理、审计、评论者数据、自动化、编辑中AI);
* -每个瞄准镜. implies(a, b) 沿着花纹走content:write → content:write:own → content:draft:own → content:propose, (中文(简体) ), site:publish → releases:publish(中文(简体) ).

作用 (单位:千美元)src/roles.ts, RFC-0005 §2, ADR-0018): (中文(简体) ) ROLES (Owner > 管理员 > 编辑 > 作者 > 撰稿人)和 ROLE_SCOPES 将每个角色映射到范围;一个键从未超过其创建者的角色(narrow),以及 modeCap 限制其模式( e)edits 为贡献者, auto (否则).

版本与发布记录

@cloudhal/agent-runtime 共发布 26 个版本，首次发布于 2026/10/20；过去 12 个月发布了 26 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本	发布日期	距今
`0.6.5`latest	2026/11/09	1 天前
`0.6.4`	2026/11/08	1 天前
`0.6.3`	2026/11/08	1 天前
`0.6.2`	2026/10/26	14 天前
`0.6.1`	2026/10/24	17 天前
`0.6.0`	2026/10/23	17 天前

关于 @cloudhal/agent-runtime 的常见问题

@cloudhal/agent-runtime 是什么？

Cloudhal代理运行时间:政策引擎(演员、范围、批准)、技能装载器、审计日志

如何安装 @cloudhal/agent-runtime？

在项目目录运行 npm install @cloudhal/agent-runtime，或使用 pnpm add / yarn add / bun add。

@cloudhal/agent-runtime 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@cloudhal/agent-runtime 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@cloudhal/agent-runtime 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@cloudhal/agent-runtime 可以商用吗？

@cloudhal/agent-runtime 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

@cloudhal/agent-runtime 的下载量有多少？

根据 npm 官方下载统计，@cloudhal/agent-runtime 在 2026/10/10 – 2026/11/08 这 30 天内被下载 4,509 次，日均约 150 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@cloudhal/agent-runtime 还在维护吗？

最新版本 0.6.5 发布于 2026/11/09（1 天前）；至今共发布 26 个版本，其中过去 12 个月发布了 26 个；首次发布于 2026/10/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。