dsh-song-memory

English | 中文

A cross-tool memory hub for DeepSeek Harness. It turns your conversations into one AI-written memory article — you read it, and the AI reads the same one, across every conversation and tool.

✨ Features

• One memory, one source: the AI continuously organizes everything it knows about you into a single coherent article (memory.md). Open the memory page and read it like a document — no fragmented lists.
• Self-organizing: conversation notes land in an inbox first, then the AI merges them into the article (new facts in, outdated facts out). Organizes automatically once 5 notes accumulate or 30 minutes pass, and you can always trigger it manually.
• AI-fact memory: besides what you say, project facts from AI replies (decisions made, fixes shipped, tech choices) are captured automatically — sentence-level extraction, no chain-of-thought, no subagent chatter, no undecided statements.
• Secret redaction: before anything is written to memory, common secret shapes (sk-xxx, api_key=..., password:, private key blocks, etc.) are replaced with [REDACTED] — project memory stays safe for public repos.
• True cross-conversation memory: at the start of every conversation, the AI reads that same article.
• Cross-tool linkage: project memory lives in a standard AGENTS.md block that Claude Code, Codex, and Cursor read natively.
• Local & transparent: plain markdown files on your machine. No cloud, no black boxes.
• Simple by design: one article + one inbox + project files. Nothing else to keep in sync.

🚀 Quick Start

Installation

dsh plugin --profile web add dsh-song-memory

How it works

1. Memory article: ~/.song-memory/memory.md — the AI-written, continuously organized article about you. This is what the AI reads at the start of each conversation.
2. Inbox: ~/.song-memory/notes.md — raw conversation notes awaiting organization.
3. Project memory: <conversation-cwd>/AGENTS.md inside the <!-- song-memory:auto --> block — project context, readable by Claude Code / Codex / Cursor.
4. View & manage: open any conversation → 记忆 tab, or DSH Settings → 记忆管理: read the article, trigger "整理记忆", toggle capture/injection, clear memories.

🔒 Privacy Notes

• The plugin captures raw user messages into its inbox by default. Keep this in mind when sharing screenshots of your memory files.
• Project memory is written into <project-cwd>/AGENTS.md. Before publishing a project publicly, review or clear the auto memory block — otherwise conversation snippets may enter public history.
• Memory is sanitized against prompt-injection patterns before injection; capture can be turned off entirely in settings.
• Run DSH with the default 127.0.0.1 host only. The plugin's management API is unauthenticated and must not be exposed on a network interface.

🛠️ Development

git clone https://github.com/songoao25/dsh-song-memory.git
cd dsh-song-memory
pnpm install

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.