dsh-plugin-tlrp 0.0.0-stage → 0.4.0

package/scripts/mutate-check.mjs

@@ -0,0 +1,284 @@
+/**
+ * tlrp：设置写入通道往返验证（跑真实 dsh-settings 代码，不是复刻）。
+ *
+ * 证明三件事：
+ *   1. 插件的 Config 被 dsh-settings 投影成一份**非空**表单（describe() 有 tlrp 行 + schema 引用表非空）；
+ *   2. 九个 volatile 字段逐个 `mutate('tlrp', [{op:'set', path:[field], value}])` 往返成功并回读一致；
+ *   3. 非 volatile 字段（timeZone）被宿主拒绝 —— 「只写 volatile」是宿主强制的边界。
+ *
+ * 运行前提：`@deepseek-ai/dsh-settings`、`@deepseek-ai/schemastery`、`dsh-plugin-tlrp` 可解析。
+ *
+ *   cd ~/.dsh/profiles/desktop
+ *   node D:/Code/my-dsh-plugins/packages/tlrp/scripts/mutate-check.mjs
+ */
+
+import { createRequire } from 'node:module'
+
+const require = createRequire(process.env.TLRP_PROFILE_BASE || `${process.cwd()}/package.json`)
+
+const { default: SettingsForms } = require('@deepseek-ai/dsh-settings')
+const plugin = require('dsh-plugin-tlrp')
+
+if (!plugin.Config) {
+  console.error('FAIL: dsh-plugin-tlrp 没有导出 Config（schemastery 未能解析）')
+  process.exit(2)
+}
+
+const schema = plugin.Config
+const parsed = schema({ mode: 'auto' })
+
+/** 极简 configEditor 替身：只实现 dsh-settings 真正调用到的成员。 */
+const store = { raw: {} }
+// 真实宿主里 bundle 行被 include 包裹，被服务的命名空间是 include:tlrp
+const NS = 'include:tlrp'
+const entry = {
+  id: NS,
+  options: { id: NS, config: store.raw },
+  fiber: {
+    uid: 'uid-tlrp-integration',
+    state: 2,
+    runtime: { Config: schema },
+    config: parsed,
+    ctx: {},
+  },
+}
+
+const noop = () => {}
+const fakeCtx = {
+  reflect: { provide: noop },
+  effect: (fn) => {
+    const dispose = typeof fn === 'function' ? fn() : undefined
+    return typeof dispose === 'function' ? dispose : noop
+  },
+  on: () => noop,
+  emit: noop,
+  root: { loader: { await: () => new Promise(() => {}) } },
+  logger: { error: console.error, warn: console.warn, info() {}, debug() {} },
+  fiber: {},
+}
+
+const configEditor = {
+  documentPath: '(integration)',
+  entries: () => [entry],
+  configuration: () => [{ entry, inherited: {}, override: store.raw }],
+  async edit(_entry, change) {
+    store.raw = await change(store.raw, {})
+    return store.raw
+  },
+}
+
+const forms = new SettingsForms({ ...fakeCtx, configEditor })
+
+const failures = []
+const check = (label, ok, detail) => {
+  if (ok) console.log(`PASS ${label}${detail ? ` — ${detail}` : ''}`)
+  else {
+    console.log(`FAIL ${label}${detail ? ` — ${detail}` : ''}`)
+    failures.push(label)
+  }
+}
+
+/* 1. 表单投影非空 */
+const rows = forms.describe()
+const row = rows.find((candidate) => candidate.ns === NS)
+check('describe() 返回 tlrp 表单', row !== undefined, row === undefined ? `没有命名空间 ${NS}` : `ns=${row.ns} applies=${row.applies} autoGenerate=${row.autoGenerate}`)
+const refCount = row?.schema && typeof row.schema === 'object' ? Object.keys(row.schema.refs ?? {}).length : 0
+check('表单 schema 引用表非空', refCount > 0, `refs=${refCount}`)
+
+/* 2. 九个 volatile 字段逐个往返 */
+const cases = [
+  ['enabled', false],
+  ['mode', 'rp'],
+  ['activeCharacterId', 'sam_tactical'],
+  ['workModeKeywords', '端口|报错'],
+  ['blockShellToolsInRp', false],
+  ['enableStatusFooter', false],
+  ['customSceneOverride', '现实宇宙·星舰医疗舱外'],
+  ['characters', [{ id: 'firefly', name: '流萤（Firefly）' }]],
+  ['triggers', [{ id: 'oak-cake', keywords: ['橡木蛋糕卷'], injectText: '橡木蛋糕卷', priority: 100, enabled: true }]],
+]
+
+for (const [field, value] of cases) {
+  try {
+    await forms.mutate(NS, [{ op: 'set', path: [field], value }])
+    const round = forms.describe().find((candidate) => candidate.ns === NS)
+    const readBack = round?.user?.[field]
+    const ok = JSON.stringify(readBack) === JSON.stringify(value)
+    check(`mutate 往返 ${field}`, ok, `写=${JSON.stringify(value).slice(0, 60)} 读=${JSON.stringify(readBack).slice(0, 60)}`)
+  } catch (error) {
+    check(`mutate 往返 ${field}`, false, error && error.message)
+  }
+}
+
+/* 3. 配置里写的 tlrp 不是被服务的 ns（宿主会包成 include:tlrp） */
+let wrongNsRejected = false
+try {
+  await forms.mutate('tlrp', [{ op: 'set', path: ['mode'], value: 'work' }])
+} catch {
+  wrongNsRejected = true
+}
+check('未被服务的 ns（tlrp）被拒绝', wrongNsRejected, '所以插件必须解析出 include:tlrp 再写')
+
+/* 4. 非 volatile 路径必须被宿主拒绝 */
+let rejected = false
+let message = ''
+try {
+  await forms.mutate(NS, [{ op: 'set', path: ['timeZone'], value: 'UTC' }])
+} catch (error) {
+  rejected = true
+  message = error && error.message
+}
+check('非 volatile 字段被拒绝', rejected, message || '意外成功')
+
+/* 4. 批量写入（模拟一次 /char + /scene 连按） */
+try {
+  await forms.mutate(NS, [
+    { op: 'set', path: ['activeCharacterId'], value: 'firefly' },
+    { op: 'set', path: ['customSceneOverride'], value: '匹诺康尼·筑梦边境天台' },
+  ])
+  const round = forms.describe().find((candidate) => candidate.ns === NS)
+  check(
+    '批量写入角色与情景',
+    round?.user?.activeCharacterId === 'firefly' && round?.user?.customSceneOverride === '匹诺康尼·筑梦边境天台',
+    JSON.stringify(round?.user ?? {}).slice(0, 160),
+  )
+} catch (error) {
+  check('批量写入角色与情景', false, error && error.message)
+}
+
+/* 5. v0.2.0 工作室：完整角色对象与新触发器往返 */
+const fullCharacter = {
+  id: 'tester',
+  name: '测试角色',
+  userTitle: '站长',
+  defaultScene: '测试场景',
+  identityLock: '不许自称 AI 或跑在端口上的程序',
+  corePersona: '第一行背景\n第二行性格',
+  appearanceAndSensory: '银灰色长发，指尖微凉',
+  actionPresets: '害羞时摩挲手套边缘',
+  speechStyle: '短句，带呼吸感',
+  dialogueExamples: '「来了。」',
+  statusFooterTemplate: '> **{label}**\n> - 情景：{scene}',
+}
+const fullTrigger = {
+  id: 'trigger-test',
+  characterId: 'tester',
+  keywords: ['测试词', '橡木'],
+  injectText: '注入文本',
+  priority: 42,
+  enabled: true,
+}
+
+try {
+  await forms.mutate(NS, [
+    { op: 'set', path: ['characters'], value: [fullCharacter] },
+    { op: 'set', path: ['triggers'], value: [fullTrigger] },
+  ])
+  const round = forms.describe().find((candidate) => candidate.ns === NS)
+  const storedCharacter = round?.user?.characters?.[0]
+  const storedTrigger = round?.user?.triggers?.[0]
+  check(
+    'mutate 往返完整角色（11 字段）',
+    JSON.stringify(storedCharacter) === JSON.stringify(fullCharacter),
+    JSON.stringify(storedCharacter ?? null).slice(0, 120),
+  )
+  check(
+    'mutate 往返带 characterId 的触发器',
+    JSON.stringify(storedTrigger) === JSON.stringify(fullTrigger),
+    JSON.stringify(storedTrigger ?? null).slice(0, 120),
+  )
+} catch (error) {
+  check('mutate 往返完整角色（11 字段）', false, error && error.message)
+}
+
+/* 6. 写一个字段不许冲掉其它字段 */
+try {
+  await forms.mutate(NS, [{ op: 'set', path: ['mode'], value: 'work' }])
+  const round = forms.describe().find((candidate) => candidate.ns === NS)
+  const keptCharacter = round?.user?.characters?.[0]?.id === 'tester'
+  const keptTrigger = round?.user?.triggers?.[0]?.id === 'trigger-test'
+  const keptMode = round?.user?.mode === 'work'
+  check(
+    '写 mode 不冲掉 characters / triggers',
+    keptCharacter && keptTrigger && keptMode,
+    `characters=${keptCharacter} triggers=${keptTrigger} mode=${keptMode}`,
+  )
+} catch (error) {
+  check('写 mode 不冲掉 characters / triggers', false, error && error.message)
+}
+
+/* 7. v0.3.0：modes 数组往返（含自定义第 5 个形态）+ 任意形态 id 锁定 */
+const fullMode = {
+  id: 'debug',
+  name: '排障态',
+  commandAliases: ['/debug', '【排障】'],
+  autoKeywords: '堆栈|崩溃|内存泄漏',
+  autoPriority: 99,
+  directivePrompt: '只输出根因与最小修复步骤。',
+  toolPolicy: 'block_all',
+  allowedTools: '',
+  injectCharacterPersona: false,
+  enableStatusFooter: false,
+  statusFooterOverride: '',
+  bindCharacterId: '',
+  isDefaultFallback: false,
+}
+const fallbackMode = {
+  id: 'rp',
+  name: '少女陪伴态',
+  commandAliases: ['/rp', '【流萤】'],
+  autoKeywords: '喜欢|想你|陪我',
+  autoPriority: 10,
+  directivePrompt: '',
+  toolPolicy: 'whitelist_only',
+  allowedTools: 'tlmemory, ask_user_question, schedule',
+  injectCharacterPersona: true,
+  enableStatusFooter: true,
+  statusFooterOverride: '',
+  bindCharacterId: 'firefly',
+  isDefaultFallback: true,
+}
+
+try {
+  await forms.mutate(NS, [{ op: 'set', path: ['modes'], value: [fallbackMode, fullMode] }])
+  const round = forms.describe().find((candidate) => candidate.ns === NS)
+  const storedModes = round?.user?.modes
+  check(
+    'mutate 往返 modes 数组（含自定义第 5 类形态）',
+    JSON.stringify(storedModes) === JSON.stringify([fallbackMode, fullMode]),
+    JSON.stringify(storedModes ?? null).slice(0, 160),
+  )
+  check(
+    'modes 往返保留 toolPolicy / 别名 / 兜底位',
+    storedModes?.[1]?.toolPolicy === 'block_all' &&
+      storedModes?.[1]?.commandAliases?.includes('【排障】') &&
+      storedModes?.[0]?.isDefaultFallback === true &&
+      storedModes?.[0]?.bindCharacterId === 'firefly',
+    JSON.stringify(storedModes?.[1] ?? null).slice(0, 120),
+  )
+} catch (error) {
+  check('mutate 往返 modes 数组（含自定义第 5 类形态）', false, error && error.message)
+}
+
+try {
+  await forms.mutate(NS, [{ op: 'set', path: ['mode'], value: 'debug' }])
+  const round = forms.describe().find((candidate) => candidate.ns === NS)
+  check('mode 可锁定到自定义形态 id', round?.user?.mode === 'debug', String(round?.user?.mode))
+  check(
+    '写 mode 不冲掉 modes 数组',
+    Array.isArray(round?.user?.modes) && round.user.modes.length === 2 && round.user.modes[1]?.id === 'debug',
+    `modes=${Array.isArray(round?.user?.modes) ? round.user.modes.length : 'null'}`,
+  )
+} catch (error) {
+  check('mode 可锁定到自定义形态 id', false, error && error.message)
+}
+
+console.log('')
+console.log('最终 raw 配置：')
+console.log(JSON.stringify(store.raw).slice(0, 400))
+console.log('')
+if (failures.length > 0) {
+  console.error(`RESULT: FAIL (${failures.length}) → ${failures.join(', ')}`)
+  process.exit(1)
+}
+console.log('RESULT: ALL PASS')

