dsh-memweave
lw24-1936/dsh-memweave
Memweave is a DSH organizational memory and task-evolution plugin. It decomposes goals into task networks, captures verifiable judgments and anti-patterns, and tracks iteration with measurable Loops. Features visual storage settings, category browsing, lifecycle management, and data exchange with existing plugins.
Install
dsh plugin --profile web add github:lw24-1936/dsh-memweaveREADME
织忆 dsh-memweave
把任务、判断、反模式与可衡量 Loop 织成组织记忆。
一个可验证、可检索、可融合的 DeepSeek Harness 插件。
快速开始 · 使用指南 · 工具 · 设置页 · 架构 · 界面预览 · 融合 · 设计文档 · 更新日志 · English
目录
为什么是“织忆”
大多数“记忆”只是把聊天记录存起来。织忆关心的是另一件事:一条经验凭什么值得被下一次任务信任?
它把组织进化的三个原则直接写进工具契约:
| 原则 | 在织忆里的硬约束 |
|---|---|
| 以任务为中心,而不是以岗位为中心 | 任务网络是基本单元;节点只标 human / agent / hybrid,不预设岗位 |
| 沉淀隐性知识,而不是操作手册 | judgment 必须说明“为什么有效”;anti_pattern 必须说明“什么情况下无效” |
| 流程闭环,而不是重复劳动 | Loop 必须有指标、目标、单位、节奏;三轮起才给趋势 |
两条贯穿始终的约束:
- 反模式优先:检索结果里没有反模式、但存在相关反模式时,强制召回最高分的一条。
- 记忆需验证:新记忆是
candidate,不进入默认检索池;只有memweave_memory_verify(valid)后才进入verified。
亮点
| 图标 | 能力 | 说明 |
|---|---|---|
| 🧠 | 可验证的记忆生命周期 | candidate → verified / disputed / superseded,置信度随验证结果变化 |
| 🪤 | 反模式强制召回 | 不让“踩过的坑”淹没在成功经验里 |
| 📈 | 可衡量 Loop | 没有指标、目标、单位、节奏,就不能创建循环 |
| 🕸️ | 任务网络 | 目标拆成带依赖的任务节点,并自动注入相关反模式警告 |
| 🖥️ | 三个设置标签页 | 存储与分类、记忆浏览、融合,全部读写同一份 Host 数据 |
| 🔌 | 只读融合层 | 五个固定内置适配器;不改配置、不劫持工具、不自动同步、不自动探测 |
| 🧠 | 自动学习(可选) | 归档脱敏会话事件(含工具操作);记忆提炼明确决定/纠正和会话摘要 |
| 🔒 | 本地原子存储 | 独占临时文件 + rename;单文件写入原子 |
| 📦 | 零第三方运行时依赖 | Host 只依赖 DSH SDK 与 Node 内置模块;Client 只用宿主 React |
设计取舍:固定适配器,不做插件市场巡检
Memweave 的职责是记忆生命周期,不是插件发现或市场管理。
- 五个适配器固定内置,状态可预期;
- 不扫描 profile、工具名或插件市场,避免把“已安装但没有数据”误报为可用;
- 只有显式
memweave_import/memweave_export才读取 workspace 中的兼容文件; - 插件市场巡检和已安装插件展示已移除;需要安装、启用或删除插件时,使用 DSH 的插件市场/插件管理器。
这样融合页只回答一个问题:五个固定适配器现在是否启用、方向是什么。

界面预览
以下截图来自真实运行的 DSH 0.2.x Web UI;插件列表 是设置外壳自带的标签页,织忆贡献其余三个。示例数据仅用于演示。完整操作步骤与更多截图见 使用指南。
存储与分类:绝对路径、五类计数与状态分布

记忆浏览:状态/类型/关键词筛选,列表与验证入口

融合:5 个固定内置记忆适配器(截图为前 3 项,向下滚动可查看全部 5 项)

