数据源

数据源是 Hifox 连接外部工具、文件系统和服务的方式。通过添加数据源，AI 可以直接读取和操作你的实际数据，而不只是提供建议。

数据源类型

Hifox 支持三类数据源：

类型	说明	适用场景
MCP 服务器	通过 Model Context Protocol 协议连接工具	GitHub、Linear、Notion、自定义服务
REST API	通过 HTTP API 连接云服务	Google 服务、Slack、Microsoft 365
本地文件	直接读写本地文件夹和应用	文件系统、Obsidian、Git 仓库

添加数据源

打开 工作区设置 → 数据源

点击 添加数据源

选择数据源类型

填写连接信息

点击 测试连接 验证是否正常

保存

添加成功后，在聊天时可以用 @数据源名称 引用该数据源，告诉 AI 在完成任务时使用哪个数据源。

MCP 服务器

MCP（Model Context Protocol）是一个开放协议，允许 AI 与外部工具进行标准化通信。

连接外部 MCP 服务器（HTTP/SSE）

适用于提供在线 MCP 服务的平台（如 Linear、Notion 官方 MCP）：

选择数据源类型 MCP

选择传输方式 HTTP 或 SSE

填入服务器 URL

选择认证方式（OAuth 或 Bearer Token）

完成授权流程

连接本地 MCP 服务器（stdio）

适用于在本地运行的 MCP 服务器进程：

{
  "type": "mcp",
  "mcp": {
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"],
    "env": {
      "MY_TOKEN": "secret"
    }
  }
}

常用 MCP 服务

服务	说明
飞书 MCP	读写飞书文档、消息、日历
钉钉 MCP	读取钉钉消息、群组数据
GitHub MCP	读取仓库、PR、Issues、代码
Gitee MCP	国产代码托管平台
Linear MCP	管理项目、任务、里程碑
Notion MCP	读写 Notion 页面和数据库
Filesystem MCP	读写本地文件和目录

REST API 数据源

飞书（文档、消息、日历）

飞书支持通过 MCP 或自建 REST API 接入。推荐使用社区提供的飞书 MCP Server，或在 Hifox 中直接告诉 AI「我想连接飞书」，它会引导你完成配置。

钉钉 / 企业微信

通过各平台提供的 API 或 MCP 接入，在 Hifox 的 REST API 数据源中填入你的 Access Token 和 App ID 即可。

Google 服务（Gmail、日历、Drive）

Google 集成需要你自己创建 OAuth 凭证：

前往 Google Cloud Console 创建项目

在 API 和服务 → 库 中启用所需 API（Gmail API、Calendar API、Drive API）

在 API 和服务 → 凭证 中创建 OAuth 2.0 客户端 ID（桌面应用类型）

记下 客户端 ID 和 客户端密钥

在 Hifox 中添加 Google 数据源，填入凭证

或者直接告诉 AI「我想连接 Gmail」，它会引导你完成配置。

Slack

需要在 Slack 中创建应用或使用已有 OAuth 凭证（Slack OAuth Client ID 需已在构建中配置）

在 Hifox 中选择 Slack 数据源

按照 OAuth 流程授权

Microsoft（Outlook、Teams、OneDrive）

选择 Microsoft 数据源

选择需要的服务（Outlook 邮件、日历、OneDrive、Teams、SharePoint）

按照 Microsoft OAuth 流程授权

本地文件数据源

允许 AI 直接读写你的本地文件夹：

添加本地文件夹

选择数据源类型 本地文件

选择或输入文件夹路径

可选：指定格式提示（filesystem、obsidian、git、sqlite）

特殊格式支持

格式	说明
`filesystem`	通用文件系统操作
`obsidian`	Obsidian 知识库（理解笔记链接和标签）
`git`	Git 仓库（可执行 git 命令）

在会话中使用数据源

通过 @mention 引用

在聊天输入框中输入 @ 可以引用已添加的数据源：

@github 帮我列出这周新增的 Issues
@drive 找一下包含"季度报告"的文档
@local-files 整理一下项目文件夹

启用/禁用数据源

在工作区设置中可以随时启用或禁用特定数据源，不影响其他配置。

权限与安全

AI 对数据源的操作受当前 权限模式 限制

在 只读模式 下，AI 只能读取数据，无法写入或修改

在 确认模式 下，任何写操作都会先弹窗请求你的确认

所有凭证（Token、API Key、OAuth 令牌）均加密存储在本地

运行本地 MCP 服务器时，Hifox 会自动过滤敏感环境变量（如 ANTHROPIC_API_KEY、GITHUB_TOKEN），防止凭证泄露到子进程

数据源文件结构

每个数据源的配置保存在：

~/.anakin/workspaces/{workspaceId}/sources/{sourceSlug}/
├── config.json    # 连接配置（URL、认证类型等）
└── guide.md       # 使用指南（AI 参考此文件了解如何使用该数据源）

你也可以直接编辑 guide.md 为 AI 提供更多上下文信息，例如API 的使用规范、常用接口说明等。

数据源类型#

添加数据源#

MCP 服务器#

连接外部 MCP 服务器（HTTP/SSE）#

连接本地 MCP 服务器（stdio）#

常用 MCP 服务#

REST API 数据源#

飞书（文档、消息、日历）#

钉钉 / 企业微信#

Google 服务（Gmail、日历、Drive）#

Slack#

Microsoft（Outlook、Teams、OneDrive）#

本地文件数据源#

添加本地文件夹#

特殊格式支持#

在会话中使用数据源#

通过 @mention 引用#

启用/禁用数据源#

权限与安全#

数据源文件结构#