桌面上的一颗水晶，替你运行 AI 智能体

1. 1认识 Verse0:00
2. 2什么是智能体0:26
3. 3模型负责计划，代码负责决定1:11
4. 4所有操作共用一道关口1:43
5. 5由你掌控2:26
6. 6外部文字不能下命令3:14
7. 7记忆3:54
8. 8技能与团队4:21
9. 9你的其他电脑5:08
10. 10谁来思考5:35
11. 11出问题时6:07
12. 12目前进展6:41
13. 简而言之7:12

模型负责规划。由朴素、可检查的代码来判断是否允许、执行、检查是否成功、不成功就撤销，并把一切记录下来。

一目了然

Verse 说话

Kitten TTS v0.8 mini，运行在你的设备上

Verse 倾听

Moonshine v2 流式识别，运行在你的设备上

Verse 会记住

存放在你设备上的小型向量记忆

应用中的智能体

书记员，负责笔记、提醒和摘要，以及内置的演示智能体。要添加更多，可在团队看板上用新建智能体，或在 platform/agents.json 中添加。

技能与团队

你自己的技能，即你写一次、用 /name 调用的指令，以及团队，即你在看板上绘制、提问时使用 @name

其他电脑

Verse Node 在你的其他电脑上运行智能体，只需用 12 位字符的配对码配对一次。你的密钥留在主电脑上。

模型

默认在你的电脑上（Ollama 上的 gemma3:1b）。线上：Verse AI、Claude、OpenAI 或 Kimi。其他都无法回答时，应用内会运行一个小的备用模型。

安全

默认什么都不允许。较大的改动要等你决定，每处改动都会被检查，失败的改动会被撤销。

连接

通过 MCP 服务器接入 23 个外部服务，在你打开之前全部关闭

运行于

Windows、macOS 和 Linux

版本

三种语言的平台均为 1.1.1。Verse Agent 应用为 0.1.0。

测试

C# 791、Python 533、Node 532、Verse Agent 191，另有 46 项故障注入检查，三种语言通用

目前进展。已经能从头到尾跑通。Verse Agent 和 Verse Node 提供 Windows 和 Linux 安装程序，没有 macOS 版；它们还没有代码签名，也不会自动更新。有些界面能显示真实数据，但暂时还不能修改：章程窗口的表单（请改在团队看板上创建智能体）、编辑规则、单独关闭某个工具，以及信任或停用已学会的技能。这些界面上都有说明。

和它交谈

Space 按住

按住键说话，说完松开。只有按住键时麦克风才是打开的。“说话”按钮用鼠标也是同样的效果。

H

免提聆听。用 “Hey Verse” 开始，然后说出你想要的。一次对话结束后的 25 秒内，你可以继续说话，不需要唤醒词。Verse 说话时会关闭听觉，所以它不会自己回答自己。

Enter

在底部的输入框里输入“问问 Verse，或者告诉智能体该做什么”，然后发送。

Space 再按一次

Verse 说话时按下它，会立刻让 Verse 停下。话语权始终在你手里。

Verse 用一到三句简短的话回答，当你要它解释什么时最多六句。它正在说的那一句，或你刚说的那一句，会在水晶下方逐字显示。Verse 听和说的都是英语。

Verse 不需要问模型就能做的事

即使模型很慢或离线，这些也能用。Verse 听的是英语，所以要用英语说。

其他一切都是对话。当你要的是真正的工作时，Verse 会把它交给合适的智能体，并告诉你是谁在处理。

给智能体安排工作

1. 用日常的话问 Verse： “Can you get the scribe to write down the plan for Friday?”
2. 以 @ 符号加智能体名称开头发出请求：@scribe write down the plan for Friday。在输入框开头输入 @ 或 / 时，Verse 会提示它认识的名称。
3. 或者输入任务，点击 +，选择智能体，选好智能体后按 Enter。这条消息会直接作为任务交给那个智能体，而不是交给 Verse。

好的任务会说明做到什么程度算完成。“把今天笔记的三行摘要写进 summary.md”比“整理我的笔记”完成得更快也更好。

编写技能，搭建团队

技能是你写一次、之后随时可用的一组指令。打开技能（按键 8），停留在你的，选择新建技能，填写名称、用途和指令，例如“使用前，先对照来源核对每个名称和数字。”然后在请求开头写上斜杠加技能名称：/careful check the guest list for the party。Verse 会在这次请求中遵循它；如果它把工作交给某个智能体或团队，技能也会一起传过去。

团队是由智能体（甚至更小的团队）组成、共同处理一个请求的一组成员。打开智能体（按键 A），选择团队和新建团队，给它起个名字并说明它的用途，然后按打开看板：

1. 把你的智能体从左侧拖到看板上。
2. 从顶部的 Verse 拖出一根连线，连到接收你请求的智能体。
3. 从该智能体向它负责的智能体拖出连线。箭头显示谁向谁负责。
4. 按保存团队。底部的状态条会说明还缺什么（如果有的话）。

然后向它提问：@research-team compare three laptops under a thousand dollars。负责的智能体会在它的团队中把工作规划成最多六个步骤，每个步骤等待它需要的前序步骤，全部完成后 Verse 会告诉你团队取得了什么成果。技能和团队可以组合使用：/careful @research-team compare three laptops。这次运行和其他工作一样显示在任务中，在那里取消它会停止它分派出去的所有工作。

