dsh-soul 0.3.2 → 0.3.3

package/README.md

@@ -17,6 +17,7 @@ DeepSeek Harness 个性化设置插件，用于配置 Agent 的昵称、回复
 - 输入自定义指令
 - Agent 可调用工具 `set_persona`，让模型在对话中直接调整人设
 - 配置持久化保存
+- 配置输入校验：字段白名单、类型、长度上限（昵称/职业 50、介绍 500、自定义指令 2000 字符）与枚举校验，非法或超限字段整单拒绝
 - 配置更新后同步到所有活动 Agent
 
 ## 安装
@@ -92,6 +93,8 @@ soul-config.json
 }
 ```
 
+字段长度上限：昵称 / 职业 50 字符，介绍 500 字符，自定义指令 2000 字符；未知字段会被丢弃，非法或超限字段整单拒绝（HTTP 返回 400 与字段级错误明细）。
+
 ## 实现原理
 
 插件通过 `compilePrompt()` 将昵称、风格、语调和自定义指令编译成 system prompt，并注册到 DSH：

package/README_EN.md

@@ -17,6 +17,7 @@ A personalization plugin for DeepSeek Harness (DSH). Configure your agent's nick
 - Custom instructions
 - Agent-callable tool `set_persona` to let the model adjust persona during a conversation
 - Configuration persisted to disk
+- Input validation: field whitelist, types, length limits (nickname/occupation 50, bio 500, custom instructions 2000 chars) and enum checks; invalid or oversized fields reject the whole write
 - Configuration synced to all active agents after every update
 
 ## Installation
@@ -92,6 +93,8 @@ Example:
 }
 ```
 
+Length limits: nickname / occupation 50 chars, bio 500 chars, custom instructions 2000 chars. Unknown fields are dropped; invalid or oversized fields reject the whole write (HTTP returns 400 with per-field error details).
+
 ## How It Works
 
 The plugin compiles the nickname, style, tone and custom instructions into a system prompt via `compilePrompt()` and registers it with DSH:

package/client/index.mjs

