dsh-plugin-tlrp 0.0.0-stage → 0.3.0

package/lib/memory-bridge.cjs

@@ -0,0 +1,265 @@
+// packages/tlrp/lib/memory-bridge.cjs
+//
+// tlrp ← → tlmemory 的记忆桥。
+//
+// 为什么是「只读直连 SQLite」而不是调用 tlmemory 的 ctx 服务：
+//   1. tlrp 必须零依赖、CJS、单文件可挂载：它要在新老 DSH 上都能装，不能因为
+//      tlmemory 没装/版本不匹配就整个插件起不来；
+//   2. 只读语义足够 —— tlrp 只负责「把该在场的信息搬到台面上」，写入永远由模型
+//      通过 tlmemory_save 发起（谁拥有数据谁负责写，避免两个插件同时写同一行）；
+//   3. 驱动走 Node 内置 node:sqlite（与仓库约定一致，绝不引入 better-sqlite3 这类
+//      按 NODE_MODULE_VERSION 编译的驱动）。宿主 Node 过旧时 require 会抛错，
+//      这里全部吞掉并降级为「无记忆上下文」，绝不让记忆桥拖垮对话。
+//
+// 降级矩阵（任一不满足都只是少一段注入，不报错、不阻塞）：
+//   no-driver  宿主 Node 没有 node:sqlite
+//   no-db      库文件不存在（tlmemory 从未运行过）
+//   no-schema  tlmemory 还是 v1（没有 scope / char_id / tags 列）
+//   no-fts     memory_fts 不可用，退化为 LIKE 检索
+
+const os = require('node:os')
+const path = require('node:path')
+const fs = require('node:fs')
+
+const EXCLUDED_STATUS = "n.status NOT IN ('pending', 'merged', 'superseded')"
+
+let driver
+let driverProbed = false
+
+// 一轮里 snapshot() 会被变量 / context / guard 多次调用，每次开库太浪费。
+// 用「参数 + 文本」做键、3 秒 TTL 的短缓存：同一轮命中缓存，跨轮自然失效。
+const CACHE_TTL_MS = 3000
+let cacheKey = ''
+let cacheAt = 0
+let cacheValue = null
+
+/** 惰性探测 node:sqlite（Electron 宿主上可能不存在，绝不能放在模块顶部 require）。 */
+function loadDriver() {
+  if (driverProbed) return driver
+  driverProbed = true
+  try {
+    // eslint-disable-next-line node/no-unsupported-features/node-builtins
+    driver = require('node:sqlite')
+  } catch {
+    driver = null
+  }
+  return driver
+}
+
+function resolveDbPath(explicit) {
+  const value = String(explicit || process.env.TLMEMORY_DB || '').trim()
+  if (value) return value
+  return path.join(os.homedir(), '.dsh', 'tlmemory.db')
+}
+
+/** 打开只读库；失败返回 null（调用方按降级处理）。 */
+function openReadOnly(dbPath) {
+  const mod = loadDriver()
+  if (!mod || typeof mod.DatabaseSync !== 'function') return { handle: null, reason: 'no-driver' }
+  if (!fs.existsSync(dbPath)) return { handle: null, reason: 'no-db' }
+  try {
+    const handle = new mod.DatabaseSync(dbPath, { readOnly: true })
+    return { handle, reason: '' }
+  } catch {
+    // 只读打开失败（例如文件被独占）时再试一次常规打开：宁可短暂持写锁也不要整段失效
+    try {
+      return { handle: new mod.DatabaseSync(dbPath), reason: '' }
+    } catch {
+      return { handle: null, reason: 'no-db' }
+    }
+  }
+}
+
+/** 列探测：v1 库没有 scope/char_id/tags，必须降级而不是抛错。 */
+function hasPartitionSchema(handle) {
+  try {
+    const rows = handle.prepare('PRAGMA table_info(nodes)').all()
+    const names = new Set(rows.map((row) => String(row.name || '')))
+    return names.has('scope') && names.has('char_id') && names.has('tags')
+  } catch {
+    return false
+  }
+}
+
+function hasFts(handle) {
+  try {
+    handle.prepare('SELECT rowid FROM memory_fts LIMIT 1').all()
+    return true
+  } catch {
+    return false
+  }
+}
+
+/** 从用户本轮发言里抽 3~4 字的检索锚点（与 tlmemory 的 trigram 拆分同一口径）。 */
+function extractTerms(text, limit = 4) {
+  const out = []
+  const seen = new Set()
+  const push = (term) => {
+    const clean = String(term || '').trim()
+    if (!clean || seen.has(clean)) return
+    seen.add(clean)
+    out.push(clean)
+  }
+  for (const seg of String(text || '').split(/[^\p{L}\p{N}_]+/u)) {
+    if (!seg) continue
+    const chars = Array.from(seg)
+    if (chars.length < 3) continue // trigram 对 <3 字符不可见，短词交给模型自己表述
+    if (chars.length <= 6) {
+      push(seg)
+    } else {
+      for (let i = 0; i + 4 <= chars.length && out.length < limit; i += 3) {
+        push(chars.slice(i, i + 4).join(''))
+      }
+    }
+    if (out.length >= limit) break
+  }
+  return out.slice(0, limit)
+}
+
+function rowToItem(row) {
+  const dirPath = String(row.path || '/')
+  const name = String(row.name || '')
+  return {
+    scope: String(row.scope || ''),
+    charId: String(row.char_id || ''),
+    path: `${dirPath}${name}`,
+    content: String(row.content || '').slice(0, 240),
+  }
+}
+
+function renderItem(item) {
+  return `- [${item.scope || '?'}] ${item.path}：${item.content}`
+}
+
+/**
+ * 取本轮记忆上下文。
+ *
+ * @param {object} input
+ * @param {string} input.characterId 当前激活角色
+ * @param {'rp'|'work'|'off'} input.mode 本轮模式
+ * @param {string} [input.text] 用户本轮发言（用于关键词静默检索）
+ * @param {string} [input.dbPath] 覆盖库路径（测试/多 profile 用）
+ * @param {number} [input.pinnedLimit]
+ * @param {number} [input.hitLimit]
+ * @returns {{text:string, pinned:Array, hits:Array, degraded:string, scopeTable:string[]}}
+ */
+function readMemoryContext(input = {}) {
+  const mode = input.mode === 'work' ? 'work' : 'rp'
+  const charId = String(input.characterId || '').trim()
+  const partitions = mode === 'rp' ? ['rp', 'lore', 'core'] : ['work', 'core']
+  const dbPath = resolveDbPath(input.dbPath)
+  const empty = { text: '', pinned: [], hits: [], degraded: '', scopeTable: partitions }
+
+  const key = `${mode}|${charId}|${dbPath}|${String(input.text || '')}`
+  const at = Date.now()
+  if (cacheValue && cacheKey === key && at - cacheAt < CACHE_TTL_MS) return cacheValue
+  const remember = (value) => {
+    cacheKey = key
+    cacheAt = Date.now()
+    cacheValue = value
+    return value
+  }
+
+  const { handle, reason } = openReadOnly(dbPath)
+  if (!handle) return remember({ ...empty, degraded: reason })
+
+  try {
+    if (!hasPartitionSchema(handle)) return remember({ ...empty, degraded: 'no-schema' })
+
+    const partitionSql = `n.scope IN (${partitions.map(() => '?').join(', ')})`
+    // 角色隔离但保留共享层：char_id='' 的行（core 画像、历史迁移记忆）对所有角色可见
+    const charSql = charId ? "(n.char_id = ? OR n.char_id = '')" : '1 = 1'
+    const baseParams = charId ? [...partitions, charId] : [...partitions]
+
+    const pinnedLimit = Number.isFinite(input.pinnedLimit) ? input.pinnedLimit : 3
+    const pinnedRows = handle
+      .prepare(
+        `SELECT n.scope, n.char_id, n.path, n.name, n.content
+           FROM nodes n
+          WHERE n.is_pinned = 1 AND n.is_leaf = 1 AND ${partitionSql} AND ${charSql} AND ${EXCLUDED_STATUS}
+          ORDER BY n.updated_at DESC
+          LIMIT ${pinnedLimit}`,
+      )
+      .all(...baseParams)
+
+    const pinned = pinnedRows.map(rowToItem)
+
+    const terms = extractTerms(input.text)
+    let hits = []
+    if (terms.length > 0) {
+      const hitLimit = Number.isFinite(input.hitLimit) ? input.hitLimit : 3
+      const pinnedPaths = new Set(pinned.map((item) => item.path))
+      if (hasFts(handle)) {
+        const match = terms.map((term) => `"${term.replace(/"/g, '""')}"`).join(' OR ')
+        const rows = handle
+          .prepare(
+            `SELECT n.scope, n.char_id, n.path, n.name, n.content
+               FROM memory_fts
+               JOIN nodes n ON n.id = memory_fts.rowid
+              WHERE memory_fts MATCH ? AND ${partitionSql} AND ${charSql} AND ${EXCLUDED_STATUS}
+              ORDER BY n.is_pinned DESC, bm25(memory_fts, 0.2, 2.0, 1.5, 1.0, 1.5, 3.0)
+              LIMIT ${hitLimit + pinned.length}`,
+          )
+          .all(match, ...baseParams)
+        hits = rows.map(rowToItem).filter((item) => !pinnedPaths.has(item.path)).slice(0, hitLimit)
+      } else {
+        const like = terms.map(() => 'n.content LIKE ?').join(' OR ')
+        const rows = handle
+          .prepare(
+            `SELECT n.scope, n.char_id, n.path, n.name, n.content
+               FROM nodes n
+              WHERE (${like}) AND n.is_leaf = 1 AND ${partitionSql} AND ${charSql} AND ${EXCLUDED_STATUS}
+              ORDER BY n.is_pinned DESC, n.updated_at DESC
+              LIMIT ${hitLimit + pinned.length}`,
+          )
+          .all(...terms.map((term) => `%${term}%`), ...baseParams)
+        hits = rows.map(rowToItem).filter((item) => !pinnedPaths.has(item.path)).slice(0, hitLimit)
+      }
+    }
+
+    const text = renderMemoryBlock({ pinned, hits, mode, charId })
+    return remember({ text, pinned, hits, degraded: '', scopeTable: partitions })
+  } catch (error) {
+    return remember({ ...empty, degraded: `error:${String(error && error.message ? error.message : error).slice(0, 120)}` })
+  } finally {
+    try {
+      handle.close()
+    } catch {
+      /* 关闭失败不影响本轮结果 */
+    }
+  }
+}
+
+/** 渲染成可直接塞进提示词的一段文本（空记忆时返回空串，不占上下文）。 */
+function renderMemoryBlock({ pinned, hits, mode, charId }) {
+  if (pinned.length === 0 && hits.length === 0) return ''
+  const lines = ['## tlmemory 记忆桥（本轮实时读取）']
+  if (pinned.length > 0) {
+    lines.push('', '### 常驻记忆（pinned，每轮必带，不需要检索就能看到）')
+    for (const item of pinned) lines.push(renderItem(item))
+  }
+  if (hits.length > 0) {
+    lines.push('', '### 本轮命中的相关记忆（关键词静默检索）')
+    for (const item of hits) lines.push(renderItem(item))
+  }
+  lines.push(
+    '',
+    '使用规则：以上是**已经落库的事实**，可以自然引用、不要当成待验证的猜测；与库中记录冲突的临时说法以库为准。',
+  )
+  if (mode === 'rp') {
+    lines.push(
+      `- 本轮新出现的重要互动、约定、情绪变化：用 tlmemory_save 写入 /rp/${charId || '<char>'}/... 分区（tags 给 3~5 个 ≥3 字词）。`,
+    )
+  } else {
+    lines.push('- 本轮产生的技术结论：用 tlmemory_save 写入 /work/... 分区；同一主题复用同一 path 让 upsert 自动收敛。')
+  }
+  return lines.join('\n')
+}
+
+module.exports = {
+  readMemoryContext,
+  renderMemoryBlock,
+  extractTerms,
+  resolveDbPath,
+  loadDriver,
+}

