PKU harnessAI 服务
先设置好 AI 模型：在中国大陆选择哪家服务商（DeepSeek、阿里云百炼、百度千帆），怎样一步一步申请 API Key、在哪里填写，以及账户余额、上下文预算和费用。
PKU harness 的助手需要一个大模型来理解你的话并替你操作。App 不附带模型，我们也不运营模型服务。你需要在模型服务商那里开一个账户，创建一个 API Key，再把它填进 App。API Key 是一串很长的字符，通常以 sk- 开头，作用相当于服务商那边的密码。
密钥保存在手机的安全存储中，只会发送给你选择的服务商。你的对话内容从手机直接发给这家服务商。服务商按用量收费：你先给账户充值，每次回复花掉一小笔钱。
推荐的服务商
任何提供 OpenAI 兼容接口的服务都可以使用。对中国大陆的同学来说，下面三家付款方便，不需要代理也能访问。
| 服务商 | 在 App 中怎样接入 | 接口地址（Base URL） | 模型示例 |
|---|---|---|---|
| DeepSeek | 「DeepSeek」（内置，默认） | https://api.deepseek.com，固定 | DeepSeek-V4.1-Flash、DeepSeek-V4-Pro |
| 阿里云百炼（千问模型） | 「OpenAI 兼容」 | https://dashscope.aliyuncs.com/compatible-mode/v1 | qwen3.7-plus、qwen3.8-flash |
| 百度千帆（文心模型） | 「OpenAI 兼容」 | https://qianfan.baidubce.com/v2 | ernie-5.1、ernie-4.5-turbo-128k |
模型名称经常更新，请以服务商的模型列表为准：百炼模型列表、千帆模型列表。
怎样选择
DeepSeek 最简单，也是我们首先推荐的。App 认识它的模型，所以：
- 不需要填写接口地址和模型名称。
- App 知道每个模型的上下文长度（100 万 token），也知道它能不能看图片。DeepSeek-V4.1-Flash 支持图片，可以发送照片，Copilot 也能使用截图；DeepSeek-V4-Pro 不支持。
- 「设置 → 用量」按 DeepSeek 公开的价格估算花费，「设置 → AI 服务」可以显示账户余额。
阿里云百炼和百度千帆通过「OpenAI 兼容」接入。如果你已经有这两家的账户，或者更喜欢它们的模型，可以选择它们。百炼还有一个好处：同一个账户也能申请语音输入用的 Key。用这种方式接入的模型，App 了解得少一些：
- App 按 128k token 估计上下文长度，并据此压缩对话。
- App 不为这些模型提供图片附件，所以不能发送照片，Copilot 也不能用截图。
- 「设置 → 用量」会统计它们的 token，但无法估算花费，App 也不能显示余额。这两项请在服务商的控制台查看。
申请 DeepSeek API Key
注册账户
用浏览器打开 platform.deepseek.com，例如用手机号注册。充值前，平台可能要求你完成实名认证。
充值
打开「充值」页面，用微信或支付宝充一小笔钱，例如 10 元。余额为零时，调用会失败，并提示「账户余额不足」。
创建 Key
点左侧菜单的「API keys」，再点「创建 API key」。起一个容易认出的名字，例如 PKU harness，然后创建。立刻复制这个 Key：完整的 Key 只显示一次。
申请阿里云百炼 API Key
注册账户
在 aliyun.com 注册阿里云账号。使用付费服务前，阿里云通常要求完成实名认证，按控制台的提示操作即可。
创建 Key
打开 API Key 页面，点「创建 API Key」，保持默认设置并确定。立刻复制这个 Key：完整的 Key 只显示一次。
填进 App
打开「设置 → AI 服务」，点「OpenAI 兼容」。把「Base URL」设为 https://dashscope.aliyuncs.com/compatible-mode/v1，把 Key 粘贴到「API Key」，在「模型 ID」里填写模型名称，例如 qwen3.7-plus。点「保存并测试连接」。
百炼的每次调用都计入你的阿里云账户。新账户有时会获得部分模型的免费额度，具体以控制台显示为准。
上面的接口地址是百炼 API Key 文档中北京地域的地址。百炼的 OpenAI 兼容说明还列出了一个业务空间地址 https://<WorkspaceId>.cn-beijing.maas.aliyuncs.com/compatible-mode/v1，并建议使用它以获得更好的稳定性。两个地址都可以使用。
申请百度千帆 API Key
注册账户
在 cloud.baidu.com 注册百度智能云账号。如果控制台要求实名认证，请先完成。
创建 Key
在控制台打开「安全认证 → API Key」，点「创建 API Key」。Key 的样子类似 bce-v3/ALTAK-…/…，复制时要包括开头的 bce-v3/。
填进 App
打开「设置 → AI 服务」，点「OpenAI 兼容」。把「Base URL」设为 https://qianfan.baidubce.com/v2，把 Key 粘贴到「API Key」，在「模型 ID」里填写模型名称，例如 ernie-5.1。点「保存并测试连接」。
接口地址和 Key 的格式来自千帆的快速开始。调用费用计入你的百度智能云账户。
在 App 中填写
可以在首次设置中连接，也可以之后在设置里修改。设置页的选项最完整。
- 打开「设置 → AI 服务」。
- 点一个服务商：「DeepSeek」或「OpenAI 兼容」。
- 在「模型」下点选一个模型，或在「模型 ID」里填写模型名称。「OpenAI 兼容」需要手动填写；测试成功后，App 也会列出服务商返回的模型。
- 选择「OpenAI 兼容」时，填写「Base URL」。DeepSeek 的地址是固定的，页面上显示为「接口地址：https://api.deepseek.com」。
- 在「API Key」里粘贴密钥。已保存的密钥会标注「已保存在本机安全存储」。
- 点「保存并测试连接」。App 会发送一条很短的测试消息，成功后显示「连接成功：」和模型的回复。只想保存、不测试，点「仅保存」。
测试失败时，提示会说明原因，见常见问题 → AI 服务。
助手不能读取或填写 API Key。如果你在对话里让它改 Key，它会打开这个页面，由你自己填写。
账户余额
选择 DeepSeek 并保存 Key 后，「AI 服务」页面会出现「账户余额」，显示余额以及其中赠送和充值的部分（「赠送 … · 充值 …」）。点按可以刷新。如果服务商提示余额不足以发起请求，页面会说明；到服务商网站充值后即可继续使用。
其他服务商的余额请在它们的控制台查看。
切换模型
在对话页点输入框下方的模型标签，或输入 /model，可以选择其他模型。新模型从下一条消息起用于这个对话，也会成为新对话的默认模型。详见对话 → 模型和上下文。
也可以直接告诉助手，例如「切换到 DeepSeek-V4-Pro」。它会修改设置，并告诉你改了什么，见设置 → 在对话中修改设置。
上下文预算
模型看到的对话内容叫作「上下文」。「设置 → AI 服务」底部的「上下文预算」限制 App 每次发送多少上下文，可选「32k」「64k」「128k」「256k」和「模型上限」，默认是「模型上限」。
选择「模型上限」时，App 使用模型的完整上下文，对话用到 90% 时把较早的内容压缩成摘要。DeepSeek 的上下文是 100 万 token，也就是大约 90 万时压缩。预算越小，回复越快、越省钱，但助手直接看到的对话也越少。长任务进行到一半时也会压缩，任务会接着做下去。
用量和费用
服务商按 token（文本片段）数量收费，发送和接收的内容都计入。对话越长、附件越多、Copilot 任务越长，用的 token 就越多。
「设置 → 用量」显示 token 用量、活跃时段与常用工具，可以选择「7 天」「30 天」或「全部」。对于公布了价格的模型（例如 DeepSeek），页面会估算花费。估算仅供参考，以服务商的账单为准。详见设置与数据 → 用量。