dsh-dupguard 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 本文件遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [1.3.1] - 2026-09-05
+
+### Fixed
+
+- **白名单按「单个字符」匹配的语义两端不一致**：设置页会把整串输入（如 `ab`）当成一个条目，
+  而检测按单个字符比对，该条目永远不会生效。现在设置页把一次输入拆成单个字符逐个加入
+  （忽略其中的空白），宿主对存量或手改的多字符、空、非字符串条目在运行时丢弃并打印告警；
+  白名单比对同时改为按 Unicode 码点进行，emoji 等代理对字符可作为单个条目正常生效。
+- **未改动的数值输入在失焦时也会写入**，把默认值写进用户层（`settings.yaml` 里因此出现
+  `threshold: 10`、`maxUnitLength: 80`、`detectionWindow: 8192` 这类无意义条目）。现在值与
+  宿主一致时跳过写入。
+- **跨字段约束只在「最大单元」一行提示**：从「最小单元」一侧提交违规值时只能拿到宿主拒绝后的
+  泛化「保存失败」。现在两行都给出具体错误并在本地拦截写入。
+- 截停收尾遇到未知块类型（协议新增 `ContentBlock` 类型）时会静默按 tool-call 兜底，
+  现补充一次性宿主告警，便于定位协议漂移。
+
 ## [1.3.0] - 2026-09-05
 
 ### Added

package/README.md

@@ -128,7 +128,7 @@ and persisted to `settings.yaml`; the dynamic build uses the constants.
 | `maxUnitLength` | `80` | 最大重复单元长度 / maximum repeating-unit length |
 | `detectionWindow` | `8192` | 检测滚动窗口（字符，去空白后），需 ≥ 阈值 × 最大单元长度 / rolling detection window in chars (after whitespace removal); must be ≥ threshold × max unit length |
 | `stripWhitespace` | `true` | 检测前移除空白/换行，识别带分隔符的复读 / strip whitespace so `"x x x"` and `"x\nx\nx"` are caught |
-| `ignoredChars` | `['-', '\|']` | 检测时忽略的字符白名单：Markdown 表格分隔行（连字符与竖线）不参与重复统计 / whitelist of characters ignored during detection, so Markdown table separators don't count |
+| `ignoredChars` | `['-', '\|']` | 检测时忽略的字符白名单：Markdown 表格分隔行（连字符与竖线）不参与重复统计。条目必须**是单个字符**（按 Unicode 码点匹配，emoji 也算一个）；设置页一次输入多个字符会逐个加入，多字符/空条目在运行时被丢弃并告警 / whitelist of characters ignored during detection, so Markdown table separators don't count. Entries must be a **single character** (matched per Unicode code point); the settings page splits multi-character input into individual entries, and invalid entries are dropped at runtime with a warning |
 | `monitorReasoning` | `true` | 是否检测思考文本（思考中的复读同样消耗 token，默认截停；只检测可见输出时置 `false`）/ also guard reasoning (thinking) text — on by default; set `false` to guard visible output only |
 | `monitorToolArguments` | `false` | 是否检测工具调用参数 / also guard tool-call JSON args — off by default (base64/JSON repeats are common) |
 | `fixStandingMountConflict` | `true` | DSH ≤ 0.1.2-rc.1 兼容补丁：幂等化 `cordisInspect.register`，修复 preset standing-mount 多代并存冲突（仅代码常量）/ idempotent `cordisInspect.register` patch for the DSH ≤ 0.1.2-rc.1 standing-mount conflict (code constant only) |
@@ -247,6 +247,11 @@ Node 20/22/24 (matching DSH; Node 18 is not supported).
 - 停止时若恰有未闭合的工具调用块（顺序输出块的适配器几乎不可能），该块会按已累积参数闭合并可能被执行。
 - 服务端停止依赖适配器在流关闭时中止底层请求的语义（已验证 `dsh-llm-deepseek`；自定义适配器需自查）。
 - 阈值语义为 `>= threshold`：第 10 次重复出现时即停止。
+- 检测窗口上限 1,048,576 字符：窗口越大，每个增量都要重写一次缓冲（实测 1Mi 窗口约 0.13 ms/增量），
+  极端长输出下会有可感知的额外开销；默认 8192 无此问题。
+- 若手工编辑 `settings.yaml` 写入非法值（如 `minUnitLength > maxUnitLength`），DSH 会在注册时拒绝该
+  命名空间，本插件捕获后仅打印错误日志并整体回落到代码默认值（检测功能不受影响，设置页显示默认值）。
+- 协议新增 `ContentBlock` 类型时，截停收尾对未知块类型只能按 tool-call 兜底并打印一次性告警。
 
 ### DSH 运行期间编辑 preset 后的 standing-mount 冲突（DSH ≤ 0.1.2-rc.1 缺陷，本插件已内置补丁）
 

package/lib/client.js