package/lib/resolve.cjs

@@ -0,0 +1,74 @@
+'use strict'
+
+/**
+ * 在不引入任何依赖的前提下解析宿主的 `@deepseek-ai/schemastery`。
+ *
+ * 为什么需要它：插件可能以 `file:` / `link:`（软链）方式装进 profile，
+ * 也可能被 pnpm 实体拷贝到 `<profile>/node_modules/dsh-plugin-tlrp`。前者按
+ * realpath 解析，裸 import 找不到宿主依赖；后者可以。这里按「自身 → 当前
+ * profile → 已知 profile → profile 级 node_modules」的顺序逐个尝试，
+ * 全部失败时返回 undefined，插件退化为「无 Config schema」仍可运行。
+ */
+
+const { createRequire } = require('node:module')
+const path = require('node:path')
+const os = require('node:os')
+
+const SPECIFIER = '@deepseek-ai/schemastery'
+
+/** 可能的解析基点（package.json 或任意文件路径）。 */
+function candidateBases() {
+  const bases = []
+  const profileDir = process.env.DSH_PROFILE_DIR
+  if (typeof profileDir === 'string' && profileDir.trim()) bases.push(path.join(profileDir, 'package.json'))
+  const home = os.homedir()
+  const profile = process.env.DSH_PROFILE
+  if (typeof profile === 'string' && profile.trim()) bases.push(path.join(home, '.dsh', 'profiles', profile, 'package.json'))
+  for (const known of ['desktop', 'web', 'default']) {
+    bases.push(path.join(home, '.dsh', 'profiles', known, 'package.json'))
+  }
+  bases.push(path.join(home, '.dsh', 'profiles', 'node_modules', 'noop.js'))
+  return bases
+}
+
+/**
+ * 尝试解析 schemastery。
+ * @param {NodeRequire} [fallbackRequire] 调用方自带的 require（CJS 入口直接传 require）
+ * @returns {{ z: any, attempts: string[], source: string }}
+ */
+function loadSchemastery(fallbackRequire) {
+  const attempts = []
+
+  const attempt = (loader, label) => {
+    try {
+      const mod = loader(SPECIFIER)
+      const z = mod && (mod.default ?? mod)
+      if (z && typeof z.object === 'function') return z
+      attempts.push(`${label}: 导出里没有 object()`)
+    } catch (error) {
+      attempts.push(`${label}: ${(error && (error.code || error.message)) || error}`)
+    }
+    return undefined
+  }
+
+  if (typeof fallbackRequire === 'function') {
+    const direct = attempt(fallbackRequire, 'self')
+    if (direct) return { z: direct, attempts, source: 'self' }
+  }
+
+  for (const base of candidateBases()) {
+    let req
+    try {
+      req = createRequire(base)
+    } catch (error) {
+      attempts.push(`${base}: ${(error && error.message) || error}`)
+      continue
+    }
+    const found = attempt(req, base)
+    if (found) return { z: found, attempts, source: base }
+  }
+
+  return { z: undefined, attempts, source: '(none)' }
+}
+
+module.exports = { loadSchemastery, candidateBases, SPECIFIER }

