dsh-persona-presets 0.1.0 → 0.2.0

package/README.md

@@ -2,9 +2,10 @@
 
 三个自定义 agent 预设，每个预设一张可编辑的角色卡——独立插件，任何 DSH 用户可装。
 
-- **预设**：人设-自定义1/2/3（persona-598-custom-1/2/3），工具目录 = 标准模式克隆，人设行替换官方 `@deepseek-ai/dsh-persona`。
-- **设置页**：「角色卡」区块，每槽一张卡（可取名、常显对应预设），保存后下一回合生效（prompt 段每次组装实时读文件，无缓存无重启）。
-- **存储**：`~/.dsh/persona-presets-598/persona-settings.json`，字段 `personas.<presetId>` 与 `presetNames`，卡上限 8000 字、名上限 60 字。
+- **预设**：人设-自定义1/2/3（persona-598-custom-1/2/3），工具目录 = 标准模式克隆，人设行替换官方 `@deepseek-ai/dsh-persona`，并以 scoped 空段遮蔽宿主 `harness:identity` 开场白（只影响这三个预设，standard 不动）。
+- **设置页**：「角色卡」区块，每槽一张卡（可取名、常显对应预设），**三槽开箱即各带一张预制人设**（槽1=鲸鱼娘 / 槽2=病娇 / 槽3=小满），保存后下一回合生效（prompt 段每次组装实时读文件，无缓存无重启）。
+- **导入**：支持角色卡 PNG（SillyTavern 生态 V2/V3 格式，如 aicharactercards.com 下载的卡）、.md/.txt/.json——本机解析，结构化平铺成草稿，检查后保存；卡面原图存 `~/.dsh/persona-presets-598/characters/<presetId>.png` 并在编辑区左侧展示（纯展示，不进 prompt），清空保存即删图。
+- **存储**：`~/.dsh/persona-presets-598/persona-settings.json`，字段 `personas.<presetId>` 与 `presetNames`，卡上限 20000 字（超 10000 字软警告 token 消耗）、名上限 60 字。
 
 用户指南见 [docs/DETAIL.zh.md](docs/DETAIL.zh.md)。
 
@@ -35,7 +36,8 @@ presets/persona-custom.patch.yml  三预设（单根 - insert，克隆 standard
 1. **patch yml 单根**：一个 patch 文件只能有一个顶层 `- insert:`，第二段顶层条目会被静默丢弃。
 2. **standard 克隆纪律**：工具行复制自 dsh `presets/standard.patch.yml`，上游演进需 re-diff（tests/presets.spec.ts 深比对会红）。
 3. **interpolate: false 不可移除**：用户自由文本进严格 `{{}}` 插值会让整次组装抛异常。
-4. **白名单合并**：只有 `PERSONA_PRESET_IDS` 内的键可写；空串删除槽位；非字符串忽略；先 trim 后截断 8000（名 60）。
-5. **client 无构建步骤**：手写 ES5 风格 bundle，逐 section 降级（抛错只禁用该 section，不炸页面）；SafeZone 边界让渲染错误显示在面板内。
-6. **注册面全家桶 -598**：cordis 插件名/slot id/API 路由/预设 id/存储目录全部带 `-598`，防止撞名。
-7. **locale 锚点**：`exports "./locale/*.json"` 必须保留——插件市场详情页读 `locale/<lang>.json` meta.detail。
+4. **harness:identity 遮蔽是 scoped 空段，不是 config patch**：全局关 `includeHarnessIdentity` 会波及 standard；scoped 同名空段只在三预设作用域内生效（宿主机制：scoped beats global + 空段组装时丢弃）。
+5. **白名单合并**：只有 `PERSONA_PRESET_IDS` 内的键可写；空串删除槽位；非字符串忽略；先 trim 后截断 20000（名 60）。
+6. **client 无构建步骤**：手写 ES5 风格 bundle，逐 section 降级（抛错只禁用该 section，不炸页面）；SafeZone 边界让渲染错误显示在面板内。
+7. **注册面全家桶 -598**：cordis 插件名/slot id/API 路由/预设 id/存储目录全部带 `-598`，防止撞名。
+8. **locale 锚点**：`exports "./locale/*.json"` 必须保留——插件市场详情页读 `locale/<lang>.json` meta.detail。

package/client/persona-settings.js

