memory-eternal 0.24.0 → 0.25.0

package/lib/star-prompt.js

@@ -0,0 +1,92 @@
+// 记忆核心 · Star 引导：等价值出现再问，而不是装机即求
+//
+// 观察（来自真实数据）：star 主要来自插件内的引导，而不是 README。但「首次打开就求 star」
+// 是在用户还没感受到任何好处时提出请求 —— 转化率低，而且显得功利。
+//
+// 所以这里换成一个**价值触发**的提示：
+//   · 门槛：账本里累计召回 ≥ 8 次，或主库已有 ≥ 15 张卡（说明它确实被用起来了）
+//   · 频次：7 天冷却、最多问 3 次；点「不再提示」永久关闭
+//   · 证据：不空喊「求 star」，而是把已经做过的事摆出来（召回次数 / 沉淀卡数 / 注入字符）
+//
+// 状态放在 config 文件旁边（<config>.star.json），与 vault 数据无关，
+// 删掉 vault 不会重置它；写失败也绝不影响面板。
+import fs from 'node:fs'
+import path from 'node:path'
+import { configFilePath } from './capture-run.js'
+import { ledgerSummary } from './ledger.js'
+import { getDb } from './db.js'
+
+export const ASK_MIN_RECALLS = 8
+export const ASK_MIN_CARDS = 15
+export const ASK_COOLDOWN_MS = 7 * 86400000
+export const ASK_MAX_TIMES = 3
+
+/** 状态文件与 config 同目录，便于用户自己查看/删除。 */
+export function starStateFile(env) {
+  return String(configFilePath(env)).replace(/\.json$/i, '.star.json')
+}
+
+export function readStarState(env) {
+  try {
+    const raw = JSON.parse(fs.readFileSync(starStateFile(env), 'utf8'))
+    return { asks: Number(raw.asks) || 0, lastAskAt: Number(raw.lastAskAt) || 0, dismissed: !!raw.dismissed }
+  } catch {
+    return { asks: 0, lastAskAt: 0, dismissed: false }
+  }
+}
+
+function writeStarState(env, next) {
+  try {
+    const file = starStateFile(env)
+    fs.mkdirSync(path.dirname(file), { recursive: true })
+    fs.writeFileSync(file, JSON.stringify({ ...next, updatedAt: new Date().toISOString() }, null, 1))
+    return true
+  } catch { return false }
+}
+
+/**
+ * 纯函数：是否该弹一次 star 提示。抽出来是为了能单测（时间注入，不依赖真实时钟）。
+ */
+export function shouldAsk({ recalls = 0, cards = 0, state = {}, now = Date.now() } = {}) {
+  if (state.dismissed) return false
+  if (Number(state.asks) >= ASK_MAX_TIMES) return false
+  const last = Number(state.lastAskAt) || 0
+  if (last && now - last < ASK_COOLDOWN_MS) return false
+  return Number(recalls) >= ASK_MIN_RECALLS || Number(cards) >= ASK_MIN_CARDS
+}
+
+/** 面板启动时查询：该不该问 + 用来「讲证据」的数字。 */
+export function starPromptStatus({ root, env, now = Date.now() } = {}) {
+  const state = readStarState(env)
+  let totals = { recalls: 0, captures: 0, injectedChars: 0 }
+  try { totals = ledgerSummary(root, { days: 30, now }).totals } catch { /* 账本坏了不影响提示 */ }
+  let cards = 0
+  try { cards = Number(getDb(root).prepare('SELECT COUNT(*) AS n FROM cards').get().n) || 0 } catch { /* 没库就按 0 算 */ }
+  return {
+    ok: true,
+    shouldAsk: shouldAsk({ recalls: totals.recalls, cards, state, now }),
+    dismissed: !!state.dismissed,
+    asks: Number(state.asks) || 0,
+    nextAskAt: (Number(state.lastAskAt) || 0) + ASK_COOLDOWN_MS,
+    evidence: {
+      recalls: totals.recalls,
+      captures: totals.captures,
+      cards,
+      injectedChars: totals.injectedChars,
+    },
+  }
+}
+
+/**
+ * 记录一次动作：
+ *   shown  → 面板确实展示了（计入一次、开始冷却）
+ *   later  → 用户点了「晚点再说」（开始冷却）
+ *   never  → 永久关闭
+ */
+export function markStarAction(env, action, now = Date.now()) {
+  const state = readStarState(env)
+  const asks = Number(state.asks) || 0
+  if (action === 'never') return writeStarState(env, { ...state, dismissed: true, lastAskAt: now })
+  if (action === 'shown') return writeStarState(env, { ...state, asks: asks + 1, lastAskAt: now })
+  return writeStarState(env, { ...state, lastAskAt: now })
+}

