memory-eternal 0.2.0 → 0.3.1

package/lib/db.js

@@ -70,9 +70,61 @@ function initTables(db) {
       useful INTEGER NOT NULL DEFAULT 0,
       created_at TEXT DEFAULT (datetime('now'))
     );
+
+    -- 审核日志：记录所有 status 变更，不可篡改
+    CREATE TABLE IF NOT EXISTS audit_log (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      card_path TEXT NOT NULL,
+      old_status TEXT,
+      new_status TEXT NOT NULL,
+      changed_by TEXT DEFAULT 'system',
+      reason TEXT DEFAULT '',
+      created_at TEXT DEFAULT (datetime('now'))
+    );
   `)
 }
 
+/**
+ * 审核守卫：根据 config 表的审核规则决定新卡 status。
+ * 所有写入路径必须经过此函数，杜绝越权。
+ *
+ * 规则：
+ * - config 表无 auditMode 记录 → 用 fallback（调用方传入的 status）
+ * - auditMode = 'none' → approved（全部免审）
+ * - auditMode = 'all' → 检查免审白名单，命中→approved，否则→pending
+ *
+ * @param {string} root - vault 根目录
+ * @param {string} kind - 卡片类型
+ * @param {string} submittedBy - 提交者
+ * @param {string} fallback - 调用方传入的 status（无配置时使用）
+ * @returns {'pending' | 'approved'}
+ */
+export function enforceAudit(root, kind, submittedBy, fallback = 'pending') {
+  const db = getDb(root)
+  const get = (key) => { try { return db.prepare('SELECT value FROM config WHERE key = ?').get(key)?.value } catch { return null } }
+  const mode = get('auditMode')
+  // 无配置 → 用调用方传入的 status
+  if (!mode) return fallback
+  if (mode === 'none') return 'approved'
+  const agentsRaw = get('auditExemptAgents') || '[]'
+  const kindsRaw = get('auditExemptKinds') || '[]'
+  let agents = [], kinds = []
+  try { agents = JSON.parse(agentsRaw) } catch { agents = agentsRaw.split(',').map(s => s.trim()).filter(Boolean) }
+  try { kinds = JSON.parse(kindsRaw) } catch { kinds = kindsRaw.split(',').map(s => s.trim()).filter(Boolean) }
+  if (agents.includes('__all__') || agents.includes(submittedBy)) return 'approved'
+  if (kinds.includes('__all__') || kinds.includes(kind)) return 'approved'
+  return 'pending'
+}
+
+/** 写入审核配置到 config 表（供 index.js 同步 DSH settings）。 */
+export function setAuditConfig(root, { auditMode, auditExemptAgents, auditExemptKinds }) {
+  const db = getDb(root)
+  const upsert = db.prepare(`INSERT INTO config (key, value, updated_at) VALUES (?, ?, datetime('now')) ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at`)
+  if (auditMode !== undefined) upsert.run('auditMode', String(auditMode))
+  if (auditExemptAgents !== undefined) upsert.run('auditExemptAgents', JSON.stringify(auditExemptAgents))
+  if (auditExemptKinds !== undefined) upsert.run('auditExemptKinds', JSON.stringify(auditExemptKinds))
+}
+
 /** 从 .md 文件迁移到 SQLite（幂等：已存在的卡跳过）。 */
 export async function migrateFromMarkdown(root) {
   const db = getDb(root)

package/lib/vault.js

@@ -4,7 +4,7 @@
 // 底层依赖 lib/db.js 的 getDb(root) → DatabaseSync 实例。
 
 import path from 'node:path'
-import { getDb } from './db.js'
+import { getDb, enforceAudit } from './db.js'
 
 /** 主题目录根。 */
 export const KIND_ROOTS = {
@@ -227,29 +227,39 @@ export async function deleteCard(root, rel, { permanent = false } = {}) {
   return { ok: true, soft: true }
 }
 
-/** 恢复软删卡：status=approved，清除 deleted_at。 */
+/** 恢复软删卡：status=approved，清除 deleted_at。写审计日志。 */
 export async function restoreCard(root, rel) {
   const db = getDb(root)
   const now = new Date().toISOString()
+  const existing = db.prepare('SELECT status FROM cards WHERE path = ?').get(rel)
+  if (!existing) throw new Error('卡片不存在: ' + rel)
   const info = db.prepare('UPDATE cards SET status = ?, deleted_at = NULL, updated_at = ? WHERE path = ?').run('approved', now, rel)
   if (info.changes === 0) throw new Error('卡片不存在: ' + rel)
+  db.prepare('INSERT INTO audit_log (card_path, old_status, new_status, changed_by, reason) VALUES (?, ?, ?, ?, ?)').run(rel, existing.status, 'approved', 'restore', '回收站恢复')
   return { ok: true, restored: true }
 }
 
-/** 更新卡状态。 */
-export async function setCardStatus(root, rel, status) {
+/** 更新卡状态（审核操作）。写审计日志，确保可追溯。 */
+export async function setCardStatus(root, rel, status, { changedBy = 'system', reason = '' } = {}) {
   const db = getDb(root)
   const now = new Date().toISOString()
+  const existing = db.prepare('SELECT status FROM cards WHERE path = ?').get(rel)
+  if (!existing) throw new Error('卡片不存在: ' + rel)
   const info = db.prepare('UPDATE cards SET status = ?, updated_at = ? WHERE path = ?').run(status, now, rel)
   if (info.changes === 0) throw new Error('卡片不存在: ' + rel)
+  // 审计日志：记录每次 status 变更
+  db.prepare('INSERT INTO audit_log (card_path, old_status, new_status, changed_by, reason) VALUES (?, ?, ?, ?, ?)').run(rel, existing.status, status, changedBy, reason)
   return { ok: true, status }
 }
 
-/** 原子写卡；先去重，命中返回 {duplicate}。 */
+/** 原子写卡；先去重，命中返回 {duplicate}。审核守卫在数据库层强制。 */
 export async function writeCard(root, { kind, title, tags = [], body, source = '', status = 'pending', submittedBy = '', severity = 'info', reason = '', deletedAt = '' }, { threshold = 0.62, dedup = true } = {}) {
   const db = getDb(root)
   const kindRoot = KIND_ROOTS[kind] || KIND_ROOTS.knowledge
 
+  // 审核守卫：数据库层强制，调用方传的 status 仅作 fallback
+  const enforcedStatus = enforceAudit(root, kind, submittedBy, status)
+
   if (dedup) {
     const hit = await dedupCheck(root, body, threshold)
     if (hit) return { ok: false, duplicate: { ...hit, path: hit.path } }
@@ -275,7 +285,7 @@ export async function writeCard(root, { kind, title, tags = [], body, source = '
     JSON.stringify(tags),
     body.trim(),
     summary,
-    status,
+    enforcedStatus,
     source,
     submittedBy,
     severity,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "记忆核心（Memory Eternal）：自研的 DeepSeek Harness 记忆插件，不移植任何既有记忆框架——对话结束后自动沉淀知识卡到本地 Markdown Vault（自研去重、自研 CJK 检索、可 git 管理），设置页提供图形化知识库（统计 / 搜索 / 知识图谱 + 侧边栏一键弹窗），Agent 通过 memory_recall 工具按需召回历史上下文。零人工干预。",
   "license": "MIT",
   "repository": {