配置 AI 助理

NTQ 内置 AI 助理"新茶"，能在工作台右下角与你对话，辅助查阅文档、解释回测报告、回答 NTQ 相关问题。

AI 助理需要你自己配置 API Key 才能使用——NTQ 不内置任何付费账号。

前置条件

• NTQ 已安装并打开 UI（python launcher.py）
• 至少有一个供应商目录已就绪（安装包默认带 7 个供应商，无需额外操作）

第一步：打开设置页

在 NTQ 工作台导航中进入 设置 → AI 助理。

页面会列出本机已发现的所有供应商，每个供应商显示：

第二步：选择供应商

NTQ 支持所有 OpenAI 兼容接口的供应商。安装包自带以下 7 个：

推荐选择：

• 国内用户首推 DeepSeek 或 智谱 GLM——价格低、速度快、中文理解好
• 需要更强推理能力可选 OpenAI 或 OpenRouter（后者可聚合多家模型）
• 硅基流动和 OpenRouter 提供免费额度，适合先试用

第三步：获取 API Key

以 DeepSeek 为例：

1. 访问 platform.deepseek.com
2. 注册账号
3. 在控制台找到 API Keys 页面
4. 创建一个新的 API Key，复制保存

其他供应商的获取方式类似——注册后在控制台创建 API Key。

第四步：在 NTQ 中配置

1. 回到 NTQ 的 设置 → AI 助理 页面
2. 找到你要使用的供应商（如 DeepSeek）
3. 在 API Key 输入框中粘贴密钥
4. 点击 保存

保存成功后：

• 页面提示"已保存 xxx 的 API Key"
• 状态变为"已配置 API Key"
• 输入框自动清空（页面不会回读明文密钥，这是安全设计）

第五步：开始对话

1. 点击工作台右下角的 AI 助理浮动按钮
2. 聊天面板打开后，底部输入框显示"可以问任何 NTQ 问题，例如：我该怎么制定一个策略？"
3. 输入问题，按 Ctrl+Enter（Mac 为 Cmd+Enter）发送

AI 助理能做什么

AI 助理不能做什么

• 不能替你改文件或跑命令——只能根据注入的文档和你贴出来的内容回答
• 不保存对话历史——每次新对话从零开始（当前版本不跨会话记忆）
• 不做实盘建议——NTQ 是研究工具，AI 助理不提供投资建议

工作原理

用户发送消息
    ↓
AssistantManager 挑选本机已配置的供应商
    ↓
context_library 扫描 context/global、context/wiki、context/know_how
    ↓
挑选最相关的 3 篇文档（上限 32000 字符）拼入系统提示
    ↓
调用供应商的 OpenAI 兼容 /chat/completions 接口
    ↓
返回助手文本

系统提示模板：

你是 New Tea Quant（NTQ）内置助理。帮助用户理解 NTQ 术语与原则、撰写与修改策略、解读回测或选股报告，并回答金融相关问题。回答简洁、准确，使用 Markdown。优先依据下方说明书。说明书没有的不要编造，并说明不确定。

添加自定义供应商

如果你想接入未内置的供应商（只要支持 OpenAI 兼容接口即可）：

1. 在 userspace/extensions/assistant/providers/ 下创建新目录（目录名即 provider_id）
2. 创建 config.py：

PROVIDER = {
    "base_url": "https://your-provider.com/v1",
    "model": "your-model-name",
    "enabled": True,
}

1. 在 NTQ 设置页粘贴 API Key（或手动创建 api_key.txt）

3 个必填字段：

常见问题

没有可用的供应商

设置页显示空列表：检查 userspace/extensions/assistant/providers/ 下是否有供应商目录，且每个目录下有合法的 config.py。

聊天报错"未配置 API Key"

在设置页对应供应商的 API Key 框中粘贴密钥并保存。密钥文件存储在 userspace/extensions/assistant/providers/<id>/api_key.txt。

聊天报错"供应商已禁用"

在供应商目录的 config.py 中把 "enabled" 改为 True。

响应很慢

• 检查网络是否需要代理（部分供应商需要科学上网）
• 尝试换一个国内供应商（如 DeepSeek、智谱）
• 默认超时 60 秒

密钥安全

• API Key 以文件形式存储在本地 userspace/ 下，不上传云端
• 文件权限为 0o600（仅所有者可读写）
• 设置页不回读明文密钥
• 打包或分发 userspace 时会自动剥离密钥
• 不要把密钥贴进策略代码或对话记录里

技术细节