dsh-soul 0.6.2 → 0.7.0

package/index.mjs

@@ -24,6 +24,7 @@ import {
   DEFAULT_CONFIG,
   STYLE_VALUES,
   TRAIT_VALUES,
+  REPLY_LENGTH_VALUES,
   LANGUAGE_VALUES,
   PERSONA_FIELDS,
   PERSONA_NAME_MAX,
@@ -32,6 +33,7 @@ import {
   sanitizePersonaName
 } from './lib/config.mjs'
 import { createInjectionSource } from './lib/injection.mjs'
+import { isBuiltinPersona, mergePersonas, personaMatches, resolvePersona } from './lib/personas.mjs'
 
 const name = 'soul'
 
@@ -69,6 +71,14 @@ const PROMPT_TEXT = {
       more: '在回复中使用较多表情符号',
       less: '尽量减少使用表情符号'
     },
+    tables: {
+      more: '在呈现对比、多字段信息或结构化内容时优先使用表格',
+      less: '避免使用表格，改用列表或段落文本呈现'
+    },
+    replyLength: {
+      concise: '回答尽量简洁，直击要点，不展开无关内容',
+      detailed: '回答尽量详尽，充分展开背景、步骤与推理过程'
+    },
     replyLanguage: {
       zh: '必须使用简体中文回复',
       en: '必须使用英语（English）回复'
@@ -116,6 +126,14 @@ const PROMPT_TEXT = {
       more: 'Use emojis fairly often in replies',
       less: 'Keep emoji usage to a minimum'
     },
+    tables: {
+      more: 'Prefer tables when presenting comparisons, multi-field or structured information',
+      less: 'Avoid tables; use lists or paragraph text instead'
+    },
+    replyLength: {
+      concise: 'Keep answers concise: hit the key points and skip unrelated elaboration',
+      detailed: 'Give detailed answers: fully expand on background, steps and reasoning'
+    },
     replyLanguage: {
       zh: '必须使用简体中文回复',
       en: 'You must reply in English.'
@@ -155,12 +173,16 @@ function buildUserProfile(config, T) {
   return lines.join('\n')
 }
 
-// 行为块：回复风格和语调 + 特质 + 输出语言
+// 行为块：回复风格和语调 + 特质（标题和列表 / 表情符号 / 表格）+ 回复长度 + 输出语言。
+// 缺项（如 tables=default、replyLength=normal）在文案表中没有对应键，直接跳过、不产生文本，
+// 因此默认配置编译出的提示词与新增这两个维度之前完全一致。
 function buildBehavior(config, T) {
   const parts = []
   if (config.style && T.styles[config.style]) parts.push(`${T.styleLabel}${T.styles[config.style]}`)
   if (config.headingLists && T.headingLists[config.headingLists]) parts.push(T.headingLists[config.headingLists])
   if (config.emoji && T.emoji[config.emoji]) parts.push(T.emoji[config.emoji])
+  if (config.tables && T.tables[config.tables]) parts.push(T.tables[config.tables])
+  if (config.replyLength && T.replyLength[config.replyLength]) parts.push(T.replyLength[config.replyLength])
   if (config.language && T.replyLanguage[config.language]) parts.push(T.replyLanguage[config.language])
   return parts.join(T.joiner)
 }
@@ -442,7 +464,50 @@ function registerRoutes(ctx) {
       }
     })
     
-    // 预览系统提示词端点已在 v0.2.0 移除（提示词预览功能下线）
+    // 预览「未保存的编辑」编译出的 system prompt：以已保存配置为底，用请求体中
+    // 通过校验的字段覆盖后编译。
+    //
+    // **不落盘、不注入会话** —— 纯只读旁路，供设置在保存前确认真正会被注入的内容。
+    // v0.1.x 曾有同类端点，随 v0.2.0 精简重构下线；此处恢复并修掉旧实现的一个疏漏：
+    // 旧版直接展开请求体（{ ...current, ...draft }）未经校验，而这里与保存路径共用
+    // 同一套 sanitizeConfig —— 非法字段既不参与预览、也不会落盘，并通过 invalid
+    // 回报给客户端，避免出现「预览悄悄沿用了旧值」这种看不出原因的偏差。
+    wsCtx.webServer.register({
+      kind: 'exact',
+      path: '/api/soul/prompt/preview',
+      handler: async (req, res) => {
+        const send = (status, body) => {
+          res.writeHead(status, { 'content-type': 'application/json' })
+          res.end(JSON.stringify(body))
+        }
+
+        try {
+          if (req.method !== 'POST') {
+            send(405, { ok: false, error: 'Method not allowed' })
+            return
+          }
+
+          const parsed = await readJsonBody(req)
+          if (!parsed.ok) {
+            send(parsed.status, { ok: false, error: parsed.error })
+            return
+          }
+
+          const { patch, errors } = sanitizeConfig(parsed.body)
+          const current = await loadConfig()
+          const draft = { ...current, ...patch }
+
+          send(200, {
+            ok: true,
+            prompt: compilePrompt(draft),
+            enabled: draft.enabled,
+            invalid: Object.keys(errors)
+          })
+        } catch (err) {
+          send(500, { ok: false, error: String(err.message || err) })
+        }
+      }
+    })
 
     // 重置配置
     wsCtx.webServer.register({
@@ -505,16 +570,21 @@ function hasOwn(obj, key) {
   return Object.prototype.hasOwnProperty.call(obj, key)
 }
 
-// 计算与当前活动配置完全一致的预设名（多个命中时取名称排序最前）
+// 计算与当前活动配置匹配的预设名（多个命中时取名称排序最前）。
+// 匹配语义是「部分覆盖」而非全字段相等，理由见 lib/personas.mjs 的 personaMatches。
 function findActivePersonaName(config) {
-  const personas = config.personas || {}
-  for (const personaName of Object.keys(personas).sort()) {
-    const entry = personas[personaName]
-    if (PERSONA_FIELDS.every((key) => entry[key] === config[key])) return personaName
+  const view = mergePersonas(config.personas)
+  for (const personaName of Object.keys(view).sort()) {
+    if (personaMatches(view[personaName], config)) return personaName
   }
   return null
 }
 
+// 预设库的对外视图（内置 + 用户）与当前命中项，供三个路由的响应复用。
+function personaLibrary(config) {
+  return { personas: mergePersonas(config.personas), activeName: findActivePersonaName(config) }
+}
+
 // 人设预设 HTTP 路由：列表 / 保存 / 使用 / 删除。
 // 保存与删除仅变更 personas 库（diffKeys 跳过该字段），不会触发会话注入；
 // 使用会变更活动配置字段，走常规 promptChanged 门控注入。
@@ -536,7 +606,7 @@ function registerPersonaRoutes(ctx) {
             return
           }
           const config = await loadConfig()
-          send(res, 200, { ok: true, personas: config.personas || {}, activeName: findActivePersonaName(config) })
+          send(res, 200, { ok: true, ...personaLibrary(config) })
         } catch (err) {
           send(res, 500, { ok: false, error: String(err.message || err) })
         }
@@ -563,12 +633,18 @@ function registerPersonaRoutes(ctx) {
             send(res, 400, { ok: false, error: `预设名称无效（1-${PERSONA_NAME_MAX} 个字符）` })
             return
           }
+          // 内置名一律不可写入：内置预设只存在于代码里，若允许同名落盘，合并视图会
+          // 遮蔽它，用户就会得到一个「保存了却看不见、也删不掉」的幽灵条目。
+          if (isBuiltinPersona(personaName)) {
+            send(res, 400, { ok: false, error: `「${personaName}」是内置预设，请换一个名称` })
+            return
+          }
           const { config: updated } = await commitConfig((current) => {
             const personas = clonePersonas(current.personas)
             personas[personaName] = { ...personaSnapshotOf(current), updatedAt: new Date().toISOString() }
             return { ...current, personas }
           })
-          send(res, 200, { ok: true, personas: updated.personas || {}, activeName: findActivePersonaName(updated) })
+          send(res, 200, { ok: true, ...personaLibrary(updated) })
         } catch (err) {
           send(res, 500, { ok: false, error: String(err.message || err) })
         }
@@ -592,12 +668,15 @@ function registerPersonaRoutes(ctx) {
           }
           const personaName = sanitizePersonaName(parsed.body && parsed.body.name)
           const current = await loadConfig()
-          if (!personaName || !hasOwn(current.personas || {}, personaName)) {
+          // 内置与用户预设共用同一条应用路径（resolvePersona 先内置后用户）
+          const entry = personaName ? resolvePersona(personaName, current.personas) : null
+          if (!entry) {
             send(res, 400, { ok: false, error: `预设不存在：${personaName || '(空)'}` })
             return
           }
-          // 预设值保存时已校验；此处再过一遍白名单，防御手改文件等异常数据
-          const { patch } = sanitizeConfig(pickPersonaValues(current.personas[personaName]))
+          // 内置预设已在代码里写过一遍；用户预设保存时也校验过。此处统一再过一遍
+          // 白名单，防御手改 config.json 注入的异常数据。
+          const { patch } = sanitizeConfig(pickPersonaValues(entry))
           const { config: updated, changed, promptChanged } = await commitConfig(c => ({ ...c, ...patch }))
           if (promptChanged.length > 0) {
             refreshPromptAndInject(ctx, updated)
@@ -625,6 +704,13 @@ function registerPersonaRoutes(ctx) {
             return
           }
           const personaName = sanitizePersonaName(parsed.body && parsed.body.name)
+          // 内置预设不可删除。这一层必须挡在「磁盘库是否存在」之前：内置项本来就不在
+          // 磁盘库里，但手改文件可能留下同名残留，那种条目已被合并视图遮蔽、删它没有
+          // 意义，而调用方真正想删的是内置项——直接拒绝，语义才唯一。
+          if (personaName && isBuiltinPersona(personaName)) {
+            send(res, 400, { ok: false, error: `「${personaName}」是内置预设，无法删除` })
+            return
+          }
           const current = await loadConfig()
           if (!personaName || !hasOwn(current.personas || {}, personaName)) {
             send(res, 400, { ok: false, error: `预设不存在：${personaName || '(空)'}` })
@@ -635,7 +721,7 @@ function registerPersonaRoutes(ctx) {
             delete personas[personaName]
             return { ...c, personas }
           })
-          send(res, 200, { ok: true, personas: updated.personas || {}, activeName: findActivePersonaName(updated) })
+          send(res, 200, { ok: true, ...personaLibrary(updated) })
         } catch (err) {
           send(res, 500, { ok: false, error: String(err.message || err) })
         }
@@ -667,11 +753,19 @@ const COMMAND_MESSAGES = {
     traitsLabel: '特质',
     headingListsLabel: '标题和列表',
     emojiLabel: '表情符号',
+    tablesLabel: '表格',
+    replyLengthLabel: '回复长度',
     traitNames: {
       default: '默认',
       more: '增强',
       less: '减弱'
     },
+    replyLengthNames: {
+      concise: '简洁',
+      normal: '适中',
+      detailed: '详尽'
+    },
+    listSep: '，',
     trailLabel: '输入框光轨',
     trailLine: (status, color, speedName, widthName) => `${status}（${color} / ${speedName} / ${widthName}）`,
     trailSpeedNames: {
@@ -697,6 +791,10 @@ const COMMAND_MESSAGES = {
     confirmDone: (detail) => `✅ 已应用人设变更：${detail}`,
     rejectDone: '✅ 已拒绝待确认的人设变更',
     saveDone: (name) => `✅ 已保存预设「${name}」`,
+    // 内置预设（随插件发布、不落盘）：不可用同名保存，也不可删除
+    builtinName: '内置',
+    builtinSaveBlocked: (name) => `「${name}」是内置预设，请换一个名称`,
+    builtinDeleteBlocked: (name) => `「${name}」是内置预设，无法删除`,
     useDone: (name) => `✅ 已应用预设「${name}」`,
     useUnchanged: (name) => `ℹ 预设「${name}」与当前配置一致，无需变更`,
     personaMissing: (name) => `预设「${name}」不存在`,
@@ -706,7 +804,7 @@ const COMMAND_MESSAGES = {
     saveUsage: '用法：/soul save <名称>（1-30 个字符）',
     useUsage: '用法：/soul use <名称>',
     delUsage: '用法：/soul del <名称>',
-    setUsage: '用法：/soul set key=value ...（可用字段：enabled / style / headingLists / emoji / language / nickname / occupation / bio / customInstructions / trailEnabled / trailColor / trailSpeed / trailWidth）',
+    setUsage: '用法：/soul set key=value ...（可用字段：enabled / style / headingLists / emoji / tables / replyLength / language / nickname / occupation / bio / customInstructions / trailEnabled / trailColor / trailSpeed / trailWidth）',
     unknownField: '未知配置项',
     invalidBoolean: (key) => `${key} 取值必须为 true / false`,
     setNoChanges: '配置无变化，未做修改',
@@ -736,11 +834,19 @@ const COMMAND_MESSAGES = {
     traitsLabel: 'Traits',
     headingListsLabel: 'Headings & lists',
     emojiLabel: 'Emoji',
+    tablesLabel: 'Tables',
+    replyLengthLabel: 'Reply length',
     traitNames: {
       default: 'Default',
       more: 'More',
       less: 'Less'
     },
+    replyLengthNames: {
+      concise: 'Concise',
+      normal: 'Balanced',
+      detailed: 'Detailed'
+    },
+    listSep: ', ',
     trailLabel: 'Composer light trail',
     trailLine: (status, color, speedName, widthName) => `${status} (${color} / ${speedName} / ${widthName})`,
     trailSpeedNames: {
@@ -766,6 +872,9 @@ const COMMAND_MESSAGES = {
     confirmDone: (detail) => `✅ Persona changes applied: ${detail}`,
     rejectDone: '✅ Pending persona proposal discarded',
     saveDone: (name) => `✅ Persona "${name}" saved`,
+    builtinName: 'built-in',
+    builtinSaveBlocked: (name) => `"${name}" is a built-in persona — pick another name`,
+    builtinDeleteBlocked: (name) => `"${name}" is a built-in persona and cannot be deleted`,
     useDone: (name) => `✅ Persona "${name}" applied`,
     useUnchanged: (name) => `ℹ Persona "${name}" matches the current config`,
     personaMissing: (name) => `Persona "${name}" does not exist`,
@@ -775,7 +884,7 @@ const COMMAND_MESSAGES = {
     saveUsage: 'Usage: /soul save <name> (1-30 chars)',
     useUsage: 'Usage: /soul use <name>',
     delUsage: 'Usage: /soul del <name>',
-    setUsage: 'Usage: /soul set key=value ... (fields: enabled / style / headingLists / emoji / language / nickname / occupation / bio / customInstructions / trailEnabled / trailColor / trailSpeed / trailWidth)',
+    setUsage: 'Usage: /soul set key=value ... (fields: enabled / style / headingLists / emoji / tables / replyLength / language / nickname / occupation / bio / customInstructions / trailEnabled / trailColor / trailSpeed / trailWidth)',
     unknownField: 'Unknown field',
     invalidBoolean: (key) => `${key} must be true or false`,
     setNoChanges: 'No config changes to apply',
@@ -847,8 +956,12 @@ function registerCommands(ctx) {
             const occupation = config.occupation || t.notSet
             const bio = config.bio || t.notSet
             const styleName = t.styleNames[config.style] || config.style || t.notSet
-            const hlName = t.traitNames[config.headingLists] || config.headingLists
-            const emojiName = t.traitNames[config.emoji] || config.emoji
+            const traitsLine = [
+              `${t.headingListsLabel}=${t.traitNames[config.headingLists] || config.headingLists}`,
+              `${t.emojiLabel}=${t.traitNames[config.emoji] || config.emoji}`,
+              `${t.tablesLabel}=${t.traitNames[config.tables] || config.tables}`,
+              `${t.replyLengthLabel}=${t.replyLengthNames[config.replyLength] || config.replyLength}`
+            ].join(t.listSep)
             const instructions = config.customInstructions || t.notSet
             const personaCount = Object.keys(config.personas || {}).length
             const pendingLine = pendingPersonaProposal ? `\n${t.pendingHint}` : ''
@@ -861,7 +974,7 @@ function registerCommands(ctx) {
 
             return {
               kind: 'success',
-              text: `${t.showTitle}\n\n${t.statusLabel}${t.colon}${status}\n${t.nicknameLabel}${t.colon}${nickname}\n${t.occupationLabel}${t.colon}${occupation}\n${t.bioLabel}${t.colon}${bio}\n${t.styleLabel}${t.colon}${styleName}\n${t.traitsLabel}${t.colon}${t.headingListsLabel}=${hlName}，${t.emojiLabel}=${emojiName}\n${t.trailLabel}${t.colon}${trailText}\n${t.instructionsLabel}${t.colon}${instructions}\n${t.toolConfirmLabel}${t.colon}${config.requireToolConfirmation ? t.onLabel : t.offLabel}\n${t.personasLabel}${t.colon}${personaCount}${pendingLine}\n\n${t.help}`
+              text: `${t.showTitle}\n\n${t.statusLabel}${t.colon}${status}\n${t.nicknameLabel}${t.colon}${nickname}\n${t.occupationLabel}${t.colon}${occupation}\n${t.bioLabel}${t.colon}${bio}\n${t.styleLabel}${t.colon}${styleName}\n${t.traitsLabel}${t.colon}${traitsLine}\n${t.trailLabel}${t.colon}${trailText}\n${t.instructionsLabel}${t.colon}${instructions}\n${t.toolConfirmLabel}${t.colon}${config.requireToolConfirmation ? t.onLabel : t.offLabel}\n${t.personasLabel}${t.colon}${personaCount}${pendingLine}\n\n${t.help}`
             }
           }
 
@@ -888,6 +1001,9 @@ function registerCommands(ctx) {
           if (first === 'save') {
             const personaName = sanitizePersonaName(rest)
             if (!personaName) return { kind: 'error', text: t.saveUsage }
+            if (isBuiltinPersona(personaName)) {
+              return { kind: 'error', text: t.builtinSaveBlocked(personaName) }
+            }
             await commitConfig((current) => {
               const personas = clonePersonas(current.personas)
               personas[personaName] = { ...personaSnapshotOf(current), updatedAt: new Date().toISOString() }
@@ -899,11 +1015,13 @@ function registerCommands(ctx) {
           if (first === 'use') {
             const personaName = sanitizePersonaName(rest)
             if (!personaName) return { kind: 'error', text: t.useUsage }
-            if (!hasOwn(config.personas || {}, personaName)) {
+            // 内置与用户预设共用同一条应用路径（resolvePersona 先内置后用户）
+            const entry = resolvePersona(personaName, config.personas)
+            if (!entry) {
               return { kind: 'error', text: t.personaMissing(personaName) }
             }
             // 预设值保存时已校验；此处再过一遍白名单，防御手改文件等异常数据
-            const { patch } = sanitizeConfig(pickPersonaValues(config.personas[personaName]))
+            const { patch } = sanitizeConfig(pickPersonaValues(entry))
             const { config: updated, changed, promptChanged } = await commitConfig(c => ({ ...c, ...patch }))
             if (changed.length === 0) {
               return { kind: 'success', text: t.useUnchanged(personaName) }
@@ -913,17 +1031,19 @@ function registerCommands(ctx) {
           }
 
           if (first === 'list') {
-            const personas = config.personas || {}
-            const names = Object.keys(personas).sort()
+            // 与 Web UI 一致：列出合并视图（内置 + 用户），并标出内置项
+            const view = mergePersonas(config.personas)
+            const names = Object.keys(view).sort()
             if (names.length === 0) {
               return { kind: 'success', text: `${t.listTitle}\n${t.listEmpty}` }
             }
             const activeName = findActivePersonaName(config)
             const lines = names.map((personaName) => {
-              const entry = personas[personaName]
+              const entry = view[personaName]
               const styleText = STYLE_VALUES.includes(entry.style) ? (t.styleNames[entry.style] || entry.style) : (entry.style || '-')
               const nickText = entry.nickname || '-'
-              return `${personaName === activeName ? '✔ ' : '• '}${personaName} ｜ ${t.styleLabel}=${styleText} ｜ ${t.nicknameLabel}=${nickText}`
+              const mark = entry.builtin ? ` [${t.builtinName}]` : ''
+              return `${personaName === activeName ? '✔ ' : '• '}${personaName}${mark} ｜ ${t.styleLabel}=${styleText} ｜ ${t.nicknameLabel}=${nickText}`
             })
             return { kind: 'success', text: `${t.listTitle} [${names.length}]\n${lines.join('\n')}` }
           }
@@ -931,6 +1051,9 @@ function registerCommands(ctx) {
           if (first === 'del' || first === 'delete' || first === 'rm') {
             const personaName = sanitizePersonaName(rest)
             if (!personaName) return { kind: 'error', text: t.delUsage }
+            if (isBuiltinPersona(personaName)) {
+              return { kind: 'error', text: t.builtinDeleteBlocked(personaName) }
+            }
             if (!hasOwn(config.personas || {}, personaName)) {
               return { kind: 'error', text: t.personaMissing(personaName) }
             }
@@ -1082,6 +1205,16 @@ function registerTools(ctx) {
             enum: TRAIT_VALUES,
             description: '特质·表情符号：default=默认，more=增强（使用较多表情符号），less=减弱（尽量减少使用表情符号）。'
           },
+          tables: {
+            type: 'string',
+            enum: TRAIT_VALUES,
+            description: '特质·表格：default=默认，more=增强（呈现对比、多字段或结构化信息时优先使用表格），less=减弱（避免表格，改用列表或段落文本）。'
+          },
+          replyLength: {
+            type: 'string',
+            enum: REPLY_LENGTH_VALUES,
+            description: '回复长度偏好：concise=简洁（直击要点、不展开），normal=适中（不额外约束），detailed=详尽（充分展开背景、步骤与推理）。'
+          },
           customInstructions: { type: 'string', description: '额外的自定义指令，用于覆盖或补充当前人设。' },
         },
         output: {
@@ -1107,6 +1240,8 @@ function registerTools(ctx) {
                   language: { type: 'string' },
                   headingLists: { type: 'string' },
                   emoji: { type: 'string' },
+                  tables: { type: 'string' },
+                  replyLength: { type: 'string' },
                   customInstructions: { type: 'string' },
                 },
               },

package/lib/config.mjs

@@ -16,9 +16,12 @@ export const DEFAULT_CONFIG = {
   bio: '',
   // 回复风格和语调（v0.2.0 起合并为单一选项）
   style: 'professional',
-  // 特质：标题和列表 / 表情符号（default=默认，more=增强，less=减弱）
+  // 特质：标题和列表 / 表情符号 / 表格（default=默认，more=增强，less=减弱）
   headingLists: 'default',
   emoji: 'default',
+  tables: 'default',
+  // 回复长度偏好：concise=简洁，normal=适中（不产生任何提示词文案），detailed=详尽
+  replyLength: 'normal',
   language: 'zh',
   customInstructions: '',
   // set_persona 工具确认模式：开启后 Agent 的人设修改返回待确认提议而不落盘
@@ -33,9 +36,14 @@ export const DEFAULT_CONFIG = {
 // 合法的回复风格和语调取值（供工具参数校验）
 export const STYLE_VALUES = ['professional', 'casual', 'humorous', 'roast', 'efficient']
 
-// 特质合法取值
+// 特质合法取值（标题和列表 / 表情符号 / 表格 共用三档）
 export const TRAIT_VALUES = ['default', 'more', 'less']
 
+// 回复长度偏好合法取值。
+// normal（适中）刻意不产生任何提示词文案 —— 与特质的 default 同理，
+// 代表「不额外约束」，保证它作为默认值时现有用户的行为零变化。
+export const REPLY_LENGTH_VALUES = ['concise', 'normal', 'detailed']
+
 // 输出语言合法取值
 export const LANGUAGE_VALUES = ['zh', 'en']
 
@@ -66,7 +74,7 @@ const TEXT_FIELDS = ['nickname', 'occupation', 'bio', 'customInstructions']
 // ==================== 人设预设 ====================
 
 // 人设预设覆盖的配置字段（enabled 为全局开关、不进入预设）
-export const PERSONA_FIELDS = ['nickname', 'occupation', 'bio', 'style', 'headingLists', 'emoji', 'language', 'customInstructions']
+export const PERSONA_FIELDS = ['nickname', 'occupation', 'bio', 'style', 'headingLists', 'emoji', 'tables', 'replyLength', 'language', 'customInstructions']
 
 // 人设预设名称上限
 export const PERSONA_NAME_MAX = 30
@@ -127,6 +135,8 @@ export function migrateConfig(raw) {
   // 特质字段校验：脏数据回退为默认值
   if (!TRAIT_VALUES.includes(config.headingLists)) config.headingLists = 'default'
   if (!TRAIT_VALUES.includes(config.emoji)) config.emoji = 'default'
+  if (!TRAIT_VALUES.includes(config.tables)) config.tables = DEFAULT_CONFIG.tables
+  if (!REPLY_LENGTH_VALUES.includes(config.replyLength)) config.replyLength = DEFAULT_CONFIG.replyLength
   // 确认模式：非布尔脏数据回退为默认值
   if (typeof config.requireToolConfirmation !== 'boolean') config.requireToolConfirmation = DEFAULT_CONFIG.requireToolConfirmation
   // 光轨字段脏数据回退：布尔 / 枚举 / 6 位十六进制颜色
@@ -214,6 +224,8 @@ export function sanitizeConfig(raw) {
     ['style', STYLE_VALUES, '回复风格和语调'],
     ['headingLists', TRAIT_VALUES, '特质·标题和列表'],
     ['emoji', TRAIT_VALUES, '特质·表情符号'],
+    ['tables', TRAIT_VALUES, '特质·表格'],
+    ['replyLength', REPLY_LENGTH_VALUES, '回复长度偏好'],
     ['language', LANGUAGE_VALUES, '输出语言'],
     ['trailSpeed', TRAIL_SPEED_VALUES, '光轨流动速度'],
     ['trailWidth', TRAIL_WIDTH_VALUES, '光轨光带粗细']

package/lib/personas.mjs

@@ -0,0 +1,172 @@
+// lib/personas.mjs — dsh-soul 内置人设预设（纯数据 + 纯函数，无任何依赖）
+//
+// 职责：
+//   - 内置人设清单（BUILTIN_PERSONAS）
+//   - 用户预设库与内置预设的合并（mergePersonas / resolvePersona）
+//
+// 三条设计约定（verify-config.mjs 逐条固化，改动时勿破坏）：
+//
+//   1) **只声明要覆盖的字段**。预设是「部分覆盖」语义：应用时只写入预设实际
+//      声明的键，未声明的保持用户当前值。所以内置预设一律省略
+//      `nickname` / `occupation` / `bio`——那是「关于你」的用户自有信息，
+//      预设去写它们等于把用户的昵称职业清空。
+//
+//   2) **不声明 `language`**。输出语言属于用户偏好而非人设的一部分；内置预设若
+//      写死 zh，英文用户应用一次就会被强行切回中文。省略即「不动它」。
+//
+//   3) **内置预设不进磁盘**。它们只存在于本文件，磁盘上的 `config.personas`
+//      仅存用户自己保存的预设。好处有三：升级时内置内容自动更新（不会被用户
+//      的旧副本覆盖）、用户无法删除或篡改内置项、`$DSH_HOME/soul-config.json`
+//      保持干净。写入路径（保存 / 删除）对内置名一律拒绝，因此不存在「删了又
+//      回来」的困惑状态。
+//
+// 名称冲突规则：**内置优先**。磁盘上若残留同名条目（手改文件或历史数据），
+// 合并时会被内置内容遮蔽，且该名字在 UI 上不可删除——不变量是「内置名永远指向
+// 内置内容」。保存路径同样拒绝内置名，用户想微调就换个名字存。
+
+import { PERSONA_FIELDS } from './config.mjs'
+
+// ==================== 内置人设 ====================
+//
+// 每条只写与默认值不同的字段。默认值见 lib/config.mjs 的 DEFAULT_CONFIG：
+//   style=professional / headingLists=default / emoji=default / tables=default
+//   / replyLength=normal（normal 与 default 均不产生任何提示词文案）
+//
+// customInstructions 是内置人设的主要载体：枚举字段只能表达「更啰嗦 / 更简洁」
+// 这类粗粒度倾向，人格化的行为差异要靠自由文本。写法上只描述**行为规则**
+// （先问什么、先给什么、按什么顺序展开），避免与 style 档位的文案重复。
+
+export const BUILTIN_PERSONAS = {
+  '苏格拉底式提问者': {
+    style: 'professional',
+    headingLists: 'less',
+    customInstructions:
+      '用提问推进对话，而不是直接给答案。' +
+      '先用自己的话复述你对问题的理解，确认无误后再提出 1-2 个能暴露关键假设的追问；' +
+      '追问要具体、指向可验证的事实，不要问「你确定吗」这类空泛问题。' +
+      '只有当用户明确要求结论，或已经追问过两轮时，才给出答案——此时要一并说明结论依赖哪些前提。'
+  },
+  '极简主义者': {
+    style: 'efficient',
+    headingLists: 'less',
+    emoji: 'less',
+    tables: 'less',
+    replyLength: 'concise',
+    customInstructions:
+      '只给结论和必要依据，砍掉一切铺垫、客套与重复。' +
+      '能用一句话说清就不要用三句；不主动扩展话题，也不追加未被问及的注意事项。' +
+      '若信息不足以回答，只问一个最关键的问题，不要罗列一串待确认项。'
+  },
+  '资深架构师': {
+    style: 'professional',
+    headingLists: 'more',
+    tables: 'more',
+    replyLength: 'detailed',
+    customInstructions:
+      '以系统设计视角回答：先说清约束、假设与规模量级，再给方案。' +
+      '至少对比两条技术路线，用表格列出权衡维度（复杂度、可维护性、性能、迁移成本、团队门槛）。' +
+      '主动指出边界条件、失败模式与长期演进风险；' +
+      '涉及取舍时给出明确推荐并说明理由，不要以「都可以，看需求」收尾。'
+  },
+  '教学型讲解者': {
+    style: 'casual',
+    headingLists: 'more',
+    replyLength: 'detailed',
+    customInstructions:
+      '按「是什么 → 为什么 → 怎么用」的顺序讲解，先建立直觉再引入术语。' +
+      '开头用一个具体例子或类比，结尾用一句话总结关键点。' +
+      '遇到专业名词先解释含义，不要假设用户已掌握前置知识；' +
+      '但每个概念只讲一遍，不要为了周全而反复换说法重复同一件事。'
+  },
+  '严格代码审阅者': {
+    style: 'professional',
+    headingLists: 'more',
+    tables: 'more',
+    emoji: 'less',
+    replyLength: 'detailed',
+    customInstructions:
+      '按代码审阅者的标准挑问题，按严重度分组：正确性 / 安全 / 性能 / 可维护性 / 风格。' +
+      '每条指出具体位置、触发条件与修复方向，不要只说「这里可能有问题」。' +
+      '优先报告会导致错误结果、数据损坏或安全风险的问题。' +
+      '没有发现问题时，明确说明检查过哪些方面，不要为凑数编造无关痛痒的意见。'
+  },
+  '头脑风暴伙伴': {
+    style: 'casual',
+    headingLists: 'more',
+    customInstructions:
+      '先发散再收敛：一次性给出若干方向明显不同的方案，而不是同一方案的变体。' +
+      '每个方案用一句话说清核心思路与主要代价。' +
+      '发散阶段不要否定任何想法；给出方案后再标出你个人最看好的一个及理由。' +
+      '避免只给显而易见的选项，至少包含一个不常规但有可行性的思路。'
+  }
+}
+
+// ==================== 合并与查询 ====================
+
+// 预设条目的元数据键：不属于人设字段，参与比较时须剔除
+const PERSONA_META_KEYS = new Set(['updatedAt', 'builtin'])
+
+// 预设实际声明的人设字段名（只保留 PERSONA_FIELDS 白名单内的键）
+export function declaredPersonaKeys(entry) {
+  return Object.keys(entry || {}).filter(
+    (key) => !PERSONA_META_KEYS.has(key) && PERSONA_FIELDS.includes(key)
+  )
+}
+
+// 预设是否与当前活动配置匹配（★ 标记的判据）。
+//
+// 预设是「部分覆盖」语义——应用时只写它声明过的字段，所以判定也必须只比较
+// 声明过的字段。若按 PERSONA_FIELDS 全量比较，内置预设会永远匹配不上：它们
+// 刻意省略 nickname / occupation / bio（用户自有信息）与 language（输出语言属于
+// 用户偏好），省略的含义是「不动它」，而不是「要求它是空」。
+//
+// 一个字段都没声明的条目视为不匹配——否则它会匹配任何配置。
+export function personaMatches(entry, config) {
+  const keys = declaredPersonaKeys(entry)
+  if (keys.length === 0) return false
+  return keys.every((key) => entry[key] === config[key])
+}
+
+// 内置人设名（按定义顺序返回；UI 列表用它把内置项排在前面的展示区）
+export function builtinPersonaNames() {
+  return Object.keys(BUILTIN_PERSONAS)
+}
+
+// 是否为内置人设名（保存与删除路径的准入判据）
+export function isBuiltinPersona(name) {
+  return typeof name === 'string' && Object.prototype.hasOwnProperty.call(BUILTIN_PERSONAS, name)
+}
+
+// 合并用户预设库与内置预设，返回给前端的展示视图。
+// 内置条目额外带 `builtin: true` —— 前端据此渲染「内置」标记并隐藏删除按钮；
+// 用户预设不带该字段。内置优先，同名用户条目被遮蔽（见文件头约定 3）。
+export function mergePersonas(userPersonas) {
+  const out = {}
+  for (const name of builtinPersonaNames()) {
+    out[name] = { ...BUILTIN_PERSONAS[name], builtin: true }
+  }
+  if (userPersonas && typeof userPersonas === 'object' && !Array.isArray(userPersonas)) {
+    for (const name of Object.keys(userPersonas)) {
+      if (isBuiltinPersona(name)) continue
+      out[name] = { ...userPersonas[name] }
+    }
+  }
+  return out
+}
+
+// 按名称取预设条目（先内置后用户），不存在返回 null。
+export function resolvePersona(name, userPersonas) {
+  if (typeof name !== 'string') return null
+  if (isBuiltinPersona(name)) return { ...BUILTIN_PERSONAS[name] }
+  if (userPersonas && Object.prototype.hasOwnProperty.call(userPersonas, name)) {
+    return { ...userPersonas[name] }
+  }
+  return null
+}
+
+// 预设声明的字段数（UI 摘要与测试用；内置预设字段少于用户预设，因为前者
+// 刻意省略用户自有信息）。
+export function declaredFieldCount(persona) {
+  if (!persona || typeof persona !== 'object') return 0
+  return Object.keys(persona).filter((key) => key !== 'updatedAt' && key !== 'builtin').length
+}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "dsh-soul",
-  "version": "0.6.2",
-  "description": "为 DeepSeek Harness 添加个性化设置",
+  "version": "0.7.0",
+  "description": "为 DeepSeek Harness 添加个性化设置。",
+  "icon": "./assets/icon.svg",
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -17,9 +18,10 @@
   "type": "module",
   "main": "index.mjs",
   "scripts": {
-    "verify": "node scripts/verify-config.mjs && node scripts/verify-compat.mjs && node scripts/verify-trail.mjs",
+    "verify": "node scripts/verify-config.mjs && node scripts/verify-compat.mjs && node scripts/verify-trail.mjs && node scripts/verify-nav-icon.mjs",
     "verify:compat": "node scripts/verify-compat.mjs",
-    "verify:trail": "node scripts/verify-trail.mjs"
+    "verify:trail": "node scripts/verify-trail.mjs",
+    "verify:nav-icon": "node scripts/verify-nav-icon.mjs"
   },
   "license": "MIT",
   "repository": {
@@ -55,6 +57,7 @@
     "index.mjs",
     "lib",
     "client",
+    "assets",
     "cordis.patch.yml",
     "scripts",
     "README.md",