HammerAI是什么？
HammerAI是一款本地优先的AI角色聊天和写作应用程序，带有外部LLM Proxy Mode。
本 HammerAI 指南使用官方 Proxy Mode 字段：以 /v1 结尾的 API 基础、确切的提供程序模型名称、API 密钥以及仅应在已知时设置的可选上下文长度。 Proxy Mode 将字符聊天模型请求路由到外部 API，同时 HammerAI 继续提供本地对话接口。使用 API 根和确切的模型名称，将上下文长度留空，除非验证值已知，并在测试短响应和较长会话之前重新加载聊天。
HammerAI 官方的 Proxy Mode 会把 Character Chat 的生成请求交给外部 OpenAI-compatible 服务。它只要求四个 Proxy 字段，不需要下载本地模型，也不使用 HammerAI 的托管模型账号。
按官方界面启用 Proxy
- 打开任意 Character Chat。
- 在右侧面板切换到 Settings。
- 找到 LLM 下拉列表。
- 滚动到列表底部，选择 Proxy。
- Proxy 表单出现后按下方填写。
四个字段对应 TokenHub 的值
- Proxy URL：
https://us-api.tokenhub.com/v1 - Proxy Model：TokenHub 模型广场中的完整 Model ID
- Proxy API Key：TokenHub API Key
- Proxy Context Length：可选；不知道真实上限时留空
官方示例中的 Proxy URL 都是 API Base，例如 LM Studio 的 /v1，不是完整请求路径。HammerAI 新版本也会裁剪误填的 /chat/completions 或 /completions 后缀，但这里应直接填写 /v1 根地址。
Web 版与 Desktop 版的差异
TokenHub 是远程 HTTPS 服务，通常不需要额外 CORS 设置。只有 HammerAI Web 连接本机 LM Studio 等服务时，上游才必须允许跨域；不要为远程 TokenHub 地址套用本地服务的 CORS 教程。
让 Proxy 配置真正生效
保存后先发送一条短消息，并在 TokenHub 请求日志确认 Model ID。官方说明某些服务需要完整重载应用才能建立连接；若字段已确认无误但仍无响应，重载 HammerAI 后再试。
长对话失败时先清空或修正 Proxy Context Length；401 检查 Proxy API Key；404 检查 Proxy URL 是否只到 /v1；模型不存在则重新复制 Proxy Model。这四项逐一核对比套用本地模型参数更有效。
官方资料
推荐模型怎么选？
HammerAI Proxy Mode FAQ
我应该输入什么作为代理 URL？
输入以 /v1 结尾的 TokenHub API 基数。 HammerAI 的官方 Proxy Mode 示例使用基本 URL 而不是 complete 请求路径。
我应该填写Proxy Context Length吗？
它是可选的。当您不知道模型的最大上下文时，将其留空；否则输入准确值。
为什么我保存后代理没有反应？
检查 Base URL、确切的型号名称和 API 密钥，然后重新加载聊天。官方 HammerAI 指南指出，某些服务需要完全重新加载。
HammerAI将Proxy Mode中的数据发送到哪里？
该角色聊天的模型请求将转到配置的外部 API，而 HammerAI 提供本地接口。使用前检查每个服务的数据处理。
如何安全测试 HammerAI Proxy Mode？
保存后重新加载聊天，发送短信，并在长时间对话之前在 TokenHub 日志中确认确切的型号和请求状态。
配置资料
本页配置以 TokenHub 教程和官方资料为依据，最后核验于 2026-09-08。
