dlaoshi-outfit 2.1.3 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 2.2.0 — 2026-10-22
+
+重磅功能：**称呼与语气**（默认称呼「主人」）。
+
+- 宿主通过官方 `ctx.systemPrompt.section()` 注入一段「称呼规则」，`text` 是函数，
+  改设置后**下一个模型步骤立刻生效**，不用重启
+- 只影响称呼与句末语气词；提示词里明确禁止改变回答的事实、结论、结构、代码、
+  工具调用、专业程度与长度
+- 设置 › 通用新增一行：称呼输入框 + 两个开关（启用称呼 / 语气词）
+- 设置持久化到 `~/.dsh/fatfish-outfit/persona.json`
+- 路由 `/fatfish/persona` 支持 GET/POST，仅回环可用
+- 测试新增：提示词段落注册、默认「主人」、改名即时生效、语气开关、禁用后段落为空、
+  非回环 403；测试使用临时 HOME，不再污染真实配置
+
+## 2.1.4 — 2026-10-22
+
+按 DSH 的「可逆副作用」规范重写挂载流程，支持热重组。
+
+- 所有副作用都成对：样式表、`html` 皮肤类、主题 token、槽位占用全部由 `ctx.effect` 托管，
+  卸载时逐项回滚，不再依赖页面刷新
+- 二次 `apply()` 幂等：先释放上一批槽位占用再挂载，避免热重组后出现两只桌宠
+- 新增自愈：槽位容器还在、本插件节点消失时（HMR 驱逐），约 5 秒内自动重新挂载
+- 测试新增「重复 apply 不重复占用槽位」断言
+
+> 注意：全新安装插件仍需重启一次 Host——DSH 的插件图在启动时组合，这不是插件能绕过的。
+
 ## 2.1.3 — 2026-10-22
 
 修复：网页端加载失败（`__ModuleLoader__` 未注册）。

package/README.md

@@ -28,6 +28,7 @@
 | 🫧 点击立牌 | q 弹回弹 + 气泡膜"啵"声 + 单独一个余额气泡（读取官方 `deepseekAccount`） |
 | 🖼️ 聊天背景 | 用你自己的插画做会话区壁纸，主题自适应蒙版保证可读性 |
 | 🧊 液态玻璃 | 输入框磨砂玻璃 + 高光描边（不再有黑气泡，消息为纯文字） |
+| 🗣️ 称呼与语气 | 设置 › 通用 里设置它怎么称呼你（默认「主人」），只改措辞不改回答方式 |
 | ⚙️ 主题开关 | 设置 › 通用 里的滑动开关：一键启用 / 禁用整套外观 |
 
 ## 安装