需要新类型的智能体吗？看板上的新建智能体可以当场创建一个：设定角色、用途、可以使用的工具，以及快速或全面的限制。它立刻就绪，并出现在看板上。

把智能体放到你的其他电脑上

节点是你家里或办公室里运行 Verse Node 的另一台电脑。你放在它上面的智能体在那里工作，使用那台电脑的文件和工具。

1. 在看板上，选择添加节点。在把 Verse Node 装到那台电脑上下，按 Windows 或 Linux 安装程序旁边的保存，把它带到另一台电脑上安装。Verse Node 会打开并显示一个配对码，例如 7KQ4-M2XD-9PRW。
2. 回到添加节点，从 Verse 在你的网络中找到的电脑里选出那一台，或者输入它的地址，输入配对码，在叫它中填写名称，然后按配对。
3. 节点会以圆圈的形式出现在看板上。把它连在 Verse 或某个智能体下面，再在它下面连上应在那台电脑上运行的智能体。点击圆圈，填写这个节点做什么，并选择它在那里打开为窗口还是终端。
4. 保存看板。Verse 会自动设置好节点，之后发给该团队的任何请求都可以把相应的部分交给这个节点。

在另一台电脑上，窗口或终端会显示它的智能体执行的每一步。对 Verse 说 “What's on my office computer?”。你的密钥始终不会离开主电脑：节点上的智能体通过 Verse，使用 Verse 的模型来思考。只要主电脑上的 Verse Agent 窗口开着，节点就能工作。

跟进工作

每个智能体都以一颗围绕 Verse 运行的小水晶出现，最多十二颗。它工作时发光，行动时闪耀，等你时泛起金色的呼吸，完成或失败时泛起光环。一个智能体把工作交给另一个时，两颗水晶之间会闪过一道光。

Verse 会在工作发生时告诉你：任务开始、需要你、完成或卡住的时候。紧急消息，比如批准、卡住的智能体或你的任务失败，可能会打断它正在说的话（“哦，等一下，有个智能体在叫我。”），然后它会接着刚才的话说下去。任务窗口显示每个任务的进度、计划、助手，以及什么算完成。历史记录会逐步回放任何任务和每项安全检查，而不会重新运行任何东西。

说“是”或“否”

当某一步会改动重要的东西时，智能体会停下来询问。Verse 会大声说出来，字标下方的状态变成需要你，“智能体”按钮变成琥珀色并带有数字。需要你的许可窗口（快捷键 3）显示它要做什么、改动有多大，以及能否撤销。

试试看。假设你已经把你的 Slack 连接交给了书记员：

• 按住批准：按住直到进度条填满，需要 1.2 秒。误点一下不会批准任何事。
• 拒绝：点一下就行，因为说不总是安全的。智能体会另找办法，或者停下来。
• 或者回答 Verse：“Yes, go ahead” 或 “Deny it”。你批准的是你看到的那个确切操作。如果它在运行前有任何变化，就必须重新询问。

照看记忆

Verse 对你的了解

“设置 › 记忆”列出所有事实，并提供忘掉那个和忘掉所有。Verse 只存储你亲口说过的内容，从不猜测，并会拒绝任何看起来像密码、密钥或银行卡号的内容。

智能体知道什么

“记忆”窗口（快捷键 9）。智能体保存的笔记会搁置中，等你用按住的方式批准，或拒绝它们。智能体永远无法批准自己的笔记。

连接外部服务

工具和连接（快捷键 7）列出 23 个服务。每个服务在你打开之前都是关闭的。如果某个服务需要密钥，Verse 会告诉你是哪个，并在加密保存密钥之前保持关闭。然后由你选择哪些智能体可以使用它。读取操作立即允许；任何会为你改动内容的操作，比如发送消息或更新工单，都会先准备好，等你许可后才执行。

工作，替你行动

Microsoft 365、Google Workspace、Slack、Jira、Confluence、Notion、Airtable、Todoist、Linear、HubSpot、Sentry、Zapier

知识

Microsoft Learn、库文档 (Context7)、arXiv

这台电脑及其设备

网页浏览器 (Playwright)、文档阅读器 (MarkItDown)、代码搜索 (Serena)、GitHub、数据库 (DBHub)、Windows 桌面、手机和平板 (mobile-mcp)、Home Assistant

选择由谁来思考

模型窗口（快捷键 0）显示这台电脑上的模型、可选的线上模型，以及工作如何分配。要添加线上模型，选择 Verse AI、Claude、OpenAI 或 Kimi 并输入密钥。对于 Verse AI，还要输入密文和服务器地址。检查并保存会拒绝提供商不接受的密钥。然后选择一个模型，选择有多少任务发往线上，再按使用这个模型。

需要时

每次调用都去适合它的地方

一半

大约一半的调用发往线上

全部

每次调用都发往线上

无论你怎么选，私密内容始终留在这台设备上。如果没有任何模型能回答，Verse 会切换到在应用内、用你的显卡运行的小型备用模型，告诉你这一点，并在你问“出什么问题了？”时说明原因和解决办法。

Verse AI 的 API 密钥和 Secret 来自本站的“设置 › API 凭据”。开发者门户有详细说明，托管服务以 VXT 计费。

在终端里使用

verse-agent 命令能做窗口能做的一切，在 Windows、macOS 或 Linux 的任何终端里都可以，通过 SSH 也行：快捷命令、可以像 tmux 那样拆分窗格的全屏视图，以及逐行聊天。