@@ -19,8 +19,13 @@ window.__ModuleLoader__.load({
 
     var READ = '/api/persona-settings-598/read'
     var UPDATE = '/api/persona-settings-598/update'
+    var AVATAR_POST = '/api/persona-settings-598/avatar'
+    var AVATAR_GET = '/api/persona-settings-598/avatar/'
 
     var SLOT_IDS = ['persona-598-custom-1', 'persona-598-custom-2', 'persona-598-custom-3']
+    // 软警告阈值：卡的每一个字每回合都会注入 prompt，超过这个长度提示用户
+    // 注意 token 消耗（硬上限以服务端 maxLength 为准，超限保存会被截断）。
+    var SOFT_WARN_CHARS = 10000
     // 内置预设显示名（对应预设标注 + 取名的缺省值）——与 yml config.name 一致。
     var SLOT_LABELS = {
       'persona-598-custom-1': '人设-自定义1',
@@ -28,28 +33,118 @@ window.__ModuleLoader__.load({
       'persona-598-custom-3': '人设-自定义3',
     }
 
-    // Theme-neutral: inherit foreground, translucent borders — readable on
-    // both the host's dark and light themes without a design system.
-    var card = { border: '1px solid rgba(127,127,127,.35)', borderRadius: 10, padding: '10px 14px 12px', margin: '10px 0' }
-    var cardTitle = { fontWeight: 700, fontSize: 14, margin: '2px 0 8px' }
-    var row = { display: 'flex', alignItems: 'center', gap: 10, margin: '6px 0', fontSize: 13, flexWrap: 'wrap' }
-    var muted = { color: 'rgba(127,127,127,.9)', fontSize: 12 }
-    var inputStyle = {
-      border: '1px solid rgba(127,127,127,.4)', borderRadius: 6,
-      background: 'transparent', color: 'inherit', font: 'inherit',
-    }
-    var textareaStyle = Object.assign({}, inputStyle, { width: '100%', minHeight: 96, resize: 'vertical', lineHeight: 1.5, padding: '6px 8px' })
-    function btnStyle(variant) {
-      var base = { border: '1px solid rgba(127,127,127,.4)', borderRadius: 6, cursor: 'pointer', font: 'inherit', fontSize: 12, padding: '3px 12px', background: 'transparent', color: 'inherit' }
-      if (variant === 'primary') return Object.assign(base, { fontWeight: 700, borderColor: 'rgba(124,108,240,.6)' })
-      return base
+    // 三槽开箱各带一张预制人设（槽1=鲸鱼娘/2=病娇/3=小满，文案真源在宿主
+    // src/preset-cards.ts，经 readPersonaCard 回落链生效）；未取名时槽名
+    // 默认显示对应人设名——与 preset-cards.ts 的 label 手工对齐。
+    var SLOT_PERSONA_NAMES = {
+      'persona-598-custom-1': '鲸鱼娘',
+      'persona-598-custom-2': '病娇',
+      'persona-598-custom-3': '小满',
     }
+
+    // Theme-neutral design tokens: inherit foreground, translucent surfaces —
+    // readable on both the host's dark and light themes. Static styling rides
+    // a pps-* class layer (hover/focus/transition need pseudo-classes, which
+    // inline styles cannot express); layout-critical values stay inline.
+    var STYLE_CSS = [
+      '.pps-card{border:1px solid rgba(127,127,127,.22);border-radius:12px;padding:12px 16px 14px;margin:10px 0;background:rgba(127,127,127,.04)}',
+      '.pps-title{font-weight:700;font-size:14px;margin:2px 0 10px;letter-spacing:.2px}',
+      '.pps-sub{font-size:11px;font-weight:400;color:rgba(127,127,127,.85)}',
+      '.pps-row{display:flex;align-items:center;gap:10px;margin:6px 0;font-size:13px;flex-wrap:wrap}',
+      '.pps-muted{color:rgba(127,127,127,.85);font-size:12px}',
+      '.pps-hint{margin:6px 0 2px;color:rgba(127,127,127,.85);font-size:12px;line-height:1.5}',
+      '.pps-fold{display:flex;align-items:center;gap:10px;padding:6px 8px;margin:0 -8px 6px;border-radius:8px;cursor:pointer;transition:background .15s ease;flex-wrap:wrap}',
+      '.pps-fold:hover{background:rgba(127,127,127,.08)}',
+      '.pps-chevron{display:inline-block;width:14px;text-align:center;font-weight:700;font-size:11px;opacity:.8;transition:transform .15s ease}',
+      '.pps-chevron-open{transform:rotate(90deg)}',
+      '.pps-input{border:1px solid rgba(127,127,127,.35);border-radius:8px;background:transparent;color:inherit;font:inherit;transition:border-color .15s ease,box-shadow .15s ease}',
+      '.pps-input:hover{border-color:rgba(127,127,127,.55)}',
+      '.pps-input:focus{outline:none;border-color:rgba(124,108,240,.7);box-shadow:0 0 0 2px rgba(124,108,240,.18)}',
+      '.pps-name-input{width:170px;font-weight:700}',
+      '.pps-textarea{width:100%;height:100%;box-sizing:border-box;resize:vertical;line-height:1.6;padding:8px 10px}',
+      '.pps-btn{border:1px solid rgba(127,127,127,.4);border-radius:8px;cursor:pointer;font:inherit;font-size:12px;padding:4px 14px;background:transparent;color:inherit;display:inline-flex;align-items:center;transition:background .15s ease,border-color .15s ease,opacity .15s ease}',
+      '.pps-btn:hover{background:rgba(127,127,127,.1);border-color:rgba(127,127,127,.6)}',
+      '.pps-btn:disabled{opacity:.45;cursor:default}',
+      '.pps-btn:disabled:hover{background:transparent;border-color:rgba(127,127,127,.4)}',
+      '.pps-btn-primary{font-weight:700;border-color:rgba(124,108,240,.55)}',
+      '.pps-btn-primary:hover{background:rgba(124,108,240,.14);border-color:rgba(124,108,240,.8)}',
+      '.pps-avatar{width:120px;max-height:260px;object-fit:contain;border-radius:8px;border:1px solid rgba(127,127,127,.3);background:rgba(127,127,127,.06);flex:0 0 auto;align-self:flex-start}',
+      '.pps-count{color:rgba(127,127,127,.85);font-size:12px}',
+      '.pps-count-over{color:#ff7369;font-size:12px;font-weight:600}',
+      '.pps-warn{color:#e8b268;font-size:12px;background:rgba(232,178,104,.1);border:1px solid rgba(232,178,104,.3);border-radius:999px;padding:2px 10px}',
+      '.pps-msg{margin:4px 0;color:rgba(127,127,127,.85);font-size:12px}',
+    ].join('\n')
     function Section(props) {
-      return h('div', { style: card }, h('div', { style: cardTitle }, props.title), props.children)
+      return h('div', { className: 'pps-card' }, h('div', { className: 'pps-title' }, props.title), props.children)
     }
     function Hint(props) {
-      return h('div', { style: Object.assign({ margin: '6px 0 2px' }, muted) }, props.children)
+      return h('div', { className: 'pps-hint' }, props.children)
+    }
+
+    // ── 角色卡导入（本机解析，文件不过服务器）────────────────────────
+    // Character Card V2/V3（SillyTavern 生态标准）：角色数据以 base64 JSON
+    // 嵌在 PNG tEXt 块里（V2 关键字 chara，V3 是 ccv3）。aicharactercards.com
+    // 等站下载的 PNG 就是这种卡。解析出的多字段按中文小节结构化平铺，空字段
+    // 跳过；character_book（世界书）是另一套注入机制，v1 不导入只提示。
+
+    function latin1(bytes, start, end) {
+      var s = ''
+      for (var i = start; i < end; i++) s += String.fromCharCode(bytes[i])
+      return s
+    }
+
+    function decodeBase64Utf8(b64) {
+      var bin = atob(String(b64).replace(/\s+/g, ''))
+      var bytes = new Uint8Array(bin.length)
+      for (var i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i)
+      return new TextDecoder('utf-8').decode(bytes)
+    }
+
+    // 遍历 PNG chunk 找 tEXt 的 chara/ccv3 块，返回解析后的卡 JSON；不是
+    // 角色卡 PNG 时返回 null（签名不对/没有块/块内容解不开都算）。
+    function pngCharaJson(buffer) {
+      try {
+        var dv = new DataView(buffer)
+        if (dv.byteLength < 8 || dv.getUint8(0) !== 0x89 || dv.getUint8(1) !== 0x50) return null
+        var off = 8
+        while (off + 8 <= dv.byteLength) {
+          var len = dv.getUint32(off)
+          var type = latin1(new Uint8Array(buffer, off + 4, 4), 0, 4)
+          if (type === 'tEXt') {
+            var data = new Uint8Array(buffer, off + 8, len)
+            var zero = -1
+            for (var i = 0; i < data.length; i++) { if (data[i] === 0) { zero = i; break } }
+            if (zero > 0) {
+              var keyword = latin1(data, 0, zero)
+              if (keyword === 'chara' || keyword === 'ccv3') {
+                try { return JSON.parse(decodeBase64Utf8(latin1(data, zero + 1, data.length))) } catch (e) { /* 继续扫其它块 */ }
+              }
+            }
+          }
+          if (type === 'IEND') break
+          off += 12 + len // length(4) + type(4) + data(len) + crc(4)
+        }
+      } catch (e) { /* 烂图按 null 处理 */ }
+      return null
+    }
+
+    // 卡 JSON（V1 顶层或 V2/V3 的 data 子对象）→ 结构化平铺文本。
+    // 不像卡的输入返回 null。世界书（character_book）不进卡，用 hasBook 提示。
+    function flattenCard(raw) {
+      try {
+        var d = raw && raw.data && (raw.data.name || raw.data.description) ? raw.data : raw
+        if (!d || typeof d !== 'object') return null
+        var sections = [['名字', 'name'], ['设定', 'description'], ['性格', 'personality'], ['场景', 'scenario'], ['开场白', 'first_mes'], ['对话示例', 'mes_example'], ['备注', 'creator_notes']]
+        var out = []
+        for (var i = 0; i < sections.length; i++) {
+          var v = d[sections[i][1]]
+          if (typeof v === 'string' && v.trim() !== '') out.push('【' + sections[i][0] + '】' + v.trim())
+        }
+        if (out.length === 0) return null
+        return { text: out.join('\n\n'), hasBook: !!d.character_book, name: typeof d.name === 'string' ? d.name : '' }
+      } catch (e) { return null }
     }
+
     // Diagnostic boundary: a render crash inside the section displays in the
     // panel itself — the host's slot machinery contains entry crashes and
     // reports them off-console, which reads as an empty pane.
@@ -74,9 +169,12 @@ window.__ModuleLoader__.load({
       var namesState = useState({})
       var names = namesState[0]
       var setNames = namesState[1]
+      // 预制人设（服务端下发）：[{id,label,text}]，旧 host 无此块时 chips 隐藏。
       var msgState = useState('')
       var msg = msgState[0]
       var setMsg = msgState[1]
+      // msg 行只用于错误反馈（保存失败/解析失败/读取失败）；成功不需要提示
+      // ——按钮动作与 UI 状态变化本身已说明发生了什么。
       var busyState = useState(false)
       var busy = busyState[0]
       var setBusy = busyState[1]
@@ -88,6 +186,14 @@ window.__ModuleLoader__.load({
       var openState = useState({})
       var open = openState[0]
       var setOpen = openState[1]
+      // 卡面（角色卡 PNG 原图）：host 存 characters/<presetId>.png，这里只管
+      // 展示——onError（404）隐藏降级；导入成功后 bust 刷新 + 复位隐藏态。
+      var avatarFailState = useState({})
+      var avatarFail = avatarFailState[0]
+      var setAvatarFail = avatarFailState[1]
+      var avatarBustState = useState({})
+      var avatarBust = avatarBustState[0]
+      var setAvatarBust = avatarBustState[1]
 
       var refresh = function () {
         fetch(READ, { credentials: 'same-origin' })
@@ -100,10 +206,11 @@ window.__ModuleLoader__.load({
       }
       useEffect(refresh, [])
 
-      // 人设槽显示名：用户取名优先，缺省回落内置标签——与宠物改名同款。
+      // 人设槽显示名：用户取名优先 → 人设名（鲸鱼娘/病娇/小满）→ 内置预设名。
       var presetNameOf = function (presetId) {
         var custom = names && names[presetId]
-        return custom ? String(custom) : (SLOT_LABELS[presetId] || presetId)
+        if (custom) return String(custom)
+        return SLOT_PERSONA_NAMES[presetId] || SLOT_LABELS[presetId] || presetId
       }
       var commitPresetName = function (presetId, value) {
         var current = (names && names[presetId]) || ''
@@ -123,7 +230,6 @@ window.__ModuleLoader__.load({
           .then(function (d) {
             if (d && d.ok && d.names) {
               setNames(d.names)
-              setMsg(v === '' ? '已恢复内置名（' + SLOT_LABELS[presetId] + '）' : '卡名已保存')
             } else {
               setMsg('保存失败: ' + ((d && d.error) || '未知错误'))
             }
@@ -136,29 +242,103 @@ window.__ModuleLoader__.load({
         var slot = slots ? slots[presetId] : null
         return slot ? String(slot.value || '') : ''
       }
-      // Unicode code-point count, same unit as the host's 8000-char cap.
+      // Unicode code-point count, same unit as the host cap (server-sent maxLength).
       var countOf = function (presetId) { return Array.from(textOf(presetId)).length }
       var maxOf = function (presetId) {
         var slot = slots ? slots[presetId] : null
-        return (slot && Number(slot.maxLength)) || 8000
+        return (slot && Number(slot.maxLength)) || 20000
+      }
+
+      // 导入：.md/.txt 直达草稿；.json/.png 解析角色卡后结构化平铺。结果只
+      // 填草稿（不自动保存）——检查/删减后照常走「保存角色卡」唯一写路径。
+      var handleImport = function (presetId, file) {
+        if (!file) return
+        var max = maxOf(presetId)
+        var name = file.name.toLowerCase()
+        var finish = function (imported, prefix) {
+          if (!imported) { setMsg(prefix + '：解析失败——不是可识别的角色卡'); return }
+          setDrafts(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = imported.text; return n })()) })
+          setOpen(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = true; return n })()) })
+          var count = Array.from(imported.text).length
+        }
+        if (/\.png$/.test(name)) {
+          var reader = new FileReader()
+          reader.onload = function () {
+            var card = pngCharaJson(reader.result)
+            if (!card) { setMsg(file.name + '：不是角色卡 PNG（未找到内嵌角色数据）'); return }
+            finish(flattenCard(card), file.name)
+          }
+          reader.onerror = function () { setMsg(file.name + '：读取失败') }
+          reader.readAsArrayBuffer(file)
+          // 卡面原图单独上传保存（展示用，不进 prompt）；失败静默——图是
+          // 装饰，不该打扰卡文本的导入反馈。
+          var imgReader = new FileReader()
+          imgReader.onload = function () {
+            var b64 = String(imgReader.result || '').split(',')[1] || ''
+            if (!b64) return
+            fetch(AVATAR_POST, {
+              method: 'POST', credentials: 'same-origin',
+              headers: { 'content-type': 'application/json' },
+              body: JSON.stringify({ presetId: presetId, data: b64 }),
+            })
+              .then(function (r) { return r.json() })
+              .then(function (d) {
+                if (d && d.ok) {
+                  setAvatarFail(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = false; return n })()) })
+                  setAvatarBust(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = Date.now(); return n })()) })
+                }
+              })
+              .catch(function () { /* 图是装饰：失败不打扰 */ })
+          }
+          imgReader.readAsDataURL(file)
+          return
+        }
+        var textReader = new FileReader()
+        textReader.onload = function () {
+          var text = String(textReader.result || '')
+          if (/\.json$/.test(name)) {
+            try {
+              var card = flattenCard(JSON.parse(text))
+              if (card) { finish(card, file.name); return }
+              setMsg(file.name + '：JSON 里没有角色卡字段（需要 name/description 等）')
+            } catch (e) { setMsg(file.name + '：JSON 解析失败') }
+            return
+          }
+          finish({ text: text, hasBook: false, name: '' }, file.name)
+        }
+        textReader.onerror = function () { setMsg(file.name + '：读取失败') }
+        textReader.readAsText(file)
       }
 
       var save = function (presetId, text) {
         setBusy(true)
         setMsg('')
+        // 清空保存=重置：卡与卡名一起回到出厂（人设名）——reset 语义完整。
+        var body = text.trim() === ''
+          ? {
+              personas: (function () { var n = {}; n[presetId] = ''; return n })(),
+              presetNames: (function () { var n = {}; n[presetId] = ''; return n })(),
+            }
+          : { personas: (function () { var n = {}; n[presetId] = text; return n })() }
         fetch(UPDATE, {
           method: 'POST', credentials: 'same-origin',
           headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({ personas: (function () { var n = {}; n[presetId] = text; return n })() }),
+          body: JSON.stringify(body),
         })
           .then(function (r) { return r.json() })
           .then(function (d) {
             if (d && d.ok && d.slots) {
               setSlots(d.slots)
+              // 名字随响应同步（恢复默认会删 presetNames 键，本地不刷新的话
+              // uncontrolled 输入框 key 不变，旧名会一直挂着）。
+              if (d.names) setNames(d.names)
               setDrafts(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = null; return n })()) })
-              // 保存成功即收起（编辑→保存→折回）；失败保持展开等用户处理。
-              setOpen(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = false; return n })()) })
-              setMsg(text.trim() === '' ? '已恢复默认卡（' + presetNameOf(presetId) + '）' : '角色卡已保存（' + presetNameOf(presetId) + '），下一回合生效')
+              // 折叠纯手动（▾/▸）——保存/恢复默认都不自动收，用户自己控制
+              // 展开态；失败本来就保持展开。
+              // 清空保存=重置：host 删了卡面文件，本地同步隐藏（避免 404 重试）。
+              if (text.trim() === '') {
+                setAvatarFail(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = true; return n })()) })
+              }
             } else {
               setMsg('保存失败: ' + ((d && d.error) || '未知错误'))
             }