@@ -100,6 +101,22 @@ Copy-Item "C:\Users\你\Documents\dlaoshi-outfit\*" `
   - **开**：壁纸 + 液态玻璃 + 桌宠 + 立牌 + 侧栏头像
   - **关**：以上全部隐藏，恢复 DSH 原始界面（开关状态会记住）
 
+## 称呼与语气
+
+设置 › 通用 › **「D老师」怎么称呼你**：
+
+- 输入框里填称呼，默认 **主人**
+- 左侧开关 = 启用 / 关闭称呼
+- 右侧开关 = 是否允许偶尔加句末语气词（呀 / 呢 / 哦 / 啦）
+
+实现方式：宿主用官方 `ctx.systemPrompt.section('dlaoshi:address')` 注入一段规则，段落文本是函数，
+改完设置**下一个模型步骤就生效**。提示词里明确写了：
+
+> 只改变称呼和语气词：回答的事实、结论、结构、代码、工具调用、专业程度与长度都保持原样。
+
+所以它不会改变回答习惯，只是称呼与措辞更亲近。设置保存在
+`~/.dsh/fatfish-outfit/persona.json`，重启后保持。
+
 ## 兼容性
 
 - 只依赖 DSH 自带的 Client 运行时与官方 `deepseekAccount` 能力，**无第三方依赖**
@@ -123,6 +140,36 @@ Copy-Item "C:\Users\你\Documents\dlaoshi-outfit\*" `
 └── examples/              # profile 配置示例
 ```
 
+## 常见问题
+
+### 装完之后没反应 / 第一次启动不生效
+
+**这是 DSH 的加载机制，不是插件的问题。** 本插件已按「可逆副作用」实现：卸载即回滚、重复挂载不会叠加、被 HMR 驱逐后会自动重挂，但**全新安装仍需重启一次 Host**（插件图只在启动时组合）。 DSH 的插件图（loader entries）在 **Host 启动时组合**；热更新只对已经加载过的客户端 bundle 生效。全新安装一个插件等于往插件图里加一个新 entry，**必须完整重启一次 DSH** 才会生效。
+
+排查顺序：
+
+1. 完全退出 DSH（不是关窗口，要从托盘/任务管理器退出）
+2. 重新启动
+3. 设置 → 插件，确认 `dlaoshi-outfit` 存在且已启用
+4. 仍不出现 → 再重启一次（首次安装有时需要两轮：第一轮装包、第二轮组合）
+5. 打开浏览器控制台（F12），看有没有 `__ModuleLoader__` 相关报错
+
+### 桌宠突然消失
+
+通常是客户端热更新（HMR）把插件卸载后没有重新挂载。按 `Ctrl+R` 刷新页面即可；刷新后仍不在就重启 DSH。
+
+### 网页端提示「加载插件失败 / 未注册」
+
+确认安装的是 **2.1.3 或更高版本**。`2.1.0` 和 `2.1.1` 的客户端注册 id 与包名不一致，已被标记 deprecated：
+
+```powershell
+dsh plugin add dlaoshi-outfit@2.1.3
+```
+
+### 开发时想热更新
+
+客户端代码改动只有在 `pnpm run dev:web` 同时运行时才会自动重建并热替换；否则改完 `client.js` 需要重启 DSH。
+
 ## 开发
 
 ```powershell

package/client.js

@@ -78,6 +78,10 @@ window.__ModuleLoader__.load({
       listener(outfitEnabled)
       return () => { outfitListeners.delete(listener) }
     }
+
+    /** Disposer of the currently mounted occupant set, shared across apply()
+     *  calls so a second mount replaces the first instead of stacking on it. */
+    let mountedOccupants = null
     /** Host route that reports the live turn's tokens and think latency. */
     const STATS_PATH = '/fatfish/stats'
   
@@ -247,6 +251,16 @@ html:not(.${SKIN_CLASS}) .${PREFIX}-hero { display: none !important; }
   border-radius: 50%; background: #fff; box-shadow: 0 1px 3px rgba(0,0,0,.25);
   transition: transform .2s cubic-bezier(.2,.9,.3,1); }
 .${PREFIX}-switch[aria-checked='true'] .${PREFIX}-switch-knob { transform: translateX(20px); }