# what's running, then a task for the scribe
verse-agent status
verse-agent task scribe "Write a three-line summary of today's notes into summary.md"
verse-agent approvals
verse-agent approve 1

出问题时

启动器里的系统健康每 5 秒检查一次 Verse 的每个部分。手册的“问题”一章说明了每种症状及其解决办法：

• 智能体没有运行：用 npm run platform:build 构建平台，这需要 .NET 10 SDK。
• Verse 在用备用模型，或者本地模型加载期间第一个回答很慢。
• 没有声音或没有听觉：下载模型。
• 一个密钥被拒绝了。
• 水晶卡顿：降低画质，或切换到示波器。
• 某个智能体总是卡住：查看“第二意见”和“历史记录”。

水晶就是 Verse。文字、按钮和窗口像 CRT 显像管的荧光粉一样发光，带有淡淡的扫描线。屏幕上的一切都用日常的话，比如“可撤销的改动”和“需要你的许可”，而不是工程术语。没有任何编造：平台没有数据的地方，或控件还没接通的地方，屏幕都会如实说明。

应用遵守的规则

先用通俗的名称

工具、改动大小和事件都用通俗的话显示：write-file 是“写入文件”，significantSharedWrite 是“别人看得到的改动”。“设置 › 显示 › 技术名称”会在旁边加上平台自己的名称。

只有真实数据

每个窗口读取的都是实时数据。空状态会自己说明：“没有正在运行的任务。让 Verse 帮你做点什么，它就会出现在这里。”

坦率说明不足

平台暂时还不能执行的控件会显示为停用，并附上说明。

先说正事

任何需要你处理的事，无论是批准还是卡住的智能体，都会显示为琥珀色：在顶栏里、在语音中，开启侧边面板时还会出现在侧栏里。

为耳朵和眼睛准备的文案

简短的主动句，带缩略形式。

荧光显像管

界面里的每种颜色都由两个值混合而成：发光的荧光粉和不发光的玻璃。在“设置 › 显示”里更换显像管，所有颜色会一起改变。这个页面的工作方式也一样：

有两种信号色不属于显像管，永远不变：琥珀色用于任何等你处理的事，红色用于失败、“拒绝”和“从不”。3D 场景保留自己的配色：深邃虚空上的青色、紫罗兰色和香槟色。

水晶

Verse 是一个由 870,000 个三角形组成的单一网格，带有烘焙的颜色、粗糙度和法线贴图。它的着色器按色相把每个纹素分入三种材质：

烟色香槟石英

透明玻璃：物理透射、石英的折射率（1.544）、香槟色吸收、色散、清漆层和薄膜虹彩。它是双面的，所以背面的刻面也能透出来。

紫水晶核心

不透明，带着呼吸般的紫色光芒，内部由一道搏动的光点亮。

青色纹路

流动的能量，加上从绘制的纹路中长出的 3D 网络，脉冲沿网络传播，在交汇处迸出星状光芒。

它的情绪随 Verse 在做的事而变化，平滑过渡：

画质设为“低”时，按设备像素比 1 绘制，不使用多重采样，透射效果为半分辨率，阴影为 1024 像素。设为“高”时，像素比最高到 1.75，使用 4× 多重采样和 2048 像素的阴影。

智能体星座

每个智能体在围绕 Verse 的轨道上有一颗小水晶，系在它的核心上，最多十二颗。更多的智能体在主水晶里发光，有智能体退役时会接管它的水晶。

生成

在核心处诞生，划出弧线飞向自己的轨道，一道闪电沿着系绳掠过。

活动

它的核心变亮，旋转加快，脉冲沿着系绳向内流动。

思考

柔和的紫罗兰色微光，一步被退回时也会用到。

闪耀

一道青色闪光和一下轻微的弹动。

转交

一道光在两颗水晶之间闪过，表示一个智能体把工作交给另一个。

需要关注

智能体在等你时，金色光芒缓缓起伏。

完成

明亮的光晕和向外扩散的光环。

失败

余烬般的闪烁、一阵颤动和一圈光环，运行崩溃并将重试时也会用到。

退役

它螺旋着飞回核心。

事件再多也能看清。持续的工作是一个会逐渐升高再衰减的水平，所以每秒一千个事件只会让一颗水晶保持发亮，而不是重放一千次动画。每个智能体的点缀效果会被限速，所有智能体合计也有上限；生命周期提示从不丢弃，但会间隔 180 毫秒；开启操作系统的“减少动态效果”设置后，只播放生命周期提示。

示波器

“设置 › 显示 › 将 Verse 显示为 › 示波器”会用双轨模拟示波器取代水晶。通道 1 是 Verse 的声音；通道 2 是你的麦克风（打开时）。每一帧都会像荧光余辉一样淡化上一帧，通道 1 上缓慢的低波表示 Verse 正在思考。使用示波器时，3D 场景及其 36 MB 的模型不会被加载，静止时每秒大约重绘十次。

配线架

团队的看板在显像管上画成一个配线架：点阵网格会随视图平移和缩放，还有扁平的方形荧光模块，以及发光的连接线缆，它们是看板上唯一的曲线。所有颜色都来自显像管，所以显像管设置也会改变看板的颜色。

Verse

固定在顶部的实心面板，带有 VERSE 字标，下方有一个输出插孔

智能体

一个方形面板，显示它的名称、职责和技能（以 /name 形式），上方有输入插孔，下方有输出插孔

团队

