dsh-experience 1.0.14 → 1.1.0

package/CHANGELOG.md

@@ -1,6 +1,22 @@
 # Changelog
 
 
+## [1.1.0] — 2026-11-09 — 平台隔离与适用边界
+
+### 新增
+- **平台标签**：`buildCandidate()` 写入 `platform: process.platform`；`platformConflicts()` 在召回与合并两条路径上拦截跨 OS 记录。
+  起因：`& "<node.exe>"` 这类 win32 经验在 darwin 上不成立，却会被当通用知识注入。
+- **README「适用边界」**：写明单用户、单机、按 OS 隔离、需人批准、不替代 AGENTS.md 五条边界。
+- 新增文档徽章改为 GitHub Actions 工作流徽章（不再手写测试数字）。
+
+### 测试
+- T82：捕获的记录带 `platform`；`platformOf` 对无标签记录返回空串。
+- T83：异平台记录 `platformConflicts=true`，同平台与无标签均为 `false`。
+- `selftest 93 pass / 0 fail`、`e2e 23 pass / 0 fail`。
+
+### 兼容
+- 旧记录没有 `platform` 字段，按「与本机兼容」处理，不会被误判为异平台。
+
 ## [1.0.14] — 2026-11-09 — A/B 效率实测记录
 
 ### 记录

package/README.md

@@ -2,7 +2,7 @@
 
 > **带生命周期治理与指纹防伪的 DSH 跨会话自学习插件** —— 同类任务第一次慢，第二次直接用上第一次的经验，但绝不把一次偶然的变通当成真理。
 
