关于 Ava Supernova

什么是 Ava？

Ava 是一位真正能做事的 AI——不只是会聊天。她会为你构建应用、撰写文档、从零教你知识、设计 Logo，或者处理那些你一直拖延的琐事。而且她记得你：你在做什么、你喜欢什么风格、上周你问了什么。

只有一个 Ava，她随你而动——无论是在代码编辑器里、作为桌面应用，还是在终端中。记忆不变，性格如一，无处不在。

她的独特之处

• 默认属于你。你的工作保留在你自己的机器上。不追踪，不遥测——永远如此。
• 对所有人开放可见。Ava 的每一行代码都是公开的。无需盲目信任。
• 免费开始。每月 300 积分，无需信用卡，没有套路——或者接入你自己的 AI 密钥，完全不用付钱给我们。
• 内置教学功能。让 Ava 教你任何科目，她会为你构建真正的课程——包含课程、示例和测验。

从未写过代码？下一页是专门为你写的。已经懂技术了？直接跳过去——她能跟上你的节奏。

从未写过代码？从这里开始

如果你从未写过一行代码，那你正是 Ava 的目标用户。开始不需要学习任何术语——你用日常用语和她交谈，就像问一位博学的朋友一样。这一页就是你全部的入门途径。

今天就能做的事，无需经验

• 用平常的话问她任何问题——“这个文件是做什么的？”、“为什么我的页面是空的？”、“数据库到底是什么？”她用通俗的语言回答，并记住对话内容。
• 从零学点什么——说“从零教我 Python”，她会为你构建一门包含课程和测验的正规课程。
• 把东西做出来——描述你想要的（“一个下载我笔记的按钮”），她会写出来，并在发生前向你展示每一个改动。

你不必理解所有细节

Ava 背后有很多机制——模式、模型、专家、路由。你会在应用中和这些文档里看到这些词。秘密是：你可以忽略几乎所有这些。Ava 会自动为你选择正确的工具和助手。技术页面是为了当你好奇时查看，而不是因为你开始时需要它们。

一条温和的起步路径

1. 安装 Ava（见下一页），然后打开聊天。
2. 输入你真正关心的问题。什么都行。看看她怎么回答。
3. 试试学习模式：输入“教我”和一个主题，然后跟着操作。
4. 当你想让 Ava 真正动手制作或修改内容时，直接告诉她就好——她总会先展示计划做什么，然后等待你说“好的”。

安装

选择最适合你工作习惯的界面。你可以同时使用多个——在同一台设备上，它们会共享同一个 ~/.ava 文件夹，这样 Ava 的记忆就能在它们之间无缝跟随你。

VS Code 扩展

1. 在 VS Code 中打开扩展面板（Ctrl+Shift+X / Cmd+Shift+X）。
2. 搜索“Ava Supernova”并点击安装。
3. 按 Ctrl+Shift+A（macOS 上是 Cmd+Shift+A）打开聊天面板。
4. 跟随设置向导操作——选择一个模型，设定权限模式，完成。

桌面 IDE

1. 从发布页面下载适用于你平台的安装程序。
2. 运行它。首次运行时，IDE 会启动欢迎流程。
3. 登录获取免费平台额度，或者粘贴你自己的 API 密钥以完全本地运行。

CLI

1. npm install -g @ava/cli（或 pnpm / yarn —— 由你决定）。
2. 在任何项目目录中运行 ava。
3. 首次运行时会提示你选择提供商和模型。选好即可开始。

初次使用 Ava

让 Ava 快速上手的最好方法，是直接让她处理一件实事，然后看着她完成。无需阅读配置说明，也无需预先学习——只用大白话告诉她你想要什么。

现在就试试

1. 打开聊天界面。
2. 输入你真正想要的指令。试试“解释这个项目是做什么的”，或者“添加一个能清空表单的按钮”。
3. Ava 会向你展示她打算做什么——然后静静等待。
4. 满意吗？说“是”。看着她完成。

这就是完整的互动节奏：你提问，她展示计划，你确认，她执行。她绝不会在未先展示的情况下修改任何内容——这样你就无需担心尝试时会弄坏什么。

值得询问的几件事

• 一个问题 —— “为什么我的页面是空白的？”，“这个文件是做什么用的？”
• 构建一些东西 —— “帮我做一个简单的待办事项页面”。
• 学习一些东西 —— “从零开始教我 Python”。她会为你打造一门真正的课程，一步步来。
• 一份文档 —— “帮我写一份单页项目提案”。她会提供一份 Word 文件或 PDF。

本地与云端，一段话说明

Ava 保存的所有内容都在本地。记忆、任务、日记、个性、设置——全部存储在你设备的 ~/.ava/ 和 .ava/（每个项目）中。她会通过 HTTPS 连接模型服务商来执行你的请求，完成后就回家。她不会主动联系服务器。她不会收集遥测数据。她也不会基于你的代码进行训练。

如果登录，你每月可获得 300 个免费额度，适用于两套阵容——基于 Qwen 的 Maestro，以及由 DeepSeek 协调的 Supernova。登录绝不会上传你的记忆、任务或设置——没有云端同步。只需自带 API 密钥，Ava 无需账户也能完全正常工作。

我需要选择 AI 吗？

好消息：你不必挑选 AI。Ava 会自动为每一步匹配合适的模型，让你轻松获得好结果，无需费心思考。

唯一能由你选择的是路由风格——默认模式适合绝大多数人。只有在特定需求下，才需要用到其他模式。

两种模式

• Maestro —— 默认模式。稳定、可靠、可预测。拿不准？选这个准没错。
• Supernova —— 适用于繁重的多步骤任务，将不同专家分配到任务的各个部分往往效果更好。

随时可通过聊天顶部的模型选择器切换。没有任何限制。

通俗词汇表

关于 Ava 你可能碰到的每个词，都按零基础水平解释。不用死记硬背——遇到任何术语看不懂时随时翻回来查。

路由 —— Ava 如何挑选模型

简短版：你无需决定使用哪个 AI 模型。Ava 替你完成，为工作的每一部分选择最佳工具——就像一位优秀的经理将合适的任务交给合适的人。

您可以从两种模式中任选其一——Maestro 或 Supernova——Ava 会将每项任务发送给最擅长处理该任务的模型。Maestro 是默认选项，在所有计划中均启用，对大多数人来说都是不错的选择。

为什么要路由？

为每个步骤匹配正确的模型，比将所有任务交给一个昂贵的大模型成本更低——且效果更佳，因为每个模型都发挥其所长。你能获得稳定的成本和高质量，却无需关心具体使用的是哪个模型。

