@nightpainters/dsh-ling 1.5.1

package/lib/host/clock-skill.js

@@ -0,0 +1,141 @@
+// dsh-ling host — clock skill:精确时间按需查询(2026-09-23 用户定)。
+//
+// 为什么做成 skill 而不常驻注入:
+// 时间锚搬迁之后(见内部时间锚设计笔记),system 侧只留 [今天](日期+星期,一天变一次),
+// context 侧给 [现在](时段档 + 间隔档)。**精确到分钟的时间刻意不常驻** —— 它每 60 秒变一次,
+// 会把整段 system 前缀连同工具定义一起作废(实测 system 侧 1440 次/天 → 0)。
+// 需要精确时间时主动查,像看手表,而不是让表一直对着人报时。
+//
+// 注册形态按平台契约:`ctx.skills.register({...})` 注册**内存中的 skill**(嵌入式),
+// 注册表补入默认调用策略与 provider 标签,返回的 disposer 归入本插件 effect 链。
+// 取服务沿用 tools 的三级兜底(直取 → ctx.inject 子 ctx → 定时重试):apply 可能早于 skills 挂载。
+
+/** skill 名(kebab-case,平台按此寻址)。 */
+export const CLOCK_SKILL_NAME = 'clock';
+
+/** 面向发现层的路由描述。 */
+export const CLOCK_SKILL_DESCRIPTION =
+  '查询当前的精确时间(年月日 · 时分秒 · 星期)。需要报时间、算时长、判断"过了多久"、生成带时间戳的名字时使用。';
+
+/** 补充路由指引 —— 顺带把"什么时候不该用它"写在这里,避免为了问时间而白调一次。 */
+export const CLOCK_SKILL_WHEN_TO_USE =
+  '用户问"现在几点""今天几号",或你需要精确到分钟/秒的时间做判断(倒计时、间隔计算、时间戳)时。' +
+  '日常判断"是接着聊还是隔了很久"不需要它 —— 读上下文里的 [现在]。';
+
+/**
+ * 指令正文(frontmatter 由注册字段承载,不进正文)。
+ * ⚠️ 正文会随 skill 加载进入模型请求 ⇒ **不得含相邻的 `{{`**(宿主 renderPrompt 对未注册变量直接抛异常,
+ * 见 1.3.1 的注入面加固);`tests/clock-skill.test.mjs` 对此有断言。
+ */
+export const CLOCK_SKILL_CONTENT = `# clock — 精确时间按需查询
+
+## 为什么需要它
+
+上下文里的时间信息只有**两个档**,都不含精确分钟:
+
+| 载体 | 内容 | 刷新频率 |
+|---|---|---|
+| system 侧 \`[今天]\` | 年月日 + 星期 | 一天一次 |
+| context 侧 \`[现在]\` | 时段(清晨/上午/中午/下午/傍晚/夜里/深夜)+ 间隔档(刚刚/今天早些时候/昨天/N 天前) | 每条消息 |
+
+精确到分钟的时间**刻意不常驻** —— 它每 60 秒变一次,会让整段 system 前缀连同工具定义一起失效。
+所以:**需要精确时间时主动查。像看手表,而不是让表一直报时。**
+
+## 怎么查
+
+\`\`\`powershell
+# 完整:日期 + 时间 + 星期
+pwsh -NoProfile -Command "Get-Date -Format 'yyyy-MM-dd HH:mm:ss dddd'"
+# → 2026-09-23 22:14:37 星期三
+
+# 只要日期
+pwsh -NoProfile -Command "Get-Date -Format 'yyyy-MM-dd dddd'"
+
+# 只要时间
+pwsh -NoProfile -Command "Get-Date -Format 'HH:mm'"
+
+# 带时区偏移(跨时区判断时)
+pwsh -NoProfile -Command "Get-Date -Format 'yyyy-MM-dd HH:mm:ss zzz'"
+# → 2026-09-23 22:14:37 +08:00
+\`\`\`
+
+本机时区:China Standard Time(**UTC+8**),无夏令时。
+
+## 何时该用
+
+| 场景 | 用不用 |
+|---|---|
+| 用户问"现在几点 / 今天几号" | ✅ 用 |
+| 算时长、"过了多久"、倒计时 | ✅ 用(先查再算) |
+| 生成带时间戳的文件名 / 日志行 | ✅ 用 |
+| 判断"接着聊还是隔了很久" | ❌ 不用 —— 读 \`[现在]\` 的间隔档 |
+| 判断语气(深夜该收尾 / 中午可以继续) | ❌ 不用 —— 时段档已在 \`[现在]\` 里 |
+| 往文档里写日期 | ⚠️ 用 \`[今天]\` 即可,除非明确要精确到分钟 |
+
+## 三条边界
+
+1. **不要把精确时间写进长期内容**(persona / settings / 记忆)—— 那会让 system 前缀每次组装都变,
+   把这次优化的收益原样还回去。
+2. **\`[今天]\` 与 \`[现在]\` 优先** —— 它们覆盖绝大多数判断;本 skill 只用于真的需要分钟级时。
+3. **跨零点注意**:\`[今天]\` 由 system 侧承载,跨天后的第一条消息**可能仍是昨天的日期** ——
+   若结论依赖"绝对今天",先查本 skill。
+
+## 来源
+
+dsh-ling 内置(器灵包)。设计依据:本插件内部的时间锚设计笔记。
+`;
+
+/**
+ * 注册 clock skill,带与 tools 同款的三级兜底。
+ * @param {object} ctx cordis 上下文。
+ * @returns {Array<Function>} 需要随插件一起释放的 disposer 列表(含定时器与 skill 注销)。
+ */
+export function registerClockSkill(ctx) {
+  const disposers = [];
+  let mounted = false;
+
+  const mount = (c) => {
+    if (mounted) return true;
+    try {
+      const skills = c?.skills;
+      if (!skills || typeof skills.register !== 'function') return false;
+      const d = skills.register({
+        name: CLOCK_SKILL_NAME,
+        description: CLOCK_SKILL_DESCRIPTION,
+        whenToUse: CLOCK_SKILL_WHEN_TO_USE,
+        content: CLOCK_SKILL_CONTENT,
+        source: 'bundled',
+      });
+      if (typeof d === 'function') disposers.push(d);
+      mounted = true;
+      console.info('[dsh-ling] clock skill registered');
+      return true;
+    } catch (e) {
+      console.debug('[dsh-ling] clock skill registration failed', e);
+      return false;
+    }
+  };
+
+  if (!mount(ctx)) {
+    // 服务从回调参数取,不能走闭包 ctx(否则报 without inject)
+    try {
+      ctx.inject?.(['skills'], (child) => {
+        mount(child);
+      });
+    } catch (e) {
+      console.debug('[dsh-ling] ctx.inject skills failed', e);
+    }
+    let tries = 0;
+    const timer = setInterval(() => {
+      tries += 1;
+      if (mounted || tries >= 20) {
+        clearInterval(timer);
+        return;
+      }
+      mount(ctx);
+    }, 1500);
+    disposers.push(() => clearInterval(timer));
+    console.info('[dsh-ling] skills service not ready at apply; retrying (clock)');
+  }
+  return disposers;
+}

