dsh-mengpo 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LogosFu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,98 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="icon.svg" alt="梦婆·记忆" width="112" height="112" />
+
+# 梦婆·记忆 · dsh-mengpo
+
+**DSH（DeepSeek Harness）本地记忆的可视化管理插件** —— 在「插件」页里查看、编辑、删除、禁用你的全局记忆与每一个项目的记忆。
+
+[![License](https://img.shields.io/badge/license-MIT-6D4BFF.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/dsh-mengpo.svg)](https://www.npmjs.com/package/dsh-mengpo)
+[![Topic](https://img.shields.io/badge/topic-dsh--plugin-6D4BFF.svg)](https://github.com/topics/dsh-plugin)
+
+> 名字取自「**孟婆汤**」谐音：传说喝下便忘，而这个插件反其道而行 —— 把那碗汤端到你面前，让你看清自己攒下了什么、哪些该倒掉。图标就是那只碗：碗内是汤，升起的是记忆。
+
+</div>
+
+---
+
+## 它解决什么问题
+
+DSH 的记忆默认只有「写入」没有「界面」：全局偏好写在 `~/.dsh-beta/AGENTS.md`，每个项目的经验/决策沉淀在 `<项目>/.dsh-project-memory/insights.json`。agent 一直在往里记（`save_lesson` / `remember` / 自动注入），但你**看不到自己攒了什么，也删不掉过时的条目**。梦婆把这个黑盒变成可浏览、可编辑的界面。
+
+## 功能与界面
+
+### 工作区视图：全局记忆 + 项目记忆库总览
+
+一眼看到全局记忆（AGENTS.md）和所有项目记忆库：insight 数、最近更新时间；有目录无数据的标「无记忆文件」，坏 JSON 标「数据损坏」而不拖垮整页。
+
+![工作区视图](docs/screenshots/01-workspace.png)
+
+### 项目视图：按类型分组的 insight 列表
+
+点任意项目进入。insight 按 kind 分组（教训 / 决策 / 流程 / 经验），标注作用域、命中次数；被禁用的条目置灰留存，防止旧坑回潮。
+
+![项目视图](docs/screenshots/02-project.png)
+
+### 详情抽屉：看全文，也能动手
+
+点任意一条 insight，右侧抽屉展示完整元信息（类型 / 范围 / 来源 / 置信度 / 命中次数 / 创建与更新时间）+ pattern / fix / 关联文件 / 触发条件全文。
+
+![详情抽屉](docs/screenshots/03-detail.png)
+
+### 编辑 / 禁用 / 删除
+
+抽屉底部三个操作：**编辑**（标题、类型、范围、pattern、fix、文件、trigger，保存即原子写回）、**禁用/启用**（等价 `draft: true|false`）、**删除**（二次确认，永久移除）。
+
+![编辑](docs/screenshots/04-edit.png)
+
+## 安装
+
+```bash
+# 从 NPM 安装（推荐；应用内「插件中心」一键装）
+dsh plugin --profile <your-profile> add dsh-mengpo
+
+# 或直接从本仓库源码安装
+dsh plugin --profile <your-profile> add github:LogosFu/dsh-mengpo
+```
+
+> 桌面端的 profile 由 Electron 独占管理（CLI 会拒绝写入），请在界面里装：
+> 侧边栏 **插件 → 添加插件 → 安装第三方插件**，填入 `dsh-mengpo`（或 GitHub 地址 / 本地目录）。
+
+装完重启 DSH，进入 **插件** 页 → **内置插件配置** → 点「**梦婆·记忆**」卡片。
+
+## 数据与权限
+
+| 项 | 说明 |
+|---|---|
+| 读取 | `~/.dsh-beta/AGENTS.md`、`~/.dsh-beta/storages/session_projcache/sessions/*.json`（只取 `record.identity.cwd` 用于项目发现）、各项目 `.dsh-project-memory/insights.json` |
+| 写入 | **仅**各项目自己的 `.dsh-project-memory/insights.json`（编辑/删除/禁用时） |
+| 不写入 | `~/.dsh-beta` 下任何文件；不联网；不采集遥测 |
+| 写回策略 | 重读-合并-原子写（tmp + rename，提交前复查 mtime，冲突自动重试最多 3 次），保留 id/createdAt/hitCount/source |
+
+## 兼容性
+
+- 已验证：DSH Desktop **2.0.18-beta.1**（macOS，`desktop` profile）
+- 只用公开插件机制：`plugins.item` 设置卡 slot + 手写 Typert Remote 描述符（**不引入** `@deepseek-ai/*` 运行时依赖，零安装体积负担）
+- Node ≥ 22（宿主 runtime 提供）
+
+## 开发
+
+```bash
+pnpm install
+pnpm build      # lib/index.js（host）、lib/client.js（web）、lib/types/
+pnpm test       # vitest：项目发现、insights 读写、原子写回与 mtime 冲突重试
+pnpm spike      # 模拟 ModuleLoader/cordis 加载构建产物（33 项断言）
+pnpm smoke      # 对真实 ~/.dsh-beta 只读冒烟：项目列表 + insight 计数
+pnpm typecheck
+```
+
+架构与已拍板决策见 [docs/design.md](docs/design.md)。
+
+## 卸载
+
+「插件」页里停用或卸载即可，无后台进程、无残留文件。你的记忆数据不受影响（插件只读写既有 JSON）。
+
+## License
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# 梦婆·记忆 插件 bundle patch：向 profile roster 插入 host 侧插件行。
+# client 半侧由 dsh.client(platform: web) + exports["./client"] 自动编进 Web shell。
+- insert:
+    - id: mengpo
+      name: dsh-mengpo

package/icon.svg

@@ -0,0 +1,34 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <defs>
+    <linearGradient id="bg2" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#6D4BFF"/>
+      <stop offset="1" stop-color="#E040FB"/>
+    </linearGradient>
+    <radialGradient id="glow2" cx="0.22" cy="0.12" r="0.95">
+      <stop offset="0" stop-color="#ffffff" stop-opacity="0.26"/>
+      <stop offset="1" stop-color="#ffffff" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+  <rect width="512" height="512" rx="120" fill="url(#bg2)"/>
+  <rect width="512" height="512" rx="120" fill="url(#glow2)"/>
+  <!-- bowl -->
+  <path d="M138 292 C138 292 152 402 256 402 C360 402 374 292 374 292 Z" fill="#fff"/>
+  <rect x="122" y="274" width="268" height="28" rx="14" fill="#fff"/>
+  <!-- soup surface -->
+  <ellipse cx="256" cy="288" rx="110" ry="20" fill="#B7A5FB"/>
+  <!-- swirl: real spiral in the liquid -->
+  <path d="M256 288
+           C 268 288 276 283 276 277
+           C 276 267 262 262 252 262
+           C 236 262 224 269 224 281
+           C 224 297 244 304 264 304
+           C 296 304 318 293 318 281"
+        fill="none" stroke="#fff" stroke-width="9" stroke-linecap="round" opacity="0.95"/>
+  <!-- steam wisps -->
+  <path d="M226 244 C214 216 236 202 228 176" stroke="#fff" stroke-width="11" fill="none" stroke-linecap="round" opacity="0.9"/>
+  <path d="M290 246 C280 220 300 206 292 180" stroke="#fff" stroke-width="11" fill="none" stroke-linecap="round" opacity="0.9"/>
+  <!-- memory dots -->
+  <circle cx="260" cy="146" r="26" fill="#fff"/>
+  <circle cx="212" cy="164" r="13" fill="#fff"/>
+  <circle cx="312" cy="168" r="12" fill="#fff"/>
+</svg>

package/lib/chunk-S7AJP5TK.js

@@ -0,0 +1,262 @@
+import {
+  EDITABLE_FIELDS
+} from "./chunk-YSAPYWNP.js";
+
+// src/host/scanner.ts
+import { promises as fs } from "fs";
+import { basename, join } from "path";
+import { homedir } from "os";
+import { randomBytes } from "crypto";
+var MengpoError = class extends Error {
+  code;
+  details;
+  isDSHRemoteError = true;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "RemoteError";
+    this.code = code;
+    this.details = details;
+  }
+};
+var MEMORY_DIR = ".dsh-project-memory";
+var INSIGHTS_FILE = "insights.json";
+var MAX_WRITE_ATTEMPTS = 3;
+async function statOrNull(path) {
+  try {
+    return await fs.stat(path);
+  } catch {
+    return null;
+  }
+}
+async function isDirectory(path) {
+  const stat = await statOrNull(path);
+  return stat !== null && stat.isDirectory();
+}
+function parseInsights(text) {
+  const raw = JSON.parse(text);
+  if (raw === null || typeof raw !== "object" || typeof raw.version !== "number" || !Array.isArray(raw.items)) {
+    throw new MengpoError("mengpo/corrupt", "insights.json \u7ED3\u6784\u4E0D\u7B26\uFF1A\u7F3A\u5C11 version \u6216 items \u6570\u7EC4");
+  }
+  return raw;
+}
+async function readInsightsFile(insightsPath) {
+  const stat = await statOrNull(insightsPath);
+  if (stat === null || !stat.isFile()) {
+    throw new MengpoError("mengpo/not-found", `\u8BB0\u5FC6\u6587\u4EF6\u4E0D\u5B58\u5728: ${insightsPath}`, { path: insightsPath });
+  }
+  const text = await fs.readFile(insightsPath, "utf8");
+  try {
+    return { data: parseInsights(text), mtimeMs: stat.mtimeMs };
+  } catch (error) {
+    if (error instanceof MengpoError) throw error;
+    throw new MengpoError("mengpo/corrupt", `insights.json \u89E3\u6790\u5931\u8D25: ${error.message}`, {
+      path: insightsPath
+    });
+  }
+}
+function projectNameOf(projectPath) {
+  const trimmed = projectPath.replace(/[/\\]+$/, "");
+  return basename(trimmed) || trimmed;
+}
+var LocalJsonDataSource = class {
+  home;
+  sessionsDir;
+  fallbackRoots;
+  hooks;
+  /** 同一 insights.json 的写操作串行化（进程内） */
+  writeChains = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    this.home = options.home ?? join(homedir(), ".dsh-beta");
+    this.sessionsDir = options.sessionsDir ?? join(this.home, "storages", "session_projcache", "sessions");
+    this.fallbackRoots = options.fallbackRoots ?? [join(homedir(), "code"), homedir()];
+    this.hooks = options.hooks;
+  }
+  /** D1：distinct session cwd ∩ 存在 .dsh-project-memory；取不到 cwd 时降级目录扫描。 */
+  async discoverProjectPaths() {
+    const cwds = await this.readSessionCwds();
+    if (cwds.length > 0) {
+      const paths2 = await this.filterMemoryDirs(cwds);
+      return { paths: paths2.sort(), discovery: "session-projcache" };
+    }
+    const candidates = [];
+    for (const root of this.fallbackRoots) {
+      candidates.push(root);
+      let entries;
+      try {
+        entries = await fs.readdir(root, { withFileTypes: true });
+      } catch {
+        continue;
+      }
+      for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith(".")) candidates.push(join(root, entry.name));
+      }
+    }
+    const paths = await this.filterMemoryDirs([...new Set(candidates)]);
+    return { paths: paths.sort(), discovery: "fallback-scan" };
+  }
+  /** 读 session 缓存里全部 distinct cwd；目录缺失/文件损坏都按「格式不符」处理。 */
+  async readSessionCwds() {
+    let files;
+    try {
+      files = (await fs.readdir(this.sessionsDir)).filter((name) => name.endsWith(".json"));
+    } catch {
+      return [];
+    }
+    const cwds = /* @__PURE__ */ new Set();
+    for (const name of files) {
+      try {
+        const raw = JSON.parse(await fs.readFile(join(this.sessionsDir, name), "utf8"));
+        const cwd = raw?.record?.identity?.cwd;
+        if (typeof cwd === "string" && cwd.length > 0) cwds.add(cwd);
+      } catch {
+      }
+    }
+    return [...cwds];
+  }
+  async filterMemoryDirs(candidates) {
+    const results = await Promise.all(
+      candidates.map(async (path) => await isDirectory(join(path, MEMORY_DIR)) ? path : null)
+    );
+    return results.filter((path) => path !== null);
+  }
+  async summarize(projectPath) {
+    const base = {
+      path: projectPath,
+      name: projectNameOf(projectPath),
+      status: "ok",
+      insightCount: 0,
+      latestUpdatedAt: null
+    };
+    const insightsPath = join(projectPath, MEMORY_DIR, INSIGHTS_FILE);
+    try {
+      const { data } = await readInsightsFile(insightsPath);
+      base.insightCount = data.items.length;
+      base.latestUpdatedAt = data.items.map((item) => item.updatedAt ?? item.createdAt).filter((value) => typeof value === "string").sort().at(-1) ?? null;
+      return base;
+    } catch (error) {
+      if (error instanceof MengpoError && error.code === "mengpo/corrupt") {
+        return { ...base, status: "corrupt", error: error.message };
+      }
+      if (error instanceof MengpoError && error.code === "mengpo/not-found") {
+        return { ...base, status: "missing" };
+      }
+      return { ...base, status: "corrupt", error: error.message };
+    }
+  }
+  async listProjects(_cwd) {
+    const { paths, discovery } = await this.discoverProjectPaths();
+    const projects = await Promise.all(paths.map((path) => this.summarize(path)));
+    return { projects, generatedAt: (/* @__PURE__ */ new Date()).toISOString(), discovery };
+  }
+  async getGlobal() {
+    const path = join(this.home, "AGENTS.md");
+    try {
+      return { path, content: await fs.readFile(path, "utf8") };
+    } catch {
+      return { path, content: null };
+    }
+  }
+  async getProject(path) {
+    if (!await isDirectory(join(path, MEMORY_DIR))) {
+      throw new MengpoError("mengpo/not-found", `\u9879\u76EE\u6CA1\u6709\u8BB0\u5FC6\u5E93: ${path}`, { path });
+    }
+    const summary = await this.summarize(path);
+    if (summary.status !== "ok") return { ...summary, insights: [] };
+    const { data } = await readInsightsFile(join(path, MEMORY_DIR, INSIGHTS_FILE));
+    return { ...summary, insights: data.items };
+  }
+  async updateInsight(projectPath, insight) {
+    return this.mutate(projectPath, (data) => {
+      const index = data.items.findIndex((item) => item.id === insight.id);
+      if (index < 0) {
+        throw new MengpoError("mengpo/not-found", `insight \u4E0D\u5B58\u5728: ${insight.id}`, { id: insight.id });
+      }
+      const existing = data.items[index];
+      const merged = { ...existing };
+      for (const field of EDITABLE_FIELDS) {
+        if (field in insight) {
+          merged[field] = insight[field];
+        } else {
+          delete merged[field];
+        }
+      }
+      merged.id = existing.id;
+      merged.createdAt = existing.createdAt;
+      merged.hitCount = existing.hitCount;
+      if (existing.source !== void 0) merged.source = existing.source;
+      merged.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      const items = [...data.items];
+      items[index] = merged;
+      return { next: { ...data, items }, value: merged };
+    });
+  }
+  async deleteInsight(projectPath, insightId) {
+    await this.mutate(projectPath, (data) => {
+      const items = data.items.filter((item) => item.id !== insightId);
+      if (items.length === data.items.length) {
+        throw new MengpoError("mengpo/not-found", `insight \u4E0D\u5B58\u5728: ${insightId}`, { id: insightId });
+      }
+      return { next: { ...data, items }, value: void 0 };
+    });
+  }
+  async setInsightDraft(projectPath, insightId, draft) {
+    return this.mutate(projectPath, (data) => {
+      const item = data.items.find((candidate) => candidate.id === insightId);
+      if (item === void 0) {
+        throw new MengpoError("mengpo/not-found", `insight \u4E0D\u5B58\u5728: ${insightId}`, { id: insightId });
+      }
+      const merged = { ...item, draft, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+      return {
+        next: { ...data, items: data.items.map((candidate) => candidate.id === insightId ? merged : candidate) },
+        value: merged
+      };
+    });
+  }
+  /**
+   * D2 写回策略：重读-合并-原子写。
+   * 读 → 合并 → 写 tmp → 提交前重查 mtime，变了则丢弃 tmp 重新合并（最多 3 次）→ rename 覆盖。
+   */
+  mutate(projectPath, mutator) {
+    const insightsPath = join(projectPath, MEMORY_DIR, INSIGHTS_FILE);
+    const previous = this.writeChains.get(insightsPath) ?? Promise.resolve();
+    const run = previous.catch(() => void 0).then(() => this.mutateLocked(insightsPath, mutator));
+    this.writeChains.set(
+      insightsPath,
+      run.catch(() => void 0)
+    );
+    return run;
+  }
+  async mutateLocked(insightsPath, mutator) {
+    let lastConflict = null;
+    for (let attempt = 1; attempt <= MAX_WRITE_ATTEMPTS; attempt++) {
+      const { data, mtimeMs } = await readInsightsFile(insightsPath);
+      const { next, value } = mutator(data);
+      const tmpPath = `${insightsPath}.mengpo-${process.pid}-${randomBytes(6).toString("hex")}.tmp`;
+      await fs.writeFile(tmpPath, JSON.stringify(next), "utf8");
+      try {
+        await this.hooks?.beforeCommit?.(insightsPath, attempt);
+        const current = await statOrNull(insightsPath);
+        if (current === null || current.mtimeMs !== mtimeMs) {
+          lastConflict = new MengpoError("mengpo/conflict", "insights.json \u5728\u5199\u5165\u671F\u95F4\u88AB\u5916\u90E8\u4FEE\u6539\uFF0C\u5DF2\u91CD\u8BD5", {
+            path: insightsPath,
+            attempt
+          });
+          continue;
+        }
+        await fs.rename(tmpPath, insightsPath);
+        return value;
+      } finally {
+        await fs.rm(tmpPath, { force: true }).catch(() => void 0);
+      }
+    }
+    throw lastConflict ?? new MengpoError("mengpo/conflict", `insights.json \u8FDE\u7EED ${MAX_WRITE_ATTEMPTS} \u6B21\u5199\u5165\u51B2\u7A81`, {
+      path: insightsPath
+    });
+  }
+};
+
+export {
+  MengpoError,
+  projectNameOf,
+  LocalJsonDataSource
+};

package/lib/chunk-YSAPYWNP.js

@@ -0,0 +1,15 @@
+// src/host/types.ts
+var EDITABLE_FIELDS = [
+  "title",
+  "kind",
+  "scope",
+  "pattern",
+  "fix",
+  "files",
+  "trigger",
+  "confidence"
+];
+
+export {
+  EDITABLE_FIELDS
+};