腾讯云数据库 AI 服务 快速接入

一、前置条件

开始配置前，请确认已满足以下条件：

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

上述三个参数的含义如下：

四、步骤二：配置 .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 ~/.dshchmod 600 ~/.dsh/.credentials.yaml

六、启动并完成首次初始化

1. 启动 Web 界面：

cd /path/to/deepseek-harnesspnpm 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：创建技能。

七、常见问题