# @agentic-workspace/workspace-cli 中文文档

规范地址：https://npmcn.com/package/%40agentic-workspace/workspace-cli/

版本：1\.19\.1
npm 元数据更新时间：2026-11-06T20:03:57.501Z
中文译文更新时间：2026-11-06T23:10:55.512Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentic-workspace/workspace-cli
原文对照：https://npmcn.com/package/%40agentic-workspace/workspace-cli/?lang=original
项目主页：https://github.com/rickardvh/agentic-workspace
源码仓库：https://github.com/rickardvh/agentic-workspace

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：132 MB，26 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-09-17T19:05:33.471Z
- 最新版本发布：2026-11-06T20:03:57.124Z
- 近 30 天下载量：2187（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 40 个）

## 中文简介

对编码剂的持续操作上下文和动态控制.

## 安装

```sh
npm install @agentic-workspace/workspace-cli
```

也可以使用：`pnpm add @agentic-workspace/workspace-cli`、`yarn add @agentic-workspace/workspace-cli`、`bun add @agentic-workspace/workspace-cli`

## README

# 代理工作空间

[![PyPI](https://img.shields.io/pypi/v/agentic-workspace)](https://pypi.org/project/agentic-workspace/) [![npm](https://img.shields.io/npm/v/%40agentic-workspace%2Fworkspace-cli)](https://www.npmjs.com/package/@agentic-workspace/workspace-cli) [![crates.io](https://img.shields.io/crates/v/agentic-workspace-cli)](https://crates.io/crates/agentic-workspace-cli)

**持久、与任务相关的编码剂项目背景.**

代理工作空间(Agentic Workspace (AW))是一个开源开发器工具,您会添加到一个 Git 寄存器中,以便在会话中给编码代理持续,任务相关的项目上下文.

AW为寻找项目指导、节省未完成的工作和经验教训以及检查先前的核查是否仍然适用提供了技能和指挥线工具.

保留您现有的编码代理,编辑器,源树,测试和审查过程. 您的项目可以使用任何编程语言或框架.

[开始吧](https://github.com/rickardvh/agentic-workspace#get-started) • 妇女 [自定义寄存器行为](https://github.com/rickardvh/agentic-workspace/blob/master/docs/customization.md) • 妇女 [每天使用量](https://github.com/rickardvh/agentic-workspace/blob/master/docs/everyday-use.md) • 妇女 [文档](https://github.com/rickardvh/agentic-workspace/blob/master/docs/index.md) • 妇女 [释放](https://github.com/rickardvh/agentic-workspace/releases)

## 为什么是AW?

**关于存储器的知识属于存储器.** 有用的项目知识应当活过会话变化、开发者或代理提供者,而不是被困在私人对话中.

**并非所有关于存放处的事都是相关的.** 装入所有累积的引导并状态到每个会话中,用上下文超载取代了再发现.

范围说明和点名技能是有用的基础。 指令设定了规则;技能解释可重复使用的程序. 无论是越长的指令文件还是不断增长的技能目录本身,都无法跟踪一项任务在何处停止,或早期的证据是否仍然适用.

联盟利用已保存的任务记录、经验教训和核查证据以及阅读和更新工具。 目的是减少完成和维持工作的费用:

| 团队福利 | AW如何帮助 |
| --- | --- |
| 减少重复调查 | 找到相关规则、来源和可重复使用的程序,而无需装入无关的指南. |
| 费用低廉的继续和交割 | 保留意向、接受进展和所余工作;给予接收代理人相关的制约和预期结果. |
| 重复解释减少 | 将项目更正作为范围说明和有用的经验教训作为以后工作的建议. |
| 重点更突出的核查 | 寻找相关的检查程序,在仍然适用时再利用证据,并查明哪些尚未核实. |
| 减少对一个代理供应商的依赖 | 将共享的项目背景保存在寄存器中,而不是一个提供者的对话历史. |

**小任务还是小任务.** 一种打字法不需要规划、记忆、核查、授权或另一种外科术,仅仅因为有这些能力.

## 如何运作

一个小条目 `AGENTS.md` 指向仓库 `workspace-startup` 技术。 它教代理人何时读取项目源,装入专门程序或查询AW的工具.

Rust支持的运行时间读取可适用的规则并保存记录,报告相关要求和可用的操作,并在支持更新之前检查当前来源和权限. 该代理人仍然作出执行决定并使用其普通发展工具.

```text
Find the relevant context → Do the work → Update what matters
```

源代码、文件、测试和决定留在他们现有的家中。 AW指向这些来源的代理人,并同时保存有用的工作环境,而不是将存储器或对话复制到第二个知识系统.

[每天的例子](https://github.com/rickardvh/agentic-workspace/blob/master/docs/everyday-use.md) • 妇女 [产品模型](https://github.com/rickardvh/agentic-workspace/blob/master/docs/package/overview.md) • 妇女 [建筑](https://github.com/rickardvh/agentic-workspace/blob/master/docs/architecture.md)

## 信任和支持

**AW不是一个沙盒.** Repository-conconfigured command 运行与呼叫者的文件系统访问和证书. 在允许寄存器执行前审查寄存器及其可以运行的命令. 证书属于代理主机或环境的证书设施,而不是入帐的AW文件.

AW的控制操作和检查支持并不能取代人的判断,独立审查,或现有的安全控制.

精确的软件包身份,安装命令,运行时间版本,操作系统支持,以及预放/稳定状态与所选的放行同步直播,生成了引用,而不是被复制到本登陆页.

[安装和设置](https://github.com/rickardvh/agentic-workspace/blob/master/docs/agentic-workspace-install.md) • 妇女 [威胁模式](https://github.com/rickardvh/agentic-workspace/blob/master/docs/security/threat-model.md) • 妇女 [证据和支助](https://github.com/rickardvh/agentic-workspace/blob/master/docs/evidence-and-support.md)

## 开始吧

使用一个 **Git 工作树** 和一个能够读取寄存器指令并运行命令的代理。 机器必须能够运行一个支持的AW分布;您的项目语言和构建系统不需要与之相匹配.

1.  通过 npm, Python/uv, Cargo 或单独放出,每个寄存器或作为共享工具安装 AW. 独立的二进制不需要语言工具链. 见 [正在获取指南](https://github.com/rickardvh/agentic-workspace/blob/master/docs/agentic-workspace-install.md) 用于平台要求和安装命令.
2.  从 Git 工作树根,跑 `agentic-workspace setup` 使用该安装并授权拟议的集成。 用于存储器本地 npm 安装, 使用 `npm exec --no -- agentic-workspace setup`。 。 。 .
3.  给您的代理人一个普通的任务, 例如纠正文档错误 .

安装提供运行时间;安装后添加 `.agentic-workspace/` 目录和一个小 `AGENTS.md` 指针. 对共享的整合文件进行审查并做出承诺,只留下被忽略的地方州. 项目规则和检查程序仍需要界定;设置并不推断.

## 你的仓库,你的规矩

AW的设计是为了适应项目周围,而不是重组.

使用 AW 的简化寄存器看起来像:

```text
your-repository/
├── AGENTS.md              # Small AW-managed entry point inside your project file
├── src/, docs/, tests/    # Existing project contents
└── .agentic-workspace/    # AW integration plus optional saved component state
```

AW设置故意只添加了一小组文件. 软件包管理技能和设置元数据与您的项目配置,组件记录,机器本地数据以及任何输出都保持相隔.

您可以用普通语言表达整个仓库的校正 :

> 将这个寄存器改为API合同,然后更改公共响应字段.

或使范围明确地方:

> 仅在此机上,在引用AW时使用此可执行路径.

代理可以保存合适的指令或配置文件中的更改并验证其是否被保留. 聊天中的承诺不是一条被保存的规则,本地偏好不应该默默地成为共享寄存器政策.

可重复使用的方法属于技能。 具有约束力的规则属于指令或配置。 目前的工作和证据都与维持它们的组成部分有关.

设置、 刷新和删除使用相同的声明文件集 。 删除 AW 仅删除 AW 能验证其拥有的集成文件,保存项目配置并保存组件记录,仅因其坐落在 AW 路径下而拒绝去除已编辑或无关的内容.

[配置参考](https://github.com/rickardvh/agentic-workspace/blob/master/docs/reference/workspace-config.md) • 妇女 [仓库文件](https://github.com/rickardvh/agentic-workspace/blob/master/docs/reference/installed-surface-catalogue.md)

## 在其帮助的地方添加结构

AW包括经常性协调费用的可选第一当事方能力:

**规划** 保留未完成的工作:预期成果、制约因素、进展、阻碍因素和下一步行动.

**内存** 保留有益的观察和经验教训,否则将花费昂贵来重新发现。 咨询在依赖关系发生变化时可以重新考虑;说明不是自动的政策.

**核查** 使检查程序、证据和已知漏洞可以重复使用。 通过支票证明它实际上检验了索赔,而不是关于已完成工作的所有索赔.

这些是可选的组成部分,而不是强制性的工作流程阶段。 存储器可以使用偿还其成本的东西,并将无关的能力从当前任务的背景中去掉.

特定仓库的规则和程序不需要新的模块。 模块用于具有自己责任的独特能力,包括只读事实;保存状态是可选的.

[模块和分机](https://github.com/rickardvh/agentic-workspace/blob/master/docs/package/modules.md)

## 与代理人合作而不是替换他们

代理工作空间不是一个自主的编码代理. 它使已经在寄存器内工作的代理商有更好的项目背景,并控制了读取或更新AW管理的信息的方法.

一个具有运行时间访问权限的代理可以查询AW组件维护的当前记录并使用所支持的操作. 唯寄存器审查员可以遵循相同的起动技巧并生成读取配置,以恢复所记录的目标,限制,进展,以及建议,而活机状态,当前测试结果,更改的许可仍然未知.

产品的共同行为 生活在一个Rust核心。 原生,Python,TypeScript,和JSON接口都称同一种执行,而不是定义单独的工作流程行为. 主办项目的执行语言不需要与AW的运行时间执行相匹配.

东道方的一体化仍然不同。 提供商的独立性并不意味着每个代理主机都以相同的方式发现技能,或者每个模型都完全遵循寄存器指南;目前的支持和证据仍然是发布和环境约束的.

[证据和支持](https://github.com/rickardvh/agentic-workspace/blob/master/docs/evidence-and-support.md)

## 学多点

**使用 AW :** [安装和收养](https://github.com/rickardvh/agentic-workspace/blob/master/docs/agentic-workspace-install.md) • 妇女 [每天使用量](https://github.com/rickardvh/agentic-workspace/blob/master/docs/everyday-use.md) • 妇女 [配置](https://github.com/rickardvh/agentic-workspace/blob/master/docs/reference/workspace-config.md)

**理解 AW :** [产品概览](https://github.com/rickardvh/agentic-workspace/blob/master/docs/package/overview.md) • 妇女 [建筑](https://github.com/rickardvh/agentic-workspace/blob/master/docs/architecture.md) • 妇女 [设计原则](https://github.com/rickardvh/agentic-workspace/blob/master/docs/design-principles.md) • 妇女 [模块](https://github.com/rickardvh/agentic-workspace/blob/master/docs/package/modules.md)

**查找细节 :** [CLI 参考](https://github.com/rickardvh/agentic-workspace/blob/master/docs/reference/cli-catalogue.md) • 妇女 [安装了表面](https://github.com/rickardvh/agentic-workspace/blob/master/docs/reference/installed-surface-catalogue.md) • 妇女 [完整文档](https://github.com/rickardvh/agentic-workspace/blob/master/docs/index.md)

## 捐款

对于 Agentic 工作空间本身的更改,请从 [投稿游戏本](https://github.com/rickardvh/agentic-workspace/blob/master/docs/maintainer/contributor-playbook.md)。使用存储器 [问题模板](https://github.com/rickardvh/agentic-workspace/issues/new/choose) 报告问题或提出修改.

捐款应使有益的工作更容易完成、继续或核查,同时保持不必要的背景、框架地表和储存地的残留量较低.

## 许可证

[麻省理工学院](https://github.com/rickardvh/agentic-workspace/blob/master/LICENSE)。 。 。 .

## 常见问题

### @agentic-workspace/workspace-cli 是什么？

对编码剂的持续操作上下文和动态控制\.

### 如何安装 @agentic-workspace/workspace-cli？

在项目目录运行 npm install @agentic-workspace/workspace-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentic-workspace，可以用 npx agentic-workspace 直接运行。

### @agentic-workspace/workspace-cli 支持 TypeScript 吗？

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

### @agentic-workspace/workspace-cli 支持 ESM 还是 CommonJS？

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

### @agentic-workspace/workspace-cli 需要什么版本的 Node\.js？

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

### @agentic-workspace/workspace-cli 可以商用吗？

@agentic-workspace/workspace-cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agentic-workspace/workspace-cli 的下载量有多少？

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

### @agentic-workspace/workspace-cli 还在维护吗？

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