@restregular/dsh-memory 0.14.3 → 0.14.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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,18 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.14.5 — 修复记忆面板审计「在轨迹中定位」不生效
6
+
7
+ - **根因**:主面板把 `jumpAuditEntryToTrajectory`(签名是 `(entry) => Promise`)当成 `openTrajectory(focus)` 回调传给 `AuditTab`。按钮把 `callId` 字符串传进去,`jumpAuditEntryToTrajectory` 读不到 `entry.sessionId`,直接按 `no_session` 返回,实际什么都没发生;UI 还误报“已定位到轨迹”。
8
+ - **修复**:主面板不再传 `openTrajectory`,`AuditTab` 走模块内的 `jumpAuditEntryToTrajectory(selected)`:先 `openSession`,等 per-session store 可用后 `openView('trajectory', callId)`,Trajectory 会选中该记录并自动打开右侧详情面板。会话内「记忆」视图仍走 `openView` 回调,回调现在返回 `{opened, focused}`,提示文案按真实结果展示。
9
+ - 回归测试:主面板路径断言 `openSession('s1')` + `openView('trajectory','call-9')`。
10
+
11
+ ## 0.14.4 — 轨迹行图标同时按 composer 上沿裁剪
12
+
13
+ - **根因**:0.14.3 只用 `_tablePane` 的底边做下界。Trajectory 的表格会一直延伸到浮动 composer 后面,`_tablePane` 的底边在 composer 下方;行滚到底部、被 composer 遮住时,fixed 图标仍在表格底边以内,所以继续显示。
14
+ - **修复**:可见区域下界取 `min(tablePane.bottom, composerSeat.top)`(composer 隐藏/高度为 0 时退回 tablePane 底边);行不完全落在上下界内就不渲染标记。选中行徽标同样裁剪。
15
+ - 回归测试:表头上方的 call-3、composer 后面的 call-4 即使有审计也不标记;完全可见的 call-1 正常标记。
16
+
5
17
  ## 0.14.3 — 轨迹行图标按滚动容器裁剪
6
18
 
7
19
  - **根因**:行左侧的年轮图标是 `shell.overlay` 里的 `position:fixed` 元素,不受轨迹表格 `overflow` 裁剪。行滚到表头/工具栏上方后,它的 `getBoundingClientRect()` 仍可能落在浏览器视口内,图标就留在原地,看起来“超出范围还显示”。
package/README.md CHANGED
@@ -375,9 +375,9 @@ GET /memory/api/anchor?session=<id>&turn=<n>&step=<n>&callId=<optional>
375
375
 
376
376
  DSH 自带的 Trajectory 面板是一个**纯投影**:它只声明 `conversation.trajectory.images` 一个子槽,没有行/列扩展点,选中状态也只存在组件内部。因此插件不能直接往轨迹表格里插审计行。当前采用的是一条不碰轨迹 React 树的组合:
377
377
 
378
- - **轨迹 → 记忆审计**:Trajectory 的选中行带有 `data-trajectory-row-key`。注意它在 DOM 上经过 `encodeURIComponent`(工具行实际是 `tool%00call%00<callId>`),插件会先解码再取 callId。有审计的调用行左侧会显示产品年轮线条图标;选中行右侧另有「记忆 N」徽标,点击按 `op:<callId>` 打开审计。两者都会按轨迹滚动容器(扣除 sticky 表头)裁剪,行滚出可视区后不会残留。
378
+ - **轨迹 → 记忆审计**:Trajectory 的选中行带有 `data-trajectory-row-key`。注意它在 DOM 上经过 `encodeURIComponent`(工具行实际是 `tool%00call%00<callId>`),插件会先解码再取 callId。有审计的调用行左侧会显示产品年轮线条图标;选中行右侧另有「记忆 N」徽标,点击按 `op:<callId>` 打开审计。两者都会按轨迹滚动容器(扣除 sticky 表头与底部浮动 composer)裁剪,行滚出可视区后被遮住时不会残留。
379
379
  - **轨迹详情页签**:点击轨迹里的任意记录后,右侧详情面板的页签行会多出一个「记忆审计」页签(用 `shell.overlay` 贴着详情面板,不改轨迹的 React 树)。它展示该记录 callId 对应的审计事件,底部按钮直接打开本会话的记忆审计面板;没有 callId 的记录明确提示无法精确过滤。
