Skip to content

Commit 07c8938

Browse files
committed
Merge main into the distill diagnostics branch (both changelog entries kept)
2 parents 9594a31 + ca77c4b commit 07c8938

74 files changed

Lines changed: 15458 additions & 177 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎AGENTS.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ dsh-mneme 是 DSH 宿主的记忆插件(蒸馏 / 注入 / 检索 / 巩固 / sc
2828
- `lib/` 是 sync 产物(见上):各自树内同步,`npm run sync` **只在准备提交前跑一次**,别当保存键用;
2929
- 共享资源同一时刻只有一个写入者:`npm install`、`npm publish`(且只在 `dsh-mneme/` 内执行;发布走 GitHub Actions 的 release.yml,不在本机跑)、插件 relink——**被 link 的那棵树才是「活」的**;
3030
- 不 `amend` / force-push 别人的提交,不把别人未提交的改动 `stash` 走;
31-
- **提交不得有 AI 署名**,且**任何 `Co-Authored-By` trailer 都不许**(不管它指向人、bot 还是 AI 工具),也不许 "Generated with" 之类的工具署名。规则自 2026-09-19 生效,此前的历史提交不追溯、不改写——见 [CONTRIBUTING](CONTRIBUTING.md);
31+
- **提交不得有 AI 署名**,且**任何 `Co-Authored-By` trailer 都不许**(不管它指向人、bot 还是 AI 工具),也不许 "Generated with" 之类的工具署名。规则自 2026-09-19 生效,此前的历史提交不追溯、不改写。**唯一例外是 GitHub squash 合并自己生成的那一行**——它不是任何人写的、贡献者也拦不住,在 PR 里说明即可;压掉真实共同作者的名字仍属违规。见 [CONTRIBUTING](CONTRIBUTING.md) 与 [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) 第 1 节;
3232
- **本机私有信息不进公开文件**:车道分配、端口占用、记忆库路径这类只对某台机器成立的东西,放不进库的本地板(`.worktrees/coordination.md`)或 `.git/info/exclude`;本文件只放对所有人都成立的纪律(定位见开头:薄入口);
3333
- 两个宿主都加载本插件时:`memoryDir` 可共用(`src/store.js` 的 `busy_timeout` + WAL 已为多进程就绪),但 `externalApiEnabled`(默认端口 8790)与 `autoDream` 后台任务**只能一边开**,否则 EADDRINUSE + 重复做梦(镜像/审计双写)。独立服务(`dsh-mneme-serve`)同理:与 DSH 外部访问抢同一端口、**二选一**;它第一期无 LLM,巩固结构性只在宿主侧,不构成第二个做梦者。
3434

@@ -46,6 +46,8 @@ dsh-mneme 是 DSH 宿主的记忆插件(蒸馏 / 注入 / 检索 / 巩固 / sc
4646
| 整理与画像草稿 | `src/organize.js` + `src/profile-extract.js` | agent 主动整理(dryRun 比对报告 → agent 判断 → apply)与从记忆提取画像草稿(只回草稿,绝不写 `user_settings`)。整理里有两种「不要它」,别混:**`discard`** = 这条候选不写,任何东西都不动(只进回执);**`archive`** = 把报告标为被取代的那条既有行归档——可恢复,绝不物理删除。两个入口都 opt-in 默认关(`organizeEnabled` / `profileExtractEnabled`) |
4747
| 蒸馏 | `src/summarize.js` + `src/quality-filter.js` | 会话 → 记忆;质量打分与处置(归档/降权) |
4848
| 巩固与睡眠 | `src/dream.js` + `src/dream/{decisions,clustering,sleep}.js` | LLM 巩固决策、dream_runs 审计回执 |
49+
| 外来行判据 | `src/memory-source.js` | 「本库不巩固别人导入的原文」这条契约的唯一实现(`isImportedRow`),挂在 saveWithDedupe 汇流口与巩固/睡眠/整理的九个行池上([docs/SHARE.md](dsh-mneme/docs/SHARE.md)) |
50+
| 分享包(出与收) | `src/share.js` + `src/share-http.js` + `src/share-import.js` | 出包口径与入包闸门(`buildSharePack` / `validateSharePack`,一条不合格整包拒)、两张皮共用的解析与答复(`shareReply` / `receiveReply` / `undoReply` 各只有一份——**「两张皮只许剩鉴权与路径不同」这条纪律归 `share-http.js`**,它同时承诺「这一层从不抛」)、收侧入库与整包退出(一个事务、按 `share_external_id` 幂等、物删不归档)。面板三件(分享弹层 / 接收弹层 / 外来区筛选与整包退出)在 `lib/client.js`,出包口径、入包闸门、错误码→状态全在那里读、不在那里复述;唯一的例外是外来说的那个字面量 `"imported"`(独立 bundle 不能 `import src/memory-source.js`),它由 `test/client-share.test.js` 的跨文件镜像锁钉回 `IMPORTED_SOURCE` 那一份 |
4951
| 实体 | `src/entities/extractor.js`(存储侧在 store 三表) | 写入时 LLM 抽取实体/属性/关系 |
5052
| 检索辅助 | `src/search/{bm25,adaptive}.js`、`src/vector-index.js`、`src/embedding.js`、`src/local-embedder.js`、`src/reranker.js` | BM25 / 自适应阈值 / 向量索引 / 嵌入 / 重排 |
5153
| 热度 | `src/heat.js` | 纯函数遗忘曲线(opt-in) |

0 commit comments

Comments
 (0)