ディレクトリに戻る

dsh-memory-keeper

キュレーションリスト掲載メンテナンス: 活発

flywalker68/dsh-memory-keeper

手元のMarkdownメモと書き出した会話履歴を検索できるようにするプラグイン。ローカルの埋め込みモデルで索引し、Web UIに記憶パネルを表示します。

GitHub で見る
$ git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper

19

スター

1

フォーク

JavaScript

言語

MIT

ライセンス

2026-11-05

作成日

2026-11-15

最終プッシュ

MIT の cordis プラグインで、手書きの `.md` メモリ保管庫とエクスポート済みの会話履歴を DeepSeek Harness から検索可能にします。BM25 とローカル bge-small のベクトルを RRF で融合し、任意で Qwen embedding と rerank を使えます。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-18

ライセンス

MIT

01どんなタスクに使えるのか?

  • 手書きの markdown メモリ保管庫を DSH の会話から検索できるようにする

    `memory_search` が字面 BM25 とベクトルの候補を RRF で融合して返し、ヒットした行と前後 1 行のコンテキストを元ファイルから復元します

    人設、日記、プロジェクトメモをすでに素の `.md` で書いていて、モデルに要約ではなく原文を引用してほしい運用者

  • キーワードではなく意味で過去の会話を掘り起こす

    `chat_search` がエクスポート済みの会話記録を直接読み、「3 日前 / 先週 / 1 か月前」といった言い方も解釈します

    過去のセッションで実際に何を話したかを思い出したいが、先にインポートしたくないユーザー

  • セッションをまたいでメモリ保管庫の健全性を保つ

    毎ターン注入されるステータスカード、`memory_check` の健全性レポート、書き込み前にバックアップする `persona_edit`

    長期間動かす個人向け構成で、人設ファイルと日記の進捗・容量・陳腐化のシグナルが欲しい人

02DeepSeek Harness への導入方法

前提条件

  • Node 24+ と DSH 0.2.x(README が明記)— Windows / macOS / Linux のいずれでも動作します
  • markdown のメモリ保管庫:`~/.dsh/memory/`(既定の `memoryDir`)に `.md` を置くだけ。ファイル名も数も問いません

インストール手順

  1. 01

    `git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper`

    $ git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper

  2. 02

    まず `cd ~/.dsh/plugins/dsh-memory-keeper` でプラグインのディレクトリへ移動し、そのあと `npm install` を実行します

    $ npm install

  3. 03

    `~/.dsh/profiles/<profile>/package.json` を開き、`dependencies` に `"dsh-memory-keeper": "link:<絶対パス>"` を、`dsh.profile.bundles` に `"dsh-memory-keeper"` を追加してください。追加したら保存します

  4. 04

    まず `cd ~/.dsh/profiles/<profile>` で profile ディレクトリへ移動し、そのあと `pnpm install` を実行します

  5. 05

    DSH を再起動

  6. 06

    `~/.dsh/profiles/<profile>/cordis.patch.yml` で `workspace` を絶対パスに設定します。空のままだと `process.cwd()` が profile ディレクトリになり、何も索引されません

導入成功の確認

  • DSH 起動後、`~/.dsh/memory-keeper.log` に `INFO 已注册工具 memory_search` の行が出ていること
  • `memory_search` の結果ヘッダに `(向量+词面)` があればベクトルも動いています。`3 条` だけなら字面検索しか走っていません

ロールバック

  • `<workspace>/.tools/memory-index.json` と `<workspace>/.tools/memory-vectors.json` を削除すれば、次回の検索で自動的に作り直されます
  • `embeddingEnabled` を `false` にするとベクトル検索を完全に止められます(ダウンロードも API 呼び出しもなし、字面検索のみ)

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

cordis プラグインとして DSH profile から読み込みます。profile の `package.json` にパッケージを追加し(`dependencies` と `dsh.profile.bundles`)、`pnpm install` を実行して DSH を再起動すると、Host 側が `memory_search` などのツールを登録し、クライアント側がサイドバーのメモリパネルを提供します。

  • 二系統のメモリ検索

    クエリ、`top=10`、任意の `beforeDate`→BM25 とベクトルの候補を RRF で融合し、必要なら Qwen で再ランク。ヒットした行と前後 1 行を付けます

    ソースファイルのパス・サイズ・mtime が変わると `<workspace>/.tools/` の索引を再構築しますQwen のキーを設定すると、検索クエリとテキストのベクトルが百煉へ送られます
  • 索引ビルダー

    `memoryDir` 配下の markdown ファイル→行単位のチャンク。各チャンクに `text`(300 文字まで)、`date`、`file`、`line` を保存します

    見出し行、引用行、区切り線、6 文字未満の短い行、「已被取代」と記された項目はスキップします
  • ステータスカードと圧縮後の原文復元

    組み立て済みの system prompt と `compaction/summary` イベント→毎ターンのカード(付き合いの日数、日記の進捗、予定、半減期候補、人設のドリフト)と、圧縮後に直近 10 ターンの原文

    毎ターン、および圧縮のたびに system prompt へテキストを追加します
  • 履歴インポートスクリプト

    `.jsonl` だけが入ったディレクトリ、または単一の jsonl ファイル→入力ファイルごとに 1 つの `.md`。1 ターン 1 行で行頭に日付が付き、時間窓の判定に参加できます

    新しい markdown ファイルを対象のメモリディレクトリへ書き込みます
  • サイドバーのメモリパネル

    ローカルのメモリ保管庫→DSH の Web UI で保管庫全体を一覧できます

    README には、このパネルを他の人の DSH バージョンでは試していないと書かれています

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • 人設、日記、プロジェクトメモをすでに素の `.md` で書いていて、モデルに要約ではなく原文を引用してほしい運用者
  • 過去のセッションで実際に何を話したかを思い出したいが、先にインポートしたくないユーザー
  • 長期間動かす個人向け構成で、人設ファイルと日記の進捗・容量・陳腐化のシグナルが欲しい人

