@leiyi-works/dsh-session-tmpdir 0.9.2 → 0.9.3

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 (4) hide show
  1. package/README.md +6 -0
  2. package/client.js +164 -22
  3. package/index.js +47 -0
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -207,3 +207,9 @@ v0.9.0 变更(2026-11-16):**中间产物/长期产物划分(方案 3)+
207
207
  v0.9.1 变更(2026-11-16):左侧菜单「临时目录」图标从彩色 emoji 换成**单色线框文件夹 SVG**(`currentColor` 描边、24 viewBox、无填充),与「云端同步」「隐私模式」等菜单的图标风格一致;尺寸跟随 `sidebar.panellist` 传入的 `size`(默认 18)。功能无变化。
208
208
 
209
209
  v0.9.2 变更(2026-11-16):图标再改为**沙漏**(单色线框),因为文件夹线框和「AI视频」「会话相关」等收纳夹图标撞形;沙漏表达“临时/到期清理”的语义,18px 下两笔可辨,与左栏现有图标形状都不重复。功能无变化。
210
+
211
+ v0.9.3 变更(2026-11-16):面板体验与条目回收。
212
+
213
+ 1. **左侧菜单改为打开右侧边栏标签页**(与「常驻钥则」一致):点击「临时目录」行时先回到会话、再打开原生右侧标签页;右侧栏不可用时自动回退全页面板。
214
+ 2. **5 秒自动刷新**:仅面板页面可见时轮询 `GET /state`(静默刷新、不闪 loading);页面隐藏时暂停,切回来立即刷新一次;保留「刷新」按钮。
215
+ 3. **目标不存在的条目自动回收**:`GET /state` 时检查每条路径,文件/目录已删除 → 条目自动删除并落盘。保护:刚批准但还没写入的条目(从未见过存在且批准不到 30 分钟)不会被误删;一旦见过目标存在,之后消失即删。面板同时显示「目标不存在」状态(回收前的短暂窗口)。
package/client.js CHANGED
@@ -1,10 +1,13 @@
1
1
  /**
2
- * dsh-session-tmpdir — Client half(v0.9).
2
+ * dsh-session-tmpdir — Client half(v0.9.3).
3
3
  *
4
- * 左侧菜单「临时目录」+ 全页面板:展示长期落点白名单(文件级/目录级),
5
- * 支持「移除」一条(让下一次写入重新走审批),不提供手动添加(添加只走对话审批)。
4
+ * 左侧菜单「临时目录」入口:点击时切到**右侧边栏标签页**(和「常驻钥则」一致);
5
+ * 侧边栏不可用时回退到全页面板。
6
6
  *
7
- * 数据来自宿主只读/可写接口:
7
+ * 面板内容:长期落点白名单(文件级/目录级),5 秒自动刷新(仅页面可见时),
8
+ * 支持「移除」一条;目标已不存在的条目由宿主侧自动回收。
9
+ *
10
+ * 宿主接口:
8
11
  * GET /__dsh-session-tmpdir/state 白名单清单 + 配置
9
12
  * POST /__dsh-session-tmpdir/revoke { id } 移除一条
10
13
  */
