# @xenosystem/agent-cli 中文文档 规范地址：https://npmcn.com/package/%40xenosystem/agent-cli/ 版本：0\.5\.173 npm 元数据更新时间：2026-11-02T21:46:27.364Z 中文译文更新时间：2026-11-02T22:46:22.454Z 软件包许可：UNLICENSED 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40xenosystem/agent-cli 原文对照：https://npmcn.com/package/%40xenosystem/agent-cli/?lang=original 项目主页：https://xenostudio.ai/ 源码仓库：https://github.com/XENO-CORPORATION/xeno-agent-cli ## 关键信息（来自 npm 元数据） - 包体积（解压后）：17.2 MB，897 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22 - 运行依赖：10 个 - 首次发布：2026-07-27T08:49:09.782Z - 最新版本发布：2026-11-02T21:46:27.159Z - 已发布版本数：149（近 12 个月 149 个） ## 中文简介 用于跨存储库、终端和模型后端的持续软件工程的自主开发人员代理CLI ## 安装 ```sh npm install @xenosystem/agent-cli ``` 也可以使用：`pnpm add @xenosystem/agent-cli`、`yarn add @xenosystem/agent-cli`、`bun add @xenosystem/agent-cli` ## README # XENO Agent命令行 XENO公司生产终端AI代理CLI。 ## 运行时所有权 当前的所有权水平是发布审计的，可能低于终端P2计划目标。Node通过P2是一个外部主机，自包含的发布资产嵌入Node.js或Bun， TypeScript/npm开发工具链仍然是第三方基础设施。运行时和工具链替换不是路线图项。软件包不能被描述为完全私有的、完全xeno所有的、不含第三方运行时代码的，或者由自有工具链构建的。 打包政策和工程洁净室控制被采用了 `ownership/`. 执行安全性使用精确的级别 `policy-only`， `process-hardened`, `contained`。Windows进程加固是深入的可信工作空间防御，并不隔离文件系统读取或网络访问。包含不可用或不受信任的执行失败关闭。SDK/CLI版本审查、摘要了MXC 0.7.0原生资产，没有使用Microsoft JavaScript包装器或运行时传递。独立候选程序仅嵌入其目标本机适配器，并且需要一个可执行绑定的签名侧车，然后才能报告经过认证的包含。 认证档案还携带相应的第三方通知，并参与一个源绑定的五个目标候选集。看到 [CLI执行安全性](https://npmcn.com/package/docs/SECURITY_BOUNDARIES.md). ## 安装 ```bash curl -fsSL https://unpkg.com/@xenosystem/agent-cli@latest/scripts/install.sh | sh ``` PowerShell: ```powershell irm https://unpkg.com/@xenosystem/agent-cli@latest/scripts/install.ps1 | iex ``` 或直接安装： ```bash npm install -g @xenosystem/agent-cli ``` ## 使用 键绑定是版本化的、用户拥有的、冲突验证的，并在TUI和附加终端之间共享。运行 `xeno keybindings list`， `xeno keybindings validate`，或者 `/keybindings`； 完整的合同文件载于 [. . / . . / docs / KEYBINDINGS.md](https://npmcn.com/package/docs/KEYBINDINGS.md). 运行时检查器解释CLI在不激活扩展或暴露凭证的情况下将加载和允许的所有内容。运行 `xeno environment`， `xeno environment --safe-mode`， `xeno environment --json`，或者 `/environment`;看到 [. . / . . / docs / RUNTIME\_ENVIRONMENT\_INSPECTOR.md](https://npmcn.com/package/docs/RUNTIME_ENVIRONMENT_INSPECTOR.md). ```bash xeno chat xeno run "summarize this repo" xeno app-server --http xeno remote validate --json xeno specs init my-feature --title "My feature" xeno review --production --staged xeno index build xeno control-room watch xeno share list xeno providers catalog xeno hosted environment list xeno hosted trigger list xeno hosted events workspace: xeno hosted run message "Continue after verification" xeno hosted run controls xeno hosted run artifacts xeno hosted handoff pull --out .xeno/handoffs/hosted-to-cli.json xeno oracle "Should this change ship?" --primary primary --critics critic-a,critic-b xeno librarian "Where is auth enforced?" --repo owner/project --connection research xeno forge issues --repo owner/project xeno recipes run release-check --dry-run xeno plugin suggest --marketplace ``` 助手是默认的运行时配置文件。使用 `xeno --agent swe`， `xeno run --agent reviewer ""`， `xeno agents profiles`，或者 `xeno agents profile devops` 挑选或检查可强制执行的专家 概要文件。看到 [代理资料](https://npmcn.com/package/docs/AGENT_PROFILES.md). 持久规范在共享工件协议下存储需求、设计、任务依赖性、风险、验收标准、批准、执行证据和漂移报告。生产评审运行独立的专家和验证者电话，并保留打印的评审报告；没有复制的模型置信度仍然没有得到明确的验证。看到 [规范工作流程](https://npmcn.com/package/docs/SPEC_WORKFLOWS.md) 和 [生产审核](https://npmcn.com/package/docs/PRODUCTION_REVIEW.md). 持久存储库智能结合了有界的源块、符号、导入、词法搜索、可选的精确模型语义向量、Git来源、测试、文档链接和新鲜度证据，同时保持当前直接读取的权威性。Agent Control Room将持久代理、任务、审批、工件、监视器、目标、通知、使用和公共活动投射到绑定哈希的终端管理器中。看到 [库情报](https://npmcn.com/package/docs/REPOSITORY_INTELLIGENCE.md) 和 [座席控制室](https://npmcn.com/package/docs/AGENT_CONTROL_ROOM.md). 安全共享具有签名、编校、到期、能力限制和只读。会话切换请求权限，但不能授予权限，而提供者连接仅存储凭据引用名称并使用功能驱动的路由。看到 [安全共享和会话切换](https://npmcn.com/package/docs/SECURE_SHARING_HANDOFF.md) 和 [提供新员工培训](https://npmcn.com/package/docs/PROVIDER_ONBOARDING.md). 托管环境绑定精确的清单校验和和OCI摘要；触发器是幂等的，事件重播是经过哈希链验证的。协议-v2适配器添加持久的编校消息、精确范围的批准/拒绝、确认历史、工件协议证据和键入的Git/PR结果。 `xeno hosted handoff push` 远程继续本地工作，并且 `xeno hosted handoff pull` 在保存私有返回文档之前验证连接的服务颁发者。除非后端具有经过候选认证的适配器，否则托管执行将失败关闭。看到 [托管舰队和跨设备切换](https://npmcn.com/package/docs/HOSTED_FLEET.md). Oracle, Librarian， Forge浏览，Recipes，自动Git突变检查点， 剪贴板图像粘贴，操作系统自带的语音听写，插件签名/锁定，和 支持存储库的插件建议文档为 [高级代理表面](https://npmcn.com/package/docs/ADVANCED_AGENT_SURFACES.md)。这些特性 保留他们的工件协议、提供者、隐私和发布边界；无 源代码完整的托管适配器意味着部署了一个公共舰队。 交互式提示软封装并增长到六行终端，同时保留完全提交的文本。 `Up` 和 `Down` 在提示历史记录之前导航包装行，文件面板助手共享相同的石墨烯安全游标和编辑行为。临时 `XENO_INPUT_SOFT_WRAP=0` 进程设置为回滚恢复单行水平视图。 Markdown源标签在受支持的交互式终端中是可点击的，并在重定向输出中保留其完整的可见URL `XENO_DISABLE_TERMINAL_LINKS=1` 是集。 后台子会话在完成、失败、停止或需要输入时自动通知父会话。无头运行使用相同的有界队列； `XENO_AGENT_NOTIFICATIONS=0` 禁用自动传递而不删除排队记录。 前台模型编写的Bash命令是管理操作：Ctrl+B促进相同的进程，页脚显示实时操作活动，有界的TaskOutput等待不消耗模型轮数，等待完成从持久检查点恢复一次。使用 `/processes` 检查、附加、停止或显式地分离任务。 文档: [https://xenostudio.ai](https://xenostudio.ai/) ## 常见问题 ### @xenosystem/agent-cli 是什么？ 用于跨存储库、终端和模型后端的持续软件工程的自主开发人员代理CLI ### 如何安装 @xenosystem/agent-cli？ 在项目目录运行 npm install @xenosystem/agent-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 xeno、xeno-code、xeno-agent，可以用 npx xeno 直接运行。 ### @xenosystem/agent-cli 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/xenosystem\_\_agent-cli 是否存在。 ### @xenosystem/agent-cli 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @xenosystem/agent-cli 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @xenosystem/agent-cli 可以商用吗？ @xenosystem/agent-cli 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。 ### @xenosystem/agent-cli 还在维护吗？ 最新版本 0\.5\.173 发布于 2026/11/03（今天）；至今共发布 149 个版本，其中过去 12 个月发布了 149 个；首次发布于 2026/07/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。