Page Assist 接入 QCode 图文教程(Windows 11 一步一图)
跟着 11 步、11 张截图,在 Windows 11 浏览器里装好 Page Assist 1.5.91 扩展,配置 QCode OpenAI 兼容端点,在任意网页侧边栏用 gpt-6.2-sol 总结和问答。
需要 API Key? 前往注册 →端点与 Base URL →
照着下面 11 步做,你会在 Windows 11 浏览器里装好开源扩展 Page Assist,接通 QCode 的 OpenAI 兼容端点,在任意网页的侧边栏直接让 AI 总结页面内容或随时提问。
一句话答案:在 Microsoft Edge 或 Chrome 安装 Page Assist 1.5.91 扩展后,点右上角齿轮进入「OpenAI 兼容 API」→「添加提供商」,类型保持 Custom,填写基础 URL https://api.qcode.cc/openai/v1 和 cr_ 密钥并勾选 gpt-6.2-sol 保存,按 Ctrl+Shift+Y 打开侧边栏、勾选「与当前页面聊天」即可提问。
| 项 | 填写 |
|---|---|
| API 类型 | Custom |
| 提供商名称 | QCode |
| 基础 URL | https://api.qcode.cc/openai/v1 |
| API 密钥 | cr_xxxxxxxx |
| 默认推荐模型 | gpt-6.2-sol |
核对于 2026-11-22 · Page Assist 1.5.91 · Windows 11
Page Assist 是一款开源浏览器扩展,支持在独立标签页(Web UI)或任意网页右侧边栏里与 AI 对话,尤其适合一边浏览英文文档或长文章、一边让模型做中文总结和追问。在 Page Assist 里接入 QCode 走的是 OpenAI 兼容 API,可直接使用 GPT 系与国产模型(推荐 gpt-6.2-sol)。
- 电脑是 Windows 10 / 11(64 位),装有 Microsoft Edge、Google Chrome 或 Firefox 之一(Windows 自带 Edge,无需额外装软件)
- 已经注册 QCode.cc,并在控制台复制好
cr_开头的 API 密钥。还没有账号?先注册 QCode,在定价页选一个方案,再到控制台创建密钥。 - 浏览器能打开官方扩展商店(如 Edge 扩展商店),以及
api.qcode.cc和probe.qcode.cc - 了解当前支持范围:Page Assist 接入 QCode 仅走 OpenAI 兼容端点,可使用
gpt-6.2-sol等 GPT 及国产模型;如果需要使用claude-opus-5-5等 Claude 模型,请改用支持自定义 Anthropic 端点的客户端
下载与安装¶
Page Assist 是浏览器扩展,没有独立的 Windows .exe 安装包,也不在 winget 或微软应用商店里。安装只需在浏览器商店点两下,不会触发 Windows SmartScreen 警告,也不需要管理员权限。
官方商店入口:
- Microsoft Edge(推荐):Edge 扩展商店 Page Assist 页面(无需登录微软账号)
- Google Chrome:Chrome 应用商店 Page Assist 页面
- Mozilla Firefox:Firefox 附加组件商店 Page Assist 页面
不同地区的浏览器商店访问情况略有不同,先选你所在的地区:
- 推荐直接用 Windows 自带的 Microsoft Edge 打开 Edge 扩展商店 Page Assist 页面,无需登录微软账号,点击「获取」→「添加扩展」即可完成安装(下面截图全部基于 Edge 演示)。
- 如果日常使用 Firefox,也可以从 Firefox 附加组件商店 直接安装。
- Chrome 应用商店在大陆网络环境下通常无法直连,请改用 Edge 或 Firefox 商店,不要从第三方站点下载
.crx文件,以防被篡改。
- Chrome、Edge、Firefox 三家官方扩展商店均可正常访问,按自己常用浏览器选择即可:
- Edge:打开 Edge 扩展商店,点击「获取」→「添加扩展」。
- Chrome:打开 Chrome 应用商店,点击「添加至 Chrome」→「添加扩展程序」。
- Firefox:打开 Firefox 附加组件商店,点击添加到 Firefox。
- 装好之后,扩展内部的配置界面和步骤在各浏览器完全一致。
跟着截图做:Windows 一步一图¶
下面 11 步每步只做一件事,以 Windows 11 自带的 Microsoft Edge 演示(Chrome / Firefox 装完后操作相同)。截图上的橙色编号和正文里的 ①②③ 一一对应。
在扩展商店点击「获取」¶
用 Microsoft Edge 打开 Edge 扩展商店的 Page Assist 页面(无需登录微软账号;若顶部出现 Cookie 提示条,先点「拒绝」或「接受」关掉)。点击右侧 ① 处的蓝色「获取」按钮。

