@restregular/dsh-memory 0.5.3 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +3 -1
  2. package/lib/client.js +50 -34
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -280,7 +280,9 @@ tools/build-single-package.mjs 构建(产物契约检查 + 可选加载验证)
280
280
 
281
281
  ## 版本
282
282
 
283
- - **0.5.3** —— 设置页侧栏「记忆」那一行的图标。宿主 `dsh-client-ui-settings-general` 把导航图标写死在 `navIcon(id)` 里:只有 `account` / `models` / `agent-presets` / `plugins` / `archived-sessions` 五个 id 有专属图标,其余(含 `memory`)一律回退成**齿轮**;`settings.section` 的注册契约里没有 icon 字段,宿主也不读包的 `icon`(那个只用于插件管理器)。所以插件侧按宿主的类名约定做了一次**定向覆盖**:隐藏那一行的齿轮、在同一位置补上芯片记号(与 `icon.svg` 同一套色)。标记只打在"文案等于「记忆」"的那个按钮上,其它区块不受影响;宿主类名约定一旦改变,规则匹配不到就自动退回齿轮。纯 CSS,不插 DOM、不碰 React 树。
283
+ - **0.5.5** —— 侧栏图标改成**与那一列同风格**的线稿芯片。0.5.4 虽然修好了"空一格",但画的是"蓝色瓦片 + 深墨蓝芯片"的实心方块,那是**插件管理器卡片/行**(36/30px,`icon.svg`)那套插件美术;而设置侧栏这一列全是 16px 单色细线图标(宿主内置 `Icon*OutlineMedium`:16 网格、`fill:none`、`stroke:currentColor`、线宽 1.3),实心蓝块混在里面格格不入。现在只用宿主渲染的那颗 svg 的**子节点**画线稿芯片(圆角方 + 内方 + 四引脚,1.3 描边、跟随主题),尺寸/对齐/行高仍由宿主保证。三条被验证过走不通的路都写进了代码注释:`::before` 补一个(盒子不成形 → 空一格)、给 svg 上背景(画不出描边线稿)、`content: url(...)` 替换 svg 内容(SVG 不支持 content 替换)。
284
+ - **0.5.4** —— 修 0.5.3 的图标空洞。0.5.3 是"把齿轮 `display:none` 藏掉、再用 `::before` 在同一格补一个记号",真机上出现**齿轮没了、记号也没画出来**,只剩一个空位。改成**就地覆盖**那颗 svg(不再隐藏、不再插节点)。同时删掉 0.1.0 遗留的空壳目录 `packages/dsh-memory-panel`(0.4.0 起已被单包取代),免得它继续干扰"哪个子包才是可安装的"这类判断。
285
+ - **0.5.3** —— 设置页侧栏「记忆」那一行的图标。宿主 `dsh-client-ui-settings-general` 把导航图标写死在 `navIcon(id)` 里:只有 `account` / `models` / `agent-presets` / `plugins` / `archived-sessions` 五个 id 有专属图标,其余(含 `memory`)一律回退成**齿轮**;`settings.section` 的注册契约里没有 icon 字段,宿主也不读包的 `icon`(那个只用于插件管理器)。所以插件侧按宿主的类名约定做了一次**定向覆盖**。标记只打在"文案等于「记忆」"的那个按钮上,其它区块不受影响;宿主类名约定一旦改变,规则匹配不到就自动退回齿轮。
284
286
  - **0.5.2** —— 新图标:插件图标换成"芯片"记号(内存条的直白隐喻)。仍是宿主内置插件美术那套规范(36×36 画布、蓝色渐变圆角瓦片 `#69B9FF → #324DE2`、外层统一缩到 26/28),但记号改用**深墨蓝 `#0E1C58` 的圆角方 + 中心点**,而不是白色细描边 —— 这个图标同时出现在**浅色主题**下(插件管理器的卡片/行、设置导航),瓦片顶部是亮蓝,白描边在 36px 就糊成"蓝方块+白点";深墨蓝在整块渐变上都够暗,缩到 16px 仍可辨。同时去掉 SVG 里的固定 `width/height`,显示尺寸交给宿主(行 30 / 卡片 36)。
285
287
  - **0.5.1** —— 清理空作用域文件:作用域被删空后(删掉最后一条、或 `POST /data/wipe`),它的 `.jsonl` 与 `.vec` 会在下一次落盘时一起移除,不再留 0 字节文件与只剩身份头的边车;下次写同一个名字会重新创建。`global.jsonl` 是唯一例外(保留作用域只清内容、留文件)。同版本的旧文件行为不变,无数据迁移。
286
288
  - **0.5.0** —— 作用域重构:
package/lib/client.js CHANGED
@@ -833,9 +833,9 @@ window.__ModuleLoader__.load({
833
833
  function apply(ctx) {
834
834
  try {
835
835
  const styleEl = document.createElement('style')
836
- // 面板样式 + 侧栏导航图标覆盖(见 NAV_ICON_CSS 的注释)
837
- styleEl.textContent = `${CSS}\n${NAV_ICON_CSS}`
836
+ styleEl.textContent = CSS
838
837
  document.head.appendChild(styleEl)
838
+ // 侧栏那一行的图标:宿主写死了齿轮,我们只改它 SVG 的孩子(见 wrapSettingsNav)
839
839
  const stopNavWatch = wrapSettingsNav()
840
840
  ctx.effect(() => () => { styleEl.remove(); stopNavWatch() }, 'dsh-memory: styles + nav icon')
841
841
 
@@ -867,9 +867,8 @@ window.__ModuleLoader__.load({
867
867
  * `package.json` 的 `icon`(那个只用于插件管理器的卡片/行),所以插件侧没有任何
868
868
  * "官方指定图标"的入口。
869
869
  *
870
- * 因此只有一条路:用宿主自己的类名做一次**定向覆盖** —— 隐藏那颗齿轮,在同一格里贴上
871
- * 我们的记号(与 icon.svg 同一套美术:蓝色渐变圆角瓦片 + 深墨蓝芯片)。
872
- * 三条护栏让它不会把界面弄坏:
870
+ * 因此只有一条路:用宿主自己的类名做一次**定向覆盖** —— 把那颗齿轮**就地**换成我们的
871
+ * 记号(内存芯片)。三条护栏让它不会把界面弄坏:
873
872
  * 1. 选择器只认 className 的**后缀**:宿主的类名是 CSS Modules 生成的
874
873
  * `<hash>_navCell` / `<hash>_navIcon`(hash 随构建变),所以用
875
874
  * `[class*="_navIcon"]` 匹配,hash 变了也照样命中;
@@ -877,48 +876,65 @@ window.__ModuleLoader__.load({
877
876
  * `dsh-memory-nav` 标记类,规则全部限定在它下面 —— 其它区块(账号/模型/插件市场)
878
877
  * 的图标一个都不碰。标记打在**按钮自己**身上而不是它所在的列表上:整列共用一个
879
878
  * 列表容器,标在容器上会波及所有区块。
880
- * 3. 纯 CSS 画图,不插 DOM、不碰 React 树;万一宿主的类名约定整个变了,规则匹配不到,
881
- * 图标就**自动退回原来那颗齿轮**,不会变成空白格。
882
- * 尺寸沿用宿主写死的 16(它给图标的 size 就是 16),行高与 .navIcon{flex:none} 一致。
879
+ * 3. **不改布局、不插 DOM**:那颗 svg 还是宿主自己渲染的,我们只把它内部换成芯片,
880
+ * 盒子尺寸/行高/对齐全由宿主保证。
881
+ *
882
+ * 风格必须跟着**侧栏这一列**走:这一列全是 16px 单色细线图标(宿主内置的
883
+ * Icon*OutlineMedium:16 网格、fill:none、stroke:currentColor、strokeWidth 1.3),
884
+ * 所以记号画成线稿芯片;**不是**插件管理器卡片/行那套"蓝色瓦片 + 白色记号"的插件美术
885
+ * (那个尺寸是 36/30px,另一套 surface —— icon.svg 仍服务那边)。0.5.3/0.5.4 早期版本
886
+ * 把蓝瓦片塞进这一列,结果就是一个实心蓝块混在细线图标里,格格不入。
887
+ *
888
+ * 实现:把宿主那颗 svg 的**子节点**换成芯片的线稿。三条被否掉的路,留给后来人:
889
+ * - `::before` 补一个(0.5.3):真机上盒子没成形 —— 齿轮没了、记号也没出现,空一格;
890
+ * - 给 svg 上背景图(0.5.4):能画出来,但只能画色块,画不出"1.3 描边的线稿",与这列不搭;
891
+ * - `content: url(...)` 替换 svg 内容:SVG 元素不支持 content 替换,实测无效。
892
+ * 换子节点这条路的失败模式是良性的:svg 由宿主渲染,我们只动它的孩子,尺寸/对齐/行高
893
+ * 一定由宿主保证;万一类名约定变了,选中不到就没有任何改动,图标保持原样。
894
+ * React 若重渲染把图形覆盖回去,observer 会在下一轮按子节点重新补上。
883
895
  */
884
- const NAV_ICON_CSS = [
885
- // 只隐藏"我们自己那一行"的图标:标记类直接打在那一行的按钮上(见 wrapSettingsNav)
886
- '.dsh-memory-nav [class*="_navIcon"] { display: none !important; }',
887
- // 同一格里补上我们的记号(纯 CSS 画,不插 DOM)
888
- '.dsh-memory-nav [class*="_navCell"]::before {',
889
- ' content: "";',
890
- ' flex: none;',
891
- ' display: block;',
892
- ' width: 16px;',
893
- ' height: 16px;',
894
- // 瓦片:圆角 26%(≈8/28,与 icon.svg 的 rx 一致)+ 同一组蓝色渐变
895
- ' border-radius: 26%;',
896
- ' background:',
897
- // 芯片:深墨蓝边框(上下两条横带 + 左右两条竖带)+ 中心点
898
- ' radial-gradient(circle at 50% 50%, #0E1C58 0 9%, rgba(0,0,0,0) 9.5%),',
899
- ' linear-gradient(180deg, rgba(0,0,0,0) 0 30%, #0E1C58 30% 70%, rgba(0,0,0,0) 70%),',
900
- ' linear-gradient(90deg, rgba(0,0,0,0) 0 14%, #0E1C58 14% 86%, rgba(0,0,0,0) 86%),',
901
- ' linear-gradient(180deg, #69B9FF 0%, #324DE2 100%);',
902
- '}',
903
- ].join('\n')
896
+ const NAV_ICON_NS = 'http://www.w3.org/2000/svg'
897
+ /** 芯片线稿:16 网格、1.3 描边、跟随 currentColor(与宿主内置图标同一规范)。 */
898
+ const CHIP_SHAPES = [
899
+ { tag: 'rect', attrs: { x: '5', y: '5', width: '6', height: '6', rx: '1.4', fill: 'none', stroke: 'currentColor', 'stroke-width': '1.3' } },
900
+ { tag: 'rect', attrs: { x: '6.9', y: '6.9', width: '2.2', height: '2.2', rx: '0.6', fill: 'none', stroke: 'currentColor', 'stroke-width': '1.3' } },
901
+ { tag: 'path', attrs: { d: 'M8 5V3.2M8 11v1.8M5 8H3.2M11 8h1.8', fill: 'none', stroke: 'currentColor', 'stroke-width': '1.3', 'stroke-linecap': 'round' } },
902
+ ]
903
+
904
+ /** 把一颗 nav 图标的图形换成芯片;已经是芯片就跳过(observer 会反复调到这里)。 */
905
+ function paintChip(svg) {
906
+ const shapes = svg.querySelectorAll('rect,path,circle,line,polyline,polygon')
907
+ const first = shapes[0]
908
+ const isChip = shapes.length === CHIP_SHAPES.length
909
+ && first?.tagName?.toLowerCase() === 'rect'
910
+ && first.getAttribute('rx') === '1.4'
911
+ if (isChip) return
912
+ svg.replaceChildren(...CHIP_SHAPES.map(({ tag, attrs }) => {
913
+ const node = document.createElementNS(NAV_ICON_NS, tag)
914
+ for (const [k, v] of Object.entries(attrs)) node.setAttribute(k, v)
915
+ return node
916
+ }))
917
+ }
904
918
 
905
919
  /**
906
- * 在"含「记忆」那一行"的按钮上打标记类,让上面的 CSS 只作用于这一行。
920
+ * 在"含「记忆」那一行"上做记号并换图。
907
921
  *
908
- * 关键:标记打在**按钮自己**身上,绝不打在父级 navList 上 —— 整列是同一个容器,
922
+ * 关键:记号打在**按钮自己**身上,绝不打在父级 navList 上 —— 整列是同一个容器,
909
923
  * 打到父级等于给所有区块都加图标。面板随时可能卸载/重挂(它是 body 上的 portal),
910
924
  * 所以用 MutationObserver 跟着 DOM 走;识别依据是**这一行的文案**(trim 后比对),
911
- * 不依赖任何类名 —— 类名约定变了只是标记不上、图标退回宿主原来的齿轮。
925
+ * 不依赖任何类名 —— 类名约定变了只是什么都不做,图标保持宿主原样。
912
926
  */
913
927
  function wrapSettingsNav() {
914
928
  const mark = () => {
915
929
  try {
916
930
  for (const cell of document.querySelectorAll('[class*="_navCell"]')) {
917
931
  const label = (cell.textContent ?? '').trim()
918
- if (label === NAV_LABEL) cell.classList?.add('dsh-memory-nav')
919
- else cell.classList?.remove('dsh-memory-nav')
932
+ if (label !== NAV_LABEL) continue
933
+ cell.classList?.add('dsh-memory-nav')
934
+ const icon = cell.querySelector('[class*="_navIcon"]')
935
+ if (icon) paintChip(icon)
920
936
  }
921
- } catch { /* 标记失败:图标保持宿主原样 */ }
937
+ } catch { /* 换图失败:图标保持宿主原样 */ }
922
938
  }
923
939
  mark()
924
940
  const observer = new MutationObserver(mark)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@restregular/dsh-memory",
3
- "version": "0.5.3",
3
+ "version": "0.5.5",
4
4
  "description": "DeepSeek Harness 本地长期记忆(单包单入口):JSONL 存储 + 本地向量检索(BGE-M3)+ 四个模型工具 + 自动召回注入 + 管理面板。",
5
5
  "icon": "./icon.svg",
6
6
  "type": "module",