dsh-fishpai 1.0.2

package/plugin/core/runtime.mjs

@@ -0,0 +1,83 @@
+/**
+ * 上游运行时加载：在 vm context 里求值站点原版的三个 vendor 资产。
+ *
+ * 为什么必须用 vm 顶层求值：上游 `js/themes.js` 用顶层 `const themes = {...}` 声明，
+ * 不挂 `window`；直接 `import` 拿不到，必须 context 级顶层求值。
+ * （这是上游的既有行为，不是我们选择的实现方式——见 NOTICE.md）
+ *
+ * 全部懒加载并缓存：插件启动时不付这份解析代价。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import vm from 'node:vm'
+import { fileURLToPath } from 'node:url'
+
+export const VENDOR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'vendor')
+
+let sandbox = null
+
+function loadRuntime() {
+  const box = { console, document: undefined }
+  box.window = box
+  box.self = box
+  box.globalThis = box
+  vm.createContext(box)
+
+  const load = (f) => vm.runInContext(fs.readFileSync(path.join(VENDOR, f), 'utf8'), box, { filename: f })
+  load('markdown-it.min.js')
+  load('highlight.min.js')
+  load('themes.js')
+
+  // hljs 在 UMD 里挂到自己身上，取出来交给沙箱的全局
+  const hljs = box.hljs || (box.window && box.window.hljs)
+  if (hljs) box.hljs = hljs
+
+  return box
+}
+
+/** 在 vendor 沙箱里求值一个表达式（'markdownit' / 'hljs' / 'themes' …）。 */
+export function read(expr) {
+  if (sandbox === null) sandbox = loadRuntime()
+  return vm.runInContext(expr, sandbox)
+}
+
+export function themes() {
+  return read('themes')
+}
+
+export function colorPresets() {
+  return read('colorPresets')
+}
+
+/** 主题名/别名 -> 主题 key。允许用中文名、emoji 名或 key 指定。 */
+export function resolveTheme(name) {
+  const THEMES = themes()
+  if (!name) return 'default'
+  if (THEMES[name]) return name
+  const norm = String(name).replace(/\s/g, '')
+  for (const [key, t] of Object.entries(THEMES)) {
+    if (key === norm || t.name.replace(/\s/g, '') === norm) return key
+    if (t.name.replace(/\s/g, '').includes(norm) || norm.includes(t.name.replace(/\s/g, ''))) return key
+  }
+  return null
+}
+
+/** 站点的字体预设（上游 app.js 的 fontMap）；默认 fontFamily='sans' 会覆盖主题自带字体。 */
+export const FONT_MAP = {
+  sans: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "PingFang SC", "Noto Sans SC", sans-serif',
+  serif: '"Georgia", "Noto Serif SC", "Source Han Serif SC", serif',
+  mono: '"SFMono-Regular", Consolas, "Liberation Mono", Menlo, "PingFang SC", monospace',
+}
+
+let HLJS_MAP = null
+
+/** highlight.js token 的计算样式表（从真实浏览器导出，见 NOTICE.md）。 */
+export function hljsMap() {
+  if (HLJS_MAP) return HLJS_MAP
+  try {
+    HLJS_MAP = JSON.parse(fs.readFileSync(path.join(VENDOR, 'hljs-map.json'), 'utf8'))
+  } catch {
+    HLJS_MAP = {}
+  }
+  return HLJS_MAP
+}

package/plugin/core/theme-info.mjs

