# @axiomantic/vine 中文文档

规范地址：https://npmcn.com/package/%40axiomantic/vine/

版本：0\.2\.17
npm 元数据更新时间：2026-10-29T21:35:35.896Z
中文译文更新时间：2026-11-07T19:07:47.011Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40axiomantic/vine
原文对照：https://npmcn.com/package/%40axiomantic/vine/?lang=original
项目主页：https://github.com/axiomantic/vine#readme
源码仓库：https://github.com/axiomantic/vine

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

- 包体积（解压后）：5.4 MB，13 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-09-28T17:15:53.770Z
- 最新版本发布：2026-10-29T21:35:35.293Z
- 近 30 天下载量：3066（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

0- Cost 裂口复制- Write 工作空间 & 0- Mirage Git 编织引擎

## 安装

```sh
npm install @axiomantic/vine
```

也可以使用：`pnpm add @axiomantic/vine`、`yarn add @axiomantic/vine`、`bun add @axiomantic/vine`

## README

# 藤类

**0- Cost 裂口复制- write 工作空间 & 0- Mirage Git Weading for Automic AI 代理**

Vine提供"零干"工作空间虚拟化,多格洛特构建-cache常态化,以及用于平行AI编码剂的机械+语义验证门.

## 核心概念

-   **绳子**: 即时 工作空间克隆(`vine new <task_id>`) (中文(简体) ). 用途 `rift` 零成本快照克隆(0个额外磁盘块的~9s)和 `git worktree` 用于单层倒置(以~280ms计).
-   **通用煤矿销售**: 克隆依赖缓存`deps`, (中文(简体) ), `node_modules`, (中文(简体) ), `vendor`)在 <80ms中,没有物理磁盘重复.
-   **Polyglot 构建缓存层**: 自动激活无损 `.envrc` 常态化 `ccache`, (中文(简体) ), `sccache`, (中文(简体) ), `uv` 克隆模式,以及 `nimcache`。 。 。 .
-   **三基门**:确保零“绿色幻影”通过要求键 1(模拟机械) `git merge-tree` 退出 0),关键 2 (活编译器和测试套件退出 0),关键 3 (独立对抗性审计批准通过 `vine audit`) (中文(简体) ).
-   **编织**: 快速前行经核实的线回入克恩克干线(`vine weave`) (中文(简体) ).

* * *

## 人类和AI代理文件

Vine 提供了全面的工作空间,大门,并构建缓存规格:

### 核心协议和架构