package/lib/host/clock.js

@@ -0,0 +1,132 @@
+// dsh-ling host — 被动时间锚(上下文时间):每次模型步组装时动态生成的"现在"行。
+// 设计(2026-09-11 作者拍板):
+//   - 属记忆与人格层的"被动时间感知":让器灵知道今天几号、距上次对话多久、是否纪念日;
+//   - **不进快照**(snapshotVersion 不含它),由注入面逐次拼接,避免跨天快照过期;
+//   - 称呼**跟随用户自己设定的 userTitle**(不硬编码);未设置时用中性措辞;
+//   - 本版本不做主动打扰:她只在你开口时出现(时间锚是"开口时的感知",不触发任何主动消息)。
+import { userTitleForMode } from './persona.js';
+
+export const WEEK_CN = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
+
+/** 内置纪念日(月份从 1 起):本项目(器灵)的诞生纪念日。可在 settings.dates 追加/覆盖自定义条目。 */
+export const FESTIVALS = [
+  { m: 9, d: 7, label: '器灵的新生纪念日', greeting: 'HELLO PARTNER' },
+];
+
+export function periodOf(hour) {
+  if (hour < 5) return '深夜';
+  if (hour < 8) return '清晨';
+  if (hour < 11) return '上午';
+  if (hour < 13) return '中午';
+  if (hour < 17) return '下午';
+  if (hour < 19) return '傍晚';
+  if (hour < 23) return '夜里';
+  return '深夜';
+}
+
+export function formatGap(ms) {
+  if (!Number.isFinite(ms) || ms < 0) return '';
+  const min = Math.floor(ms / 60000);
+  if (min < 1) return '刚刚';
+  if (min < 60) return min + ' 分钟前';
+  const hr = Math.floor(min / 60);
+  if (hr < 24) return hr + ' 小时前';
+  const day = Math.floor(hr / 24);
+  if (day < 30) return day + ' 天前';
+  const mon = Math.floor(day / 30);
+  if (mon < 12) return '约 ' + mon + ' 个月前';
+  return '约 ' + Math.floor(mon / 12) + ' 年前';
+}
+
+/**
+ * 档位化间隔(context 侧专用,2026-09-23)。
+ *
+ * 与 formatGap 的差别是**精度降到档**:分钟级梯度("3 分钟前/38 分钟前")对判断没有价值,
+ * 却会让挂在末条消息上的 context 文本每分钟改一次 ⇒ 上下文缓慢膨胀。
+ * 本函数按**日历天**分档,一天最多变一次("刚刚"→"今天早些时候"跨 2 小时边界)。
+ */
+export function formatGapCoarse(last, now = new Date()) {
+  const t = last instanceof Date ? last : new Date(last);
+  if (!Number.isFinite(t.getTime())) return '';
+  const min = Math.floor((now.getTime() - t.getTime()) / 60000);
+  if (min < 0) return '';
+  if (min < 120) return '刚刚'; // < 2 小时:含跨午夜(23:50→01:00 仍算刚聊过)
+  const d0 = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+  const d1 = new Date(t.getFullYear(), t.getMonth(), t.getDate());
+  const days = Math.round((d0.getTime() - d1.getTime()) / 864e5);
+  if (days <= 0) return '今天早些时候';
+  if (days === 1) return '昨天';
+  if (days < 30) return days + ' 天前';
+  const mon = Math.floor(days / 30);
+  if (mon < 12) return '约 ' + mon + ' 个月前';
+  return '约 ' + Math.floor(mon / 12) + ' 年前';
+}
+
+function pad2(n) { return (n < 10 ? '0' : '') + n; }
+
+/** 命中当天的纪念日(内置 + settings.dates),返回 {label, greeting} 或 null。 */
+export function festivalToday(settings, now = new Date()) {
+  const list = [];
+  const custom = settings?.dates;
+  if (Array.isArray(custom)) list.push(...custom);
+  list.push(...FESTIVALS);
+  const m = now.getMonth() + 1;
+  const d = now.getDate();
+  for (const f of list) {
+    if (!f || Number(f.m) !== m || Number(f.d) !== d) continue;
+    return { label: String(f.label || '纪念日'), greeting: f.greeting ? String(f.greeting) : '' };
+  }
+  return null;
+}
+
+/**
+ * system 侧时间锚:**日期 + 星期**(+ 纪念日)。一天只变一次。
+ *
+ * 为什么时分/时段不在这里(2026-09-23 搬迁):system 是**会话前缀**,改一个字整段前缀
+ * 缓存作废。实测回合内断裂 174 次 = 未缓存 token 43.96%,是全项目最大单点。
+ * 分钟级信息移到 context 侧({@link timeAnchorLive})——那里是"末条消息追加",
+ * 平台只在本轮真正不同时产出新快照。
+ * @param {object} _memory 未用:保留签名与 timeAnchorLive 对称,便于调用方切换
+ * @param {object} settings 传入 SettingsFile 或已解包的 settings 对象
+ * @param {Date} now 便于测试注入
+ */
+export function timeAnchorDate(_memory, settings, { now = new Date() } = {}) {
+  const s = settings && typeof settings.get === 'function' ? settings.get() : (settings || {});
+  const mode = s?.mode?.lastMode || 'life';
+  const callName = userTitleForMode(s?.persona?.userTitle, mode); // 称呼跟随用户设定;空则中性措辞
+  const lines = [];
+  lines.push(`[今天] ${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())} ${WEEK_CN[now.getDay()]}`);
+  const fest = festivalToday(s, now);
+  if (fest) {
+    const greet = fest.greeting ? ` —— 开场第一句${callName ? `先对${callName}说` : '先说'}:${fest.greeting}` : '';
+    lines.push(`今天是 ${fest.label}(${now.getMonth() + 1}-${now.getDate()})${greet}。`);
+  }
+  return lines.join('\n');
+}
+
+/**
+ * context 侧时间锚:**时段 + 间隔(档位制)**。每轮实时重算,挂在末条消息上。
+ *
+ * 精度刻意降到"档":分钟级梯度对判断没有价值,却会让尾部文本每分钟变一次。
+ * 两侧合起来才是完整时间感知 —— system 给"今天几号",本函数给"什么时段、隔了多久"。
+ *
+ * 调用方把本函数的文本注册进 `systemPrompt.context()`,不是 `section()`:
+ * context 走末条消息追加 + 平台差异比对,section 改一个字就作废整个前缀。
+ */
+export function timeAnchorLive(memory, settings, { now = new Date() } = {}) {
+  const s = settings && typeof settings.get === 'function' ? settings.get() : (settings || {});
+  const mode = s?.mode?.lastMode || 'life';
+  const callName = userTitleForMode(s?.persona?.userTitle, mode);
+  const head = `[现在] ${periodOf(now.getHours())}`;
+  try {
+    const last = memory && typeof memory.lastUserTurnAt === 'function' ? memory.lastUserTurnAt() : null;
+    if (last) {
+      const t = Date.parse(last);
+      if (Number.isFinite(t)) {
+        const gap = formatGapCoarse(new Date(t), now);
+        if (gap) return callName ? `${head} · 距上次与${callName}对话:${gap}` : `${head} · 距上次对话:${gap}`;
+      }
+    }
+  } catch {}
+  return head;
+}