做对了你会看到:浏览器地址栏下方弹出一个安装确认小窗口,列出扩展所需的权限。
卡住了?商店打不开或想在 Chrome 中安装
如果 Chrome 商店一直转圈打不开,建议改用系统自带的 Microsoft Edge 访问上面的 Edge 商店链接;网络可直连 Chrome 商店时,点「添加至 Chrome」效果一样,安装后直接跳到第 3 步继续。
在权限弹窗里点击「添加扩展」¶
Edge 会弹出确认框,提示将 Page Assist 添加到浏览器,并列出两条权限(「读取并更改在所有网站上的所有数据」与「显示通知」)。点击 ① 处的「添加扩展」开始安装,整个过程不需要管理员权限。

做对了你会看到:几秒内下载安装完成,Edge 右上角弹出「Page Assist - 本地 AI 模型的 Web UI 现已安装」提示气泡。
把 Page Assist 固定到浏览器工具栏¶
先点右上角 × 关掉「现已安装」的提示气泡。接着点击地址栏右侧 ① 处的拼图图标「扩展」,在下拉列表中找到 Page Assist,点击它右侧 ② 处的图钉图标(「固定到工具栏」),工具栏上就会常驻出现 ③ 处的 Page Assist 图标。

做对了你会看到:地址栏右侧工具栏上常驻显示 Page Assist 图标,随时点击就能打开。
打开 Web UI 并进入设置¶
点击工具栏上的 Page Assist 图标,浏览器会在新标签页打开 Web UI。首次打开默认是英文界面,页面中间提示 Unable to connect to Ollama (http://127.0.0.1:11434)——使用 QCode 云端 API 时无需本地 Ollama,直接忽略即可。点击页面右上角 ① 处的齿轮图标进入设置。

做对了你会看到:页面进入设置界面,左侧显示设置导航菜单,右侧为「General Settings」。
卡住了?点击工具栏图标没反应或找不到齿轮
先确认第 3 步已经把 Page Assist 固定到工具栏并点击了它的图标。齿轮图标位于新标签页内容区的右上角(最右侧一个图标);也可以点击「扩展」菜单里 Page Assist 旁的「在边栏中打开」,再点侧边栏顶部的齿轮进入同一设置页。
切换简体中文并打开「OpenAI 兼容 API」¶
进入设置后,点击顶部 ① 处的 Language 下拉框(默认显示 English),搜索并选择「简体中文」,整个界面会立刻切换为中文。接着点击左侧菜单中 ② 处的「OpenAI 兼容 API」。

做对了你会看到:左侧菜单全部变为中文(「一般设置」「OpenAI 兼容 API」「管理模型」等),右侧进入 OpenAI 兼容服务管理页面并出现「添加提供商」按钮。
添加 QCode 提供商并填写 API 密钥¶
点击页面中的「添加提供商」,会弹出「添加新提供商」窗口。按下面顺序填写:
- 顶部 ① 处的类型下拉框保持默认的「Custom」;
- 「提供商名称」填
QCode; - ② 处的「基础 URL」填
https://api.qcode.cc/openai/v1(填到/v1为止,末尾不要多加斜杠或/chat/completions); - 「API 密钥」粘贴你在 QCode 控制台复制的
cr_密钥(格式如cr_xxxxxxxx); Fix CORS issues和「自定义头部」保持默认,点击底部 ③ 处的「保存」。

做对了你会看到:「添加新提供商」窗口关闭,紧接着自动弹出「模型列表」窗口,显示拉取到的 QCode 模型。
在模型列表里勾选推荐模型¶
保存提供商后,Page Assist 会自动携带密钥拉取 QCode 的 OpenAI 兼容模型列表(共列出 20 个模型)。勾选 ① 处的 gpt-6.2-sol;如果想同时添加一个轻量备用模型,可以在 ② 处的「搜索模型」中输入 deepseek-v4.1-flash 一并勾选。保持底部类型选中「聊天模型」,点击 ③ 处的「保存」。

做对了你会看到:页面顶部短暂提示「成功添加新模型。」,随后自动回到「OpenAI 兼容 API」列表页面。
卡住了?模型列表空白或提示拉取失败
先确认上一步「基础 URL」准确填写为 https://api.qcode.cc/openai/v1、密钥以 cr_ 开头且前后没有多余空格。若列表仍为空,可以先关闭弹窗,到第 9 步的「管理模型」→「自定义模型」点击「添加新模型」,手动填入 gpt-6.2-sol。
确认 QCode 提供商已启用¶
回到「OpenAI 兼容 API」列表页,核对 ① 处新出现的 QCode 这一行:确认「基础 URL」为 https://api.qcode.cc/openai/v1,最右侧的启用开关处于蓝色开启状态。表格不会明文显示你的 API 密钥;日后需要更换密钥或重新同步模型列表时,点该行右侧的编辑或下载图标即可。

做对了你会看到:表格里出现 QCode 一行,基础 URL 正确,最右侧开关为蓝色开启状态。
在「管理模型」核对已导入的模型¶
点击左侧菜单的「管理模型」(默认打开「Ollama 模型」标签),再点击 ① 处的「自定义模型」标签。确认 ② 处列表中已经出现 gpt-6.2-sol(以及顺带勾选的 deepseek-v4.1-flash)。以后需要手动补充其他模型 ID 时,随时可以点右上角 ③ 处的「添加新模型」。

做对了你会看到:「自定义模型」标签页下清楚列出 gpt-6.2-sol,状态为可用。
打开网页并在侧边栏选择模型¶
新建一个浏览器标签页,打开任意你想阅读的网页(例如一篇英文技术文档),按快捷键 Ctrl+Shift+Y 在右侧展开 Page Assist 侧边栏。点击侧边栏顶部 ① 处的「选择一个模型」下拉框,在展开列表中选择 ② 处的 gpt-6.2-sol。

做对了你会看到:网页右侧打开 Page Assist 侧边栏,模型下拉框里直接列出 gpt-6.2-sol 并可顺利选中,无需刷新页面。
卡住了?按 Ctrl+Shift+Y 没有反应
可能是快捷键与其他扩展或软件冲突。点击地址栏右侧的拼图图标「扩展」,找到 Page Assist 后直接点击它旁边的「在边栏中打开」图标,同样可以呼出侧边栏。
勾选「与当前页面聊天」并发送提问¶
选好模型后,务必先勾选模型选择器正下方的「与当前页面聊天」复选框(默认未勾选,不勾选时模型读不到网页正文)。然后在底部「输入一条消息...」输入框中输入「用中文简要总结这个页面(三句话以内)」并点击「提交」。发送后 ① 处显示你的提问,几秒内 ② 处的 gpt-6.2-sol 会返回贴合当前网页内容的中文总结,并在回复底部附带可点击展开的 ③ 处「引用」来源。

做对了你会看到:侧边栏很快输出基于当前网页内容的中文总结,底部出现可展开的「引用」按钮,没有红色报错。
卡住了?模型回复说看不到当前网页内容
确认侧边栏中「与当前页面聊天」复选框已经勾选。如果想以后每次打开侧边栏都默认读取网页正文,可以进入设置 →「一般设置」,开启「默认启用与网站聊天」。
验证成功¶
四件事都对上,说明 Page Assist 已经完整接通 QCode:
- 设置 →「OpenAI 兼容 API」表格中存在
QCode这一行,「基础 URL」为https://api.qcode.cc/openai/v1且右侧启用开关为蓝色开启状态; - 设置 →「管理模型」→「自定义模型」中能看到
gpt-6.2-sol; - 在任意网页按
Ctrl+Shift+Y打开侧边栏、选中gpt-6.2-sol并勾选「与当前页面聊天」,发送总结问题能收到基于网页内容的正常回复; - 打开 probe.qcode.cc,输入同一把
cr_密钥并查询,能看到与刚才提问时间吻合、状态正常的请求记录。
全部完成¶
你已经在 Windows 11 浏览器里装好 Page Assist 并接通 QCode。以后看任何英文文档、长文章或网页资料,按 Ctrl+Shift+Y 就能随时在侧边栏总结和追问。接下来可以:
常见报错¶
| 报错原文 | 原因 | 怎么办 |
|---|---|---|
Unable to connect to Ollama (http://127.0.0.1:11434) |
Page Assist 默认会检测本机是否运行 Ollama,未安装本地 Ollama 时打开 Web UI 就会显示该提示 | 使用 QCode 云端 API 时直接忽略即可,点击右上角齿轮图标按本文步骤添加「OpenAI 兼容 API」提供商并在聊天界面选择 gpt-6.2-sol |
model_not_available_on_endpoint |
在「OpenAI 兼容 API」中填入了 Claude 系列模型(如 claude-opus-5-5);QCode 的 OpenAI 兼容端点不接受 Claude 模型 |
在 Page Assist 里请使用 GPT 或国产模型(推荐 gpt-6.2-sol、deepseek-v4.1-flash、glm-5.3 等);需要使用 Claude 时请换用支持自定义 Anthropic 端点 https://api.qcode.cc/api 的客户端 |
404 |
「基础 URL」多填了路径(例如写成 https://api.qcode.cc/openai/v1/chat/completions),Page Assist 会再拼一次 /chat/completions 导致地址错误 |
进入「OpenAI 兼容 API」编辑 QCode 提供商,把「基础 URL」改为 https://api.qcode.cc/openai/v1(精确到 /v1 结尾,不加多余路径或末尾斜杠)后保存 |
常见问题¶
密钥到期后怎么办?¶
分两种情况处理:
- 个人套餐的密钥到期后不能续,只能重新开通、换一把新密钥;
- 按量包的密钥到期后再买一个包,同一把密钥会自动恢复。
如果更换了新密钥,打开 Page Assist 设置 →「OpenAI 兼容 API」,点击 QCode 这一行右侧的编辑图标,替换「API 密钥」并点击「保存」即可。
为什么不能在 Page Assist 里用 Claude 模型?¶
Page Assist 的「Anthropic (Claude)」只是 OpenAI 兼容下拉框里的固定预设,其接口地址写死为官方地址,没有提供自定义 Anthropic Base URL 的入口;而 QCode 的 Claude 模型(如 claude-opus-5-5、claude-haiku-5-5)只能走 Anthropic 协议端点 https://api.qcode.cc/api,不能走 OpenAI 兼容端点。因此 Page Assist 接入 QCode 时仅支持 GPT 与国产模型;如果需要使用 Claude,建议配合其他支持自定义 Anthropic 端点的桌面或 IDE 客户端。
保存提供商后模型列表为空,怎么手动添加模型?¶
如果在添加提供商时没有自动弹出模型列表,可以先核对「基础 URL」是否为 https://api.qcode.cc/openai/v1 以及密钥是否完整有效;确认无误后,进入左侧「管理模型」→ 切换到「自定义模型」标签 → 点击右上角「添加新模型」,手动输入模型 ID(如 gpt-6.2-sol)保存即可。
怎样让侧边栏默认读取当前网页,不用每次手动勾选?¶
在侧边栏中,「与当前页面聊天」默认是不勾选的。如果你经常需要总结当前网页,可以打开 Page Assist 设置 →「一般设置」,找到并开启「默认启用与网站聊天」,之后每次呼出侧边栏都会自动关联当前打开的网页。
对话响应偏慢或偶尔超时怎么办?¶
中国大陆网络环境建议把「基础 URL」切换到亚洲节点 https://asia.qcode.cc/openai/v1;海外北美或欧洲网络可改用 https://us.qcode.cc/openai/v1。如果个别网页环境下出现浏览器跨域拦截,也可以在「OpenAI 兼容 API」里编辑 QCode 提供商,尝试打开 Fix CORS issues 开关后保存。
接入速览¶
| 项目 | 说明 |
|---|---|
| 软件形态 | 浏览器扩展(Edge / Chrome / Firefox),支持独立 Web UI 与网页侧边栏 |
| 协议与基础 URL | OpenAI 兼容:https://api.qcode.cc/openai/v1 |
| API 类型 | Custom |
| 可用模型 | GPT ✅(推荐 gpt-6.2-sol)· 国产模型 ✅(如 deepseek-v4.1-flash、glm-5.3、kimi-k3)· Claude ❌(扩展未开放自定义 Anthropic Base URL) |
| 呼出侧边栏快捷键 | Ctrl+Shift+Y |
| 官方仓库 | github.com/n4ze3m/page-assist |
其他接入点¶
QCode 提供三个接入点,业务能力相同、同一把密钥通用,只区分网络路由。如需切换,在「OpenAI 兼容 API」编辑 QCode 行的「基础 URL」即可:
| 节点 | OpenAI 兼容基础 URL |
|---|---|
| 全球(默认) | https://api.qcode.cc/openai/v1 |
| 亚洲(中国大陆首选) | https://asia.qcode.cc/openai/v1 |
| 北美 / 欧洲 | https://us.qcode.cc/openai/v1 |
可用模型¶
在 Page Assist 的「模型列表」或「添加新模型」中,可按场景选择以下 OpenAI 兼容模型:
| 模型 | 模型 ID | 适用场景 |
|---|---|---|
| GPT 6.2 Sol | gpt-6.2-sol |
默认推荐,网页总结与日常问答均衡主力 |
| GPT 6.2 Astra | gpt-6.2-astra |
高阶复杂推理与深度长文分析 |
| DeepSeek V4.1 Flash | deepseek-v4.1-flash |
响应快速,适合高频轻量网页问答 |
| DeepSeek V4 Pro | deepseek-v4-pro |
复杂推理与技术文档解读 |
| GLM 5.3 | glm-5.3 |
国产主力,中文总结自然流畅 |
| Kimi K3 | kimi-k3 |
长文本阅读与多轮网页追问 |
更多国产模型 ID 见 国产模型接入,实时可用列表以 qcode.cc/models 为准。
相关文档¶
- 接入点与 API 格式 — 协议与模型家族对照表
- 模型选择指南 — 不同场景如何挑选合适模型
- 国产模型接入 — OpenAI 兼容端点可用国产模型清单
- 故障排查 — 常见连接与鉴权问题排查
- Page Assist 官方仓库
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models