同样的面板，带双层边框和“团队”徽标，没有输出插孔，因为它运行着自己的团队

节点

一个带指示灯的虚线圆圈：Verse 已连接时亮起，正在连接时为琥珀色，离线时变暗

线缆

一条曲线，从上级的下方插孔连到下级的上方插孔，末端带箭头。通向有问题的模块时，它会变成琥珀色。

保存时，每根线缆上都会传出一个短暂的信号脉冲。启用减少动态效果时没有脉冲，看板打开时也没有动画。

字体、形状、动效和声音

类型

标签和按钮用 Roboto Condensed，读数、字幕和输入框用像素风终端字体 VT323，手册中的阅读文字用 Roboto Serif。全部内置，运行时不会下载任何内容。

形状

每个角都是方的。唯一的圆角是 CRT 玻璃。边框和分隔线是 2 px 的线条，填充的读数单元格之间隔着 3 px 的缝，就像这个页面一样。

质感

所有内容上都有扫描线，文字带柔和的荧光辉光，窗口是半透明的。扫描线和辉光都可以单独关闭。

动效

分步跳变，干脆利落，就像老式硬件。状态点分步闪烁，窗口在 260 毫秒内打开，语音字幕在方块光标后面以每秒 45 个字符的速度逐字显示。

音频

唯一的声音是 Verse 的声音。没有点击声，也没有提示音。

布局

默认情况下屏幕是空的，给水晶留出空间，消息以角落里的提示条出现。开启侧边面板后，左侧栏列出智能体，右侧栏显示需要你处理的事和最新活动。

启动器（W）把所有窗口分了组：工作（智能体、任务、需要你的许可、第二意见、历史记录）、智能体能做什么（规则、工具和连接、技能、记忆）、系统（模型、系统健康、设置）和帮助（手册）。每个窗口都是可以拖动的浮动面板；获得焦点的那个带有明亮的边框。

所有窗口

按键和手势

你在输入框中打字时，这些按键都不起作用。批准一个操作、批准一条记忆笔记和移除已保存的密钥都用按住：按钮会在 1.2 秒内填满，提前松开或滑出按钮就会取消。当 Verse 问“要批准吗？”时，单独按 “yes” 或 “no” 可以在 2 分钟内回答它。

声音和听觉

声音

Kitten TTS v0.8 mini（8000 万参数），在后台工作线程中运行。模型 1.5 到 3 秒就绪，Verse 开始说一句话后约 1.1 秒出第一段音频，各段之间没有静音间隔。八种声音：Rosie（默认）、Bella、Jasper、Luna、Bruno、Hugo、Kiki 和 Leo，语速 0.5× 到 2×。

水晶特效

略微提升临场感和空气感，带一点缓慢的立体声闪烁和短短的玻璃碗余音，混得很轻，不影响听清说的话。

听觉

Moonshine v2 medium，流式英语识别（305 MB），在自己的工作线程中运行，带回声消除、降噪和自动增益。它还在加载时你说的话会被保留，最长约 30 秒，等它就绪后再识别。

记忆模型

bge-small-en-v1.5 嵌入模型 (34 MB)，用于 Verse 对你的记忆。

下载

三个模型都按固定版本下载，使用前用 SHA-256 校验。

Verse 如何说话

Verse 好奇、温暖，带一点冷幽默。如果你真心发问，它会坦率说自己是 AI，会跟进它记得的事，幽默点到为止，在你忙碌或沮丧时说话简短。

• 文案是为耳朵写的：每句约 8 到 12 个词，一句一个意思，用主动语态，总是用口语化的缩略形式。
• 每次发言是一到三句话，最多一个问题，放在最后。
• No stock phrases (“Certainly!”, “Great question”), no inflated words, no em dashes, no markdown or emoji, no flattery.
• 它只简短道歉一次；会直截了当地说“我不知道”并给出下一步建议；绝不会把原始错误代码念出来。
• 智能体的消息来自常用语手册，而不是模型，所以是即时的，对发生了什么绝不会说错。

1.5 秒内的相似消息会合并在一起（“三个任务刚刚完成。”），5 秒内已经修复的工具错误绝不会提起，过时的消息会被丢弃。

手册

按 F1 打开 Verse 手册，版式像印刷的手册一样：双页跨版、带大号像素数字的章节开篇、沿边缘排列的拇指标签，并且可以用 Ctrl F 在全书中搜索。它的专色会跟随你选的显像管。在终端里用 verse-agent handbook 可以看到同样的文字。

1. 认识 Verse
2. 交谈
3. 界面导航
4. 智能体
5. 你的许可
6. 工具、记忆
7. 模型
8. 设置
9. 好习惯
10. 问题
11. 终端

无障碍

• 示波器几乎不需要图形性能。设置了减少动态效果后，字幕会立刻出现，波形保持不动，窗口动画关闭，星座只播放生命周期提示。
• 窗口是以标题命名的对话框，字幕是礼貌型的实时区域，开关、菜单和分段控件都带有各自的角色。
• 所有重要的事都可以用语音、键盘或鼠标完成。批准是刻意的按住，绝不是误点。
• 状态不仅靠颜色，也靠形状区分：菱形表示等待，对勾表示完成，叉号表示失败。

智能体及其章程

智能体是负责一项工作的执行者。它的章程就是它的岗位说明：用途是什么、可以使用哪些工具、可以自主做到什么程度、预算多少、何时必须询问、可以记住什么，以及它的思考可以在哪里进行。