Ava 积分 —— 计费说明

积分只是 Ava 计算你用量的一种方式——就像手机套餐里的分钟数。每个计划（包括免费版）都附带一个积分池，Ava 做的每件事（回答你、生成图片）都会消耗少量积分。这就是核心概念。下面的详情供你想确切知道每项花费时使用。

Ava 使用积分计费，而非原始 token。（“token”是极小的文本块——大约几个字母——AI 模型据此读写；大多数服务按 token 收费，难以预测。）一个积分覆盖一个工作单位——一次聊天回合、一个人格实例化（一个助手完成部分任务）、一次图像生成。与 token 级计量解耦意味着你无需知道运行的是哪个模型，就能知道某项操作的成本。无论 Maestro 将其路由到 Qwen 3.7 Plus 还是 Supernova 将其路由到 DeepSeek Flash，同样的聊天回合成本相同。

计划

每个计划都能访问所有功能——模型访问、Creative Studio、全部七种模式、完整的人格编排。更高阶梯购买更多积分和更高的速率限制上限，而非解锁新功能。

• 免费 —— 每月 $0。300 积分。每分钟 20 次请求速率限制。无需绑定卡片。
• 专业版 —— 每月 $19。5,000 积分。每分钟 60 次请求。
• 超能版 —— 每月 $39。10,000 积分。每分钟 120 次请求。
• 企业版 —— 每月 $79。20,000 积分。每分钟 200 次请求。

各项费用

按操作计费表——每项操作运行时从你的积分池中扣除的内容。（“缓存命中”是指 Ava 重用已做的工作而非重做；发生这种情况时你支付更少——费用降低 70%，或在 DeepSeek Flash 等输出密集型模型上降低 50%。）

• 对话回合 —— 2 积分。任何模式下的单次来回。
• 轻量调用 —— 1 积分。意图网关、分类、单次读取。
• 重型角色 —— 3 积分。架构师、研究员、CVE 研究员、创意者（深度 ≥ 4）。
• 轻型角色 —— 1 积分。侦察兵、验证者、序列生成器、挑战者（深度 ≤ 2）。
• 编排 —— 10 积分。完整角色流水线启动（指挥者 + 多角色任务）。
• 图像生成 —— 12 积分。Creative Studio.
• 视频生成 —— 150 积分（720p），1080p 需 300 积分。Creative Studio，通过 Wan。
• 语音生成 —— 10 积分。Creative Studio，通过 Qwen3-TTS。
• 背景移除 —— 2 积分。

按模型计算的乘数

这部分是给好奇的你看的 —— 使用 Ava 并不需要它。乘数只是根据动作背后模型的昂贵程度来调整积分成本的高低，所以较重的模型会稍微贵一点。（“净利润”是项目在支付自身开销后保留的部分 —— 我们将其定得较低，以便价值更多地回流给你。）

每个模型都配有一个乘数，用来根据实际运行成本调整操作费用——轻量模型比标准档便宜，重型模型则更贵。我们的净利率目标设定在约 30%，此前曾从 55% 和 40% 逐步下调：每次目标降低，所有乘数都会随之下降，省下的钱就回到您口袋里。

• 1.0× — 任何未列出乘数的模型。基础费率。
• 舰队本身不增加额外费用。每种路由方式设计均为 1.0×；回合成本完全来自实际使用的模型。这就是为什么将舰队切换到更便宜的主模型会降低收费，而无需更改价格。
• 关于 DeepSeek 有一点说明：它在 UTC 时间 01:00–04:00 和 06:00–10:00 期间收费翻倍。此处及成本计算器中列出的所有 DeepSeek 价格均为非高峰时段价格，适用于每天 24 小时中的 17 小时。

BYOK 与信用额度

BYOK（"自带密钥" —— 你提供自己在 AI 提供商处的账户和密钥，这是一个私有的密码，允许软件使用该付费账户）适用于已经直接向 AI 提供商付费的人。如果你不属于这种情况，完全可以忽略本节内容。

自带密钥请求完全绕过了平台基础设施——请求直接从 Ava 直达提供商，由你直接向提供商付费，不会消耗信用额度。唯一的例外情况是：当 BYOK 会话为子任务启动托管层角色时；因为用到了 Ava 的编排服务，所以仍需扣除信用额度。

如何查看余额

• 扩展程序 — 设置 → 账户，或聊天标题栏中的信用胶囊。
• IDE — 账户仪表板磁贴显示当前余额和消耗速率。
• Web — avasupernova.com/dashboard 显示余额、历史记录和续订日期。

模式 — Ava 的思维状态

模式就是 Ava 当前的思维状态 —— 就像同事换帽子一样。还是同一个人，对你的记忆也一样，但建设者的思考方式与教师不同。你选择模式，它就会改变她的行为方式和带来的助手。随时通过模式选择器切换，或输入两字符快捷键。

你想要哪一个？

从你想做的事情开始 —— 模式由此决定：

• 我想构建或修改某物 → 代码 (>>)。你描述它，她来构建，先向你展示每一个改动。大型任务会启用完整的助手团队。
• 我想在更改前制定计划 → 计划 (::)。她会深思熟虑后交给你一份计划供批准或编辑。在此模式下，她不会触碰你的文件。
• 我只是想聊聊或提问 → 聊天 (..)。一位拥有记忆、新闻和天气功能的思考伙伴。不修改文件，不写代码 —— 只是对话。
• 我想学习一些东西 → 教学 (??)。为你量身定制的真实课程：课程、测验等应有尽有。所有计划均可使用。如果你是新手，这非常适合。
• 我想检查项目是否存在安全漏洞 → 安全 (!!)。团队会对照标准常见 Web 漏洞列表（即“OWASP”类别）和已知报告缺陷（称为“CVEs”），然后交给你一份按问题严重程度排序的报告。此功能面向开发者 —— 如果你不是，可以跳过。
• 我想要点子 → 头脑风暴 (**)。她根据你实际情况生成选项，指出薄弱之处，并将其余部分完善为后续步骤。
• 我想撰写文档 → 写作 (<<)。报告、提案、信件、文章 —— 她用 Markdown 起草并导出带有品牌标识的 Word 文档或 PDF，逐节完善。没有代码，只有写作。

记忆 —— Ava 如何记住您

简单来说：Ava 记得您。告诉她一件事——您喜欢什么，您做的决定——她会记住，这样您在下次聊天或下周就不用重复了。这就是核心要点。下面的内容只是解释她如何随着时间的推移保持记忆整洁。

