vivi 维基百科
一个小而无头的TypeScript工具调用回路. @ayayaq/vivi 提供消息, 提供者
适配器、代理转接器和可选的可信任工具。 你的东道主拥有批准书,证书,
存储、文件系统政策和用户界面。 22+节点,无害环境管理和共同JS。 只有可选技能
模块加载维护的 YAML 解析器依赖性.
公开npm latest 经核实为 0.17.0 2026-11-01 (英语). 发表 0.17.0
添加通用的 OpenAI 请求投影和安全错误细节, 加上 OpenRouter
推理-重放修复. 主机仍然拥有认证、存储和核准政策;核心有
不添加 ChatGPT 签名或跳过权限 。 见
释放来源 财务报告和审定财务报表 相关内容。 。 。 .
补丁 0.17.1 单独编制,尚未公布。 它承认有效的SSE
并改进其他反应的安全诊断.
认证仍然为主机所有;实际报告的ChatGPT会话仍未核实.
使用被冻结的已审查的档案和收件进行出版,而不是重新包装这种离职.
见 相关内容。 。 。 .
可选背景管理(自0.14.0起)
基础API增加了全部预计需求占用,明确已知/未知的能力,
measureContext、手动/自动便携式紧接装置、单独的源头检查站、,
并重试一次机密流 坚固原始历史和工具/核准证据
不变。 主机拥有耐久的检查站存储和UI;额外的摘要使用是分开的.
见 内 容 提 要。该特征已公布 0.14.0。 。 。 .
工作空间说明和工具图像(以0.16.0提供)
新鲜主机拥有 getContextPrefix 信件在每次发送之前进行测量,而不
进入犬科历史. 带有图像的可选工具结果带有不可改变的快照
引用可视化提供者适配器;主机保留文件权限和存储.
见 新的前缀 财务报告和审定财务报表
工具图像观测。不包含附件命令或主机采纳.
可选澄清问题(自0.12.0起)
选入 @ayayaq/vivi/extensions/questions 子路径提供一个不偏移的渲染器
request_user_input 用于1–3个问题、选择、自由文本和明确跳出/跳出的工具.
一个主机的回调收集实际的人类输入;没有一个,没有工具的广告. 答复是
普通工具结果,绝不授权动作或更改批准模式。 正常和
Plan-mode主机可以在自己的工具政策下使用扩展. 见
问题东道方合同 财务报告和审定财务报表 离线示例。 。 。 .
这一增加内容可从出版物中查阅 0.12.0;宿主根据自己的政策采纳.
可选的队列消息引导在 0.16.0。主机自己的队列识别
和强制发送取消;见 停车,md。 。 。 .
可选决定的审查
此模块以可核实的稳定方式发布 0.7.0 和离开不可改变 0.6.0。 。 。 .
准确的注册字节和干净的节点22/24消费者得到核实;主机的采用另行进行.
@ayayaq/vivi/decisions 提供被冻结的精确动作快照, allow 编号 : ask 编号 : deny
和专门的OpenAI决定/OpenRouter Jev适配器。 从不给钱
权限或执行工具。 东道国规则、资格、隐私、人工审查和审计暂停
与您的申请。 见 决定(md) 离线
examples/decisions.mjs 在通过之前.
已验证 0.8.0 添加可选主机备案效果元数据并纯审查路径
同样的子路径。 东道国的收养仍另行审查;见
合同。 。 。 .
安装
最近核实的公开 npm 发布是 0.17.0数字 :
npm install --save-exact @ayayaq/[email protected]
注册归档与保存的释放包完全匹配 。 其来源、元数据 补丁、散列和可复制性限制记录在 释放来源。 。 。 . 收容收养仍然是单独的融合决定. 主机保留连接,处理,证书,实际发送和UI. 见 MCP.md (英语) 财务报告和审定财务报表 相关内容。 。 。 .
0.10.0 还增加了自有范围, /events 会议简介和 /events/stream
命令接受的信息重放 。 其注册字节经过核实,没有变化. 见
重播合同。 。 。 .
可选模型能力
这个 @ayayaq/vivi/providers/deepseek 适配器( 自 0.15.0)支持普通的 DeepSeek 软件
独立于网络检索和决定审查的聊天补全, 本地
全回合推理保留和目录生成能力。 见 深网主机合同。 。 。 .
可选 @ayayaq/vivi/providers/models 子路径在已核实的登记册中公布 0.4.0
和离开不可改变 0.3.0。主机可以通过经过单独审查的修改加以采用
保留其记录的能力覆盖和选择行为.
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并提供了支持/不支持/未知 状态,包括单独推理、努力选择、明确禁用和强制状态. 默认表示没有被覆盖, 独立于明显的禁用 。 没有获取或选择模型 , 并且没有更改请求。 主机保留证书,目录获取/缓存,默认,节制, 和准入政策。 这个 合同和来源 解释有界种子登记册, 配对主机证据和释放/采纳门.
可选共享记忆(已公布为0.5.0)
可选 @ayayaq/vivi/extensions/memory 模块提取桌面 v1 绑定内存
服务、编码器、修订、用户级上下文和工具指导。 该出版物载于
已核实 0.5.0 和离开不可改变 0.4.0. 供应原子持久性/回收
和强制性工具政策召回;批准,
规划模式、操作录入/排水、全应用存储路径和多流程锁定仍然保留
宿主拥有. 见 内存合同 财务报告和审定财务报表 离线政策实例。 。 。 .
不包括主机合并或会议说明迁移.
可选的唯教技能(已公布为0.6.0)
可选 @ayayaq/vivi/extensions/skills 模块读取普通代理技能 SKILL.md
文件,每回合发布一个紧凑的目录,并按要求加载指令/资源.
它包括一个只读的原始技能创建者和一个可选的 SKILL.md-只保存工具
背后的准确内容 主机批准和修订检查的持久性。 主机选择批准
源,拥有其全应用程序的商店并应用现有的权限. 没有执行脚本/ 插件,
没有扫描工作空间,也没有当前转动的热重载。 此模块以校验方式发布 0.6.0 和离开不可改变
0.5.08. 桌面/CLI的采用情况仍另行审查。 见
格式和东道方合同 财务报告和审定财务报表 离线示例。 。 。 .
无头小例
此示例不需要终端框架、 app、 提供者密钥或网络请求 :
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。 。 。 .
发展和学习更多
npm ci
npm run check
检查使用假供应商和HTTP,构建两种模块格式,并安装打包消费者. 软件包包括建筑、申报、来源、实例和文件;安装 不运行构建脚本.
- API 和主机集成合同、使用、供应商、历史和延期
- 可选网页搜索和获取: 单独的主机控制检索和DeepSeek适配器
- 可运行的无头示例 财务报告和审定财务报表 库存政策实例
- 更改日志, (中文(简体) ), 发布状况和工作流程, (中文(简体) ), 共享用途审计
- Apache-2.0: (英语) 自由主义, (中文(简体) ), 通知, (中文(简体) ), 来源和归属
扶养政策
源代码开发需要npm QQ11.17.0. 读取 7天依赖性冷却 在安装或更新依赖之前.