dsh-timem-memory

TiMEM 장기 기억을 위한 DeepSeek Harness(DSH) 플러그인입니다. 하나의 cordis 항목으로 두 가지 작업을 처리합니다:

1. MCP 브릿지 — @deepseek-ai/dsh-mcp-client를 통해 TiMEM 클라우드 MCP (https://api.timem.cloud/mcp)에 연결하여 17개의 도구를 mcp__timem__* 이름으로 모델에 등록합니다 (기억 4개, 규칙 8개, 지식 베이스 4개, ready 1개);

2. 기억 skill — 5개의 내장 skill을 DSH skill 시스템(runtime 계층, rank 250)에 등록하여, 모델이 사용자의 S0–S6 등급 이해 없이도 '매 턴마다 먼저 기억 검색 → 작업 수행 → 기억 쓰기' 워크플로우를 자동으로 실행하도록 합니다.

자격 증명은 **ctx.credentials**를 통해 파싱되며(TiMEM_API_KEY / TiMEM_USER_ID), 설정 파일에 키를 하드코딩하지 않습니다; 자격 증명 변경 시 이벤트가 트리거되어 MCP 브릿지를 자동으로 다시 마운트하며, 재시작이 필요 없습니다.

설치

전제 조건: DSH가 설치되어 있고, pnpm이 PATH에 있어야 합니다(dsh plugin이 의존).

# 1. 把插件装进目标 profile（任意名字，web / headless / 自定义皆可）
#    GitHub 渠道（当前即可用）：
dsh plugin --profile web add git+https://github.com/auuduu/dsh-timem-memory.git
#    npm 官方商店渠道（发布后）：
# dsh plugin --profile web add dsh-timem-memory

# 2. 在 <DSH_HOME>/profiles/web/cordis.patch.yml 中插入一条目（保存即热生效）
- insert:
    - id: timem-memory
      name: 'dsh-timem-memory'

초보자용 원리 설명(패키지가 무엇인지, 설치 위치, DSH가 어떻게 "깨우는지"): docs/principles.zh.md

Related MCP server: r3 (Recall)

자격 증명 설정

자격 증명은 자격 증명 저장소(~/.dsh/.credentials.yaml, 권한 0600, DSH 웹 페이지의 자격 증명 페이지에서 관리 가능)에 저장되거나, 환경 변수 / ~/.dsh/.env(시작 시 로드)에 저장됩니다. .credentials.yaml 예시:

DEEPSEEK_API_KEY: sk-…
TiMEM_API_KEY: sk-…          # https://console.timem.cloud/settings/api-key
TiMEM_USER_ID: usr_…         # TiMEM 控制台个人资料页

작성 후 플러그인이 자동으로 MCP 브릿지를 다시 마운트합니다(DSH 재시작 불필요). TiMEM 자격 증명이 없으면, 플러그인은 브릿지를 건너뛰고 오류 로그만 기록하며, skill은 계속 등록됩니다.

설정 항목

확인

재시작/핫 리로드 후, 대화에서 모델에게 "TiMEM 연결되었어?"라고 물어보세요 — 모델이 mcp__timem__ready를 호출하고 17개 도구가 보이는지 확인합니다; 또는 설정 → 플러그인 페이지에서 timem-memory 항목 상태를 확인할 수 있습니다.

작동 원리

• lib/index.js: cordis 플러그인 본체(inject: ['credentials', 'skills']). 활성화 시: ① 자격 증명 파싱 → ctx.plugin(mcpClient, …)으로 MCP 브릿지 마운트; ② 패키지 내 skills/*/SKILL.md 읽기 → ctx.skills.register()로 등록(컨텍스트에 따라 자동 소멸).

• skills/: 5개의 skill 패키지(TiMEM 공식 skill의 DSH 어댑터 버전, 도구 이름은 mcp__timem__*으로 재작성, 자체 가용성 검사 및 S3/S0/S6 등급 포함).

• 자격 증명 핫 업데이트: credentials/updated 이벤트 수신, apiKeyRef / userIdRef 일치 시 이전 브릿지 해제 후 새 자격 증명으로 재마운트.

라이선스

MIT