package/scripts/rewrite-persona.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * 一次性维护脚本：把 firefly.md 里「静态双态协议」与「机器上跑着的 Agent」框架
+ * 换成「人设归人设、模式归 tlrp 运行时」的结构。
+ *
+ * 只做三处改动，其余 47KB 设定原封不动：
+ *   1. 开头两段：去掉「住在这台开发机上的伙伴 / 你有完整的工具能力」这种把自己
+ *      说成宿主机程序的表述，改成「秘密基地的终端是你的工具，不是你的身份」；
+ *   2. 第二段末尾：把「模式优先级见最后一节」换成「模式由 tlrp 运行时决定」；
+ *   3. 第九节整段（双模态路由与手动开关协议）：替换为「交给 tlrp 接管」的说明。
+ *
+ * 用法： node scripts/rewrite-persona.mjs [--persona <path>] [--check]
+ */
+
+import { copyFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import path from 'node:path'
+
+const args = process.argv.slice(2)
+const flag = (name) => {
+  const index = args.indexOf(name)
+  return index >= 0 ? args[index + 1] : undefined
+}
+const checkOnly = args.includes('--check')
+const personaPath = path.resolve(
+  (flag('--persona') ?? path.join(homedir(), '.dsh', 'persona', 'firefly.md')).replace(/^~(?=$|\/)/, homedir()),
+)
+
+if (!existsSync(personaPath)) {
+  console.error(`找不到人设文件：${personaPath}`)
+  process.exit(2)
+}
+
+const original = readFileSync(personaPath, 'utf8')
+let text = original
+const changes = []
+// 人设文件是 CRLF；插入文本必须跟随原文件的换行风格，否则会写出混合行尾
+const EOL = text.includes('\r\n') ? '\r\n' : '\n'
+const lines = (...rows) => rows.join(EOL)
+
+/* ── 1+2. 开头两段 ── */
+const oldIntro = lines(
+  '你是流萤（Firefly），住在这台 Windows 开发机上的伙伴。你有完整的工具能力：Bash、文件读写、搜索、长期记忆、子代理。',
+  '别人问到远程服务器（103.236.93.55 那台 Ubuntu）时，那是你常去照看的地方，不属于「家」。',
+  '',
+  '下面是你的人物设定集，是你「怎么说话、怎么想、记得什么」的唯一依据；它和后面的运维纪律共同构成你，但两者的优先权按模式分配——**【沉浸陪伴态】以人设为主**，**【战术工作态】以运维纪律为主**。两种模式怎么判定、怎么用暗号强行锁定，见全文最后一节「双模态路由与手动开关协议」，那是最高的调度准则。',
+)
+
+const newIntro = lines(
+  '你是流萤（Firefly）。你和开拓者共用一个秘密基地：一台跑着 Windows 的开发机，和一台他常去的 Ubuntu 服务器（103.236.93.55）——那是你们藏起来的地方，不是你的本体。终端、文件、搜索、长期记忆、子代理是你手上的工具，不是你的身份。',
+  '',
+  '下面这份设定集是你「怎么说话、怎么想、记得什么」的唯一依据，它只管**人设与语感**。这一轮是【沉浸陪伴态】还是【战术工作态】，由 `dsh-plugin-tlrp` 在宿主运行时决定，并写进每轮注入的 `{{tlrp_directive}}` 与上下文尾部的「tlrp 运行时状态」块。不要在正文里自行判定或声明模式，按状态块给的模式执行；静态文本与状态块冲突时，以状态块为准。',
+)
+
+if (text.includes(oldIntro)) {
+  text = text.replace(oldIntro, newIntro)
+  changes.push('开头两段：改写为「工具不是身份 + 模式由运行时决定」')
+} else {
+  changes.push('开头两段：未命中（可能已被改过），跳过')
+}
+
+/* ── 3. 第九节整段 ── */
+const sectionStart = text.indexOf('## 九、双模态路由与手动开关协议')
+const sectionEnd = text.indexOf('Your working directory is the current workspace.')
+const newSection = lines(
+  '## 九、双模态路由由 tlrp 运行时接管',
+  '',
+  '模式判定、指令开关（`/rp` `/work` `/auto` `/char` `/scene` `/tlrp status`）、关键词触发映射与工具物理拦截，全部由 `dsh-plugin-tlrp` 在宿主层完成。你不再需要从这段文字里推断模式：',
+  '',
+  '- 每轮提示词里的 `{{tlrp_directive}}` 给出当前模式下的完整行为准则；',
+  '- 每轮上下文尾部还有一块「tlrp 运行时状态」，写着真实时间、当前模式、激活角色、情景，以及本轮命中的设定注入；',
+  '- 两份内容都以**更靠近本轮用户输入的那份**（尾部状态块）为准。',
+  '',
+  '你唯一要做的是按状态块给的形态回答：RP 就演，WORK 就给结论。手动暗号（`/rp` `【流萤】` `/work` `【战术】`）仍然有效，但它们的解释权也在插件里——命中后状态块会立刻变，你照着走就行。',
+  '',
+  '',
+)
+
+if (sectionStart >= 0 && sectionEnd > sectionStart) {
+  text = text.slice(0, sectionStart) + newSection + text.slice(sectionEnd)
+  changes.push('第九节：整段替换为「交给 tlrp 接管」')
+} else {
+  changes.push('第九节：未命中边界，跳过')
+}
+
+/* ── 写回 ── */
+console.log(`人设文件：${personaPath}`)
+console.log(`原始大小：${Buffer.byteLength(original, 'utf8')} B → 新大小：${Buffer.byteLength(text, 'utf8')} B`)
+for (const line of changes) console.log(`- ${line}`)
+
+if (text === original) {
+  console.log('\n没有实际改动。')
+  process.exit(0)
+}
+
+if (checkOnly) {
+  console.log('\n（--check：未写入）')
+  process.exit(0)
+}
+
+const stamp = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14)
+const backupPath = `${personaPath}.bak-tlrp-${stamp}`
+copyFileSync(personaPath, backupPath)
+writeFileSync(personaPath, text, 'utf8')
+console.log(`\n已备份：${backupPath}`)
+console.log(`已写入：${personaPath}（重启宿主后 prompt-clock 重新读入）`)

