@psyduck25/dsh-session-manager 0.0.0-stage → 0.4.1

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/lib/state.js ADDED
@@ -0,0 +1,148 @@
1
+ /**
2
+ * 插件的持久状态:`$DSH_HOME/session-manager/state.json`。
3
+ *
4
+ * 结构(只存插件自己的数据):
5
+ * {
6
+ * version: 1,
7
+ * settings: { bufferHours },
8
+ * locks: [sessionId], // 锁定后禁止删除
9
+ * buffer: [entry], // 删除缓冲站
10
+ * updatedAt
11
+ * }
12
+ *
13
+ * entry = {
14
+ * sessionId, title, workspaceId, workspaceTitle,
15
+ * deletedAt, // 进入缓冲站的时间
16
+ * expiresAt, // 到期后彻底删除
17
+ * pending, note, noteDetail // 到期但删不掉时(会话还在跑)的原因代码与细节
18
+ * }
19
+ *
20
+ * 为什么不写进 `cordis.patch.yml`:这些是用户点界面产生的运行数据,不是插件配置;
21
+ * 写进配置层会让每次点按钮都变成一次配置编辑。读取时任何损坏都退回默认值,
22
+ * 绝不让插件因为一个坏文件起不来。
23
+ */
24
+
25
+ import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
26
+ import os from 'node:os'
27
+ import path from 'node:path'
28
+
29
+ /**
30
+ * 没写过状态文件时使用的值。
31
+ *
32
+ * 标注成 `number` 而不是让它自己推断:`Object.freeze({ bufferHours: 24 })`
33
+ * 会被推断成字面量 `24`,之后 `settings.bufferHours = 任何别的数字` 都会报类型错。
34
+ * 这里只标注 `bufferHours`,其余字段留给推断。
35
+ * @type {Readonly<{ bufferHours: number }>}
36
+ */
37
+ export const DEFAULTS = /** @type {Readonly<{ bufferHours: number }>} */ (Object.freeze({
38
+ bufferHours: 24,
39
+ }))
40
+
41
+ /** 界面可改的范围:0 表示二次确认后立即彻底删除,720 小时 = 30 天。 */
42
+ export const LIMITS = Object.freeze({
43
+ bufferHours: { min: 0, max: 720, step: 1 },
44
+ })
45
+
46
+ export const STATE_VERSION = 1
47
+
48
+ /** `$DSH_HOME`,与 DSH 自身的解析顺序一致:显式覆盖优先,否则 `~/.dsh`。 */
49
+ export function resolveDshHome(env = process.env) {
50
+ const override = typeof env.DSH_HOME === 'string' ? env.DSH_HOME.trim() : ''
51
+ return override === '' ? path.join(os.homedir(), '.dsh') : path.resolve(override)
52
+ }
53
+
54
+ export function stateFile(home) {
55
+ return path.join(home, 'session-manager', 'state.json')
56
+ }
57
+
58
+ function isRecord(value) {
59
+ return typeof value === 'object' && value !== null && !Array.isArray(value)
60
+ }
61
+
62
+ function clamp(value, min, max) {
63
+ return Math.min(max, Math.max(min, value))
64
+ }
65
+
66
+ /**
67
+ * 把任意候选值收成合法设置。
68
+ *
69
+ * 这里不做报错、只做收敛:状态文件是插件自己的运行数据,用户改坏了、被别的程序写坏了,
70
+ * 都应该退回默认值继续用,而不是让设置页打不开。超出范围的数字直接掐到边界。
71
+ */
72
+ export function normalizeSettings(candidate) {
73
+ const input = isRecord(candidate) ? candidate : {}
74
+ /** @type {{ bufferHours: number }} */
75
+ const settings = { ...DEFAULTS }
76
+ const limit = LIMITS.bufferHours
77
+ const raw = input.bufferHours
78
+ if (raw === undefined || raw === null) return settings
79
+ const value = typeof raw === 'number' ? raw : Number(raw)
80
+ if (!Number.isFinite(value)) return settings
81
+ settings.bufferHours = clamp(Math.round(value), limit.min, limit.max)
82
+ return settings
83
+ }
84
+
85
+ function normalizeEntry(entry) {
86
+ if (!isRecord(entry)) return undefined
87
+ if (typeof entry.sessionId !== 'string' || entry.sessionId === '') return undefined
88
+ const deletedAt = Number.isFinite(entry.deletedAt) ? Number(entry.deletedAt) : Date.now()
89
+ // 缺失 expiresAt 时绝对不能回落到 deletedAt:那样条目立刻「已到期」,
90
+ // 下一次巡检就会把一个本该还能回档的会话永久删掉。
91
+ // 退回默认缓冲时长,宁可多留一会儿。
92
+ const expiresAt = Number.isFinite(entry.expiresAt)
93
+ ? Number(entry.expiresAt)
94
+ : deletedAt + DEFAULTS.bufferHours * 3_600_000
95
+ return {
96
+ sessionId: entry.sessionId,
97
+ title: typeof entry.title === 'string' ? entry.title : '',
98
+ workspaceId: typeof entry.workspaceId === 'string' ? entry.workspaceId : '',
99
+ workspaceTitle: typeof entry.workspaceTitle === 'string' ? entry.workspaceTitle : '',
100
+ deletedAt,
101
+ expiresAt,
102
+ // 日志被搬到回收站之前的所在目录,以及搬了哪些文件;meta.json 丢了也能靠它还原。
103
+ originalDir: typeof entry.originalDir === 'string' ? entry.originalDir : '',
104
+ files: Array.isArray(entry.files) ? entry.files.filter((name) => typeof name === 'string') : [],
105
+ pending: entry.pending === true,
106
+ note: typeof entry.note === 'string' ? entry.note : '',
107
+ noteDetail: typeof entry.noteDetail === 'string' ? entry.noteDetail : '',
108
+ }
109
+ }
110
+
111
+ function normalize(candidate) {
112
+ const input = isRecord(candidate) ? candidate : {}
113
+ const settings = normalizeSettings(input.settings)
114
+ const locks = Array.isArray(input.locks)
115
+ ? input.locks.filter((id) => typeof id === 'string' && id !== '')
116
+ : []
117
+ const buffer = Array.isArray(input.buffer)
118
+ ? input.buffer.map(normalizeEntry).filter((entry) => entry !== undefined)
119
+ : []
120
+ return { version: STATE_VERSION, settings, locks, buffer, updatedAt: typeof input.updatedAt === 'string' ? input.updatedAt : '' }
121
+ }
122
+
123
+ export function emptyState() {
124
+ return { version: STATE_VERSION, settings: { ...DEFAULTS }, locks: [], buffer: [], updatedAt: '' }
125
+ }
126
+
127
+ /** 读状态文件;缺失或损坏时返回默认值。 */
128
+ export function readState(home) {
129
+ const file = stateFile(home)
130
+ if (!existsSync(file)) return emptyState()
131
+ try {
132
+ return normalize(JSON.parse(readFileSync(file, 'utf8')))
133
+ } catch {
134
+ return emptyState()
135
+ }
136
+ }
137
+
138
+ /** 原子写入(先写临时文件再替换),避免半个文件把状态弄坏。 */
139
+ export function writeState(home, candidate) {
140
+ const state = normalize(candidate)
141
+ state.updatedAt = new Date().toISOString()
142
+ const file = stateFile(home)
143
+ mkdirSync(path.dirname(file), { recursive: true })
144
+ const temporary = `${file}.tmp`
145
+ writeFileSync(temporary, `${JSON.stringify(state, null, 2)}\n`, 'utf8')
146
+ renameSync(temporary, file)
147
+ return state
148
+ }
package/lib/trash.js ADDED
@@ -0,0 +1,216 @@
1
+ /**
2
+ * 删除缓冲站的磁盘部分。
3
+ *
4
+ * 为什么不是「归档」:归档只是把会话写进工作区注册表的归档集合,左侧列表是否
5
+ * 显示它取决于用户的「显示归档会话」开关。开关一开,会话就变灰留在原地——那
6
+ * 不是用户要的「看不见」。
7
+ *
8
+ * 这里改成真正的回收站:把会话日志文件从会话目录 **移走**,挪进
9
+ * `$DSH_HOME/session-manager/trash/<会话>/`。文件不在会话目录里,DSH 的存储层
10
+ * 列不出它、左侧列表也就没有这一行;回档时再原样移回去,连工作区位置都不用动,
11
+ * 因为工作区登记里那个 id 一直没被删过。
12
+ *
13
+ * 目录布局:
14
+ * trash/<编码后的会话 id>/
15
+ * session.v4.jsonl.zstd 会话日志(原文件名,可能还有 .bak-*)
16
+ * meta.json { sessionId, originalDir, files }
17
+ *
18
+ * 只搬 `session.` 开头的文件;会话目录里别的东西一概不动。
19
+ */
20
+
21
+ import { copyFile, mkdir, readFile, readdir, rename, rm, rmdir, stat, unlink, writeFile } from 'node:fs/promises'
22
+ import path from 'node:path'
23
+
24
+ const META = 'meta.json'
25
+
26
+ export function trashRoot(home) {
27
+ return path.join(home, 'session-manager', 'trash')
28
+ }
29
+
30
+ /**
31
+ * 会话 id 进路径前编码。
32
+ *
33
+ * 转义非 `[0-9._-]` 的字符是为了杜绝 `../` 和分隔符;连字母一起转义,是因为
34
+ * Windows 的文件系统大小写不敏感,`trash/AbC` 和 `trash/abc` 是同一个目录,
35
+ * 两个 id 只差大小写就会共用一个回收站目录、互相覆盖 meta.json。全转义之后
36
+ * 编码只依赖 id 的字节,注入和碰撞都无从下手。
37
+ */
38
+ export function encodeSegment(raw) {
39
+ if (raw === '.' || raw === '..') return raw.replace(/\./g, '~002E')
40
+ let out = ''
41
+ for (let i = 0; i < raw.length; i += 1) {
42
+ const code = raw.charCodeAt(i)
43
+ const ch = String.fromCharCode(code)
44
+ if (/^[0-9._-]$/.test(ch)) out += ch
45
+ else out += `~${code.toString(16).toUpperCase().padStart(4, '0')}`
46
+ }
47
+ return out === '' ? '~002D' : out
48
+ }
49
+
50
+ /** 0.4.0 之前的编码:字母原样保留。只用来找回旧版本留下的目录。 */
51
+ function encodeSegmentLegacy(raw) {
52
+ if (raw === '.' || raw === '..') return raw.replace(/\./g, '~002E')
53
+ let out = ''
54
+ for (let i = 0; i < raw.length; i += 1) {
55
+ const code = raw.charCodeAt(i)
56
+ const ch = String.fromCharCode(code)
57
+ if (ch !== '~' && /^[A-Za-z0-9._-]$/.test(ch)) out += ch
58
+ else out += `~${code.toString(16).toUpperCase().padStart(4, '0')}`
59
+ }
60
+ return out === '' ? '~002D' : out
61
+ }
62
+
63
+ export function trashDir(home, sessionId) {
64
+ return path.join(trashRoot(home), encodeSegment(sessionId))
65
+ }
66
+
67
+ /**
68
+ * 找这个人真正在用的回收站目录。
69
+ *
70
+ * 编码规则变过,旧版本写下的条目还躺在旧名字下面。新名字存在就用新名字;
71
+ * 否则旧名字存在就用旧名字——这样升级之后缓冲站里的老条目照样能回档。
72
+ */
73
+ async function resolveTrashDir(home, sessionId) {
74
+ const current = trashDir(home, sessionId)
75
+ if (await exists(current)) return current
76
+ const legacy = path.join(trashRoot(home), encodeSegmentLegacy(sessionId))
77
+ if (legacy !== current && (await exists(legacy))) return legacy
78
+ return current
79
+ }
80
+
81
+ async function exists(target) {
82
+ try {
83
+ await stat(target)
84
+ return true
85
+ } catch {
86
+ return false
87
+ }
88
+ }
89
+
90
+ /** 跨盘符时 rename 会 EXDEV,退回复制再删。 */
91
+ async function moveFile(from, to) {
92
+ try {
93
+ await rename(from, to)
94
+ } catch (error) {
95
+ if (error && error.code === 'EXDEV') {
96
+ await copyFile(from, to)
97
+ await unlink(from)
98
+ return
99
+ }
100
+ throw error
101
+ }
102
+ }
103
+
104
+ async function moveAll(pairs) {
105
+ const done = []
106
+ for (const [from, to] of pairs) {
107
+ try {
108
+ await moveFile(from, to)
109
+ done.push([from, to])
110
+ } catch (error) {
111
+ // 中途失败就回滚,不留半个状态。
112
+ for (const [source, target] of done.reverse()) {
113
+ try {
114
+ await moveFile(target, source)
115
+ } catch {
116
+ // 回滚失败也没别的办法了,把原始错误抛出去让界面显示
117
+ }
118
+ }
119
+ throw error
120
+ }
121
+ }
122
+ }
123
+
124
+ /**
125
+ * 把一个会话的日志搬进回收站。
126
+ * @param home `$DSH_HOME`
127
+ * @param sessionId 会话 id
128
+ * @param sourceFile 会话日志的绝对路径(来自存储层的 `location.path`)
129
+ */
130
+ export async function moveIntoTrash(home, sessionId, sourceFile) {
131
+ const originalDir = path.dirname(sourceFile)
132
+ let entries
133
+ try {
134
+ entries = await readdir(originalDir, { withFileTypes: true })
135
+ } catch (error) {
136
+ if (error && (error.code === 'ENOENT' || error.code === 'ENOTDIR')) return { moved: false, code: 'missingLog' }
137
+ return { moved: false, code: 'readdirFailed', detail: messageOf(error) }
138
+ }
139
+
140
+ const files = entries.filter((entry) => entry.isFile() && entry.name.startsWith('session.')).map((entry) => entry.name)
141
+ if (files.length === 0) return { moved: false, code: 'missingLog' }
142
+
143
+ const target = trashDir(home, sessionId)
144
+ try {
145
+ await mkdir(target, { recursive: true })
146
+ await moveAll(files.map((name) => [path.join(originalDir, name), path.join(target, name)]))
147
+ await writeFile(
148
+ path.join(target, META),
149
+ `${JSON.stringify({ sessionId, originalDir, files }, null, 2)}\n`,
150
+ 'utf8',
151
+ )
152
+ } catch (error) {
153
+ return { moved: false, code: 'moveFailed', detail: messageOf(error) }
154
+ }
155
+
156
+ // 目录空了就顺手删掉;还留着别的文件就保留。
157
+ try {
158
+ await rmdir(originalDir)
159
+ } catch {
160
+ // ENOTEMPTY / ENOENT 都无所谓
161
+ }
162
+ return { moved: true, originalDir, files }
163
+ }
164
+
165
+ /** 读出回收站目录里的 meta;meta 丢了就用状态文件里记的那份。 */
166
+ async function readMeta(source, entry) {
167
+ try {
168
+ const raw = await readFile(path.join(source, META), 'utf8')
169
+ const parsed = JSON.parse(raw)
170
+ return {
171
+ originalDir: typeof parsed.originalDir === 'string' ? parsed.originalDir : entry.originalDir,
172
+ files: Array.isArray(parsed.files) ? parsed.files.filter((name) => typeof name === 'string') : entry.files,
173
+ }
174
+ } catch {
175
+ return { originalDir: entry.originalDir, files: entry.files }
176
+ }
177
+ }
178
+
179
+ /** 把日志搬回原来的会话目录。 */
180
+ export async function restoreFromTrash(home, entry) {
181
+ const source = await resolveTrashDir(home, entry.sessionId)
182
+ const meta = await readMeta(source, entry)
183
+ const originalDir = typeof meta.originalDir === 'string' ? meta.originalDir : ''
184
+ const files = Array.isArray(meta.files) ? meta.files : []
185
+ if (originalDir === '' || files.length === 0) return { restored: false, code: 'noMeta' }
186
+
187
+ try {
188
+ await mkdir(originalDir, { recursive: true })
189
+ await moveAll(files.map((name) => [path.join(source, name), path.join(originalDir, name)]))
190
+ } catch (error) {
191
+ return { restored: false, code: 'restoreFailed', detail: messageOf(error) }
192
+ }
193
+ try {
194
+ await rm(source, { recursive: true, force: true })
195
+ } catch {
196
+ // 搬都搬回去了,残留目录不影响使用
197
+ }
198
+ return { restored: true }
199
+ }
200
+
201
+ /** 真正删掉:回收站目录整个移除。新旧两种编码都清一次。 */
202
+ export async function purgeTrash(home, sessionId) {
203
+ try {
204
+ const source = await resolveTrashDir(home, sessionId)
205
+ await rm(source, { recursive: true, force: true })
206
+ const legacy = path.join(trashRoot(home), encodeSegmentLegacy(sessionId))
207
+ if (legacy !== source) await rm(legacy, { recursive: true, force: true })
208
+ return { purged: true }
209
+ } catch (error) {
210
+ return { purged: false, code: 'purgeFailed', detail: messageOf(error) }
211
+ }
212
+ }
213
+
214
+ function messageOf(error) {
215
+ return error instanceof Error ? error.message : String(error)
216
+ }
package/locale/en.json ADDED
@@ -0,0 +1,7 @@
1
+ {
2
+ "meta": {
3
+ "title": "Session manager",
4
+ "description": "Lists every session by workspace in Settings > Session manager, with a lock toggle and a delete button on each row. Deleting asks for confirmation first, then moves the session into a recycle bin at the bottom of the page and out of the workspace list for good: the log file is moved into the recycle bin, so the session stays invisible even with archived sessions shown. Restore brings it back exactly as it was during a configurable window (24 hours by default, 0 deletes for good immediately); each row also has Delete now, which asks for confirmation once more. Expired sessions are deleted for real, logs included.",
5
+ "detail": "docs/DETAIL.md"
6
+ }
7
+ }
package/locale/zh.json ADDED
@@ -0,0 +1,7 @@
1
+ {
2
+ "meta": {
3
+ "title": "会话删除管理",
4
+ "description": "在「设置 → 会话删除管理」里按工作区列出所有会话,每行带锁定和删除。删除要先二次确认,确认后会话进入页面底部的删除缓冲站并立即从左侧工作区列表消失(不是变灰,是看不见):日志被移进回收站,所以在打开「显示归档会话」时也不会出现。缓冲期内点「回档」能原样恢复(默认 24 小时,填 0 表示确认后立即彻底删除)。缓冲站里每行还能「彻底删除」,那个按钮也会再问一次。到期后连日志一起真正删除。",
5
+ "detail": "docs/DETAIL.zh.md"
6
+ }
7
+ }
package/package.json CHANGED
@@ -1,6 +1,70 @@
1
1
  {
2
2
  "name": "@psyduck25/dsh-session-manager",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.4.1",
4
+ "type": "module",
5
+ "description": "Delete a single session with a two-step confirmation and a recycle bin: browse every session by workspace, lock the ones to keep, and recover deleted sessions until the configurable buffer window expires.",
6
+ "keywords": [
7
+ "dsh",
8
+ "dsh-plugin",
9
+ "deepseek-harness",
10
+ "session",
11
+ "recycle-bin",
12
+ "settings"
13
+ ],
14
+ "license": "MIT",
15
+ "author": "psyduck25",
16
+ "homepage": "https://github.com/psyduck25/dsh-session-manager#readme",
17
+ "repository": {
18
+ "type": "git",
19
+ "url": "git+https://github.com/psyduck25/dsh-session-manager.git"
20
+ },
21
+ "bugs": {
22
+ "url": "https://github.com/psyduck25/dsh-session-manager/issues"
23
+ },
24
+ "publishConfig": {
25
+ "access": "public",
26
+ "registry": "https://registry.npmjs.org/"
27
+ },
28
+ "main": "lib/index.js",
29
+ "icon": "./icon.svg",
30
+ "exports": {
31
+ ".": "./lib/index.js",
32
+ "./client": "./lib/client.js",
33
+ "./locale/*.json": "./locale/*.json",
34
+ "./package.json": "./package.json"
35
+ },
36
+ "files": [
37
+ "lib",
38
+ "locale",
39
+ "docs",
40
+ "assets",
41
+ "screenshots.json",
42
+ "cordis.patch.yml",
43
+ "icon.svg",
44
+ "README.md",
45
+ "LICENSE"
46
+ ],
47
+ "scripts": {
48
+ "typecheck": "tsc --noEmit"
49
+ },
50
+ "devDependencies": {
51
+ "typescript": "^7.0.2",
52
+ "@types/node": "^26.2.0"
53
+ },
54
+ "dsh": {
55
+ "bundle": {
56
+ "patch": "./cordis.patch.yml"
57
+ },
58
+ "client": {
59
+ "platform": "web",
60
+ "immediately": true,
61
+ "inject": [
62
+ "@deepseek-ai/dsh-client-ui-settings"
63
+ ]
64
+ }
65
+ },
66
+ "engines": {
67
+ "node": ">=22.19.0",
68
+ "dsh": ">=0.2.2-rc.3"
69
+ }
70
+ }
@@ -0,0 +1,3 @@
1
+ [
2
+ "assets/screenshot-1.png"
3
+ ]