dsh-prime-memory 0.11.0

package/INSTALL.ko.md

@@ -0,0 +1,92 @@
+# 설치 안내（dsh-prime-memory）
+
+본 플러그인은 **DSH 공식 bundle 합성 패키지**로 배포됩니다. 설치 후 `cordis.patch.yml`의 `dsh.bundle` 계층이 플러그인 행을 자동 마운트하므로 profile 설정을 손으로 고칠 필요가 없습니다.
+
+## 환경 요구
+
+- Node.js ≥ 22.16（DSH 0.1.1-rc.2 이상）
+- DeepSeek Harness（이하 DSH）설치 완료, `--profile web` 사용 가능
+
+## 설치
+
+두 가지 호출 방식 중 선택（`npx` 접두사는 아래 어떤 `dsh` 명령도 대체 가능）：
+
+```bash
+# 방식 1: npx로 공식 CLI 직접 실행（dsh 사전 설치 불필요. 버전 고정 가능, 예: dsh-prime-memory@0.8.4）
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-prime-memory
+
+# 방식 2: dsh CLI 설치된 경우（dsh는 pnpm 포워더. 없으면 먼저 npm i -g pnpm）
+dsh plugin --profile web add dsh-prime-memory
+
+# 기타 소스: GitHub 저장소 / 로컬 경로（개발·디버깅용. link: 는 저장소를 가리키며, npm run build + dsh 재시작으로 반영）
+dsh plugin --profile web add https://github.com/drscrewdriver/dsh-prime-memory
+dsh plugin --profile web add /path/to/dsh-prime-memory
+```
+
+### Agent에게 설치시키기（권장）
+
+현재 Agent가 터미널 명령을 실행할 수 있다면 아래 문장을 그대로 보내세요：
+
+```text
+DeepSeek Harness의 web 프로파일에 dsh-prime-memory 플러그인을 설치해 주세요.
+
+다른 프로파일은 수정하지 말고 아래 두 명령만 실행해 주세요:
+dsh plugin --profile web add dsh-prime-memory
+dsh --profile web --dump-config
+
+출력에 dsh-prime-memory가 나타나면 설치 결과를 알려 주세요.
+실행 중인 DSH를 임의로 닫거나 재시작하지 마세요. 설치 후 DSH Web Host 수동 재시작을 알려 주세요.
+```
+
+## 업그레이드
+
+```bash
+# 최신版으로
+dsh plugin --profile web update dsh-prime-memory
+
+# 특정 버전으로
+dsh plugin --profile web update dsh-prime-memory@0.8.11
+```
+
+업그레이드는 플러그인 코드와 `dist/` 산출물만 교체하며, 데이터 디렉터리 `~/.dsh/memory/`에는 영향이 없습니다.
+
+## 검증
+
+DSH Web Host 재시작 후 확인：
+
+1. **데이터 디렉터리가 나타남**＝플러그인 적용 성공：`~/.dsh/memory/` 아래에 `conversations/` `records/` `scenes/`와 `memory.db`가 나타남；
+2. **설정에 "기억" 페이지**, 입력 바에 모드 pill이 나타남＝클라이언트 준비 완료；
+3. 개인정보를 담은 메시지를 보내고 증류 완료 후, 다른 턴에서 관련을 물으면 컨텍스트에 "컨텍스트 주입 · memory" 행이 보여야 함.
+
+선택 스모크 테스트（개발·장애 대응용）：
+
+```bash
+npm run build
+npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
+node dist-smoke/smoke.js
+```
+
+## 마이그레이션 / 다운그레이드
+
+- **구버전（0.5.0 이전은 `dsh-memory-plugin`）에서 이전**：구 데이터 디렉터리는 신패키지와 호환되지 않습니다. 백업 후 `~/.dsh/memory/`를 삭제하고 신플러그인 초회 실행에서 재구축하세요. 내역은 그대로 승격 불가하며 재증류가 필요합니다.
+- **구버전으로 롤백**：`dsh plugin --profile web remove dsh-prime-memory` 후 구버전 문서로 재설치. 데이터 디렉터리는 남지만 구버전은 신레이아웃을 읽지 못하므로 함께 삭제 권장.
+
+## 제거
+
+```bash
+dsh plugin --profile web remove dsh-prime-memory
+```
+
+데이터는 `~/.dsh/memory/`에 남습니다. 필요 없으면 디렉터리 전체를 수동 삭제하세요.
+
+## 문제 해결
+
+| 현상 | 가능한 원인 | 조치 |
+| --- | --- | --- |
+| 설치 후 "기억" 페이지 없음 | DSH 미재시작 / bundle 미마운트 | DSH Web Host 재시작. `dsh --profile web --dump-config`로 `dsh-prime-memory` 확인 |
+| 기동 시 `duplicate loader entry id` | patch가 `insert:`와 bundle 동일 id 중복 추가 | 수동 `insert:` 삭제（본 패키지는 bundle 계층 동봉） |
+| "컨텍스트 주입 · memory" 행 없음 | 증류 미실행 / 회상 꺼짐 | 모드가 off 아니며 `recall.enabled=true` 확인. `memory.log`의 `L1 단계 완료` 확인 |
+| 로컬 임베딩 다운로드 멈춤 | 미러 직결 불가 | `embedding.proxy`로 프록시 설정, 또는 `embedding.mirror`을 공식 `huggingface.co`로 |
+| 원격 임베딩 401 오류 | apiKey 오류 / 무키 서비스에 key 불필요 | `embedding.apiKey` 확인. self-host 무키 서비스는 apiKey 비움 |
+
+자세한 것은 [README.ko.md](./README.ko.md)와 [CHANGELOG.ko.md](./CHANGELOG.ko.md) 참조.

