dlaoshi-outfit 2.1.4 → 2.2.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 2.2.1 — 2026-10-22
+
+立牌只出现在聊天页。
+
+- 轮询判断当前是否在聊天页：设置/插件等以 `[role="dialog"][aria-modal="true"]` 打开的页面，
+  或会话区不可见时，立牌整体隐藏（`display:none`），不再浮在二级页面之上
+- 回到聊天页自动恢复，气泡状态保留
+- 客户端测试新增 `data-on-chat` 断言
+
+## 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 的「可逆副作用」规范重写挂载流程，支持热重组。

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` 能力，**无第三方依赖**

package/client.js

@@ -251,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
@@ -973,6 +983,34 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
         balanceTimer.current = setTimeout(() => setBalanceOpen(false), ms === undefined ? BUBBLE_HOLD_MS : ms)
       }
 
+      // The standee belongs to the conversation view only: settings, the plugin
+      // manager and other secondary pages are modal dialogs or replace the chat
+      // pane, and the standee must not float over them.
+      const [onChat, setOnChat] = useState(true)
+      useEffect(() => {
+        if (typeof document === 'undefined') return undefined
+        const check = () => {
+          let visible = true
+          try {
+            if (document.querySelector('[role="dialog"][aria-modal="true"]')) visible = false
+            if (visible) {
+              const content = document.querySelector('[data-conversation-content]')
+              if (content) {
+                const rect = typeof content.getBoundingClientRect === 'function'
+                  ? content.getBoundingClientRect()
+                  : null
+                visible = rect === null || (rect.width > 0 && rect.height > 0)
+              }
+            }
+          } catch (err) { visible = true }
+          setOnChat((prev) => (prev === visible ? prev : visible))
+        }
+        check()
+        const timer = setInterval(check, 600)
+        if (timer && typeof timer.unref === 'function') timer.unref()
+        return () => clearInterval(timer)
+      }, [])
+
       // Responsive size: the standee must fit the free right margin of the
       // conversation, so a windowed app gets a smaller standee instead of one
       // that covers the messages. Falls back to a viewport-proportional width,
@@ -1070,9 +1108,12 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
 
       return h('div', {
         class: `${PREFIX}-stats`,
-        style: { right: STATS_PIN.right + 'px', bottom: STATS_PIN.bottom + 'px' },
+        style: onChat
+          ? { right: STATS_PIN.right + 'px', bottom: STATS_PIN.bottom + 'px' }
+          : { right: STATS_PIN.right + 'px', bottom: STATS_PIN.bottom + 'px', display: 'none' },
         title: detail,
         'data-popping': popping ? 'true' : 'false',
+        'data-on-chat': onChat ? 'true' : 'false',
       },
         reportVisible || balanceVisible ? h('div', { class: `${PREFIX}-clouds` },
           balanceVisible ? h('div', { key: 'balance', class: `${PREFIX}-cloud`, 'data-kind': 'balance' },
@@ -1104,7 +1145,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
@@ -1204,8 +1303,9 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
             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() }
         }

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.4",
+  "version": "2.2.1",
   "type": "module",
   "description": "Anime whale-boy maid-outfit desktop pet, token/think-time standee and liquid-glass theme for DeepSeek Harness",
   "exports": {