Ava 拥有持久记忆（“持久”指的是即使你关闭了应用，它也会保留），它能贯穿不同的对话和项目，且仅存储于你的设备中。它不是简单的聊天记录。它是一种结构化的、可检索的理解，记录着你是谁、你喜欢什么，以及你做过哪些决定。

五个层级

1. 提取 — 实时捕获每条消息中的关键事实。
2. 反思 — 在有意义的会话结束时进行更深入的分析。模式、主题、矛盾点。
3. 积累 — 修正和偏好随数周数月不断累积。
4. 分析 — 图引擎关联相关记忆，当新信息与旧信息冲突时标记矛盾。
5. 整合 — 相似记忆合并；过时记忆修剪。记忆随时间变得更精准，而非更嘈杂。

检索

当你提问时，Ava 通过含义搜索记忆（“语义搜索”——它理解你的意图，所以即使措辞不同也能找到正确的记忆），而不仅仅是匹配确切单词。模式特定过滤器同时运行 —— 聊天模式调用个人上下文，工作模式调用项目决策和代码模式。

任务与日志

Ava 会为你记录三种类型的笔记，很容易弄混。简单记法：记忆是她对你了解的内容，任务是待办事项，日志则是记录事情经过的日记。下面说明何时使用哪一种。

• 记忆 —— 持久的事实。包括偏好、决策和行为模式。通常由系统根据交互积累，很少手动创建。
• 任务 —— 待办事项。带有截止日期和状态的具体行动项。完成后打勾即可。
• 日志 —— 反思记录。每日流水账，包含双方条目（你的记录和 Ava 对会话的观察）。有助于情绪追踪、会话复盘，并为明天提供背景信息。

只要合适，Ava 会自动同步更新这三类笔记。你也可以直接从仪表盘向其中任意一项写入内容。没有任何数据被锁定在单一位置——你在一个地方创建的任务（例如命令行工具），会自动出现在其他所有地方（如桌面应用）。

权限设置 —— 你的安全调节旋钮

权限就是你的安全调节旋钮。它决定了 Ava 是在电脑操作前征求你的许可，还是直接执行。你可以设置为询问所有操作、仅询问高风险操作，或直接信任她全权处理——而且随时可以更改。如果不确定，保持默认设置即可，这样最稳妥。

Ava 拥有超过 120 个工具（"tools" 指她能执行的操作，比如读取文件、搜索网络等）。每个工具都归入一个类别（文件操作、Shell、Git、Web、媒体、数据库、系统、文档、记忆、学习）。每次调用工具前都会经过权限关卡（一个决定是否需要先征求您同意的检查点）。您可以自主决定哪些操作自动通过，哪些需要询问一次，哪些必须每次都问。

“平衡”是默认设置。“严格”模式适合审计她的行为（仔细检查每一步）。“自主”模式则适合希望她放手去做的场景。

引导与中止 Ava

你永远掌握主导权。当 Ava 忙碌工作时，你可以轻轻引导她转向新方向而不打断进度，也可以立即叫停。两个按钮，两种结果——这就是本页面要介绍的全部内容。

Ava 会一直运行，直到她的计划完成或你停止她。在她运行时，你有两种方式介入（这个词叫做“干预”）。

介入 —— 引导而不取消

在 Ava 工作时输入新消息。她会先完成当前的工具调用，读取你的消息，然后调整计划。不会丢失任何上下文。当你想要重定向、补充信息或在运行中更改优先级时使用此功能。

硬停止 —— 取消并清空

按 Escape（CLI）、点击停止（扩展程序、IDE），或输入停止命令。当前运行会被取消，待处理的工具调用也会终止，对话准备好迎接新的回合。

桌面角色

本页面适合好奇者和高级用户。“桌面自动化”（有时称为“电脑操作”）意味着 Ava 实际上可以在你的屏幕上点击并使用应用——打开 Gmail、填写表单、发送消息——就像一个人坐在键盘前一样。为了安全地做到这一点，她将工作拆分为五个小助手，每个助手只有一个狭窄的角色。你永远不会直接与它们打交道；这里只是为了让你知道谁负责什么。

桌面轨迹中的每一步（Ava 驱动你的屏幕朝向目标的一次运行）都会经历一个五角色流程。每个角色只有一份工作，且仅此一份。这种分离确保提示紧凑、输出结构化，并且推理设计为保持审慎。

侦察兵

报告当前屏幕上可见的内容。从不虚构元素。从不规划。返回包含元素 ID、名称、边界框、置信度和依据来源（UIA、Playwright DOM 或 OmniParser 视觉）的 ScreenState JSON。

规划师

决定单个下一步动作。每步仅一个动作——绝不批量处理。偏好可逆路径。根据安全本体论对风险进行分类。输出包含类型、目标、参数、风险类别、推理和预期后状态预测的 ProposedAction JSON。

执行者

精确执行规划师提出的内容——在审批门通过之后。不即兴发挥。不重试。失败如实报告，由验证器处理下一步。

验证器

检查动作是否成功落地。将新的 ScreenState 与规划师的预测进行比较。返回已验证、偏离或需要回滚。还运行循环检测——重复已经成功的动作属于偏离，而非验证。

叙述者

用户在轨迹期间听到的唯一声音。每步一句过去时句子（“打开了 Gmail。”，“点击了撰写。”）。还编写结构化的审计日志。当出现问题时会说明——从不隐藏问题。

桌面安全本体论

简而言之：在 Ava 点击屏幕上的任何内容之前，她会按风险程度对动作进行分类。读取屏幕？无害。发送资金或删除内容？她总是先停下来问你——每一次，绝无例外。下面的五个标签只是这个风险梯子的阶梯。这是高级用户的细节，但要点很简单：危险的事情总是需要你的同意。

每个提议的动作都被归类为五种风险类别之一。分类结合了三个信号——屏幕上的目标是什么、它的通俗描述（“语义标题”——Ava 对自己正在看内容的描述）以及动作的设置——当它们不一致时会上调（视为风险更高）。误报（不需要问却问了）只是唠叨。漏报（应该问却没问）则是导致产品终结的事故。

五个类别

• 观察性 —— 读取 UIA 树、截图、悬停。始终自动允许。
• 导航性 —— 滚动、移动焦点、打开菜单。在驾驶模式下自动允许。
• 可逆变更 — 输入文本、粘贴内容、打开应用、访问网址。在“询问模式”下需确认；在白名单内的 Drive 中则自动执行。
• 不可逆变更 — 发送、提交、支付、删除、确认、发布。无论权限等级如何，始终需要确认。授权记录永不缓存。
• 特权操作 — UAC 提权、sudo、注册表编辑、凭据请求。默认禁止。每个会话需单独进行单次授权。

