# DeepSeek Harness

使用原生 dsh-xmemo npm 包将 DeepSeek Harness (dsh) CLI 智能体执行循环连接到 XMemo。

- Canonical: https://docs.xmemo.dev/zh/docs/connect/deepseek-harness
- Locale: zh-CN
- Content-Locale: zh-CN
- Canonical-Content-Digest: c6de6cc4c0f626de469ac03a56dc357d0c9af7afcc4dfe19946e5ef345c10181
- Edition-Digest: 2c183030a92a1deeaaf1cc1a61103a30665dd83cbca1e630f2327cd3c2a3207a
- Source-Revision: sha256:dec9ab1fbe4dd6a2bdb916f3b710fbe7727d084a06a4c81753e6790881a0afee

## 适用对象与边界

本指南将 DeepSeek Harness (dsh) CLI 智能体执行循环连接到 XMemo 持久记忆。该集成通过 npm 上的原生 dsh-xmemo 插件包（版本 0.1.0）运行，代码锚定在仓库 yonro/xmemo-deepseek-plugin @ e7101afb0a (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md)。重要边界：本集成专用于 dsh 智能体 harness CLI 工具；它不是针对 DeepSeek 消费端网页聊天（chat.deepseek.com）的集成，后者不支持自定义插件或 MCP 扩展。

## 前置条件

在连接之前，请确保以下运行时依赖和工具已准备就绪：

- DeepSeek Harness (dsh) CLI 已安装且可正常运行。
- Node.js 运行时版本 18.0.0 或更高。
- https://xmemo.dev 上的有效 XMemo 账户。
- 通过 HTTPS 访问 https://xmemo.dev/mcp 的网络连接。

## 安装

使用 README 第 90-94 行中记载的命令将原生 dsh-xmemo 插件添加到您的 DeepSeek Harness 配置文件中：

```bash
dsh plugin --profile <name> add dsh-xmemo
```

## 授权与凭据配置

使用环境变量或 harness profile 配置设置凭据。切勿将明文 API key 放置在公开的项目代码仓库中：

- 环境变量（推荐）：在启动 dsh 之前在环境中设置 XMEMO_KEY (export XMEMO_KEY='<your-xmemo-token>')。
- Profile 配置：在目标 profile 配置文件 (~/.dsh/config.json) 中指定身份验证凭据。

## 加载与重启机制

守护进程重启或执行循环重新加载流程在 dsh-xmemo 插件 README (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md) 中未明确记载；请参考 DeepSeek Harness CLI 文档或使用您配置的 profile 启动任务。

## 连接检查（只读）

在启动智能体执行循环之前，使用只读 recall 请求验证连接性：

- 检查：通过 dsh 执行只读评估查询，不修改任何记忆状态。
- 成功信号：dsh 返回带有来自已授权工作区的有效 Reference 和 Location 字段的结构化记忆结果。

## 首个实用任务：合成记忆生命周期

验证记忆持久性、无状态会话过渡、带溯源归属的召回及修正：

- 1. 保存合成事实：将 harness 任务规范 ("Harness demo build target: ESM with strict typing.") 存储到 "projects/demo-dsh/conventions"。
- 2. 无状态过渡：终止当前 dsh 任务，并使用配置的 profile 启动全新的执行运行。
- 3. 带溯源归属的召回：查询 "harness build target convention"。确认返回的 Reference 和 Location。
- 4. 修正记忆：使用 update_memory 配合更新后的构建目标来更新所记住的规范。
- 5. 可选清理：在入职验证完成后，软删除 (forget) 该演示规范。

## 自动捕获范围与去重机制

DeepSeek Harness 执行循环记忆管理：

- 循环检查点：dsh-xmemo 在任务完成边界自动捕获任务成果、架构决策和错误解决方案。
- 去重机制：去重哈希可防止在重复的循环迭代中重复捕获相同的执行上下文。
- 范围隔离：捕获的上下文严格限定在已认证的工作区和活跃代码仓库范围内。

## 与现有提供方的冲突及存储所有权

运行时边界与存储所有权：

- 提供方冲突：使用 dsh-xmemo 时，请在 dsh.config.json 中禁用默认的临时本地记忆，以避免冗余或冲突的上下文注入。
- 存储所有权：持久记忆存储在用户所有的 XMemo 云端后端；dsh 仅存储临时的执行转录和本地运行日志。
- 离线与重放限制：短暂的网络中断会在本地缓冲；一旦缓冲区耗尽，延长的离线期将导致写入操作失败，且离线上下文在重新连接网络前不会在智能体之间共享。

## 恢复、更新与卸载

DeepSeek Harness 的故障排查、更新与卸载流程：

- 恢复 (401 invalid_token)：验证运行 dsh 的 shell 环境中已导出 XMEMO_KEY。
- 更新与卸载：dsh-xmemo 插件 README (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md) 中未记载更新和插件卸载流程；有关 profile 管理请参考 DeepSeek Harness CLI 文档，或在 https://xmemo.dev/me 撤销凭据并清除已存储的记忆。
- 远程删除：要清除已存储的记忆或撤销访问令牌，请在 https://xmemo.dev/me 管理您的工作区。