380
- - **记忆审计 → 轨迹**:审计详情里的「在轨迹中定位」把条目上的 `operationId`(记忆工具调用、触发召回的工具调用)交给 Trajectory 的 `openView('trajectory', callId)`。没有 `operationId` 的按轮/步事件先请求 `/anchor`,由 Host 从会话事件窗口里找该 turn/step 的第一个 `tool/call`;找不到就只切到轨迹页,不伪造定位。
380
+ - **记忆审计 → 轨迹**:审计详情里的「在轨迹中定位」把条目上的 `operationId`(记忆工具调用、触发召回的工具调用)交给 Trajectory 的 `openView('trajectory', callId)`;主面板会先打开会话,再切换轨迹并选中该记录,右侧详情面板自动打开。没有 `operationId` 的按轮/步事件先请求 `/anchor`,由 Host 从会话事件窗口里找该 turn/step 的第一个 `tool/call`;找不到就只切到轨迹页,不伪造定位。
381
381
  - **会话内的「记忆」视图**:与 Chat / 轨迹同一个 view ring,按当前会话展示审计;它直接使用宿主传给每个 view 的 `openView`,因此跳转是官方支持路径。它声明 `data-conversation-composer-overlay` 让壳层压住外层滚动,审计列表在自己的滚动容器里滚动,外层界面不需要跟着滚。主面板不在 view ring 内,通过 `conversation.session` 注册的 per-session store 调同一个 action;拿不到时退化为打开会话/轨迹页。
382
382
  - 记忆工具调用(`memory_save/search/list/get/forget`)本身会额外留一条 `stage: tool_call` 的审计锚点:即使自动召回关闭,也能从这条记录精确跳回轨迹里的那次调用。
383
383
 