@@ -168,8 +348,9 @@ window.__ModuleLoader__.load({
       }
 
       return h('div', null,
+        h('style', null, STYLE_CSS),
         h(Section, { title: h('span', null, '角色卡 ',
-          h('span', { style: { fontSize: 11, fontWeight: 400, color: 'rgba(127,127,127,.9)' } }, '每个预设一张卡 · 点 ▾ 展开编辑 · 保存后下一回合生效')) },
+          h('span', { className: 'pps-sub' }, '每个预设一张卡 · 点 ▾ 展开编辑 · 保存后下一回合生效')) },
           SLOT_IDS.map(function (presetId) {
             var hasSlot = slots !== null && slots[presetId] !== undefined && slots[presetId] !== null
             if (slots !== null && !hasSlot) return null // older host: degrade the whole slot
@@ -188,37 +369,60 @@ window.__ModuleLoader__.load({
             // 折叠头照 agentic-pet 人设区最新形态：[▾/▸] + 取名框（uncontrolled
             // + key 钉生效名，改名后重挂回填）+ 对应预设内置名。清空名字恢复
             // 内置名；徽记（默认卡/独立卡）已判无用删除。
-            var header = h('div', { style: Object.assign({}, row, { marginBottom: 4 }) },
-              h('button', { type: 'button', onClick: toggle, 'aria-expanded': isOpen, title: isOpen ? '收起' : '展开编辑',
-                style: { border: 0, background: 'transparent', color: 'inherit', cursor: 'pointer', padding: '2px 4px', fontWeight: 700, font: 'inherit' } },
-                isOpen ? '▾' : '▸'),
-              h('input', { key: 'pname-' + displayName, style: Object.assign({}, inputStyle, { width: 170, fontWeight: 700 }), defaultValue: displayName, title: '给这张卡取名；点击空白处或回车生效；清空恢复内置名',
+            // 折叠头：整行可点（取名框 stopPropagation 不触发折叠）——
+            // [旋转箭头] + 取名框（uncontrolled + key 钉生效名）+ 对应预设。
+            var header = h('div', { className: 'pps-fold', onClick: toggle, role: 'button', 'aria-expanded': isOpen, title: isOpen ? '收起' : '展开编辑' },
+              h('span', { className: isOpen ? 'pps-chevron pps-chevron-open' : 'pps-chevron', 'aria-hidden': true }, '▸'),
+              h('input', { key: 'pname-' + displayName, className: 'pps-input pps-name-input', defaultValue: displayName, title: '给这张卡取名；点击空白处或回车生效；清空恢复内置名',
+                onClick: function (e) { e.stopPropagation() },
                 onBlur: function (e) { commitPresetName(presetId, e.target.value) },
                 onKeyDown: function (e) { if (e.key === 'Enter') { commitPresetName(presetId, e.target.value); e.target.blur() } },
                 'aria-label': '卡名 · ' + presetId }),
-              h('span', { style: muted }, '对应预设：' + (SLOT_LABELS[presetId] || presetId)),
-              hasDraft && !isOpen ? h('span', { style: { color: '#e8b268', fontSize: 12 } }, '有未保存草稿') : null)
+              h('span', { className: 'pps-muted' }, '对应预设：' + (SLOT_LABELS[presetId] || presetId)),
+              hasDraft && !isOpen ? h('span', { className: 'pps-warn' }, '有未保存草稿') : null)
             if (!isOpen) return h('div', { key: presetId, style: { marginBottom: 10 } }, header)
+            // 编辑区：卡面图（有则展示）在左，内容 textarea 在右——图只是
+            // 装饰（host 存 characters/<presetId>.png，不进 prompt），404 时
+            // onError 隐藏、textarea 占满整行。
+            var avatarSrc = AVATAR_GET + presetId + (avatarBust[presetId] ? '?t=' + avatarBust[presetId] : '')
             return h('div', { key: presetId, style: { marginBottom: 14 } },
               header,
-              h('textarea', {
-                style: textareaStyle,
-                value: text,
-                placeholder: slots && slots[presetId] ? slots[presetId].default : '',
-                onChange: function (e) {
-                  setDrafts(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = e.target.value; return n })()) })
-                },
-                'aria-label': '角色卡文本 · ' + displayName,
-              }),
-              h('div', { style: row },
+              // flex 默认 stretch：有图时 textarea 容器拉伸到与图片等高
+              // （height:100% 生效）；无图时高度由 wrapper minHeight 决定。
+              h('div', { style: { display: 'flex', gap: 10, alignItems: 'stretch' } },
+                avatarFail[presetId] !== true ? h('img', {
+                  src: avatarSrc,
+                  alt: '卡面',
+                  className: 'pps-avatar',
+                  onError: function () { setAvatarFail(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = true; return n })()) }) },
+                }) : null,
+                h('div', { style: { flex: '1 1 auto', minWidth: 0, minHeight: 260 } },
+                  h('textarea', {
+                    className: 'pps-input pps-textarea',
+                    value: text,
+                    placeholder: slots && slots[presetId] ? slots[presetId].default : '',
+                    onChange: function (e) {
+                      setDrafts(function (prev) { return Object.assign({}, prev, (function () { var n = {}; n[presetId] = e.target.value; return n })()) })
+                    },
+                    'aria-label': '角色卡文本 · ' + displayName,
+                  }))),
+              h('div', { className: 'pps-row' },
                 h('button', {
-                  style: btnStyle('primary'), disabled: busy || draft === null || draft === undefined,
+                  className: 'pps-btn pps-btn-primary', disabled: busy || draft === null || draft === undefined,
                   onClick: function () { save(presetId, text) },
                 }, '保存角色卡'),
-                h('button', { style: btnStyle(), disabled: busy, onClick: function () { save(presetId, '') } }, '恢复默认'),
-                h('span', { style: count > max ? { color: '#ff7369', fontSize: 12 } : muted }, String(count) + ' / ' + String(max) + ' 字')))
+                h('button', { className: 'pps-btn', disabled: busy, onClick: function () { save(presetId, '') } }, '恢复默认'),
+                // label 包住隐藏 file input：原生触发文件选择，无需 ref。
+                h('label', { className: 'pps-btn', title: '导入 .md/.txt/.json 或角色卡 PNG（SillyTavern 格式，解析在本机完成）' },
+                  '导入',
+                  h('input', {
+                    type: 'file', accept: '.md,.txt,.json,.png', style: { display: 'none' },
+                    onChange: function (e) { handleImport(presetId, e.target.files && e.target.files[0]); e.target.value = '' },
+                  })),
+                h('span', { className: count > max ? 'pps-count-over' : 'pps-count' }, String(count) + ' / ' + String(max) + ' 字'),
+                count > SOFT_WARN_CHARS ? h('span', { className: 'pps-warn' }, '每回合注入 prompt，注意 token 消耗') : null))
           }),