@@ -616,13 +616,15 @@ window.__ModuleLoader__.load({
         }
         
         // 延迟执行初始同步，等待设置页面渲染完成
-        const timer = setTimeout(sync, 500)
+        let timer = setTimeout(sync, 500)
         
         // 监听 DOM 变化（只监听子节点添加，不监听所有变化）
         const observer = new MutationObserver(() => {
-          // 防抖：只在停止变化后执行
+          // 防抖：每次变化都重置计时器，停止变化 100ms 后执行
+          // （修复：此前新计时器未赋回 timer，clearTimeout 永远只清除首个 500ms
+          // 计时器，防抖实际失效，每次 DOM 变化都会调度一次 sync）
           clearTimeout(timer)
-          setTimeout(sync, 100)
+          timer = setTimeout(sync, 100)
         })
         
         observer.observe(document.body, {

package/index.mjs

@@ -17,6 +17,14 @@ import { readFile, writeFile, mkdir } from 'node:fs/promises'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
 import { createUserMessage } from '@deepseek-ai/dsh-llm'
+import {
+  DEFAULT_CONFIG,
+  STYLE_VALUES,
+  TRAIT_VALUES,
+  LANGUAGE_VALUES,
+  migrateConfig,
+  sanitizeConfig
+} from './lib/config.mjs'
 
 const name = 'soul'
 
@@ -155,59 +163,11 @@ const StyleLayer = {
 
 // ==================== 配置管理 ====================
 
-// 默认配置
-const DEFAULT_CONFIG = {
-  enabled: true,
-  nickname: '',
-  // 关于你：用户职业 / 用户介绍
-  occupation: '',
-  bio: '',
-  // 回复风格和语调（v0.2.0 起合并为单一选项）
-  style: 'professional',
-  // 特质：标题和列表 / 表情符号（default=默认，more=增强，less=减弱）
-  headingLists: 'default',
-  emoji: 'default',
-  language: 'zh',
-  customInstructions: ''
-}
-
-// 合法的回复风格和语调取值（供工具参数校验）
-const STYLE_VALUES = ['professional', 'casual', 'humorous', 'roast', 'efficient']
-
-// 特质合法取值
-const TRAIT_VALUES = ['default', 'more', 'less']
-
-// v0.1.x 配置使用 style + tone 两个字段；v0.2.0 起合并为单一 style（回复风格和语调）。
-// 迁移映射：组合命中用组合表，否则退回旧 style 表，再否则用默认值。
-const LEGACY_STYLE_TONE_MAP = {
-  'professional+formal': 'professional',
-  'casual+neutral': 'casual',
-  'humorous+informal': 'humorous'
-}
-const LEGACY_STYLE_MAP = {
-  professional: 'professional',
-  casual: 'casual',
-  friendly: 'casual',
-  humorous: 'humorous',
-  academic: 'professional'
-}
+// 默认配置、合法取值（STYLE_VALUES / TRAIT_VALUES / LANGUAGE_VALUES）、
+// 旧版本迁移（migrateConfig）与输入校验（sanitizeConfig）见 lib/config.mjs。
 
-function migrateConfig(raw) {
-  const config = { ...DEFAULT_CONFIG, ...raw }
-  if (raw && typeof raw.style === 'string' && typeof raw.tone === 'string') {
-    const combo = `${raw.style}+${raw.tone}`
-    config.style = LEGACY_STYLE_TONE_MAP[combo] || LEGACY_STYLE_MAP[raw.style] || DEFAULT_CONFIG.style
-    delete config.tone
-  }
-  // 人设预设 / 示例指令功能已在 v0.2.0 移除，丢弃历史残留字段
-  delete config.presets
-  delete config.tone
-  delete config.examples
-  // 特质字段校验：脏数据回退为默认值
-  if (!TRAIT_VALUES.includes(config.headingLists)) config.headingLists = 'default'
-  if (!TRAIT_VALUES.includes(config.emoji)) config.emoji = 'default'
-  return config
-}
+// POST /api/soul/config 请求体大小上限：合法配置远小于该值，仅用于拦截异常请求
+const MAX_BODY_BYTES = 64 * 1024
 
 // 内存中的配置缓存
 let configCache = null
@@ -239,6 +199,36 @@ async function saveConfig(config) {
   return clean
 }
 
+// ==================== 配置写入队列 ====================
+
+// 所有配置写路径（HTTP 保存 / /soul 命令 / set_persona 工具 / soulConfig 服务）
+// 统一经由该队列串行执行「读—改—写」，避免并发写入时各方都基于同一份旧配置合并、
+// 后写覆盖前写（丢更新）。队列按提交顺序执行任务。
+let configWriteQueue = Promise.resolve()
+
+function enqueueConfigWrite(task) {
+  const run = configWriteQueue.then(task)
+  // 队列吞掉单次任务的失败，保证后续写入不会被一次磁盘错误卡死
+  configWriteQueue = run.then(() => {}, () => {})
+  return run
+}
+
+// 在写队列中执行一次配置更新：mutate 收到当前配置的浅拷贝，返回新配置对象。
+// 注意 mutate 必须在队列任务内完成全部读取与合并，不要在队列外提前读取配置。
+async function commitConfig(mutate) {
+  return enqueueConfigWrite(async () => {
+    const next = mutate({ ...(await loadConfig()) })
+    return await saveConfig(next)
+  })
+}
+
+// 将字段级校验错误汇总为一行文本（HTTP 错误信息 / 工具返回消息共用）
+function formatFieldErrors(errors) {
+  return Object.entries(errors)
+    .map(([field, reason]) => `${field}: ${reason}`)
+    .join('；')
+}
+
 // ==================== 提示词编译器 ====================
 
 // Prompt Compiler：编译三层架构为系统提示词
@@ -361,11 +351,43 @@ function registerRoutes(ctx) {
             const config = await loadConfig()
             send(200, { ok: true, config })
           } else if (req.method === 'POST') {
-            let raw = ''
-            for await (const chunk of req) raw += chunk
-            const newConfig = JSON.parse(raw)
-            const current = await loadConfig()
-            const updated = await saveConfig({ ...current, ...newConfig })
+            // 读取请求体：超过大小上限则丢弃内容但继续读完剩余数据，
+            // 避免连接中残留未读字节污染 keep-alive
+            const chunks = []
+            let size = 0
+            let oversized = false
+            for await (const chunk of req) {
+              size += chunk.length
+              if (size > MAX_BODY_BYTES) {
+                oversized = true
+                chunks.length = 0
+                continue
+              }
+              chunks.push(chunk)
+            }
+            if (oversized) {
+              send(413, { ok: false, error: `请求体超过大小上限 ${MAX_BODY_BYTES} 字节` })
+              return
+            }
+
+            // JSON 解析失败属于客户端错误：返回 400 而非 500
+            let body
+            try {
+              body = JSON.parse(Buffer.concat(chunks).toString('utf8'))
+            } catch (err) {
+              send(400, { ok: false, error: '请求体不是合法的 JSON：' + String(err.message || err) })
+              return
+            }
+
+            // 输入校验：字段白名单 + 类型 + 长度上限 + 枚举；存在错误时整单拒绝
+            const { patch, errors } = sanitizeConfig(body)
+            if (Object.keys(errors).length > 0) {
+              send(400, { ok: false, error: '配置校验失败：' + formatFieldErrors(errors), errors })
+              return
+            }
+
+            // 写队列内「读—改—写」，只合并通过校验的字段（未知字段不落盘）
+            const updated = await commitConfig(current => ({ ...current, ...patch }))
             
             // 配置变化后更新系统提示词，并注入所有活动会话
             refreshPromptAndInject(ctx, updated)
@@ -413,7 +435,7 @@ function registerRoutes(ctx) {
         }
 
         try {
-          const config = await saveConfig({ ...DEFAULT_CONFIG })
+          const config = await commitConfig(() => ({ ...DEFAULT_CONFIG }))
 
           // 配置变化后更新系统提示词，并注入所有活动会话
           refreshPromptAndInject(ctx, config)
@@ -538,29 +560,31 @@ function registerCommands(ctx) {
               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.instructionsLabel}${t.colon}${instructions}\n\n${t.help}`
             }
           } else if (args === 'reset') {
-            const updated = await saveConfig({ ...DEFAULT_CONFIG })
+            const updated = await commitConfig(() => ({ ...DEFAULT_CONFIG }))
             // 更新系统提示词，并注入所有活动会话
             refreshPromptAndInject(ctx, updated)
             return { kind: 'success', text: t.resetDone }
           } else if (args === 'enable') {
-            config.enabled = true
-            const updated = await saveConfig(config)
+            // 写队列内「读—改—写」，不在队列外改写内存缓存对象
+            const updated = await commitConfig(c => ({ ...c, enabled: true }))
             // 更新系统提示词，并注入所有活动会话
             refreshPromptAndInject(ctx, updated)
             return { kind: 'success', text: t.enableDone }
           } else if (args === 'disable') {
-            config.enabled = false
-            const updated = await saveConfig(config)
+            const updated = await commitConfig(c => ({ ...c, enabled: false }))
             // 更新系统提示词，并注入所有活动会话
             refreshPromptAndInject(ctx, updated)
             return { kind: 'success', text: t.disableDone }
           } else {
-            // 设置昵称（保留原始大小写，不做 toLowerCase）
-            config.nickname = raw
-            const updated = await saveConfig(config)
+            // 设置昵称（保留原始大小写，不做 toLowerCase）；与 HTTP 保存共用同一套校验
+            const { patch, errors } = sanitizeConfig({ nickname: raw })
+            if (errors.nickname) {
+              return { kind: 'error', text: t.failed(errors.nickname) }
+            }
+            const updated = await commitConfig(c => ({ ...c, nickname: patch.nickname }))
             // 更新系统提示词，并注入所有活动会话
             refreshPromptAndInject(ctx, updated)
-            return { kind: 'success', text: t.nicknameDone(raw) }
+            return { kind: 'success', text: t.nicknameDone(patch.nickname) }
           }
         } catch (err) {
           return { kind: 'error', text: commandMessages(await loadConfig()).failed(err.message) }
@@ -643,7 +667,7 @@ function registerTools(ctx) {
           },
           language: {
             type: 'string',
-            enum: ['zh', 'en'],
+            enum: LANGUAGE_VALUES,
             description: '回复语言：zh=简体中文，en=English。'
           },
           headingLists: {
@@ -685,39 +709,35 @@ function registerTools(ctx) {
         },
         async execute(args) {
           try {
-            const current = await loadConfig()
-            const patch = {}
-            if (typeof args.nickname === 'string' && args.nickname !== current.nickname) {
-              patch.nickname = args.nickname
-            }
-            if (typeof args.occupation === 'string' && args.occupation !== current.occupation) {
-              patch.occupation = args.occupation
-            }
-            if (typeof args.bio === 'string' && args.bio !== current.bio) {
-              patch.bio = args.bio
-            }
-            if (typeof args.style === 'string' && STYLE_VALUES.includes(args.style) && args.style !== current.style) {
-              patch.style = args.style
-            }
-            if (typeof args.language === 'string' && ['zh', 'en'].includes(args.language) && args.language !== current.language) {
-              patch.language = args.language
-            }
-            if (typeof args.headingLists === 'string' && TRAIT_VALUES.includes(args.headingLists) && args.headingLists !== current.headingLists) {
-              patch.headingLists = args.headingLists
-            }
-            if (typeof args.emoji === 'string' && TRAIT_VALUES.includes(args.emoji) && args.emoji !== current.emoji) {
-              patch.emoji = args.emoji
-            }
-            if (typeof args.customInstructions === 'string' && args.customInstructions !== current.customInstructions) {
-              patch.customInstructions = args.customInstructions
+            // 与 HTTP 保存共用同一套校验（白名单 / 类型 / 长度 / 枚举）
+            const { patch, errors } = sanitizeConfig(args)
+            if (Object.keys(errors).length > 0) {
+              return { ok: false, message: '配置校验失败：' + formatFieldErrors(errors) }
             }
             if (Object.keys(patch).length === 0) {
               return { ok: true, message: '没有要更改的设置' }
             }
-            const updated = { ...current, ...patch }
-            await saveConfig(updated)
+
+            // 在写队列内做 diff 与合并，避免与其他写入方（Web UI、/soul 命令）竞态
+            let changes = null
+            const updated = await commitConfig((current) => {
+              const next = { ...current }
+              changes = {}
+              for (const key of Object.keys(patch)) {
+                if (current[key] !== patch[key]) {
+                  next[key] = patch[key]
+                  changes[key] = patch[key]
+                }
+              }
+              return next
+            })
+
+            if (!changes || Object.keys(changes).length === 0) {
+              return { ok: true, message: '没有要更改的设置' }
+            }
+
             refreshPromptAndInject(ctx, updated)
-            return { ok: true, message: '已更新个性化设置', changes: patch }
+            return { ok: true, message: '已更新个性化设置', changes }
           } catch (err) {
             return { ok: false, message: String(err.message || err) }
           }
@@ -741,16 +761,19 @@ export async function apply(ctx) {
       return await loadConfig()
     },
     async updateConfig(newConfig) {
-      const current = await loadConfig()
-      const updated = { ...current, ...newConfig }
-      return await saveConfig(updated)
+      // 与 HTTP 保存共用同一套校验；失败时抛错给服务调用方
+      const { patch, errors } = sanitizeConfig(newConfig)
+      if (Object.keys(errors).length > 0) {
+        throw new Error('配置校验失败：' + formatFieldErrors(errors))
+      }
+      return await commitConfig(current => ({ ...current, ...patch }))
     },
     async getSystemPrompt() {
       const config = await loadConfig()
       return compilePrompt(config)
     },
     async resetConfig() {
-      return await saveConfig({ ...DEFAULT_CONFIG })
+      return await commitConfig(() => ({ ...DEFAULT_CONFIG }))
     }
   })
   

package/lib/config.mjs

@@ -0,0 +1,138 @@
+// lib/config.mjs — dsh-soul 配置层（纯函数模块，无任何依赖）
+//
+// 职责：
+//   - 默认配置与合法取值常量（DEFAULT_CONFIG / STYLE_VALUES / TRAIT_VALUES / LANGUAGE_VALUES）
+//   - 旧版本配置迁移（migrateConfig）
+//   - 外部输入校验（sanitizeConfig）：字段白名单 + 类型断言 + 长度上限 + 枚举校验
+//
+// index.mjs 的所有配置写路径（HTTP 保存 / /soul 命令 / set_persona 工具 / soulConfig 服务）
+// 共用同一套校验；本模块可被 scripts/verify-config.mjs 独立加载测试。
+
+export const DEFAULT_CONFIG = {
+  enabled: true,
+  nickname: '',
+  // 关于你：用户职业 / 用户介绍
+  occupation: '',
+  bio: '',
+  // 回复风格和语调（v0.2.0 起合并为单一选项）
+  style: 'professional',
+  // 特质：标题和列表 / 表情符号（default=默认，more=增强，less=减弱）
+  headingLists: 'default',
+  emoji: 'default',
+  language: 'zh',
+  customInstructions: ''
+}
+
+// 合法的回复风格和语调取值（供工具参数校验）
+export const STYLE_VALUES = ['professional', 'casual', 'humorous', 'roast', 'efficient']
+
+// 特质合法取值
+export const TRAIT_VALUES = ['default', 'more', 'less']
+
+// 输出语言合法取值
+export const LANGUAGE_VALUES = ['zh', 'en']
+
+// 文本字段长度上限：防止超长文本撑爆 system prompt（同时缩小提示词注入面）。
+// 超限一律拒绝、不做静默截断，避免改写用户输入。
+export const FIELD_LIMITS = {
+  nickname: 50,
+  occupation: 50,
+  bio: 500,
+  customInstructions: 2000
+}
+
+// 需做长度校验的自由文本字段
+const TEXT_FIELDS = ['nickname', 'occupation', 'bio', 'customInstructions']
+
+// v0.1.x 配置使用 style + tone 两个字段；v0.2.0 起合并为单一 style（回复风格和语调）。
+// 迁移映射：组合命中用组合表，否则退回旧 style 表，再否则用默认值。
+const LEGACY_STYLE_TONE_MAP = {
+  'professional+formal': 'professional',
+  'casual+neutral': 'casual',
+  'humorous+informal': 'humorous'
+}
+const LEGACY_STYLE_MAP = {
+  professional: 'professional',
+  casual: 'casual',
+  friendly: 'casual',
+  humorous: 'humorous',
+  academic: 'professional'
+}
+
+// 迁移并清洗磁盘上的历史配置：补齐默认值、合并旧 style+tone、丢弃废弃字段、
+// 特质脏数据回退为默认值。
+export function migrateConfig(raw) {
+  const config = { ...DEFAULT_CONFIG, ...raw }
+  if (raw && typeof raw.style === 'string' && typeof raw.tone === 'string') {
+    const combo = `${raw.style}+${raw.tone}`
+    config.style = LEGACY_STYLE_TONE_MAP[combo] || LEGACY_STYLE_MAP[raw.style] || DEFAULT_CONFIG.style
+    delete config.tone
+  }
+  // 人设预设 / 示例指令功能已在 v0.2.0 移除，丢弃历史残留字段
+  delete config.presets
+  delete config.tone
+  delete config.examples
+  // 特质字段校验：脏数据回退为默认值
+  if (!TRAIT_VALUES.includes(config.headingLists)) config.headingLists = 'default'
+  if (!TRAIT_VALUES.includes(config.emoji)) config.emoji = 'default'
+  return config
+}
+
+// 校验外部传入的配置补丁，返回 { patch, errors }：
+//   - patch：通过校验的字段补丁（仅含白名单字段），调用方将其合并到当前配置
+//   - errors：被拒绝字段的原因表（字段名 -> 说明）；非空时调用方应整单拒绝本次写入
+//
+// 规则：
+//   - 白名单：未知字段静默丢弃，不再落盘
+//   - 类型：enabled 必须为布尔；文本字段必须为字符串；枚举字段必须命中合法取值
+//   - 长度：文本字段超过 FIELD_LIMITS 即拒绝（不截断）
+//   - 文本字段保存前 trim 首尾空白，空串视为清除该字段
+export function sanitizeConfig(raw) {
+  const patch = {}
+  const errors = {}
+
+  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+    return { patch, errors: { _: '配置必须是一个 JSON 对象' } }
+  }
+
+  if ('enabled' in raw) {
+    if (typeof raw.enabled === 'boolean') {
+      patch.enabled = raw.enabled
+    } else {
+      errors.enabled = '必须为布尔值（true / false）'
+    }
+  }
+
+  for (const key of TEXT_FIELDS) {
+    if (!(key in raw)) continue
+    const value = raw[key]
+    if (typeof value !== 'string') {
+      errors[key] = '必须为字符串'
+      continue
+    }
+    const text = value.trim()
+    if (text.length > FIELD_LIMITS[key]) {
+      errors[key] = `长度超过上限 ${FIELD_LIMITS[key]} 字符（当前 ${text.length}）`
+      continue
+    }
+    patch[key] = text
+  }
+
+  const ENUM_CHECKS = [
+    ['style', STYLE_VALUES, '回复风格和语调'],
+    ['headingLists', TRAIT_VALUES, '特质·标题和列表'],
+    ['emoji', TRAIT_VALUES, '特质·表情符号'],
+    ['language', LANGUAGE_VALUES, '输出语言']
+  ]
+  for (const [key, values, label] of ENUM_CHECKS) {
+    if (!(key in raw)) continue
+    const value = raw[key]
+    if (typeof value === 'string' && values.includes(value)) {
+      patch[key] = value
+    } else {
+      errors[key] = `${label}必须是 ${values.join(' / ')} 之一`
+    }
+  }
+
+  return { patch, errors }
+}

package/package.json

@@ -1,21 +1,24 @@
 {
   "name": "dsh-soul",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "为 DeepSeek Harness 添加个性化设置",
   "keywords": [
     "dsh",
     "dsh-plugin",
+    "dsh-soul",
     "deepseek",
     "deepseek-harness",
     "personalization",
     "persona",
     "system-prompt",
-    "ai-agent",
     "ai-assistant",
     "customization"
   ],
   "type": "module",
   "main": "index.mjs",
+  "scripts": {
+    "verify": "node scripts/verify-config.mjs"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -48,8 +51,10 @@
   },
   "files": [
     "index.mjs",
+    "lib",
     "client",
     "cordis.patch.yml",
+    "scripts",
     "README.md",
     "README_EN.md"
   ]

package/scripts/verify-config.mjs

@@ -0,0 +1,142 @@
+// scripts/verify-config.mjs — 配置层纯函数自检（npm run verify）
+//
+// 覆盖 lib/config.mjs 的 migrateConfig / sanitizeConfig：
+//   - 旧版本 style+tone 迁移、废弃字段清理、特质脏数据回退
+//   - 白名单 / 类型 / 长度 / 枚举校验的接受与拒绝路径
+// 零依赖，直接 `node scripts/verify-config.mjs` 运行。
+
+import assert from 'node:assert/strict'
+import {
+  DEFAULT_CONFIG,
+  FIELD_LIMITS,
+  migrateConfig,
+  sanitizeConfig
+} from '../lib/config.mjs'
+
+let passed = 0
+function check(name, fn) {
+  fn()
+  passed++
+  console.log(`  ✓ ${name}`)
+}
+
+console.log('migrateConfig')
+
+check('非对象输入返回默认配置', () => {
+  assert.deepEqual(migrateConfig(null), DEFAULT_CONFIG)
+  assert.deepEqual(migrateConfig(undefined), DEFAULT_CONFIG)
+})
+
+check('正常配置原样保留并补齐默认值', () => {
+  const config = migrateConfig({ enabled: false, nickname: '小明', style: 'roast', language: 'en' })
+  assert.equal(config.enabled, false)
+  assert.equal(config.nickname, '小明')
+  assert.equal(config.style, 'roast')
+  assert.equal(config.language, 'en')
+  assert.equal(config.headingLists, 'default')
+  assert.equal(config.emoji, 'default')
+})
+
+check('v0.1.x style+tone 组合迁移', () => {
+  assert.equal(migrateConfig({ style: 'professional', tone: 'formal' }).style, 'professional')
+  assert.equal(migrateConfig({ style: 'casual', tone: 'neutral' }).style, 'casual')
+  assert.equal(migrateConfig({ style: 'humorous', tone: 'informal' }).style, 'humorous')
+})
+
+check('v0.1.x 旧 style 名迁移（friendly→casual，academic→professional）', () => {
+  assert.equal(migrateConfig({ style: 'friendly', tone: 'neutral' }).style, 'casual')
+  assert.equal(migrateConfig({ style: 'academic', tone: 'formal' }).style, 'professional')
+})
+
+check('废弃字段 tone / presets / examples 清理', () => {
+  const config = migrateConfig({ nickname: 'x', tone: 'formal', presets: [1], examples: 'y' })
+  assert.equal('tone' in config, false)
+  assert.equal('presets' in config, false)
+  assert.equal('examples' in config, false)
+})
+
+check('特质脏数据回退为默认值', () => {
+  const config = migrateConfig({ headingLists: 'always', emoji: 1 })
+  assert.equal(config.headingLists, 'default')
+  assert.equal(config.emoji, 'default')
+})
+
+console.log('sanitizeConfig')
+
+check('合法补丁全部通过', () => {
+  const { patch, errors } = sanitizeConfig({
+    enabled: false,
+    nickname: '小明',
+    occupation: '工程师',
+    bio: '写代码的',
+    style: 'humorous',
+    headingLists: 'more',
+    emoji: 'less',
+    language: 'en',
+    customInstructions: '保持简洁'
+  })
+  assert.deepEqual(errors, {})
+  assert.equal(patch.enabled, false)
+  assert.equal(patch.nickname, '小明')
+  assert.equal(patch.occupation, '工程师')
+  assert.equal(patch.style, 'humorous')
+  assert.equal(patch.headingLists, 'more')
+  assert.equal(patch.emoji, 'less')
+  assert.equal(patch.language, 'en')
+  assert.equal(patch.customInstructions, '保持简洁')
+})
+
+check('未知字段静默丢弃（不进入 patch，也不报错）', () => {
+  const { patch, errors } = sanitizeConfig({ nickname: 'x', hacked: 'junk', presets: [1] })
+  assert.deepEqual(errors, {})
+  assert.deepEqual(patch, { nickname: 'x' })
+})
+
+check('类型错误被拒绝：enabled 非布尔、文本非字符串', () => {
+  const { errors } = sanitizeConfig({ enabled: 'yes', nickname: 123 })
+  assert.ok(errors.enabled)
+  assert.ok(errors.nickname)
+})
+
+check('枚举错误被拒绝：style / headingLists / emoji / language', () => {
+  const { errors } = sanitizeConfig({ style: 'hacker', headingLists: 'always', emoji: 'max', language: 'jp' })
+  assert.ok(errors.style)
+  assert.ok(errors.headingLists)
+  assert.ok(errors.emoji)
+  assert.ok(errors.language)
+})
+
+check('超长文本被拒绝且不截断', () => {
+  const { errors, patch } = sanitizeConfig({
+    nickname: '名'.repeat(FIELD_LIMITS.nickname + 1),
+    customInstructions: 'a'.repeat(FIELD_LIMITS.customInstructions + 1)
+  })
+  assert.ok(errors.nickname)
+  assert.ok(errors.customInstructions)
+  assert.equal('nickname' in patch, false)
+  assert.equal('customInstructions' in patch, false)
+})
+
+check('长度上限边界值通过', () => {
+  const { errors } = sanitizeConfig({
+    nickname: '名'.repeat(FIELD_LIMITS.nickname),
+    bio: 'b'.repeat(FIELD_LIMITS.bio),
+    customInstructions: 'a'.repeat(FIELD_LIMITS.customInstructions)
+  })
+  assert.deepEqual(errors, {})
+})
+
+check('文本字段首尾空白被 trim，空白串视为清除', () => {
+  const { patch, errors } = sanitizeConfig({ nickname: '  小明  ', bio: '   ' })
+  assert.deepEqual(errors, {})
+  assert.equal(patch.nickname, '小明')
+  assert.equal(patch.bio, '')
+})
+
+check('非对象输入整体拒绝', () => {
+  assert.ok(sanitizeConfig([1, 2]).errors._)
+  assert.ok(sanitizeConfig('x').errors._)
+  assert.ok(sanitizeConfig(null).errors._)
+})
+
+console.log(`\n全部通过：${passed} 项检查`)