package/lib/schema.cjs

@@ -0,0 +1,188 @@
+'use strict'
+
+/**
+ * tlrp 的 Cordis Config（Schemastery）。
+ *
+ * 这个 schema 同时就是「设置界面」：`@deepseek-ai/dsh-settings` 只把
+ * `.volatile()` 字段投影成表单，也只允许写 volatile 路径，所以所有需要
+ * 在设置面板里改、或者需要被 `/rp` `/work` `/char` `/scene` 指令改的字段
+ * 一律标 `.volatile()`。
+ *
+ * `.volatile()` 之后字段的解析结果是 live ref（`{ get() }`），运行期读数
+ * 必须走 `core.live()`，否则热更新看到的是启动时的旧快照。
+ */
+
+const core = require('./core.cjs')
+
+/**
+ * 构建 Config schema。
+ * @param {any} z `@deepseek-ai/schemastery` 的导出（默认导出）
+ * @returns {any} Schemastery schema
+ */
+function buildConfig(z) {
+  const characterShape = z.object({
+    id: z.string().default(''),
+    name: z.string().default(''),
+    userTitle: z.string().default(''),
+    identityLock: z.string().default(''),
+    corePersona: z.string().default(''),
+    defaultScene: z.string().default(''),
+    appearanceAndSensory: z.string().default(''),
+    actionPresets: z.string().default(''),
+    speechStyle: z.string().default(''),
+    dialogueExamples: z.string().default(''),
+    statusFooterTemplate: z.string().default(''),
+  })
+
+  const triggerShape = z.object({
+    id: z.string().default(''),
+    characterId: z.string().default(''),
+    keywords: z.array(z.string()).default([]),
+    injectText: z.string().default(''),
+    priority: z.number().default(0),
+    enabled: z.boolean().default(true),
+  })
+
+  const modeShape = z.object({
+    id: z.string().default(''),
+    name: z.string().default(''),
+    commandAliases: z.array(z.string()).default([]),
+    autoKeywords: z.string().default(''),
+    autoPriority: z.number().default(50),
+    directivePrompt: z.string().default(''),
+    toolPolicy: z.union(['allow_all', 'whitelist_only', 'block_all']).default('allow_all'),
+    allowedTools: z.string().default(''),
+    injectCharacterPersona: z.boolean().default(true),
+    enableStatusFooter: z.boolean().default(true),
+    statusFooterOverride: z.string().default(''),
+    bindCharacterId: z.string().default(''),
+    isDefaultFallback: z.boolean().default(false),
+    styleLayer: z
+      .union(['inherit', 'on', 'off'])
+      .default('inherit')
+      .description('风格层开关（只带语言风格，不演动作）：on 强制开、off 强制关、inherit 跟随全局 styleLayerDefault。'),
+  })
+
+  return z.object({
+    /* ── 设置面板字段（全部 volatile） ── */
+    enabled: z
+      .boolean()
+      .default(true)
+      .description('插件总开关。关闭后不注入任何角色、形态约束与工具拦截。')
+      .volatile(),
+    mode: z
+      .string()
+      .default('auto')
+      .description('路由锁定：auto 按各形态的 autoKeywords 自动分流；填任意已注册形态 id 则锁死在该形态。聊天里用 /auto、/mode <id> 或形态别名切换。')
+      .volatile(),
+    modes: z
+      .array(modeShape)
+      .default(core.DEFAULT_MODES.map((entry) => ({ ...entry, commandAliases: [...entry.commandAliases] })))
+      .description('运行形态矩阵：每个形态含 id / name / commandAliases / autoKeywords / autoPriority / directivePrompt / toolPolicy / allowedTools / injectCharacterPersona / enableStatusFooter / statusFooterOverride / bindCharacterId / isDefaultFallback。增删改后即时生效。')
+      .volatile(),
+    activeCharacterId: z
+      .string()
+      .default('firefly')
+      .description('当前激活的预设角色 ID（见 characters）。聊天里用 /char <id> 切换。')
+      .volatile(),
+    workModeKeywords: z
+      .union([z.string(), z.array(z.string())])
+      .default(core.DEFAULT_WORK_KEYWORDS)
+      .description('（0.2.0 兼容字段）行为族为 work 的形态若没写自己的 autoKeywords，则用这里的关键词做自动分流。新形态请直接在形态自己的 autoKeywords 里配置。')
+      .volatile(),
+    blockShellToolsInRp: z
+      .boolean()
+      .default(true)
+      .description('（0.2.0 兼容字段）行为族为 rp 的形态在 whitelist_only 策略下是否物理拦截工具；0.3.0 起建议改用形态自己的 toolPolicy。')
+      .volatile(),
+    enableStatusFooter: z
+      .boolean()
+      .default(true)
+      .description('状态面板总开关；与形态自己的 enableStatusFooter 取「与」。')
+      .volatile(),
+    customSceneOverride: z
+      .string()
+      .default('')
+      .description('当前临时覆盖的剧情情景；留空则使用角色的 defaultScene。聊天里用 /scene <描述> 覆盖。')
+      .volatile(),
+    characters: z
+      .array(characterShape)
+      .default(core.DEFAULT_CHARACTERS.map((entry) => ({ ...entry })))
+      .description('多角色预设库。每个角色含 id / name / userTitle / identityLock / defaultScene / appearanceAndSensory / actionPresets / speechStyle / statusFooterTemplate。')
+      .volatile(),
+    triggers: z
+      .array(triggerShape)
+      .default(core.DEFAULT_TRIGGERS.map((entry) => ({ ...entry, keywords: [...entry.keywords] })))
+      .description('提示词触发映射表（动态世界书）：命中 keywords 即把 injectText 注入本轮上下文。')
+      .volatile(),
+
+    /* ── 风格层：只带语言风格 + 表情 + 本地表情包/图库 ── */
+    styleLayerDefault: z
+      .union(['on', 'off'])
+      .default('off')
+      .description('风格层全局默认开关：形态自己的 styleLayer 没写 on/off 时按这里走。聊天里用 /style on|off|default 临时改本会话。')
+      .volatile(),
+    styleEmojiHint: z
+      .string()
+      .default('允许适度使用 emoji：一屏最多 2 个，放在句尾，不堆在句首，也不用 emoji 替代文字。')
+      .description('风格层的表情规范；留空则完全不出现 emoji。')
+      .volatile(),
+    stickerDir: z
+      .string()
+      .default('')
+      .description('本地表情包库目录；留空为 ~/.dsh/stickers。子目录名即角色 id，图片文件名即贴纸标签（如 开心.png → 标签「开心」）。')
+      .volatile(),
+    galleryDir: z
+      .string()
+      .default('')
+      .description('本地图库目录；留空为 ~/.dsh/gallery。图片文件名即图片标签，供「给我看图」这类请求使用。')
+      .volatile(),
+    maxStickersPerTurn: z
+      .number()
+      .default(2)
+      .description('单轮最多贴几张表情包或图片（0 = 只准用文字描述，不许贴图）。')
+      .volatile(),
+
+    /* ── 以下为普通配置（通过 profile 的 cordis.patch.yml 调整） ── */
+    timeZone: z.string().default('Asia/Shanghai').description('{{now}} 与状态块使用的时区。'),    statusFooterLabel: z.string().default('流萤状态同步').description('底部状态面板的标题标签。'),
+    registerNowVariable: z
+      .union(['auto', 'off'])
+      .default('auto')
+      .description('是否尝试注册 {{now}} / {{cwd}}：auto 表示已被 prompt-clock 占用时自动让位，off 表示完全不注册。'),
+    enableMemoryBridge: z
+      .boolean()
+      .default(true)
+      .description('是否每轮从 tlmemory 的 SQLite 只读读取常驻羁绊（pinned）与关键词命中；驱动缺失或库不存在时自动降级为空。'),
+    memoryDbPath: z
+      .string()
+      .default('')
+      .description('tlmemory 数据库路径；留空则依次取环境变量 TLMEMORY_DB、~/.dsh/tlmemory.db。'),
+    coreSectionEnabled: z.boolean().default(true).description('是否注册 {{tlrp_character}} / {{tlrp_directive}} 所在的核心 prompt section。'),
+    coreSectionOrder: z.number().default(10150).description('核心 section 的排序位置（默认在 first-party 指引之后、persona suffix 之前）。'),
+    coreSectionText: z
+      .string()
+      .default('## tlrp 角色与形态装配\n当前时间：{{now}}\n工作目录：{{cwd}}\n\n{{tlrp_character}}\n\n{{tlrp_directive}}')
+      .description('核心 section 的模板；只允许 {{now}} / {{cwd}} / {{tlrp_character}} / {{tlrp_directive}} / {{tlrp_memory_context}} 五个占位符，其余会被中和。'),
+    contextOrder: z.number().default(300).description('每轮尾部实时状态块的 context 排序位置。'),
+    maxTriggerInjections: z.number().default(3).description('单轮最多注入多少组触发器（上限 8）。'),
+    blockedToolPatterns: z
+      .array(z.string())
+      .default([...core.DEFAULT_BLOCKED_TOOL_PATTERNS])
+      .description('RP 态下要拦截的工具名正则（deny 语义）。'),
+    allowedToolPatterns: z
+      .array(z.string())
+      .default([...core.DEFAULT_ALLOWED_TOOL_PATTERNS])
+      .description('无论什么模式都放行的工具名正则（allow 语义，优先于 deny）。'),
+    activeProfileEntryId: z
+      .string()
+      .default('tlrp')
+      .description('settings.mutate 使用的 profile 条目 id；改 bundle 行 id 时必须同步。'),
+    rpAllowedTools: z
+      .string()
+      .default(core.DEFAULT_RP_ALLOWED_TOOLS)
+      .description('RP 态放行的工具白名单（逗号分隔的工具名或前缀，默认 tlmemory / ask_user_question / schedule）。命中即放行，优先于拦截规则。')
+      .volatile(),
+  })
+}
+
+module.exports = { buildConfig }

