Spirtxiaoqi7 / mindspace-dsh-session-memory

Mindspace Session Memory for DeepSeek Harness

An installable DeepSeek Harness community plugin for editable, session-isolated personalization memory. It keeps continuity and user control in the same place:

• a roughly 300-character profile separating confirmed user facts from AI observations, while DSH compaction stays internal;
• editable preferences and assistant instructions consolidated into at most three categorized cards each;
• a relationship identity and a purpose for each conversation;
• an optional roleplay preset isolated to one session;
• model-facing get_session_memory and update_session_memory tools;
• conservative automatic extraction from explicit user statements;
• category-based conflict replacement with stable card ids and a visible append/merge/replace/skip audit trail;
• a one-time, optional role/purpose/style question when a new session has no personalization.

0.2.9: Session-scoped context compaction

The Memory Center now exposes a session-isolated context-compaction policy. Users can enable it, set the trigger ratio, retained recent context, and summary limit, or run a manual compaction before the threshold is reached. The policy is persisted as session events and never changes another conversation.

• Only conversation messages are summarized; system, tool, personalization, relationship-mission, and roleplay layers are excluded.
• The prior summary is included as input to avoid losing durable context across repeated compactions.
• The compaction prompt prioritizes facts, decisions, constraints, open work, and reusable conclusions while dropping greetings, repetition, and tool logs.
• DSH remains the compaction executor; this plugin supplies the session policy and the visible user controls.

This is a community plugin and is not an official DeepSeek project. The repository artwork is supplied by the project owner and is used only to identify this repository.

0.2.0 update and contribution

Version 0.2.0 turns the first editable-memory prototype into a governed, session-scoped personalization layer for DeepSeek Harness:

• the public compaction-summary override is replaced by a 300-character user profile that separates confirmed facts from clearly labelled AI observations;
• preferences and assistant requirements are consolidated into at most three categorized cards per section instead of growing as disconnected fragments;
• corrections replace conflicting information while preserving stable card ids;
• automatic extraction proposes a complete next state and an atom-by-atom handled/skipped ledger, so partial model output is rejected atomically;
• append, merge, replace, and skip activity records expose source message sequences, before/after values, reasons, and timestamps;
• V1 session events remain replayable and migrate into the V2 document shape;
• repeated legacy fallback categories are repaired during replay instead of locking all later writes;
• assistant names, nicknames, self-designations, and relationship-specific titles have a dedicated identity action and are never routed into the user's profile or preferences;
• relationship missions and roleplay presets remain independently scoped to each conversation.

The contribution is deliberately tree-out: one installable dual-face DSH bundle owns the Host service, event projection, prompt/tool integration, extraction hook, Typert descriptor, Remote, and settings UI. It does not replace DSH compaction semantics or require an upstream source patch, making the memory-governance layer independently installable, auditable, and removable.

Confirmed/observed profile and categorized preferences

Session role preset and visible memory audit

The V2 acceptance run passed 10 automated tests, build and package checks, real model write/merge/replace flows, cross-session isolation, and persistence after restarting the default Web profile.

Install

This README describes current main. It does not point at a nonexistent Release tarball: build the prebuilt package from a pulled checkout, then install it from the official Harness checkout root.

git clone https://github.com/Spirtxiaoqi7/mindspace-dsh-session-memory.git
Set-Location .\mindspace-dsh-session-memory
corepack pnpm install
corepack pnpm run build
corepack pnpm pack --pack-destination dist
$memoryTgz = (Get-ChildItem .\dist\mindspace-dsh-session-memory-*.tgz | Sort-Object LastWriteTime -Descending | Select-Object -First 1).FullName

Set-Location C:\path\to\deepseek-harness
corepack pnpm dsh plugin --profile web add $memoryTgz
corepack pnpm dsh --profile web --dump-config
corepack pnpm dsh web

Do not run pnpm dsh in the plugin directory or require a global dsh: that command belongs to the official Harness checkout. The repository has no install-time build script; the commands above explicitly create and install the tarball. Historic GitHub Releases map only to their respective tags and do not represent the current main feature set.

How it composes

The package is one DSH bundle with one dual-face row. On the Host it mounts the memory service, projection, prompt contribution, model tools, extraction hook, and Typert descriptor. The same package declares its Web client contribution, which self-mounts the generated Remote descriptor and registers the settings page.

It does not patch DSH source, api-remotes, the built-in bundles, or root TypeScript projects. Removal is therefore one command:

corepack pnpm dsh plugin --profile web remove mindspace-dsh-session-memory

Data and model calls

Memory changes are appended to the selected DSH session event log. The UI reads and replaces a whole versioned document with optimistic revision checks. Automatic extraction is enabled by default and may make one auxiliary model request after a completed root-agent turn. A proposal must contain the complete next state plus a handled/skipped ledger for every extracted atom; invalid or partial output is rejected atomically. Confirmed facts and cautious observations remain separate, and inferred sensitive facts are rejected by policy.

Disable automatic extraction in a later profile patch if you want tool/manual writes only:

- id: mindspace-session-memory
  name: mindspace-dsh-session-memory
  config:
    maxTextBytes: 4096
    maxItemsPerSection: 3
    maxProfileCharacters: 300
    autoExtract: false
    extractionMaxTokens: 1024

Compatibility

The initial release targets the public DeepSeek Harness 0.1.0-rc family and Node 22.19+ or Node 24+. Harness is currently a developer preview; breaking upstream changes may require a plugin update.

Recent DSH builds also ship experimental in-tree session-memory fields and a matching settings entry. This plugin deliberately disables those in-tree rows in its profile patch before installing its own single owner for the Remote, event projection, prompt integration, and editable UI. Future extensions must keep one owner per session-memory schema/Remote namespace; enabling both implementations causes duplicate registration or competing writers.

Development

pnpm install
pnpm run build
pnpm test
pnpm pack --pack-destination dist

The generated Typert descriptors are committed under src/generated/. The build rescopes their package identity and bundles the browser Remote with the UI.

Chinese documentation: README.zh-CN.md

License

MIT