package/orca-plugin/orca-plugin.json

@@ -3,7 +3,7 @@
   "id": "memory-eternal",
   "publisher": "eternalnight996",
   "name": "memory-eternal",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Memory Atlas for Orca: open the local memory vault, pending review and knowledge graph from a sandboxed Orca panel.",
   "author": {
     "name": "EternalNight996",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "记忆核心（Memory Eternal）：自研的 DeepSeek Harness 记忆插件，不移植任何既有记忆框架——对话结束后自动沉淀知识卡到本地 Markdown Vault（自研去重、自研 CJK 检索、可 git 管理），设置页提供图形化知识库（统计 / 搜索 / 知识图谱 + 侧边栏一键弹窗），Agent 通过 memory_recall 工具按需召回历史上下文。零人工干预。",
   "icon": "assets/icon.png",
   "license": "MIT",
@@ -70,7 +70,7 @@
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
     "panel-check": "node scripts/panel-check.mjs",
-    "test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/capture-route.test.mjs && node tests/stall.test.mjs && node tests/vault-path.test.mjs && node tests/vault-resolve.test.mjs && node tests/minhash.test.mjs && node tests/settings-save.test.mjs && node tests/config-coverage.test.mjs && node tests/config-sync.test.mjs && node tests/config-merge.test.mjs && node tests/sse.test.mjs && node tests/api.test.mjs && node tests/import-roundtrip.test.mjs && node tests/graph-perf.test.mjs && node tests/graph-force.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/watchdog-lock.test.mjs && node tests/markdown.test.mjs && node tests/feedback.test.mjs && node tests/graph-lod.test.mjs && node tests/graph-warmup.test.mjs && node tests/loading-hints.test.mjs && node tests/web-entry.test.mjs && node tests/tui-scroll.test.mjs && node tests/tui-audit-scene.test.mjs && node tests/tui-plugin-boot.test.mjs && node tests/capture-session-id.test.mjs && node tests/ssr.test.mjs && node tests/window-controls.test.mjs && node tests/web-assets.test.mjs && node tests/manifests.test.mjs && node tests/two-store.test.mjs && node tests/noise-gate.test.mjs && node tests/e2e-recall.test.mjs && node tests/issue-fixes.test.mjs && node tests/issue-fixes-2.test.mjs && node tests/issue-fixes-3.test.mjs && node tests/watchdog-orphans.test.mjs && node tests/watchdog-restart.test.mjs && node tests/readme-i18n.test.mjs && node tests/issue-fixes-4.test.mjs && node tests/host-drain.test.mjs && node tests/e2e-host-drain.mjs && node tests/issue-fixes-5.test.mjs && node tests/issue-fixes-6.test.mjs && node tests/capture-json-repair.test.mjs && node tests/csrf-origin.test.mjs && node tests/watchdog-orphan-web.test.mjs && node tests/config-validate.test.mjs && node tests/issue-fixes-8.test.mjs && node tests/issue-fixes-9.test.mjs && node tests/release-verify.test.mjs && node tests/refine.test.mjs && node tests/db-restore.test.mjs && node tests/align.test.mjs && node tests/tags-normalize.test.mjs && node tests/resident-state.test.mjs && node tests/llm-route.test.mjs && node tests/host-managed.test.mjs && node tests/replace-claim.test.mjs && node tests/version-check-self.test.mjs && node tests/setup-codex.test.mjs && node tests/listener-netstat.test.mjs && node tests/issue-46-overlay.test.mjs && node tests/graph-initial-zoom.test.mjs && node tests/card-head-actions.test.mjs && node tests/card-reader-ux.test.mjs && node tests/tag-filter.test.mjs && node tests/ui-overflow.test.mjs && node tests/version-card-state.test.mjs && node tests/llm-routes-proxy.test.mjs && node tests/model-strikes.test.mjs && node tests/support-bundle.test.mjs && node tests/health-panel.test.mjs && node tests/issue-48-timeout.test.mjs && node tests/setup-node-path.test.mjs && node tests/capture-kind.test.mjs && node tests/core-memory.test.mjs && node tests/skill-cards.test.mjs && node tests/audit-search.test.mjs && node tests/news.test.mjs && node tests/news-feed.test.mjs && node tests/ledger.test.mjs && node tests/issue-55-timezone.test.mjs && node tests/recycle-center.test.mjs && node tests/news-follows.test.mjs && node tests/news-digest.test.mjs && node tests/search-index.test.mjs"
+    "test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/capture-route.test.mjs && node tests/stall.test.mjs && node tests/vault-path.test.mjs && node tests/vault-resolve.test.mjs && node tests/minhash.test.mjs && node tests/settings-save.test.mjs && node tests/config-coverage.test.mjs && node tests/config-sync.test.mjs && node tests/config-merge.test.mjs && node tests/sse.test.mjs && node tests/api.test.mjs && node tests/import-roundtrip.test.mjs && node tests/graph-perf.test.mjs && node tests/graph-force.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/watchdog-lock.test.mjs && node tests/markdown.test.mjs && node tests/feedback.test.mjs && node tests/graph-lod.test.mjs && node tests/graph-warmup.test.mjs && node tests/loading-hints.test.mjs && node tests/web-entry.test.mjs && node tests/tui-scroll.test.mjs && node tests/tui-audit-scene.test.mjs && node tests/tui-plugin-boot.test.mjs && node tests/capture-session-id.test.mjs && node tests/ssr.test.mjs && node tests/window-controls.test.mjs && node tests/web-assets.test.mjs && node tests/manifests.test.mjs && node tests/two-store.test.mjs && node tests/noise-gate.test.mjs && node tests/e2e-recall.test.mjs && node tests/issue-fixes.test.mjs && node tests/issue-fixes-2.test.mjs && node tests/issue-fixes-3.test.mjs && node tests/watchdog-orphans.test.mjs && node tests/watchdog-restart.test.mjs && node tests/readme-i18n.test.mjs && node tests/issue-fixes-4.test.mjs && node tests/host-drain.test.mjs && node tests/e2e-host-drain.mjs && node tests/issue-fixes-5.test.mjs && node tests/issue-fixes-6.test.mjs && node tests/capture-json-repair.test.mjs && node tests/csrf-origin.test.mjs && node tests/watchdog-orphan-web.test.mjs && node tests/config-validate.test.mjs && node tests/issue-fixes-8.test.mjs && node tests/issue-fixes-9.test.mjs && node tests/release-verify.test.mjs && node tests/refine.test.mjs && node tests/db-restore.test.mjs && node tests/align.test.mjs && node tests/tags-normalize.test.mjs && node tests/resident-state.test.mjs && node tests/llm-route.test.mjs && node tests/host-managed.test.mjs && node tests/replace-claim.test.mjs && node tests/version-check-self.test.mjs && node tests/setup-codex.test.mjs && node tests/listener-netstat.test.mjs && node tests/issue-46-overlay.test.mjs && node tests/graph-initial-zoom.test.mjs && node tests/card-head-actions.test.mjs && node tests/card-reader-ux.test.mjs && node tests/tag-filter.test.mjs && node tests/ui-overflow.test.mjs && node tests/version-card-state.test.mjs && node tests/llm-routes-proxy.test.mjs && node tests/model-strikes.test.mjs && node tests/support-bundle.test.mjs && node tests/health-panel.test.mjs && node tests/issue-48-timeout.test.mjs && node tests/setup-node-path.test.mjs && node tests/capture-kind.test.mjs && node tests/core-memory.test.mjs && node tests/skill-cards.test.mjs && node tests/audit-search.test.mjs && node tests/news.test.mjs && node tests/news-feed.test.mjs && node tests/ledger.test.mjs && node tests/issue-55-timezone.test.mjs && node tests/recycle-center.test.mjs && node tests/news-follows.test.mjs && node tests/news-digest.test.mjs && node tests/search-index.test.mjs && node tests/star-prompt.test.mjs"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"