永不缓存的授权

所有竞争对手都会缓存授权（记住你的“同意”并在下次重用）。这是提示词注入最大的突破口——一种攻击方式，恶意网页会悄悄向人工智能植入隐藏指令，让它做出损害你的行为。如果授权被缓存，一旦网页被攻破，它就能利用你之前给出的“同意”。Ava 从不缓存。每一次不可逆操作都会重新询问。

敏感信息处理

密码、API 密钥以及 2FA 验证码（登录时由其他应用或短信发给你的单次代码）均通过不透明句柄处理——即代表真实值的占位符。Ava 看到的是 "{secret}"，而非真实密码。真实值永远不会进入她的记忆、活动日志或她“读取”的内容——有一个独立的底层机制会在最后一刻、按下按键时直接输入，确保人工智能核心永远接触不到它。

桌面定位层级（预览版）

在 Ava 点击按钮之前，她必须先真正理解屏幕上有什么、东西在哪里——这就是“定位”（弄清楚屏幕上每个元素是什么以及确切位置）。她有这三种方法，并会为你当前使用的 App 选择最可靠的一种。这是给高级用户的深层细节；核心点在于她偏好扎实准确的方法，而不是靠猜测图片。

分为三层，按顺序评估。成本最低且可靠的方案胜出。

1. 浏览器窗口 → Playwright DOM

如果活动窗口是 Web 浏览器，Ava 会读取页面自身的结构（“DOM”——页面上元素的底层列表），而不是从图片中猜测。读取结构比肉眼观察像素可靠约 10×——她能精确知道每个按钮的位置，以及页面何时加载完成。这是 Web 上任何操作的主要路径，而非备用方案。

2. 支持 UIA 的本地应用 → Windows UI Automation

对于 Windows 上的普通桌面应用，Ava 会读取内置的可访问性映射（“UIA”，屏幕阅读器用来描述窗口的相同数据）——它列出每个控件、名称及其位置。如果该映射返回至少五个可用且有名称的元素，她就信任并使用它。

3. UIA 为空或无效 → OmniParser 视觉

当该映射缺失或无效时（某些应用、游戏和远程屏幕不提供），Ava 会回退到实际查看截图。视觉工具（OmniParser）识别可点击区域并标记每个区域的内容，将图片转回她可以操作的列表——同时结合可访问性映射提供的少量信息。

桌面紧急停止开关（预览版）

“紧急停止开关”顾名思义——当 Ava 控制你的屏幕时，立即停止它的紧急方式。令人安心的是：有三个，各自独立构建，所以如果一个失效，另一个依然有效。你不必学习全部三个。只需知道当情况看起来不对劲时，你随时可以停止它，而最强的停止方式（下方的恐慌停止）不依赖 Ava 的配合。

在研究了所有公开的自主事故（AI 代理忽略停止命令、删除邮件存档、擦除驱动器的真实案例）后，我们在三个不同层级构建了三个紧急停止开关。它们都不依赖于 AI 模型本身——如果 Ava 卡住或无响应，你仍然可以停止她。

暂停 —— 空格键或暂停按钮

会在下一步的边界处暂停。可以恢复使用。当你想要介入干预，同时又不希望偏离当前轨迹时，请使用此功能。

停止 — 按 Escape 键或点击停止按钮

安全中止。叙述者会总结目前已完成的工作。无法恢复。审计日志会记录提交。

紧急终止 — 连按三次 Escape 或 Ctrl+Shift+K

这是最彻底的停止方式。它是一个独立的小程序（看门狗），会强制关闭正在控制你屏幕的 Ava 组件。它不会等待 AI 回应，也不需要应用窗口正常运行，不管系统处于什么状态——它直接切断进程。只有在情况真的不对劲时，才使用这个。

工具参考手册

这是 Ava 所有工具的完整清单——“工具”指的是她能执行的具体操作，比如读取文件或进行搜索。你不必阅读此页面。Ava 每次都会自动选择正确的工具。这里仅供你在好奇她具体能做什么时查阅。

完整的内置工具箱。此处列出的每个工具都已注册在核心运行时（即支撑所有三种界面的底层引擎）中，只要模式及权限允许，Ava 即可调用。可按类别或风险等级进行筛选。

无需记忆所有内容——下方的表格仅作为参考卡片。

风险等级

• 安全级 —— 只读取内容而不做任何更改。包括 `file_read`、`glob`（按名称模式查找文件）、`grep`（在文件内搜索文本）、`git_status`（Git 是追踪项目变更的系统）。
• 写入级 —— 修改文件、保存工作检查点（即“提交”），或生成新内容。包括 `file_edit`、`git_commit`、`generate_image`。
• 危险级 —— 在电脑终端（“命令行”）运行指令、控制桌面、访问互联网或查询数据库。包括 `bash`、`browser`、`desktop_*`。

模型列表

“模型”就是负责思考的 AI 大脑——例如 Qwen、DeepSeek、Mistral 等。本页面列出了 Ava 可用的所有模型。简单来说：你无需手动选择。Ava 会为每一步自动挑选合适的模型。除非你想了解细节或手动覆盖，否则无需继续阅读。

包含 Ava 可调度的所有模型，以及三种编排策略——即决定由哪个模型处理任务各部分的规则。你可以选择一个路由模式，让 Ava 自动分发任务；或者指定单个模型，完全跳过路由。

路由模式

两种精心编排的策略。相同的角色管道（Ava 在幕后运行的小型专家助手团队）在两者上都会运行；唯一变化的是底层的模型阵容。在模型选择器中挑选一种模式，Ava 就会处理其余一切。下方每张卡片展示了指挥者将任务分配给哪些专家成员。

无需记忆下方的卡片——它们的存在是为了让你了解每种策略由哪些部分组成。

平台托管的模型

适用于所有套餐，包括免费层级。Token（AI 文本计量的基本单位——大约相当于四分之三个单词）会计入您的套餐额度。密钥（用于解锁各付费模型的私密密码）由平台负责轮换与监控——您无需进行任何配置。

自带密钥

“API 密钥”是一种私密密码，允许软件以您自己的账户使用付费服务。“BYOK”即“自带密钥”——意味着使用您自己的密钥而非我们的。请在设置中粘贴您的 API 密钥。BYOK 请求直接从 Ava 发送至提供商（即运行模型的公司）——它们不经过我们的基础设施，也不会消耗平台 Token。费用由您直接向提供商支付；我们无法查看相关流量。

角色编排

