dsh-selfnote 0.13.2 → 0.14.0

package/lib/store.js

@@ -21,6 +21,49 @@ export const DEFAULT_MAX_ENTRIES = 40
 /** 单条自述的硬上限，防止一次写入撑爆。 */
 export const MAX_ENTRY_CHARS = 600
 
+/**
+ * 自述分三型。混在一起装的时候，人格和「今晚推个提醒」抢同一份预算，
+ * 抢输的永远是人味那一条 —— 所以分开排：
+ *   core   核心身份（人格、长期身份、基本原则），先装，独立配额
+ *   stable 稳定偏好（语言、表达习惯、工作偏好），按 pin → 时间
+ *   temp   临时自述（当前阶段的目标、近期变化），最后装，时间倒序
+ */
+export const NOTE_TIERS = ['core', 'stable', 'temp']
+/** 类型在 notes.md 里写成中文：人打开文件看得懂、改得动，不用查代码。 */
+export const TIER_TAG = { core: '核心', stable: '稳定', temp: '临时' }
+const TAG_TO_TIER = { 核心: 'core', 稳定: 'stable', 临时: 'temp' }
+/** 没打标记的按「稳定」算：存量条目零迁移，行为跟改版前一模一样。 */
+export const DEFAULT_TIER = 'stable'
+
+/**
+ * 临时自述的保质期（天）。过了就不再每回合自动在场 —— 只留在库里，等人自己翻，
+ * 这样「这周在弄什么」不会一直跟人格抢预算。核心与稳定型永不到期。
+ */
+export const DEFAULT_TEMP_TTL_DAYS = 14
+
+/**
+ * 一条自述到期没有。
+ * date 只有「年月日」（没有时刻），按当天零点算；正好第 N 天还在保质期内，
+ * 免得写出「今天刚写、明天就过期」这种一日游。
+ */
+export function isExpiredNote(entry, ttlDays = DEFAULT_TEMP_TTL_DAYS, now = Date.now()) {
+  if (normalizeTier(entry?.tier) !== 'temp') return false
+  const raw = typeof entry?.date === 'string' ? entry.date.trim() : ''
+  const at = Date.parse(`${raw}T00:00:00`)
+  if (!Number.isFinite(at)) return false
+  const days = Number.isFinite(Number(ttlDays)) ? Math.max(1, Math.round(Number(ttlDays))) : DEFAULT_TEMP_TTL_DAYS
+  return now - at > days * 86400000
+}
+
+/** 把外部传进来的 tier 收成合法值，认不出就是默认型（不抛错 —— 别为了个标记把写自述弄失败）。 */
+export function normalizeTier(value) {
+  if (typeof value !== 'string') return DEFAULT_TIER
+  const raw = value.trim().toLowerCase()
+  if (NOTE_TIERS.includes(raw)) return raw
+  // 也认中文写法，方便人直接对着接口手搓
+  return TAG_TO_TIER[raw] ?? TAG_TO_TIER[value.trim()] ?? DEFAULT_TIER
+}
+
 function dshHome() {
   const fromEnv = typeof process.env.DSH_HOME === 'string' ? process.env.DSH_HOME.trim() : ''
   return fromEnv.length > 0 ? fromEnv : join(homedir(), '.dsh')
@@ -49,17 +92,38 @@ export function today() {
   return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`
 }
 
-/** 把 notes.md 解析成 [{ date, text }]，忽略空行与注释。 */
+/** 正文归一：回车换行压成空格、去掉首尾空白、截到硬上限。 */
+function cleanEntryText(text) {
+  return String(text ?? '').replace(/\s+/g, ' ').trim().slice(0, MAX_ENTRY_CHARS)
+}
+
+/**
+ * 把 notes.md 解析成 [{ date, text, tier, pin }]，忽略空行与注释。
+ * 行格式：`- 2026-11-04 [核心*] 正文` —— 日期可省、标记可省、`*` 表示 pin。
+ * 标记认不出就原样留在正文里：宁可多显示一个怪括号，也不能吞掉人写的内容。
+ */
 export function parseNotes(raw) {
   const out = []
   for (const line of String(raw ?? '').split(/\r?\n/)) {
     const trimmed = line.trim()
     if (trimmed === '' || trimmed.startsWith('#')) continue
-    const m = trimmed.match(/^[-*]\s+(\d{4}-\d{2}-\d{2})?\s*(.*)$/)
+    const m = trimmed.match(/^[-*]\s+(\d{4}-\d{2}-\d{2})?\s*(?:\[([^\]]{1,8})\]\s*)?(.*)$/)
     if (!m) continue
-    const text = (m[2] ?? '').trim()
+    let text = (m[3] ?? '').trim()
+    let tier = DEFAULT_TIER
+    let pin = false
+    const tag = (m[2] ?? '').trim()
+    if (tag !== '') {
+      const hit = tag.match(/^(核心|稳定|临时)\s*(\*)?$/)
+      if (hit) {
+        tier = TAG_TO_TIER[hit[1]]
+        pin = hit[2] === '*'
+      } else {
+        text = `[${tag}] ${text}`.trim()
+      }
+    }
     if (text === '') continue
-    out.push({ date: m[1] ?? '', text })
+    out.push({ date: m[1] ?? '', text, tier, pin })
   }
   return out
 }
@@ -71,9 +135,20 @@ export function readNotes() {
   return parseNotes(readFileSync(file, 'utf8'))
 }
 
+/**
+ * 标记只在「非默认」时才写出来：稳定型且没 pin 的条目不带前缀，
+ * 存量 notes.md 不会因为升级平白多出一堆 `[稳定]`。
+ */
+function tagOf(entry) {
+  const tier = normalizeTier(entry?.tier)
+  const pin = entry?.pin === true
+  if (tier === DEFAULT_TIER && !pin) return ''
+  return `[${TIER_TAG[tier]}${pin ? '*' : ''}] `
+}
+
 /** 渲染成注入/展示用的文本（最新在后）。 */
 export function renderNotes(entries) {
-  return entries.map((entry) => `- ${entry.date ? `${entry.date} ` : ''}${entry.text}`).join('\n')
+  return entries.map((entry) => `- ${entry.date ? `${entry.date} ` : ''}${tagOf(entry)}${entry.text}`).join('\n')
 }
 
 /** 写回当前生效的自述（整份重写，内容不超过上限）。 */
@@ -114,18 +189,19 @@ export function archive(entries) {
 }
 
 /** 追加一条自述并裁剪归档。返回 { kept, archived, notesFile }。 */
-export function appendNote(text, limits) {
-  const clean = String(text ?? '').replace(/\s+/g, ' ').trim().slice(0, MAX_ENTRY_CHARS)
+export function appendNote(text, limits, meta = {}) {
+  const clean = cleanEntryText(text)
   if (clean === '') throw new Error('自述内容不能为空')
   const entries = readNotes()
-  entries.push({ date: today(), text: clean })
+  const entry = { date: today(), text: clean, tier: normalizeTier(meta.tier), pin: meta.pin === true }
+  entries.push(entry)
   const { kept, overflow } = trim(entries, limits)
   // 先归档、再改 notes.md：反过来的话，归档一抛错（磁盘满、被占用），
   // 被挤出预算的那几条既已从 notes.md 消失、又没进归档，等于静默丢掉。
   // 万一 notes.md 写失败，最坏是归档里有重复，还能人工删 —— 丢内容没法补。
   const archivedFile = archive(overflow)
   writeNotes(kept)
-  return { kept: kept.length, archived: overflow.length, archivedFile, notesFile: notesPath() }
+  return { kept: kept.length, archived: overflow.length, archivedFile, notesFile: notesPath(), tier: entry.tier, pin: entry.pin }
 }
 
 /**
@@ -133,21 +209,53 @@ export function appendNote(text, limits) {
  * 日期保留原样：改的是措辞，不是「今天又写了一条」。
  * 改长了照样按容量裁剪，被挤出去的进归档 —— 和追加走同一条规则。
  */
-export function updateNote(index, text, limits) {
+export function updateNote(index, text, limits, meta = {}) {
   const entries = readNotes()
   const at = Number(index)
   if (!Number.isInteger(at) || at < 0 || at >= entries.length) {
     // 列表可能是几秒前拉的：给一句能照着做的话，而不是「非法参数」
     throw new Error('没有这一条了（可能刚被改过），刷新一下再试')
   }
-  const clean = String(text ?? '').replace(/\s+/g, ' ').trim().slice(0, MAX_ENTRY_CHARS)
+  const clean = cleanEntryText(text)
   if (clean === '') throw new Error('自述内容不能为空')
-  if (clean === entries[at].text) return { kept: entries.length, archived: 0, unchanged: true, notesFile: notesPath() }
-  entries[at] = { date: entries[at].date || today(), text: clean }
+  const prev = entries[at]
+  const next = {
+    date: prev.date || today(),
+    text: clean,
+    // meta 没传 = 保留原来那个型，别偷偷把一条核心身份降级成临时
+    tier: meta.tier === undefined ? normalizeTier(prev.tier) : normalizeTier(meta.tier),
+    pin: meta.pin === undefined ? prev.pin === true : meta.pin === true,
+  }
+  if (next.text === prev.text && next.tier === normalizeTier(prev.tier) && next.pin === (prev.pin === true)) {
+    return { kept: entries.length, archived: 0, unchanged: true, notesFile: notesPath() }
+  }
+  entries[at] = next
   const { kept, overflow } = trim(entries, limits)
   const archivedFile = archive(overflow)
   writeNotes(kept)
-  return { kept: kept.length, archived: overflow.length, archivedFile, unchanged: false, notesFile: notesPath() }
+  return { kept: kept.length, archived: overflow.length, archivedFile, unchanged: false, notesFile: notesPath(), tier: next.tier, pin: next.pin }
+}
+
+/**
+ * 只改一条的类型 / pin，不动正文。设置页上「把这条设成核心身份」就是这个接口。
+ * 不走 trim：标记只多几个字，为这点长度把一条旧自述挤进归档不值当。
+ */
+export function setNoteMeta(index, meta = {}) {
+  const entries = readNotes()
+  const at = Number(index)
+  if (!Number.isInteger(at) || at < 0 || at >= entries.length) {
+    throw new Error('没有这一条了（可能刚被改过），刷新一下再试')
+  }
+  const prev = entries[at]
+  const next = {
+    date: prev.date,
+    text: prev.text,
+    tier: meta.tier === undefined ? normalizeTier(prev.tier) : normalizeTier(meta.tier),
+    pin: meta.pin === undefined ? prev.pin === true : meta.pin === true,
+  }
+  entries[at] = next
+  writeNotes(entries)
+  return { kept: entries.length, tier: next.tier, pin: next.pin, notesFile: notesPath() }
 }
 
 /** 删一条：先归档再摘除，删掉的东西仍然找得回来（archive/YYYY-MM.md）。 */
@@ -163,6 +271,13 @@ export function deleteNote(index) {
   return { kept: entries.length, removed: dropped, archivedFile, notesFile: notesPath() }
 }
 
+/** 三型各几条。 */
+export function countTiers(entries) {
+  const out = { core: 0, stable: 0, temp: 0 }
+  for (const entry of entries) out[normalizeTier(entry.tier)] += 1
+  return out
+}
+
 /** 统计：生效条数、字符数、归档文件数。 */
 export function stats() {
   const entries = readNotes()
@@ -176,6 +291,9 @@ export function stats() {
   return {
     entries: entries.length,
     chars: renderNotes(entries).length,
+    // 三型各几条：设置页要能解释「为什么我这条没进上下文」
+    tiers: countTiers(entries),
+    pinned: entries.filter((entry) => entry.pin === true).length,
     archiveFiles,
     notesFile: notesPath(),
     // 上次真正写进 notes.md 的时刻：条目里只存日期（YYYY-MM-DD），看不出「几小时前」，

package/lib/transfer.js

@@ -9,7 +9,7 @@
  * 索引不导出：它记的是磁盘路径与 mtime，搬过去必然过期，导入后重建一次就行。
  */
 
-export const BUNDLE_VERSION = 1
+export const BUNDLE_VERSION = 2
 export const BUNDLE_APP = 'dsh-selfnote'
 
 const CONFIG_FIELDS = [
@@ -22,6 +22,10 @@ const CONFIG_FIELDS = [
   'profileMaxChars',
   'halfLifeDays',
   'noteGuide',
+  // v2 加的两个：人格开关与临时自述保质期。它们决定「搬过去之后样子一样不一样」，
+  // 不带的话，同一份导出在另一台机器上会长得不一样
+  'personaEnabled',
+  'tempTtlDays',
 ]
 
 function isObject(value) {
@@ -32,8 +36,16 @@ function textOf(value) {
   return typeof value === 'string' ? value.trim() : ''
 }
 
+/** 人格三段：只有非空的才算「带了人格」，全空等同于没带。 */
+function normalizePersona(value) {
+  if (!isObject(value)) return null
+  const out = { l0: textOf(value.l0), l1: textOf(value.l1), l2: textOf(value.l2) }
+  if (out.l0 === '' && out.l1 === '' && out.l2 === '') return null
+  return out
+}
+
 /** 导出：只挑能带走的东西，配置只挑用户可调的那几项。 */
-export function buildBundle({ notes = [], facts = [], habits = [], config = {}, now = new Date() } = {}) {
+export function buildBundle({ notes = [], facts = [], habits = [], config = {}, persona = null, now = new Date() } = {}) {
   const safeConfig = {}
   for (const field of CONFIG_FIELDS) {
     if (config[field] !== undefined) safeConfig[field] = config[field]
@@ -46,6 +58,8 @@ export function buildBundle({ notes = [], facts = [], habits = [], config = {},
     notes: notes.map((entry) => ({ date: entry.date ?? '', text: entry.text ?? '' })),
     facts: facts.map((fact) => ({ ...fact })),
     habits: habits.map((habit) => ({ ...habit })),
+    // 人格跟着走（v2）；纠偏候选不跟 —— 它是「这台机器上攒下的证据」，搬过去就失了上下文
+    persona: normalizePersona(persona),
     config: safeConfig,
   }
 }
@@ -60,9 +74,33 @@ export function validateBundle(bundle) {
   for (const key of ['notes', 'facts', 'habits']) {
     if (bundle[key] !== undefined && !Array.isArray(bundle[key])) return `${key} 不是数组`
   }
+  if (bundle.persona !== undefined && bundle.persona !== null) {
+    if (!isObject(bundle.persona)) return 'persona 不是对象'
+    for (const field of ['l0', 'l1', 'l2']) {
+      const value = bundle.persona[field]
+      if (value !== undefined && typeof value !== 'string') return `persona.${field} 不是字符串`
+    }
+  }
   return null
 }
 
+/**
+ * 人格怎么合并：**永远不覆盖**。
+ * - 包里没带、或者全空 → none
+ * - 本机还没有人格 → adopt（用导入的）
+ * - 本机有且一模一样 → same（不写盘，省一次无意义的原子写）
+ * - 本机有但不一样 → conflict，调用方把它落到 persona.imported-<ts>.md，
+ *   绝不悄悄盖掉本机那份 —— 人格是人一条条确认出来的，不该被一次导入换掉。
+ */
+export function mergePersona(incoming, current) {
+  const next = normalizePersona(incoming)
+  if (next === null) return { action: 'none' }
+  const now = normalizePersona(current)
+  if (now === null) return { action: 'adopt', persona: next }
+  if (now.l0 === next.l0 && now.l1 === next.l1 && now.l2 === next.l2) return { action: 'same' }
+  return { action: 'conflict', persona: next }
+}
+
 /**
  * 合并：返回「合并后的三份数据 + 账目」。
  * 纯函数，不写盘 —— 写盘由调用方做，失败才好回滚。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-selfnote",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "type": "module",
   "description": "Self-narrative memory for DeepSeek Harness: the model writes notes to itself, which persist across sessions and are injected back. | 人格库：模型写给自己看的话，跨会话保留并每回合注入。",
   "keywords": [
@@ -27,7 +27,7 @@
     "assets"
   ],
   "scripts": {
-    "test": "node tests/smoke.mjs && node tests/memory.mjs && node tests/roles.mjs && node tests/heat.mjs && node tests/fair.mjs && node tests/capture-debug.mjs && node tests/facts-tx.mjs && node tests/crash-write.mjs && node tests/capture.mjs && node tests/capture-p1b.mjs && node tests/index.mjs && node tests/incremental.mjs && node tests/profile.mjs && node tests/warm.mjs && node tests/transfer.mjs && node tests/api.mjs && node tests/client-state.mjs && node tests/client.mjs",
+    "test": "node tests/smoke.mjs && node tests/memory.mjs && node tests/roles.mjs && node tests/heat.mjs && node tests/fair.mjs && node tests/capture-debug.mjs && node tests/facts-tx.mjs && node tests/crash-write.mjs && node tests/capture.mjs && node tests/capture-p1b.mjs && node tests/index.mjs && node tests/incremental.mjs && node tests/profile.mjs && node tests/warm.mjs && node tests/transfer.mjs && node tests/api.mjs && node tests/notes-tier.mjs && node tests/persona.mjs && node tests/corrections.mjs && node tests/client-state.mjs && node tests/client.mjs",
     "test:accept": "node tests/acceptance-runtime.mjs"
   },
   "engines": {