@@ -0,0 +1,80 @@
+/**
+ * 主题能力标注：从主题定义本身推导"这个主题能做什么、粘进微信靠不靠谱"。
+ *
+ * 为什么要有这一层：工具栏里有些控件只对部分主题有效——
+ *   - **主题色**靠替换主题样式里的 `{{PRIMARY}}` / `{{PRIMARY_BG}}` 生效，
+ *     实测只有 `default`（默认公众号）用了它，其余主题点了也不会变。
+ *   - **渐变文字**（`background-clip: text` + 透明字色）依赖微信可能重写的属性，
+ *     作为公众号正文有风险。
+ *
+ * 所以这里把判断**写进代码**、由主题定义推导，而不是在 UI 里维护一份主题名单：
+ * 上游哪天改了主题，标注自动跟着变（相关单测会红，提醒复核）。
+ *
+ * 纯函数、零依赖，可单独单测。
+ */
+
+/** 主题色占位符：`{{PRIMARY}}` 与它的浅色变体都算用了主题色。 */
+const ACCENT_RE = /\{\{PRIMARY(?:_BG)?\}\}/
+
+/** 渐变文字：把背景裁剪到文字上，字色本身就是透明的。 */
+const TEXT_CLIP_RE = /(?:-webkit-)?background-clip:\s*text/i
+
+/** 深色底判定阈值（sRGB 相对亮度）。 */
+const DARK_LUMINANCE = 0.4
+
+function stylesText(theme) {
+  const styles = theme && typeof theme === 'object' ? theme.styles : null
+  if (!styles || typeof styles !== 'object') return ''
+  return Object.values(styles)
+    .filter((v) => typeof v === 'string')
+    .join(';')
+}
+
+function parseColor(value) {
+  const raw = String(value || '').trim()
+  let m = /^#([0-9a-f]{3})$/i.exec(raw)
+  if (m) {
+    const [r, g, b] = m[1].split('').map((c) => parseInt(c + c, 16))
+    return { r, g, b }
+  }
+  m = /^#([0-9a-f]{6})$/i.exec(raw)
+  if (m) {
+    const n = parseInt(m[1], 16)
+    return { r: (n >> 16) & 255, g: (n >> 8) & 255, b: n & 255 }
+  }
+  // rgb()/rgba()：只取前三个通道；解析不了就返回 null（失效方向选"不标记"）
+  m = /^rgba?\(\s*(\d{1,3})\s*[,\s]\s*(\d{1,3})\s*[,\s]\s*(\d{1,3})/i.exec(raw)
+  if (m) return { r: Number(m[1]), g: Number(m[2]), b: Number(m[3]) }
+  return null
+}
+
+function luminance({ r, g, b }) {
+  const channel = (v) => {
+    const s = v / 255
+    return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4
+  }
+  return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b)
+}
+
+/** 从 wrapper 样式里取背景色；`background:` 与 `background-color:` 都认。 */
+export function wrapperBackground(theme) {
+  const styles = theme && typeof theme === 'object' ? theme.styles : null
+  const wrapper = styles && typeof styles.wrapper === 'string' ? styles.wrapper : ''
+  const m = /(?:^|;)\s*background(?:-color)?:\s*([^;]+)/i.exec(wrapper)
+  return m ? parseColor(m[1]) : null
+}
+
+/**
+ * 标注一个主题。
+ *
+ * @param {object} theme `themes[key]` 的定义（`{ name, emoji, desc, styles }`）
+ * @returns {{usesAccent: boolean, gradientText: boolean, darkWrapper: boolean, wechatSafe: boolean}}
+ */
+export function classifyTheme(theme) {
+  const text = stylesText(theme)
+  const usesAccent = ACCENT_RE.test(text)
+  const gradientText = TEXT_CLIP_RE.test(text)
+  const bg = wrapperBackground(theme)
+  const darkWrapper = bg ? luminance(bg) < DARK_LUMINANCE : false
+  return { usesAccent, gradientText, darkWrapper, wechatSafe: !gradientText && !darkWrapper }
+}

package/plugin/core/theme-spec.mjs

