prts-terrarchive 0.2.0

package/bin/install.js

@@ -0,0 +1,273 @@
+#!/usr/bin/env node
+/**
+ * prts-terrarchive 一键安装脚本。
+ *
+ * 用法：
+ *   node bin/install.js web                 # 从当前插件源码目录安装
+ *   node bin/install.js web /path/to/pkg    # 安装指定本地目录或压缩包
+ *   node bin/install.js web --preset-only   # 旧版打包器已放置插件，只生成/迁移预设
+ *
+ * 环境变量：
+ *   DSH_HOME   宿主根目录（缺省 ~/.dsh）；DSH 插件命令（缺省 dsh）
+ *   PRTS_DSH_VERSION  仅 --preset-only：可显式指定打包目标的 DSH 版本，且不调用 dsh
+ *
+ * 做什么：
+ *   1) 把插件加入 profile（dsh plugin add）
+ *   2) DSH 0.1.7 起由插件注册「PRTS 模式」；旧版创建用户预设
+ *      （$DSH_HOME/.agent-presets/prts/*），且只有选中该模式才加载语料工具
+ *   3) 打印后续指引（如何设为默认模式）
+ *
+ * 说明：资料管理（设置页 /api + UI）由插件 host 常驻提供；语料三工具由
+ * PRTS 预设加载——标准/极简等其它模式不加载 PRTS 工具。
+ */
+import { execFileSync } from 'node:child_process'
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const packageDir = resolve(here, '..')
+const packageMetadata = JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf8'))
+const argv = process.argv.slice(2)
+const presetOnly = argv.includes('--preset-only')
+const knownFlags = new Set(['--preset-only'])
+const unknownFlag = argv.find((arg) => arg.startsWith('-') && !knownFlags.has(arg))
+if (unknownFlag) throw new Error(`未知选项：${unknownFlag}`)
+const positionalArgs = argv.filter((arg) => !knownFlags.has(arg))
+if (positionalArgs.length > 2) throw new Error('位置参数过多')
+const profile = positionalArgs[0] || 'web'
+if (profile.toLowerCase() === 'desktop' && !presetOnly) {
+  throw new Error('官方 DSH Desktop 的 desktop profile 由应用管理，请在桌面插件管理窗口安装 prts-terrarchive；npm 发布前请使用 Web 本地安装或 Portable。--preset-only 仅供已放置插件的发行版打包器使用。')
+}
+const pkg = positionalArgs[1] ? resolve(positionalArgs[1]) : packageDir
+if (!presetOnly && !existsSync(pkg)) {
+  throw new Error(`本地插件目录或压缩包不存在：${pkg}`)
+}
+if (!profile || profile === '.' || profile === '..' || profile === 'node_modules'
+    || profile.startsWith('-') || profile.includes('/') || profile.includes('\\')
+    || /[\u0000-\u001f\u007f]/u.test(profile)) {
+  throw new Error(`DSH profile 名称非法：${JSON.stringify(profile)}`)
+}
+const dshHome = process.env.DSH_HOME || join(homedir(), '.dsh')
+const dshCmd = process.env.DSH || 'dsh'
+
+const PRESET_ID = 'prts'
+const presetDir = join(dshHome, '.agent-presets', PRESET_ID)
+const compositionPath = join(presetDir, 'agent.cordis.yml')
+const metadataPath = join(presetDir, 'preset.yml')
+
+// 预设组合：以 bare 包名加载本插件（dsh plugin add 安装后即可解析，可移植），
+// 注册语料工具（registerTools:true）；registerUi:false 让资料管理 API/设置 UI
+// 归 host 常驻那份，预设只注册工具，避免重复注册 /api/prts-corpus 路由。
+const bundledPreset = join(packageDir, 'presets', PRESET_ID)
+const PRESET_COMPOSITION = readFileSync(join(bundledPreset, 'agent.cordis.yml'), 'utf8')
+const PRESET_METADATA = readFileSync(join(bundledPreset, 'preset.yml'), 'utf8')
+
+function run(cmd, args, stdio = 'inherit') {
+  if (process.platform === 'win32') {
+    // dsh 在 Windows 上通常是 .cmd，必须经 shell 执行；此时 execFileSync 会把
+    // 参数拼成一条命令行，含空格的路径用双引号包裹。cmd.exe 的引用规则无法
+    // 在双引号内屏蔽 %VAR% 展开与 & | < > ^ 等元字符——与其静默炸裂，不如
+    // 预检后明确报错，让用户换路径或用 DSH 环境变量指向 dsh.cmd 绝对路径。
+    const unsafe = /[\r\n%!&|<>^"]/
+    for (const value of [cmd, ...args]) {
+      if (unsafe.test(String(value))) {
+        throw new Error(
+          `Windows cmd 无法安全传递含特殊字符的参数：「${value}」。` +
+          '请把插件放到不含换行及 % ! & | < > ^ " 的路径后重试，或设置环境变量 DSH 指向 dsh.cmd 的绝对路径。')
+      }
+    }
+    const quote = (value) => `"${String(value)}"`
+    return execFileSync(quote(cmd), args.map(quote), {
+      stdio, encoding: 'utf8', shell: true, env: process.env,
+    })
+  }
+  return execFileSync(cmd, args, { stdio, encoding: 'utf8', env: process.env })
+}
+
+function usesDeclarativePresets(version) {
+  const match = /^\s*(?:dsh\s+)?(\d+)\.(\d+)\.(\d+)(?:[-+]|\s|$)/u.exec(version)
+  // Old launchers (and legacy package fixtures) may print no version at all.
+  if (!match && !version.trim()) return false
+  if (!match) throw new Error(`无法识别 DSH 版本：${JSON.stringify(version.trim())}`)
+  const [, major, minor, patch] = match.map(Number)
+  return major > 0 || minor > 1 || (minor === 1 && patch >= 7)
+}
+
+const CONFIG_KEY = /^ {2}(?:config|'config'|"config")[ \t]*:/u
+const BLOCK_CONFIG = /^ {2}(?:config|'config'|"config")[ \t]*:[ \t]*(?:#[^\r\n]*)?\r?$/u
+const ENABLED_GAMES_KEY = /^ {4}(?:enabledGames|'enabledGames'|"enabledGames")[ \t]*:/u
+
+function presetEntryEnd(lines, start) {
+  // YAML mapping key order is not fixed: the next plugin may start with name,
+  // config, or an anchor. Any top-level sequence item ends this entry's scope.
+  const next = lines.findIndex((line, index) => index > start && /^-(?:\s|$)/u.test(line))
+  return next < 0 ? lines.length : next
+}
+
+function isStandardBlockConfig(lines, configIndex, end) {
+  if (!BLOCK_CONFIG.test(lines[configIndex])) return false
+  for (let index = configIndex + 1; index < end; index += 1) {
+    if (/^\s*(?:#.*)?$/u.test(lines[index])) continue
+    const indentation = /^ */u.exec(lines[index])[0].length
+    // 不把自定义缩进中的字段挤到安装器使用的四空格层级。
+    return indentation <= 2 || indentation === 4
+  }
+  return true
+}
+
+// 只改安装器使用的块映射；用户写成行内映射、alias 或 anchor 时保留原文。
+// 在没有完整 YAML parser 的安装环境里，不能把不认识的写法当成缺失键。
+/** 在已有 PRTS preset 中启用 DSH 安全 provider 支撑的 web_fetch，不触碰其他 entry。 */
+function enableSafeWebFetch(composition) {
+  const lines = composition.split('\n')
+  const start = lines.findIndex((line) => /^- id: tool-web\s*$/.test(line))
+  if (start < 0) return composition
+  const end = presetEntryEnd(lines, start)
+  const configIndex = lines.findIndex((line, index) => index > start && index < end
+    && CONFIG_KEY.test(line))
+  if (configIndex >= 0 && !isStandardBlockConfig(lines, configIndex, end)) return composition
+  const fetchIndex = lines.findIndex((line, index) => index > start && index < end
+    && /^ {4}(?:fetch|'fetch'|"fetch")[ \t]*:/u.test(line))
+  if (fetchIndex >= 0) {
+    lines[fetchIndex] = '    fetch: true'
+    return lines.join('\n')
+  }
+  if (configIndex >= 0) lines.splice(configIndex + 1, 0, '    fetch: true')
+  else lines.splice(end, 0, '  config:', '    fetch: true')
+  return lines.join('\n')
+}
+
+/** 为安装器生成的双游戏云端 preset 显式固定本地资料范围。 */
+function enableDualGameModules(composition) {
+  const lines = composition.split('\n')
+  const start = lines.findIndex((line) => /^- id: prts-corpus\s*$/.test(line))
+  if (start < 0) return composition
+  const end = presetEntryEnd(lines, start)
+  const block = lines.slice(start, end)
+  if (block.some((line) => ENABLED_GAMES_KEY.test(line))) return composition
+  if (block.some((line) => CONFIG_KEY.test(line) && !BLOCK_CONFIG.test(line))) return composition
+  const usesDefaultDualCloud = block.some((line) => /^\s{6}baseUrl:\s*https:\/\/prts\.chat\s*$/u.test(line))
+    && block.some((line) => /^\s{6}game:\s*all\s*$/u.test(line))
+  if (!usesDefaultDualCloud) return composition
+  const registerUi = lines.findIndex((line, index) => index > start && index < end
+    && /^\s{4}registerUi:\s*/u.test(line))
+  const registerTools = lines.findIndex((line, index) => index > start && index < end
+    && /^\s{4}registerTools:\s*/u.test(line))
+  const insertAfter = registerUi >= 0 ? registerUi : registerTools
+  if (insertAfter < 0) return composition
+  lines.splice(insertAfter + 1, 0, '    enabledGames:', '      - arknights', '      - endfield')
+  return lines.join('\n')
+}
+
+/** 让独立 Skill entry 与安装器生成的双模块工具 entry 使用同一基础范围。 */
+function enableDualSkillModules(composition) {
+  const lines = composition.split('\n')
+  const start = lines.findIndex((line) => /^- id: prts-retrieval-skill\s*$/u.test(line))
+  if (start < 0) return composition
+  const end = presetEntryEnd(lines, start)
+  if (lines.slice(start, end).some((line) => ENABLED_GAMES_KEY.test(line))) return composition
+  const nameIndex = lines.findIndex((line, index) => index > start && index < end
+    && /^\s{2}name:\s*prts-terrarchive\/skill\s*$/u.test(line))
+  if (nameIndex < 0) return composition
+  const configIndex = lines.findIndex((line, index) => index > start && index < end
+    && CONFIG_KEY.test(line))
+  if (configIndex >= 0) {
+    if (!isStandardBlockConfig(lines, configIndex, end)) return composition
+    lines.splice(configIndex + 1, 0, '    enabledGames:', '      - arknights', '      - endfield')
+  } else {
+    lines.splice(nameIndex + 1, 0, '  config:', '    enabledGames:',
+      '      - arknights', '      - endfield')
+  }
+  return lines.join('\n')
+}
+
+function migrateLegacyCloudGame(composition) {
+  const lines = composition.split('\n')
+  const start = lines.findIndex((line) => /^- id: prts-corpus\s*$/u.test(line))
+  if (start < 0) return composition
+  const end = presetEntryEnd(lines, start)
+  const entry = lines.slice(start, end).join('\n').replace(
+    /(\s{4}cloud:\r?\n\s{6}baseUrl:\s*https:\/\/prts\.chat\r?\n\s{6}game:\s*)arknights\b/u,
+    '$1all',
+  )
+  return [...lines.slice(0, start), entry, ...lines.slice(end)].join('\n')
+}
+
+console.log(`prts-terrarchive 一键安装 → profile「${profile}」`)
+
+if (!presetOnly) {
+  console.log('\n[1/2] 把插件加入 profile（dsh plugin add）…')
+  try {
+    run(dshCmd, ['plugin', '--profile', profile, 'add', pkg])
+    console.log('  已加入。')
+  } catch (error) {
+    console.error(`  安装失败（${String(error?.message ?? error).split('\n')[0]}）。`)
+    console.error(`  请修复后重试：${dshCmd} plugin --profile ${profile} add ${pkg}`)
+    process.exitCode = 1
+    throw error
+  }
+} else {
+  console.log('\n[1/2] 插件实体由发行版管理，跳过 dsh plugin add。')
+}
+
+// --preset-only is used by offline legacy packagers: never invoke dsh there.
+// A packager targeting modern DSH can declare the exact version explicitly.
+const dshVersion = presetOnly ? (process.env.PRTS_DSH_VERSION || '') : run(dshCmd, ['--version'], 'pipe')
+if (usesDeclarativePresets(dshVersion)) {
+  console.log('\n[2/2] 当前 DSH 使用声明式预设；PRTS 模式由插件自动注册，无需写入旧版用户预设文件。')
+  console.log('\n完成。重启 dsh，在新会话中选择「PRTS 模式」。')
+} else {
+  console.log('\n[2/2] 创建 PRTS 用户预设…')
+  mkdirSync(presetDir, { recursive: true })
+  // 各文件独立修复；已存在的组合只迁移本插件旧 guidance，并补齐网页工具和 Skill loader，
+  // 不覆盖其它用户改动。
+  if (!existsSync(compositionPath)) {
+    writeFileSync(compositionPath, PRESET_COMPOSITION)
+  } else {
+    const existing = readFileSync(compositionPath, 'utf8')
+    let migrated = existing.replace(
+      /- id: prts-corpus-guidance\r?\n\s+name: prts-terrarchive\/guidance/g,
+      '- id: prts-retrieval-skill\n  name: prts-terrarchive/skill',
+    )
+    // 0.1.0-alpha.1 的官方预设曾把基础层锁死为 arknights，使新版
+    // enabledGames 在无用户层配置时无法默认双游戏。只迁移本安装器生成的
+    // 标准 baseUrl + game 片段；自定义云端地址和其他 preset 不受影响。
+    migrated = migrateLegacyCloudGame(migrated)
+    migrated = enableDualGameModules(migrated)
+    migrated = enableSafeWebFetch(migrated)
+    // Web 搜索 provider 留在 DSH Web host；preset 只需挂载稳定的模型工具。
+    if (!/^- id: tool-web\s*$/m.test(migrated)) {
+      const toolWeb = "- id: tool-web\n  name: '@deepseek-ai/dsh-tool-web'\n  config:\n    fetch: true\n    searchTimeoutMs: 60000\n"
+      const toolSkillAnchor = /^- id: tool-skill\s*$/m
+      const retrievalSkillAnchor = /^- id: prts-retrieval-skill\s*$/m
+      migrated = toolSkillAnchor.test(migrated)
+        ? migrated.replace(toolSkillAnchor, `${toolWeb}- id: tool-skill`)
+        : retrievalSkillAnchor.test(migrated)
+          ? migrated.replace(retrievalSkillAnchor, `${toolWeb}- id: prts-retrieval-skill`)
+          : `${migrated.trimEnd()}\n${toolWeb}`
+    }
+    // DSH Web 把宿主层 tool-skill 禁用，由每个 agent preset 自行挂载。
+    // 旧 PRTS preset 只有 Skill 注册项，没有 catalog/loader，模型看不到也无法加载 Skill。
+    if (!/^- id: tool-skill\s*$/m.test(migrated)) {
+      const toolSkill = "- id: tool-skill\n  name: '@deepseek-ai/dsh-tool-skill'\n"
+      const skillAnchor = /^- id: prts-retrieval-skill\s*$/m
+      migrated = skillAnchor.test(migrated)
+        ? migrated.replace(skillAnchor, `${toolSkill}- id: prts-retrieval-skill`)
+        : `${migrated.trimEnd()}\n${toolSkill}`
+    }
+    migrated = enableDualSkillModules(migrated)
+    if (migrated !== existing) writeFileSync(compositionPath, migrated)
+  }
+  if (!existsSync(metadataPath)) writeFileSync(metadataPath, PRESET_METADATA)
+  console.log(`  已确保预设文件存在（仅自动迁移本插件旧检索指导）：${presetDir}`)
+
+  console.log('\n完成。重启 dsh 后：')
+  console.log('  · 设置 → 插件 →「PRTS 语料」= 资料管理（host 常驻，始终可进）')
+  console.log('  · 新建会话顶部的模式下拉选「PRTS 模式」→ 加载语料三工具')
+  console.log('  · 标准/极简等其它模式不加载 PRTS 工具')
+  console.log(`  · 以后执行 dsh plugin update 后，可运行本命令加 --preset-only 同步预设迁移`)
+  console.log(`  · 卸载：${dshCmd} plugin --profile ${profile} remove ${packageMetadata.name}`)
+  console.log(`  · 想让新会话默认就用 PRTS 模式：设置 → Agent 预设 → 设为默认`)
+}

package/bin/pack-map-assets.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * 预压缩终末地地图资源（与 endfield.prts.chat 前端 scripts/precompress.mjs
+ * 同一方法）：对 map.js 与 resources/*.json 生成 brotli(q9, TEXT) 与 gzip(9)
+ * 两种压缩副本，并删除明文原件——插件交付包内只携带压缩版，由 ui.js 的静态
+ * 路由按 Accept-Encoding 直接回传对应编码。PNG 已是压缩格式，保持原样。
+ *
+ * 运行：node bin/pack-map-assets.mjs          # 压缩（幂等，可重复执行）
+ *       node bin/pack-map-assets.mjs --restore # 用压缩副本还原明文（调试用）
+ */
+import { readdir, readFile, rename, rm, writeFile } from 'node:fs/promises'
+import { promisify } from 'node:util'
+import { brotliCompress, brotliDecompress, constants, gunzip, gzip } from 'node:zlib'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const brotli = promisify(brotliCompress)
+const unbrotli = promisify(brotliDecompress)
+const gzipFile = promisify(gzip)
+const gunzipFile = promisify(gunzip)
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'lib', 'endfield-map')
+const restore = process.argv.includes('--restore')
+
+const targets = [join(root, 'map.js')]
+const resourcesDir = join(root, 'resources')
+const resourceTargets = new Set()
+for (const entry of await readdir(resourcesDir, { withFileTypes: true })) {
+  if (!entry.isFile()) continue
+  const match = /^(.*\.json)(?:\.(?:br|gz))?$/.exec(entry.name)
+  if (match) resourceTargets.add(match[1])
+}
+targets.push(...[...resourceTargets].sort().map((name) => join(resourcesDir, name)))
+
+const megabytes = (bytes) => (bytes / 1_000_000).toFixed(2)
+let rawBytes = 0
+let brotliBytes = 0
+let gzipBytes = 0
+let processed = 0
+
+async function readCompressed(filePath) {
+  try {
+    return await unbrotli(await readFile(`${filePath}.br`))
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error
+  }
+  try {
+    return await gunzipFile(await readFile(`${filePath}.gz`))
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error
+  }
+  throw Object.assign(new Error(`找不到明文或压缩副本：${filePath}`), { code: 'ENOENT' })
+}
+
+for (const filePath of targets) {
+  if (restore) {
+    // 明文存在说明已是还原态；否则真正解压 .br（缺失时回退 .gz）。
+    try {
+      await readFile(filePath)
+      continue
+    } catch { /* 缺明文 → 从压缩副本还原 */ }
+    const restored = await readCompressed(filePath)
+    const temp = `${filePath}.restore.tmp-${process.pid}`
+    await writeFile(temp, restored)
+    await rename(temp, filePath)
+    await rm(`${filePath}.br`, { force: true })
+    await rm(`${filePath}.gz`, { force: true })
+    processed += 1
+    continue
+  }
+  let source
+  try {
+    source = await readFile(filePath)
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error
+    // 已同时具备两种发布变体即为打包态；重复执行应是无操作。
+    try {
+      await Promise.all([readFile(`${filePath}.br`), readFile(`${filePath}.gz`)])
+      continue
+    } catch { /* 副本不完整：从现有副本恢复明文并补齐 */ }
+    source = await readCompressed(filePath)
+  }
+  const [brotliResult, gzipResult] = await Promise.all([
+    brotli(source, {
+      params: {
+        [constants.BROTLI_PARAM_MODE]: constants.BROTLI_MODE_TEXT,
+        [constants.BROTLI_PARAM_QUALITY]: 9,
+      },
+    }),
+    gzipFile(source, { level: 9 }),
+  ])
+  // 原子写压缩副本，确认落盘后再删明文。
+  const tmpBr = `${filePath}.br.tmp-${process.pid}`
+  const tmpGz = `${filePath}.gz.tmp-${process.pid}`
+  await writeFile(tmpBr, brotliResult)
+  await writeFile(tmpGz, gzipResult)
+  await rename(tmpBr, `${filePath}.br`)
+  await rename(tmpGz, `${filePath}.gz`)
+  await rm(filePath, { force: true })
+  rawBytes += source.length
+  brotliBytes += brotliResult.length
+  gzipBytes += gzipResult.length
+  processed += 1
+}
+
+if (!restore) {
+  console.log(`[pack-map-assets] ${processed}/${targets.length} files: ${megabytes(rawBytes)} MB raw → `
+    + `${megabytes(brotliBytes)} MB br + ${megabytes(gzipBytes)} MB gzip`)
+} else {
+  console.log(`[pack-map-assets] restored ${processed}/${targets.length} files to plain text`)
+}

package/bin/preview-rhine.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+// A loopback-only, read-only preview using the same corpus API as the plugin.
+import { createServer } from 'node:http'
+import { readFile, mkdtemp } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { CorpusStore } from '../src/store.js'
+import { buildApi } from '../src/ui.js'
+
+const root = fileURLToPath(new URL('../', import.meta.url))
+const releasesDir = resolve(process.env.PRTS_RHINE_RELEASES || join(root, 'data/releases'))
+const port = Number(process.env.PORT || 4177)
+const temporary = await mkdtemp(join(tmpdir(), 'prts-rhine-preview-'))
+const store = new CorpusStore({ releasesDir, cursorSecretPath: join(temporary, 'cursor-secret.bin') })
+await store.ready()
+const api = buildApi({ store, effective: () => ({ enabledGames: ['arknights', 'endfield'] }) })
+const files = new Map([
+  ['/rhine/rhine.js', ['lib/rhine/rhine.js', 'text/javascript']],
+  ['/rhine/rhine.css', ['lib/rhine/rhine.css', 'text/css']],
+  ['/rhine/assets/archive-cassette.glb', ['lib/rhine/assets/archive-cassette.glb', 'model/gltf-binary']],
+  ['/rhine/assets/archive-assembly.glb', ['lib/rhine/assets/archive-assembly.glb', 'model/gltf-binary']],
+  ...['Light', 'Regular', 'Demibold', 'Bold'].map(weight => [`/rhine/fonts/MiSans-${weight}.woff2`, [`lib/rhine/fonts/MiSans-${weight}.woff2`, 'font/woff2']]),
+  ['/rhine/fonts/NOTICE.txt', ['lib/rhine/fonts/NOTICE.txt', 'text/plain; charset=utf-8']],
+  ['/rhine/fonts/MiSans-license.pdf', ['lib/rhine/fonts/MiSans-license.pdf', 'application/pdf']],
+])
+const html = `<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>莱茵生命 · 资料馆预览</title><link rel="stylesheet" href="/rhine/rhine.css"><style>html,body,#app{margin:0;width:100%;height:100%;overflow:hidden;background:#eeece4}.preview-label{position:fixed;z-index:50;bottom:2px;left:50%;transform:translateX(-50%);font:9px system-ui;color:#77766c;pointer-events:none;max-width:70vw;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}</style><body><main id="app"></main><span class="preview-label">本地预览 · 真实资料库</span><script src="/rhine/rhine.js"></script><script>
+const snapshot={sessionId:'preview-local-v1',running:false,searching:false,query:'',tool:'',sources:[],answer:'',records:[]};
+window.rhineWorkbench=window.__PRTS_RHINE__.mountRhineWorkbench(document.getElementById('app'),{
+assetBase:'/rhine/',snapshot,agentAvailable:false,
+api:async(endpoint,payload,signal)=>{const res=await fetch('/rpc',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({endpoint,payload}),signal});const body=await res.json();if(!res.ok)throw new Error(body.error||'请求失败');return body;},
+askAgent:async()=>{throw new Error('这是资料馆独立预览。请在 Harness 会话中启用「莱茵生命资料馆」，即可将问题和摘录交给 Agent。');},
+close:()=>{document.querySelector('.preview-label').textContent='独立预览没有对话窗口；在 Harness 中此按钮返回当前会话。';}
+});
+</script></body></html>`
+const send = (res, status, body, type = 'application/json') => {
+  const data = typeof body === 'string' || Buffer.isBuffer(body) ? body : JSON.stringify(body)
+  res.writeHead(status, { 'content-type': type, 'x-content-type-options': 'nosniff',
+    'cache-control': 'no-store', 'cross-origin-resource-policy': 'same-origin' })
+  res.end(data)
+}
+const server = createServer(async (req, res) => {
+  try {
+    if (!['GET', 'HEAD', 'POST'].includes(req.method)) return send(res, 405, { error: 'Method not allowed' })
+    const url = new URL(req.url, `http://127.0.0.1:${port}`)
+    if (req.method === 'GET' && url.pathname === '/') return send(res, 200, html, 'text/html; charset=utf-8')
+    const file = files.get(url.pathname)
+    if (file && ['GET', 'HEAD'].includes(req.method)) {
+      const bytes = await readFile(join(root, file[0]))
+      return send(res, 200, req.method === 'HEAD' ? '' : bytes, file[1])
+    }
+    if (req.method !== 'POST' || url.pathname !== '/rpc') return send(res, 404, { error: 'Not found' })
+    if (req.headers.origin && new URL(req.headers.origin).host !== req.headers.host) return send(res, 403, { error: 'Origin rejected' })
+    let body = ''
+    req.setEncoding('utf8')
+    for await (const chunk of req) {
+      body += chunk
+      if (Buffer.byteLength(body) > 128 * 1024) return send(res, 413, { error: 'Request too large' })
+    }
+    const { endpoint, payload } = JSON.parse(body)
+    const route = { 'archive.search': 'archive/search', 'archive.options': 'archive/options', 'archive.cloud-search': 'archive/cloud-search', read: 'read' }[endpoint]
+    if (!route) return send(res, 404, { error: '此预览只开放搜索与读取' })
+    const controller = new AbortController()
+    res.on('close', () => { if (!res.writableEnded) controller.abort() })
+    const result = await api.call(endpoint === 'archive.options' ? 'GET' : 'POST', '/api/prts-corpus/' + route, payload, { signal: controller.signal })
+    if (!res.destroyed) send(res, result.status, result.json)
+  } catch (error) {
+    if (!res.destroyed) send(res, 500, { error: error.message || 'Preview request failed' })
+  }
+})
+server.listen(port, '127.0.0.1', () => console.log(`Rhine preview: http://127.0.0.1:${port} · ${store.documents.size} documents · ${store.dataVersion}`))

package/bin/rhine-detail-baker.ts

@@ -0,0 +1,84 @@
+import * as THREE from "three";
+
+/** Offline rasterization of the authored shallow lettering. Runtime uses the
+ * generated data only; this module is not imported by the browser bundle. */
+export function createArrayDetail(surface: string, source: THREE.BufferGeometry, material: THREE.Material) {
+  if (surface !== "Array_Interior_Lettering") return undefined;
+  const position = source.getAttribute("position"), normal = source.getAttribute("normal"), index = source.index;
+  if (!index || !normal || !position || !(material instanceof THREE.MeshStandardMaterial)) return undefined;
+  if (!source.boundingBox) source.computeBoundingBox();
+  const baked: number[] = [], bounds = new THREE.Box3(), point = new THREE.Vector3();
+  for (let i = 0; i < index.count; i += 3) {
+    const vertices = [index.getX(i), index.getX(i + 1), index.getX(i + 2)];
+    baked.push(...vertices);
+    for (const v of vertices) bounds.expandByPoint(point.fromBufferAttribute(position, v));
+  }
+  if (baked.length < 30 || bounds.isEmpty()) return undefined;
+  const size = bounds.getSize(new THREE.Vector3());
+  // Unsupported relief keeps the real mesh. This is not a general 3D impostor.
+  if (size.z > 0.0011 || size.x <= 0 || size.y <= 0) return undefined;
+  const width = 512, height = 64;
+  const paddingX = size.x * 2 / (width - 4), paddingY = size.y * 2 / (height - 4);
+  bounds.min.x -= paddingX; bounds.max.x += paddingX;
+  bounds.min.y -= paddingY; bounds.max.y += paddingY;
+  bounds.getSize(size);
+  const w = width * 2, h = height * 2;
+  const depth = new Float32Array(w * h).fill(-Infinity), normals = new Float32Array(w * h * 3);
+  for (let i = 0; i < baked.length; i += 3) {
+    const vertices = baked.slice(i, i + 3);
+    const xs = vertices.map(v => (position.getX(v) - bounds.min.x) / size.x * w);
+    const ys = vertices.map(v => (position.getY(v) - bounds.min.y) / size.y * h);
+    const denominator = (ys[1] - ys[2]) * (xs[0] - xs[2]) + (xs[2] - xs[1]) * (ys[0] - ys[2]);
+    if (Math.abs(denominator) < 1e-10) continue;
+    for (let y = Math.max(0, Math.floor(Math.min(...ys))); y < Math.min(h, Math.ceil(Math.max(...ys))); y++) {
+      for (let x = Math.max(0, Math.floor(Math.min(...xs))); x < Math.min(w, Math.ceil(Math.max(...xs))); x++) {
+        const a = ((ys[1] - ys[2]) * (x + 0.5 - xs[2]) + (xs[2] - xs[1]) * (y + 0.5 - ys[2])) / denominator;
+        const b = ((ys[2] - ys[0]) * (x + 0.5 - xs[2]) + (xs[0] - xs[2]) * (y + 0.5 - ys[2])) / denominator;
+        const c = 1 - a - b;
+        if (Math.min(a, b, c) < -1e-6) continue;
+        const z = a * position.getZ(vertices[0]) + b * position.getZ(vertices[1]) + c * position.getZ(vertices[2]);
+        const pixel = y * w + x;
+        if (z < depth[pixel]) continue;
+        depth[pixel] = z;
+        for (let channel = 0; channel < 3; channel++) normals[pixel * 3 + channel] =
+          a * normal.getComponent(vertices[0], channel) + b * normal.getComponent(vertices[1], channel) + c * normal.getComponent(vertices[2], channel);
+      }
+    }
+  }
+  const pixels = new Uint8Array(width * height * 4);
+  let occupied = 0;
+  for (let y = 0; y < height; y++) for (let x = 0; x < width; x++) {
+    point.set(0, 0, 0); let count = 0;
+    for (let dy = 0; dy < 2; dy++) for (let dx = 0; dx < 2; dx++) {
+      const pixel = (y * 2 + dy) * w + x * 2 + dx;
+      if (!Number.isFinite(depth[pixel])) continue;
+      point.x += normals[pixel * 3]; point.y += normals[pixel * 3 + 1]; point.z += normals[pixel * 3 + 2]; count++;
+    }
+    if (count) { point.normalize(); occupied++; } else point.set(0, 0, 1);
+    const offset = (y * width + x) * 4;
+    pixels[offset] = Math.round((point.x * 0.5 + 0.5) * 255);
+    pixels[offset + 1] = Math.round((point.y * 0.5 + 0.5) * 255);
+    pixels[offset + 2] = Math.round((point.z * 0.5 + 0.5) * 255);
+    pixels[offset + 3] = Math.round(count * 255 / 4);
+  }
+  if (!occupied) return undefined;
+  const texture = new THREE.DataTexture(pixels, width, height, THREE.RGBAFormat);
+  texture.name = `Array ${surface} normal and coverage`;
+  texture.colorSpace = THREE.NoColorSpace;
+  texture.generateMipmaps = true; texture.minFilter = THREE.LinearMipmapLinearFilter;
+  texture.magFilter = THREE.LinearFilter; texture.anisotropy = 4; texture.needsUpdate = true;
+  const geometry = new THREE.PlaneGeometry(size.x, size.y).translate(
+    (bounds.min.x + bounds.max.x) / 2, (bounds.min.y + bounds.max.y) / 2, bounds.max.z + 0.00001);
+  const proxyMaterial = material.clone();
+  proxyMaterial.normalMap = texture; proxyMaterial.normalMapType = THREE.TangentSpaceNormalMap;
+  proxyMaterial.normalScale.set(1, 1); proxyMaterial.transparent = true; proxyMaterial.depthWrite = false;
+  proxyMaterial.alphaTest = 0.01;
+  proxyMaterial.onBeforeCompile = shader => {
+    shader.fragmentShader = shader.fragmentShader.replace("#include <alphatest_fragment>",
+      "diffuseColor.a *= texture2D(normalMap, vNormalMapUv).a;\n#include <alphatest_fragment>");
+  };
+  proxyMaterial.customProgramCacheKey = () => "array-normal-coverage-v1";
+  proxyMaterial.userData.arrayDetail = { surface, width, height, bakedTriangles: baked.length / 3 };
+  return { geometry, material: proxyMaterial, texture, bakedTriangles: baked.length / 3,
+    textureBytes: pixels.byteLength, sourceTriangles: index.count / 3 };
+}