常见问题（FAQ）

基础问题

Hifox 是免费的吗？

Hifox 应用本身完全免费开源。你需要自行准备 AI 模型的 API Key，使用费用按各提供商的定价直接结算，没有中间商赚差价。

推荐国产平台：MiniMax、DeepSeek、通义千问、豆包等提供国内稳定访问，注册即可使用。也支持 Anthropic、OpenAI 等海外模型，以及使用 GitHub Copilot / ChatGPT Plus 订阅通过 OAuth 直接登录，无需额外费用。

Hifox 支持哪些操作系统？

macOS（Apple Silicon 和 Intel）

Windows 10/11

Linux（主流发行版）

支持哪些 AI 模型？

国产模型（推荐）：

MiniMax（MiniMax-M2.5）— 国内访问稳定 ⭐

DeepSeek（deepseek-chat V3.2 / deepseek-reasoner）

通义千问（qwen3-max / qwen-plus）

豆包（doubao-seed-2-0-pro，字节跳动）

文心一言（ernie-4.5-turbo-128k，百度）

Kimi（kimi-k2.5，月之暗面）

智谱 GLM（glm-4.7 / glm-4.7-flash 免费）

海外模型：

Anthropic Claude（claude-opus / claude-sonnet 等）

Google Gemini（gemini-2.0-flash 等）

OpenAI GPT（通过 ChatGPT Plus 或 Codex OAuth）

GitHub Copilot

通过自定义端点支持：

OpenRouter（数百个模型）

Ollama（本地运行开源模型）

任何 OpenAI 或 Anthropic 兼容的 API 端点

我的文件会上传到 Hifox 服务器吗？

不会。Hifox 是本地运行的桌面应用，你的文件只在本地处理，通过你选择的 AI API 发送给对应的 AI 提供商（国产模型如 MiniMax、DeepSeek，海外模型如 Anthropic、OpenAI），不经过 Hifox 的服务器。

功能使用

如何在聊天中引用我的文件夹？

先在 工作区设置 → 数据源 中添加本地文件夹数据源

在聊天中输入 @数据源名称 引用它

例如：@my-project 帮我找一下包含 TODO 的文件

AI 可以修改我的文件吗？

可以，但受权限模式控制：

只读模式：AI 无法修改任何文件

确认模式（默认）：修改前会弹出确认窗口，你批准后才执行

自动模式：AI 会直接修改，不需要你的确认

在聊天界面按 Shift+Tab 切换权限模式。

如何创建技能（Skills）？

技能是 Hifox 的工作规范文件，告诉 AI 如何完成特定类型的任务：

打开 工作区设置 → 技能，点击新建

或者直接在 ~/.anakin/workspaces/{id}/skills/ 目录中创建文件夹和 SKILL.md

使用时在聊天框中输入 @技能名称 即可调用。

详见技能（Skills）。

Hifox 如何处理长对话？

超过约 60KB 的工具响应（如读取大文件的结果）会自动使用轻量级 AI 模型进行压缩摘要，保留关键信息的同时控制上下文长度，避免超过模型限制。

可以同时运行多个会话吗？

可以。Hifox 支持多会话管理，你可以同时运行多个 AI 会话，每个会话独立处理，互不干扰。

会话历史保存在哪里？

会话历史以 JSONL 格式保存在本地：

~/.anakin/workspaces/{workspaceId}/sessions/

不会自动上传到任何服务器。

数据源连接

连接 GitHub 需要什么权限？

GitHub MCP 连接只需要你提供 Personal Access Token（PAT）或 OAuth 授权。根据你的使用场景，建议申请最小必要权限：

读取代码：repo:read

读写 Issues/PR：repo

Google 集成需要创建自己的 OAuth 应用吗？

是的。Hifox 不内置 Google OAuth 客户端凭证，你需要在 Google Cloud Console 创建自己的 OAuth 2.0 客户端（桌面应用类型），然后将 Client ID 和 Client Secret 填入数据源配置。

这是一次性设置，详见数据源。

为什么我的数据源显示"连接失败"？

常见原因：

Token 或 API Key 过期：重新生成并更新凭证

网络问题：检查网络连接是否正常

OAuth 令牌过期：点击数据源的"重新授权"按钮

MCP 服务器未运行（本地 stdio 类型）：启动对应的服务进程

自动化

自动化任务的提示有延迟是正常的吗？

是的。SchedulerTick 事件默认每分钟检查一次，因此定时任务可能有最多 1 分钟的延迟，这是正常行为。

如何暂时禁用某个自动化而不删除它？

在 automations.json 中对应规则内添加 "enabled": false 字段即可：

{
  "cron": "0 9 * * 1-5",
  "enabled": false,
  "actions": [...]
}

故障排除

如何查看调试日志？

在命令行启动 Hifox 时加上 --debug 参数：

macOS：

Windows（PowerShell）：

& "$env:LOCALAPPDATA\Programs\Hifox\Hifox.exe" -- --debug

日志文件位置：

macOS：~/Library/Logs/@craft-agent/electron/main.log

Windows：%APPDATA%\@craft-agent\electron\logs\main.log

Linux：~/.config/@craft-agent/electron/logs/main.log

凭证泄露了怎么办？

立即在对应平台撤销泄露的 API Key 或 Token

在 Hifox 中删除该连接配置

重新生成新的凭证并添加到 Hifox

检查使用日志，评估泄露造成的影响

基础问题#

Hifox 是免费的吗？#

Hifox 支持哪些操作系统？#

支持哪些 AI 模型？#

我的文件会上传到 Hifox 服务器吗？#

功能使用#

如何在聊天中引用我的文件夹？#

AI 可以修改我的文件吗？#

如何创建技能（Skills）？#

Hifox 如何处理长对话？#

可以同时运行多个会话吗？#

会话历史保存在哪里？#

数据源连接#

连接 GitHub 需要什么权限？#

Google 集成需要创建自己的 OAuth 应用吗？#

为什么我的数据源显示"连接失败"？#

自动化#

自动化任务的提示有延迟是正常的吗？#

如何暂时禁用某个自动化而不删除它？#

故障排除#

如何查看调试日志？#

凭证泄露了怎么办？#