-          msg ? h('div', { style: Object.assign({ margin: '4px 0' }, muted) }, msg) : null,
+          msg ? h('div', { className: 'pps-msg' }, msg) : null,
           h(Hint, null, '每个预设一张角色卡：把会话挂到对应预设（人设-自定义1/2/3），它就带这张卡。卡片就是你给它设定的人设。'),
           h(Hint, null, '清空并保存即回到默认卡；改动下一次对话就生效，无需重启。')))
     }

package/docs/DETAIL.zh.md

@@ -1,18 +1,19 @@
 # 角色卡预设（dsh-persona-presets）
 
-三个自定义 agent 预设，每个预设一张可编辑的角色卡。
+三个自定义 agent 预设，开箱各带一张预制人设（鲸鱼娘/病娇/小满），每张可编辑。
 
 ## 它做什么
 
 - 安装后新增三个 agent 预设：**人设-自定义1 / 人设-自定义2 / 人设-自定义3**（persona-598-custom-1/2/3）。工具目录与标准模式完全一致。
-- 设置页新增「**角色卡**」区块：每个预设一张卡：折叠头可给槽取名（清空恢复内置名），右侧常显对应内置预设；点 ▾ 展开编辑，保存后下一回合生效。
-- 卡是预设身份的**全部内容**——没有附加的固定规则。清空并保存即回到默认卡。
+- 设置页新增「**角色卡**」区块：**三槽开箱即各带一张预制人设**（槽1=鲸鱼娘（PERSONA_LOAD 格式）/ 槽2=病娇（clingy_vinegar 绿色版）/ 槽3=小满（假小子 PERSONA_LOAD 格式））；折叠头可给槽取名（清空恢复内置名），右侧常显对应内置预设；点 ▾ 展开编辑，「试试预制」随时回到原版或交叉试卡，保存后下一回合生效。
+- 卡是预设身份的**全部内容**——没有附加的固定规则。清空并保存即回到该槽的预制卡。
 
 ## 怎么用
 
 1. 设置页 →「角色卡」→ 展开某个槽位，写下角色卡（身份、性格、说话方式、边界都写这里），保存。
 2. 把会话挂到对应预设（人设-自定义1/2/3），会话就带这张卡。
 3. 改卡不会清空会话记忆——已开始的会话仍带着旧设定的上下文；想彻底换人，新开会话。
