@mzzsfy/dsh-settings-nav-icons 0.3.0 → 0.4.1

package/README.md

@@ -38,7 +38,7 @@ DeepSeek Harness 纯前端插件:设置弹窗左侧导航与 dsh-market 插件
 
 - **外部声明**:其他插件运行时注册自己的 label/插件名 → 图标,优先级最高(见下节)。
 - **内置映射**:官方分区与无法改源的第三方分区。
-- **关键词**:插件名/分区名整词命中语义关键词得主题图(git→分支、im→机器人、search→放大镜、usage→图表等 19 组规则);整词边界匹配,`im` 不误伤 `important`。
+- **关键词**:插件名/分区名整词命中语义关键词得主题图(git→分支、im→机器人、search→放大镜、usage→图表、wallet→钱包、dash→表盘等 21 组规则);整词边界匹配,`im` 不误伤 `important`。
 - **备用池**:星芒/层叠/标签/网格四个中性图形,按名称稳定哈希取一个——同一名称永远同一图形,重渲染不闪动。dsh-market 目录内全部插件(含下载量前 1000)至此都有图标。
 
 ## 图标声明机制(其他插件接入)
@@ -54,12 +54,12 @@ window.__navicIcons.register({ '消息通知': 'bell' })
 ```
 
 - 键:分区显示文本(设置导航)或插件名(dsh-market 卡片)。两域共用一张表,同名时以先命中者生效,键请取不易与官方分区撞名的插件名。官方双语分区按等价组解析:任一语言 label 作键,两种语言下均命中(消除语言切换的声明键漂移)。
-- 值:内置 glyph 名(`tune/theme/bot/market/cube/mcp/shield/cards/plan/bell/wrench/archive/spark/layers/tag/grid/git/search/term/chart/code/doc/db/flow/globe/lock/image/zap`)或完整 16×16 `<svg>` 字符串。svg 字符串过安全门:完整开标签(大小写不敏感,拒绝 `<svgx` 残串)且单根闭合(首个 `</svg>` 后不得再有内容,堵尾缀活动 HTML);不带 `on*` 事件属性(`\b` 前界堵斜杠分隔绕过)、不带 `<script>`/`<style>`(内联样式全文档生效且 @import 可外联)/`<foreignObject>`/SMIL 动画(`<animate>`/`<set>` 等)载体;不带 `href`/`xlink:href` 及 `attributeName="href"` 注入(16×16 静态图标无合法引用/动画场景,外联请求一并封死);不带 `javascript:`(纵深);长度 ≤4096 字符;glyph 名查表经 `typeof` 收口,原型链成员不可能被注入。
+- 值:内置 glyph 名(`tune/theme/bot/market/cube/mcp/shield/cards/plan/bell/wrench/archive/spark/layers/tag/grid/git/search/term/chart/code/doc/db/flow/globe/lock/image/zap/wallet/gauge`)或完整 16×16 `<svg>` 字符串。svg 字符串过安全门:完整开标签(大小写不敏感,拒绝 `<svgx` 残串)且单根闭合(首个 `</svg>` 后不得再有内容,堵尾缀活动 HTML);不带 `on*` 事件属性(`\b` 前界堵斜杠分隔绕过)、不带 `<script>`/`<style>`(内联样式全文档生效且 @import 可外联)/`<foreignObject>`/SMIL 动画(`<animate>`/`<set>` 等)载体;不带 `href`/`xlink:href` 及 `attributeName="href"` 注入(16×16 静态图标无合法引用/动画场景,外联请求一并封死);不带 `javascript:`(纵深);长度 ≤4096 字符;glyph 名查表经 `typeof` 收口,原型链成员不可能被注入。
 - 声明值经归一化后写入注册表;同值重复注册幂等短路;非法值(未知 glyph/被安全门拒绝/非字符串)撤销该键声明,该分区回到内置映射或关键词/哈希默认管线,已改写的 nav svg 内容就地重写。
 - 声明持久化在 `window.__navicIconDeclarations`:本插件 client 半区热重载会重跑工厂而生产者不重发注册,持久层让重装实例恢复声明,页面刷新随 window 释放。
 - 污染面收敛在 `window.__navicIcons` 单一命名空间,插件卸载时移除 API、取消已排定的重绘、队列恢复数组形态——卸载后生产者按上方「方式二」入队等待下一实例,不再驱动 DOM 改写;重载页面后全部还原为官方图标。
 
-本仓库自有插件的分区图标即全部走此机制:usage-panel(账号余额 → plan)、turn-notify(消息通知 → bell)、maintain(版本与运维 → wrench)、session-manager(会话归档 → archive);四包的注册样板由本包测试做契约锁定。
+本仓库全部插件包(含本包自画像与仅 host 半区的包)都走此机制显式声明,不依赖关键词/哈希推导;键为「分区 label + 市场短名」双形态:usage-panel(账号余额、dsh-usage-panel → wallet)、usage-dash(使用统计/Usage、dsh-usage-dash → gauge)、turn-notify(消息通知、dsh-turn-notify → bell)、maintain(版本与运维、dsh-maintain → wrench)、session-manager(会话归档、dsh-session-manager → archive)、rs-workflow(若水工作流、dsh-rs-workflow → flow)、cron-board(dsh-cron-board → plan)、think-expand(dsh-think-expand → spark)、model-capability-editor(dsh-model-capability-editor → cube)、auto-trust-all(dsh-auto-trust-all → shield)、llm-pi-gateway(dsh-llm-pi-gateway → globe)、settings-nav-icons(dsh-settings-nav-icons → tune);仅 host 半区的 auto-trust-all 与 llm-pi-gateway 为声明专设最小 client 半区。注册样板由本包测试做契约锁定。
 
 ## 内置映射表
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-settings-nav-icons",
   "description": "设置弹窗导航分区与插件市场卡片图标替换:按分区显示文本把回退齿轮换成专属图形,市场卡片头像槽换成插件图标,DOM 观察实现,卸载后重载页面恢复官方图标",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "type": "module",
   "main": "src/index.js",
   "exports": {

package/src/client.js

@@ -3,11 +3,21 @@
 // 背景见 README「实现边界」:settings.* 子槽声明权被原版条目占用,
 // 接管 Shell 不可行,DOM 观察是唯一不依赖官方契约变更的路径。
 
+// 本插件市场短名自画像:经同一套声明机制注册(先于 load,渲染端同文件就绪)
+if (typeof window !== 'undefined') {
+  const NAV_ICON = { 'dsh-settings-nav-icons': 'tune' }
+  if (window.__navicIcons !== undefined) window.__navicIcons.register(NAV_ICON)
+  else if (Array.isArray(window.__navicIconQueue)) window.__navicIconQueue.push(NAV_ICON)
+  else window.__navicIconQueue = [NAV_ICON]
+}
+
 window.__ModuleLoader__.load({
   id: '@mzzsfy/dsh-settings-nav-icons',
   factory(require) {
     // ---- 官方 DOM 字面量标识(设置弹窗导航,CSS Modules 哈希前缀稳定) ----
 
+    // 注册 id 单点定义:样式 data-plugin 标记与装载归属同源,防字面量双写漂移
+    const PLUGIN_ID = '@mzzsfy/dsh-settings-nav-icons'
     const SELECTOR_CELL = 'button.VOzbGW_navCell'
     const SELECTOR_LABEL = '.VOzbGW_navLabel'
     const ATTR_MARK = 'data-navic'
@@ -260,6 +270,8 @@ window.__ModuleLoader__.load({
 
     function installOverlayStyle() {
       overlayStyle = document.createElement('style')
+      // 自带 data-plugin:缺失时宿主 claimStyles 会把它归属给后续材质化插件,其 HMR 重建即误删
+      overlayStyle.setAttribute('data-plugin', PLUGIN_ID)
       overlayStyle.textContent = OVERLAY_CSS
       document.head.appendChild(overlayStyle)
       if (slot !== null) slot.overlayStyle = overlayStyle
@@ -387,6 +399,13 @@ window.__ModuleLoader__.load({
       rectOf('2.5', '3', '11', '10', '1.2') +
       circleOf('5.9', '6.1', '1') + pathOf('m3.6 12 3-3 2.3 2.3 1.7-1.7 1.9 1.9'))
     const ZAP = svgOf(pathOf('M8.9 1.8 3.8 8.9h3.5L7 14.2l5.2-7.1H8.6z'))
+    const WALLET = svgOf(
+      rectOf('2.5', '3.5', '11', '9.5', '1.5') +
+      pathOf('M13.5 7.4h-2.1a1.6 1.6 0 0 0 0 3.2h2.1'))
+    const GAUGE = svgOf(
+      pathOf('M2.5 12a5.5 5.5 0 1 1 11 0') +
+      pathOf('M8 12 10.8 9.2') +
+      pathOf('M2.5 12h11'))
     const FALLBACK = [SPARK, LAYERS, TAG, GRID]
 
     // 内置 glyph 名称表:声明值可用名称引用内置图形,避免跨插件复制 svg。
@@ -396,6 +415,7 @@ window.__ModuleLoader__.load({
       archive: ARCHIVE, spark: SPARK, layers: LAYERS, tag: TAG, grid: GRID,
       git: GIT, search: SEARCH, term: TERM, chart: CHART, code: CODE, doc: DOC,
       db: DB, flow: FLOW, globe: GLOBE, lock: LOCK, image: IMAGE, zap: ZAP,
+      wallet: WALLET, gauge: GAUGE,
     }
 
     // 声明值解析与安全门:svg 须完整开标签(大小写不敏感)且单根闭合(首个 </svg>
@@ -437,7 +457,9 @@ window.__ModuleLoader__.load({
       ['doc|note|file|markdown|wiki', DOC],
       ['database|sqlite|redis|cache|db', DB],
       ['session|archive|history', ARCHIVE],
+      ['dash|dashboard|gauge', GAUGE],
       ['usage|stat|meter|monitor|radar|metric', CHART],
+      ['wallet|balance|money|coin|fund', WALLET],
       ['flow|workflow|pipeline|task|job|queue', FLOW],
       ['auth|login|pass|secret|token|lock|guard|crypt', SHIELD],
       ['mcp', MCP],
@@ -807,6 +829,8 @@ window.__ModuleLoader__.load({
 
     function installScrollStyle() {
       scrollStyle = document.createElement('style')
+      // 自带 data-plugin:缺失时宿主 claimStyles 会把它归属给后续材质化插件,其 HMR 重建即误删
+      scrollStyle.setAttribute('data-plugin', PLUGIN_ID)
       scrollStyle.textContent = NAVLIST_SCROLL_CSS
       document.head.appendChild(scrollStyle)
       if (slot !== null) slot.scrollStyle = scrollStyle

package/src/logic.mjs

@@ -109,6 +109,13 @@ export const IMAGE = svgOf(
   rectOf('2.5', '3', '11', '10', '1.2') +
   circleOf('5.9', '6.1', '1') + pathOf('m3.6 12 3-3 2.3 2.3 1.7-1.7 1.9 1.9'))
 export const ZAP = svgOf(pathOf('M8.9 1.8 3.8 8.9h3.5L7 14.2l5.2-7.1H8.6z'))
+export const WALLET = svgOf(
+  rectOf('2.5', '3.5', '11', '9.5', '1.5') +
+  pathOf('M13.5 7.4h-2.1a1.6 1.6 0 0 0 0 3.2h2.1'))
+export const GAUGE = svgOf(
+  pathOf('M2.5 12a5.5 5.5 0 1 1 11 0') +
+  pathOf('M8 12 10.8 9.2') +
+  pathOf('M2.5 12h11'))
 
 export const FALLBACK = [SPARK, LAYERS, TAG, GRID]
 
@@ -119,6 +126,7 @@ export const GLYPHS = {
   archive: ARCHIVE, spark: SPARK, layers: LAYERS, tag: TAG, grid: GRID,
   git: GIT, search: SEARCH, term: TERM, chart: CHART, code: CODE, doc: DOC,
   db: DB, flow: FLOW, globe: GLOBE, lock: LOCK, image: IMAGE, zap: ZAP,
+  wallet: WALLET, gauge: GAUGE,
 }
 
 // 声明值解析与安全门:svg 须完整开标签(大小写不敏感)且单根闭合(首个 </svg>
@@ -183,7 +191,9 @@ export const NAME_RULES = [
   ['doc|note|file|markdown|wiki', DOC],
   ['database|sqlite|redis|cache|db', DB],
   ['session|archive|history', ARCHIVE],
+  ['dash|dashboard|gauge', GAUGE],
   ['usage|stat|meter|monitor|radar|metric', CHART],
+  ['wallet|balance|money|coin|fund', WALLET],
   ['flow|workflow|pipeline|task|job|queue', FLOW],
   ['auth|login|pass|secret|token|lock|guard|crypt', SHIELD],
   ['mcp', MCP],

package/test/orchestration.test.mjs

@@ -143,6 +143,8 @@ function fakeDocument() {
         value: '',
         placeholder: '',
         innerHTML: '',
+        attrs: {},
+        setAttribute(name, value) { el.attrs[name] = value },
         appendChild(child) { el.children.push(child) },
         focus() { el.focused = true },
         addEventListener(type, fn) { el.handlers[type] = fn },
@@ -250,6 +252,7 @@ test('启动样式:覆盖浮层样式与滚动样式注入 head,卸载移除,重
     assert.equal(doc.createdStyles.length, 2, '恰两次注入(浮层+滚动)')
     assert.ok(doc.createdStyles.some((el) => el.textContent.includes('sni-ov')), '浮层样式随启动注入')
     assert.ok(doc.createdStyles.some((el) => el.textContent === NAVLIST_SCROLL_CSS), '滚动规则与实现同源')
+    assert.ok(doc.createdStyles.every((el) => el.attrs['data-plugin'] === '@mzzsfy/dsh-settings-nav-icons'), '样式自带 data-plugin,防宿主 claimStyles 误归属后随他插件 HMR 整批误删')
     assert.equal(doc.head.children.length, 2, '样式挂载在 head')
     assert.deepEqual(doc.events, ['style', 'style', 'observe'], '样式注入先于观察器挂载')
     unload()
@@ -300,11 +303,12 @@ test('启动样式代际:HMR 不卸载重评估由新实例代拆,旧形槽跨
 test('registerIcons 输入校验:数组与空值拒收', () => {
   const { win, doc, raf } = loadClient()
   const unload = boot(win.__loaded, doc)
+  raf.flush() // 排空启动期自声明的重贴,后续断言只看本次入参的增量
   try {
     win.__navicIcons.register(['bell'])
     win.__navicIcons.register(null)
     win.__navicIcons.register('bell')
-    assert.deepEqual(Object.keys(win.__navicIconDeclarations ?? {}), [], '非法入参不写入注册表')
+    assert.deepEqual(Object.keys(win.__navicIconDeclarations ?? {}), ['dsh-settings-nav-icons'], '非法入参不写入注册表(仅启动期自声明在场)')
     assert.equal(raf.size(), 0, '非法入参不触发重贴')
     assert.equal(doc.marked.length, 0)
   } finally {
@@ -402,6 +406,7 @@ test('队列时序:畸形条目不中断排空,同键后者覆盖,排空先于
 test('卸载:__navicIcons 删除,rAF 取消,异常不外抛', () => {
   const { win, doc, raf } = loadClient()
   const unload = boot(win.__loaded, doc)
+  raf.flush() // 排空启动期自声明的重贴,断言只看本次注册的增量
   win.__navicIcons.register({ bell: 'bell' })
   assert.equal(raf.size(), 1, '重贴已排定')
   unload()
@@ -536,6 +541,7 @@ test('头像槽换名:重贴清行内旧注入(父容器范围),外来兄弟不
 test('rAF 合批:同一帧内多次 register 只排一帧,flush 后重新排定', () => {
   const { win, doc, raf } = loadClient()
   const unload = boot(win.__loaded, doc)
+  raf.flush() // 排空启动期自声明的重贴,断言只看本次注册的增量
   try {
     win.__navicIcons.register({ a: 'bell' })
     win.__navicIcons.register({ b: 'wrench' })
@@ -567,6 +573,7 @@ test('replacePass 逐项异常隔离:单项失败不中断其余', () => {
 test('onMutations 过滤:元素级变更唤醒,文本节点与域外文本不唤醒', () => {
   const { win, doc, raf, observers } = loadClient()
   const unload = boot(win.__loaded, doc)
+  raf.flush() // 排空启动期自声明的重贴,断言只看本次变更的增量
   try {
     const observer = observers[observers.length - 1]
     const inCellText = { parentElement: { closest(sel) { return sel.includes('navCell') ? {} : null } } }
@@ -740,10 +747,12 @@ test('用户覆盖:非 nav 单元格右键不弹浮层', () => {
   }
 })
 
-// 声明侧契约:四个生产者包的注册样板(先探测入口、数组态入队),改契约须同步五处。
+// 声明侧契约:全部生产者包的注册样板(先探测入口、数组态入队),改契约须同步全部生产者。
 // 包脱离 monorepo 布局(发布态)时跳过:无兄弟包源码可读。
-test('生产者样板契约:四包注册走 __navicIcons/__navicIconQueue', () => {
-  const producers = ['dsh-session-manager', 'dsh-usage-panel', 'dsh-turn-notify', 'dsh-maintain']
+test('生产者样板契约:全包注册走 __navicIcons/__navicIconQueue', () => {
+  const producers = ['dsh-session-manager', 'dsh-usage-panel', 'dsh-turn-notify', 'dsh-maintain', 'dsh-rs-workflow',
+    'dsh-usage-dash', 'dsh-cron-board', 'dsh-think-expand', 'dsh-model-capability-editor', 'dsh-settings-nav-icons',
+    'dsh-auto-trust-all', 'dsh-llm-pi-gateway']
   let checked = 0
   for (const pkg of producers) {
     const clientPath = join(PKG_ROOT, '..', pkg, 'src', 'client.js')

package/test/parity.test.mjs

@@ -274,7 +274,7 @@ function defineScenarios(prefix, L) {
   })
 
   test(prefix + '关键词规则整词边界与跨规则优先级', () => {
-    const { themedIcon, FALLBACK } = L
+    const { themedIcon, FALLBACK, GLYPHS } = L
     assert.equal(themedIcon('important'), FALLBACK[poolIndexOf('important')], 'im 不命中 important')
     assert.equal(themedIcon('dbtool'), FALLBACK[poolIndexOf('dbtool')], 'db 不命中 dbtool')
     assert.equal(themedIcon('my db tool'), themedIcon('db'), '独立词 db 命中')
@@ -283,6 +283,13 @@ function defineScenarios(prefix, L) {
     // 顺序即优先级,具体语义在前:双规则同打名取靠前者
     assert.equal(themedIcon('search-bot'), themedIcon('search'), 'search 先于 bot')
     assert.equal(themedIcon('git-notify'), themedIcon('git'), 'git 先于 notify')
+    // 余额语义:wallet 系关键词命中钱包图,plan 系关键词仍命中时钟
+    assert.equal(themedIcon('account-balance'), GLYPHS.wallet, 'balance 命中钱包')
+    assert.equal(themedIcon('my-wallet-tool'), GLYPHS.wallet, 'wallet 命中钱包')
+    assert.equal(themedIcon('cron-board'), GLYPHS.plan, 'cron 仍命中时钟')
+    // 仪表盘语义:dash 系关键词命中表盘图
+    assert.equal(themedIcon('usage-dash'), GLYPHS.gauge, 'dash 命中表盘')
+    assert.equal(themedIcon('my-dashboard'), GLYPHS.gauge, 'dashboard 命中表盘')
   })
 
   test(prefix + '别名等价:双语分区任一语言键命中,组外键不受影响', () => {
@@ -419,8 +426,8 @@ test('两份实现 NAME_RULES 全量同源(含标志位)', () => {
 
 test('README 契约数量锁定', () => {
   // README 声明的内置表规模,扩表须同步改 README
-  assert.equal(Object.keys(logic.GLYPHS).length, 28)
-  assert.equal(logic.NAME_RULES.length, 19)
+  assert.equal(Object.keys(logic.GLYPHS).length, 30)
+  assert.equal(logic.NAME_RULES.length, 21)
 })
 
 test('LOGIC 段与 logic.mjs 决策函数逐函数源码一致(归一化注释与空白)', () => {