文档

Page Assist

Page Assist 是为本地 Ollama 构建的，同一界面也支持托管端点：依次选择 Settings → OpenAI Compatible API → Add Provider → Custom，填写三个字段，然后侧边栏就能用 Claude 或 GPT 总结当前标签页，而不必受限于笔记本电脑的内存容量。

Settings → OpenAI Compatible API → Add Provider → Custom：填写 Provider Name、保留 /v1 的 Base URL 和密钥 — 然后从 Page Assist 自动获取的列表中勾选模型 ID。

Settings → OpenAI Compatible API → Add Provider → Custom

Provider Name   Kunavo
Base URL        https://api.kunavo.com/v1
API Key         sk-kn-...
                [ Save ]

Model List      (appears after Save — fetched from GET /v1/models)
  [x] claude-haiku-4-5
  [x] claude-sonnet-5
  [x] gpt-5-6-terra

Base URL 需要保留 /v1 后缀。 OpenAI Compatible API 页面本身没有说明这一点——字段的帮助文本说明了。其帮助文本写道：“OpenAI API 提供商的 Base URL，例如 (http://localhost:1234/v1)”，两个同类提供商页面也为同一字段给出了具体 URL，且两者一致：LM Studio 的“默认值为 http://localhost:1234/v1”，以及 LLaMA.cpp 的 http://localhost:8080/v1。Page Assist 只会追加路由，因此使用不带路径的源站地址会导致 404，而不是 401——这与需要仅填写源站地址的 Anthropic 风格客户端正好相反。

模型列表通常由系统获取，无需手动输入。完成 Save 后，Page Assist 会打开 Model List，并显示“请选择要与此提供商搭配使用的聊天模型”，列表由端点填充。Kunavo 会返回 GET /v1/models，因此列表会自动填充。如果列表为空，扩展会提示：“未找到模型。请确保已添加正确的提供商，并设置了 Base URL 和 API 密钥。”这是准确的：空列表更常见的原因是 Base URL 或密钥有问题，而非模型目录问题。先用下方的 curl 确认问题，再处理扩展。也可以通过 Add Custom Model 手动添加 ID，其 Model ID 字段可直接填写本页表格中的模型标识。

选择 Chat Model，而不是另一个单选项。 Add Custom Model 表单中有一个 Model Type 选项，而 Kunavo 不提供嵌入模型——目录中没有模型能响应该端点，因此这里的第二个选项无处可用。知识库功能依赖嵌入模型：供应商自己的页面说明，你必须在 RAG Settings 中设置一个，并推荐使用 nomic-embed-text。为此，请继续配置本地 Ollama 与此提供商并用——Page Assist 可同时保留多个提供商，聊天和嵌入这两种用途不必来自同一处。

音频设置需要单独配置。 Page Assist 的 Text-to-Speech 部分提供 OpenAI TTS 提供商，有独立的 API Key、Base URL 和 TTS Model，而 Kunavo 不提供文本转语音模型。反过来也一样：Kunavo 不提供语音转文本模型，Page Assist 的语音输入使用浏览器自带的识别器，通过 Speech Recognition Language 设置，根本不会调用 API。让这两个部分继续使用当前配置即可。

此配置根据供应商的文档和界面原文整理，核对日期见下方。Kunavo 尚未通过其端点运行 Page Assist——未固定扩展版本、未启动侧边栏会话、未测试流式回复，也未进行工具往返。发布配置说明不等于测试，本文也不应被视为测试结果。你可以在十秒内自行确认的是 curl；扩展在正常工作的端点之上的表现，则取决于 Page Assist。

还没有密钥？创建 Kunavo 账户，创建一个密钥（以 sk-kn- 开头），并充值 $10 起——调用费用从该余额中扣除，失败的调用不会收费。随后，控制台会打开 Page Assist 设置页面。

分步操作

在 /app/keys 创建密钥并复制——它只会显示一次。
点击浏览器工具栏上的 Page Assist 图标，然后点击 Settings 图标，再转到 OpenAI Compatible API 标签页。
点击 Add Provider。下拉菜单中的预设项没有 Kunavo，因此请选择 Custom——这是供应商在步骤 5 中为列表中未包含的提供商指定的选项。
填写 Provider Name、Base URL = https://api.kunavo.com/v1 和 API Key，然后点击 Save。
在打开的 Model List 中勾选所需的模型 ID。通常选两个比较合适：一个用于页面摘要，成本较低；另一个能力较强，用于后续提问。
在真实页面上打开侧边栏——Ctrl+Shift+L 会打开 Web UI——从选择器中选取模型，然后询问它当前标签页的内容。包含实际内容的页面比一句问候更能说明情况，因为页面文本才是会产生费用的部分。

已于 2026年9月21日对照 Page Assist 的 OpenAI Compatible API 页面检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 Page Assist 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。

模型 ID	Kunavo 输入 / 输出	它在 Page Assist 中的位置
`claude-haiku-4-5`	$0.70 / $3.50	侧边栏的默认选择：用于页面摘要和后续提问，使用量是主要考量
`gpt-5-6-terra`	$0.70 / $4.20	长页面——文档、讨论串、文字记录——不做删减，直接整体发送
`claude-sonnet-5`	$1.40 / $7.00	摘要之后的问题；此时答案必须准确
`gpt-5-6-sol`	$2.00 / $12.00	来自另一个系列的第二意见；将其作为第二个已勾选的 ID 添加，使用同一提供商

计费方式是从预付余额中按 token 扣费，无月费——参见计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

页面会产生多少费用，以及哪些内容会离开浏览器

侧边栏客户端的计费方式与编辑器不同，差别就在页面。Page Assist 每次与标签页聊天时，都会将该标签页提取出的文本作为输入令牌发送——文档页面或长讨论串可能包含数万个令牌，而且同一对话中的每次后续提问都会重新发送这些内容。因此，上方的模型表优先列出低成本 ID：在此客户端中，输入量通常比输出量高出一个数量级，而让 claude-haiku-4-5 或 gpt-5-6-terra 读取整个页面，优于让更强的模型读取截断后的内容。

有三个设置会增加你未明确要求的流量，供应商的 Settings 页面都列出了这些设置：

使用 AI 生成标题 — “根据对话自动生成聊天标题”。每段对话额外调用一次，使用当前选定的模型。
Internet Search，其中 Internet Search 默认开启，并设有 Total Search Results——获取的页面会并入提示词，因此令牌费用会随结果数量增加。
页面操作，即配套扩展——模型“先读取页面，再逐步执行操作”，因此每一步都会读取一次 DOM，而不是每段对话读取一次。其自身的 执行每项操作前要求批准 默认开启，建议保持开启。

隐私边界也遵循同样的原则。Page Assist 会在浏览器存储中本地保存聊天记录、知识库和设置；通过网络传输的内容就是你发送的内容。选用此提供商后，页面文本、你的消息和此前的对话内容都会发送到 api.kunavo.com，再由其转发给为模型 ID 提供服务的上游——请参阅隐私政策，了解 Kunavo 这一端会保留哪些内容。对于你不会粘贴到聊天窗口中的页面，请切换回本地 Ollama；扩展能同时配置这两个提供商，正是为了让你只需在下拉菜单中切换。

如果你是从 OpenRouter 预设页面来到这里的

OpenRouter 无需选择 Custom。它是供应商 OpenAI Compatible API 页面列出的预设项之一，与 Ollama、LM Studio、Groq、Together、Mistral、xAI 及约二十个其他选项并列，因此前四次点击相同，然后从下拉菜单中选择 OpenRouter，而不是 Custom；在 API Key 中填写其密钥，再点击 Save。此预设自带 Base URL，且 OpenRouter 的模型 ID 带有供应商前缀，格式为 anthropic/claude-sonnet-4.5；而上方表格中的 ID 不带前缀。在这里选择提供商，也就决定了你要输入哪种 ID 命名空间。

在此客户端中，以下情况值得切换：你希望通过一个界面访问 Kunavo 未提供的模型，或者你已经配置好密钥，额外设置成本为零。以下情况值得切换到 Kunavo：表格中的 ID 也能用于你的编程工具，因此一个密钥即可用于两者；而对于重复发送的页面上下文，提示缓存才是影响侧边栏账单的关键——请参阅缓存。你可以同时保留两个提供商：Page Assist 会一并列出它们，模型选择器也不在意模型来自哪一行。

常见问题

如何在 Page Assist 中使用自定义 API？

点击浏览器工具栏上的 Page Assist 图标，打开 Settings，转到 OpenAI Compatible API 标签页，然后点击 Add Provider。如果你的端点不在下拉菜单的预设项中，请选择 Custom，填写 Provider Name、Base URL 和 API Key，然后点击 Save。接着，Page Assist 会打开从端点获取的 Model List，你可以在其中勾选要通过该提供商使用的聊天模型。如果未获取到任何模型，也可以通过 Add Custom Model 手动输入 ID。

Page Assist 的 base URL 需要包含 /v1 吗？

对于兼容 OpenAI 的端点，需要包含。OpenAI Compatible API 页面没有明说，但 Base URL 字段自身的帮助文本说明了这一点：“OpenAI API 提供商的 base URL。例如 (http://localhost:1234/v1)”；LM Studio 和 LLaMA.cpp 页面也在相同字段中列出了相同后缀，分别为 http://localhost:1234/v1 和 http://localhost:8080/v1。对于 Kunavo，URL 应为 https://api.kunavo.com/v1。Page Assist 只会追加路由，因此省略后缀会导致 404，而不是身份验证错误。

为什么我添加提供商后，Page Assist 显示没有模型？

模型列表会使用你刚输入的密钥从端点获取，扩展自身的提示也说明了需要检查什么：“未找到模型。请确保已添加正确的提供商，并填写正确的 base URL 和 API 密钥。”使用 curl 对 /v1/models 执行同样的请求，在扩展之外测试这组配置——若返回 JSON，问题就在提供商配置项；若返回 401，问题在密钥；若返回 404，通常是 Base URL 缺少 /v1。若仍无法解决，可通过 Add Custom Model 手动添加 ID，这不依赖模型获取功能。

Page Assist 能使用 Claude 或 GPT 替代本地模型吗？

可以。“OpenAI Compatible API”指的是线路格式，而不是供应商；模型 ID 会传递给你配置的 Base URL，因此 Claude 或 GPT ID 会在该端点解析，而不是在扩展内部解析。本地模型功能不受影响：Page Assist 可以同时保留多个提供商，因此 Ollama 项和托管提供商项可以并列显示，并可通过模型选择器在它们之间切换。

哪个模型用于 Page Assist 最便宜？

此客户端的输入量占主导，因为每次与标签页聊天时，都会在对话的每一轮中重新发送该标签页提取出的文本。因此，默认选择价格低且上下文长度大的模型较合适——普通页面用 claude-haiku-4-5，长页面用 gpt-5-6-terra——再勾选 claude-sonnet-5 这类能力更强的 ID 作为第二个选项，用于答案十分重要的问题。各模型每百万令牌的价格见本页表格；对于侧边栏账单，提示缓存的影响大于模型选择。

Page Assist 的 Knowledge Base 能使用 Kunavo 吗？

索引部分不行。Knowledge Base 是一项 RAG 功能，供应商文档指出，你必须在 RAG Settings 中设置嵌入模型，并推荐 nomic-embed-text；Kunavo 不提供嵌入模型，因此该位置需要使用其他提供商——通常选择本地 Ollama，它可以与此提供商同时运行，互不冲突。聊天部分不受影响：文档完成索引后，用于回答相关问题的模型可以是此提供商中的任意聊天 ID。

Kunavo 是否测试过 Page Assist？

没有。2026 年 9 月 21 日核对的是 Page Assist 自己的 OpenAI Compatible API 文档和扩展的英文界面文本——Settings 中的操作路径、字段标签及顺序、Base URL 示例和空列表提示均引自这些资料。Kunavo 尚未安装扩展、固定版本或通过扩展发送请求，因此不对任何特定版本的流式传输、页面提取或 Model List 获取功能作出声明。本页上的 curl 命令是你可以独立验证的部分。