+/* the addressing row: text field + two switches */
+.${PREFIX}-persona-row { display: flex; align-items: center; gap: 10px; flex-wrap: wrap;
+  justify-content: flex-end; max-width: 320px; }
+.${PREFIX}-input { flex: 1; min-width: 120px; padding: 6px 10px; border-radius: 8px;
+  border: 1px solid var(--dsw-alias-border-l2, rgba(150,190,255,.3));
+  background: transparent; color: inherit; outline: none;
+  font: 500 13px/1.4 "Segoe UI","Microsoft YaHei",system-ui,sans-serif; }
+.${PREFIX}-input:focus { border-color: #2F55E0; }
+.${PREFIX}-persona-hint { flex: 1 0 100%; text-align: right;
+  font: 400 11px/16px "Segoe UI","Microsoft YaHei",system-ui,sans-serif; opacity: .7; }
 
 /* ============================================================ chat skin == */
 /* The supplied illustration is the chat page's wallpaper. A theme-aware veil
@@ -1100,7 +1114,65 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
     }
 
     /**
-     * The Settings row for the theme switch.
+     * Settings row for the addressing feature: what the model calls the user.
+     *
+     * The Host owns the value (it is written into the prompt as a section), so
+     * this row is a thin client: GET on mount, POST on change.
+     */
+    function PersonaSettingsRow() {
+      const [persona, setPersona] = useState({ enabled: true, address: '主人', tone: true })
+      useEffect(() => {
+        if (typeof fetch !== 'function') return
+        fetch('/fatfish/persona', { cache: 'no-store' })
+          .then((res) => (res.ok ? res.json() : null))
+          .then((data) => { if (data && data.ok && data.persona) setPersona(data.persona) })
+          .catch(() => { /* the host route may be absent on an old build */ })
+      }, [])
+      const save = (next) => {
+        setPersona(next)
+        if (typeof fetch !== 'function') return
+        fetch('/fatfish/persona', {
+          method: 'POST',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify(next),
+        }).catch(() => { /* keep the local value; the next poll retries */ })
+      }
+      return h('div', { class: `${PREFIX}-settings` },
+        h('div', { class: `${PREFIX}-settings-text` },
+          h('div', { class: `${PREFIX}-settings-title` }, '「D老师」怎么称呼你'),
+          h('div', { class: `${PREFIX}-settings-desc` },
+            '默认称呼「主人」；只增加称呼与语气词，不改变回答方式与内容。')),
+        h('div', { class: `${PREFIX}-persona-row` },
+          h('input', {
+            class: `${PREFIX}-input`,
+            type: 'text',
+            value: persona.address,
+            maxLength: 24,
+            placeholder: '主人',
+            'aria-label': '称呼',
+            onChange: (event) => save({ ...persona, address: event.target.value }),
+          }),
+          h('button', {
+            type: 'button',
+            role: 'switch',
+            'aria-checked': persona.enabled ? 'true' : 'false',
+            class: `${PREFIX}-switch`,
+            title: persona.enabled ? '关闭称呼' : '启用称呼',
+            onClick: () => save({ ...persona, enabled: !persona.enabled }),
+          }, h('span', { class: `${PREFIX}-switch-knob` })),
+          h('button', {
+            type: 'button',
+            role: 'switch',
+            'aria-checked': persona.tone ? 'true' : 'false',
+            class: `${PREFIX}-switch`,
+            title: persona.tone ? '关闭语气词' : '启用语气词',
+            onClick: () => save({ ...persona, tone: !persona.tone }),
+          }, h('span', { class: `${PREFIX}-switch-knob` })),
+          h('div', { class: `${PREFIX}-persona-hint` }, '左边开关=称呼，右边开关=语气词')))
+    }
+
+    /**
+     * The Settings row for the whole outfit switch.
      *
      * Rendered inside DSH's own "General" settings list, so it inherits the
      * page's typography and spacing. The switch drives the whole outfit: the
@@ -1152,18 +1224,34 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
           window.__petDebug = { starts: 0, ends: 0, happy: 0, sad: 0, balance: null }
         }
 
+        // Reversible, idempotent mount. Every side effect below is paired with a
+        // disposer owned by this plugin's fiber, so the loader can apply this
+        // module again (hot recompose) without a restart and without leaving a
+        // duplicate stylesheet, class or slot occupant behind.
+        if (typeof document.querySelectorAll === 'function') {
+          for (const stale of document.querySelectorAll('style[data-plugin="dlaoshi-outfit"]')) {
+            try { stale.remove() } catch (err) { /* already detached */ }
+          }
+        }
+
         // Apply the remembered outfit state before the stylesheet mounts so the
         // page never flashes the beautified look on a "switched off" session.
         outfitEnabled = readOutfitSetting()
-        applyOutfitClass(outfitEnabled)
+        ctx.effect(() => {
+          applyOutfitClass(outfitEnabled)
+          return () => {
+            try { document.documentElement.classList.remove(SKIN_CLASS) } catch (err) { /* no document */ }
+          }
+        }, 'dlaoshi-pet: skin class')
 