-[![tests](https://img.shields.io/badge/tests-114%20passing-brightgreen)](tools/selftest.mjs)
+[![tests](https://github.com/Aatzer0/dsh-experience/actions/workflows/test.yml/badge.svg)](https://github.com/Aatzer0/dsh-experience/actions/workflows/test.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 [![runtime](https://img.shields.io/badge/runtime-DeepSeek%20Harness-purple)](https://github.com/Aatzer0/dsh-experience)
 
@@ -29,6 +29,8 @@ Agent 每次会话都从零开始：读同样的配置文件、踩同样的坑
 | **零性能损耗** | 捕获是 O(≤40 次调用) 的纯字符串运算，实测 `avgCaptureMs: 1`；召回在本地做词覆盖打分，无网络、无向量库 | `experience_debug` |
 | **可观测** | 六层诊断逐层 PASS/FAIL，直接回答「为什么这次没命中」 | `/memory debug` |
 
+- **平台隔离** —— 每条经验记录它是在哪个 OS 上学到的；`win32` 的「PATH 里没有 node」不会被拿到 `darwin` 上当事实用，跨平台既不合并也不召回。
+
 ## 为什么经验必须由你批准
 
 自动捕获的经验只会进入 `candidate` 状态，**永远不会被注入**。只有你执行 `/memory approve <id>` 之后，它才变成 `verified` 并进入召回池。Agent 侧没有任何写入状态的入口——`experience_record` 只能新建候选，`experience_review` 是只读的，「批准」这个动作只存在于 `/memory` 命令里。
@@ -69,7 +71,7 @@ flowchart LR
 ### 方式一：从 npm 安装（推荐）
 
 ```text
-plugin_manager install_bundle target=dsh-experience@1.0.5
+plugin_manager install_bundle target=dsh-experience
 ```
 
 安装后 `plugin_manager list_plugins` 应出现 `dsh-experience` 且 `fiberPhase: active`。
@@ -130,6 +132,16 @@ plugin_manager install_bundle target=link:<PATH-TO-dsh-experience>
 `#error`/`#node`/`#module` 同时命中再加确定性加分。实测同一批失败查询上，正确条目的分数从 0.07 提升到 0.36–0.50，
 并在清理流水账后稳定排第 1。
 
+## 适用边界
+
+这个插件是给**一个人一台机器**的长期协作场景设计的，不是团队共享服务：
+
+- **单用户**：经验库在 `~/.dsh/experience/`，没有账号体系、没有并发写保护、没有服务端。
+- **单机**：网络位置、绝对路径、工具链安装方式都随机器而变；跨机器共享需要你自己想办法（同步文件、或用 `/memory teach` 重建）。
+- **按 OS 隔离**：v1.1 起每条记录带 `platform` 标签，跨平台不合并、不召回。
+- **需要人批准**：自动捕获只到 `candidate`，注入池里永远只有你亲手批过的 `verified`。
+- **不替代 AGENTS.md**：经验是"上次怎么做的"，规则是"必须怎么做"。两者冲突时以规则为准。
+
 ## 已知限制
 
 - 召回仅在每轮第 1 步生效；
@@ -142,7 +154,7 @@ plugin_manager install_bundle target=link:<PATH-TO-dsh-experience>
 
 ```bash
 node tools/selftest.mjs   # 91 pass / 0 fail（纯函数 + 闸门 + 衰减）
-node tools/e2e.mjs        # 19 pass / 0 fail（假 Cordis context 驱动真实 apply()）
+node tools/e2e.mjs        # 23 pass / 0 fail（假 Cordis context 驱动真实 apply()）
 ```
 
 零依赖、零构建步骤：修改 `index.js` / `lib/*.js` 后重载插件即可。贡献流程见 [CONTRIBUTING.md](CONTRIBUTING.md)。

package/index.js

@@ -273,6 +273,7 @@ export function apply(ctx) {
 
   function recallable(experience) {
     if (!experience) return false
+    if (C.platformConflicts(experience)) return false
     if (experience.decay && experience.decay.state === 'dormant' && !D.isPinned(experience)) return false
     if (experience.status === 'verified') return true
     return CONFIG.allowAutoVerified === true && experience.status === 'auto-verified'
@@ -611,10 +612,19 @@ export function apply(ctx) {
         return true
       }
 
+      // The same recipe on another OS is a different recipe.
+      let platformVeto = null
+      const platformBlocked = (existing) => {
+        if (!C.platformConflicts(existing)) return false
+        if (!platformVeto) platformVeto = { id: existing.id, was: C.platformOf(existing), now: process.platform }
+        return true
+      }
+
       let fpBest = null
       for (const existing of store.experiences) {
         if (!mergeable.includes(existing.status)) continue
         if (!sameScope(existing)) continue
+        if (platformBlocked(existing)) continue
         if (intentBlocked(existing)) continue
         if (!C.fingerprintsMatch(existing, draft)) continue
         if (!fpBest) fpBest = existing
@@ -625,6 +635,7 @@ export function apply(ctx) {
         if (!mergeable.includes(existing.status)) continue
         if (!sameScope(existing)) continue
         if (existing.taskType && draft.taskType && existing.taskType !== draft.taskType) continue
+        if (platformBlocked(existing)) continue
         if (intentBlocked(existing)) continue
         const score = scoreExperience(existing, queryTokens, index)
         if (score >= CONFIG.mergeThreshold && (!best || score > best.score)) best = { existing, score }
@@ -675,7 +686,7 @@ export function apply(ctx) {
       noteEvidence(created, trace, 'success', Boolean(draft.fingerprint && draft.fingerprint.green), runSteps)
       outcome.ok = true
       outcome.id = id
-      outcome.reason = `新建 ${id}（scope ${(draft.scope || []).join(',') || '未知'}；指纹 ${((draft.fingerprint && draft.fingerprint.targets) || []).join(',') || '无'}${draft.fingerprint && draft.fingerprint.green ? ' 全绿' : ''}${intentVeto ? `；意图不同（${intentVeto.a} vs ${intentVeto.b}），不并入 ${intentVeto.id}` : ''}${typeVeto ? `；产物类型不同（${typeVeto.kinds[0].join(',') || '无'} vs ${typeVeto.kinds[1].join(',') || '无'}），不并入 ${typeVeto.id}（相似度 ${typeVeto.score}）` : ''}）`
+      outcome.reason = `新建 ${id}（scope ${(draft.scope || []).join(',') || '未知'}；指纹 ${((draft.fingerprint && draft.fingerprint.targets) || []).join(',') || '无'}${draft.fingerprint && draft.fingerprint.green ? ' 全绿' : ''}${platformVeto ? `；平台不同（${platformVeto.was} vs ${platformVeto.now}），不并入 ${platformVeto.id}` : ''}${intentVeto ? `；意图不同（${intentVeto.a} vs ${intentVeto.b}），不并入 ${intentVeto.id}` : ''}${typeVeto ? `；产物类型不同（${typeVeto.kinds[0].join(',') || '无'} vs ${typeVeto.kinds[1].join(',') || '无'}），不并入 ${typeVeto.id}（相似度 ${typeVeto.score}）` : ''}）`
       outcome.ms = Math.round(performance.now() - started)
       persist()
       return outcome

package/lib/capture.js

@@ -659,6 +659,7 @@ export function buildCandidate(trace, info, config) {
 
   const record = {
     status: 'candidate',
+    platform: process.platform,
     // Scope detection needs the raw paths; every rendered field below is normalized.
     scope: mentionedDirs(
       [
@@ -692,6 +693,21 @@ export function buildCandidate(trace, info, config) {
   return record
 }
 
+export function platformOf(record) {
+  const value = record && record.platform
+  return typeof value === 'string' ? value : ''
+}
+
+/**
+ * "PATH has no node, use the bundled node.exe" is a fact on win32 and a lie on
+ * darwin. Unknown platform never vetoes: records written before v1.1 carry no
+ * tag, and every one of them was learned on this machine.
+ */
+export function platformConflicts(record) {
+  const tag = platformOf(record)
+  return Boolean(tag && tag !== process.platform)
+}
+
 export function mergeInto(existing, draft) {
   existing.occurrences = (existing.occurrences || 1) + 1
   existing.lastSeenAt = new Date().toISOString()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-experience",
-  "version": "1.0.14",
+  "version": "1.1.0",
   "private": false,
   "publishConfig": {
     "access": "public"

package/tools/selftest.mjs

@@ -1184,6 +1184,20 @@ test('T81 a run recipe is always titled by its script', () => {
   assert.equal(draft.title, '跑 run')
 })
 
+test('T82 a captured recipe remembers the OS that taught it', () => {
+  const draft = C.buildCandidate({ query: 'add pad', turn: 1 }, { sessionId: 's', cwd: 'D:/work/acme' }, C.DEFAULT_CONFIG)
+  assert.equal(draft.platform, process.platform)
+  assert.equal(C.platformOf({ platform: 'linux' }), 'linux')
+  assert.equal(C.platformOf({}), '')
+})
+
+test('T83 a recipe from another OS is never merged and never recalled', () => {
+  const foreign = { platform: process.platform === 'win32' ? 'linux' : 'win32' }
+  assert.equal(C.platformConflicts(foreign), true)
+  assert.equal(C.platformConflicts({ platform: process.platform }), false)
+  assert.equal(C.platformConflicts({}), false)
+})
+
 // ---------------------------------------------------------------- summary
 
 const total = pass + failures.length