SuperAPI AI 工具集

actual-setup

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:把 actual.inc(Actual Computer)接入 Hermes 作为推理提供方。Actual 可将用户自有硬件变成私有推理集群,并以 OpenAI 兼容 API 暴露:托管端到端加密中继 https://api.actual.inc(用 ac_ 密钥认证),以及本地守护进程 http://127.0.0.1:8080(回环无认证)。本技能不代装 Actual 守护进程,设备授权需人工在浏览器完成。

适用场景:添加 actual.inc 为提供方(云端中继或本地);已有 ac_ 密钥并希望 Hermes 走自己的 Actual 集群;希望完全本地推理;排查 Actual 请求出现 400 或空流。

前提:Hermes 已内置 actual 提供方(id actual,别名 actual-computer、actualcomputer、aci),不要再用 custom_providers 或 providers.actual.* 配置。中继模式需 Actual 账号与 https://actual.inc/user/keys 的 ac_ 密钥;本地模式需已安装守护进程(curl -fsSL "https://actual.inc/install" | bash)并完成设备授权(运行 actual 后打开打印的 https://actual.inc/device?code=... 链接,5 分钟过期,需等待用户操作)。

用法:中继模式把 ACTUAL_API_KEY=ac_... 写入 ~/.hermes/.env,用 curl -s https://api.actual.inc/v1/models -H "Authorization: Bearer $ACTUAL_API_KEY" 验证并发现模型,再执行 hermes config set model.provider actual 与 hermes config set model.default "MODEL_ID",最后用 hermes chat -Q -q "Reply with exactly: ACTUAL_OK" --provider actual -m MODEL_ID 验证。本地模式先 actual models search、actual models download(必须指定量化,否则 409)、actual models list、actual models load,再把 ACTUAL_BASE_URL=http://127.0.0.1:8080 写入 .env,设置 provider 与模型名,用 -t file,web 减少工具集验证。

限制与注意:reasoning_effort 仅支持 none/low/medium/high/max,内置提供方会自动钳制;小上下文本地模型易因工具 schema 溢出而返回空流,可限制工具或增大 n_ctx;下载 id 与安装名不同;推理模型可能把 max_tokens 耗尽在 reasoning 字段;不要创建名为 actual 的自定义提供方。其他 OpenAI 兼容客户端见 references/opencode.md。