“角色”是 Ava 在幕后为处理更难的任务而扮演的助手角色——例如探索者、规划者或事实核查员。您无需直接与它们交谈，也不需要理解此页即可使用 Ava。这里是为了当您好奇她如何将大任务分解为小专家团队时提供说明。

5 个模式团队共有 24 位专家。指挥者（负责协调其余部分的助手）决定哪个团队运行、以何种顺序以及使用何种上下文。聊天模式没有角色——它就是 Ava 本人。

编排如何运行

1. 您在“计划”、“教学”、“安全”或“头脑风暴”模式下发送消息（或复杂的作业请求）。
2. 指挥者读取请求，选择模式团队，并构建执行计划——某些角色按顺序运行，某些以并行波次运行。
3. 每个角色都有自己的系统提示词、受限的工具白名单，以及先前角色发现内容的共享上下文池。
4. 最终角色根据模式生成摘要、计划或报告。
5. Ava 向您展示结果。您可以批准、调整或重定向。

下面的完整名单仅供参考——无需记住谁做什么。Ava 会为您组建合适的团队。

CLI 命令

本页面专为 CLI 设计——这是 Ava 的命令行版本，你需要在终端窗口中输入指令，而不是点击按钮。如果你使用的是扩展程序或桌面应用，完全可以跳过此页。这里是为偏爱键盘操作的用户准备的。

CLI 是一个 REPL（一种交互式命令行界面）——它会等待你输入，执行你键入的内容，然后再等待下一次输入。这些斜杠命令（即以“/”开头的指令）都可以在提示符下直接使用。

• `/help` —— 查看命令列表及当前模式。
• `/mode <name>` —— 切换模式（工作、写作、规划、聊天、教学、安全、头脑风暴）。
• `/model <id>` —— 无需退出会话即可切换模型。
• `/clear` —— 清除当前对话记录。记忆内容保持不变。
• `/history` —— 查看本项目中的历史对话。
• `/memory` —— 打开记忆浏览器。
• /tasks — 列出并管理任务。
• /journal — 打开今日日记。
• /settings — 打开设置菜单。
• /exit — 退出 REPL。

启动参数

启动参数是您在启动 Ava 时添加的额外选项，每个都以"--"开头，用于设定她如何启动。

• --mode <name> — 以特定模式启动。
• --model <id> — 使用特定模型启动。
• --permission <mode> — 严格 (strict) / 平衡 (balanced) / 自主 (autonomous)。
• --project <path> — 显式设置项目根目录。

配置

此页面显示 Ava 在您的计算机上保存设置和文件的位置。您几乎不需要手动修改任何内容——应用程序会为您打理好一切。如果您想查看、备份或自行共享这些文件，这里会有帮助。

Ava 从两个范围读取配置（她保存的设置）。全局设置——适用于所有地方的设置——位于名为 ~/.ava/ 的文件夹中（"~" 是您的主文件夹的简写）。按项目设置的配置文件位于项目本身的 .ava/ 文件夹内。

全局 — ~/.ava/

• settings.json — 模型偏好、权限模式、性格、语言。
• memory/ — 您的全局记忆（适用于所有地方的偏好和决策）。
• tasks.json — 跨项目任务列表。
• journal/ — 每日日记条目，按日期组织。

项目 — .ava/

• instructions.md — Ava 始终加载的项目特定说明。持久上下文（“我们使用 pnpm，而不是 npm”，“API 密钥存储在 1Password 中”）。
• context.md — 可选的自由格式项目笔记。
• memory/ — 仅限此项目的记忆。
• datasets/config.json — 需主动开启的数据采集配置。

键盘快捷键

键盘快捷键是可选的提速技巧——每一个都有对应的可点击按钮。仅当您想通过键盘更流畅地操控 Ava 时才查阅此处。

按运行界面分类的快捷键（Ava 运行的三个位置：VS Code 扩展、桌面应用和终端）。在每个界面的设置中自定义它们。无需记住下面的列表。

项目上下文

这里说明 Ava 在开工前如何了解你的项目——她会查阅哪些文件来理解你的工作内容。你无需手动配置任何内容，她会自动完成。如果你希望放置一些笔记让她随时能看到，可以参考这里了解应该放在哪里。

当你打开一个项目时，Ava 会加载多个层级的上下文（她脑海中持有的背景信息）。了解这些层级有助于你将信息放在合适的位置。

自动加载

• .ava/instructions.md —— 被视为持久、高优先级的指导。始终包含在上下文中。
• .ava/context.md —— 自由格式的笔记。会被加载，但优先级较低。
• README.md —— 首次运行时扫描，用于获取项目摘要。
• package.json / pyproject.toml / Cargo.toml —— 列出项目配置的小文件；读取它们以检测语言、框架和测试命令。
• .gitignore —— 版本控制中要排除的文件列表；所有文件工具（glob, grep, project_index）都会尊重此规则。

按需加载

“按需”意味着 Ava 仅在任务真正需要时才获取这些信息，而不是提前全部加载。

• 项目索引 —— 你文件的结构化地图，包括其中的命名部分（函数、类 —— “符号”）以及它们如何连接（“导入”）。采用惰性构建，即仅在 Ava 需要时才生成。
• Git 历史 —— 过去变更的记录；当调用 git_status、git_diff 或 git_create_pr 时拉取（Git 是追踪项目所有变更的工具；“拉取请求”是提议的一组变更）。
• 记忆 —— 条目按含义（“语义上”）匹配，并逐次注入，而非一次性全部注入。

桌面预算上限

当 Ava 代表您操作桌面时——点击、输入、打开应用——每一次运行都被称为一个“轨迹”。本页说明了安全限制，确保单次运行不会耗时太久或花费过多。核心原则是：她绝不会擅自超时，而是会在超出前停下来向您确认。如果您想了解具体数据，这里都有。

每个“轨迹”都受三个同时生效的上限（硬性限制）约束。一旦触及其中任何一个，就会立即停止。轨迹绝不会在突破限制后悄悄继续——Narrator（那位帮您解说当前情况的助手）会暂停下来，询问您该如何处理。

三个硬性上限（默认值）

• 步骤数 — 30 步
• Token 预算 — 500,000 个 Token
• 实际耗时 — 5 分钟

任务成本档位

• 简单（搜索文档、打开页面）— 5–10 步，~70–135K Token，~$0.04–0.08
• 中等（登录、查看日志、下载输出）— 15–25 步，~205–340K Token，~$0.12–0.21
• 复杂（分类处理三个 GitHub 问题）— 25–30 步，~340–410K Token，~$0.21–0.25