@@ -14,23 +17,25 @@ window.__ModuleLoader__.load({
14
17
  const React = require('react')
15
18
  const h = React.createElement
16
19
  const PANEL_ID = 'session-tmpdir'
20
+ const TAB_ID = 'session-tmpdir-tab'
17
21
  const API = '/__dsh-session-tmpdir'
22
+ const REFRESH_MS = 5000
18
23
 
19
24
  const styles = {
20
25
  root: {
21
26
  height: '100%',
22
27
  overflow: 'auto',
23
28
  boxSizing: 'border-box',
24
- padding: 'calc(var(--dsh-frame-top-clearance, 0px) + 16px) 14px 28px',
29
+ padding: '10px 12px 20px',
25
30
  color: 'var(--dsw-alias-label-primary)',
26
31
  fontSize: 13,
27
32
  lineHeight: 1.55,
28
33
  },
29
- inner: { maxWidth: 900, margin: '0 auto', display: 'flex', flexDirection: 'column', gap: 10 },
30
- title: { margin: 0, fontSize: 17, fontWeight: 600 },
34
+ inner: { display: 'flex', flexDirection: 'column', gap: 10 },
35
+ title: { margin: 0, fontSize: 15, fontWeight: 600 },
31
36
  hint: { margin: 0, color: 'var(--dsw-alias-label-secondary)', fontSize: 12 },
32
37
  meta: { fontSize: 11, color: 'var(--dsw-alias-label-secondary)' },
33
- bar: { display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap', marginTop: 2 },
38
+ bar: { display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' },
34
39
  btn: {
35
40
  appearance: 'none',
36
41
  cursor: 'pointer',
@@ -54,18 +59,18 @@ window.__ModuleLoader__.load({
54
59
  color: 'var(--dsw-alias-state-error-primary, #d14a4a)',
55
60
  whiteSpace: 'nowrap',
56
61
  },
57
- table: { display: 'flex', flexDirection: 'column', gap: 6, marginTop: 4 },
62
+ table: { display: 'flex', flexDirection: 'column', gap: 6 },
58
63
  row: {
59
64
  display: 'flex',
60
65
  alignItems: 'center',
61
- gap: 10,
66
+ gap: 8,
62
67
  border: '1px solid var(--dsw-alias-border-l1, rgba(127,127,127,.22))',
63
68
  borderRadius: 8,
64
69
  padding: '8px 10px',
65
70
  },
66
71
  rowMain: { flex: 1, minWidth: 0, display: 'flex', flexDirection: 'column', gap: 3 },
67
72
  path: { fontFamily: 'ui-monospace, Consolas, monospace', fontSize: 12, wordBreak: 'break-all' },
68
- rowMeta: { display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' },
73
+ rowMeta: { display: 'flex', alignItems: 'center', gap: 6, flexWrap: 'wrap' },
69
74
  tag: {
70
75
  fontSize: 10,
71
76
  lineHeight: '16px',
@@ -73,6 +78,16 @@ window.__ModuleLoader__.load({
73
78
  borderRadius: 6,
74
79
  background: 'var(--dsw-alias-bg-layer-2, rgba(127,127,127,.08))',
75
80
  color: 'var(--dsw-alias-label-secondary)',
81
+ whiteSpace: 'nowrap',
82
+ },
83
+ tagWarn: {
84
+ fontSize: 10,
85
+ lineHeight: '16px',
86
+ padding: '0 6px',
87
+ borderRadius: 6,
88
+ background: 'rgba(210,120,0,.14)',
89
+ color: 'var(--dsw-alias-state-warning-primary, #c27c00)',
90
+ whiteSpace: 'nowrap',
76
91
  },
77
92
  empty: { fontSize: 12, color: 'var(--dsw-alias-label-secondary)', margin: '8px 0 0' },
78
93
  err: { fontSize: 12, color: 'var(--dsw-alias-state-error-primary, #d14a4a)', margin: 0 },
@@ -97,21 +112,37 @@ window.__ModuleLoader__.load({
97
112
  function WhitelistPanel() {
98
113
  const [state, setState] = React.useState({ loading: true, error: '', data: null })
99
114
  const [busy, setBusy] = React.useState('')
115
+ const aliveRef = React.useRef(true)
100
116
 
101
- const load = React.useCallback(async () => {
102
- setState((prev) => ({ ...prev, loading: true, error: '' }))
117
+ React.useEffect(() => () => { aliveRef.current = false }, [])
118
+
119
+ const load = React.useCallback(async (quiet = false) => {
120
+ if (!quiet) setState((prev) => ({ ...prev, loading: true, error: '' }))
103
121
  try {
104
122
  const res = await fetch(`${API}/state`, { cache: 'no-store' })
105
123
  const data = await res.json()
106
124
  if (!data || data.ok !== true) throw new Error(data?.error || '读取失败')
107
- setState({ loading: false, error: '', data })
125
+ if (aliveRef.current) setState({ loading: false, error: '', data })
108
126
  } catch (error) {
109
- setState({ loading: false, error: String(error?.message ?? error), data: null })
127
+ if (aliveRef.current) setState((prev) => ({ ...prev, loading: false, error: String(error?.message ?? error) }))
110
128
  }
111
129
  }, [])
112
130
 
131
+ // 首次加载 + 页面可见时每 5 秒静默刷新
113
132
  React.useEffect(() => {
114
- void load()
133
+ void load(false)
134
+ const timer = setInterval(() => {
135
+ if (typeof document !== 'undefined' && document.visibilityState === 'hidden') return
136
+ void load(true)
137
+ }, REFRESH_MS)
138
+ const onVisible = () => {
139
+ if (typeof document === 'undefined' || document.visibilityState !== 'hidden') void load(true)
140
+ }
141
+ if (typeof document !== 'undefined') document.addEventListener('visibilitychange', onVisible)
142
+ return () => {
143
+ clearInterval(timer)
144
+ if (typeof document !== 'undefined') document.removeEventListener('visibilitychange', onVisible)
145
+ }
115
146
  }, [load])
116
147
 
117
148
  const remove = async (id) => {
@@ -124,7 +155,7 @@ window.__ModuleLoader__.load({
124
155
  })
125
156
  const data = await res.json()
126
157
  if (!data || data.ok !== true) throw new Error(data?.error || '移除失败')
127
- await load()
158
+ await load(true)
128
159
  } catch (error) {
129
160
  setState((prev) => ({ ...prev, error: String(error?.message ?? error) }))
130
161
  } finally {
@@ -145,13 +176,13 @@ window.__ModuleLoader__.load({
145
176
  h(
146
177
  'p',
147
178
  { style: styles.hint },
148
- '长期落点白名单:在临时目录外**新建**产物要先经过你同意,同意后才会出现在这里;**改写已存在文件**按规则直接放行,不弹窗。',
179
+ '长期落点白名单:在临时目录外**新建**产物要先经过你同意,同意后才会出现在这里;**改写已存在文件**按规则直接放行,不弹窗。目标被删除后条目会自动消失。',
149
180
  ),
150
181
  data
151
182
  ? h(
152
183
  'p',
153
184
  { style: styles.meta },
154
- `存储:${data.approvalsFile || ''} · 改写放行:${data.allowOverwrite ? '是' : '否'} · 临时根目录:${data.rootDirName || '_tmp'}/`,
185
+ `改写放行:${data.allowOverwrite ? '是' : '否'} · 临时根:${data.rootDirName || '_tmp'}/ · ${data.approvalsFile || ''}`,
155
186
  )
156
187
  : null,
157
188
  h(
@@ -159,7 +190,7 @@ window.__ModuleLoader__.load({
159
190
  { style: styles.bar },
160
191
  h(
161
192
  'button',
162
- { style: styles.btn, onClick: () => void load(), disabled: state.loading || Boolean(busy) },
193
+ { style: styles.btn, onClick: () => void load(false), disabled: state.loading || Boolean(busy) },
163
194
  state.loading ? '读取中…' : '刷新',
164
195
  ),
165
196
  ),
@@ -181,6 +212,7 @@ window.__ModuleLoader__.load({
181
212
  'div',
182
213
  { style: styles.rowMeta },
183
214
  h('span', { style: styles.tag }, row.kind === 'dir' ? '目录' : '文件'),
215
+ row.exists === false ? h('span', { style: styles.tagWarn }, '目标不存在') : null,
184
216
  h('span', { style: styles.meta }, `同意于 ${fmtTime(row.approvedAt) || '未知时间'}`),
185
217
  row.sessionId
186
218
  ? h(
@@ -228,12 +260,83 @@ window.__ModuleLoader__.load({
228
260
 
229
261
  return {
230
262
  name: '@leiyi-works/dsh-session-tmpdir',
231
- inject: ['slots'],
263
+ inject: ['slots', 'layout'],
232
264
  apply(ctx) {
265
+ let nativeOpen = null
266
+ let redirecting = false
267
+
268
+ const openTab = () => {
269
+ if (nativeOpen === null) return false
270
+ try {
271
+ nativeOpen()
272
+ return true
273
+ } catch (error) {
274
+ console.warn('[dsh-session-tmpdir] native right-sidebar openTab failed:', error)
275
+ return false
276
+ }
277
+ }
278
+
279
+ // 右侧边栏标签页(与「常驻钥则」同款原生通道)
280
+ const mountTab = (inner) => {
281
+ let registry
282
+ let slots
283
+ let sidebarRight
284
+ try {
285
+ registry = inner.sidebarRightTabs ?? inner.get?.('sidebarRightTabs')
286
+ slots = inner.slots
287
+ sidebarRight = inner.sidebarRight ?? inner.get?.('sidebarRight')
288
+ } catch {
289
+ return undefined
290
+ }
291
+ if (registry === undefined || typeof registry.register !== 'function' || slots === undefined) return undefined
292
+ const disposers = []
293
+ try {
294
+ const disposeType = registry.register({
295
+ id: TAB_ID,
296
+ kind: TAB_ID,
297
+ title: () => '临时目录',
298
+ })
299
+ if (typeof disposeType === 'function') disposers.push(disposeType)
300
+ const disposeBody = slots.inject('sidebar.right.pane.tab', () =>
301
+ slots.register({ name: 'sidebar.right.pane.tab', key: TAB_ID }, (props) => h(WhitelistPanel, props)),
302
+ )
303
+ if (typeof disposeBody === 'function') disposers.push(disposeBody)
304
+ if (sidebarRight !== undefined && typeof sidebarRight.openTab === 'function') {
305
+ nativeOpen = () => sidebarRight.openTab(TAB_ID)
306
+ }
307
+ } catch (error) {
308
+ for (const dispose of disposers.reverse()) {
309
+ try {
310
+ dispose()
311
+ } catch {
312
+ /* ignore */
313
+ }
314
+ }
315
+ return undefined
316
+ }
317
+ return () => {
318
+ for (const dispose of disposers.reverse()) {
319
+ try {
320
+ dispose()
321
+ } catch {
322
+ /* ignore */
323
+ }
324
+ }
325
+ }
326
+ }
327
+ try {
328
+ ctx.inject(['sidebarRightTabs', 'sidebarRight', 'slots'], mountTab)
329
+ } catch {
330
+ mountTab(ctx)
331
+ }
332
+
333
+ // 兜底:右侧边栏不可用时仍可用全页面板。
233
334
  ctx.effect(
234
335
  () => ctx.slots.inject('main', () => ctx.slots.register({ name: 'main', key: PANEL_ID }, WhitelistPanel)),
235
- 'session-task-tmpdir: whitelist page',
336
+ 'session-task-tmpdir: whitelist page (fallback)',
236
337
  )
338
+
339
+ // 左侧菜单入口。
237
340
  ctx.effect(
238
341
  () =>
239
342
  ctx.slots.inject('sidebar.panellist', () =>
@@ -241,6 +344,45 @@ window.__ModuleLoader__.load({
241
344
  ),
242
345
  'session-task-tmpdir: sidebar entry',
243
346
  )
347
+
348
+ // 点左侧行时保持会话:先回到会话,再打开右侧标签页;打不开才退回全页面板。
349
+ ctx.effect(() => {
350
+ const layout = ctx.layout
351
+ if (!layout || !layout.panelInfo) return undefined
352
+ const openAfterReturn = () => {
353
+ const opened = openTab()
354
+ if (!opened) {
355
+ try {
356
+ layout.selectPanel(PANEL_ID)
357
+ } catch (error) {
358
+ console.warn('[dsh-session-tmpdir] full-page fallback failed:', error)
359
+ }
360
+ }
361
+ redirecting = false
362
+ }
363
+ const check = () => {
364
+ if (redirecting) return
365
+ let active
366
+ try {
367
+ active = layout.panelInfo.getSnapshot().activePanelId
368
+ } catch {
369
+ return
370
+ }
371
+ if (active !== PANEL_ID) return
372
+ redirecting = true
373
+ try {
374
+ layout.selectPanel(null)
375
+ } catch (error) {
376
+ redirecting = false
377
+ console.warn('[dsh-session-tmpdir] returning to the conversation failed:', error)
378
+ return
379
+ }
380
+ if (typeof queueMicrotask === 'function') queueMicrotask(openAfterReturn)
381
+ else setTimeout(openAfterReturn, 0)
382
+ }
383
+ check()
384
+ return layout.panelInfo.subscribe(check)
385
+ }, 'session-tmpdir: row opens the native right-sidebar tab')
244
386
  },
245
387
  }
246
388
  },
package/index.js CHANGED
@@ -1546,9 +1546,54 @@ export function apply(ctx, config) {
1546
1546
  reason: entry.reason ?? '',
1547
1547
  basis: entry.basis ?? '',
1548
1548
  approvedAt: entry.approvedAt ?? 0,
1549
+ exists: (() => {
1550
+ try {
1551
+ return existsSync(entry.path)
1552
+ } catch {
1553
+ return false
1554
+ }
1555
+ })(),
1549
1556
  }))
1550
1557
  }
1551
1558
 
1559
+ /**
1560
+ * v0.9.3:目标已不存在的白名单条目自动回收。
1561
+ * 保护:刚批准、还没写入的条目(从未见过存在,且批准不到 30 分钟)不删,避免误删;
1562
+ * 一旦见过目标存在(lastSeenAt>0),之后目标消失 → 下次刷新即删。
1563
+ */
1564
+ function pruneMissingApprovals() {
1565
+ const now = Date.now()
1566
+ const keep = []
1567
+ let changed = false
1568
+ for (const entry of approvalState.entries) {
1569
+ let exists = false
1570
+ try {
1571
+ exists = existsSync(entry.path)
1572
+ } catch {
1573
+ exists = false
1574
+ }
1575
+ if (exists) {
1576
+ if (!entry.lastSeenAt || now - entry.lastSeenAt > 60_000) {
1577
+ entry.lastSeenAt = now
1578
+ changed = true
1579
+ }
1580
+ keep.push(entry)
1581
+ continue
1582
+ }
1583
+ const approvedAt = Number(entry.approvedAt) || 0
1584
+ const seen = Number(entry.lastSeenAt) || 0
1585
+ if (seen > 0 || (approvedAt > 0 && now - approvedAt > 30 * 60_000)) {
1586
+ changed = true
1587
+ continue
1588
+ }
1589
+ keep.push(entry)
1590
+ }
1591
+ if (changed) {
1592
+ approvalState.entries = keep
1593
+ saveApprovalsNow()
1594
+ }
1595
+ }
1596
+
1552
1597
  function registerApproval(session, targetPath, { reason, basis, kind = 'file' } = {}) {
1553
1598
  const id = sessionKey(session)
1554
1599
  if (!id) throw new Error('longterm_approve: session is unavailable')
@@ -2148,6 +2193,8 @@ export function apply(ctx, config) {
2148
2193
  }
2149
2194
  })()
2150
2195
  if (pathname.endsWith('/state') && req.method === 'GET') {
2196
+ // v0.9.3:目标已不存在的条目自动回收(新建→批准→写入的窗口期受保护)
2197
+ pruneMissingApprovals()
2151
2198
  const approvals = approvalEntriesForPanel().map((entry) => ({
2152
2199
  ...entry,
2153
2200
  current: Boolean(sessionId && entry.sessionId === sessionId),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@leiyi-works/dsh-session-tmpdir",
3
- "version": "0.9.2",
3
+ "version": "0.9.3",
4
4
  "type": "module",
5
5
  "description": "Per-session task temp folder with a long-term write guard. v0.9 (方案3): creating a new file outside _tmp requires the user's approval (per file by default, per directory with mode=dir), overwriting an existing file is allowed without asking, every write channel is guarded (write/edit, shell including ffmpeg/pandoc/Export-*/IO APIs, publish copies, code runtimes, unknown tools), and the persisted whitelist is shown in a left-sidebar panel「临时目录」 where entries can be removed. Every session also gets _tmp/<session title>/ in its working directory, cleaned 7 days after the session is deleted; the same tick reclaims the attachment store.",
6
6
  "exports": {