memory-eternal 0.30.4 → 0.31.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memory-eternal",
-  "version": "0.30.4",
+  "version": "0.31.0",
   "description": "记忆核心（Memory Eternal）：对话结束后自动沉淀知识卡到本地记忆库（~/.dsh/memory-vault），支持检索 / 召回 / 审核中心。",
   "author": {
     "name": "EternalNight996",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.30.4",
+  "version": "0.31.0",
   "description": "记忆核心（Memory Eternal）：对话结束后自动沉淀知识卡到本地记忆库（~/.dsh/memory-vault），支持检索 / 召回 / 审核中心。",
   "author": {
     "name": "EternalNight996",

package/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.30.4",
+  "version": "0.31.0",
   "description": "记忆核心（Memory Eternal）：对话结束后自动沉淀知识卡到本地记忆库（~/.dsh/memory-vault），支持检索 / 召回 / 审核中心。",
   "author": {
     "name": "EternalNight996",

package/README.md

@@ -15,7 +15,7 @@
 
 [![GitHub stars](https://img.shields.io/github/stars/EternalNight996/memory-eternal?style=flat)](https://github.com/EternalNight996/memory-eternal/stargazers)
 [![npm](https://img.shields.io/npm/v/memory-eternal)](https://www.npmjs.com/package/memory-eternal)
-[![release](https://img.shields.io/badge/release-v0.30.4-FF7A45)](https://github.com/EternalNight996/memory-eternal/releases)
+[![release](https://img.shields.io/badge/release-v0.31.0-FF7A45)](https://github.com/EternalNight996/memory-eternal/releases)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 **English (default)** · [简体中文](README.zh-CN.md)
@@ -227,6 +227,22 @@ Not everything should be injected into every session. Core memory is the small,
 | **Terminal** | <code>dsh-memory tui</code> — live queue, select-all, batch approve/reject, long-form reader |
 | **Browser** | <code>dsh-memory open</code> → http://127.0.0.1:7999 |
 
+## 🎨 Skins
+
+Five skins, switch in Settings → General → Theme with one click. The choice is saved locally and survives reloads.
+
+<p align="center">
+  <img src="assets/screen/skins-gallery.png" width="900" alt="Five themes: Default, Pop, Light, Resident Evil and Spider-Man" />
+</p>
+
+| Skin | Style |
+| --- | --- |
+| **Default** | Dark base + amber accent, easy on the eyes |
+| **Pop** | Yellow paper, black frames, hard shadows and halftone |
+| **Light** | Warm paper + serif headings for daytime |
+| **Resident Evil** | Umbrella lab, toxic-green scanlines, B.O.W. banner and claw |
+| **Spider-Man** | Red/blue comic, webs, halftone, wide action banner and hanging charm |
+
 ## 📸 Screenshots
 
 <p align="center">

package/README.zh-CN.md

@@ -15,7 +15,7 @@
 
 [![GitHub stars](https://img.shields.io/github/stars/EternalNight996/memory-eternal?style=flat)](https://github.com/EternalNight996/memory-eternal/stargazers)
 [![npm](https://img.shields.io/npm/v/memory-eternal)](https://www.npmjs.com/package/memory-eternal)
-[![release](https://img.shields.io/badge/release-v0.30.4-FF7A45)](https://github.com/EternalNight996/memory-eternal/releases)
+[![release](https://img.shields.io/badge/release-v0.31.0-FF7A45)](https://github.com/EternalNight996/memory-eternal/releases)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 [English (default)](README.md) · **简体中文（镜像）**
@@ -227,6 +227,22 @@ dsh-memory ledger --days 30 --json        # 召回注入 / 沉淀调用 / 有用
 | **终端** | <code>dsh-memory tui</code> —— 实时队列、全选、批量批/驳、长文读卡 |
 | **浏览器** | <code>dsh-memory open</code> → http://127.0.0.1:7999 |
 
+## 🎨 皮肤 / Skins
+
+五套皮肤，设置 → 通用 → 主题皮肤一键切换；选择会本地保存，刷新后保持。
+
+<p align="center">
+  <img src="assets/screen/skins-gallery.png" width="900" alt="五种主题皮肤：默认暗色、波普、明亮、生化危机、蜘蛛侠" />
+</p>
+
+| 皮肤 | 风格 |
+| --- | --- |
+| **默认暗色** | 深色底 + 琥珀强调，长时间阅读不刺眼 |
+| **波普 Pop** | 黄底黑框、硬阴影、半调与粗黑标题 |
+| **明亮 Light** | 暖纸面 + 衬线标题，适合白天 |
+| **生化危机** | Umbrella 实验室、毒绿扫描线、B.O.W. 头图与巨爪 |
+| **蜘蛛侠** | 红蓝漫画、蛛网、半调、横版动作头图与悬吊挂件 |
+
 ## 📸 截图
 
 <p align="center">

package/cursor-extension/package.json

@@ -2,7 +2,7 @@
   "name": "memory-eternal",
   "displayName": "Memory Atlas",
   "description": "Memory-eternal: open the local Memory Atlas library, review queue and knowledge graph in a Cursor/VS Code webview.",
-  "version": "0.30.4",
+  "version": "0.31.0",
   "publisher": "EternalNight996",
   "license": "MIT",
   "repository": {

package/dsh-tui-plugin/dsh-plugin.json

@@ -2,7 +2,7 @@
   "$schema": "urn:dsh-std:community-draft:dsh-plugin:0.15",
   "id": "memory-eternal-tui",
   "name": "memory-eternal-tui",
-  "version": "0.30.4",
+  "version": "0.31.0",
   "manifestVersion": "0.15",
   "description": "Open Memory Atlas from dsh-TUI: native /audit scene plus browser launcher.",
   "facets": {

package/dsh-tui-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal-tui",
-  "version": "0.30.4",
+  "version": "0.31.0",
   "description": "Memory Atlas for dsh-TUI: /audit scene with reason/severity, batch confirmation and reject reasons.",
   "type": "module",
   "main": "main.js",

package/index.js

@@ -73,6 +73,8 @@ export const Config = z.object({
   skillCardsAutoSync: z.boolean().default(true),
   // 记忆界面整体布局大小：compact / normal / large（只影响 UI，不影响召回）
   uiScale: z.union([z.const('compact'), z.const('normal'), z.const('large')]).default('normal'),
+  // 主题皮肤：一键切换整个记忆界面（含设置页）。新增皮肤时在这里登记 id，并在 src/client 的 CSS 里加 [data-skin="id"] 块。
+  theme: z.union([z.const('default'), z.const('pop'), z.const('light'), z.const('resident'), z.const('spider')]).default('default'),
   vaultDir: z.string().default(''),
   dedupThreshold: z.number().min(0).max(1).default(0.62),
   captureMinChars: z.number().default(200),
@@ -213,6 +215,21 @@ export function describeDistillFailure(primary, all = []) {
   return `${head}（另有 ${rest.length} 个兜底候选失败：${summary}）`
 }
 
+/** 蒸馏失败里属于「凭证/鉴权」的判定（issue #59：AUTH 失败时只报“蒸馏失败”，用户不知道要换 Key）。 */
+export function isAuthFailure(failure) {
+  const text = `${(failure && failure.code) || ''} ${(failure && failure.message) || ''}`
+  return /AUTH|401|403|invalid[ _-]?(api[ _-]?key|token)|unauthori[sz]ed|authentication/i.test(text)
+}
+
+/** 把蒸馏失败翻成用户能直接照做的提示：凭证类失败给出续命路径，其余保持原样。 */
+export function humanizeDistillFailure(failure) {
+  const base = `蒸馏失败（${failure && failure.provider ? failure.provider + '：' : ''}${(failure && failure.code) || ''} ${(failure && failure.message) || ''}`
+  if (!isAuthFailure(failure)) return base
+  return base +
+    ' —— 这是凭证/鉴权失败：请在「设置→记忆→高级」更新该 provider 的 API Key，' +
+    '或改用其它蒸馏模型，或关闭「蒸馏知识卡」只存原文卡（内容不会丢）'
+}
+
 const API_PREFIX = '/memory-eternal/api'
 
 // DSH 宿主自动沉淀卡的署名：用可读名而非 agent 会话 id，便于在智能体筛选中归组。
@@ -879,7 +896,7 @@ export function apply(ctx, config) {
         })
       } catch { /* 账本失败不影响沉淀主流程 */ }
       // 真失败要亮红并进提示段：此前只有笼统的「蒸馏无输出」，真实原因（如缺凭证）完全不可见。
-      if (failure) { health.fail(`蒸馏失败（${failure.provider}）：${failure.code} ${failure.message}`); touchPrompt() }
+      if (failure) { health.fail(humanizeDistillFailure(failure)); touchPrompt() }
       // 主因 + 兜底候选失败汇总：卡片 reason 与 created 日志都用这个，避免把排查者引向错误方向。
       const why = failure ? describeDistillFailure(failure, failures) : '无可用产出'
       if (!result) {
@@ -1033,7 +1050,7 @@ export function apply(ctx, config) {
         '',
         '⚠ 自动沉淀异常（记忆核心 memory-eternal）——' + h.reason,
         '（发生时间：' + new Date(h.since).toLocaleString() + '。请在回复第一句提醒用户：自动沉淀异常 + 上述原因；'
-          + '并可提示用户打开 设置→记忆→用量/今日 查看「自动沉淀日志」；若原因是接口/版本不匹配，需更新 memory-eternal 插件。）',
+          + '并可提示用户打开 设置→记忆→用量/今日 查看「自动沉淀日志」；若原因含 AUTH/401 等鉴权失败，请更新对应 provider 的 Key 或换模型；若明确是接口/版本不匹配，再更新 memory-eternal 插件。）',
       ].join('\n')
       disposeSection = ctx.systemPrompt.section({
         name: 'memory-eternal: auto-recall',
@@ -1539,7 +1556,7 @@ export function apply(ctx, config) {
               const cfg = settings.get() ?? {}
               // 只暴露可安全展示/回填的字段
               const safe = {
-                autoCapture: cfg.autoCapture, autoRecall: cfg.autoRecall, coreMemoryEnabled: cfg.coreMemoryEnabled, workingMemoryEnabled: cfg.workingMemoryEnabled, coreMemoryLimit: cfg.coreMemoryLimit, coreMemoryMaxChars: cfg.coreMemoryMaxChars, uiScale: cfg.uiScale, recallLimit: cfg.recallLimit, recallSummaryLen: cfg.recallSummaryLen, recallIncludeBody: cfg.recallIncludeBody, secretHint: cfg.secretHint || '',
+                autoCapture: cfg.autoCapture, autoRecall: cfg.autoRecall, coreMemoryEnabled: cfg.coreMemoryEnabled, workingMemoryEnabled: cfg.workingMemoryEnabled, coreMemoryLimit: cfg.coreMemoryLimit, coreMemoryMaxChars: cfg.coreMemoryMaxChars, uiScale: cfg.uiScale, theme: cfg.theme, recallLimit: cfg.recallLimit, recallSummaryLen: cfg.recallSummaryLen, recallIncludeBody: cfg.recallIncludeBody, secretHint: cfg.secretHint || '',
                 captureMinChars: cfg.captureMinChars, captureCooldownMs: cfg.captureCooldownMs, dedupThreshold: cfg.dedupThreshold, maxCardsPerDay: cfg.maxCardsPerDay,
                 distillEnabled: cfg.distillEnabled, dedupByLLM: cfg.dedupByLLM, captureMaxTokens: cfg.captureMaxTokens, recallMinScore: cfg.recallMinScore,
                 autoWeb: cfg.autoWeb, autoWebMode: cfg.autoWebMode, webPort: cfg.webPort, webCheckIntervalMs: cfg.webCheckIntervalMs, webMaxRestart: cfg.webMaxRestart, watchdogAutoSpawn: cfg.watchdogAutoSpawn, autoRestartOnDrift: cfg.autoRestartOnDrift, autoMcpSetup: cfg.autoMcpSetup,

package/lib/api.js

@@ -1429,7 +1429,7 @@ export function createApi(deps = {}) {
         const cfg = getSettings() ?? {}
         const env = typeof process !== 'undefined' ? process.env : {}
         const safe = {
-          autoCapture: cfg.autoCapture ?? true, autoRecall: cfg.autoRecall ?? true, coreMemoryEnabled: cfg.coreMemoryEnabled ?? true, workingMemoryEnabled: cfg.workingMemoryEnabled ?? true, coreMemoryLimit: cfg.coreMemoryLimit ?? 6, coreMemoryMaxChars: cfg.coreMemoryMaxChars ?? 2000, uiScale: cfg.uiScale || 'normal', recallLimit: cfg.recallLimit ?? 5, recallSummaryLen: cfg.recallSummaryLen ?? 130, recallIncludeBody: cfg.recallIncludeBody ?? false, secretHint: cfg.secretHint || '',
+          autoCapture: cfg.autoCapture ?? true, autoRecall: cfg.autoRecall ?? true, coreMemoryEnabled: cfg.coreMemoryEnabled ?? true, workingMemoryEnabled: cfg.workingMemoryEnabled ?? true, coreMemoryLimit: cfg.coreMemoryLimit ?? 6, coreMemoryMaxChars: cfg.coreMemoryMaxChars ?? 2000, uiScale: cfg.uiScale || 'normal', theme: cfg.theme || 'default', recallLimit: cfg.recallLimit ?? 5, recallSummaryLen: cfg.recallSummaryLen ?? 130, recallIncludeBody: cfg.recallIncludeBody ?? false, secretHint: cfg.secretHint || '',
           captureMinChars: cfg.captureMinChars ?? 200, captureCooldownMs: cfg.captureCooldownMs ?? 300000, dedupThreshold: cfg.dedupThreshold ?? 0.62, maxCardsPerDay: cfg.maxCardsPerDay ?? 60,
           distillEnabled: cfg.distillEnabled ?? true, dedupByLLM: cfg.dedupByLLM ?? true, captureMaxTokens: cfg.captureMaxTokens ?? DEFAULT_CAPTURE_MAX_TOKENS, recallMinScore: cfg.recallMinScore ?? 2,
           autoWeb: cfg.autoWeb ?? env.MEMORY_AUTO_WEB !== '0', autoWebMode: cfg.autoWebMode || 'init', webPort: Number(cfg.webPort) || Number(env.MEMORY_WEB_PORT) || 7999, webCheckIntervalMs: Number(cfg.webCheckIntervalMs) || 5000, webMaxRestart: Number(cfg.webMaxRestart) || 10, watchdogAutoSpawn: cfg.watchdogAutoSpawn ?? env.MEMORY_WATCHDOG === '1', autoRestartOnDrift: cfg.autoRestartOnDrift ?? true, autoMcpSetup: cfg.autoMcpSetup ?? false,