dsh-self-memory — DSH 自记忆插件

一句话概览：给 DSH 智能体装上跨会话的「经验记忆」——遇到问题先查历史记录，尝试成功/失败都有回写，并把方法、脚本文件与模型调用全过程沉淀下来，新会话不再重复踩坑。

快速开始（3 步上手）

1. 安装

dsh plugin --profile web add <本目录>

免重启热挂载：对 AI 说 dev_install_package {"dir": "<本目录>"}。

2. 验证已生效

对 AI 说：selfmem_status → 应返回 schema=2 records=… solutions=…。 （代码更新后需 dev_reload_package dsh-self-memory，或重启 dsh 由 bundles 重新装配。）

3. 第一次使用

对 AI 说：selfmem_search {"query":"如何识图"} → 返回最匹配的记录列表（问题 + 多个方案，含 hits / 适用前提 / 冲突标注）。

日常闭环：新会话遇到问题 → 先 selfmem_search 查记录 → 有方案就执行，成功 selfmem_hit 标记、失败 selfmem_fail 记根因 → 没有方案就自行解决 → 最后 selfmem_record 把方法写回。

核心能力

工具一览

使用示例

记录一个带前提的方案

selfmem_record {"problem":"断网时如何安装插件","solution":"解压本地包 → dsh plugin add <目录> → pnpm install → dev_install_package 热挂载","keywords":{"plugin":1,"network":0.6},"appliesTo":{"network":"no"}}

前提感知检索（不同前提返回不同方案并标注）

selfmem_search {"query":"如何识图","context":{"model_vision":"no"}}
→ sol-offline-script（适用）；sol-switch-model 标注 [不适用当前前提]

外部导入

selfmem_import {"source":"examples/import-demo.json"}

标记成功 / 失败

selfmem_hit  {"query":"断网时如何安装插件","solutionId":"s-…"}
selfmem_fail {"query":"…","solutionId":"s-…","rootCause":"…"}

记录结构

{
  "schema": 2,
  "problem": "原始问题（含细节）",
  "abstractProblem": "泛化问题（细节隐去，自动生成）",
  "problemType": "…",
  "keywords": { "plugin": 1, "network": 0.6 },
  "tags": ["…"],
  "preconditions": { "network": "no" },
  "solutions": [
    { "id": "s-…", "method": "…", "scripts": [], "modelCalls": [],
      "appliesTo": { "network": "no" }, "conflictsWith": ["s-…"],
      "status": "active|superseded|conflicting",
      "hits": 0, "failedAttempts": 0, "rootCauses": [] }
  ]
}

项目结构（零依赖，纯 JS）

dsh-self-memory/
├── entry.js            # 公共出口
├── index.js            # 核心实现 + 工具注册（含 schema 合法性守卫）
├── lib/
│   ├── store.js        # JSON 持久化（v1 自动迁移 v2）
│   ├── search.js       # 打分：加权关键词 + 泛化 + bigram + 前提匹配
│   ├── indexer.js      # 倒排索引（快速候选集）
│   ├── norm.js         # 关键词规范化 + 同义词 + 问题泛化
│   └── seed.js         # 初始知识
├── tests/              # 单元测试（node:test，零依赖）
├── examples/           # 使用示例（如 import-demo.json）
├── cordis.patch.yml    # bundle 装配补丁
├── LICENSE             # MIT
└── package.json        # dsh.bundle.patch -> cordis.patch.yml

存储位置

~/.dsh/self-memory/records.json（{schema:2, records:[...]}，v1 自动迁移）。 零运行时依赖，只用 Node 内建模块。

测试

node --test   # 10 个单元测试：norm / search / store / schema（含防 400 事故的 schema 合法性测试）

许可证

MIT — 见 LICENSE。