package/locale/en.json

@@ -0,0 +1,19 @@
+{
+  "meta": {
+    "title": "TLRP · Multi-Mode Matrix Engine",
+    "description": "Registers the tlrp settings namespace, an editable matrix of runtime modes, /mode and per-mode alias commands, live {{tlrp_character}} / {{tlrp_directive}} / {{now}} prompt variables, a per-turn tail status block, and physical tool gating driven by each mode's toolPolicy."
+  },
+  "command": {
+    "mode": "Switch to a runtime mode (/mode <mode-id>; auto restores routing)",
+    "rp": "Switch to the companion mode",
+    "work": "Switch to tactical work mode",
+    "sam": "Switch to SAM assault mode",
+    "sleep": "Switch to the medbay mode",
+    "auto": "Restore automatic semantic routing",
+    "char": "Switch the active preset character",
+    "scene": "Override the current scene",
+    "title": "Rename how the active character addresses you",
+    "trigger": "Add a keyword trigger mapping",
+    "tlrp": "Show tlrp status: current mode, routing chain, character, scene, enabled triggers"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,19 @@
+{
+  "meta": {
+    "title": "TLRP · 多形态矩阵引擎",
+    "description": "注册 tlrp 设置命名空间、可自由增删的 modes 形态矩阵、/mode 与形态别名指令、{{tlrp_character}} / {{tlrp_directive}} / {{now}} 动态提示变量、每轮尾部实时状态块，并按各形态的 toolPolicy 物理拦截工具。"
+  },
+  "command": {
+    "mode": "切换到指定运行形态（/mode <形态ID>；auto 恢复自动路由）",
+    "rp": "切换到少女陪伴态",
+    "work": "切换到战术工作态",
+    "sam": "切换到萨姆强袭态",
+    "sleep": "切换到医疗舱微凉态",
+    "auto": "恢复自动语义分流",
+    "char": "切换当前激活的预设角色",
+    "scene": "覆盖当前所处情景",
+    "title": "修改当前角色对对方的专属称呼",
+    "trigger": "新增一组关键词触发映射",
+    "tlrp": "查看 tlrp 状态：当前形态、路由链路、角色、情景、已启用触发器"
+  }
+}

package/package.json

@@ -1,6 +1,75 @@
 {
   "name": "dsh-plugin-tlrp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.0",
+  "description": "DSH 核心角色扮演与多形态矩阵引擎：注册 tlrp 设置命名空间、可自由增删的 modes 形态矩阵、/mode 与形态别名指令拦截、{{tlrp_character}}/{{tlrp_directive}}/{{tlrp_memory_context}}/{{now}} 动态变量、每轮尾部实时状态与 tlmemory 记忆桥注入，并按形态的 toolPolicy 物理拦截工具。",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "icon": "./icon.svg",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.cjs"
+    },
+    "./client": {
+      "default": "./client.js"
+    },
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "index.cjs",
+    "client.js",
+    "lib/core.cjs",
+    "lib/schema.cjs",
+    "lib/resolve.cjs",
+    "lib/memory-bridge.cjs",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "scripts/install-into-profile.mjs",
+    "scripts/apply-check.mjs",
+    "scripts/mutate-check.mjs",
+    "scripts/rewrite-persona.mjs",
+    "scripts/client-check.mjs",
+    "test/core.test.mjs",
+    "test/memory-bridge.test.mjs"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "dsh-bundle",
+    "roleplay",
+    "system-prompt",
+    "tlrp"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-plugin-manager"
+      ]
+    }
+  },
+  "scripts": {
+    "test": "node --test test/core.test.mjs test/memory-bridge.test.mjs",
+    "check:apply": "node scripts/apply-check.mjs",
+    "check:mutate": "node scripts/mutate-check.mjs",
+    "check:client": "node scripts/client-check.mjs",
+    "install:profile": "node scripts/install-into-profile.mjs"
+  }
 }