> ## Documentation Index
> Fetch the complete documentation index at: https://docs.study.faroapi.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 DeepSeek Harness 里连接 Open Study

> DeepSeek Harness 不会打开网页授权：在网站「开发者密钥」建一把完整访问的密钥，写进补丁的请求头里连接 Open Study。

这是 DeepSeek Harness 命令行，不是 DeepSeek 网页聊天。它的官方 MCP 客户端（`@deepseek-ai/dsh-mcp-client`）不会打开浏览器走网页授权，只能在请求头里带密钥，所以要先在网站建一把开发者密钥。

> [!NOTE]
>
> 这一页按 DeepSeek Harness 的官方说明整理，我们还没有逐步实测。和你看到的界面不一致时，以官方说明为准，也欢迎[告诉我们](https://docs.study.faroapi.cn/help/contact.md)。

## 安装

1. 登录网站，打开左侧 **开发者密钥**，点 **新建密钥**。权限选 **完整访问**（选只读连不上），有效期按需要填，点 **创建密钥**，复制出现的密钥。密钥只显示这一次，由你自己保存好，不要发给 AI。
2. 把下面这段合并进 `$DSH_HOME/cordis.patch.yml`（只给某个配置档用就放 `$DSH_HOME/profiles/<名字>/cordis.patch.yml`），把 `osk_你的密钥` 换成刚复制的密钥。文件里已有别的补丁时只追加这一段，不要整份覆盖。
3. 登录网站，打开左侧 **快速开始**，在页面下方下载 **标准插件** 包并解压到一个固定目录。你装的版本能加载 Skill 的话，把包里 `skills/open-study` 整个目录按 DeepSeek Harness 当前的 Skill 说明放好。

补丁的写法：

```yaml theme={null}
- insert:
    - id: open-study
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: open-study
        transport: streamable-http
        url: https://study.faroapi.cn/mcp
        headers:
          Authorization: Bearer osk_你的密钥
```

## 授权

不用网页授权：请求头里的密钥就是授权。这把密钥等于你的账号权限，别人拿到就能用你的资料和积分；不用了就在 **开发者密钥** 里删掉，换了密钥要同步改补丁文件。

登录要用 Open Study 账号；还没有就先到 [study.faroapi.cn](https://study.faroapi.cn) 注册。密钥由你自己填进配置文件，不用发给 Agent。

## 也可以让 AI 带你装

这一节写给人看：登录网站，打开左侧 **快速开始**，点 **DeepSeek Harness** 那张卡片，在 **提示词** 页签复制安装提示词，在 DeepSeek Harness 里新开一个对话发过去。它会读这一页，能代你做的直接做，要在界面上点的会告诉你点哪里。密钥要你自己建、自己填。

## 确认能用

退出当前会话重新启动 DeepSeek Harness，把这段发过去：

请使用 Open Study 查询我的资料库，列出最多三条资料标题和内容 ID。没有资料就说明为空；还没连上就告诉我下一步。只查询已有资料，不整理新视频。

请使用 Open Study 查询我的资料库，列出最多三条资料标题和内容 ID。没有资料就说明为空；还没连上就告诉我下一步。只查询已有资料，不整理新视频。

收到资料列表或「资料库为空」，就说明连上了。

## 更新

网站 **快速开始** 出现新版本时，下载新的标准插件，用里面的 `skills/open-study` 整个替换旧目录。连接地址不变；提示需要授权时，按上面「授权」一节再做一次。更新后退出当前会话重新启动 DeepSeek Harness。

## 遇到问题

* **连上了却没有 Open Study 的工具**：确认密钥是 **完整访问**、没有过期，也没有在 **开发者密钥** 里被删掉；`Bearer` 和密钥之间要有一个空格。
* **其他情况**：见[插件更新与连接问题](https://docs.study.faroapi.cn/connect-ai/update-troubleshoot.md)。
* **DeepSeek Harness 官方说明**：[DeepSeek Harness MCP 客户端](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/README.md)、[DeepSeek Harness 接 MCP 的说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/mcp-memory.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.