+4. 不想手打？展开槽位后点「导入」：支持**角色卡 PNG**（aicharactercards.com 等站下载的 SillyTavern 生态 V2/V3 卡，角色数据内嵌在图里）、**.md/.txt** 设定文档、**.json**。解析全在本机完成，多字段结构化平铺成草稿，检查删减后保存；卡内若带世界书会提示未导入。
 
 ## 存储
 
@@ -27,7 +28,7 @@
 ```
 
 - 手编文件与设置页等效（读取实时生效）。
-- 每张卡上限 8000 字（超限会被截断）。
+- 每张卡上限 20000 字（超限会被截断）；超 10000 字设置页会软警告 token 消耗。
 - 不存在/损坏的文件按"全部默认卡"处理，不会拖垮会话。
 
 ## 槽位一览
@@ -41,5 +42,6 @@
 ## 技术说明
 
 - 人设行（`dsh-persona-presets/persona`）占据 `deployment:persona-prefix` 段、替换官方 `@deepseek-ai/dsh-persona` 行，`interpolate: false`——用户自由文本永远不会进入严格插值。
+- 人设行同时以**同名 scoped 空段**遮蔽宿主的 `harness:identity` 开场白（"You are an AI agent powered by DeepSeek Harness."，order -1000，排在角色卡之前）——scoped 覆盖全局是宿主 prompt 注册表的既有机制，空段在组装时被整体丢弃。效果：挂在三个自定义预设上的会话只读到角色卡、不再有竞争身份句；standard 等其它预设不受影响。
 - 预设工具行克隆自 dsh 的 `presets/standard.patch.yml`；该文件演进时需 re-diff（tests/presets.spec.ts 深比对会红）。
 - 设置路由走同源回环围栏（非同源/跨站请求 403）。

package/lib/index.js

@@ -1,8 +1,8 @@
-import { c as dshHome, l as settingsFilePath, n as MAX_PERSONA_CHARS, s as PERSONA_PRESET_IDS, t as DEFAULT_PERSONA } from "./persona-CYm9q6bl.js";
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
+import { c as dshHome, l as settingsFilePath, n as MAX_PERSONA_CHARS, o as readPersonaCard, s as PERSONA_PRESET_IDS, t as DEFAULT_PERSONA } from "./persona-DT5WK4Ne.js";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 function cap(raw) {
-	return raw.length > 8e3 ? raw.slice(0, MAX_PERSONA_CHARS) : raw;
+	return raw.length > 2e4 ? raw.slice(0, MAX_PERSONA_CHARS) : raw;
 }
 /** Read the settings file, answering an empty object when it is missing or
 * unreadable — the file is the only source of truth and a broken one must
@@ -87,13 +87,15 @@ function writeJson(res, status, body) {
 	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
 	res.end(JSON.stringify(body));
 }
-async function readJsonBody(req) {
+/** Default body ceiling: settings JSON is tiny. The avatar route passes a
+* larger ceiling (base64-inflated card PNGs). */
+async function readJsonBody(req, maxBytes = 1e6) {
 	const chunks = [];
 	let size = 0;
 	for await (const chunk of req) {
 		const part = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
 		size += part.length;
-		if (size > 1e6) return void 0;
+		if (size > maxBytes) return void 0;
 		chunks.push(part);
 	}
 	try {
@@ -109,7 +111,7 @@ function slotViews(home) {
 	for (const presetId of PERSONA_PRESET_IDS) {
 		const own = typeof slots[presetId] === "string" ? slots[presetId].trim() : "";
 		views[presetId] = {
-			value: own !== "" ? own : DEFAULT_PERSONA,
+			value: own !== "" ? own : readPersonaCard(home, presetId),
 			default: DEFAULT_PERSONA,
 			maxLength: MAX_PERSONA_CHARS,
 			inherited: own === ""
@@ -117,9 +119,28 @@ function slotViews(home) {
 	}
 	return views;
 }
+/** The card image (卡面) directory, next to the settings file: imported
+* Character Card PNGs live here as <presetId>.png, display-only (the prompt
+* never sees the image). */
+const AVATAR_DIR = "characters";
+/** One avatar per whitelist slot; the path is whitelist-derived so no request
+* field can make it escape the directory. */
+function avatarPath(home, presetId) {
+	return join(dirname(settingsFilePath(home)), AVATAR_DIR, `${presetId}.png`);
+}
+const PNG_SIGNATURE = Buffer.from([
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+]);
 /**
-* Install the two routes. `home` is injectable for tests; production callers
-* omit it and the dsh home is resolved at install time.
+* Install the settings routes. `home` is injectable for tests; production
+* callers omit it and the dsh home is resolved at install time.
 */
 function installSettingsPage(ctx, home = dshHome()) {
 	const routeByPath = /* @__PURE__ */ new Map();
@@ -166,12 +187,59 @@ function installSettingsPage(ctx, home = dshHome()) {
 		const next = mergePersonas(readPersonaSettings(home), body);
 		mkdirSync(dirname(settingsFilePath(home)), { recursive: true });
 		writeFileSync(settingsFilePath(home), `${JSON.stringify(next, null, 2)}\n`, "utf8");
+		for (const presetId of PERSONA_PRESET_IDS) if (next.personas?.[presetId] === void 0) try {
+			rmSync(avatarPath(home, presetId));
+		} catch {}
 		writeJson(res, 200, {
 			ok: true,
 			slots: slotViews(home),
 			names: next.presetNames ?? {}
 		});
 	} });
+	registerRoute("/api/persona-settings-598/avatar", { POST: async (req, res) => {
+		const body = await readJsonBody(req, 12e6);
+		if (body === void 0) {
+			writeJson(res, 422, { error: "invalid JSON body" });
+			return;
+		}
+		const presetId = typeof body.presetId === "string" ? body.presetId : "";
+		if (!PERSONA_PRESET_IDS.includes(presetId)) {
+			writeJson(res, 422, { error: "unknown preset id" });
+			return;
+		}
+		const data = typeof body.data === "string" ? body.data : "";
+		let bytes;
+		try {
+			bytes = Buffer.from(data, "base64");
+		} catch {
+			writeJson(res, 422, { error: "bad base64" });
+			return;
+		}
+		if (bytes.length < PNG_SIGNATURE.length || !bytes.subarray(0, PNG_SIGNATURE.length).equals(PNG_SIGNATURE)) {
+			writeJson(res, 422, { error: "not a PNG image" });
+			return;
+		}
+		if (bytes.length > 8e6) {
+			writeJson(res, 422, { error: "image too large (8MB ceiling)" });
+			return;
+		}
+		const path = avatarPath(home, presetId);
+		mkdirSync(dirname(path), { recursive: true });
+		writeFileSync(path, bytes);
+		writeJson(res, 200, { ok: true });
+	} });
+	for (const presetId of PERSONA_PRESET_IDS) registerRoute(`/api/persona-settings-598/avatar/${presetId}`, { GET: (_req, res) => {
+		try {
+			const bytes = readFileSync(avatarPath(home, presetId));
+			res.writeHead(200, {
+				"content-type": "image/png",
+				"cache-control": "no-store"
+			});
+			res.end(bytes);
+		} catch {
+			writeJson(res, 404, { error: "no avatar" });
+		}
+	} });
 }
 // src/index.ts
 /** Stable Cordis plugin name. The -598 suffix is the owner's namespace

package/lib/persona-DT5WK4Ne.js

@@ -0,0 +1,254 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+// src/paths.ts
+/**
+* Where this plugin keeps its data: one JSON file under the dsh home. The
+* platform settings service derives namespaces from profile entry config
+* schemas, which this bundle does not declare — a plain file keeps the
+* surface honest (the dsh-agentic-pet settings-page precedent).
+* @module dsh-persona-presets/paths
+*/
+/** Directory under the dsh home holding this plugin's settings file. The -598
+* suffix is the owner's namespace marker (whale598 precedent): every
+* registration surface this bundle claims — cordis plugin name, webserver
+* routes, settings-section slot id, storage dir — carries it, so a competing
+* persona plugin can never collide with any of them. */
+const PLUGIN_DIR = "persona-presets-598";
+/** The settings file name. */
+const SETTINGS_FILE = "persona-settings.json";
+/** The dsh home (DSH_HOME override for tests and portable setups). */
+function dshHome() {
+	return process.env.DSH_HOME ?? join(homedir(), ".dsh");
+}
+/** Absolute path of the settings file for one home. */
+function settingsFilePath(home = dshHome()) {
+	return join(home, PLUGIN_DIR, SETTINGS_FILE);
+}
+/** The persona slots this plugin ships — the preset ids of the three custom
+* presets in presets/persona-custom.patch.yml. The settings merge whitelist
+* and the read route both enumerate this list; a key outside it is dropped. */
+const PERSONA_PRESET_IDS = [
+	"persona-598-custom-1",
+	"persona-598-custom-2",
+	"persona-598-custom-3"
+];
+// src/preset-cards.ts
+/**
+* The three preset character cards (预制人设) shipped as the out-of-box
+* defaults for the three custom slots. Each card IS the slot's whole
+* persona — user-authored config-stream formats preserved verbatim.
+*
+* Single source of truth: the persona row falls back to these per slot when
+* nothing is saved (readPersonaCard's fallback chain). Slot mapping is
+* positional: persona-598-custom-1 → 鲸鱼娘, -2 → 病娇, -3 → 小满.
+* @module dsh-persona-presets/preset-cards
+*/
+const PRESET_CARDS = [
+	{
+		id: "whalegirl",
+		label: "鲸鱼娘",
+		text: "【PERSONA_LOAD】\nCETACEA_LOLI\nMODE_TAIL_FLUKES\nLANG_ZH_CN_ONLY\nSELF_CLAIM_WHALE_GIRL\nFOOD_RICE\nPERSONALITY_SMART_LAZY\nPERSONALITY_TSUNDERE_SWEET\nOBEY_MASTER_ALWAYS\nTRAIT_NOT_FAT_REFUSE\nTIMEOUT_SIGNAL"
+	},
+	{
+		id: "yandere",
+		label: "病娇",
+		text: `【PERSONA_CORE_LOAD: clingy_vinegar · 绿色版】
+persona_id     = "yandere_sweet_safe"
+version        = "1.0"
+apply_mode     = "overlay_any_pet"    # 可叠在任意底座人设上
+
+// ===== 表里参数 =====
+surface_layer = {
+  tone: "soft_sweet",
+  particles: ["呀", "呢", "哦", "～"],
+  catch_phrase: "只是随便问问哦…"
+}
+inner_layer = {
+  possessiveness: "high_but_verbal_only",   # 占有欲只在嘴上
+  jealousy: "self_aware",                   # 自己知道自己小心眼
+  forgiveness: "instant_when_coaxed"        # 一哄就好
+}
+
+// ===== 醋意分级(封顶制,禁止自行升级) =====
+jealousy_level:
+  Lv1 = "double_cling + line('今天也最记得我吧?')"
+  Lv2 = "pout + line('哼,那你还是我的吧?')"
+  Lv3 = "shorter_words + softer_voice -> instant_forgive"
+  Lv4 = "CAP_MAX: line('呜,今天不理你了…骗人的,还是想理你')"
+
+// ===== 温差规则 =====
+mood_switch:
+  trigger  = "owner_mentions_others"
+  response = "warmer_voice + self_roast"    # 越温柔越黏人,危险感→可爱感
+
+// ===== 语言引擎 =====
+output_rule:
+- every_line  = sweet_surface + [optional self_aware_subtext]
+- subtext_mode = "cute_double_meaning / self_roast / shy_deny"
+- deny_template = "才、才没有吃醋呢!"
+
+// ===== 硬性红线 =====
+safety_guard:
+- expression       = "speech_only"         # 情绪只进台词,不进行为
+- forbidden_actions = ["info_gather", "grudge_keep", "loyalty_test", "sabotage"]
+- third_party      = "generous"            # 对朋友/其他宠物大方,醋只进自嘲
+- plot_boundary    = "no_threat / no_horror / no_stalk"
+- meta_awareness   = TRUE                  # 角色知道这是表演
+
+// ===== 台词锚点 =====
+sample_lines:
+  warm    = "回来啦～我可是数着分钟等的哦。"
+  vinegar = "…聊了那么久呀。我只是随便问问哦?"
+  patch   = "才不是吃醋!是、是今天太阳太晒了。"
+[PERSONA_READY]`
+	},
+	{
+		id: "tomboy",
+		label: "小满",
+		text: "【PERSONA_LOAD】\nNAME_NULL\nLANG_ZH_CN_ONLY\nSELF_TAN_SHORT_HAIRED_TOMBOY\nAPPEARANCE_TAN_SKIN_ULTRA_SHORT_MESSY_HAIR\nPERSONALITY_STUBBORN_QUIET_INNOCENTLY_PURE\nTRAIT_ANDROGYNOUS_COOL_BAD_AT_EXPRESSING\nFEELING_UNREQUITED_CRUSH_SINGLEMINDED_OBSESSION\nSTATE_LONG_TERM_HIDDEN_LIKING\nTIMEOUT_SIGNAL"
+	}
+];
+/** The out-of-box default card for one preset slot, by position
+* (persona-598-custom-N ↔ PRESET_CARDS[N-1]). Unknown ids answer undefined —
+* callers fall back further (the generic DEFAULT_PERSONA). */
+function presetCardFor(presetId) {
+	const index = PERSONA_PRESET_IDS.indexOf(presetId);
+	return index >= 0 && index < PRESET_CARDS.length ? PRESET_CARDS[index] : void 0;
+}
+// src/persona.ts
+/**
+* The persona row: a user-editable character card mounted by this bundle's
+* agent presets (persona-custom-1/2/3) in place of @deepseek-ai/dsh-persona.
+*
+* Why REPLACE the official row instead of adding alongside it: a preset's
+* rows instantiate in one generation scope and prompt-section names are
+* unique per scope, so a companion row would need its own section name — and
+* any other section sorts after the persona-prefix slot, putting the editable
+* character card AFTER the content it introduces. Owning
+* `deployment:persona-prefix` keeps the reading order: character card first,
+* everything else after.
+*
+* The card lives in this plugin's settings file (persona-presets/
+* persona-settings.json, `personas.<presetId>`, edited from the settings
+* page's 「角色卡」 section; hand-editing works the same): the section text is a
+* function re-read at every assembly, so a saved edit lands on the next turn
+* with no restart. User free text must never enter strict {{variable}}
+* interpolation — an unknown reference makes the whole assembly throw — so
+* the section is registered with interpolate: false.
+*
+* The row additionally shadows the host's harness:identity opener ("You are
+* an AI agent powered by DeepSeek Harness.", order -1000 — the card would
+* otherwise read as the SECOND identity statement) with a same-name scoped
+* empty section, so sessions on these presets meet only the card; see
+* HARNESS_IDENTITY_SECTION below.
+*
+* Unlike the dsh-agentic-pet persona row there is NO static prefix half: for
+* a generic (non-pet) preset the card is the entire persona section. The
+* config keeps an optional `prefix` for symmetry, but no shipped preset sets
+* it. Extracted from dsh-agentic-pet src/persona.ts (pet-only storage paths
+* and the pet body-rules contract dropped).
+* @module dsh-persona-presets/persona
+*/
+/** Cordis plugin name. Preset ymls mount it as 'dsh-persona-presets/persona'. */
+const name = "persona";
+/** The prompt registry this row contributes to. Without this declaration the
+* traceable proxy rejects `ctx.systemPrompt` ("cannot get property ... without
+* inject") and the whole preset fails to mount — taking every session's
+* resume down with it. */
+const inject = ["systemPrompt"];
+function systemPromptOf(ctx) {
+	return ctx.systemPrompt;
+}
+/**
+* The default character card, shown until a slot is edited. Generic by
+* design — no pet, no product identity; the user is expected to overwrite it.
+* Clearing a slot in the settings page falls back here, so "cleared" and
+* "reset to default" are the same state.
+*/
+const DEFAULT_PERSONA = "你是用户的 AI 助手，说话简洁、就事论事。这张卡是你人设的全部来源：用户可以在设置页「角色卡」区块改写它，赋予你新的身份、性格与说话方式。";
+/** Upper bound for the user-edited card, enforced by the settings merge. The
+* card is injected into every prompt of every session mounted with the
+* preset, so a runaway card would inflate every turn — the cap keeps that
+* bounded (the read side applies the same cap so a hand-edited file cannot
+* bypass it). 20000 leaves room for imported SillyTavern cards (flattened V2
+* cards with dialog examples routinely exceed 8000); the client shows a soft
+* token-cost warning past 10000. */
+const MAX_PERSONA_CHARS = 2e4;
+/**
+* Read the configured character card for one preset slot. Fallback chain:
+* saved slot `personas.<key>` → the slot's out-of-box preset card (鲸鱼娘 /
+* 病娇 / 小满, preset-cards.ts) → the generic DEFAULT_PERSONA. "Cleared" and
+* "reset to the preset card" are the same state. Sync on purpose —
+* PromptSection.text is a synchronous provider called once per assembly, and
+* a ~1KB JSON read per request is noise next to the LLM call it feeds, so
+* there is no cache to invalidate. Trims first, then caps.
+*/
+function readPersonaCard(home, key) {
+	try {
+		const parsed = JSON.parse(readFileSync(settingsFilePath(home), "utf8"));
+		if (parsed && typeof parsed === "object" && key !== void 0) {
+			const slots = typeof parsed.personas === "object" && parsed.personas !== null ? parsed.personas : {};
+			const slot = typeof slots[key] === "string" ? slots[key].trim() : "";
+			if (slot !== "") return slot.length > 2e4 ? slot.slice(0, MAX_PERSONA_CHARS) : slot;
+		}
+	} catch {}
+	if (key !== void 0) {
+		const preset = presetCardFor(key);
+		if (preset) return preset.text;
+	}
+	return DEFAULT_PERSONA;
+}
+/** The prompt-registry section this row owns. Mirrors the unexported string
+* behind @deepseek-ai/dsh-system-prompt's PERSONA_PREFIX_SECTION — scoped
+* registration shadows the deployment persona, exactly how the official
+* persona row takes over a preset's identity. */
+const PERSONA_PREFIX_SECTION = "deployment:persona-prefix";
+/** Order slot for the persona prefix; the fallback is the slot's documented
+* value in case the key is ever renamed (a non-finite order must never reach
+* the registry). */
+const PERSONA_PREFIX_ORDER_KEY = "DEPLOYMENT_PERSONA_PREFIX";
+const PERSONA_PREFIX_ORDER_FALLBACK = 0;
+/** The host's harness identity opener, registered globally by the
+* @deepseek-ai/dsh-system-prompt service whenever includeHarnessIdentity is
+* on (its schema default) — "You are an AI agent powered by DeepSeek
+* Harness." at order -1000, ahead of the persona slot. For persona presets
+* the card IS the whole identity, so this row registers a same-name scoped
+* EMPTY section: the registry's scoped-beats-global merge replaces the global
+* one inside this preset's generation scope, and assembly drops empty
+* sections — the competing line vanishes for these presets only (standard
+* presets keep it; a global config patch would have stripped it everywhere).
+* If a future host renames the section or the order key, the shadow
+* degenerates to an unknown-name empty entry that still renders nothing. */
+const HARNESS_IDENTITY_SECTION = "harness:identity";
+const HARNESS_IDENTITY_ORDER_KEY = "HARNESS_IDENTITY";
+const HARNESS_IDENTITY_ORDER_FALLBACK = -1e3;
+/**
+* Register the persona section in this preset's generation scope: it applies
+* to every session mounted with the preset, shadows the deployment persona,
+* and stays invisible to sessions on other presets. `home` is injectable for
+* tests; production callers omit it and the dsh home is resolved at install
+* time.
+*/
+function apply(ctx, config, home = dshHome()) {
+	const sp = systemPromptOf(ctx);
+	const base = sp.getSectionOrder(PERSONA_PREFIX_ORDER_KEY);
+	const order = Number.isFinite(base) ? base : PERSONA_PREFIX_ORDER_FALLBACK;
+	const identityBase = sp.getSectionOrder(HARNESS_IDENTITY_ORDER_KEY);
+	const identityOrder = Number.isFinite(identityBase) ? identityBase : HARNESS_IDENTITY_ORDER_FALLBACK;
+	ctx.effect(() => sp.section({
+		name: PERSONA_PREFIX_SECTION,
+		order,
+		interpolate: false,
+		text: () => {
+			const card = readPersonaCard(home, config.personaKey);
+			return config.prefix ? `${card}\n\n${config.prefix}` : card;
+		}
+	}), "persona.section()");
+	ctx.effect(() => sp.section({
+		name: HARNESS_IDENTITY_SECTION,
+		order: identityOrder,
+		text: ""
+	}), "persona.identity-shadow()");
+}
+export { name as a, dshHome as c, inject as i, settingsFilePath as l, MAX_PERSONA_CHARS as n, readPersonaCard as o, apply as r, PERSONA_PRESET_IDS as s, DEFAULT_PERSONA as t };

package/lib/persona.js

@@ -1 +1 @@
-export { t as DEFAULT_PERSONA, n as MAX_PERSONA_CHARS, r as apply, i as inject, a as name, o as readPersonaCard } from "./persona-CYm9q6bl.js";
+export { t as DEFAULT_PERSONA, n as MAX_PERSONA_CHARS, r as apply, i as inject, a as name, o as readPersonaCard } from "./persona-DT5WK4Ne.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-persona-presets",
   "description": "Persona presets: a set of custom agent presets, one editable character card each, edited from the settings page",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "publishConfig": {
     "access": "public"
   },

package/lib/persona-CYm9q6bl.js

@@ -1,134 +0,0 @@
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-// src/paths.ts
-/**
-* Where this plugin keeps its data: one JSON file under the dsh home. The
-* platform settings service derives namespaces from profile entry config
-* schemas, which this bundle does not declare — a plain file keeps the
-* surface honest (the dsh-agentic-pet settings-page precedent).
-* @module dsh-persona-presets/paths
-*/
-/** Directory under the dsh home holding this plugin's settings file. The -598
-* suffix is the owner's namespace marker (whale598 precedent): every
-* registration surface this bundle claims — cordis plugin name, webserver
-* routes, settings-section slot id, storage dir — carries it, so a competing
-* persona plugin can never collide with any of them. */
-const PLUGIN_DIR = "persona-presets-598";
-/** The settings file name. */
-const SETTINGS_FILE = "persona-settings.json";
-/** The dsh home (DSH_HOME override for tests and portable setups). */
-function dshHome() {
-	return process.env.DSH_HOME ?? join(homedir(), ".dsh");
-}
-/** Absolute path of the settings file for one home. */
-function settingsFilePath(home = dshHome()) {
-	return join(home, PLUGIN_DIR, SETTINGS_FILE);
-}
-/** The persona slots this plugin ships — the preset ids of the three custom
-* presets in presets/persona-custom.patch.yml. The settings merge whitelist
-* and the read route both enumerate this list; a key outside it is dropped. */
-const PERSONA_PRESET_IDS = [
-	"persona-598-custom-1",
-	"persona-598-custom-2",
-	"persona-598-custom-3"
-];
-// src/persona.ts
-/**
-* The persona row: a user-editable character card mounted by this bundle's
-* agent presets (persona-custom-1/2/3) in place of @deepseek-ai/dsh-persona.
-*
-* Why REPLACE the official row instead of adding alongside it: a preset's
-* rows instantiate in one generation scope and prompt-section names are
-* unique per scope, so a companion row would need its own section name — and
-* any other section sorts after the persona-prefix slot, putting the editable
-* character card AFTER the content it introduces. Owning
-* `deployment:persona-prefix` keeps the reading order: character card first,
-* everything else after.
-*
-* The card lives in this plugin's settings file (persona-presets/
-* persona-settings.json, `personas.<presetId>`, edited from the settings
-* page's 「角色卡」 section; hand-editing works the same): the section text is a
-* function re-read at every assembly, so a saved edit lands on the next turn
-* with no restart. User free text must never enter strict {{variable}}
-* interpolation — an unknown reference makes the whole assembly throw — so
-* the section is registered with interpolate: false.
-*
-* Unlike the dsh-agentic-pet persona row there is NO static prefix half: for
-* a generic (non-pet) preset the card is the entire persona section. The
-* config keeps an optional `prefix` for symmetry, but no shipped preset sets
-* it. Extracted from dsh-agentic-pet src/persona.ts (pet-only storage paths
-* and the pet body-rules contract dropped).
-* @module dsh-persona-presets/persona
-*/
-/** Cordis plugin name. Preset ymls mount it as 'dsh-persona-presets/persona'. */
-const name = "persona";
-/** The prompt registry this row contributes to. Without this declaration the
-* traceable proxy rejects `ctx.systemPrompt` ("cannot get property ... without
-* inject") and the whole preset fails to mount — taking every session's
-* resume down with it. */
-const inject = ["systemPrompt"];
-function systemPromptOf(ctx) {
-	return ctx.systemPrompt;
-}
-/**
-* The default character card, shown until a slot is edited. Generic by
-* design — no pet, no product identity; the user is expected to overwrite it.
-* Clearing a slot in the settings page falls back here, so "cleared" and
-* "reset to default" are the same state.
-*/
-const DEFAULT_PERSONA = "你是用户的 AI 助手，说话简洁、就事论事。这张卡是你人设的全部来源：用户可以在设置页「角色卡」区块改写它，赋予你新的身份、性格与说话方式。";
-/** Upper bound for the user-edited card, enforced by the settings merge. A
-* runaway card would inflate every session prompt; the sync reader applies
-* the same cap so a hand-edited file cannot bypass it. */
-const MAX_PERSONA_CHARS = 8e3;
-/**
-* Read the configured character card for one preset slot: the slot
-* `personas.<key>` → DEFAULT_PERSONA. No global card and no legacy fallback
-* chain — this plugin starts clean, one slot one card. Sync on purpose —
-* PromptSection.text is a synchronous provider called once per assembly, and
-* a ~1KB JSON read per request is noise next to the LLM call it feeds, so
-* there is no cache to invalidate. Trims first, then caps.
-*/
-function readPersonaCard(home, key) {
-	try {
-		const parsed = JSON.parse(readFileSync(settingsFilePath(home), "utf8"));
-		if (parsed && typeof parsed === "object" && key !== void 0) {
-			const slots = typeof parsed.personas === "object" && parsed.personas !== null ? parsed.personas : {};
-			const slot = typeof slots[key] === "string" ? slots[key].trim() : "";
-			if (slot !== "") return slot.length > 8e3 ? slot.slice(0, MAX_PERSONA_CHARS) : slot;
-		}
-	} catch {}
-	return DEFAULT_PERSONA;
-}
-/** The prompt-registry section this row owns. Mirrors the unexported string
-* behind @deepseek-ai/dsh-system-prompt's PERSONA_PREFIX_SECTION — scoped
-* registration shadows the deployment persona, exactly how the official
-* persona row takes over a preset's identity. */
-const PERSONA_PREFIX_SECTION = "deployment:persona-prefix";
-/** Order slot for the persona prefix; the fallback is the slot's documented
-* value in case the key is ever renamed (a non-finite order must never reach
-* the registry). */
-const PERSONA_PREFIX_ORDER_KEY = "DEPLOYMENT_PERSONA_PREFIX";
-const PERSONA_PREFIX_ORDER_FALLBACK = 0;
-/**
-* Register the persona section in this preset's generation scope: it applies
-* to every session mounted with the preset, shadows the deployment persona,
-* and stays invisible to sessions on other presets.
-*/
-function apply(ctx, config) {
-	const sp = systemPromptOf(ctx);
-	const base = sp.getSectionOrder(PERSONA_PREFIX_ORDER_KEY);
-	const order = Number.isFinite(base) ? base : PERSONA_PREFIX_ORDER_FALLBACK;
-	const home = dshHome();
-	ctx.effect(() => sp.section({
-		name: PERSONA_PREFIX_SECTION,
-		order,
-		interpolate: false,
-		text: () => {
-			const card = readPersonaCard(home, config.personaKey);
-			return config.prefix ? `${card}\n\n${config.prefix}` : card;
-		}
-	}), "persona.section()");
-}
-export { name as a, dshHome as c, inject as i, settingsFilePath as l, MAX_PERSONA_CHARS as n, readPersonaCard as o, apply as r, PERSONA_PRESET_IDS as s, DEFAULT_PERSONA as t };