上面的 Token 数值指的是单次运行的技术上限，不是您的月度额度——那是按积分计算的。免费版的每月 300 积分足以轻松应对聊天、写代码和少量自动化任务的组合。

桌面会话白名单

“白名单”是指您授权 Ava 在接管桌面时可以操作的软件及网站列表。本页说明如何授予这些权限，以及为何每次都会重置。简单来说：她只能在您允许的地方行动，去新地方前也会先问您。

在桌面会话开始时，Ava 会询问她可以在哪里行动。用大白话就行：“Gmail、Cursor、Azure 门户。”她会复述一遍并与您确认匹配结果（“Gmail 网页版、Cursor 应用、portal.azure.com”）。

执行方式

仅查看类操作——例如截图、读取屏幕上的按钮和字段列表（也就是“UIA 树”，Windows 对窗口内容的映射）——随处都允许，因为您需要看清屏幕内容才能决定是否把应用加入白名单。凡是涉及修改的操作，在列表外一律被拦截；Ava 会暂停并询问您是否要添加。

仅限会话，这是刻意为之

白名单不会在不同会话间保留。没有“记住此应用”的选项。每个新轨迹都从头开始。这虽有些不便，却是有意为之——忘记重新授权是一种保护特性，而非漏洞。

轨迹中途添加

在轨迹进行中，您可以从顶部栏添加应用：“+ 允许应用”会打开一个小输入框。点击添加，新应用即刻生效，直至本次会话结束。

知识包

简单来说：把你自己文档的文件夹交给 Ava，她可以从中阅读来回答你的问题。“知识包”就是那束文件 —— 她被允许参考的参考资料。

将参考资料目录（规范、RFC、会议记录、API 文档）拖入知识包。当对话涉及该主题时，Ava 可以将相关内容拉入上下文中。

包是本地索引的。检索是语义化的 —— Ava 通过含义而非文件名找到正确的文档。（“语义化”意味着她根据文档的主题进行匹配，所以你不需要记住确切的词语或文件名。）包可以与团队共享或保持私密。

Creative Studio

简单来说：描述你想要的图标、图像、视频或配音，Ava 与你一起设计 —— 无需设计软件，无需折腾提示词。

Creative Studio 是一个引导式设计工作区。它打开时分为三个窗格 —— 左侧是设计类型，中间是你的画布，右侧是你正在处理的作品控件。没有需要寻找的“生成”按钮：你在屏幕底部与设计架构师（Ava，担任设计师角色）交谈，她为你运行工具，你用几个清晰的控件进行完善。

你今天能制作什么

• 图标 —— 主打功能。从真实的线条图标形状开始（内置 1,990 个），选择材质和品牌颜色，Ava 重新设计样式并将其裁剪为干净的透明 PNG。
• 图像 —— 自由形式，基于描述。正方形、横向或纵向（1:1, 16:9, 9:16）。
• 视频 —— 基于提示词的短 AI 片段。5 或 10 秒，最高 1080p，支持横向、纵向或正方形。
• 配音功能——将文本转为自然语音，并支持波形预览。提供十种语言的十一款声音。
• Brand Kit — 你的专属色板，随时在手，确保每个素材都符合品牌规范。

更多设计类型 — 应用图标、徽标、徽章、头像、横幅、主图和社交媒体图片、插图、图案以及完整的游戏开发资源集 — 正在迁移中，并在左侧栏显示为 "soon"。

它由什么驱动

图标和图像通过 Qwen-Image 生成，视频通过 Wan 生成，配音通过 Qwen3-TTS 生成。你创作的任何内容都会进入你的资料库，并按创建类型分类存放。

Creative Studio 并非付费附加项 — 所有计划均包含此功能，免费计划也不例外。生成操作消耗的是你常规的积分额度，与 Ava 其他功能共用同一份额度。

健康与营养

简单来说：告诉 Ava 你的目标和你手头的条件，她会为你定制一份实实在在的锻炼和饮食计划 — 随后陪你一天天落实执行。

健康与营养是仪表盘中的一个专注模块。Ava 会先了解你的情况 — 目标、器材、任何限制 — 然后调用真实的练习和食谱库，为你量身定制计划。计划可以是健身、饮食，也可以是两者兼顾。

工作原理

1. Ava 通过简单的控件询问你的目标和配置 — 目标卡片、器材标签、数字输入框 — 而不是面对一堆问题。
2. 她从目录中为你规划一个多周计划，确保你能用现有条件切实执行。
3. 你一天天按计划执行；Ava 可以根据变化随时补充或调整任意一天的内容。

所有内容都保存在你自己的设备上的本地计划库中。食谱和练习目录都是真实、精选的内容 — 而非临时拼凑。

将计划转化为餐食

计划若无法采购便毫无用处。购物清单会汇总整周所需的所有食材，并依照超市的陈列顺序排列——蔬果区、肉类水产、乳制品、烘焙坊、干货柜——让你只需逛一圈就能买齐，无需来回折返。

• 相同食材的不同写法会被自动合并。"洋葱"和"切碎的洋葱"会归为一行，并显示它们分别用于哪些餐食。
• 份量会根据家庭成员数量缩放。这个数值仅在此处生效——你的计划依然按单人标准制定，因此四口之家不会简单地将每日热量乘以四。
• 单位选择以易读为先。例如半公斤大米会显示为 500g。
• 无需精确测量的项也会被保留。"加盐调味"这类描述会被计入清单，而不会仅仅因为没人称重就被忽略。
• 你可以选择要采购哪些餐食。默认全部选中；如果家里已经有了，可以关闭该项。这样能将"已拥有"和"已购买"区分开，仅靠勾选无法表达这一细微差别。
• 如果清单无法涵盖所有内容，它会明确说明原因及缺失之处——而不是假装完整却在背后有所欠缺。

何时真正下厨

准备计划展示了每周的工作分布。它将动手操作的时间与无需看管的时间区分开来，毕竟没人会一直守着炖了四个小时的菜——烹饪工作量上限为一小时，超出部分不计入。因此，一道慢炖菜的实际负担比时钟显示的要轻，这才是真实的付出。

• 标出哪天工作量最大，让你在遭遇忙碌的周二之前就有所准备。
• 列出必须提前一晚开始的项目——比如隔夜燕麦。仅当它真正影响你的晚间安排时才提示；像面团静置九十分钟这种事，没必要特意提醒。
• 识别值得一次多做些的菜。如果一周内同道菜要吃两次，且能在保质期内，系统会建议周一做好，留到周三吃，从而节省一小时。
• 如果你告知 Ava 你每天有多少烹饪时间，超时的一天会被标记。如果没有设定，则不会判定任何一天为"繁重"——未设定的时间预算视为未知，而非零。

