帮你快速理解、总结文档立即下载
文档中心>腾讯云数据库 AI 服务>Memory 应用指南>Memory Hub>接入配置>DeepSeek Harness 接入 Memory 配置

DeepSeek Harness 接入 Memory 配置

最近更新时间：2026-09-01 15:02:30
我的收藏

本页目录：

概述

DeepSeek Harness（npm 包 @deepseek-ai/dsh）是 DeepSeek 官方提供的 AI 编码助手框架，基于 Cordis 插件架构，自带 Web 界面（默认访问地址 127.0.0.1:3080）。它使用标准的 OpenAI Chat Completions 协议，通过内置的 llm-deepseek 适配器连接 api.deepseek.com 或任意兼容 OpenAI 协议的接口。将该适配器指向 Memory 的 Proxy 服务后，DeepSeek Harness 即可获得团队记忆、技能与知识的注入能力。

前置条件

开始配置前，请确认已满足以下条件：
1. Memory Hub 已部署并可正常访问。
2. 已在 Memory Hub 的 API Key 页面获取以下两项信息：
客户端接入地址：找到 DeepSeek Harness 对应的地址，单击复制。
User Key：以 sk-mem- 开头的密钥，用于身份认证。
3. 已安装 DeepSeek Harness（npm 包 @deepseek-ai/dsh）。

配置步骤

DeepSeek Harness 的接入配置分布在 ~/.dsh 目录下的两个文件中：settings.yaml 指定连接地址与密钥来源，.credentials.yaml 存放密钥的实际值。
说明：
~ 表示当前登录用户的主目录，例如 Windows 下为 C:\\Users\\用户名，macOS / Linux 下为 /home/用户名 或 /Users/用户名。两个文件位于主目录的 .dsh 文件夹内；首次使用需先创建该文件夹，例如执行 mkdir -p ~/.dsh。

步骤一：配置 settings.yaml

编辑 ~/.dsh/settings.yaml，写入以下内容：
llm-deepseek:
  # 密钥变量名，保持默认即可
  apiKeyEnv: PROXY_USER_KEY

  # 接入地址，粘贴从 Memory Hub 复制的接入 DeepSeek Harness 的地址
  baseURL: http://127.0.0.1:8096/dsh/default

  # 思考强度，保持默认即可
  reasoningEffort: high
上述三个参数的含义如下：
参数
作用
是否需要修改
apiKeyEnv
指定密钥的变量名，与 .credentials.yaml 中的键名对应
否，保持 PROXY_USER_KEY
baseURL
Memory 的接入地址
是，粘贴从 Memory Hub 复制的地址。
说明：
登录 Memory Hub，进入 API Key 页面，找到 DeepSeek Harness 对应的客户端接入地址。
reasoningEffort
模型思考强度
否，保持 high

步骤二：配置 .credentials.yaml

编辑 ~/.dsh/.credentials.yaml，将 sk-mem-xxxxxxxxxxxxxxxx 替换为实际的 User Key
PROXY_USER_KEY: sk-mem-xxxxxxxxxxxxxxxx
该值与步骤一中 apiKeyEnv 指定的变量名对应——settings.yaml 声明"从 PROXY_USER_KEY 读取密钥"，本文件提供密钥的真实值。

步骤三：设置文件权限

DeepSeek Harness 会校验以下权限，配置不正确将拒绝启动：
chmod 700 ~/.dsh
chmod 600 ~/.dsh/.credentials.yaml

启动并完成首次初始化

1. 启动 Web 界面：
cd /path/to/deepseek-harness
pnpm dsh web --port 3080
# 或: node apps/cli/lib/bin.js web --port 3080
2. 打开浏览器访问 http://127.0.0.1:3080，在页面的对话框中发送任意消息（例如 hi）。Proxy 会依次返回以下选择器（按钮形式）：
是否关联团队资产（Associate team assets?）：选择 Yes 注入团队上下文，选择 No 跳过。
选择团队（Team）：仅存在一个团队时会自动跳过。
选择 Agent：在所选团队下选择 Agent。
选择任务（Task）：首行是虚拟的 "No task" 条目。
3. 完成选择后，Agent 会进行自我介绍，并在后续每轮对话中自动注入以下上下文：会话上下文（<session_context>）、可用的技能列表（<available_skills>）与用户画像记忆（<tdai_profile_memory>）。
4. 初始化完成后，可在聊天中输入以下斜杠命令使用相关能力：
mem:help：查看记忆命令的帮助。
mem:sync：同步记忆。
mem:create-skill：创建技能。

常见问题

现象
可能原因
解决方法
启动时报权限错误
.credentials.yaml 权限未设置为 600
重新执行步骤三的 chmod 命令
发送消息后提示连接失败
Proxy 未启动或接入地址不正确
确认 Proxy 服务正常运行，检查 baseURL 是否与 Memory Hub 页面一致
发送消息后无选择器弹出
User Key 无效或过期
重新从 Memory Hub 复制 User Key，更新 .credentials.yaml

中国站