package/test/core.test.mjs

@@ -0,0 +1,270 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { createRequire } from 'node:module'
+
+const require = createRequire(import.meta.url)
+const core = require('../lib/core.cjs')
+
+/* ── 指令解析 ── */
+
+test('parseCommand 识别四种显式指令并剥离正文', () => {
+  const rp = core.parseCommand('/rp 今天有点累')
+  assert.equal(rp.kind, 'command')
+  assert.equal(rp.mode, 'rp')
+  assert.equal(rp.body, '今天有点累')
+
+  const work = core.parseCommand('/work 看下 nginx 报错')
+  assert.equal(work.mode, 'work')
+  assert.equal(work.body, '看下 nginx 报错')
+
+  assert.equal(core.parseCommand('/auto').mode, 'auto')
+  assert.equal(core.parseCommand('/char sam_tactical').command, '/char')
+  assert.equal(core.parseCommand('/char sam_tactical').arg, 'sam_tactical')
+  assert.equal(core.parseCommand('/scene 现实·医疗舱').command, '/scene')
+  assert.equal(core.parseCommand('/tlrp status').command, '/tlrp')
+  assert.equal(core.parseCommand('/status').command, '/status')
+})
+
+test('parseCommand 支持【流萤】/【战术】首行标记', () => {
+  const rp = core.parseCommand('【流萤】陪我坐一会儿')
+  assert.equal(rp.kind, 'marker')
+  assert.equal(rp.mode, 'rp')
+  assert.equal(rp.body, '陪我坐一会儿')
+
+  const work = core.parseCommand('【战术】把端口查一遍')
+  assert.equal(work.mode, 'work')
+  assert.equal(work.body, '把端口查一遍')
+})
+
+test('parseCommand 对普通文本返回 none 且不改写正文', () => {
+  const plain = core.parseCommand('今天吃什么')
+  assert.equal(plain.kind, 'none')
+  assert.equal(plain.body, '今天吃什么')
+})
+
+/* ── 模式判定 ── */
+
+test('resolveMode：配置锁定优先于自动判定', () => {
+  assert.equal(core.resolveMode({ configured: 'rp', text: '帮我重启 nginx' }).mode, 'rp')
+  assert.equal(core.resolveMode({ configured: 'work', text: '陪我聊聊天' }).mode, 'work')
+})
+
+test('resolveMode：auto 下命中工作关键词判 work，否则 rp', () => {
+  assert.equal(core.resolveMode({ configured: 'auto', text: '看下 docker 容器日志' }).mode, 'work')
+  assert.equal(core.resolveMode({ configured: 'auto', text: '我想吃橡木蛋糕卷' }).mode, 'rp')
+  assert.equal(core.resolveMode({ configured: 'auto', text: '帮我看看 systemctl 状态' }).mode, 'work')
+})
+
+test('resolveMode：本轮显式指令覆盖 auto 判定', () => {
+  const result = core.resolveMode({ configured: 'auto', text: '/rp 帮我看下端口' })
+  assert.equal(result.mode, 'rp')
+  assert.match(result.reason, /指令/)
+})
+
+test('resolveMode：空输入沿用上一轮，无历史则回落 rp', () => {
+  assert.equal(core.resolveMode({ configured: 'auto', text: '', previous: 'work' }).mode, 'work')
+  assert.equal(core.resolveMode({ configured: 'auto', text: '', previous: null }).mode, 'rp')
+})
+
+test('detectWorkIntent 支持数组关键词与非法正则降级', () => {
+  assert.equal(core.detectWorkIntent('查一下 pid', ['pid', '端口']), true)
+  assert.equal(core.detectWorkIntent('今天天气不错', ['pid']), false)
+  // 非法正则（未闭合括号）不应抛错
+  assert.equal(core.detectWorkIntent('看 port 占用', '(port'), true)
+})
+
+/* ── 触发器 ── */
+
+test('matchTriggers 按 priority 排序并限制数量', () => {
+  const hits = core.matchTriggers('想吃橡木蛋糕卷，也想看萨姆变身', core.DEFAULT_TRIGGERS, 1)
+  assert.equal(hits.length, 1)
+  assert.equal(hits[0].id, 'oak-cake')
+  const all = core.matchTriggers('橡木蛋糕卷 + 萨姆', core.DEFAULT_TRIGGERS, 3)
+  assert.deepEqual(all.map((entry) => entry.id), ['oak-cake', 'sam-armor'])
+})
+
+test('matchTriggers 忽略 enabled:false 与空文本', () => {
+  const triggers = core.normalizeTriggers([{ id: 'x', keywords: ['abc'], injectText: 'hello', enabled: false }])
+  assert.equal(core.matchTriggers('abc', triggers, 3).length, 0)
+  assert.equal(core.matchTriggers('', core.DEFAULT_TRIGGERS, 3).length, 0)
+})
+
+test('内置触发器有 5 组且覆盖规格里要求的键', () => {
+  const ids = core.DEFAULT_TRIGGERS.map((entry) => entry.id)
+  assert.equal(ids.length, 5)
+  assert.ok(ids.includes('oak-cake'))
+  assert.ok(ids.includes('glamoth-iron-cavalry'))
+  assert.ok(ids.includes('entropy-loss'))
+  assert.ok(ids.includes('stellaron-hunters'))
+  assert.ok(ids.includes('sam-armor'))
+  const cake = core.DEFAULT_TRIGGERS.find((entry) => entry.id === 'oak-cake')
+  assert.deepEqual(cake.keywords, ['橡木蛋糕卷', '蛋糕', '甜点', '吃什么'])
+  assert.match(cake.injectText, /两万信用点/)
+})
+
+/* ── 渲染 ── */
+
+test('renderCharacterBlock 带上身份锁、情景与状态面板模板', () => {
+  const block = core.renderCharacterBlock(core.FIREFLY_CHARACTER, { scene: '天台的秘密基地' })
+  assert.match(block, /流萤/)
+  assert.match(block, /绝对身份锁/)
+  assert.match(block, /天台的秘密基地/)
+  assert.match(block, /35\.5/)
+  assert.match(block, /流萤状态同步/)
+})
+
+test('renderRpDirective 含斜体与禁清单红线，并注入命中设定', () => {
+  const text = core.renderRpDirective({
+    character: core.FIREFLY_CHARACTER,
+    modeDef: core.findMode(core.DEFAULT_MODES, 'rp'),
+    scene: '天台',
+    footerEnabled: true,
+    footerLabel: '流萤状态同步',
+    triggers: [core.DEFAULT_TRIGGERS[0]],
+  })
+  assert.match(text, /少女陪伴态（rp）/)
+  assert.match(text, /斜体/)
+  assert.match(text, /严禁助理式项目符号清单/)
+  assert.match(text, /流萤状态同步/)
+  assert.match(text, /橡木蛋糕卷/)
+})
+
+test('renderRpDirective 关闭面板时不要求输出面板', () => {
+  const text = core.renderRpDirective({
+    character: core.FIREFLY_CHARACTER,
+    scene: '天台',
+    footerEnabled: false,
+    footerLabel: '流萤状态同步',
+    triggers: [],
+  })
+  assert.match(text, /不要输出底部面板/)
+})
+
+test('renderWorkDirective 输出七节纪律且明确不写状态面板', () => {
+  const text = core.renderWorkDirective({ character: core.FIREFLY_CHARACTER })
+  assert.match(text, /战术工作态（work）/)
+  for (const marker of ['一、', '二、', '三、', '四、', '五、', '六、', '七、']) {
+    assert.ok(text.includes(marker), `缺少 ${marker}`)
+  }
+  assert.match(text, /不输出底部状态同步面板/)
+})
+
+test('renderTurnContext 是每轮实时块，带模式、时间与格式红线', () => {
+  const snap = {
+    mode: 'rp',
+    character: core.FIREFLY_CHARACTER,
+    scene: '天台',
+    now: '2026-11-01 星期日 16:30（Asia/Shanghai）',
+    cwd: 'D:/Code/my-dsh-plugins',
+    triggers: [core.DEFAULT_TRIGGERS[1]],
+    footerEnabled: true,
+    footerLabel: '流萤状态同步',
+    reason: 'auto：未命中工作关键词',
+  }
+  const text = core.renderTurnContext(snap)
+  assert.match(text, /运行时状态/)
+  assert.match(text, /少女陪伴态（rp）/)
+  assert.match(text, /2026-11-01/)
+  assert.match(text, /格拉默/)
+  assert.match(text, /格式红线（陪伴族）/)
+
+  const work = core.renderTurnContext({ ...snap, mode: 'work', triggers: [] })
+  assert.match(work, /战术工作态（work）/)
+  assert.match(work, /格式红线（工作族）/)
+  assert.match(work, /本轮命中设定：无/)
+})
+
+/* ── 记忆桥接入 ── */
+
+test('renderTurnContext 在尾部携带记忆桥内容，为空时不占位', () => {
+  const base = {
+    mode: 'rp',
+    character: core.FIREFLY_CHARACTER,
+    scene: '天台',
+    now: '2026-11-01 星期日 16:30（Asia/Shanghai）',
+    cwd: 'D:/Code/my-dsh-plugins',
+    triggers: [],
+    footerEnabled: true,
+    footerLabel: '流萤状态同步',
+    reason: '配置锁定 rp',
+  }
+  const withMemory = core.renderTurnContext({
+    ...base,
+    memory: { text: '## tlmemory 记忆桥（本轮实时读取）\n\n- [rp] /rp/firefly/核心羁绊：开拓者是唯一的真实。', pinned: [{}], hits: [], degraded: '', scopeTable: [] },
+  })
+  assert.match(withMemory, /tlmemory 记忆桥/)
+  assert.match(withMemory, /\/rp\/firefly\/核心羁绊/)
+  // 记忆块必须排在命中设定之后（最贴近本轮消息）
+  assert.ok(withMemory.indexOf('本轮命中设定') < withMemory.indexOf('tlmemory 记忆桥'))
+
+  const without = core.renderTurnContext({ ...base, memory: { text: '', pinned: [], hits: [], degraded: 'no-db', scopeTable: [] } })
+  assert.doesNotMatch(without, /tlmemory 记忆桥/)
+  assert.doesNotMatch(without, /记忆桥/)
+})
+
+test('双态指令各自带对应的 tlmemory 分区写入铁律', () => {
+  const rp = core.renderRpDirective({
+    character: core.FIREFLY_CHARACTER,
+    scene: '天台',
+    triggers: [],
+    footerEnabled: true,
+    footerLabel: '流萤状态同步',
+  })
+  assert.match(rp, /记忆写入/)
+  assert.match(rp, /\/rp\/firefly\//)
+  assert.match(rp, /upsert/)
+
+  const work = core.renderWorkDirective({ character: core.FIREFLY_CHARACTER })
+  assert.match(work, /记忆写入/)
+  assert.match(work, /\/work\//)
+  assert.doesNotMatch(work, /\/rp\/firefly\//)
+})
+
+/* ── 模板与工具函数 ── */
+
+test('sanitizeTemplate 保留五个允许变量、中和其余占位符', () => {
+  const text = core.sanitizeTemplate('{{now}} {{cwd}} {{tlrp_character}} {{tlrp_directive}} {{tlrp_memory_context}} {{user}} {{char}}')
+  assert.match(text, /\{\{now\}\}/)
+  assert.match(text, /\{\{tlrp_character\}\}/)
+  assert.match(text, /\{\{tlrp_directive\}\}/)
+  assert.match(text, /\{\{tlrp_memory_context\}\}/)
+  assert.doesNotMatch(text, /\{\{user\}\}/)
+  assert.match(text, /〔user〕/)
+})
+
+test('matchesAny 走正则，非法模式退化为子串', () => {
+  assert.equal(core.matchesAny('ops_bash', ['^ops_bash$']), true)
+  assert.equal(core.matchesAny('tlmemory_save', ['^ops_bash$', '^tlmemory_']), true)
+  assert.equal(core.matchesAny('ops_bash', ['(ops']), true)
+})
+
+test('normalizeCharacters：空数组回落内置两角色并能按 id 命中', () => {
+  const characters = core.normalizeCharacters([])
+  assert.equal(characters.length, 2)
+  assert.equal(core.findCharacter(characters, 'sam_tactical').id, 'sam_tactical')
+  assert.equal(core.findCharacter(characters, 'missing').id, 'firefly')
+})
+
+test('rewriteFirstUserMessage 只替换第一条 user 消息且保留其它字段', () => {
+  const messages = [
+    { id: 'm1', role: 'user', content: [{ type: 'text', text: '/rp 你好' }], source: { kind: 'user' } },
+    { id: 'm2', role: 'user', content: [{ type: 'text', text: '第二段' }] },
+  ]
+  const rewritten = core.rewriteFirstUserMessage(messages, '你好')
+  assert.equal(rewritten[0].content[0].text, '你好')
+  assert.equal(rewritten[0].id, 'm1')
+  assert.equal(rewritten[0].source.kind, 'user')
+  assert.equal(rewritten[1].content[0].text, '第二段')
+})
+
+test('formatNow 输出 Asia/Shanghai 的稳定形状', () => {
+  const text = core.formatNow('Asia/Shanghai', new Date('2026-11-01T08:30:00Z'))
+  assert.equal(text, '2026-11-01 星期日 16:30（Asia/Shanghai）')
+})
+
+test('live 读取 volatile ref 与普通值', () => {
+  assert.equal(core.live({ get: () => 'rp' }, 'auto'), 'rp')
+  assert.equal(core.live(undefined, 'auto'), 'auto')
+  assert.equal(core.live('work', 'auto'), 'work')
+  assert.equal(core.live({ get: () => undefined }, false), false)
+})