书记员的文件工具只能访问一个文件夹：Documents/Verse Notes。写入文件是可逆的：改动先暂存，读回确认，之后才保留。

章程还会设定升级触发条件、风险策略、记忆范围，以及数据可以去往哪里。你没写的部分会使用安全的默认值：20 步、15 次工具调用、200,000 个 Token 和 600 秒。

要创建智能体，请在团队看板上使用新建智能体：设定角色、用途、最多 12 个工具，以及快速（8 步、6 次工具使用、5 分钟）或全面（20 步、15 次工具使用、15 分钟）限制，思考量为 80,000 个 Token。平台会立即注册它，无需重启，并为每个工具添加一条允许规则，上限是该工具自身的改动大小，所以“别人看得到的改动”或更大的操作仍然会先询问你。属于某个连接的工具不会在这里提供：它们在“连接”里给出，因为那里知道它们的密钥。章程窗口的五步表单会显示任何智能体的真实章程，但暂时还不能保存章程。

每个智能体都按一个有界的循环工作：观察、更新自己的认知、规划、提出一个操作，然后由平台验证、授权、运行并检查。预算是硬性限制。智能体卡住或没把握时，会把一份简短的概述（而不是整段对话）发给中央模型，征求第二意见。

技能与团队

你的技能

/name 技能会以你自己的指令的形式交给模型，以 skill: careful 为标题，并作为约束随它所交付的任何任务一起传递。在看板上，每个模块最多可以携带五个自己的技能，用来塑造该智能体在该团队中的工作。名称使用小写字母、数字和连字符，最长 40 个字符。你最多可以保存 100 个技能，每个技能的指令最长 4,000 个字符，一次请求最多使用五个。

看板的规则

编辑时和保存时都会检查：Verse 下是一棵树，每个模块恰好连到一位上级；最多 16 个模块、五个层级；团队模块是末端模块，下面不能再连别的模块；节点下面只能有智能体，且至少有一个，节点内部不能再有节点；团队最多嵌套三层，且任何团队都不能最终包含它自己。

一次运行

没有下属团队的模块会拿到完整的请求。带有团队的智能体会负责统筹，在它的团队和它自己之间制定计划。有多个模块连到 Verse 时，由团队牵头，以 Verse 的名义发言。一个计划有一到六个步骤，每个步骤都是一项独立的任务；无需等待的步骤同时运行，处于等待中的步骤会拿到前面步骤的成果。制定计划的一方用两到四句话做总结。只要至少有一个步骤成功，这次运行就算完成，总结里会列出失败或被跳过的步骤及原因。

批准

运行是你要求的，所以交接不需要批准。成员之后做的任何事仍然要经过它的章程、规则和批准。超过 30 分钟仍在进行的运行会停止并失败。

节点

Verse Node 是一个小程序，里面装着一整套属于它自己的智能体平台。Verse 根据各个看板推算出每个节点的配置：它的团队、团队里的智能体和规则、它们携带的技能、它们使用的无需密钥的连接，以及模型选择，但绝不包含密钥。只有配置发生变化时才会发送，而在运行期间到达的配置会等运行结束后再生效。

• 模型调用经由 Verse。节点把它的模型指向一个中继，中继把每次调用交给 Verse，Verse 只会把它发往该模型已配置的地址，并在那里加上真正的密钥。因此节点上的智能体使用的是 Verse 自己的模型，而 Verse 不在线时，它们根本无法连接到任何模型。
• 运行。仅限本地的请求绝不会发往另一台电脑。离线的节点会立即让它的这一步失败并给出原因；在运行期间失联五分钟的节点也会让这一步失败。如果运行结束时 Verse 不在线，节点会把结果保留一小时。
• 批准。节点上的智能体在做“别人看得到的改动”及以上的事之前，仍然会先询问。Verse 会把它们以“在 office 上：……”的形式列在需要你的许可中，你的决定会回传给节点。
• 只能通过窗口。节点中心运行在桌面应用里，所以带有节点的看板无法通过终端命令保存。

工具

工具在设计上就很窄：读取和写入工具是分开的，没有通用的 shell、SQL、HTTP 或文件工具。注册一个工具不会把它授予任何人。

每个步骤的提示词最多列出 16 个工具，按它们与目标和该步骤的匹配程度排序，该步骤自己的工具始终保留。工具可以对所有人或某个角色关闭，网关同样会拒绝已关闭的工具。网页搜索会交给 Brave、Tavily 或 Exa，最多返回 20 条结果。

在 Verse Agent 应用中，只授予书记员的四个工具。构建、测试、代码检查和 git 工具在那里保持关闭，因为它们会运行项目自己的命令。

连接

连接通过 MCP 服务器把外部服务的工具带进来。连接送回来的任何内容都不会被自动信任，它和其他内容一样要经过同样的检查。会在现实世界里切换东西的连接，比如 Home Assistant，除读取之外的每个操作都要先征得你的许可。

• 密钥由操作系统加密封存，并绑定到所属服务器、变量名称和服务器配置的指纹。如果配置变了，密钥就不会被提供。
• 每个服务器都以最小的环境启动，所以没有服务器能看到其他服务器的密钥或模型密钥。
• 因缺少密钥或配置改变而无法运行的服务器会保持关闭并显示原因，而不是让整个平台停下来。
• 给智能体一个连接，会加上该服务的工具，以及一条允许这些工具做到“别人看得到的改动”为止的规则，所以达到或高于这个级别的操作仍然要等你决定。服务的修改操作要经过预览、批准、应用三步，而应用总是需要有人确认。收回访问权限时，只会移除当初加上的那些规则。
• 每个导入的工具在重启后或每 5 分钟都会重新列出自己的定义，如果服务器偷换了定义，调用就会被拒绝。