@@ -24,9 +24,9 @@ window.__ModuleLoader__.load({
       nav: '重复守卫',
       title: '重复输出守卫',
       intro: '模型输出中同一字符串连续重复达到阈值次数时自动截停。以下参数修改后即时生效并持久化（settings.yaml）。',
-      list: '忽略字符（白名单）',
+      list: '忽略字符（白名单，按单个字符匹配）',
       empty: '白名单为空：所有字符都参与重复统计。',
-      addPlaceholder: '输入要忽略的字符',
+      addPlaceholder: '输入要忽略的字符（可多个）',
       add: '添加',
       params: '检测参数',
       threshold: '触发阈值（连续重复次数）',
@@ -51,6 +51,7 @@ window.__ModuleLoader__.load({
       errInteger: '请输入整数。',
       errRange: '取值范围 {min}–{max}。',
       errCross: '不能小于最小重复单元长度（当前 {min}）。',
+      errCrossMin: '不能大于最大重复单元长度（当前 {max}）。',
       windowWarn: '⚠ 检测窗口长度需要提高：至少 {need}（当前 {current} = 阈值 {threshold} × 最大单元 {maxUnit}）。当前窗口下超过 {effective} 字符的重复单元无法识别。',
       loading: '加载中…',
       remoteHint: '设置修改仅支持本机连接：请通过本机地址（127.0.0.1）打开 DSH 页面后重试。远程访问时 DSH 的设置通道被禁用，检测参数将使用默认值。',
@@ -60,9 +61,9 @@ window.__ModuleLoader__.load({
       nav: 'Dupguard',
       title: 'Repetition Guard',
       intro: 'Generation stops when the same string repeats consecutively up to the threshold. Changes below take effect immediately and persist to settings.yaml.',
-      list: 'Ignored characters (whitelist)',
+      list: 'Ignored characters (whitelist, matched per character)',
       empty: 'Whitelist is empty: every character counts.',
-      addPlaceholder: 'Character to ignore',
+      addPlaceholder: 'Characters to ignore (one or more)',
       add: 'Add',
       params: 'Detection parameters',
       threshold: 'Threshold (consecutive repeats)',
@@ -87,6 +88,7 @@ window.__ModuleLoader__.load({
       errInteger: 'Enter an integer.',
       errRange: 'Allowed range {min}–{max}.',
       errCross: 'Must not be smaller than the minimum unit length (currently {min}).',
+      errCrossMin: 'Must not be larger than the maximum unit length (currently {max}).',
       windowWarn: '⚠ Detection window is too small: needs at least {need} (currently {current} = threshold {threshold} x max unit {maxUnit}). Units longer than {effective} characters cannot be detected with the current window.',
       loading: 'Loading…',
       remoteHint: 'Settings editing requires a local connection: open the DSH page through the local address (127.0.0.1) and retry. Remote browsers have the settings channel disabled and detection keeps its defaults.',
@@ -281,7 +283,10 @@ window.__ModuleLoader__.load({
         const value = parsed[field.key]
         if (!Number.isInteger(value)) return t('errInteger')
         if (value < field.min || value > field.max) return fmt(t('errRange'), { min: field.min, max: field.max })
-        if (field.key === 'maxUnitLength' && crossInvalid) return fmt(t('errCross'), { min: parsed.minUnitLength })
+        // 跨字段约束在两侧都提示：否则从「最小单元」一侧提交违规值时，
+        // 只能拿到宿主拒绝后的泛化「保存失败」。
+        if (crossInvalid && field.key === 'maxUnitLength') return fmt(t('errCross'), { min: parsed.minUnitLength })
+        if (crossInvalid && field.key === 'minUnitLength') return fmt(t('errCrossMin'), { max: parsed.maxUnitLength })
         return null
       }
 
@@ -326,8 +331,15 @@ window.__ModuleLoader__.load({
           return
         }
         const value = parsed[field.key]
-        dirty.current[field.key] = true
         setErrors((prev) => ({ ...prev, [field.key]: null }))
+        // 值未变化时不写入：避免仅仅聚焦/失焦就把默认值写进用户层，
+        // 污染 settings.yaml 并让「恢复默认」失去意义。
+        if (snapshotValue()[field.key] === value) {
+          dirty.current[field.key] = false
+          setForm({ ...currentForm(), [field.key]: String(value) })
+          return
+        }
+        dirty.current[field.key] = true
         setForm({ ...currentForm(), [field.key]: String(value) })
         runWrite(() => controller.set(field.key, value), () => snapshotValue()[field.key] === value)
       }
@@ -353,11 +365,20 @@ window.__ModuleLoader__.load({
       }
 
       const add = () => {
-        const ch = draft.trim()
-        if (ch.length === 0) return
+        const text = draft.trim()
+        if (text.length === 0) return
         setDraft('')
-        if (shown.ignoredChars.indexOf(ch) !== -1) return
-        commitList([...shown.ignoredChars, ch])
+        // 白名单按单个字符匹配：一次输入多个字符时逐个加入（忽略输入中的空白），
+        // 否则整串会被当成一个条目，永远不会命中。
+        const next = [...shown.ignoredChars]
+        let changed = false
+        for (const ch of text) {
+          if (/\s/.test(ch)) continue
+          if (next.indexOf(ch) !== -1) continue
+          next.push(ch)
+          changed = true
+        }
+        if (changed) commitList(next)
       }
       const remove = (ch) => commitList(shown.ignoredChars.filter((item) => item !== ch))
 

package/lib/index.js

@@ -78,6 +78,8 @@ const CONFIG = {
   // 检测时忽略的字符（白名单）：Markdown 表格的分隔行由连字符与竖线组成
   // （如 "|---|---|"），正常表格输出会大量连续出现，不应视为复读。
   // 默认忽略连字符与竖线；需要更严格的检测时可改为空数组 []。
+  // 条目必须是单个字符（按 Unicode 码点匹配，emoji 也算一个）；
+  // 多字符条目永远不会命中，运行时会丢弃并告警。
   ignoredChars: ['-', '|'],
   // 是否同时检测思考（reasoning）文本。默认开启：思考中的复读同样消耗 token，
   // 应立即截停。注意：正常思考中若连续重复同一字符串 10 次以上（如"等等等等"），
@@ -129,12 +131,11 @@ function stripWhitespace(text) {
   return text.replace(/\s+/g, '')
 }
 
-/** 移除白名单字符（与 CONFIG.ignoredChars 配合）。 */
+/** 移除白名单字符（与 CONFIG.ignoredChars 配合）。按 Unicode 码点逐个比对。 */
 function stripIgnoredChars(text, ignored) {
   if (ignored.length === 0) return text
   let out = ''
-  for (let i = 0; i < text.length; i++) {
-    const ch = text[i]
+  for (const ch of text) {
     if (ignored.indexOf(ch) === -1) out += ch
   }
   return out
@@ -147,6 +148,46 @@ function sanitizeDelta(delta, config) {
   return piece
 }
 
+/**
+ * 未知块类型只会在 DSH 协议新增 ContentBlock 类型时出现：此时没有合法的合成
+ * block-end，只能按 tool-call 兜底并告警一次，便于定位协议漂移。
+ */
+let warnedUnknownBlockType = false
+function warnUnknownBlockType(blockType) {
+  if (warnedUnknownBlockType) return
+  warnedUnknownBlockType = true
+  console.warn(
+    '[dupguard] 遇到未知块类型 ' + JSON.stringify(blockType) +
+    '：截停收尾只能按 tool-call 兜底，请升级插件以匹配新的 DSH 协议。'
+  )
+}
+
+/**
+ * 白名单按「单个字符」（Unicode 码点）匹配：多字符或空条目永远不会命中，
+ * 属于无效配置。此处丢弃并告警，避免设置页显示了一个永远不生效的条目。
+ */
+function normalizeIgnoredChars(raw, fallback) {
+  if (!Array.isArray(raw)) return [...fallback]
+  const kept = []
+  const dropped = []
+  for (const entry of raw) {
+    if (typeof entry !== 'string') {
+      dropped.push(String(entry))
+      continue
+    }
+    // [...entry] 按码点拆分：emoji 等代理对字符算一个字符。
+    if ([...entry].length === 1) kept.push(entry)
+    else dropped.push(entry)
+  }
+  if (dropped.length > 0) {
+    console.warn(
+      '[dupguard] 白名单条目必须是单个字符，已忽略无效条目：' + JSON.stringify(dropped) +
+      '（白名单按字符匹配，多字符条目不会生效）。'
+    )
+  }
+  return kept
+}
+
 /**
  * 为一次 llm/stream 调用创建守卫。
  * 每次模型调用都会新建一份状态，互不干扰。
@@ -241,6 +282,7 @@ function createStreamGuard(options, runtime) {
     } else if (b.blockType === 'reasoning') {
       block = { type: 'reasoning', text: b.text }
     } else {
+      if (b.blockType !== 'tool-call') warnUnknownBlockType(b.blockType)
       block = {
         type: 'tool-call',
         id: b.toolCallId !== undefined ? b.toolCallId : 'call-' + index,
@@ -386,9 +428,7 @@ function applySettingsToRuntime(runtime, value) {
     return fallback[key]
   }
   const pickBool = (key) => (typeof source[key] === 'boolean' ? source[key] : fallback[key])
-  runtime.ignoredChars = Array.isArray(source.ignoredChars)
-    ? source.ignoredChars.filter((ch) => typeof ch === 'string')
-    : [...fallback.ignoredChars]
+  runtime.ignoredChars = normalizeIgnoredChars(source.ignoredChars, fallback.ignoredChars)
   runtime.threshold = pickInt('threshold')
   runtime.minUnitLength = pickInt('minUnitLength')
   runtime.maxUnitLength = pickInt('maxUnitLength')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-dupguard",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Real-time repetition guard for DeepSeek Harness (DSH): stops model generation when the same string repeats >=10 times in the streamed output. 实时检测 DSH 大模型流式输出中的重复内容，同一字符串重复十次以上立即停止生成。",
   "keywords": [
     "dsh-plugin",