@@ -0,0 +1,276 @@
+/**
+ * 模型自定义主题（**主题规格**）：校验 + 合并。
+ *
+ * 为什么是数据而不是代码：内置主题本身就是"19 个样式槽位 → 一段 CSS 声明"的数据
+ * （`plugin/vendor/themes.js`），`makeStyler()` 只做 `{{PRIMARY}}` / `{{PRIMARY_BG}}` 占位符替换。
+ * 所以"让模型写主题"= 让模型写**同构的数据**，不需要求值任何模型给的代码。
+ *
+ * 两条硬约束，都在这里把关：
+ *   1. **必须在某个内置主题上做增量覆盖**。渲染器对缺失槽位的处理是"不加 style 属性"
+ *      （`markdown.mjs`：`styles[key] ? ` style="…"` : ''`），所以"从零写一套"等于大部分元素没有样式。
+ *      合并后 19 个槽位必然齐备。
+ *   2. **属性白名单**。只放行内置主题实际用过的那批属性——那 11 套是真人实测能在公众号里活的；
+ *      名单之外的属性一律拒绝，免得模型写出一条微信会丢的声明，或者干脆是注入。
+ *
+ * 这一层是纯函数：不碰文件系统、不去求值。
+ */
+
+/**
+ * 主题的样式槽位（与内置主题一一对应）。
+ * 加槽位要同时改 `plugin/vendor/themes.js` 与 `markdown.mjs` 的渲染规则，不是这里的自由项。
+ */
+export const THEME_SLOTS = [
+  'wrapper',
+  'h1',
+  'h2',
+  'h3',
+  'p',
+  'blockquote',
+  'code_inline',
+  'code_block',
+  'ul',
+  'ol',
+  'li',
+  'img',
+  'a',
+  'table',
+  'th',
+  'td',
+  'hr',
+  'strong',
+  'em',
+]
+
+/**
+ * 允许出现在自定义主题里的 CSS 属性。
+ *
+ * **这份名单是统计出来的，不是挑出来的**：把 11 套内置主题的 19 个槽位全部拆开，
+ * 出现过的属性就是下面这 30 个（含 `-webkit-` 两个渐变文字用的）。要加属性请先给出
+ * "它在真实公众号里活下来"的证据，并同时补 `test/theme-spec.test.mjs` 的用例。
+ */
+export const SPEC_PROPS = new Set([
+  'margin',
+  'color',
+  'font-size',
+  'padding',
+  'background',
+  'font-weight',
+  'line-height',
+  'border-radius',
+  'border',
+  'padding-left',
+  'font-style',
+  'text-align',
+  'border-left',
+  'font-family',
+  'border-bottom',
+  'letter-spacing',
+  'overflow-x',
+  'max-width',
+  'display',
+  'text-decoration',
+  'width',
+  'border-collapse',
+  'height',
+  '-webkit-background-clip',
+  '-webkit-text-fill-color',
+  'padding-bottom',
+  'box-shadow',
+  'text-indent',
+  'border-image',
+  'border-top',
+])
+
+/**
+ * 主题色占位符：自定义主题照样能用它，于是面板的色板对它也有效。
+ *
+ * 两个形态是刻意的：`.test()` 用在**带 `g` 的正则**上会被 `lastIndex` 影响（上一轮匹配到哪，
+ * 下一轮就从哪开始），所以判定用不带 `g` 的那个，替换用带 `g` 的那个。
+ */
+const PLACEHOLDER_RE = /\{\{PRIMARY(?:_BG)?\}\}/
+const PLACEHOLDER_G = /\{\{PRIMARY(?:_BG)?\}\}/g
+
+/**
+ * 明确不许出现的东西：注入面（`}` / `<` / **双引号**）、外链请求（`url(`）、脚本（`expression` / `javascript:`）、样式表指令。
+ *
+ * 双引号是必须禁的那一个：属性**一律由双引号包裹**（`markdown.mjs` 各槽位拼的就是 `style="…"`，
+ * `render.mjs` 的 wrapper 也是），值里出现 `"` 就闭合了属性、把后面的字节变成任意属性。
+ * 单引号放行：它在双引号包裹的属性里只是普通字符，闭合不了任何东西，而
+ * `font-family: 'Georgia', serif` 是合法且常见的写法，禁它只是白白挡住常见写法。
+ * （管线后段只有单向的 `"` → `'` 降级，没有反向把 `'` 变回 `"` 的路径，放行不会又被武装回来。）
+ *
+ * 判定前先把**合法占位符**摘掉：`{{PRIMARY}}` 自己就带花括号，不摘的话所有想用主题色的主题
+ * 都会被自己的注入检查拦下（占位符是这套机制的一部分，不是注入面）。
+ */
+const FORBIDDEN_RE = /[{}<>"]|url\s*\(|expression\s*\(|@import|javascript:/i
+
+function stripPlaceholders(text) {
+  return String(text).replace(PLACEHOLDER_G, 'P')
+}
+
+const MAX_NAME = 24
+const MAX_DECLS = 24
+const MAX_VALUE = 200
+
+/**
+ * 规格只认这三个键。
+ *
+ * `emoji` / `icon` 之类**故意不收**：图标由鱼排统一提供。
+ * 合法图标名的名单只存在于浏览器那半（`@deepseek-ai/dsh-client-ui-primitives` 的 `Icon*` 导出），
+ * 而校验器在宿主这半——让模型选名字就得在宿主再抄一份名单并跟着 DSH 升级维护，
+ * 抄漏一个的后果是**图标静默消失且不报错**。统一图标只需客户端一行降级逻辑。
+ * 多写的键一律报错（而不是默默忽略）：写了没作用，比不让写更容易骗人。
+ */
+const SPEC_KEYS = ['name', 'base', 'styles']
+
+function fail(message) {
+  throw new Error(message)
+}
+
+function cleanName(raw, fallback) {
+  const name = String(raw ?? '')
+    .replace(/[\u0000-\u001f\u007f]+/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim()
+  if (!name) return fallback
+  if (name.length > MAX_NAME) fail(`主题名太长（最多 ${MAX_NAME} 个字）：${name.slice(0, MAX_NAME)}…`)
+  return name
+}
+
+/** 把一段 CSS 声明拆成 `[prop, value]`，逐条过白名单；返回规范化后的声明串。 */
+function parseDeclarations(slot, css, notes) {
+  const text = String(css ?? '')
+  if (/[\r\n]/.test(text)) fail(`槽位 ${slot} 的样式不能换行（写成一行，用 ; 分隔）`)
+  if (FORBIDDEN_RE.test(stripPlaceholders(text))) {
+    fail(`槽位 ${slot} 里出现了不允许的内容（{}、<>、双引号、url()、expression、@import 都不能用；单引号可以；{{PRIMARY}} 这类占位符是允许的）`)
+  }
+  const out = []
+  for (const raw of text.split(';')) {
+    const decl = raw.trim()
+    if (!decl) continue
+    const m = /^([-a-zA-Z]+)\s*:\s*(\S[\s\S]*)$/.exec(decl)
+    if (!m) fail(`槽位 ${slot} 里有看不懂的声明：「${decl}」（要写成 "属性: 值"）`)
+    const prop = m[1].toLowerCase()
+    let value = m[2].trim()
+    if (!SPEC_PROPS.has(prop)) {
+      fail(`槽位 ${slot} 用了不支持的属性「${prop}」。允许的属性见技能 fishpai 的自定义主题一节（内置主题用过的那批）`)
+    }
+    if (value.length > MAX_VALUE) fail(`槽位 ${slot} 的属性「${prop}」值太长（最多 ${MAX_VALUE} 字符）`)
+    // `!important` 在微信里留不住，留着只会让模型误以为"这样就能强制生效"
+    if (/!\s*important/i.test(value)) {
+      value = value.replace(/\s*!\s*important/gi, '')
+      notes.push(`槽位 ${slot} 的「${prop}」去掉了 !important（微信不保留它，留着会误判）`)
+    }
+    if (!value) fail(`槽位 ${slot} 的属性「${prop}」没有值`)
+    out.push(`${prop}: ${value}`)
+    if (out.length > MAX_DECLS) fail(`槽位 ${slot} 的声明太多（最多 ${MAX_DECLS} 条）`)
+  }
+  return out.join('; ') + (out.length ? ';' : '')
+}
+
+/** wrapper 上必须有这两条：面板的「字体」「字号」是靠替换它们生效的（漏了就变成死控件）。 */
+const WRAPPER_REQUIRED = ['font-family', 'font-size']
+
+function inheritDecl(baseWrapper, prop) {
+  const re = new RegExp(`(?:^|;)\\s*(${prop}\\s*:[^;]+)`, 'i')
+  const m = re.exec(String(baseWrapper || ''))
+  return m ? m[1].trim() : null
+}
+
+/**
+ * 校验一份主题规格。
+ *
+ * @param {object} spec `{ name?, base?, styles? }`
+ * @param {Record<string, object>} baseThemes 内置主题表（`runtime.themes()`）
+ * @returns {{name: string, base: string, styles: Record<string,string>, notes: string[]}}
+ * @throws {Error} 文案是给模型看的：说清哪个槽位、哪个属性、为什么
+ */
+export function validateThemeSpec(spec, baseThemes) {
+  if (!spec || typeof spec !== 'object' || Array.isArray(spec)) {
+    fail('theme_spec 必须是一个对象：{ name, base, styles }')
+  }
+  const extra = Object.keys(spec).filter((k) => !SPEC_KEYS.includes(k))
+  if (extra.length) {
+    fail(`主题规格只认 ${SPEC_KEYS.join(' / ')}，多了：${extra.join(' / ')}（图标与 emoji 由鱼排统一给，不用你选）`)
+  }
+  const notes = []
+  const base = String(spec.base ?? 'default')
+  const baseTheme = baseThemes && baseThemes[base]
+  if (!baseTheme) {
+    fail(`base 必须是已有的主题 key，没有「${base}」。可选：${Object.keys(baseThemes || {}).join(' / ')}`)
+  }
+  const name = cleanName(spec.name, `${baseTheme.name}·自定义`)
+
+  const rawStyles = spec.styles
+  if (rawStyles === undefined || rawStyles === null) {
+    fail('styles 不能为空：至少要写一个想改的槽位（例如 {"p": "line-height: 2;"}）')
+  }
+  if (typeof rawStyles !== 'object' || Array.isArray(rawStyles)) fail('styles 必须是对象：{ 槽位: "CSS 声明" }')
+  const keys = Object.keys(rawStyles)
+  if (!keys.length) fail('styles 里一个槽位都没有：至少要写一个想改的槽位')
+
+  const styles = {}
+  for (const slot of keys) {
+    if (!THEME_SLOTS.includes(slot)) {
+      fail(`不认识的槽位「${slot}」。可用槽位：${THEME_SLOTS.join(' / ')}`)
+    }
+    const css = rawStyles[slot]
+    if (typeof css !== 'string') fail(`槽位 ${slot} 必须是字符串（形如 "font-size: 18px; color: #333;"）`)
+    const normalized = parseDeclarations(slot, css, notes)
+    if (!normalized) fail(`槽位 ${slot} 是空的：要么写内容，要么别写这个键`)
+    styles[slot] = normalized
+  }
+
+  // wrapper 是唯一的硬性缺口：模型很容易只写 line-height / color，漏掉字体字号，
+  // 结果面板上「字体」「字号」两个控件点了没反应——那正是最不该出现的"死控件"。
+  if (styles.wrapper) {
+    const missing = WRAPPER_REQUIRED.filter((prop) => !inheritDecl(styles.wrapper, prop))
+    if (missing.length) {
+      const parts = []
+      for (const prop of missing) {
+        const inherited = inheritDecl(baseTheme.styles && baseTheme.styles.wrapper, prop)
+        if (!inherited) fail(`槽位 wrapper 缺少 ${prop}，且 base 主题里也没有，无法补全`)
+        parts.push(inherited)
+      }
+      styles.wrapper = `${styles.wrapper} ${parts.join('; ')};`.replace(/\s+/g, ' ')
+      notes.push(
+        `wrapper 自动补上了 ${missing.join(' / ')}（从 base 继承）——漏了它们，面板的「字体」「字号」会变成点了没反应的死控件`,
+      )
+    }
+  }
+
+  if (!PLACEHOLDER_RE.test(Object.values(styles).join(';'))) {
+    notes.push('没有用到 {{PRIMARY}}：面板的「主题色」色板对这个主题不会有效果（这没有错，只是提醒）')
+  }
+  return { name, base, styles, notes }
+}
+
+/**
+ * 把校验过的规格合并到 base 主题上，得到一份完整主题（19 个槽位齐备）。
+ *
+ * @param {object} baseTheme `baseThemes[spec.base]`
+ * @param {{name: string, styles: Record<string,string>}} spec `validateThemeSpec()` 的产物
+ * @returns {object} 可以直接交给 `render({theme})` 的主题对象
+ */
+export function mergeTheme(baseTheme, spec) {
+  return {
+    key: 'custom',
+    name: spec.name,
+    emoji: '✳️',
+    desc: `自定义主题（基于「${baseTheme.name}」）`,
+    custom: true,
+    styles: { ...(baseTheme.styles || {}), ...spec.styles },
+  }
+}
+
+/** 一步到位：校验 + 合并。给工具与路由用。 */
+export function buildCustomTheme(spec, baseThemes) {
+  const checked = validateThemeSpec(spec, baseThemes)
+  return { theme: mergeTheme(baseThemes[checked.base], checked), spec: checked }
+}
+
+/** 给模型看的一行说明（工具返回里带上，省得它去猜自己写了什么）。 */
+export function describeThemeSpec(spec) {
+  const slots = Object.keys(spec.styles)
+  return `自定义主题「${spec.name}」（base=${spec.base}）改了 ${slots.length} 个槽位：${slots.join('、')}`
+}

package/plugin/host/assets.mjs

@@ -0,0 +1,120 @@
+/**
+ * 图片处理：本地图片 → data URI（复制/导出时内嵌），以及给预览用的静态读取。
+ *
+ * 为什么在宿主侧做而不是浏览器 canvas：文档里的图片是**磁盘上的相对路径**
+ * （写文章的人本来就这么引图）。浏览器拿不到它，宿主能；而且不需要 CORS 与 canvas。
+ *
+ * 上游只对 blob:/data: 的图做内嵌（浏览器里粘贴进来的图）。鱼排多做一步：
+ * 相对路径的本地图片也能内嵌，粘进公众号编辑器时图片不会丢。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { IMAGE_EXTS, MAX_ASSET_BYTES, mimeFor, resolveInCwd } from './store.mjs'
+
+/**
+ * 单张图内嵌上限：**与"能不能存进来"同一个上限**（`MAX_ASSET_BYTES`）。
+ * 两处各写一个数字的话，迟早出现"存得进来、却内嵌不了"的图，而面板只会说"需手动上传"。
+ */
+export const MAX_EMBED_BYTES = MAX_ASSET_BYTES
+
+function isRemote(src) {
+  return /^(https?:|data:|blob:|\/\/)/i.test(String(src || ''))
+}
+
+/**
+ * 造一个 `imageResolver` 给 `render()` 用：把 <img src> 换成 data URI。
+ *
+ * @param {{cwd: string, docPath: string, maxBytes?: number}} ctx
+ * @returns {(src: string) => string | null} 返回 null 表示保持原样
+ */
+export function makeImageResolver({ cwd, docPath, maxBytes = MAX_EMBED_BYTES }) {
+  const baseDir = path.dirname(docPath)
+  return (src) => {
+    if (!src || isRemote(src)) return null
+    let abs
+    try {
+      abs = resolveInCwd(cwd, path.isAbsolute(src) ? src : path.join(baseDir, src), { exts: IMAGE_EXTS })
+    } catch {
+      return null // 越界或不是图片：原样保留，交给微信去处理
+    }
+    let stat
+    try {
+      stat = fs.statSync(abs)
+    } catch {
+      return null
+    }
+    if (!stat.isFile() || stat.size > maxBytes) return null
+    const data = fs.readFileSync(abs)
+    return `data:${mimeFor(abs)};base64,${data.toString('base64')}`
+  }
+}
+
+/**
+ * 读一张本地图片给预览 iframe 用（`/fishpai/api/asset`）。
+ *
+ * @returns {{bytes: Buffer, mime: string} | null}
+ */
+export function readAsset({ cwd, docPath, src, maxBytes = 20 * 1024 * 1024 }) {
+  if (!src || isRemote(src)) return null
+  const baseDir = path.dirname(docPath)
+  let abs
+  try {
+    abs = resolveInCwd(cwd, path.isAbsolute(src) ? src : path.join(baseDir, src), { exts: IMAGE_EXTS })
+  } catch {
+    return null
+  }
+  try {
+    const stat = fs.statSync(abs)
+    if (!stat.isFile() || stat.size > maxBytes) return null
+    return { bytes: fs.readFileSync(abs), mime: mimeFor(abs) }
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Markdown 里引用的**外链图**清单：这些是微信会拦掉的那一类（"此图片来自…未经允许不可引用"），
+ * 复制过去也不显示，必须手动重新上传。本地图不走这里——它们会被内嵌成 base64 带过去。
+ */
+export function listRemoteImages({ markdown }) {
+  const out = []
+  const re = /!\[[^\]]*\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g
+  let m
+  while ((m = re.exec(String(markdown || ''))) !== null) {
+    if (isRemote(m[1])) out.push({ src: m[1] })
+  }
+  return out
+}
+
+/**
+ * Markdown 里引用的本地图片清单，并标出**能不能被内嵌**。
+ *
+ * 只有 `embed: true` 的图会被 base64 内嵌进剪贴板、跟着粘贴一起进公众号编辑器；
+ * 其余的（文件不在、越界、超过大小上限）不会被内嵌，粘过去大概率不显示，需要手动上传。
+ * 面板与 `fishpai_read` 都靠 `embed` 这一列说人话。
+ */
+export function listLocalImages({ markdown, cwd, docPath, maxBytes = MAX_EMBED_BYTES }) {
+  const baseDir = path.dirname(docPath)
+  const out = []
+  const re = /!\[[^\]]*\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g
+  let m
+  while ((m = re.exec(String(markdown || ''))) !== null) {
+    const src = m[1]
+    if (isRemote(src)) continue
+    let status = 'ok'
+    let size = null
+    try {
+      const abs = resolveInCwd(cwd, path.isAbsolute(src) ? src : path.join(baseDir, src), { exts: IMAGE_EXTS })
+      if (!fs.existsSync(abs)) {
+        status = 'missing'
+      } else {
+        size = fs.statSync(abs).size
+        if (size > maxBytes) status = 'too-large'
+      }
+    } catch {
+      status = 'outside'
+    }
+    out.push({ src, status, size, embed: status === 'ok' })
+  }
+  return out
+}

package/plugin/host/custom-theme.mjs

@@ -0,0 +1,121 @@
+/**
+ * 工作目录级的**自定义主题**：一个工作目录只有一套，存在 `.fishpai/theme.json`。
+ *
+ * 为什么不是"主题库"：面板上只留**一个**「自定义主题」占位，模型改一次就覆盖一次——
+ * 不需要命名、列表、删除这一堆管理面，用户也不必维护一个主题清单。
+ *
+ * 路径由宿主拼死（**不接受**调用方传路径），所以这里给 `resolveInCwd` 放行 `.json`
+ * 不会变成"任意 JSON 读写"：`.fishpai/state/*.json` 那些仍然不可达。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { safeThemeKey } from '../core/render.mjs'
+import { themes } from '../core/runtime.mjs'
+import { buildCustomTheme } from '../core/theme-spec.mjs'
+import { classifyTheme } from '../core/theme-info.mjs'
+import { ensureFishpaiLayout, resolveInCwd } from './store.mjs'
+
+/** 主题列表里那个占位的 key（面板按它选中）。 */
+export const CUSTOM_THEME_KEY = 'custom'
+/** 占位的显示名：固定一个，不跟着模型起的名字变（面板上只留一个占位）。 */
+export const CUSTOM_THEME_LABEL = '自定义主题'
+
+const STORE_VERSION = 1
+
+function themePath(cwd) {
+  return resolveInCwd(cwd, path.join('.fishpai', 'theme.json'), { exts: ['.json'] })
+}
+
+/**
+ * 读当前工作目录的自定义主题。
+ *
+ * 坏文件/校验不过 → `null`（当"没有"处理）：一份手改坏的 `theme.json` 不该让面板打不开，
+ * 也不该让一篇文档渲染不出来。`missing` 与"坏掉了"在这里是同一件事。
+ *
+ * @returns {{spec: object, theme: object} | null}
+ */
+export function readCustomTheme(cwd) {
+  try {
+    const abs = themePath(cwd)
+    if (!fs.existsSync(abs)) return null
+    const raw = JSON.parse(fs.readFileSync(abs, 'utf8'))
+    const spec = raw && typeof raw === 'object' && raw.spec ? raw.spec : raw
+    return buildCustomTheme(spec, themes())
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 写自定义主题（覆盖那唯一一套）。
+ * @throws {Error} 规格不合法时抛出——文案是给模型看的，让它自己改对再来
+ */
+export function writeCustomTheme({ cwd, spec }) {
+  ensureFishpaiLayout(cwd)
+  const built = buildCustomTheme(spec, themes())
+  const abs = themePath(cwd)
+  // 只存**数据**三件套：校验产物还带着 `notes`（那是给模型的运行时提示），
+  // 整个存下去的话，读回来会被"只认 name/base/styles"的规则拒掉——存了等于没存（测试抓到过）。
+  const saved = { name: built.spec.name, base: built.spec.base, styles: built.spec.styles }
+  // 临时文件 + rename：写一半留下坏 JSON 会让面板下次直接"没有自定义主题"
+  const tmp = `${abs}.${process.pid}.tmp`
+  fs.writeFileSync(tmp, `${JSON.stringify({ version: STORE_VERSION, spec: saved }, null, 2)}\n`, 'utf8')
+  fs.renameSync(tmp, abs)
+  return built
+}
+
+/** 移除自定义主题。返回是否真的删掉了东西。 */
+export function clearCustomTheme(cwd) {
+  try {
+    const abs = themePath(cwd)
+    if (!fs.existsSync(abs)) return false
+    fs.unlinkSync(abs)
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 把文档状态里的主题名解析成 `render()` 能用的东西。
+ *
+ * `'custom'` 是唯一需要查磁盘的 key：那套主题不在内置表里，找不到就**退回默认主题**
+ * （与 `safeThemeKey` 对未知主题的处理一致——别让一篇文档因为主题文件被删就打不开）。
+ *
+ * @returns {{theme: string|object, key: string, custom: boolean, missing: boolean}}
+ */
+export function themeFor({ cwd, name }) {
+  if (name !== CUSTOM_THEME_KEY) {
+    const key = safeThemeKey(name)
+    return { theme: key, key, custom: false, missing: false }
+  }
+  const custom = readCustomTheme(cwd)
+  if (!custom) return { theme: 'default', key: 'default', custom: false, missing: true }
+  return { theme: custom.theme, key: CUSTOM_THEME_KEY, custom: true, missing: false }
+}
+
+/**
+ * 主题清单里的那一个占位项（没有自定义主题时返回 `null`，面板就不显示这一组——
+ * 宁可没有这一行，也不要一个点了没反应的灰项）。
+ *
+ * 能力标注照旧由 `classifyTheme()` 从主题定义推导：模型写了渐变文字/深色底，
+ * 面板就会把它归进「微信可能掉样式」那一组，跟内置主题一个待遇。
+ */
+export function customCatalogEntry(cwd) {
+  const custom = readCustomTheme(cwd)
+  if (!custom) return null
+  return {
+    key: CUSTOM_THEME_KEY,
+    name: CUSTOM_THEME_LABEL,
+    emoji: custom.theme.emoji || '✳️',
+    desc: `模型生成：${custom.spec.name}（基于「${themes()[custom.spec.base].name}」）`,
+    ...classifyTheme(custom.theme),
+  }
+}
+
+/** 给工具/模型看的当前规格（`fishpai_theme` 的 show 用）。 */
+export function describeCustomTheme(cwd) {
+  const custom = readCustomTheme(cwd)
+  if (!custom) return null
+  return { spec: custom.spec, theme: custom.theme }
+}