AI 密钥门与助手就绪条件
密钥门是本机没有任何可作答的引擎时，每个 Senzoukria 助手都会显示的那块界面：它接收一个 Claude 密钥或 Groq 密钥，存入操作系统密钥库，一旦有可用引擎就放行。
Senzoukria · 文档 · 更新于 2026 年 9 月
位置
- 位置
- AI 助手页面，以及图表、回测、脚本、报告和连接助手，直到有可用引擎为止
- 接受的密钥
- Claude 密钥（以 sk-ant- 开头）或 Groq 密钥（以 gsk_ 开头）
- 存储
- 操作系统密钥库；应用绝不把它写入磁盘
- 默认引擎
- claude（引擎存储的默认值）；保存 Groq 密钥会把引擎切换为 groq
它做什么
这道门是一张标题为「唤醒 Sen」的卡片。它只有一项任务：收集一个 API 密钥，好让助手能够作答。Claude 表单接收以 sk-ant- 开头的密钥；标题下方的文字写明该密钥存放在你的系统密钥库中，绝不写入磁盘，除 api.anthropic.com 外不发往任何地方。第二个表单以「或者用 Groq 免费开始」引出，接收以 gsk_ 开头的密钥，保存成功后把引擎切换为 Groq。两个表单在输入至少 8 个字符之前都禁用按钮，并在保存密钥时显示「正在保存…」。
这道门并不是唯一的入口。就绪钩子（useAssistantReady）先检查是否存在 Claude 密钥；存在则助手就绪。若不存在，它会探测配置地址上的本地引擎，当引擎可连接且至少列出一个模型时，判定助手就绪。因此一台有可用本地模型的机器即便没有任何密钥，也永远看不到这道门。
引擎的选择不在这里进行。这张卡片刻意不包含模型选择器：早期版本有一个，但那个选择没有任何地方读取，于是被移除了。通过这道门之后，引擎在聊天顶栏的模型选择器中选择。
设置项
| 设置 | 默认值 | 它改变什么 |
|---|---|---|
| Claude 密钥字段 | 空，占位符 sk-ant-… | 把密钥存入密钥库，并把助手标记为就绪 |
| Groq 密钥字段 | 空，占位符 gsk_… | 保存 Groq 密钥，并把引擎设为 groq |
| 提交按钮启用条件 | 去除空格后满 8 个字符 | 避免保存一个明显被截断的密钥 |
| 本地引擎放行 | 仅在没有 Claude 密钥时探测 | 当可连接的本地引擎至少列出一个模型时放行 |
| 就绪状态重新测量 | 引擎或基础地址变化时 | 切换到本地模型会重新探测，而不是沿用旧的判定 |
怎么用
- 在 console.anthropic.com 获取一个 Claude 密钥（卡片上有链接），粘贴进来，按「唤醒 Sen」。
- 或者在 console.groq.com 获取一个免费密钥，粘贴到第二个表单里，按「使用 Groq（免费）」。之后引擎会用 Llama 3.3 70B 这类开源模型作答。
- 如果你改用本地模型，请在模型选择器中配置：探测到模型时，这道门会在没有任何密钥的情况下消失。
- 另外五个助手（脚本、回测、图表、报告、连接）会出现同一道门。通过一次即处处通过，因为所有助手使用同一条就绪规则。
限制与陷阱
- 密钥是你的，每条消息都由提供方按它计费。卡片写明 Claude 密钥除 api.anthropic.com 外不发往任何地方；应用本身不额外设置任何配额。
- 这道门不会测试已保存的密钥。请在引擎设置中使用「测试此引擎」，以确认提供方是否真的应答。
- 保存过程中的错误会以原始错误字符串显示在表单下方；按钮会重新启用，方便你重试。
- Groq 这条路径不读截图，并被提供方按分钟限速；模型选择器中对此有说明。
相关页面
其他语言版本
常见问题
- 我的 API 密钥存在哪里？
- 存在操作系统的密钥库中。应用不会把它写入磁盘，也只在本机使用，正如设置中「密钥已存入密钥库」那句话所示。
- 没有任何 API 密钥能用助手吗？
- 可以，用本地模型。没有 Claude 密钥时，就绪检查会探测本地引擎，一旦引擎可连接且至少列出一个模型就放行。
- 这道门为什么不让我选模型？
- 通过之后，模型选择器就在聊天顶栏里。这道门只负责收集密钥；卡片上早期那个选择器因为什么都控制不了而被移除。