架构
flowchart LR
subgraph C["Client 半 · 设置 → 插件"]
UI1["存储与分类"]
UI2["记忆浏览"]
UI3["融合"]
end
subgraph H["Host 半 · lib/index.js"]
TOOLS["10 × memweave_* 工具"]
API["/memweave/api<br/>同源路由"]
CORE["core<br/>memory · network · loop · fusion"]
PATHS["paths<br/>解析 · 原子写入"]
end
UI1 --> API
UI2 --> API
UI3 --> API
TOOLS --> CORE
API --> CORE
CORE --> PATHS
PATHS --> STORE[(".memweave/<br/>memories · tasknets · loops")]
CORE -. 显式文件桥接 .-> OTHER["workspace 兼容文件<br/>.dsh-memory / .dsh-cue-bank / ..."]
| 半边 | 职责 | 不做什么 |
|---|---|---|
| Host | 10 个工具、记忆/任务/Loop 核心、原子存储、同源设置 API、5 个固定内置适配器 | 不渲染 UI、不打包、不混淆 |
| Client | 三个设置标签页、筛选/详情/验证/融合开关、主题 token | 不直接读写文件、不操作宿主 DOM |
Host 的必需依赖只有 tools;webServer、configEditor 是可选依赖。5 个适配器固定内置,不做自动插件探测;缺失 UI 能力时工具仍可用。
快速开始
环境要求
- DeepSeek Harness Desktop 0.2.x(desktop profile)
- 一个可写的 workspace
- 无需从 npm 安装第三方运行时依赖
1. 安装
在 DSH 的 plugin_manager 中调用:
{
"action": "install_bundle",
"target": "<本仓库的绝对路径>"
}
也可以直接安装 GitHub 仓库:
dsh plugin --profile desktop add git+https://github.com/lw24-1936/dsh-memweave.git
npx @deepseek-ai/dsh plugin --profile desktop add git+https://github.com/lw24-1936/dsh-memweave.git
安装完成后,dsh-memweave 会成为当前 profile 的一个 bundle。默认 patch 只插入自身一行:
- insert:
- id: memweave
name: dsh-memweave
2. 验证
| 检查项 | 预期 |
|---|---|
| 设置 → 插件 | 出现 存储与分类、记忆浏览、融合 三个标签页 |
| 模型工具 | 可见 10 个 memweave_* 工具 |
| 默认存储 | 当前会话 workspace 下的 .memweave/ |
DSH 的普通 Config 字段变更会重启插件。保存存储路径后若页面短暂提示“读取失败”,等一秒点“重试”即可;UI 已内置一次重试。
3. 跑一次完整闭环
# 1. 拆任务
memweave_decompose("把插件做到可安装")
# 2. 定义可衡量 Loop
memweave_loop_start(
loopName="发布周期",
metricName="交付时长",
metricTarget=3,
metricUnit="天",
cadence="weekly"
)
# 3. 记录一轮
memweave_loop_record(loopId, 5)
# 4. 复盘后沉淀判断
memweave_precipitate(
type="judgment",
content="先注册工具再写 UI,能更早发现契约错误",
rationale="defineTool 在注册阶段就会校验 schema"
)
# 5. 下一次任务中检索,并验证它是否真的有用
memweave_memory_find("插件 schema 注册")
memweave_memory_verify(memoryId, "valid", "在任务 42 复现")
三轮之后,memweave_loop_record 才会返回 improving / worsening / stable;在此之前是 insufficient_data。
工具
共 10 个模型工具。所有工具只返回 canonical JSON,output.render 恰好输出一个文本块。
| 工具 | 类别 | 何时用 | 关键约束 |
|---|---|---|---|
memweave_decompose | 任务网络 | 开始新任务、拆解模糊目标 | 确定性 6 节点骨架;节点带 dependsOn 与 executor |
memweave_precipitate | 组织记忆 | 任务完成、发现有效判断、踩坑 | anti_pattern 必须有 antiPatterns;judgment 必须有 rationale |
memweave_memory_find | 组织记忆 | 拆任务、设计 Loop、引用旧判断 | 默认只搜 verified;反模式强制召回 |
memweave_memory_verify | 组织记忆 | 用过一条记忆、知道它是否有效 | valid +0.15;invalid −0.25,低于 0.3 转 disputed |
memweave_memory_list | 组织记忆 | 浏览、分类计数、分页 | summaryByType 始终五个键 |
memweave_loop_start | 可衡量 Loop | 定义可迭代的流程 | 指标名/目标/单位/节奏必填 |
memweave_loop_record | 可衡量 Loop | 每轮迭代结束 | 三轮起计算趋势;v1 约定越小越好 |
memweave_fusion_status | 融合 | 问兼容性、导入导出前 | 五个固定内置适配器;不做自动探测 |
memweave_import | 融合 | 明确要求从兼容格式导入 | dryRun 不写盘;正式导入写 candidate、confidence=0.4 |
memweave_export | 融合 | 明确要求导出为兼容格式 | 只写 .memweave-exports/,不写对方目录 |
记忆类型
| 类型 | 回答的问题 | 必填 |
|---|---|---|
fact | 发生了什么? | content |
procedure | 怎么做? | content |
judgment | 为什么这样做有效? | content + rationale |
anti_pattern | 什么情况下会失效? | content + antiPatterns |
relation | 两条记忆如何关联? | content |
设置页
打开 设置 → 插件:
| 标签页 | 你能做什么 |
|---|---|
| 存储与分类 | 查看存储根、来源与目录状态;保存/清除绝对路径;查看五类计数与四种状态;点击分类下钻 |
| 记忆浏览 | 按状态/类型/关键词筛选;分页浏览;查看详情;执行“有效 / 无效 / 未定”验证 |
| 融合 | 查看 5 个固定内置记忆适配器的状态;开关融合;选择读/写/双向 |
验证按钮与 memweave_memory_verify 共用同一个 Host core,不存在两套写入逻辑。
分类点击会在本页展开该分类明细,并把筛选预置给“记忆浏览”;由于设置外壳没有向注册者暴露“切换标签页”的 API,织忆不读取或操作宿主 DOM。
配置
插件通过 DSH 原生 Config 暴露两个字段:
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
storageRoot | string | "" | 记忆存储根目录的绝对路径;留空使用当前 workspace 的 .memweave/ |
fusion | object | {} | { "<pluginKey>": { enabled: boolean, direction: "read" | "write" | "both" } } |
规则:
storageRoot必须是绝对路径;相对路径会被 Host 以INVALID_ARGUMENT拒绝。- 清除
storageRoot后回退到 workspace 的.memweave/。 - 修改普通 Config 字段会触发插件重启,这是 DSH 的生命周期规则,不是插件自行重启。
- 设置页通过
configEditor写回 profile patch,不直接改 profile 文件。
存储与记忆生命周期
目录
<root>/
├── memories/<memoryId>.json
├── tasknets/<netId>.json
└── loops/<loopId>.json
生命周期
stateDiagram-v2
[*] --> candidate: precipitate (confidence 0.5)
candidate --> verified: verify(valid) +0.15
candidate --> disputed: verify(invalid), confidence < 0.3
verified --> verified: verify(invalid), confidence >= 0.3
verified --> disputed: verify(invalid), confidence < 0.3
disputed --> verified: verify(valid)
verified --> superseded: 新版本取代
disputed --> superseded
superseded --> [*]
candidate:新写入,默认检索池不可见。verified:经过正向验证,进入默认检索池。disputed:验证无效且置信度低于 0.3;可浏览,但不进入检索池。superseded:被新版本取代;保留归档,不参与检索,拒绝再次验证。
v1 没有自动 supersede 工具;该状态由未来版本或手工维护。
precipitate只返回重叠提示,不会擅自替代旧记忆。
检索打分
score = tfidf(query, memory) × trust × type_boost
trust = confidence × (1 + 0.6 × (freshness − 0.5))
freshness = clamp(1 − ageDays(lastVerifiedAt ?? createdAt) / 90, 0, 1)
type_boost = anti_pattern 1.3 / judgment 1.1 / procedure 1.0 / fact 0.9 / relation 0.8
- 词法:拉丁/数字按词,中文按二元组(bigram)。
- 默认语料:
verified;includeCandidates=true时追加candidate。 - 反模式强制召回:Top N 没有反模式、但存在相关反模式时,用最高分反模式替换最低分结果。
原子写入
tmp = <targetDir>/<targetName>.tmp.<12 hex>
open(tmp, 'wx', 0o600) → write → close → rename(tmp, target)
失败:best-effort unlink(tmp)
- 单文件写入原子;跨文件操作不是事务。
- 超过 1 小时的孤儿
.tmp.*由memweave_memory_list顺带清理。 - v1 不 fsync。
融合
织忆不 import 其他插件的运行时值,不修改其他插件的配置,不劫持其他插件的工具。融合固定为五个内置适配器,只在显式导入/导出时读取 workspace 下的兼容文件;不做自动插件探测。
兼容矩阵
| 插件 | 来源 | 文件/格式 | 默认方向 |
|---|---|---|---|
dsh-memory-xfy | 内置 | .dsh-memory/**/*.md | 读 |
dsh-memory-plus | 内置 | .dsh-memory/**/*.json | 读 |
dsh-cue-bank | 内置 | .dsh-cue-bank/**/*.json | 读 |
dsh-task-memory | 内置 | .dsh-task-memory/**/*.md | 读 |
dsh-graphmemory | 内置 | .dsh-graphmemory/**/*.json | 读 |
显式导入 / 导出
memweave_fusion_status()
# 只预览,不写盘
memweave_import(pluginKey="dsh-memory-xfy", dryRun=true)
# 正式导入:candidate、confidence=0.4
memweave_import(pluginKey="dsh-memory-xfy")
# 只写 workspace/.memweave-exports/
memweave_export(pluginKey="dsh-memory-xfy", statusFilter="verified")
导入的 anti_pattern 如果没有反模式说明,会被降级为 fact,避免把违反契约的数据写进库。
自动学习(可选)
自动学习默认关闭。开启后:
- 监听新会话的
user/message,并从历史会话回填; - 归档脱敏后的用户/助手消息、工具调用与结果到
sessions/*.jsonl; - 只把明确决定/纠正和会话摘要写入记忆,不把原始工具输出注入记忆;
- 自动脱敏密钥/token;
- 明确决定在实时会话可自动验证,其余写为
candidate; - 历史回填统一写为
candidate,不会自动验证; - 可按项目或技能名限定范围;
- 历史回填在“存储与分类”里手动触发,有界且可重复。
不会自动把记忆注入每轮对话;Agent 仍通过 memweave_memory_find 检索。
完整边界与操作见 自动学习。

可选聚合层
DSH 0.2.x 的 Loader patch 没有 optional: true 行语义:缺失包的行会变成 failed fiber。因此织忆不把兼容插件直接塞进默认 patch,而是提供一个加法层:
# 1) 先安装 dsh-memweave(独立 bundle)
# 2) 生成只包含本机已安装兼容包的 patch
node scripts/prepare-aggregate.mjs --profile <profile-dir>
# 3) 把 aggregate/ 作为第二个 bundle 安装
# plugin_manager -> install_bundle -> target = <repo>/aggregate
patches/aggregate.yaml是声明式单一事实来源。scripts/prepare-aggregate.mjs检查本机安装情况,只写入可用的 optional 行。- 不会重复插入
dsh-memweave(避免 Loader 重复 entry id),聚合是独立安装之上的加法层。 - 安装聚合后,
memweave_fusion_status通过memweaveAggregate服务报告aggregateBundle: true。
安全与隐私
- 同源设置 API:
/memweave/api只接受 loopback 或显式 trusted host;拒绝跨站sec-fetch-site与异源Origin。 - 本地数据:记忆、任务网络、Loop 全部写在用户指定的本地目录;不联网、不上传。
- 路径校验:
storageRoot必须是绝对路径;id 只允许安全字符,防止路径穿越。 - 导入边界:只读 workspace 下公开的记忆文件;不写其他插件目录。
- 导出边界:只写 workspace 的
.memweave-exports/,由用户自行搬运。 - 无凭据存储:插件不保存 API key、token 或其他凭据。
开发与测试
结构
dsh-memweave/
├── lib/ # Host 半:10 个工具、core、存储、API、融合
├── client/ # Client 半:classic script,注册三个设置标签页
├── patches/ # 默认 bundle patch + 声明式聚合清单
├── aggregate/ # 可选聚合包(marker + 生成的 patch)
├── scripts/ # prepare-aggregate.mjs
├── locale/ # zh/en 显示元数据
├── test/ # 41 个测试:Host、API、paths、client、aggregate
├── DESIGN.md # 完整设计文档与 ADR
└── README.md
命令
npm test # node --test "test/*.test.mjs"
npm run check # 语法检查 Host/Client 入口
node scripts/prepare-aggregate.mjs --profile <profile-dir>
工程纪律
- Host 半明文可读,不打包、不混淆。
- Host 不使用第三方运行时依赖;Client 不引入外部 UI 库。
- Client 只使用宿主主题 token,不读取或操作宿主 DOM。
- 工具的
description以Use when …开头;每个execute观察exec.signal。 - 可预期失败抛带 code 的
HarnessError;不返回{ ok:false }。
本地测试需要能解析 @deepseek-ai/dsh-tools、@deepseek-ai/dsh-llm、@deepseek-ai/schemastery;本机由 DSH profile 的共享 SDK 目录提供,仓库不提交 node_modules。
故障排查
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 设置里看不到三个标签页 | 插件未启用 / 页面未刷新 | 在插件管理中确认 dsh-memweave 已启用;刷新页面 |
模型看不到 memweave_* 工具 | 插件 fiber 未激活 | 查看插件清单状态;禁用再启用一次 |
| 保存存储路径后报读取失败 | Config 变更触发重启的竞态 | 等 1 秒点“重试”;UI 已自动重试一次 |
提示 storageRoot 必须是绝对路径 | 填了相对路径 | 改为绝对路径,或清空使用 .memweave/ |
| 聚合安装后没有 marker | 先装了聚合、未装独立版 | 先安装 dsh-memweave,再安装 aggregate/ |
| 导入 0 条、跳过 N 条 | 内容重复或文件不可读 | 先 dryRun 看示例;检查文件编码与格式 |
路线图
| 版本 | 状态 | 内容 |
|---|---|---|
| v1.0 | ✅ 已发布 | 10 个工具、三个设置页、融合层、聚合层、41 个测试 |
| v1.1 | 计划 | 任务网络更新工具;superseded 工作流;向量检索(保留可解释排序) |
| v1.2 | 计划 | 更多融合适配器;导出格式扩展;截图与演示素材 |
| 未来 | 探索 | 团队级共享存储、记忆合并建议、Loop 与任务完成自动关联 |
未发布项不会以“已支持”的口吻出现在文档里。
设计文档
更完整的契约、状态机、评分算法、平台修正与 ADR 在 DESIGN.md:
- 为什么
ctx.settings.register不存在,以及Config + configEditor的等价实现; - 为什么 Client 不能直接调用 Host 工具,以及同源 API 的信任围栏;
dsh.client的真实加载机制;- 聚合层为什么不是
optional: true行; memory_verify/loop_record为什么在 schema 上补了字段。
贡献
问题与建议:https://github.com/lw24-1936/dsh-memweave/issues
欢迎 Issue / PR,但请先确认:
npm test全绿,新增行为有对应测试;- 不引入第三方 Host 运行时依赖或外部 Client UI 库;
- 工具 schema 的显式 object 节点声明
additionalProperties: false; - 不修改其他插件的配置、运行时或私有目录。
License
MIT © 2026 lw24-1936
织忆 / Memweave · built for DeepSeek Harness