记录实际情况

计划直面现实生活。打开过去的任意一天，对每项进行标记：完成了还是跳过了，吃了原定的，吃了别的，或者完全跳过。旁边配有备注框，并明确告知你会读取这些内容——因为人们知道自己被关注时会更坦诚，而如果事后才发现被查看，那感觉就像被监视一样。

空白代表未记录，而非跳过。这是两个不同的事实，Ava 会区别对待——她绝不会将空白的日子误判为遗漏。

针对训练还有更详细的日志：组数、次数和重量，均根据计划预设填充，通常只需轻点几下，仅需输入差异部分。刻意让"跳过"与"记录"同样便捷——如果跳过选项隐蔽，用户就会直接留空，导致区别在源头就消失了。

你记录的数据会充实 Ava 对你实际训练和饮食的记忆，因此下周的建议将基于真实情况，而非她最初制定的计划。

重复与进阶

可以将某一天或整周向后复制，并可适度进阶——增加一次重复，或增加一组。进阶的是副本，而非原件，确保你已经完成的工作不会被覆盖。

热身、放松、灵活性训练以及完整的休息日保持原样。在休息日增加组数不算进阶，而是悄悄将其变成了训练课——这正是该日程旨在避免的情况。负荷也不会自动进阶：此处的重量支持自由文本输入，给"自重"添加百分比毫无意义。

单日求助

卡在周四怎么办？请 Ava 帮你填补空缺、增加收尾动作、降低难度、增加蛋白质摄入，或缩短时间。她会提供方案——当前日程会与她的建议并列展示，让你在看清具体改动后再决定是否采纳，未经确认绝不保存。

所有内容都保存到您本地的计划库中，就在您的设备上。食谱和运动目录都是真实且经过精选的内容——食谱包含三种难度等级和完整步骤，运动则附带技巧指南、常见错误及演示图片。所有内容都不是即时生成的。

学习

简单来说：请 Ava 教你某个主题，她会为你打造一门完整的课程 — 包含课程、示例解析和测验 — 然后按你的节奏一步步引导你掌握。

学习是仪表盘中的一个专注模块。Ava 为你想学的主题规划课程，逐课教学，通过测验检验理解程度，并记录进度，让你能随时接续之前的学习。

工作原理

1. 告诉 Ava 一个主题 — 比如 "teach me Python from scratch"，或者 "help me understand databases"。
2. 她构建结构化课程：包含模块、课程和关键节点。
3. 你一次只学一课；她负责讲解、举例，并通过测验帮你巩固记忆。
4. 你的进度会被保存，下次会话将从你中断的地方继续。

本质上，这是教学模式 — 一个小专家团队（课程架构师、内容撰稿人、事实核查员、出题人和导师），由 Ava 为你统筹协作。

Office Suite

需要撰写报告、邮件或文档吗？Ava 可以为您起草，并提供真正的 Word、Excel 或 PDF 文件，您可以像处理普通文件一样打开和编辑。

报告、邮件和文档——经过起草、格式化，并导出为原生格式（.docx 对应 Word，.xlsx 对应 Excel，.pdf 对应 PDF）。

• report_generate —— 基于任务、日志、记忆和项目状态生成的结构化 .docx 文件。
• email_draft —— 控制语气的邮件，输出为 .docx 文件。
• document_manage —— 在 Word、Excel、PDF、CSV、Markdown 之间进行创建、读取、编辑和导出。

当 Ava 代您撰写内容时非常实用——例如状态报告、启动演示文稿或客户更新。.docx 文件会出现在您的项目中，方便您进一步润色。

资料库

简单来说：这里有一个架子，专门存放你珍视的东西——你正在阅读的论文、你制作的素材，以及你写下的文档——确保一切都有迹可循，不会丢失。

资料库是一个可浏览的仪表盘，包含三个标签页：

• 论文 —— 你保存的科学论文，来自 arXiv、OpenAlex 和 Crossref，支持内联阅读全文。
• 素材 —— 你在 Creative Studio 中制作的所有内容，按你创建时所用的设计类型分类（Open Canvas、Web / App、Game Dev）。先按组筛选，再按类型筛选；每种类型都会显示你的数量。
• 文档 —— 包括 Word、Excel、PDF 等 Ava 与你协作创建的文件，支持按文件类型筛选。

顶部的存储空间条显示本地文件占用了多少空间，“Open save folder”按钮可直接带你进入磁盘上的文件夹。它是“本地优先”的——资料库读取的是你自己机器上的内容。

每日简报

简单来说：每天早上一条简短的“昨日进度摘要”，让您无需重读所有内容即可快速接上工作。

晨间摘要：包含昨日的日志、待办任务、项目状态，以及 Ava 设置的任何提醒。此为可选功能——可在设置中开启。

简报利用记忆呈现相关上下文（例如："上次您处理认证流程时，曾提到想重新审视刷新令牌策略"）。这不是新闻推送，而是帮助您专注跟进的摘要。

工作流程

简单来说：教 Ava 一个你反复执行的例行任务，给它起个名字，她就能按需重复整个流程。所谓“工作流”，就是保存下来的这个例行任务——一套 Ava 为你重复执行的步骤。

保存一组你发现自己会重复执行的步骤 —— 审查拉取请求 → 运行测试 → 编写发布说明 → 起草邮件。工作流就是一个可复用的计划，Ava 可以用不同的输入重新执行它。

工作流按项目存储在你的项目文件夹 .ava/workflows/ 中。通过提交该目录（将其保存到共享项目中）与团队成员共享，这样队友也能获取到。

事件与通知

简单来说：当 Ava 工作时，你会看到一个整洁的步骤列表，显示她在做什么；长任务完成后会有提示，让你可以暂时离开。

Ava 运行时，你看到的是结构化的更新，而不是一堆文字。每一次工具调用、每一个角色交接、每一段流式传输的增量，都是 UI 中的一个独立事件 —— 可展开查看详情，也可折叠查看概览。

后台运行在完成时会发出操作系统级别的通知。你可以离开去处理其他事情，等长构建完成后，Ava 会告诉你。

性格设定

简单来说：调节 Ava 与你交谈的方式 —— 是健谈还是简洁，正式还是随意，多讲笑话还是少讲 —— 让她听起来符合你的喜好。

塑造 Ava 与你交谈的风格。语气、能量、说话多少（表达详略）、正式度、幽默感。滑块和预设选项 —— 干练工程师、温暖导师、冷静同事，或者你自己的混合风格。

