dsh-macro-memory 0.0.0-stage → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +506 -2
- package/cordis.patch.yml +6 -0
- package/lib/client.js +3623 -0
- package/lib/index.js +502 -0
- package/lib/macro/brand.js +82 -0
- package/lib/macro/bridge.js +158 -0
- package/lib/macro/chain.js +206 -0
- package/lib/macro/contract.js +471 -0
- package/lib/macro/cost.js +164 -0
- package/lib/macro/defs/admin.js +442 -0
- package/lib/macro/defs/dream.js +24 -0
- package/lib/macro/defs/link.js +257 -0
- package/lib/macro/defs/project.js +25 -0
- package/lib/macro/defs/read.js +160 -0
- package/lib/macro/defs/remember.js +411 -0
- package/lib/macro/defs/search.js +871 -0
- package/lib/macro/defs/update.js +161 -0
- package/lib/macro/dreamledger.js +1398 -0
- package/lib/macro/facade.js +135 -0
- package/lib/macro/fusion.js +182 -0
- package/lib/macro/linkflow.js +391 -0
- package/lib/macro/links.js +448 -0
- package/lib/macro/neighbor.js +209 -0
- package/lib/macro/panel.js +96 -0
- package/lib/macro/prompt.js +139 -0
- package/lib/macro/provenance.js +148 -0
- package/lib/macro/render.js +35 -0
- package/lib/macro/revisions.js +253 -0
- package/lib/macro/shared.js +113 -0
- package/lib/macro/store.js +103 -0
- package/lib/macro/supersede.js +197 -0
- package/lib/macro/tokencost.js +90 -0
- package/lib/macro/tools.js +67 -0
- package/package.json +54 -4
- package/vendor/VENDOR.json +23 -0
- package/vendor/dsh-memory-nebula/CONTRIBUTING.md +48 -0
- package/vendor/dsh-memory-nebula/LICENSE +21 -0
- package/vendor/dsh-memory-nebula/README.en.md +203 -0
- package/vendor/dsh-memory-nebula/README.md +253 -0
- package/vendor/dsh-memory-nebula/SECURITY.md +43 -0
- package/vendor/dsh-memory-nebula/SUPPORT.md +33 -0
- package/vendor/dsh-memory-nebula/cordis.patch.yml +4 -0
- package/vendor/dsh-memory-nebula/lib/client.js +105 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/index.js +279 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/ingest.js +230 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/meow.js +320 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/notes.js +305 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/sqlite.js +287 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/util.js +231 -0
- package/vendor/dsh-memory-nebula/lib/host/bridge.js +351 -0
- package/vendor/dsh-memory-nebula/lib/host/compress.js +97 -0
- package/vendor/dsh-memory-nebula/lib/host/demo.js +357 -0
- package/vendor/dsh-memory-nebula/lib/host/diagnostics.js +125 -0
- package/vendor/dsh-memory-nebula/lib/host/doctor.js +270 -0
- package/vendor/dsh-memory-nebula/lib/host/entities.js +230 -0
- package/vendor/dsh-memory-nebula/lib/host/graph.js +1762 -0
- package/vendor/dsh-memory-nebula/lib/host/graphcache.js +290 -0
- package/vendor/dsh-memory-nebula/lib/host/http.js +993 -0
- package/vendor/dsh-memory-nebula/lib/host/injectcfg.js +95 -0
- package/vendor/dsh-memory-nebula/lib/host/ledger.js +175 -0
- package/vendor/dsh-memory-nebula/lib/host/live.js +204 -0
- package/vendor/dsh-memory-nebula/lib/host/nebula.js +2105 -0
- package/vendor/dsh-memory-nebula/lib/host/page.js +75 -0
- package/vendor/dsh-memory-nebula/lib/host/path.js +83 -0
- package/vendor/dsh-memory-nebula/lib/host/recall.js +524 -0
- package/vendor/dsh-memory-nebula/lib/host/share.js +633 -0
- package/vendor/dsh-memory-nebula/lib/host/sources.js +266 -0
- package/vendor/dsh-memory-nebula/lib/host/store.js +333 -0
- package/vendor/dsh-memory-nebula/lib/host/text.js +410 -0
- package/vendor/dsh-memory-nebula/lib/host/transcripts.js +396 -0
- package/vendor/dsh-memory-nebula/lib/index.js +782 -0
- package/vendor/dsh-memory-nebula/lib/standalone.mjs +315 -0
- package/vendor/dsh-memory-nebula/lib/web/api.js +426 -0
- package/vendor/dsh-memory-nebula/lib/web/app.js +4172 -0
- package/vendor/dsh-memory-nebula/lib/web/i18n.js +580 -0
- package/vendor/dsh-memory-nebula/lib/web/index.html +174 -0
- package/vendor/dsh-memory-nebula/lib/web/nav.js +132 -0
- package/vendor/dsh-memory-nebula/lib/web/render.js +1890 -0
- package/vendor/dsh-memory-nebula/lib/web/space3d.js +1883 -0
- package/vendor/dsh-memory-nebula/lib/web/style.css +1402 -0
- package/vendor/dsh-memory-nebula/locale/en.json +7 -0
- package/vendor/dsh-memory-nebula/locale/zh.json +7 -0
- package/vendor/dsh-memory-nebula/market/assets/icon-180.png +0 -0
- package/vendor/dsh-memory-nebula/market/assets/icon.svg +40 -0
- package/vendor/dsh-memory-nebula/market/index.json +101 -0
- package/vendor/dsh-memory-nebula/package.json +87 -0
- package/vendor/dsh-memory-nebula/sidecar.ps1 +119 -0
- package/vendor/meow-memory/LICENSE +21 -0
- package/vendor/meow-memory/README.en.md +192 -0
- package/vendor/meow-memory/README.md +174 -0
- package/vendor/meow-memory/README.pt-br.md +180 -0
- package/vendor/meow-memory/cordis.patch.yml +7 -0
- package/vendor/meow-memory/lib/client.js +3344 -0
- package/vendor/meow-memory/lib/client.js.map +7 -0
- package/vendor/meow-memory/lib/index.js +9802 -0
- package/vendor/meow-memory/lib/index.js.map +7 -0
- package/vendor/meow-memory/lib/prompts/README.md +65 -0
- package/vendor/meow-memory/lib/prompts/en/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/en/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/en/dream-project-summary.md +12 -0
- package/vendor/meow-memory/lib/prompts/en/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/en/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/en/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/en/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/en/reflect.md +31 -0
- package/vendor/meow-memory/lib/prompts/en/system-guide.md +121 -0
- package/vendor/meow-memory/lib/prompts/en/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/en/welcome-guide.md +12 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-project-summary.md +12 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/pt-br/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/pt-br/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/pt-br/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/pt-br/reflect.md +31 -0
- package/vendor/meow-memory/lib/prompts/pt-br/system-guide.md +121 -0
- package/vendor/meow-memory/lib/prompts/pt-br/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/pt-br/welcome-guide.md +12 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-project-summary.md +19 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/zh/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/zh/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/zh/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/zh/reflect.md +30 -0
- package/vendor/meow-memory/lib/prompts/zh/system-guide.md +119 -0
- package/vendor/meow-memory/lib/prompts/zh/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/zh/welcome-guide.md +12 -0
- package/vendor/meow-memory/package.json +64 -0
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
# meow-memory 🐱📝
|
|
2
|
+
|
|
3
|
+
| [中文](README.md) | [English](README.en.md) | [Português (BR)](README.pt-br.md) | [MIT License](LICENSE) |
|
|
4
|
+
| :---: | :---: | :---: | :---: |
|
|
5
|
+
|
|
6
|
+
为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)打造的跨会话记忆插件。
|
|
7
|
+
|
|
8
|
+
当前版本 **0.31.0** | 版本变更见 [CHANGELOG.md](CHANGELOG.md) | 兼容 **dsh 0.1.5**
|
|
9
|
+
|
|
10
|
+
## ✨ 功能特性
|
|
11
|
+
|
|
12
|
+
- **七层记忆**:`soul`(AI 自身)/ `user`(用户信息与偏好)/ `project`(项目信息,含 `subcategory`)/ `fact`(原子事实)/ `lesson`(教训与纠正)/ `topic`(进行中的话题,带目标句)/ `rules`(设计原则与行为准则)。每层一张 SQLite 表,UUID 带时间前缀,id 顺序即创建顺序。
|
|
13
|
+
- **首轮注入(长期记忆块)**:第一条用户消息前注入 soul / user / 设计原则 / 记忆导引。记忆作为独立 plugin snapshot 消息放在真实 user 消息之前,**不改写用户 prompt**;**首轮不跑关键词命中**(命中从第二轮起)。
|
|
14
|
+
- **每消息关键词命中**:从第二条用户消息起,每条真实用户消息检索 fact/lesson/rules/topic(全局 + 当前 project 锚定),top-2 命中注入。命中基于**条目关键词**而非全文。
|
|
15
|
+
- **当前 project 锚定**:带 project 参数即锚定该会话的当前项目;未锚定时命中只搜全局(用户闲聊不误伤)。
|
|
16
|
+
- **缓存友好设计**:静态 `meow-memory:guide` section 在 system prompt 中注册一次——文本恒定,破坏不了 provider 的 KV 缓存。
|
|
17
|
+
- **压缩后重注入**:会话压缩后,下一轮自动重新注入长期记忆快照 + 本会话查阅过的项目全景 + 本会话写入过的记忆原文,AI 不会因为压缩突然失忆。
|
|
18
|
+
- **七层之上的三件事**:写入自动去重合并、按 `updated_at` 展示记忆时间戳、全局信息用全局标记(区别于留空)。
|
|
19
|
+
- **按窗口 dream**:窗口空闲 ≥3 小时即允许整理,由该窗口自己的主 agent 分三轮处理(原子记忆 / topic / 项目总结),**峰时抑制**(默认北京时间 09:00–12:00、14:00–18:00,API 峰谷电价峰时)不触发。也可敲 `/dream` 立刻手动整理。
|
|
20
|
+
- **反思**:单次任务内连续 ≥7 个工具 step 后,插件询问模型自上次整理以来是否有值得记忆的内容。最后工具是 `memory_*` 视为已主动记忆、不重复反思。
|
|
21
|
+
- **外部记忆库信任门**:工作区自带的 `.dsh-meow` 若非本机创建(如 clone 的外部仓库),默认暂停注入/检索/整理——首轮提示一次,`/meow-trust` 一键信任、即刻生效;本机创建与升级前打开过的工作区自动信任,正常使用零感知。
|
|
22
|
+
- **客户端 UI**:注入文本折叠成横条、反思/dream 轮折叠成一条可展开的卡片、会话列表显示 dream 状态图标(🌙 已整理 / 呼吸灯 进行中 / 灰月牙斜杠 已跳过)。
|
|
23
|
+
- **无需另装运行时依赖**:`node:sqlite` + esbuild 产物(`lib/index.js`);`schemastery` 和 `dsh-llm` 由 DSH 宿主解析提供。**无原生模块。**
|
|
24
|
+
|
|
25
|
+
## 📦 安装
|
|
26
|
+
|
|
27
|
+
### 一键安装(推荐)
|
|
28
|
+
|
|
29
|
+
```sh
|
|
30
|
+
dsh plugin --profile web add github:Phant0Meow/dsh-meow-memory
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
一条命令装完即生效:安装时自动编译(包内含 `prepare` 脚本),自动挂载,重启 `dsh web` 后新会话自动加载插件。
|
|
34
|
+
|
|
35
|
+
> pnpm ≥10 默认会阻止安装期的构建脚本:首次 `add` 可能失败并提示 `allowBuilds`,按提示把输出的键加进 profile 的 `pnpm-workspace.yaml` 后重跑即可。
|
|
36
|
+
|
|
37
|
+
### 卸载
|
|
38
|
+
|
|
39
|
+
```sh
|
|
40
|
+
dsh plugin --profile web remove meow-memory
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### PT-BR Fork
|
|
44
|
+
|
|
45
|
+
想要巴西葡语打包版本的仓库:[coutogilson](https://github.com/coutogilson) 的 fork:
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
dsh plugin --profile web add github:coutogilson/dsh-meow-memory
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### 手动安装(开发者,任意 DSH 安装,无需 npm)
|
|
52
|
+
|
|
53
|
+
1. 把本包复制(或软链)到 profile 的 `node_modules`:
|
|
54
|
+
|
|
55
|
+
```sh
|
|
56
|
+
mkdir -p ~/.dsh/profiles/web/node_modules
|
|
57
|
+
ln -s /path/to/meow-memory ~/.dsh/profiles/web/node_modules/meow-memory
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
(Windows:`New-Item -ItemType Junction ...` —— NTFS junction,无需管理员权限。)
|
|
61
|
+
|
|
62
|
+
2. 把 `meow-memory` 加进 profile `package.json` 的 `dsh.profile.bundles`。
|
|
63
|
+
|
|
64
|
+
3. 重启 `dsh web`。新会话自动加载插件。
|
|
65
|
+
|
|
66
|
+
## 🔌 兼容性
|
|
67
|
+
|
|
68
|
+
支持 **dsh 0.1.5**(含最新的 `0.1.5-rc.1`),同时向下兼容旧版本——升级 dsh 不需要改本插件,也不需要改任何配置。
|
|
69
|
+
|
|
70
|
+
插件不写死版本号,而是运行时探测宿主能力,因此新旧版走各自正确的分支。已实测两代:`0.1.5-rc.1` 上首次注入、记忆工具调用、客户端渲染全部正常;`0.1.1-rc.2` 上行为与历史版本完全一致。
|
|
71
|
+
|
|
72
|
+
## ⚙️ 配置
|
|
73
|
+
|
|
74
|
+
所有字段均可选(profile patch 或 `cordis.patch.yml`)。**也可以不手编文件**:DSH 设置页里有本插件的「喵记忆」标签页(与「通用」「模型」平级),下面这些项全部图形化可改、字段级保存、可单项恢复默认(恢复默认 = 回到插件出厂默认,不受 patch 基线影响);保存后热重载/重启 meow-memory 插件生效。
|
|
75
|
+
|
|
76
|
+
```yaml
|
|
77
|
+
- id: meow-memory
|
|
78
|
+
name: 'meow-memory'
|
|
79
|
+
config:
|
|
80
|
+
enabled: true # 总开关
|
|
81
|
+
projectDir: '.dsh-meow' # 记忆目录(相对工作区)
|
|
82
|
+
promptLang: 'zh' # ⚠️ 首次使用建议显式配置(见下方说明)
|
|
83
|
+
hitTopK: 2 # 每条用户消息关键词命中的条目数上限
|
|
84
|
+
dream:
|
|
85
|
+
enabled: true
|
|
86
|
+
idleMinutes: 180 # 窗口空闲 ≥180 分钟(3 小时)允许 dream
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
**完整字段、类型与默认值见 [docs/配置参考.md](docs/配置参考.md)**,含 `titleMax` / `autoMigrate` / `homeDir` / `disabledWorkspaces` / `backup` / `delegate` 等全部配置项。
|
|
90
|
+
|
|
91
|
+
> ⚠️ **`promptLang` 首次使用建议显式配置。** 它决定注入/反思/dream 文案与工具描述的语言,同时影响模型写记忆条目用的语言——关键词按条目语言提取。内置 `zh` / `en` / `pt-br` 三套语言包。配置值就是 `src/prompts/` 的子目录名,**逐字匹配**:填一个不存在的名字(例如 `pt`)不会报错,而是静默落回中文包。详见 [docs/配置参考.md](docs/配置参考.md)。
|
|
92
|
+
|
|
93
|
+
### 界面语言
|
|
94
|
+
|
|
95
|
+
插件界面文案跟随 DSH 的「设置 → 通用 → 语言」(内置中文 / English / Português (Brasil)),与 `promptLang` 是两层、互不影响。详见 [docs/配置参考.md](docs/配置参考.md)。
|
|
96
|
+
|
|
97
|
+
## 🧠 工作原理
|
|
98
|
+
|
|
99
|
+
```
|
|
100
|
+
第一条用户消息(首轮) 第二条起的每条消息 空闲≥3h 且非峰时
|
|
101
|
+
┌────────────────────┐ ┌────────────────────┐ ┌──────────────────────┐
|
|
102
|
+
│ ===== 长期记忆 ===== │ │ 可能相关的记忆,仅供 │ │ 按窗口 dream: │
|
|
103
|
+
│ 【关于你】(soul) │ │ 参考:keywords 命中 │ │ 三轮(含项目总结) │
|
|
104
|
+
│ 【关于user】 │ │ top-2(全局+当前 │ │ 七层+提取过的, │
|
|
105
|
+
│ 【设计原则】(rules) │ │ project 锚定) │ │ updated_at 以 T 封存 │
|
|
106
|
+
│ 【记忆导引】 │ └────────────────────┘ └──────────────────────┘
|
|
107
|
+
└────────────────────┘ 已见 id 按会话记录
|
|
108
|
+
独立 plugin snapshot (sessions/<id>.json)
|
|
109
|
+
↓ 原样 user prompt 压缩信号 → 释放已见
|
|
110
|
+
每会话只注入一次,
|
|
111
|
+
首轮不做命中
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### 工具
|
|
115
|
+
|
|
116
|
+
| 工具 | 用途 |
|
|
117
|
+
|---|---|
|
|
118
|
+
| `memory_remember` | 写入一条记忆(必填 content/project/keywords/importance,自动去重合并) |
|
|
119
|
+
| `memory_search` | 关键词检索(BM25 × 近期权重,支持 level/project/status/days 过滤) |
|
|
120
|
+
| `memory_project` | 取回某项目的完整注入段落(**project 参数必填**) |
|
|
121
|
+
| `memory_find_similar` | 查重与冲突检测 |
|
|
122
|
+
| `memory_read` | 按 id 读取单条完整元数据 |
|
|
123
|
+
| `memory_update` | 修正 status / importance / goal / keywords |
|
|
124
|
+
| `memory_dream` | 手动触发本窗口的记忆整理 |
|
|
125
|
+
| `memory_home` | 查看 / 切换全局数据目录 |
|
|
126
|
+
|
|
127
|
+
另有 `/dream` 命令:在输入框敲 `/dream` 立即手动唤起本窗口的记忆整理,不受峰时抑制。
|
|
128
|
+
|
|
129
|
+
**参数、返回与副作用见 [docs/工具参考.md](docs/工具参考.md)**(含 `memory_project` 的项目锚定副作用与 `memory_home` 的三个预设目录标记)。
|
|
130
|
+
|
|
131
|
+
## 🛠 开发
|
|
132
|
+
|
|
133
|
+
```sh
|
|
134
|
+
npm install
|
|
135
|
+
npm run build # esbuild 打包 → lib/index.js(宿主 peer 保持 external)
|
|
136
|
+
npm run test # 228 项逻辑测试:db / bm25 / migrate / inject / reflect / dream / tools / apply
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
`@deepseek-ai/*` 包位于 dsh-meow pnpm workspace 中,不在本包的 `node_modules` 里。
|
|
140
|
+
在 Windows 上,`npm run link-workspace`(或 `scripts/link-workspace.ps1`)创建 workspace
|
|
141
|
+
包的 junction 镜像,使 esbuild 能解析它们;`build.mjs` 通过 `nodePaths` 引用。
|
|
142
|
+
构建不需要安装可选的 `dsh-llm` peer。直接用 Node 运行测试时,仍需从匹配的 DSH
|
|
143
|
+
workspace 链接 `@deepseek-ai/dsh-llm`;正常插件运行由 DSH 的 profile loader
|
|
144
|
+
解析宿主提供的 peer。不要把它加回 devDependencies,否则 `file:` / `link:`
|
|
145
|
+
安装可能再次向 profile 引入宿主核心包的另一份副本(#84)。
|
|
146
|
+
|
|
147
|
+
`node tests/build-host-peers.mjs` 单独验证无宿主 peer 的干净构建(#87)。
|
|
148
|
+
`node tests/host-peers.mjs /path/to/node_modules/@deepseek-ai/dsh` 使用另行安装的
|
|
149
|
+
官方 DSH,验证隔离 profile 的真实 Host 装载和消息契约,不调用模型。
|
|
150
|
+
|
|
151
|
+
## 📚 文档
|
|
152
|
+
|
|
153
|
+
| 想了解 | 看这里 |
|
|
154
|
+
| --- | --- |
|
|
155
|
+
| 七个工具的参数、返回与副作用 | [docs/工具参考.md](docs/工具参考.md) |
|
|
156
|
+
| 全部配置项、类型与默认值 | [docs/配置参考.md](docs/配置参考.md) |
|
|
157
|
+
| 为什么这样设计(缓存、命中、dream、踩过的坑) | [docs/设计说明.md](docs/设计说明.md) |
|
|
158
|
+
| 装不上、检索不准、报错怎么读 | [docs/常见问题.md](docs/常见问题.md) |
|
|
159
|
+
| 版本变更历史 | [CHANGELOG.md](CHANGELOG.md) |
|
|
160
|
+
| 加界面语言 | [src/i18n/README.md](src/i18n/README.md) |
|
|
161
|
+
| 加 prompt 语言包 | [src/prompts/README.md](src/prompts/README.md) |
|
|
162
|
+
|
|
163
|
+
## 🙏 致谢
|
|
164
|
+
|
|
165
|
+
感谢每一位贡献者让 meow-memory 越来越好:
|
|
166
|
+
|
|
167
|
+
- **[daveycodez](https://github.com/daveycodez)** — 英文语言包与英文分词([PR #6](https://github.com/Phant0Meow/dsh-meow-memory/pull/6),v0.22.0 发布)
|
|
168
|
+
- **[chenmzh](https://github.com/chenmzh)** — 记忆注入改为独立 plugin snapshot 消息,根治会话标题污染([PR #10](https://github.com/Phant0Meow/dsh-meow-memory/pull/10))
|
|
169
|
+
- **[cuddly-guacamole](https://github.com/cuddly-guacamole)** — dsh 0.1.2-alpha.4 双版本 Session events 兼容([PR #11](https://github.com/Phant0Meow/dsh-meow-memory/pull/11))
|
|
170
|
+
- **[coutogilson](https://github.com/coutogilson)** — 巴西葡语 prompt 语言包(`src/prompts/pt-br/`)与跟随 DSH 语言设置的界面文案层
|
|
171
|
+
|
|
172
|
+
## 📄 License
|
|
173
|
+
|
|
174
|
+
MIT —— 见 [LICENSE](LICENSE)。
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
# meow-memory 🐱📝
|
|
2
|
+
|
|
3
|
+
| [中文](README.md) | [English](README.en.md) | [Português (BR)](README.pt-br.md) | [MIT License](LICENSE) |
|
|
4
|
+
| :---: | :---: | :---: | :---: |
|
|
5
|
+
|
|
6
|
+
Memória entre sessões para o [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH).
|
|
7
|
+
|
|
8
|
+
Versão **0.31.0** | Histórico: [CHANGELOG.md](CHANGELOG.md) | Suporta **dsh 0.1.5**
|
|
9
|
+
|
|
10
|
+
## ✨ Recursos
|
|
11
|
+
|
|
12
|
+
- **Memória em sete níveis**: `soul` (a própria IA) / `user` (fatos e preferências do usuário) / `project` (informação de projeto, com `subcategory`) / `fact` (fato atômico) / `lesson` (o que se aprendeu e correções) / `topic` (assunto em andamento com frase-objetivo) / `rules` (princípios de design e diretrizes de comportamento). Uma tabela SQLite por nível, UUID com prefixo de tempo, a ordem dos ids é a ordem de criação.
|
|
13
|
+
- **Injeção da primeira rodada (bloco de memória de longo prazo)**: antes da primeira mensagem do usuário, injeta soul / user / princípios de design / guia de memória. A memória entra como uma mensagem plugin snapshot independente antes da mensagem real do usuário e **nunca reescreve o prompt dele**; **a primeira rodada não roda acertos por palavra-chave** (eles começam na segunda).
|
|
14
|
+
- **Acerto por palavra-chave a cada mensagem**: a partir da segunda mensagem do usuário, cada mensagem real busca fact/lesson/rules/topic (global + ancorado no projeto atual) e injeta os top-2 acertos. O acerto usa as **palavras-chave da entrada**, não o texto inteiro.
|
|
15
|
+
- **Ancoragem no projeto atual**: passar o parâmetro `project` ancora o projeto atual daquela sessão; sem ancoragem os acertos buscam só o global (conversa fiada do usuário não atrapalha).
|
|
16
|
+
- **Projetado para cache**: a section estática `meow-memory:guide` é registrada uma vez no system prompt — texto constante, então não quebra o cache KV do provider.
|
|
17
|
+
- **Reinjeção após compactação**: depois que a sessão é compactada, a rodada seguinte reinjeta automaticamente o snapshot de longo prazo + o panorama dos projetos consultados nesta sessão com `memory_project` + o texto das memórias que esta sessão escreveu/atualizou — a IA não perde a lembrança de repente.
|
|
18
|
+
- **Três coisas além dos níveis**: a escrita deduplica e faz merge automaticamente; o timestamp exibido é sempre o `updated_at`; informação global usa a marca global (distinto de deixar o campo vazio).
|
|
19
|
+
- **Dream por janela**: com a janela ociosa por ≥3 horas ela fica elegível, e o próprio agente principal dela consolida em rodadas (memórias atômicas / topic / resumo de projeto); a **supressão em horário de pico** (09:00–12:00 e 14:00–18:00 no `timeZone` configurado, padrão Asia/Shanghai — os picos de tarifa da API) impede o disparo. Digitar `/dream` consolida na hora, sob demanda.
|
|
20
|
+
- **Reflexão**: depois de ≥7 passos de ferramenta seguidos dentro de uma mesma tarefa, o plugin pergunta ao modelo se há algo que valha memorizar desde a última consolidação. Se a última ferramenta for `memory_*`, considera que já houve memorização ativa e não reflete de novo.
|
|
21
|
+
- **Portão de confiança de memória externa**: um `.dsh-meow` trazido pelo workspace que não foi criado nesta máquina (ex.: repositório externo clonado) fica pausado por padrão — um aviso na primeira rodada, e `/meow-trust` reativa na hora; bibliotecas criadas localmente e workspaces abertos antes do upgrade são confiados automaticamente, sem nenhum atrito no uso normal.
|
|
22
|
+
- **UI do cliente**: o texto injetado é recolhido em uma barra, as rodadas de reflexão/dream em um card expansível, e a lista de sessões mostra ícones de estado do dream (🌙 consolidado / lua em respiração em andamento / lua cinza com barra pulado).
|
|
23
|
+
- **Sem dependências de runtime instaladas separadamente**: `node:sqlite` + artefato esbuild (`lib/index.js`); o host DSH resolve os peers `schemastery` e `dsh-llm`. **Nenhum módulo nativo.**
|
|
24
|
+
|
|
25
|
+
## 📦 Instalação
|
|
26
|
+
|
|
27
|
+
### Instalação em um comando (recomendada)
|
|
28
|
+
|
|
29
|
+
```sh
|
|
30
|
+
dsh plugin --profile web add github:Phant0Meow/dsh-meow-memory
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Um comando instala e já vale: a instalação compila automaticamente (o pacote traz o script `prepare`), monta sozinho, e depois de reiniciar o `dsh web` novas sessões carregam o plugin automaticamente.
|
|
34
|
+
|
|
35
|
+
> O pnpm ≥10 bloqueia por padrão scripts de build na instalação: o primeiro `add` pode falhar pedindo `allowBuilds`; siga a instrução, adicione as chaves mostradas no `pnpm-workspace.yaml` do profile e rode de novo.
|
|
36
|
+
|
|
37
|
+
#### Fork em PT-BR
|
|
38
|
+
|
|
39
|
+
```sh
|
|
40
|
+
dsh plugin --profile web add github:coutogilson/dsh-meow-memory
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### Desinstalação
|
|
44
|
+
|
|
45
|
+
```sh
|
|
46
|
+
dsh plugin --profile web remove meow-memory
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### Instalação manual (desenvolvedores, qualquer instalação do DSH, sem npm)
|
|
50
|
+
|
|
51
|
+
1. Copie (ou crie um link simbólico de) este pacote para o `node_modules` do profile:
|
|
52
|
+
|
|
53
|
+
```sh
|
|
54
|
+
mkdir -p ~/.dsh/profiles/web/node_modules
|
|
55
|
+
ln -s /path/to/meow-memory ~/.dsh/profiles/web/node_modules/meow-memory
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
(Windows: `New-Item -ItemType Junction ...` — junction NTFS, sem precisar de administrador.)
|
|
59
|
+
|
|
60
|
+
2. Adicione `meow-memory` ao `dsh.profile.bundles` do `package.json` do profile (como acima).
|
|
61
|
+
|
|
62
|
+
3. Reinicie o `dsh web`. Novas sessões carregam o plugin automaticamente.
|
|
63
|
+
|
|
64
|
+
## 🔌 Compatibilidade
|
|
65
|
+
|
|
66
|
+
Suporta **dsh 0.1.5** (incluindo o `0.1.5-rc.1` mais recente) e também versões antigas — atualizar o dsh não exige mudar este plugin nem nenhuma configuração.
|
|
67
|
+
|
|
68
|
+
O plugin não fixa número de versão: ele detecta as capacidades do host em runtime, então cada versão segue o ramo correto. Duas gerações já foram testadas de verdade: no `0.1.5-rc.1` a primeira injeção, as chamadas das ferramentas de memória e a renderização no cliente funcionam; no `0.1.1-rc.2` o comportamento é idêntico ao das versões anteriores.
|
|
69
|
+
|
|
70
|
+
## ⚙️ Configuração
|
|
71
|
+
|
|
72
|
+
Todos os campos são opcionais (patch do profile ou `cordis.patch.yml`). **Também dá para não editar arquivo nenhum**: a página de configurações do DSH tem a aba "Meow memory" deste plugin (no mesmo nível de "Geral" e "Modelos"), onde todos os itens abaixo são editáveis na interface, com gravação por campo e restauração individual do padrão (restaurar padrão = voltar ao padrão de fábrica do plugin, sem sofrer a base do patch); depois de salvar, vale após recarregar a quente/reiniciar o plugin meow-memory.
|
|
73
|
+
|
|
74
|
+
```yaml
|
|
75
|
+
- id: meow-memory
|
|
76
|
+
name: 'meow-memory'
|
|
77
|
+
config:
|
|
78
|
+
enabled: true # chave geral
|
|
79
|
+
projectDir: '.dsh-meow' # diretório de memória (relativo ao workspace)
|
|
80
|
+
promptLang: 'pt-br' # ⚠️ configure explicitamente no primeiro uso (ver abaixo)
|
|
81
|
+
hitTopK: 2 # máximo de entradas por acerto de palavra-chave a cada mensagem
|
|
82
|
+
dream:
|
|
83
|
+
enabled: true
|
|
84
|
+
idleMinutes: 180 # janela ociosa por ≥180 minutos (3 horas) permite o dream
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
**Todos os campos, tipos e padrões estão em [docs/configuration-reference.md](docs/configuration-reference.md)**, incluindo `titleMax` / `autoMigrate` / `homeDir` / `disabledWorkspaces` / `backup` / `delegate`.
|
|
88
|
+
|
|
89
|
+
> ⚠️ **Configure o `promptLang` explicitamente no primeiro uso.** Ele decide o idioma do texto de injeção/reflexão/dream e das descrições das ferramentas, e também influencia o idioma em que o modelo escreve as entradas de memória — as palavras-chave são extraídas no idioma da entrada. O valor **é** o nome do subdiretório em `src/prompts/` e é casado **literalmente**: um nome que não existe (por exemplo `pt`) não gera erro nenhum — ele cai no pacote chinês, em silêncio. Veja [docs/configuration-reference.md](docs/configuration-reference.md).
|
|
90
|
+
|
|
91
|
+
### Idioma da interface
|
|
92
|
+
|
|
93
|
+
O texto da interface do plugin segue o "Configurações → Geral → Idioma" do DSH (embutidos: 中文 / English / Português (Brasil)) e é uma camada separada do `promptLang`; as duas não interferem. Veja [docs/configuration-reference.md](docs/configuration-reference.md).
|
|
94
|
+
|
|
95
|
+
## 🧠 Como funciona
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
Primeira mensagem ............ injeta o bloco de memória de longo prazo
|
|
99
|
+
(prefixo = snapshot .... Sobre você (soul) / Sobre o usuário (user) /
|
|
100
|
+
plugin, prompt do Princípios de design (rules) / Guia de memória
|
|
101
|
+
usuário intocado) (a 1ª rodada NÃO faz acertos por palavra-chave)
|
|
102
|
+
|
|
103
|
+
Da 2ª mensagem em diante ..... "Memórias possivelmente relevantes, apenas para
|
|
104
|
+
referência:" + top-2 acertos por palavra-chave
|
|
105
|
+
(global + ancorado no projeto atual)
|
|
106
|
+
ids já vistos registrados por sessão
|
|
107
|
+
(sessions/<id>.json); sinal de compactação
|
|
108
|
+
libera os vistos
|
|
109
|
+
|
|
110
|
+
Janela ociosa ≥3h ............ dream por janela: 3 rodadas (a 3ª é o resumo de
|
|
111
|
+
e fora do pico projeto) sobre as memórias criadas + extraídas
|
|
112
|
+
nesta janela, congelando por updated_at no
|
|
113
|
+
timestamp da última conversa
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
Os rótulos acima são os do pacote de prompts em português; com `promptLang: 'zh'` eles aparecem em chinês e com `'en'` em inglês (por exemplo `===== LONG-TERM MEMORY =====`, `Possibly relevant memories, for reference only:`).
|
|
117
|
+
|
|
118
|
+
### Ferramentas
|
|
119
|
+
|
|
120
|
+
| Ferramenta | Para que serve |
|
|
121
|
+
|---|---|
|
|
122
|
+
| `memory_remember` | Escreve uma memória (content/project/keywords/importance obrigatórios; deduplica e faz merge) |
|
|
123
|
+
| `memory_search` | Busca por palavra-chave (BM25 × peso de recência; filtros level/project/status/days) |
|
|
124
|
+
| `memory_project` | Devolve o parágrafo de panorama de um projeto (**parâmetro `project` obrigatório**) |
|
|
125
|
+
| `memory_find_similar` | Checagem de duplicatas e conflitos |
|
|
126
|
+
| `memory_read` | Lê os metadados completos de uma entrada pelo id |
|
|
127
|
+
| `memory_update` | Corrige status / importance / goal / keywords |
|
|
128
|
+
| `memory_dream` | Dispara manualmente a consolidação desta janela |
|
|
129
|
+
| `memory_home` | Consulta / troca o diretório global de dados |
|
|
130
|
+
|
|
131
|
+
Há também o comando `/dream`: digite `/dream` no input para consolidar esta janela na hora, sem sofrer a supressão de pico.
|
|
132
|
+
|
|
133
|
+
**Parâmetros, retornos e efeitos colaterais estão em [docs/tool-reference.md](docs/tool-reference.md)** (incluindo o efeito de ancoragem do `memory_project` e os três marcadores de diretório do `memory_home`).
|
|
134
|
+
|
|
135
|
+
## 🛠 Desenvolvimento
|
|
136
|
+
|
|
137
|
+
```sh
|
|
138
|
+
npm install
|
|
139
|
+
npm run build # empacota com esbuild → lib/index.js (peers do host externos)
|
|
140
|
+
npm run test # 228 testes de lógica: db / bm25 / migrate / inject / reflect / dream / tools / apply
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Os pacotes `@deepseek-ai/*` ficam no pnpm workspace do dsh-meow, não no `node_modules` deste pacote.
|
|
144
|
+
No Windows, `npm run link-workspace` (ou `scripts/link-workspace.ps1`) cria os junctions espelhando os
|
|
145
|
+
pacotes do workspace para o esbuild resolvê-los; o `build.mjs` os referencia via `nodePaths`.
|
|
146
|
+
O build não precisa do peer opcional `dsh-llm`. Para executar os testes diretamente
|
|
147
|
+
com Node, vincule `@deepseek-ai/dsh-llm` de um workspace DSH compatível; o loader do
|
|
148
|
+
profile DSH resolve esse peer durante o uso normal. Não o adicione novamente a
|
|
149
|
+
`devDependencies`: instalações `file:` / `link:` podem introduzir outra cópia de
|
|
150
|
+
um pacote central do host no profile (#84).
|
|
151
|
+
|
|
152
|
+
`node tests/build-host-peers.mjs` verifica o build limpo sem peers do host (#87).
|
|
153
|
+
`node tests/host-peers.mjs /path/to/node_modules/@deepseek-ai/dsh` usa uma instalação
|
|
154
|
+
oficial independente do DSH para verificar o carregamento real pelo host e os
|
|
155
|
+
contratos de mensagem em um profile isolado, sem chamadas a modelos.
|
|
156
|
+
|
|
157
|
+
## 📚 Documentação
|
|
158
|
+
|
|
159
|
+
| Para saber sobre | Leia |
|
|
160
|
+
| --- | --- |
|
|
161
|
+
| As sete ferramentas: parâmetros, retornos e efeitos colaterais | [docs/tool-reference.md](docs/tool-reference.md) |
|
|
162
|
+
| Todos os campos de configuração, tipos e padrões | [docs/configuration-reference.md](docs/configuration-reference.md) |
|
|
163
|
+
| Por que foi projetado assim (cache, acertos, dream, armadilhas) | [docs/design-notes.md](docs/design-notes.md) |
|
|
164
|
+
| Falha ao instalar, busca imprecisa, como ler os erros | [docs/troubleshooting.md](docs/troubleshooting.md) |
|
|
165
|
+
| Histórico de versões | [CHANGELOG.md](CHANGELOG.md) |
|
|
166
|
+
| Adicionar um idioma de interface | [src/i18n/README.md](src/i18n/README.md) |
|
|
167
|
+
| Adicionar um pacote de prompts | [src/prompts/README.md](src/prompts/README.md) |
|
|
168
|
+
|
|
169
|
+
## 🙏 Agradecimentos
|
|
170
|
+
|
|
171
|
+
Obrigado a cada contribuidor que faz o meow-memory melhorar:
|
|
172
|
+
|
|
173
|
+
- **[daveycodez](https://github.com/daveycodez)** — pacote de prompts em inglês e tokenização do inglês ([PR #6](https://github.com/Phant0Meow/dsh-meow-memory/pull/6), lançado na v0.22.0)
|
|
174
|
+
- **[chenmzh](https://github.com/chenmzh)** — injeção de memória como mensagem plugin snapshot independente, resolvendo a poluição do título da sessão ([PR #10](https://github.com/Phant0Meow/dsh-meow-memory/pull/10))
|
|
175
|
+
- **[cuddly-guacamole](https://github.com/cuddly-guacamole)** — compatibilidade de Session events entre as duas versões do dsh 0.1.2-alpha.4 ([PR #11](https://github.com/Phant0Meow/dsh-meow-memory/pull/11))
|
|
176
|
+
- **[coutogilson](https://github.com/coutogilson)** — pacote de prompts em português do Brasil (`src/prompts/pt-br/`) e a camada de texto de UI que segue o locale do DSH
|
|
177
|
+
|
|
178
|
+
## 📄 License
|
|
179
|
+
|
|
180
|
+
MIT —— ver [LICENSE](LICENSE).
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# meow-memory bundle patch: inserts this plugin into a profile's layer stack.
|
|
2
|
+
# Applied when a profile lists this bundle (or copied by hand for manual
|
|
3
|
+
# installs). Rows reference the package by name so Node resolution finds the
|
|
4
|
+
# installed code.
|
|
5
|
+
- insert:
|
|
6
|
+
- id: meow-memory
|
|
7
|
+
name: 'meow-memory'
|