package/lib/client.js CHANGED
@@ -2185,9 +2185,10 @@ window.__ModuleLoader__.load({
2185
2185
  }
2186
2186
 
2187
2187
  /**
2188
- * 轨迹行可见区域:表格滚动容器(`_tablePane`)的上下边界,再扣掉 sticky 表头。
2188
+ * 轨迹行可见区域:表格滚动容器(`_tablePane`)的上下边界,扣掉 sticky 表头,
2189
+ * 底部再扣掉浮动的 composer。
2189
2190
  * fixed 定位的浮层不会被表格的 overflow 裁剪,所以必须自己做这个裁剪;
2190
- * 否则行滚到表头/工具栏上方后,图标还会留在原地。
2191
+ * 否则行滚到表头/工具栏上方或 composer 后面时,图标还会留在原地。
2191
2192
  */
2192
2193
  function trajectoryRowClip(row) {
2193
2194
  try {
@@ -2199,9 +2200,25 @@ window.__ModuleLoader__.load({
2199
2200
  const table = row.closest('table')
2200
2201
  const head = table && typeof table.querySelector === 'function' ? table.querySelector('thead') : null
2201
2202
  const headRect = head ? head.getBoundingClientRect() : null
2203
+ let bottom = paneRect.bottom
2204
+ // Trajectory 把 composer 浮在 ledger 底部;表格会一直延伸到它后面。
2205
+ // composer 可见时,浮层不应盖在输入框上。
2206
+ const root = typeof row.closest === 'function' ? row.closest('[class*="_scrollBody"]') : null
2207
+ let composer = null
2208
+ try {
2209
+ composer = root && typeof root.querySelector === 'function'
2210
+ ? root.querySelector('[class*="_composerSeat"]')
2211
+ : (typeof document !== 'undefined' ? document.querySelector('[class*="_composerSeat"]') : null)
2212
+ } catch { composer = null }
2213
+ if (composer !== null) {
2214
+ const composerRect = composer.getBoundingClientRect()
2215
+ if (composerRect.height > 0 && composerRect.top > paneRect.top) {
2216
+ bottom = Math.min(bottom, composerRect.top)
2217
+ }
2218
+ }
2202
2219
  return {
2203
2220
  top: Math.max(paneRect.top, headRect ? headRect.bottom : paneRect.top),
2204
- bottom: paneRect.bottom,
2221
+ bottom,
2205
2222
  }
2206
2223
  } catch {
2207
2224
  return null
@@ -2897,8 +2914,11 @@ window.__ModuleLoader__.load({
2897
2914
  try {
2898
2915
  const focus = await resolveAuditFocus(selected)
2899
2916
  if (typeof openTrajectory === 'function') {
2900
- openTrajectory(focus)
2901
- setFocusNotice(focus === undefined ? '已切到轨迹页(这条没有精确锚点)' : '已定位到轨迹')
2917
+ const result = await openTrajectory(focus, selected)
2918
+ if (result && result.focused === true) setFocusNotice('已定位到轨迹')
2919
+ else if (result && result.opened === true) setFocusNotice('已切到轨迹页(未找到精确锚点)')
2920
+ else if (result === undefined) setFocusNotice(focus === undefined ? '已切到轨迹页(这条没有精确锚点)' : '已定位到轨迹')
2921
+ else setFocusNotice('定位失败')
2902
2922
  return
2903
2923
  }
2904
2924
  const result = await jumpAuditEntryToTrajectory(selected)
@@ -3120,7 +3140,7 @@ window.__ModuleLoader__.load({
3120
3140
  /** 待嵌入自动刷新:最多 300 次 × 1.5s(后端挂着时不无限轮询)。 */
3121
3141
  const PENDING_POLL_LIMIT = 300
3122
3142
 
3123
- function MemoryPanel({ openSession, sessionInfo, openTrajectory, audience = 'panel', lockSession } = {}) {
3143
+ function MemoryPanel({ openSession, sessionInfo, audience = 'panel', lockSession } = {}) {
3124
3144
  const [records, setRecords] = React.useState([])
3125
3145
  const [scopes, setScopes] = React.useState([])
3126
3146
  const [embedServer, setEmbedServer] = React.useState(null)
@@ -3608,7 +3628,6 @@ window.__ModuleLoader__.load({
3608
3628
  sessionInfo,
3609
3629
  audience,
3610
3630
  lockSession,
3611
- openTrajectory,
3612
3631
  })
3613
3632
  : overviewBody,
3614
3633
  )
@@ -3624,8 +3643,12 @@ window.__ModuleLoader__.load({
3624
3643
  function MemoryAuditView({ sessionId, openView, sessionInfo }) {
3625
3644
  const openTrajectory = (focus) => {
3626
3645
  try {
3627
- if (typeof openView === 'function') openView('trajectory', focus)
3646
+ if (typeof openView === 'function') {
3647
+ openView('trajectory', focus)
3648
+ return { opened: true, focused: focus !== undefined }
3649
+ }
3628
3650
  } catch { /* 视图不可用时保持在本页 */ }
3651
+ return { opened: false, focused: false }
3629
3652
  }
3630
3653
  return h('div', {
3631
3654
  className: 'memp mem-view',
@@ -4131,10 +4154,10 @@ window.__ModuleLoader__.load({
4131
4154
  const inject = ['slots']
4132
4155
 
4133
4156
  /** 侧栏入口打开的主界面页面(整块可滚动,内容就是面板本体)。 */
4134
- function MemoryPage({ openSession, sessionInfo, openTrajectory } = {}) {
4157
+ function MemoryPage({ openSession, sessionInfo } = {}) {
4135
4158
  return h('div', { className: 'mem-page' },
4136
4159
  h('div', { className: 'mem-page-head' }, h('h2', null, '记忆系统')),
4137
- h(MemoryPanel, { openSession, sessionInfo, openTrajectory, audience: 'panel' }),
4160
+ h(MemoryPanel, { openSession, sessionInfo, audience: 'panel' }),
4138
4161
  )
4139
4162
  }
4140
4163
 
@@ -4215,7 +4238,6 @@ window.__ModuleLoader__.load({
4215
4238
  openSession,
4216
4239
  sessionInfo,
4217
4240
  audience: 'panel',
4218
- openTrajectory: jumpAuditEntryToTrajectory,
4219
4241
  }),
4220
4242
  ))
4221
4243
 
@@ -4238,7 +4260,6 @@ window.__ModuleLoader__.load({
4238
4260
  slots.inject('main', () => slots.register({ name: 'main', key: 'memory' }, () => React.createElement(MemoryPage, {
4239
4261
  openSession,
4240
4262
  sessionInfo,
4241
- openTrajectory: jumpAuditEntryToTrajectory,
4242
4263
  }))),
4243
4264
  slots.inject('sidebar.panellist', () => slots.register(
4244
4265
  { name: 'sidebar.panellist', id: 'memory', order: 20, label: () => NAV_LABEL },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@restregular/dsh-memory",
3
- "version": "0.14.3",
3
+ "version": "0.14.5",
4
4
  "description": "DeepSeek Harness 记忆系统(单包单入口):JSONL 存储 + 本地向量检索(BGE-M3)+ 五个模型工具 + 自动召回注入 + 管理面板。",
5
5
  "icon": "./icon.svg",
6
6
  "type": "module",