-   **[字符串寿命周期规格](https://npmcn.com/package/%40axiomantic/vine/docs/strand_lifecycle.md)**:零成本裂口 Copy-on-Write 线条,目录隔离, `.vine.json` 运行时间显示 和碰撞探测.
-   **[三键门规格](https://npmcn.com/package/%40axiomantic/vine/docs/two_key_gate.md)**:零"绿色幻影"哲学,关键 1 机械合并-树 + 关键 2活测试发现级联 + 关键 3 独立对抗码审核批准和密码门标志.
-   **[Polyglot 构建缓存正常化](https://npmcn.com/package/%40axiomantic/vine/docs/cache_normalization.md)**: 无损 `.envrc` 连锁,缓存,货物目标, uv克隆链接,和尼姆卡切的统一.
-   **[CLI 参考手册](https://npmcn.com/package/%40axiomantic/vine/docs/cli_reference.md)**: 完整所有 Vine 命令的目录 (`new`, (中文(简体) ), `status`, (中文(简体) ), `collisions`, (中文(简体) ), `gate`, (中文(简体) ), `submit`, (中文(简体) ), `audit`, (中文(简体) ), `weave`, (中文(简体) ), `list`, (中文(简体) ), `sync`, (中文(简体) ), `prune`) (中文(简体) ).
-   **[配置结构](https://npmcn.com/package/%40axiomantic/vine/docs/configuration.md)**:分层配置等级,工作空间路径,和出闸选项.
-   **[代理宪法和Invariants(AGENTS.md)](https://npmcn.com/package/%40axiomantic/vine/AGENTS.md)**:工作空间隔离规则,主权工人分配,三关键纪律.

* * *

## 独立然而为轴心三体设计

葡萄完全独立,可以单独用于零成本的"裂口"复制-写作工作空间克隆, `.envrc` 任何git存储器上三键门的校验.

> \[注\]
> 
> ### 快速注意: 将花园作为您的高层次的 Swarm 包装器
> 
> **寻找高级多代理指挥? 使用 [花园](https://github.com/axiomantic/garden)。 。 。 .**  
> 虽然 `vine` 提供孤立的分支工作空间和三基门, **花园** 是高层次的伞式框架。 只需在您最喜欢的编码工具( Antigravity, Claude Code, OpenCode) 中启动一个会话, 并输入 `"garden: I want to build [feature]"`花园进行录入采访,为您的终端标签生成干净的10个回转快卡,协调Rhizo和Vine上的所有工人!

然而,葡萄酒的设计从地上到上,无缝地与 **瑞佐** 财务报告和审定财务报表 **花园**数字 :

-   [**瑞佐**](https://github.com/axiomantic/rhizo) (运输和货币): 代理通讯总线,单音节栅栏锁,以及任务排到Redis上空.
-   **藤类** (工作空间与核查):零成本的裂口复制-并写线条,多块块的构建-缓存正常化,和三键集成门(C`git merge-tree` 机械+编译器/测试套装语义检查+独立的对抗性审计批准.
-   [**花园**](https://github.com/axiomantic/garden) (Swarm Methods & High-Level Crapper):对话式的项目收录访谈,即时启动的工人车队(10个后卫卡),3个阶段的经验性辩证泵(研究,建筑,审计),以及主仪式性实施规划.

## 安装

### 1\. AI编码助理(建议)

在全球安装技能(`-g`) 跨越所有编码助理(Claude Code, Antigravity, Cursor, Codex, OpenCode等) :

```bash
# Recommended: Install the complete multi-agent triad globally
npx skills add -g axiomantic/rhizo
npx skills add -g axiomantic/vine
npx skills add -g axiomantic/garden
```

_(如果尚未安装在您的系统上, 每种技能都会自动设置本地的 CLI 二进制) ._

只安装 Vine :

```bash
npx skills add -g axiomantic/vine
```

### 2\. 单独安装CLI

将编译的 CLI 工具直接安装到您的上 `$PATH`数字 :

```bash
# Install all three tools:
npm install -g @axiomantic/rhizo @axiomantic/vine @axiomantic/garden rift-snapshot

# Or install Vine alone:
npm install -g @axiomantic/vine rift-snapshot
```

> \[TIP\] **零安装通过 NPX 运行**:在无法全局安装的受限或集装箱环境中,可以直接运行任何指令而无需安装:
> 
> ```bash
> npx -y @axiomantic/vine <command>
> ```

### 3\. 仓库协调指南

将 Vine 链条协调协议直接安装到任何工程中 `AGENTS.md`数字 :

```bash
vine guide install
```

## 快速启动

```bash
# Spin up an isolated strand for a task
vine new task-1049 --repo ~/Development/PebbleOS --branch feat/display-driver

# Inspect dynamic strand lifecycle and commit delta
vine status --json

# Forecast cross-strand file footprint overlap before conflicts happen
vine collisions

# Reconcile upstream canonical trunk changes into strand
vine sync

# Verify mechanical and semantic correctness inside the strand
vine gate

# Weave clean strand into canonical trunk
vine weave

# Prune completed or merged strands
vine prune --apply
```

## CLI 参考

| 命令 | 参数 | 说明 |
| :-- | :-- | :-- |
| `vine new <task_id>` | `[--repo <dir>] [--branch <name>] [--parent <branch>] [--worktree]` | 提供一条与世隔绝的裂缝绳索或干树. |
| `vine list` | `[--repo <dir>] [--all] [--json]` | 列出各项目的活跃线条、分支和状态. |
| `vine status` | `[<strand>] [--dir <path>] [--json]` | 被检查的深生命周期状态( C)`PROVISIONED`, (中文(简体) ), `IN_PROGRESS`, (中文(简体) ), `GATE_PASSED`),并承担前/后. |
| `vine collisions` | `[--repo <dir>] [--json]` | 预测文件脚印重叠于同时期工人. |
| `vine sync` | `[--dir <path>] [--base <branch>]` | 快速前进或合并上游干线 干净地改变成支线. |
| `vine gate` | `[--dir <path>] [--base <branch>] [--submit] [--author <name>] [--skip-tests] [-- <command...>]` | 跑出三键门:键 1 机械预检和键 2 语义测试套件(`-- <cmd...>` 或者说 `--test-command <cmd>`) (中文(简体) ). |
| `vine submit` | `[--dir <path>] [--author <name>] [--commit <msg>] [--listen] [--allow-no-tests]` | 运行 Keys 1 & 2, 自动承诺下脏更改, 提交 Key 3 审计的线索, 并选择输入前景倾听器 . |
| `vine audit` | `<approve|reject|status> [--auditor <name>] [--reason <text>] [--notes <text>]` | 关键词3 横向审计:拒绝缺陷,检查状态,或批准带有加密审计标志的核准(工人自我审计被严格封锁). |
| `vine weave` | `[--dir <path>] [--base <branch>] [--force] [--allow-unaudited]` | 检查三基门 快速前进 将批准的线条合并到峡谷干道和干道. |
| `vine prune` | `[--repo <dir>] [--apply]` | 删除不活动或已完成的线程( 默认干线运行) . |
| `vine config <init|show>` | `[--json]` | 脚手架或显示项目 `vine.toml` 配置 . |
| `vine guide <install|check|uninstall>` | `[path]` | 在 `AGENTS.md`。 。 。 . |

## 配置环境变量( E)

> \[TIP\] 完整说明 `vine.toml`, (中文(简体) ), `.vine.json` 运行时状态计划,以及环境变量,参见 [Vine 配置并显示引用](https://npmcn.com/package/%40axiomantic/vine/docs/configuration.md)。 。 。 .

Vine 提供了零配置默认,可以通过 `vine.toml` 或环境变量:

| 变量 | 默认 | 说明 |
| :-- | :-- | :-- |
| `VINE_WORKSPACES_DIR` | `~/Development/workspaces` | 提供孤立线条的基准目录 . |
| `VINE_PROJECTS_DIR` | `~/Development` | 库克库所在的基目录. |
| `VINE_CONFIG` | _自动发现_ | 项目的明确路径 `vine.toml`。 。 。 . |
| `VINE_PRIMARY_BRANCH` | `main` | 门检查和合并的默认目标分支 . |
| `VINE_TEST_COMMAND` | _自动检测_ | 自定义测试/编译器运行键 2 语义门检查 . |
| `VINE_VENV_POLICY` | `prompt` | 虚拟环境复制政策`prompt`, (中文(简体) ), `auto_yes`, (中文(简体) ), `auto_no`) (中文(简体) ). |

### 示例 `vine.toml`

```toml
[project]
primary_branch = "main"

[strand]
venv_policy = "prompt"
vendor_dirs = ["deps", "node_modules", "vendor", ".zig-cache"]

[verification]
test_command = "pytest -v tests/"
```

## 多代理三合一工作流程

当由多个AI助手组成的团队同时跨行时,配对Vine与 [**瑞佐**](https://github.com/axiomantic/rhizo) 财务报告和审定财务报表 [**花园**](https://github.com/axiomantic/garden)数字 :

-   **分布的变种( F)**: 使用 `rhizo lock file:<path> --fencing` 防止在不可合并的图案或迁移中同时发生相撞.
-   **同步任务队列**代理人通过 `rhizo claim queue:<project>:tasks --lease 1800` 并在雷地斯巴士上报告情况.
-   **完全仪式行为**: 使用 `garden` 指导个人审议,生成10个背部工人快速卡,并推动实施计划.
-   **零下层**: Rhizo, Vine, and Garden 强制将代理身份与目录路径完全脱钩.

## 仓库指南集成

将 Vine 向导安装到任何仓库 `AGENTS.md`数字 :

```bash
# Defaults to AGENTS.md in the current working directory:
vine guide install

# Or specify a custom target path:
vine guide install /path/to/AGENTS.md
```

## 常见问题

### @axiomantic/vine 是什么？

0- Cost 裂口复制- Write 工作空间 & 0- Mirage Git 编织引擎

### 如何安装 @axiomantic/vine？

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

### @axiomantic/vine 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/axiomantic\_\_vine 是否存在。

### @axiomantic/vine 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @axiomantic/vine 可以商用吗？

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

### @axiomantic/vine 的下载量有多少？

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

### @axiomantic/vine 还在维护吗？

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