不向きな用途

  • これは検索レイヤーであり、完全なメモリシステムではありません。ターンごとの再生、増分抽出、要約、忘却は対象外で、すでに書いているものを読むだけで代筆はしません。チャンク化、索引再構築、二系統の検索と融合、時間窓、ステータスカード、圧縮後の原文復元はコードが保証しますが、いつ日記を書くか、関係の断片を残すか、何を削るかは `AGENTS.md` に沿ったモデルの判断に委ねられ、抜けた記憶は本当に存在しないままになります。
  • メモリのデータは常にローカルに残り、Qwen のキーを設定したときだけ検索クエリとテキストのベクトルが百煉へ送られます。キー未設定、呼び出し失敗、タイムアウト、3 回連続失敗のいずれでもローカルの bge-small に戻ります。
  • `sharp` は実際にビルドされている必要があります。`npm install --ignore-scripts` では libvips のバイナリが無く、`@xenova/transformers` がそれを要求するため、ベクトル検索だけが静かに落ちてプラグイン自体は起動してしまいます。
  • README 自身が未検証項目を挙げています。`pnpm install` が必須かどうか、`link:` の Windows バックスラッシュでの挙動、ログのパス、`embeddingEnabled` を切ったときの検索品質、他の DSH バージョンでのパネルの見え方です。作者はプラグインが軽量設計で、保管庫が非常に大きい場合の最適化はこれからだと述べています。

05互換性・メンテナンス・セキュリティ上の注意

  • これは検索レイヤーであり、完全なメモリシステムではありません。ターンごとの再生、増分抽出、要約、忘却は対象外で、すでに書いているものを読むだけで代筆はしません。チャンク化、索引再構築、二系統の検索と融合、時間窓、ステータスカード、圧縮後の原文復元はコードが保証しますが、いつ日記を書くか、関係の断片を残すか、何を削るかは `AGENTS.md` に沿ったモデルの判断に委ねられ、抜けた記憶は本当に存在しないままになります。
  • メモリのデータは常にローカルに残り、Qwen のキーを設定したときだけ検索クエリとテキストのベクトルが百煉へ送られます。キー未設定、呼び出し失敗、タイムアウト、3 回連続失敗のいずれでもローカルの bge-small に戻ります。
  • `sharp` は実際にビルドされている必要があります。`npm install --ignore-scripts` では libvips のバイナリが無く、`@xenova/transformers` がそれを要求するため、ベクトル検索だけが静かに落ちてプラグイン自体は起動してしまいます。
  • README 自身が未検証項目を挙げています。`pnpm install` が必須かどうか、`link:` の Windows バックスラッシュでの挙動、ログのパス、`embeddingEnabled` を切ったときの検索品質、他の DSH バージョンでのパネルの見え方です。作者はプラグインが軽量設計で、保管庫が非常に大きい場合の最適化はこれからだと述べています。
2026-11-052026-11-15作者は未記載

MIT · README ブランチ main(リリースなし)

06よくある質問

導入したのに 1 件も検索できないのはなぜですか?

ほぼ必ず `workspace` が空のためです。DSH では `process.cwd()` がワークスペースではなく profile ディレクトリを指すので、日記が見つからず、エラーも出ないまま検索結果が空になります。`~/.dsh/profiles/<profile>/cordis.patch.yml` で `workspace` を絶対パスに設定してください。コード側も WARN を出すようになっています。

百煉の API キーは必要ですか?

不要です。キーが無ければローカルの `Xenova/bge-small-zh-v1.5`(約 24 MB、int8、初回検索時に hf-mirror 経由でプラグインの `models/` へ取得)を使い、オフラインでも動きます。キーを設定すると `qwen3.7-text-embedding` と `qwen3.7-text-rerank` に切り替わり、失敗・タイムアウト・3 回連続失敗のいずれかでローカルへ戻ります。

ベクトル検索が動いているかはどう確認しますか?

`memory_search` の結果ヘッダを見ます。`3 条(向量+词面)` ならベクトルと字面の両方が動いており、`3 条` だけなら字面検索のみで、多くは `sharp` のビルド失敗が原因です。その場合は `npm install --ignore-scripts` のあと `npm install-scripts approve sharp` と `npm rebuild sharp` を実行します。

このプラグインが意図的にやらないことは?

ターンごとの再生、記憶の増分抽出、要約、忘却は行いません。チャンク化、索引再構築、二系統の検索と融合、時間窓、ステータスカード、圧縮後の原文復元はコードが保証しますが、いつ日記を書くか、関係の断片を残すか、何を削るかは `AGENTS.md` に沿ったモデルの判断に任され、抜けた分はそのまま存在しない記憶になります。

索引をリセットするには?

`<workspace>/.tools/memory-index.json` と `<workspace>/.tools/memory-vectors.json` を削除すれば、次回の検索で自動的に作り直されます。通常は不要です。索引は各ソースファイルのパス・サイズ・mtime を比較し、変化があれば再構築します。

08データと出典

  • 作者による申告github.com56860da0d1ad…

    - 这是 **DSH(DeepSeek Harness)的 cordis 插件**,**不是把目录丢进 `.dev/` 就生效**

  • 作者による申告github.com56860da0d1ad…

    DSH 是通过 **profile 的 `package.json`** 加载插件的,光把目录放进去不会生效。

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-18。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。