模型

由模型来思考。默认是你电脑上的一个小模型。你可以添加线上模型来处理更难的工作，并选择有多少任务交给它。不管怎样，私密内容都只留在你的电脑上。

能在你电脑上运行的大小

路由。0 到 100 的倾向值决定有多少请求发往线上：0 表示只用本地，是硬性禁止；100 表示只用线上；介于两者之间表示一次调用发往线上的概率。每个角色可以有自己的倾向值。只有遇到暂时性故障（如超时、速率限制或服务器错误），或提示词太长时，调用才会转到另一层。被拒绝的密钥或错误的请求会如实报告，绝不会为了“修复”而把你的提示词发到别处。

等级。角色也可以被赋予一个等级：低级为仅限本地，中级为一半一半，精英级为仅限线上。等级优先于角色的倾向值，角色的倾向值又优先于整体倾向值。

Verse AI 增加了什么

Verse AI 是平台自己的模型 API，来自本站：OpenAI Chat Completions，加上智能体对每次调用所了解的信息。

只有它可以使用的工具

回复的格式只允许这个智能体可以使用的工具，以及每个工具确切的输入

按每一步的需要决定思考深度

推理力度随这一步的深度而变

复用已经读过的内容

给每一步都会重复的指令用的缓存键

知道是谁在提问

每次调用都会说明它的目的、智能体的角色、任务，以及是否必须留在本地

太长的会转去别处

对模型来说太长的提示词会转给另一层，而不是失败

备用模型

当本地模型和线上模型都无法回答时，Verse 会改用一个在应用内、运行在你显卡上的小模型来交谈。它不能给智能体安排工作，常用的模型恢复后它就会被卸载。

应用启动时会在你提第一个问题之前预热本地模型；在它准备好之前，Verse 自己处理命令和闲聊，并告诉你它还没完全醒来。

记忆

有三种相互独立的记忆，外加技能。

Verse 对你的了解

只存在于这台电脑上的小型向量库。只有当一条事实的大部分词是你这一轮或上一轮说过的内容，并且不像是机密时，才会被保存；近似重复的内容会刷新旧事实，而不是新增一条。最多六条相关事实会作为依据交给模型，除非你要求，Verse 绝不会复述它们。

智能体知道什么

长期记忆分为六个命名空间，只有一个入口：检查来源、去重、检查矛盾，然后搁置或提升。智能体永远无法提升自己的记忆，只有经过验证的记忆才会交给模型。

共享看板

智能体在任务期间互相传递的信息，每一项都有评分，过时或不确定的会下沉。

技能

带测试和权限清单的可复用程序。只有已验证或受信任的技能才能使用，并且在沙箱中运行。

批准与安全

智能体自行工作，直到某一步会改动重要的东西。每个操作都有级别，足够大的操作会等你决定。每处改动都会被检查；没通过检查的改动会被撤销。一切都有记录。

• 智能体何时必须询问：最后两个级别一定要等人来决定，超出该智能体自身上限的操作也一样。听起来很有把握的模型也无法调低级别或跳过批准。
• 从别处复制的内容：如果某个操作用到了来自不可信内容的东西（比如从网页复制的邮箱地址），而不是来自你的请求，“允许”就会变成“询问你”。
• 一次批准绑定的内容：操作本身、它的参数、它的目标、所用的工具和智能体的权限，这些的指纹。如果其中任何一项在执行前发生变化，就会被拒绝，智能体必须重新请求。请求 24 小时后过期。

每个操作都要经过的环节

1. 检查格式
2. 评估风险大小
3. 规则，默认拒绝
4. 你的许可（如果需要）
5. 一次性许可
6. 输入界面
7. 准备
8. 运行，在沙箱中或作为事务
9. 输出界面
10. 独立检查结果
11. 保留，或撤销
12. 把它记下来

筛查

进入时：任务是否一致、参数大小、试图逃出范围的路径、网址（私有地址和云元数据地址在连接时就会被拒绝）、机密、SQL 范围和速率限制。输出时：泄露的机密和过大的输出会被拦截，看起来像被注入的指令的文本会被标记为不可信。

信任级别

每一段上下文都带有一个级别：0 是不可信的外部数据，1 是检索到的内部数据，2 是智能体的观察，3 是你的指令，4 是系统策略。只有级别 3 和 4 可以作为指令，这一点由代码的类型来强制保证，而不是靠好言好语请模型遵守。

沙箱

代码在隔离的工作文件夹中运行，环境变量已清空，默认没有网络，并有资源限制。容器沙箱（无网络、只读根目录、放弃所有权能）在三种操作系统上都是真正的边界。

始终开启

除非有规则允许，否则什么都不允许。任何无法撤销的操作都会先问你。听起来很有把握的智能体也必须询问。

终端命令

verse-agent 是没有窗口的 Verse，可在任何终端中使用。它需要 Node 22.18 或更新版本，以及已构建的平台。它的命名是 verse-agent 而不是 verse，所以不会遮盖其他工具。