package/INSTALL.md

@@ -0,0 +1,92 @@
+# 安装指南（dsh-prime-memory）
+
+本插件以 **DSH 官方 bundle 组合包**形式分发：安装后由 `cordis.patch.yml` 的 `dsh.bundle` 层自动挂载插件行，无需手改任何 profile 配置。
+
+## 环境要求
+
+- Node.js ≥ 22.16（DSH 0.1.1-rc.2 及以上）
+- 已安装 DeepSeek Harness（以下简称 DSH），且 `--profile web` 可用
+
+## 安装
+
+任选一种调用方式（`npx` 前缀可替换下面任何 `dsh` 命令）：
+
+```bash
+# 方式一：npx 直接跑官方 CLI（无需预装 dsh；可 pin 版本，如 dsh-prime-memory@0.8.4）
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-prime-memory
+
+# 方式二：已装 dsh CLI（dsh 是 pnpm 转发器，未装 pnpm 时先 npm i -g pnpm）
+dsh plugin --profile web add dsh-prime-memory
+
+# 包源备选：GitHub 仓库 / 本地路径（开发调试，link: 指向仓库，npm run build + 重启 dsh 即生效）
+dsh plugin --profile web add https://github.com/drscrewdriver/dsh-prime-memory
+dsh plugin --profile web add /path/to/dsh-prime-memory
+```
+
+### 让 Agent 安装（推荐）
+
+把下面这段话完整发送给当前 Agent（只要它能执行终端命令）：
+
+```text
+请为 DeepSeek Harness 的 web Profile 安装 dsh-prime-memory 插件。
+
+只执行下面两条命令，不要修改其他 Profile：
+dsh plugin --profile web add dsh-prime-memory
+dsh --profile web --dump-config
+
+确认输出中出现 dsh-prime-memory 后告诉我安装结果。
+不要替我关闭或重启正在运行的 DSH；安装完成后提醒我手动重启 DSH Web Host。
+```
+
+## 升级
+
+```bash
+# 升级到最新版
+dsh plugin --profile web update dsh-prime-memory
+
+# 升级到指定版本
+dsh plugin --profile web update dsh-prime-memory@0.8.11
+```
+
+升级只替换插件代码与 `dist/` 产物，数据目录 `~/.dsh/memory/` 不受影响。
+
+## 验证
+
+安装并重启 DSH Web Host 后检查：
+
+1. **数据目录出现**即插件 apply 成功：`~/.dsh/memory/` 下出现 `conversations/` `records/` `scenes/` 目录与 `memory.db`；
+2. **设置页出现「记忆」页面**、输入栏出现档位 pill 即 client 半边就绪；
+3. 发一条带个人信息的消息，稍等蒸馏完成后，在另一轮对话里问到相关信息，应能在上下文看到「上下文注入 · memory」行。
+
+可选冒烟测试（开发/排障用）：
+
+```bash
+npm run build
+npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
+node dist-smoke/smoke.js
+```
+
+## 迁移 / 降级
+
+- **从旧版（0.5.0 前名为 `dsh-memory-plugin`）迁移**：旧数据目录与新包不兼容，请备份后删除 `~/.dsh/memory/`，由新插件首次运行重建；历史记忆不可直接升级，需重新蒸馏。
+- **回退到旧版**：`dsh plugin --profile web remove dsh-prime-memory` 后按旧版文档重装；数据目录保留，但旧版不识别新结构，建议一并清理。
+
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-prime-memory
+```
+
+数据保留在 `~/.dsh/memory/`，不需要时手动删除整个目录即可。
+
+## 故障排查
+
+| 现象 | 可能原因 | 处理 |
+| --- | --- | --- |
+| 安装后设置页无「记忆」页 | 未重启 DSH / bundle 未挂载 | 重启 DSH Web Host；`dsh --profile web --dump-config` 确认含 `dsh-prime-memory` |
+| 重启报 `duplicate loader entry id` | patch 里同时用了 `insert:` 与 bundle 同 id 追加 | 删除手动加的 `insert:` 条目，本包已自带 bundle 层 |
+| 无「上下文注入 · memory」行 | 蒸馏未跑 / 召回关闭 | 检查档位非 off、recall.enabled=true；看 `memory.log` 的 `L1 阶段完成` |
+| 本地嵌入档下载卡住 | 镜像直连不可达 | 设 `embedding.proxy` 走代理；或换 `embedding.mirror` 为官方 `huggingface.co` |
+| 远程嵌入报错 401 | apiKey 错 / 免 key 服务不应传 key | 检查 `embedding.apiKey`；自托管免 key 服务保持 apiKey 为空 |
+
+更多见 [README.md](./README.md) 与 [CHANGELOG.md](./CHANGELOG.md)。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 drscrewdriver
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.