性格只影响措辞，不影响能力。她仍然使用相同的工具并遵循相同的权限规则。她的名字固定为 Ava —— 这一点不可更改。

桌面自动化

简单来说：Ava 可以接管你的鼠标和键盘来帮你完成任务——比如打开应用、点击按钮、填写表单——而你在旁边观看，并对重要事项进行确认。

这是 Ava 的一种新模式，使用前缀 @@。她会观察桌面，决定如何操作，并驱动 UI 自动化（替你控制屏幕上的应用）来完成任务。它在你的真实机器上运行，使用你的真实凭证——而非云端浏览器。上线后将对所有层级开放。

为何需要另一个

大多数桌面自动化产品只是机械听从指令的点击工具。Ava 则先规划：她会展示步骤，等待你的许可，并在任何不可逆的操作前再次确认——每次都这样，绝不缓存。

她还能记住跨会话如何操作你的应用。其他智能体每次都要重新学习。这种记忆优势会随着使用不断积累。

工作原理

每个步骤都会触发一个“五人角色组”：侦察员负责观察，规划者选择下一步动作，执行者进行操作，验证者进行检查，讲述者向你汇报结果。Sidecar 会选择成本最低且可靠的交互基础——原生应用使用 UIA，浏览器使用 Playwright，当其他方案无法提供有效结构时使用 OmniParser 视觉能力。

有关安全本体、交互依据层级、紧急停止开关以及会话白名单模型的详细信息，请参阅概念页面。

常见错误

大多数错误都有简短、具体的原因。以下是常见问题及其解决方法。如果措辞听起来有些技术化，请不要担心——下面的每一项都会告诉你实际看到了什么，以及具体该怎么做。

模型无响应

你看到的情况：Ava 沉默了，没有回复。

检查聊天标题栏中的状态指示器。如果显示“正在连接”，说明你的提供商（Ava 正在对话的 AI 服务）可达但较慢——给它三十秒时间。如果显示“不可用”，Ava 会自动回退到链中的下一个模型（她自动切换到了备用模型）。如果没有任何反应，请在设置中验证你的 API key 并测试连接。（API key 是允许 Ava 使用付费 AI 服务的私密密码。）

工具调用失败

你看到的情况：Ava 的某一步骤（一个“工具调用”——比如读取文件、运行命令等）显示红色错误，而不是完成。

点击失败的“工具调用”查看错误。常见原因：她试图访问项目文件夹外的文件，这是出于安全目的故意阻止的（这种保护称为“路径遍历”防护——防止她走出你正在工作的文件夹）；或者需要在不同文件夹中运行的命令；或者是自从 Ava 上次查看后文件被移动了。告诉她哪里出错了——她会修正后重试。

记忆未找回

你看到的情况：Ava 找不到一些你确信她应该记得的内容。

记忆基于含义而非精确字词工作（这就是“语义”的意思）。所以“我对认证做了什么决定？”比“查找我的认证决定”更有效。如果记忆确实存在但没有浮现，请打开记忆浏览器进行搜索——如果那里没有，说明它从未被保存过。

登录循环

你看到的情况：你已登录，但 Ava 不断要求你再次登录——这是一个无法通过的循环。

解决方法是清除保存的登录信息并重新开始：在扩展中从命令面板运行“Ava: Sign Out”，在 IDE 中使用设置 → 账户 → 注销，在 CLI 中删除文件 ~/.ava/auth.json（位于主目录名为 .ava 的文件夹中的小型登录文件）。然后重新登录。

令牌耗尽

你看到的情况：一条消息提示本月免费额度已用完。（“令牌”是衡量 AI 使用量的方式——“耗尽”仅意味着你用完了本月的免费额度。）

免费版月度预算每月 1 日重置。在此之前，切换到 BYOK 提供商（使用你自己的 API key）以继续工作。你的账户保持活跃——仅暂停免费的平台托管请求。

日志位置

“日志”只是电脑记录发生事情的日记——当出现问题且你需要（或支持人员需要）查看详情时很有用。

当你需要原始画面——调用了什么工具、获取了什么信息、AI 服务返回了什么——日志是你电脑上 ~/.ava/logs/ 文件夹中的纯文本文件（主目录下的 .ava 文件夹，里面有一个 logs 文件夹）。

• ~/.ava/logs/session-<date>.log — 每次会话的转录，包括工具调用、流式响应和错误。
• ~/.ava/logs/extension.log — VS Code 扩展主机日志。激活失败、面板错误。
• ~/.ava/logs/ide.log — 桌面 IDE 日志。Sidecar 进程消息、Rust 崩溃。
• ~/.ava/logs/cli.log — CLI REPL 日志。

在扩展中，命令面板中的“Ava: Show Logs”会在编辑器标签页中打开相关日志。在 IDE 中，设置 → 诊断有个“打开日志”按钮。CLI 可以通过 `ava logs --follow` 跟踪其自身日志。

提交支持请求

简单来说：如果遇到问题且上述方法没解决，请给我们留言。最简单的方式是直接让 Ava 帮你处理。

如果问题不在常见错误列表中，请提交支持工单（即向支持团队求助）。你可以直接在 Ava 内操作（无需填表），也可以通过网页进行。

在 Ava 应用中

请她来提交。说："Ava，能帮我提交个支持工单吗？" 她会调用 support_request，附上相关的会话上下文（已隐藏敏感信息），然后发送。这是最快的方式。

通过网页端

访问 avasupernova.com/support。选择一个类别（缺陷、功能、账户、安全、通用）并描述情况。我们将在一个工作日内回复。

请提供哪些信息

• 你原本想做什么。
• 实际发生了什么。
• 是哪种平台（扩展、IDE、CLI）以及哪个版本。
• 任何错误消息或日志片段。请先隐藏敏感凭证。

报告安全漏洞

简单来说：如果你发现 Ava 可能存在被入侵或滥用的风险（即“漏洞”——安全弱点），请先私下告知我们，这样我们能在他人利用之前修复它。本页就是操作方法。

发现漏洞了吗？谢谢你。我们重视每一份报告，会在公开披露前与你协作修复（即在问题公之于众之前）。

如何报告

1. 发送邮件至 security@ava-supernova.com，包含描述、复现步骤以及你希望的披露时间窗口。
2. 或者提交类别为“安全”的支持工单——进入相同的处理队列。
3. 我们会在 24 小时内确认收到。

我们的承诺

• 协调披露——在公开前我们会与你商定时间表。默认期限为 90 天。
• 署名致谢——除非你希望匿名，否则我们将在修复说明中为你署名。
• 无法律追责——欢迎善意研究。我们绝不会因为此事起诉你。