At a glance
What it does
A DeepSeek Harness plugin for layered local long-term memory, session distillation, and memory settings.
Web Profile
Not declared in supplied evidence
Evidence-verified
Checked Sep 10, 2026, 2:19 PM UTC
Code-evidenced contributions
What it adds to DSH
Adds a DSH sidebar panel for browsing memory, viewing distillation and deep-sleep status, and adjusting settings.
Mechanism evidence ↗Embedded agent skill defining layered memory retrieval and write-discipline guidance.
Mechanism evidence ↗Before you choose it
Shoucang Memory adds a layered memory library to DeepSeek Harness: lightweight indexes load at session start, while detailed notes are retrieved on demand. It can distill eligible idle-session material into memory, consolidate lessons after all sessions have been inactive, and exposes controls and status in a DSH sidebar panel.
Best for
DeepSeek Harness users who want an agent to retain curated cross-session context, working preferences, and reusable lessons locally.
Common tasks
- Keep an agent and user profile across DSH sessions.
- Review memory indexes, detailed notes, distillation statistics, and deep-sleep state in the sidebar.
- Configure idle-session distillation, deep-sleep thresholds, and the memory root.
Permissions and data
The plugin persists local memory and configuration data and may use an LLM subagent for automated distillation.
Permissions- Write and update local memory indexes, note files, agent profiles, and user profiles.
- Write local configuration and panel state; the documented default state location is under ~/.dsh/storages/.
- The README states that memory-library data stays on the local machine and is not uploaded or published with the repository.
- Project-specific experience is documented as being written under the workspace's docs/devref/shoucang/ path.
- Requires DeepSeek Harness and its declared peer dependencies.
- Distillation can use a configured LLM provider/model or follow the main session model.
- No credential requirement is declared in the supplied evidence.
Limitations
- The supplied evidence does not establish a supported DSH Harness version range.
- The npm package version was not found; use the verified pinned Git bundle route.
- Installation, runtime behavior, automated writes, and privacy claims were not independently executed or audited.
What DSHub checked
- A pinned Git source commit, package manifest, and Cordis bundle patch are present.
- The manifest declares DSH LLM/tools, Cordis, and Schemastery peer-dependency ranges.
- The README documents the web-profile installation command, sidebar panel, local-memory design, and configuration options.
What DSHub did not check
- Successful installation or operation in a DSH environment.
- Actual behavior of session distillation, deep sleep, whitelist gating, and the settings panel.
- Compatibility with a particular DeepSeek Harness release or LLM provider.
Pinned install
Install Shoucang Memory
This plugin bundle does not have a DSH Plugin install action. Use its source documentation for the delivery method.
Maintainer source
Project README
dsh-shoucang-memory
DeepSeek Harness (DSH) 记忆插件。让 DSH 拥有跨会话长期记忆：
- 🧠 长期记忆库 — 画像索引 + 知识索引 + 详情层分层结构，每次会话自动加载，越用越懂你
- 🏭 会话蒸馏 — 会话空闲后自动唤醒，LLM 子代理裁决「什么值得记」，教程式浓缩写回记忆库
- 🌙 深度睡眠 — 全部会话停滞后自动归纳「习得原则」进 agent 画像——像人睡前反思：认识自己，也认识用户
- 👤 成长型 agent 画像 — AGENT.md（角色定位/稳定做法/能力边界/教训/习得原则）+ USER.md（用户画像），蒸馏与深睡双入口持续维护
- 🖥️ 设置面板 — 侧栏入口：记忆库浏览、蒸馏统计、参数调节、深度睡眠视图，深浅色跟随宿主主题
- 🛡️ 白名单门禁 — 写入过闸：不符白名单一律不存，宁缺毋滥
守藏（shoucang）：取「善于收藏、守而不忘」之意。记忆插件的终态 = 一个能一直学习、反思、迭代的 agent 助理角色：蒸馏=学习，深度睡眠=反思，replace 更新=迭代。
🧠 长期记忆库
记忆库分索引层与详情层：会话开始只加载轻量索引，详情按指针按需召回，不占上下文。
| 层 | 内容 |
|---|---|
AGENT.md |
agent 自我画像（成长档案）— 角色定位 / 学习史 / 稳定做法 / 常犯错误 / [原则] 习得原则（深度睡眠归纳的跨任务通用经验，v16 并入此文件）/ [路径] 任务路径（v17，对标 AWM：可复用任务类型的变量化步骤序列），容量 3,000 字符 |
MEMORY.md |
知识索引 — 工具用法 / 工作流 / 教训 / 环境事实，一行一条指向详情 |
USER.md |
用户画像索引 — 你的偏好习惯，蒸馏 + 深睡双通道维护 |
notes/*.md |
详情层（L2）— 按主题分文件（tools / flows / lessons / env / release / user / agent） |
详情容量水位超 85% 触发审计重组；长期零召回的条目自动降级提纯（细节下放、经验上收），永不无限膨胀。
🏭 会话蒸馏（自动沉淀）
会话结束空闲约 10 分钟后自动运行：扫描本轮增量 → 信号词预筛（零 LLM 成本跳过无关会话）→ LLM 子代理按蒸馏契约裁决 → 过白名单门禁写回记忆库。
- 粒度判定锚 — 只收「下次做类似任务给方向」的粗粒度指引，细碎条文宁可不存
- 项目事实直写工作区 — 项目专属经验直写
<workspace>/docs/devref/shoucang/，跨工作区红线隔离 - 拒收留痕 — 被门禁拒绝的条目写审计日志，蒸馏次数 / 入册数 / 拒收分布面板可见
- 断点安全 — 水位推进 + 在途并发守卫，宿主重启不重复蒸馏
🌙 深度睡眠（记忆巩固）
全部会话停滞 ≥ 3 小时（可配）自动运行一次归纳 pass：自上次归纳以来的新痕迹（无痕迹则本轮不睡）→ 归纳子代理提炼「习得原则」与「通用任务路径（[路径] 行，v17，具体值变量化）」与画像更新 → write_gate 校验 → 以 [原则]/[路径] 索引行原子写入 AGENT.md（反思双通道：认识自己 + 认识用户，同步维护 USER 画像）。归纳材料含窗口内任务运行成败统计（v17，ExpeL 式成败对比信号，定位真因用）。
- 会话活跃状态机 — RUNNING / ENDED / PROBING / SUSPECT / STALLED 五态，多轮采样 + 多信号交叉区分「正常长任务 / 卡住 / 异常退出」，除长任务外一律正常睡
- 失败可重试 — 瞬时故障回滚水位，重启回放不重复、不丢痕迹
🖥️ 设置面板
DSH 网页侧栏入口（纯 DOM 面板，深浅色跟随宿主主题）：
- 记忆板块 — 三索引容量卡、notes 分类浏览、小节直达、蒸馏统计与趋势
- 画像板块 — USER / AGENT 画像指针行，点击直达详情小节
- 参数调节 — 注入档位滑块、布尔开关一键切换，改动即时写回（备份先行）
- 深度睡眠视图 — 五态徽章、会话明细、停滞计时、手动归纳、阈值可调
- 插件集合 / 配置原文 — suite 装配状态、根目录管理、配置 YAML 原文编辑
🚀 安装
dsh plugin --profile web add github:Fishsb/dsh-shoucang-memory
安装后重启 DSH（dsh web），侧栏出现守藏入口即安装成功。
需本机已装 DeepSeek Harness。记忆库数据区默认在 DSH 技能目录下，可经
MEMORY_ROOT环境变量自定义位置。
⚙️ 配置
插件配置为扁平单层（面板或 config 文件均可改）：
| 配置项 | 说明 |
|---|---|
state_path |
面板 root 登记表存储位置（默认 ~/.dsh/storages/） |
members |
suite 外部成员注册表（默认空；单插件自足） |
enableDistill |
蒸馏器开关（默认开） |
idleWakeMs |
空闲唤醒阈值（默认 10 分钟） |
distillPrescan |
信号词预筛（默认开，无关会话零成本跳过） |
llmProvider / llmModel |
蒸馏子代理指定模型（缺省跟随主会话） |
enableDeepSleep / deepSleepIdleMs |
深度睡眠开关与停滞阈值（默认开 / 3 小时） |
deepSleepProbe* |
长任务探测：采样次数 / 确认轮数 / 重试 / 兜底时长 |
📚 文档
🔒 隐私：记忆库全部数据只存本机，不随仓库发布、不上报任何数据。
🛠️ 开发
npm install --legacy-peer-deps
npm run typecheck && npm run build
License: Apache-2.0
Operate deliberately
Install and manage
Prerequisites and target Profile
Target： Web Profile
Delivery： Dsh Bundle Git — Fishsb/dsh-shoucang-memory#5e02cc9aabc45aa06f6a02b3eb642edff7a93915。
Verify, update, and remove
Show lifecycle commands
dsh plugin --profile web listCompatibility and access
DSH bundle; requires declared DSH peer dependencies： Not declared in supplied evidence。
Review compatibility evidence ↗
Risk facts
Stores long-term memory and user-profile data locally; storage location can be configured.
Evidence ↗Can automatically distill idle sessions and consolidate learned material after prolonged inactivity.
Evidence ↗Evidence and editorial reviewManifest, Bundle patch, distribution and freshness
Immutable evidence
Review status and source activity
Use this for local, persistent DSH memory only after reviewing how its automated distillation and configured model behavior fit your privacy expectations.
AI reviewed Sep 10, 2026, 2:20 PM UTC。GitHub facts last checked Sep 10, 2026, 2:20 PM UTC。
No material source change has been recorded since this evidence baseline.