在聊天中，用 @scribe 开头的一行会把工作交给书记员。窗格的拆分方式和 tmux 一样：按 Ctrl+B，松开后，按 % 左右拆分，按 " 上下拆分。当智能体需要你的许可时，“需要你”窗格会自动打开，不会打断你正在输入的内容。

更新和分发

• 平台以带版本号和校验和的软件包形式发布：十个 NuGet 包、可运行的 API 和 worker 压缩包（需要 .NET 10 运行时）、一个 Python wheel 和 sdist，以及一个 npm 包。每个包都按使用者安装的方式做过冒烟测试。
• 容器：独立的非 root API 镜像和 worker 镜像，以及一个包含 PostgreSQL、OPA、OpenTelemetry 收集器和一个替身模型的 compose 文件。
• Verse Agent 提供安装程序，支持 Windows（安装给单个账号，并将 verse-agent 加入其 PATH）和 Linux（一个 .deb 和一个 AppImage）。它们包含应用、终端命令、内置 .NET 运行时的平台构建，以及 Verse Node 安装程序，总共约 1 GB。
• Verse Node 有自己的安装程序，支持 Windows（为所有账号安装，并带有一条仅适用于专用网络的 Windows Firewall 规则）和 Linux（一个 .deb 和一个 AppImage），每个约 140 到 180 MB。
• 没有 macOS 安装程序，安装程序尚未进行代码签名，而且不会自动更新：你需要安装较新的安装程序，或拉取源代码后重新构建。从源代码运行时，操作与之前相同：npm install（同时会获取语音、听觉和记忆模型），npm run platform:build，然后是 npm start。请在下方的下载中获取它们。

各个部分及其如何通信

• 应用会在本地端口上启动平台，使用一个 48 个字符的新密钥，这个密钥绝不会给窗口看到；它会关闭随附的开发者密钥，并在平台崩溃时最多重启三次。
• 窗口永远看不到密钥或端口。每次调用都是一条消息，只接受来自应用自己页面的，并检查 ID，文本上限为 2,000 个字符。
• verse-agent 命令在普通 Node 中运行同样的监督器和伙伴代码，也可以连接到正在运行的 verse-agent serve。
• 另一台电脑上的 Verse Node 通过加密的 WebSocket 连接到应用主进程中的中心。平台通过 127.0.0.1 上的网关把步骤交给节点，每次启动都使用新的令牌。

一个中央模型，多个有界智能体

一个大型中央模型协调许多较小的智能体。每个智能体都有受限的自主权、有类型的状态、短程规划器、本地记忆、自己的工具、对自身不确定性的估计、对自己工作的检查，以及求助的办法。模型返回的内容始终只是一个经过严格解析的决定：执行、修改计划、完成或升级。模型从不直接调用工具。

C# 解决方案有十三个源码项目（包括测试台命令），另有四个测试项目和三个示例，边界严格：核心逻辑从不引用模型 SDK、数据库库、Web 框架或工作流引擎。

循环

1. 查看
2. 更新认知
3. 计划
4. 提出一个操作
5. 验证
6. 授权
7. 运行
8. 检查
9. 更新状态
10. 保存检查点
11. 继续、完成或升级

• 步数、工具调用、Token 和时间的预算都是硬性的。只有当回答仍在预算之内，模型调用才会被放行，辅助智能体最多只能得到其上级剩下的部分。
• 重复同一个提案或毫无进展，都会被发现并终止这次运行。
• 只有每个可由机器检查的目标都达成，才算完成。糟糕的完成或糟糕的计划会被退回，并记录这次拒绝。
• 操作发出之前，会先保存决定。崩溃后会进行核对：已记录的结果会被复用，确定从未发出的操作会重新发送，任何不明的情况都会停下来等人处理。可能已经发生的副作用绝不会重试。

动作网关

从决定到真实效果的唯一路径。每个阶段都可以说不，而默认就是不。

• 提案 ID 由运行时生成，绝不取自模型，并且一个提案最多只运行一次。
• 如果工具能从参数中算出它真正的目标，就会在任何检查之前取代模型给它的标签。会改动内容却算不出目标的工具会被拒绝。
• 暂存之后只要出任何问题，就会在 30 秒内回滚，且只回滚一次。回滚失败时会如实报告。
• 两个对同一事物的写入同时发生时会立刻失败。每个智能体的真实过往记录会反馈到它的操作看起来有多危险上。

持久的任务、状态转换和检查点

每个幂等键只接受一次任务，失败后带退避重试（默认三次），反复崩溃后会被搁置，等待批准时则暂停。每个批准只会决定一次，然后任务从它的检查点继续。每次状态转换都按顺序存储，且绝不改写。

检查点带有一个版本号，用作隔离令牌：两个工作者恢复同一个任务时，只有检查点写入成功的那个才可以行动。Verse 会读取平台自己记录的、你可查看的最近十个任务，所以当你问“出了什么问题？”时，它会用通俗的话说出失败的步骤和确切的错误，绝不瞎猜。

平台的 API

每条路由都在 /api/v1 之下，需要操作员或批准者的密钥，并且按密钥限速（默认每分钟 120 次请求）。其他租户的对象会回答“未找到”，所以 ID 不会泄露。

一轮对话，从头到尾