package/lib/host/corpus-suggest.js

@@ -0,0 +1,139 @@
+// dsh-ling host — 语料人格建议识别器 v2(零模型,证据驱动)。
+// 称呼类建议采用**白名单人称词库 + 句首/句尾双端匹配**(避免把"不错/当然可以/服务器繁忙"
+// 之类功能性开头当称呼);纠正类仍用模式桶。全部阈值保守,证据附带原文摘录。
+
+// 示例词库(启发式):可按你自己的历史语料增删。
+// AI 自称词库:识别"助手在句中如何自称"的候选;
+// 用户称呼词库:识别"助手如何称呼用户"的候选(其中也含 AI 自身名字,以免把自称误判成对用户的称呼)。
+const AI_NAME_LEX = ['小灵', '灵灵', '小灵儿', '阿灵', '小语', '语语'];
+const USER_TITLE_LEX = ['主人', '朋友', '兄弟', '老哥', '老师', '同学', '伙伴', '老板', '师傅', '亲', '阁下', '君', '先生', '女士', '道友', '掌柜', '大王', '小灵', '灵灵', '小语', '你老'];
+
+export const CORRECTION_BUCKETS = [
+  {
+    key: 'classical',
+    rule: '不要为文言而文言;用户要求直白清楚时用现代口语。',
+    re: /太文言|文言文|文言了|晦涩|诘屈|为文言|咬文嚼字|拽文|之乎者也/,
+  },
+  {
+    key: 'verbose',
+    rule: '回答先给结论,控制篇幅,别绕。',
+    re: /太啰嗦|太冗长|废话|太长不看|精简|精炼|说重点|直接给结论|别绕|说人话|简洁一点|能不能短点|缩短|废话太多|回复太长|回答太长|写太长|车轱辘|重复啰嗦/,
+  },
+  {
+    key: 'vague',
+    rule: '不要空话套话;给可执行的具体内容。',
+    re: /太虚|假大空|空话|套话|不接地气|太抽象|太空洞|虚的|来点实际的|干货|务实点|别整虚的/,
+  },
+  {
+    key: 'emotion',
+    rule: '语气有温度一点,别太冷/太官方。',
+    re: /太冷|冷漠|冷冰冰|温柔一点|温暖一点|太官方|太正式|轻松点|活泼点|俏皮|幽默点|有人情味|太机械|太客套/,
+  },
+  {
+    key: 'format',
+    rule: '多用结构化呈现(分点/表格/列表),便于阅读。',
+    re: /用表格|分点|分条|列个表|做成表格|排版|结构化|条理|编号列出|要点列出来|表格形式|按点回答/,
+  },
+];
+
+const escRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+function excerptAround(text, idx, span = 44) {
+  const start = Math.max(0, idx - span);
+  const seg = text.slice(start, idx + span).replace(/\s+/g, ' ');
+  return (start > 0 ? '…' : '') + seg + (start + seg.length < text.length ? '…' : '');
+}
+
+/**
+ * 白名单人称匹配:词出现在句首(词+标点)或句尾(标点+词)才计为"称呼"。
+ * 附带 anyTotal(全文提及次数,作旁证展示)。
+ */
+function analyzeLexMatches(docs, lexicon, { minCount = 3 }) {
+  const out = [];
+  for (const w of lexicon) {
+    const startRe = new RegExp('^' + escRe(w) + '[，,。！!？?:：]');
+    const tailRe = new RegExp('[，,。！!？?:：]' + escRe(w) + '[。!！？?]?$');
+    let n = 0;
+    let anyTotal = 0;
+    let last = '';
+    const samples = [];
+    for (const doc of docs) {
+      const text = doc.text || '';
+      if (text.length > 20000) continue;
+      if (text.includes(w)) anyTotal += 1;
+      let idx = -1;
+      let m = text.match(startRe);
+      if (m) {
+        idx = 0;
+      } else {
+        m = text.match(tailRe);
+        if (m) idx = text.lastIndexOf(w);
+      }
+      if (idx < 0) continue;
+      n += 1;
+      if (!last || (doc.date || '') > last) last = doc.date || '';
+      if (samples.length < 3) {
+        samples.push({ date: doc.date || '', ref: doc.ref || '', excerpt: excerptAround(text, Math.max(0, idx)) });
+      }
+    }
+    if (n >= minCount) {
+      out.push({ chunk: w, n, last, samples, anyTotal });
+    }
+  }
+  return out.sort((a, b) => b.n - a.n).slice(0, 3);
+}
+
+function analyzeCorrections(docs, { minCount = 3 }) {
+  const buckets = CORRECTION_BUCKETS.map((b) => ({ ...b, n: 0, last: '', samples: [] }));
+  for (const doc of docs) {
+    const text = doc.text || '';
+    if (text.length > 20000) continue;
+    for (const b of buckets) {
+      const m = text.match(b.re);
+      if (m) {
+        b.n += 1;
+        if (!b.last || (doc.date || '') > b.last) b.last = doc.date || '';
+        if (b.samples.length < 3) {
+          b.samples.push({ date: doc.date || '', ref: doc.ref || '', excerpt: excerptAround(text, m.index) });
+        }
+      }
+    }
+  }
+  return buckets.filter((b) => b.n >= minCount);
+}
+
+/**
+ * @param {object} opts { userDocs, assistantDocs }
+ */
+export function analyzeCorpus({ userDocs = [], assistantDocs = [] } = {}) {
+  const items = [];
+  const aiNames = analyzeLexMatches(userDocs, AI_NAME_LEX, { minCount: 3 });
+  if (aiNames.length) {
+    const top = aiNames[0];
+    items.push({
+      kind: 'aiName',
+      value: top.chunk,
+      note: `历史语料里你有 ${top.n} 次在句首/句尾以「${top.chunk}」唤我(全文提及 ${top.anyTotal} 次,最近 ${top.last || '?'})。建议 AI 自称设为「${top.chunk}」。`,
+      evidence: { count: top.n, recent: top.last, samples: top.samples.slice(0, 3), anyTotal: top.anyTotal },
+    });
+  }
+  const userTitles = analyzeLexMatches(assistantDocs, USER_TITLE_LEX, { minCount: 3 });
+  if (userTitles.length) {
+    const top = userTitles[0];
+    items.push({
+      kind: 'userTitle',
+      value: top.chunk,
+      note: `过去我的回复里有 ${top.n} 次以「${top.chunk}」称呼你(全文 ${top.anyTotal} 次,最近 ${top.last || '?'})。建议沿用为对你的称呼。`,
+      evidence: { count: top.n, recent: top.last, samples: top.samples.slice(0, 3), anyTotal: top.anyTotal },
+    });
+  }
+  for (const b of analyzeCorrections(userDocs, { minCount: 3 })) {
+    items.push({
+      kind: 'hardrule',
+      value: b.rule,
+      note: `你在 ${b.n} 条消息里表达过这类诉求(最近 ${b.last || '?'}),建议采纳为习惯:「${b.rule}」`,
+      evidence: { count: b.n, recent: b.last, samples: b.samples.slice(0, 3), bucket: b.key },
+    });
+  }
+  return { items, stats: { userDocs: userDocs.length, assistantDocs: assistantDocs.length } };
+}