-        const tag = document.createElement('style')
-        tag.dataset.plugin = 'dlaoshi-outfit'
-        tag.textContent = CSS
-        document.head.appendChild(tag)
-        ctx.effect(() => () => {
-          tag.remove()
-          document.documentElement.classList.remove(SKIN_CLASS)
+        ctx.effect(() => {
+          const tag = document.createElement('style')
+          tag.dataset.plugin = 'dlaoshi-outfit'
+          tag.textContent = CSS
+          document.head.appendChild(tag)
+          return () => {
+            try { tag.remove() } catch (err) { /* already detached */ }
+          }
         }, 'dlaoshi-pet: stylesheet')
 
         ctx.effect(() => ctx.theme.overrideTokens('dlaoshi-outfit', TOKENS),
@@ -1172,16 +1260,53 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
         const occupy = (name, id, order, component) => ctx.slots.inject(name, () =>
           ctx.slots.register({ name, id, order }, component))
 
-        ctx.effect(() => {
+        // A second mount must replace the first, never stack on top of it: the
+        // loader may re-apply this module while a previous occupant set is still
+        // registered (hot recompose), and two pets would otherwise fight.
+        const mountOccupants = () => {
+          if (typeof mountedOccupants === 'function') {
+            try { mountedOccupants() } catch (err) { /* already gone */ }
+            mountedOccupants = null
+          }
           const stop = [
             occupy('shell.overlay', 'dlaoshi-companion', 20, Companion),
             occupy('sidebar.brand.mark', 'dlaoshi-sidebar', 5, SidebarMark),
             occupy('conversation.hero.brand.mark', 'dlaoshi-hero', 5, HeroCharacter),
-            // the switch lives in Settings › General, like DSH's own rows
+            // the switches live in Settings › General, like DSH's own rows
             occupy('settings.general.item', 'dlaoshi-theme', 40, ThemeSettingsRow),
+            occupy('settings.general.item', 'dlaoshi-persona', 41, PersonaSettingsRow),
           ]
           return () => { for (const fn of stop) if (typeof fn === 'function') fn() }
+        }
+
+        mountedOccupants = mountOccupants()
+        ctx.effect(() => () => {
+          if (typeof mountedOccupants === 'function') mountedOccupants()
+          mountedOccupants = null
         }, 'dlaoshi-pet: slot occupants')
+
+        // Self heal for hot recomposition: when the loader evicts this module's
+        // occupants but the overlay slot itself stays mounted, remount instead of
+        // leaving the user with a vanished pet until they refresh.
+        ctx.effect(() => {
+          if (typeof window === 'undefined' || typeof document === 'undefined') return () => {}
+          let misses = 0
+          const timer = setInterval(() => {
+            try {
+              const slot = document.querySelector('[data-slot="shell.overlay"]')
+              if (!slot || typeof slot.querySelector !== 'function') { misses = 0; return }
+              if (slot.querySelector(`.${PREFIX}-pet`)) { misses = 0; return }
+              misses += 1
+              if (misses < 2) return
+              misses = 0
+              mountedOccupants = mountOccupants()
+            } catch (err) {
+              misses = 0
+            }
+          }, 2500)
+          if (timer && typeof timer.unref === 'function') timer.unref()
+          return () => clearInterval(timer)
+        }, 'dlaoshi-pet: hot-recompose self heal')
       },
     }
   },

package/index.js

@@ -22,10 +22,69 @@
 /** The web server is the only service required. */
 export const inject = ['webServer']
 
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+
 const BASE = '/fatfish'
 const MAX_SESSIONS = 16
 const LOOPBACKS = new Set(['127.0.0.1', '::1', '::ffff:127.0.0.1'])
 
+/* ------------------------------------------------------------ persona ----- */
+
+/** Where the "how should it address me" setting lives (survives restarts). */
+const PERSONA_PATH = path.join(os.homedir(), '.dsh', 'fatfish-outfit', 'persona.json')
+const DEFAULT_PERSONA = { enabled: true, address: '主人', tone: true }
+
+function loadPersona() {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(PERSONA_PATH, 'utf8'))
+    return {
+      enabled: parsed.enabled !== false,
+      address: typeof parsed.address === 'string' && parsed.address.trim()
+        ? parsed.address.trim().slice(0, 24)
+        : DEFAULT_PERSONA.address,
+      tone: parsed.tone !== false,
+    }
+  } catch (err) {
+    return { ...DEFAULT_PERSONA }
+  }
+}
+
+function savePersona(persona) {
+  try {
+    fs.mkdirSync(path.dirname(PERSONA_PATH), { recursive: true })
+    fs.writeFileSync(PERSONA_PATH, JSON.stringify(persona, null, 2), 'utf8')
+  } catch (err) { /* best effort: the setting still applies for this run */ }
+}
+
+/**
+ * The prompt section that carries the addressing rule.
+ *
+ * Deliberately narrow: it changes how the model addresses the user and which
+ * light sentence-final particles it may use. It explicitly forbids touching the
+ * answer's content, structure, code, tools or length, so answer habits stay the
+ * same. Returns '' when the feature is switched off, which makes the section
+ * empty and therefore invisible to the model.
+ */
+function personaPrompt(persona) {
+  if (!persona.enabled) return ''
+  const address = persona.address || DEFAULT_PERSONA.address
+  const lines = [
+    '## 称呼与语气（只影响措辞，不影响回答内容）',
+    `- 在称呼用户时使用「${address}」。`,
+  ]
+  if (persona.tone) {
+    lines.push('- 可以在句首或句尾偶尔加一个很轻的语气词（呀 / 呢 / 哦 / 啦），让语气更有陪伴感；不要每句都加。')
+  }
+  lines.push(
+    '- 这条规则只改变称呼和语气词：回答的事实、结论、结构、代码、工具调用、专业程度与长度都保持原样。',
+    '- 不要为了使用称呼而重复用户的话，也不要刻意卖萌或降低信息密度。',
+    '- 如果用户使用其他语言，请使用该语言里对应的称呼（例如英文用 "Master"）。',
+  )
+  return lines.join('\n')
+}
+
 /** One turn's accounting; replaced at every `turn/start`. */
 function blank(sessionId) {
   return {
@@ -274,6 +333,56 @@ export function apply(ctx) {
     return balanceCache.value
   }
 
+  // ---- addressing: one persona section the model sees on every step ------
+  // The section text is a function, so changing the setting takes effect on the
+  // very next model step without re-registering anything.
+  let persona = loadPersona()
+  ctx.inject(['systemPrompt'], (scope) => {
+    const registry = scope && scope.systemPrompt
+    if (!registry || typeof registry.section !== 'function') return
+    registry.section({
+      name: 'dlaoshi:address',
+      order: 9000,
+      text: () => personaPrompt(persona),
+    })
+  })
+
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: `${BASE}/persona`,
+    handler: (req, res) => {
+      if (!isLoopback(req)) {
+        respondJson(res, 403, { ok: false, error: 'loopback only' })
+        return
+      }
+      if (req.method === 'POST') {
+        let body = ''
+        req.on('data', (chunk) => {
+          body += chunk
+          if (body.length > 4096) req.destroy()
+        })
+        req.on('end', () => {
+          try {
+            const parsed = JSON.parse(body || '{}')
+            persona = {
+              enabled: parsed.enabled !== false,
+              address: typeof parsed.address === 'string' && parsed.address.trim()
+                ? parsed.address.trim().slice(0, 24)
+                : DEFAULT_PERSONA.address,
+              tone: parsed.tone !== false,
+            }
+            savePersona(persona)
+            respondJson(res, 200, { ok: true, persona })
+          } catch (err) {
+            respondJson(res, 400, { ok: false, error: 'invalid json' })
+          }
+        })
+        return
+      }
+      respondJson(res, 200, { ok: true, persona })
+    },
+  }), 'fatfish: persona route')
+
   ctx.effect(() => ctx.webServer.register({
     kind: 'exact',
     path: `${BASE}/balance`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dlaoshi-outfit",
-  "version": "2.1.3",
+  "version": "2.2.0",
   "type": "module",
   "description": "Anime whale-boy maid-outfit desktop pet, token/think-time standee and liquid-glass theme for DeepSeek Harness",
   "exports": {