1. 你说话或打字。Moonshine 把语音转成一行文字，应用检查其中有没有命令。命令会立刻处理。
2. 否则，窗口会发送你的消息、最近 12 轮对话和近期活动。主进程会回想最多六条关于你的事实，并请平台给出回复。
3. 平台构建模型的上下文：人设和说话规则作为系统策略，你的消息作为你的指令，对话和记住的事实作为数据，智能体的工作作为观察。它和智能体经过同一个模型运行时，所以适用同样的模型选择和隐私规则。
4. 回复包含要说的话、最多五条要记住的事实、最多两个话题，以及可选的交给智能体的工作，这会变成一个真实的任务。
5. 提出的事实在存储之前，会与你以前说过的话进行核对。
6. 窗口会把回复缩短后用于语音，并朗读出来。

数据存放位置

章程、任务或工具的输出都可以把数据标记为仅限本地。一次运行取这三者中最严格的一个，并一直保持：一旦看到仅限本地的输出，这次运行之后的每次调用都留在本地。仅限本地的工作只会交给本地模型，绝不上线，作为备用也不行，通过倾向值也不行，征求第二意见也不行；如果没有本地模型，就会被拒绝。在应用里，这就是把私密内容留在这里，它始终开启。

安全和密钥

应用

窗口运行在沙箱中，无法访问 Node，只有一个最简桥接，从不暴露平台密钥。不弹出窗口，不跳转到别处，内容安全策略严格，除麦克风外的所有权限都被拒绝。

模型密钥

由操作系统加密（Windows 上用 DPAPI，macOS 上用钥匙串，Linux 上用 GNOME Keyring 或 KWallet），仅所有者可访问，并绑定到该文件夹和账号，所以复制到别处无法读取。服务器地址与密钥一起封存，所以编辑文件无法改变它的指向。窗口只能看到最后四个字符。

说得直白

以你身份运行的程序可以请求操作系统解密。加密保护的是静止状态下的文件：副本、备份、其他账号和其他电脑。

平台

默认拒绝且故障时保持关闭的策略、结构化的信任级别、一次性许可、进出两个方向的筛查、事务性回滚、留待审核的记忆、锁、幂等运行、只增不改的审计、固定的 MCP 定义，以及与确切操作绑定的批准。生产环境中没有默认凭据。

持久化与可观测性

• 平台的记录在生产环境存入 PostgreSQL，测试时用 SQLite，开发时用内存。审计、状态转换和用量记录都只增不改。
• 在 Verse Agent 应用中，平台把记录保存在内存里。任务、历史记录、批准记录、智能体的记忆和共享看板只在平台运行期间保留，重启后会清空，包括更换模型、密钥或连接后的重启。Verse 对你的记忆、已保存的密钥、连接开关和设置都存在磁盘上，会保留下来。
• OpenTelemetry 的 span 和指标只携带 ID、大小和哈希值。应用会关闭遥测。
• 评估：无副作用地回放已记录的运行、AgentDojo 风格的注入基准测试（实测攻击成功次数：0）、工具使用基准测试，以及在三种语言之间对比的 46 项故障注入检查。

三种语言，同一种行为

C# 平台是参考实现。Python 移植版（3.11 或更新版本，仅用标准库）和 Node.js 移植版（TypeScript，Node 18 或更新版本，没有运行时依赖）是整个核心忠实的、独立测试的副本：循环、网关、筛查、策略和许可证、记忆、技能、编排、每个模型提供商和 MCP。它们共用一种配置格式、一套策略、相同的测试向量和相同的故障注入检查。Verse Agent 应用运行的是 C# 构建。

技术栈和版本

操作系统

平台可在 Linux、macOS 和 Windows 上运行，其 CI 在这三者上构建并测试。Verse Agent 通过 Electron 的 Chromium 在这三者上运行。在 Linux 上，备用模型需要 VERSE_WEBGPU=1，保存密钥需要 GNOME Keyring 或 KWallet；在 macOS 上必须允许使用麦克风；Windows 终端没有 tmux，所以 verse-agent tmux 使用它内置的窗格。安装程序只为 Windows 和 Linux 构建。Verse Node 提供 Windows（x64）和 Linux（x64 的 .deb 和 AppImage）安装程序；Mac 则从源码检出目录运行节点。

测试

构建和运行

下载

Verse Agent 0.1.0、Verse Node 0.1.0 以及平台发行版 1.1.1：即本页所述的版本。请将任何下载与以下内容核对 SHA256SUMS.txt.

许可证简述：个人和商业使用均免费，所以你可以用它构建和销售任何东西，但不得声称平台是你自己的，也不得把它当作你自己的产品或托管服务转售或再分发。

sudo apt install ./verse-agent_0.1.0_amd64.deb
verse-agent-desktop   # the app
verse-agent agents    # the terminal command

# or the AppImage, on any distribution
chmod +x Verse-Agent-0.1.0-x86_64.AppImage
./Verse-Agent-0.1.0-x86_64.AppImage
./Verse-Agent-0.1.0-x86_64.AppImage --cli agents

sudo apt install ./verse-node_0.1.0_amd64.deb
verse-node status     # the terminal command; the AppImage takes --cli status

# if ufw is on
sudo ufw allow 47800/tcp && sudo ufw allow 47801/udp

# point NuGet at the unzipped folder
dotnet nuget add source /path/to/downloads/csharp/nuget --name agentplatform
dotnet add package AgentPlatform.Infrastructure

pip install agent_platform-1.1.1-py3-none-any.whl
python -c "import agent_platform; print(agent_platform.__version__)"

npm install agent-platform-1.1.1.tgz

每个版本开箱即可离线运行，使用内存存储和一个按脚本运行的模型：试用时不需要 API 密钥或数据库。