# DeepSeek Harness

네이티브 dsh-xmemo npm 패키지를 사용하여 DeepSeek Harness (dsh) CLI 에이전트 실행 루프를 XMemo에 연결합니다.

- Canonical: https://docs.xmemo.dev/ko/docs/connect/deepseek-harness
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: c6de6cc4c0f626de469ac03a56dc357d0c9af7afcc4dfe19946e5ef345c10181
- Edition-Digest: b848f282bbad6b3c91ac08bc7401e720688f1042d9114c20e29497ea3d98ca8f
- 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 에이전트 하네스 CLI 도구 전용입니다. 커스텀 플러그인이나 MCP 확장을 지원하지 않는 DeepSeek 소비자 웹 채팅 (chat.deepseek.com)과의 통합이 아닙니다.

## 사전 요구 사항

연결하기 전에 다음 런타임 종속성 및 도구가 준비되어 있는지 확인합니다:

- 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
```

## 인증 및 자격 증명 구성

환경 변수 또는 하네스 프로필 구성을 사용하여 자격 증명을 설정합니다. 공개 프로젝트 리포지토리에 일반 텍스트 API 키를 배치하지 마십시오:

- 환경 변수 (권장): dsh를 실행하기 전에 환경에 XMEMO_KEY를 설정합니다 (export XMEMO_KEY='<your-xmemo-token>').
- 프로필 구성: 대상 프로필 구성 파일 (~/.dsh/config.json)에 인증 자격 증명을 지정합니다.

## 로드 및 재시작 동작

데몬 재시작 또는 실행 루프 다시 로드 절차는 dsh-xmemo 플러그인 README (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md)에 명시적으로 설명되어 있지 않습니다. DeepSeek Harness CLI 문서를 참조하거나 구성된 프로필을 사용하여 작업을 실행하십시오.

## 연결 확인 (읽기 전용)

에이전트 실행 루프를 시작하기 전에 읽기 전용 회상 요청으로 연결 상태를 확인합니다:

- 확인: 메모리 상태를 수정하지 않고 dsh를 통해 읽기 전용 평가 쿼리를 실행합니다.
- 성공 신호: dsh가 승인된 워크스페이스에서 유효한 Reference 및 Location 필드가 포함된 구조화된 메모리 결과를 반환합니다.

## 첫 번째 유용한 작업: 합성 메모리 수명 주기

메모리 지속성, 상태 비저장 세션 전환, 출처 귀속 회상 및 수정을 확인합니다:

- 1. 합성 사실 저장: 하네스 작업 규칙 ("Harness demo build target: ESM with strict typing.")을 "projects/demo-dsh/conventions"에 저장합니다.
- 2. 상태 비저장 전환: 현재 dsh 작업을 종료하고 구성된 프로필을 사용하여 새 실행을 시작합니다.
- 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를 실행하는 셸 환경에서 XMEMO_KEY가 내보내졌는지 확인합니다.
- 업데이트 및 제거: 플러그인 업데이트 및 제거 절차는 dsh-xmemo 플러그인 README (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md)에 설명되어 있지 않습니다. 프로필 관리는 DeepSeek Harness CLI 문서를 참조하거나 https://xmemo.dev/me에서 자격 증명을 해지하고 저장된 메모리를 삭제하십시오.
- 원격 삭제: 저장된 메모리를 삭제하거나 액세스 토큰을 해지하려면 https://xmemo.dev/me에서 워크스페이스를 관리하십시오.