# @ayayaq/vivi 中文文档

规范地址：https://npmcn.com/package/%40ayayaq/vivi/

版本：0\.17\.1
npm 元数据更新时间：2026-11-07T10:33:55.553Z
中文译文更新时间：2026-11-07T20:56:31.694Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：2.8 MB，442 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-10-04T03:52:14.300Z
- 最新版本发布：2026-11-07T10:33:55.400Z
- 近 30 天下载量：2602（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

一个小型的无头,提供者中立的工具调用代理环

## 安装

```sh
npm install @ayayaq/vivi
```

也可以使用：`pnpm add @ayayaq/vivi`、`yarn add @ayayaq/vivi`、`bun add @ayayaq/vivi`

## README

# vivi 维基百科

一个小而无头的TypeScript工具调用回路. `@ayayaq/vivi` 提供消息, 提供者 适配器、代理转接器和可选的可信任工具。 你的东道主拥有批准书,证书, 存储、文件系统政策和用户界面。 22+节点,无害环境管理和共同JS。 只有可选技能 模块加载维护的 YAML 解析器依赖性.

公开npm `latest` 经核实为 `0.17.0` 2026-11-01 (英语). 发表 `0.17.0` 添加通用的 OpenAI 请求投影和安全错误细节, 加上 OpenRouter 推理-重放修复. 主机仍然拥有认证、存储和核准政策;核心有 不添加 ChatGPT 签名或跳过权限 。 见 [释放来源](https://npmcn.com/package/%40ayayaq/vivi/docs/releases/0.17.0.md) 财务报告和审定财务报表 [相关内容](https://npmcn.com/package/%40ayayaq/vivi/RELEASING.md)。 。 。 .

补丁 `0.17.1` 单独编制,尚未公布。 它承认有效的SSE 并改进其他反应的安全诊断. 认证仍然为主机所有;实际报告的ChatGPT会话仍未核实. 使用被冻结的已审查的档案和收件进行出版,而不是重新包装这种离职. 见 [相关内容](https://npmcn.com/package/%40ayayaq/vivi/RELEASING.md)。 。 。 .

## 可选背景管理(自0.14.0起)

基础API增加了全部预计需求占用,明确已知/未知的能力, `measureContext`、手动/自动便携式紧接装置、单独的源头检查站、, 并重试一次机密流 坚固原始历史和工具/核准证据 不变。 主机拥有耐久的检查站存储和UI;额外的摘要使用是分开的. 见 [内 容 提 要](https://npmcn.com/package/%40ayayaq/vivi/docs/CONTEXT.md)。该特征已公布 `0.14.0`。 。 。 .

## 工作空间说明和工具图像(以0.16.0提供)

新鲜主机拥有 `getContextPrefix` 信件在每次发送之前进行测量,而不 进入犬科历史. 带有图像的可选工具结果带有不可改变的快照 引用可视化提供者适配器;主机保留文件权限和存储. 见 [新的前缀](https://npmcn.com/package/%40ayayaq/vivi/docs/CONTEXT.md#fresh-dispatch-prefixes-unreleased) 财务报告和审定财务报表 [工具图像观测](https://npmcn.com/package/%40ayayaq/vivi/docs/IMAGES.md)。不包含附件命令或主机采纳.

## 可选澄清问题(自0.12.0起)

选入 `@ayayaq/vivi/extensions/questions` 子路径提供一个不偏移的渲染器 `request_user_input` 用于1–3个问题、选择、自由文本和明确跳出/跳出的工具. 一个主机的回调收集实际的人类输入;没有一个,没有工具的广告. 答复是 普通工具结果,绝不授权动作或更改批准模式。 正常和 Plan-mode主机可以在自己的工具政策下使用扩展. 见 [问题东道方合同](https://npmcn.com/package/%40ayayaq/vivi/docs/QUESTIONS.md) 财务报告和审定财务报表 [离线示例](https://npmcn.com/package/%40ayayaq/vivi/examples/questions.mjs)。 。 。 . 这一增加内容可从出版物中查阅 `0.12.0`;宿主根据自己的政策采纳.

可选的队列消息引导在 `0.16.0`。主机自己的队列识别 和强制发送取消;见 [停车,md](https://npmcn.com/package/%40ayayaq/vivi/docs/STEERING.md)。 。 。 .

## 可选决定的审查

此模块以可核实的稳定方式发布 `0.7.0` 和离开不可改变 `0.6.0`。 。 。 . 准确的注册字节和干净的节点22/24消费者得到核实;主机的采用另行进行.

`@ayayaq/vivi/decisions` 提供被冻结的精确动作快照, `allow` 编号 : `ask` 编号 : `deny` 和专门的OpenAI决定/OpenRouter Jev适配器。 从不给钱 权限或执行工具。 东道国规则、资格、隐私、人工审查和审计暂停 与您的申请。 见 [决定(md)](https://npmcn.com/package/%40ayayaq/vivi/docs/DECISIONS.md) 离线 [`examples/decisions.mjs`](https://npmcn.com/package/%40ayayaq/vivi/examples/decisions.mjs) 在通过之前.

已验证 `0.8.0` 添加可选主机备案效果元数据并纯审查路径 同样的子路径。 东道国的收养仍另行审查;见 [合同](https://npmcn.com/package/%40ayayaq/vivi/docs/DECISIONS.md#prepared-action-routing-published-080)。 。 。 .

## 安装

最近核实的公开 npm 发布是 `0.17.0`数字 :

```sh
npm install --save-exact @ayayaq/vivi@0.17.0
```

注册归档与保存的释放包完全匹配 。 其来源、元数据 补丁、散列和可复制性限制记录在 [释放来源](https://npmcn.com/package/%40ayayaq/vivi/docs/releases/0.17.0.md)。 。 。 . 收容收养仍然是单独的融合决定. 主机保留连接,处理,证书,实际发送和UI. 见 [MCP.md (英语)](https://npmcn.com/package/%40ayayaq/vivi/docs/MCP.md) 财务报告和审定财务报表 [相关内容](https://npmcn.com/package/%40ayayaq/vivi/RELEASING.md)。 。 。 .

`0.10.0` 还增加了自有范围, `/events` 会议简介和 `/events/stream` 命令接受的信息重放 。 其注册字节经过核实,没有变化. 见 [重播合同](https://npmcn.com/package/%40ayayaq/vivi/docs/AGENT_STREAM.md)。 。 。 .

## 可选模型能力

这个 `@ayayaq/vivi/providers/deepseek` 适配器( 自 `0.15.0`)支持普通的 DeepSeek 软件 独立于网络检索和决定审查的聊天补全, 本地 全回合推理保留和目录生成能力。 见 [深网主机合同](https://npmcn.com/package/%40ayayaq/vivi/docs/DEEPSEEK.md)。 。 。 .

可选 `@ayayaq/vivi/providers/models` 子路径在已核实的登记册中公布 `0.4.0` 和离开不可改变 `0.3.0`。主机可以通过经过单独审查的修改加以采用 保留其记录的能力覆盖和选择行为.

```js
import { normalizeModelCapabilities, reasoningSelectionSupport } from '@ayayaq/vivi/providers/models'

const capabilities = normalizeModelCapabilities({
  apiVersion: 1,
  provider: 'openai',
  protocol: 'responses',
  model: { id: 'gpt-5.1' }
})
console.log(capabilities.tools) // supported
console.log(reasoningSelectionSupport(capabilities, { mode: 'disabled' })) // supported
```

正常化是纯正的,终点认识. 它保存了精确的ID并提供了支持/不支持/未知 状态,包括单独推理、努力选择、明确禁用和强制状态. 默认表示没有被覆盖, 独立于明显的禁用 。 没有获取或选择模型 , 并且没有更改请求。 主机保留证书,目录获取/缓存,默认,节制, 和准入政策。 这个 [合同和来源](https://npmcn.com/package/%40ayayaq/vivi/CAPABILITIES.md) 解释有界种子登记册, 配对主机证据和释放/采纳门.

## 可选共享记忆(已公布为0.5.0)

可选 `@ayayaq/vivi/extensions/memory` 模块提取桌面 v1 绑定内存 服务、编码器、修订、用户级上下文和工具指导。 该出版物载于 已核实 `0.5.0` 和离开不可改变 `0.4.0`. 供应原子持久性/回收 和强制性工具政策召回;批准, 规划模式、操作录入/排水、全应用存储路径和多流程锁定仍然保留 宿主拥有. 见 [内存合同](https://npmcn.com/package/%40ayayaq/vivi/docs/MEMORY.md) 财务报告和审定财务报表 [离线政策实例](https://npmcn.com/package/%40ayayaq/vivi/examples/memory.mjs)。 。 。 . 不包括主机合并或会议说明迁移.

## 可选的唯教技能(已公布为0.6.0)

可选 `@ayayaq/vivi/extensions/skills` 模块读取普通代理技能 `SKILL.md` 文件,每回合发布一个紧凑的目录,并按要求加载指令/资源. 它包括一个只读的原始技能创建者和一个可选的 SKILL.md-只保存工具 背后的准确内容 主机批准和修订检查的持久性。 主机选择批准 源,拥有其全应用程序的商店并应用现有的权限. 没有执行脚本/ 插件, 没有扫描工作空间,也没有当前转动的热重载。 此模块以校验方式发布 `0.6.0` 和离开不可改变 `0.5.0`8\. 桌面/CLI的采用情况仍另行审查。 见 [格式和东道方合同](https://npmcn.com/package/%40ayayaq/vivi/docs/SKILLS.md) 财务报告和审定财务报表 [离线示例](https://npmcn.com/package/%40ayayaq/vivi/examples/skills.mjs)。 。 。 .

## 无头小例

此示例不需要终端框架、 app、 提供者密钥或网络请求 :

```js
import { runAgent } from '@ayayaq/vivi'
import { createToolRegistry } from '@ayayaq/vivi/extensions'
import { calculatorExtension } from '@ayayaq/vivi/extensions/calculator'

const registry = createToolRegistry([calculatorExtension])
const result = await runAgent({
  provider: { async generate({ messages }) {
    const answer = messages.find(message => message.kind === 'tool_result')
    return answer
      ? { content: answer.content, toolCalls: [] }
      : { content: '', toolCalls: [
        { id: 'calc-1', name: 'calculate', arguments: { expression: '2*(3+4)' } }
      ] }
  } },
  messages: [{ kind: 'message', role: 'user', content: 'Calculate 2*(3+4)' }],
  tools: registry.tools,
  executeTool: registry.executeTool
})
console.log(result.status, result.content) // completed {"result":14}
```

扩展代码运行于进程并被信任. 登记不是安全沙盒 主机执行自己的权限和批准. 通过 `@ayayaq/vivi/providers/openai` 财务报告和审定财务报表 `@ayayaq/vivi/providers/openrouter`。 。 。 .

## 发展和学习更多

```sh
npm ci
npm run check
```

检查使用假供应商和HTTP,构建两种模块格式,并安装打包消费者. 软件包包括建筑、申报、来源、实例和文件;安装 不运行构建脚本.

-   [API 和主机集成](https://npmcn.com/package/%40ayayaq/vivi/docs/API.md)合同、使用、供应商、历史和延期
-   [可选网页搜索和获取](https://npmcn.com/package/%40ayayaq/vivi/docs/WEB.md): 单独的主机控制检索和DeepSeek适配器
-   [可运行的无头示例](https://npmcn.com/package/%40ayayaq/vivi/examples/headless.mjs) 财务报告和审定财务报表 [库存政策实例](https://npmcn.com/package/%40ayayaq/vivi/examples/inventory.mjs)
-   [更改日志](https://npmcn.com/package/%40ayayaq/vivi/CHANGELOG.md), (中文(简体) ), [发布状况和工作流程](https://npmcn.com/package/%40ayayaq/vivi/RELEASING.md), (中文(简体) ), [共享用途审计](https://npmcn.com/package/%40ayayaq/vivi/REUSE_AUDIT.md)
-   Apache-2.0: (英语) [自由主义](https://npmcn.com/package/%40ayayaq/vivi/LICENSE), (中文(简体) ), [通知](https://npmcn.com/package/%40ayayaq/vivi/NOTICE), (中文(简体) ), [来源和归属](https://npmcn.com/package/%40ayayaq/vivi/ATTRIBUTION.md)

## 扶养政策

源代码开发需要npm QQ11.17.0. 读取 [7天依赖性冷却](https://npmcn.com/package/%40ayayaq/vivi/docs/DEPENDENCY_POLICY.md) 在安装或更新依赖之前.

## 常见问题

### @ayayaq/vivi 是什么？

一个小型的无头,提供者中立的工具调用代理环

### 如何安装 @ayayaq/vivi？

在项目目录运行 npm install @ayayaq/vivi，或使用 pnpm add / yarn add / bun add。

### @ayayaq/vivi 支持 TypeScript 吗？

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

### @ayayaq/vivi 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ayayaq/vivi 需要什么版本的 Node\.js？

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

### @ayayaq/vivi 可以商用吗？

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

### @ayayaq/vivi 的下载量有多少？

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

### @ayayaq/vivi 还在维护吗？

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