@device1999/dsh-session-archive-delete 0.0.0-stage → 0.1.1

package/lib/paths.js

@@ -0,0 +1,105 @@
+/**
+ * dsh-session-archive-delete · 路径与命名工具
+ *
+ * 三个原则，与 delete-archived-sessions.ps1 保持一致：
+ *   1. 会话目录名原样保留（session-<uuid>），备份里不改名，恢复时直接复制回去
+ *   2. 备份文件夹名 <id 前 8 位>-<标题>，重名加 -2 / -3
+ *   3. 任何写操作前先确认目标路径确实在预期根目录之下，绝不越界
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+
+/** DSH 家目录：与宿主其它插件一致，优先 DSH_HOME，其次 ~/.dsh */
+export function dshHome() {
+  return process.env.DSH_HOME || path.join(os.homedir(), '.dsh')
+}
+
+/**
+ * 标题转安全文件名：去掉 Windows 非法与易混淆字符，压缩空白，按字节裁剪。
+ * 默认 60 字节（约 20 个汉字），与 ps1 一致。
+ */
+export function safeFileName(text, maxBytes = 60) {
+  if (!text) return ''
+  let s = String(text)
+    .replace(/[\x00-\x1F\x7F]/g, ' ')
+    .replace(/[<>:"/\\|?*]/g, ' ')
+    .replace(/[\[\]{}#%&~`^$@+=;,!]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .replace(/^[-_. ]+|[-_. ]+$/g, '')
+  const buf = Buffer.from(s, 'utf8')
+  if (buf.length > maxBytes) {
+    let cut = maxBytes
+    while (cut > 0 && (buf[cut] & 0xc0) === 0x80) cut--
+    s = buf.subarray(0, cut).toString('utf8').replace(/^[-_. ]+|[-_. ]+$/g, '')
+  }
+  return s
+}
+
+/** session UUID 前 8 位小写 */
+export function idPrefix(sessionId) {
+  const leaf = String(sessionId || '').replace(/^session-/, '')
+  const m = leaf.match(/^([0-9a-fA-F]{8})/)
+  if (m) return m[1].toLowerCase()
+  return (safeFileName(leaf, 8) || 'unknown').toLowerCase()
+}
+
+/** 备份文件夹名：<前8位>-<标题> */
+export function backupName(sessionId, title) {
+  const t = safeFileName(title) || '未命名'
+  return idPrefix(sessionId) + '-' + t
+}
+
+/**
+ * 在 root 下为 name 找一个不冲突的目录名（已存在就 -2 / -3）。
+ * @returns {string} 绝对路径
+ */
+export function uniqueDir(root, name) {
+  let candidate = name
+  let n = 2
+  while (fs.existsSync(path.join(root, candidate))) {
+    candidate = name + '-' + n
+    n++
+  }
+  return path.join(root, candidate)
+}
+
+/** 确认 child 解析后确实在 parent 之下（防止路径穿越与大小写/短名绕行） */
+export function isInside(parent, child) {
+  const p = path.resolve(parent)
+  const c = path.resolve(child)
+  if (c === p) return false
+  return c.startsWith(p.endsWith(path.sep) ? p : p + path.sep)
+}
+
+/** 递归列出目录下所有文件（返回绝对路径数组） */
+export function listFiles(root) {
+  const out = []
+  const walk = (dir) => {
+    let entries = []
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true })
+    } catch {
+      return
+    }
+    for (const e of entries) {
+      const full = path.join(dir, e.name)
+      if (e.isDirectory()) walk(full)
+      else if (e.isFile()) out.push(full)
+    }
+  }
+  walk(root)
+  return out
+}
+
+/** 递归计算目录大小（字节） */
+export function dirSize(root) {
+  let total = 0
+  for (const f of listFiles(root)) {
+    try {
+      total += fs.statSync(f).size
+    } catch {}
+  }
+  return total
+}

package/lib/store.js

@@ -0,0 +1,77 @@
+/**
+ * dsh-session-archive-delete · 设置持久化
+ *
+ * 存到 ~/.dsh/dsh-session-archive-delete.json（不写进 profile，不污染插件目录）。
+ * 读取失败一律回落到默认值；写入用「临时文件 + 改名」，避免半截 JSON。
+ *
+ * 设置项：
+ *   mode         'backup-then-delete'（默认）| 'delete-only'
+ *   backupRoot   备份根目录；空字符串 = <工作区根目录>\DSH-归档会话
+ *   confirm      是否弹确认框（默认 true）
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { dshHome } from './paths.js'
+
+export const DEFAULTS = Object.freeze({
+  mode: 'both', // 'both'（同时显示两个菜单项，默认）| 'backup-then-delete' | 'delete-only'
+  backupRoot: '',
+  confirm: true,
+  dateStyle: 'default', // 'default'（日期+主题）| 'id-title' | 'title' | 'id-title-date'
+})
+
+let cache = null
+
+export function settingsFile() {
+  return path.join(dshHome(), 'dsh-session-archive-delete.json')
+}
+
+/** 读设置（带内存缓存，写入后失效） */
+export function readSettings() {
+  if (cache) return { ...cache }
+  let loaded = {}
+  try {
+    loaded = JSON.parse(fs.readFileSync(settingsFile(), 'utf8')) || {}
+  } catch {
+    loaded = {}
+  }
+  cache = normalize(loaded)
+  return { ...cache }
+}
+
+/** 全量覆盖写设置，返回写入后的值 */
+export function writeSettings(patch) {
+  const next = normalize({ ...readSettings(), ...(patch || {}) })
+  const file = settingsFile()
+  const tmp = file + '.tmp'
+  try {
+    fs.mkdirSync(path.dirname(file), { recursive: true })
+    fs.writeFileSync(tmp, JSON.stringify(next, null, 2), 'utf8')
+    fs.renameSync(tmp, file)
+  } catch (err) {
+    try {
+      fs.rmSync(tmp, { force: true })
+    } catch {}
+    throw new Error('settings write failed: ' + String((err && err.message) || err))
+  }
+  cache = next
+  return { ...next }
+}
+
+/** 备份文件夹命名方式（dateStyle）合法值与默认 */
+const DATE_STYLES = ['default', 'id-title', 'title', 'id-title-date']
+
+/** 把任意输入收敛成合法设置。mode 默认 both：菜单同时显示两个选项 */
+export function normalize(input) {
+  const src = input && typeof input === 'object' ? input : {}
+  const mode = src.mode === 'delete-only' || src.mode === 'backup-then-delete' ? src.mode : 'both'
+  const backupRoot = typeof src.backupRoot === 'string' ? src.backupRoot.trim() : ''
+  const confirm = src.confirm === false ? false : true
+  const dateStyle = DATE_STYLES.indexOf(src.dateStyle) >= 0 ? src.dateStyle : 'default'
+  return { mode, backupRoot, confirm, dateStyle }
+}
+
+/** 测试或热更新后清掉缓存 */
+export function resetCache() {
+  cache = null
+}

package/lib/subtree.js

@@ -0,0 +1,138 @@
+/**
+ * dsh-session-archive-delete · 子代理会话收集
+ *
+ * 子代理会话是主会话的「兄弟目录」：
+ *   ~/.dsh/sessions/<工作区>/session-<主会话id>/
+ *   ~/.dsh/sessions/<工作区>/session-<子代理id>/   ← 目录名里看不出父子关系
+ *
+ * 关系记录在会话 header 的 parentSession 字段里。删主会话时如果不处理它们：
+ *   - 磁盘上留孤儿目录（占空间）
+ *   - 归档账本仍引用它们，侧栏可能出现空壳条目
+ *   - 对话框 @ 提及仍可能列出这些死掉的子会话
+ *
+ * 所以删除前先按 parentSession 广度优先收集整个子树（含跨工作区的子会话），
+ * 由调用方一起备份、一起删除。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+
+/** 读取会话日志里第一个含 header 的行，拿到 header 对象 */
+function readHeaderFromJsonl(file) {
+  try {
+    const fd = fs.openSync(file, 'r')
+    const buf = Buffer.alloc(64 * 1024)
+    const n = fs.readSync(fd, buf, 0, buf.length, 0)
+    fs.closeSync(fd)
+    const text = buf.subarray(0, n).toString('utf8')
+    // zstd 压缩文件按 utf8 解出来是乱码，直接放弃
+    if (text.indexOf('\uFFFD') >= 0) return null
+    for (const line of text.split(/\r?\n/)) {
+      if (!line || line.indexOf('header') < 0) continue
+      try {
+        const o = JSON.parse(line)
+        if (o && o.header && typeof o.header === 'object') return o.header
+        if (o && o.type === 'session/header' && o.data && typeof o.data === 'object') return o.data
+      } catch {}
+    }
+  } catch {}
+  return null
+}
+
+/**
+ * 读出某个会话目录的 header（不依赖宿主服务，纯读盘）。
+ * 注意：真实 DSH 的会话文件是 session.v4.jsonl.zstd（zstd 压缩），
+ * 读不出 header 属正常情况——此时完全依赖宿主的 sessionQuery 服务。
+ */
+function readHeaderFromDir(sessionDir) {
+  if (!sessionDir || !fs.existsSync(sessionDir)) return null
+  try {
+    for (const e of fs.readdirSync(sessionDir, { withFileTypes: true })) {
+      if (!e.isFile()) continue
+      if (!/\.(jsonl|json)$/i.test(e.name)) continue
+      const h = readHeaderFromJsonl(path.join(sessionDir, e.name))
+      if (h) return h
+    }
+  } catch {}
+  return null
+}
+
+/**
+ * 收集主会话及其所有子孙会话（广度优先）。
+ *
+ * 数据来源优先级：宿主 sessionQuery.listSessions() → 扫描磁盘读 header。
+ *
+ * @param {object} p
+ * @param {object} p.ctx         插件上下文
+ * @param {string} p.sessionId   主会话 id
+ * @param {string} p.sessionsRoot sessions 根目录
+ * @returns {Promise<Array<{id:string, dir:string, workspace:string}>>}
+ *          第一个元素恒为主会话自身
+ */
+export async function collectSubtree({ ctx, sessionId, sessionsRoot }) {
+  const out = [{ id: sessionId, dir: null, workspace: null }]
+  const seen = new Set([sessionId, sessionId.replace(/^session-/, ''), 'session-' + sessionId.replace(/^session-/, '')])
+
+  // ---- 建立 parent -> children 索引 ----
+  const childrenOf = new Map()
+  const addChild = (parent, child, dir, workspace) => {
+    if (!parent || !child) return
+    const list = childrenOf.get(parent) || []
+    if (!list.some((x) => x.id === child)) list.push({ id: child, dir, workspace })
+    childrenOf.set(parent, list)
+  }
+
+  let fromHost = false
+  try {
+    const sq = ctx && ctx.get ? ctx.get('sessionQuery') : null
+    if (sq && typeof sq.listSessions === 'function') {
+      const records = await sq.listSessions()
+      for (const r of records || []) {
+        const h = r && r.header
+        if (!h || typeof h.id !== 'string') continue
+        if (typeof h.parentSession !== 'string' || !h.parentSession) continue
+        addChild(h.parentSession, h.id, null, null)
+      }
+      fromHost = true
+    }
+  } catch {}
+
+  // ---- 宿主服务不可用时，扫盘补全索引 ----
+  if (!fromHost) {
+    let wsDirs = []
+    try {
+      wsDirs = fs.readdirSync(sessionsRoot, { withFileTypes: true }).filter((e) => e.isDirectory())
+    } catch {}
+    for (const ws of wsDirs) {
+      const wsPath = path.join(sessionsRoot, ws.name)
+      let sessDirs = []
+      try {
+        sessDirs = fs.readdirSync(wsPath, { withFileTypes: true }).filter((e) => e.isDirectory())
+      } catch {}
+      for (const sd of sessDirs) {
+        const dir = path.join(wsPath, sd.name)
+        const h = readHeaderFromDir(dir)
+        if (!h) continue
+        if (typeof h.parentSession !== 'string' || !h.parentSession) continue
+        addChild(h.parentSession, h.id, dir, ws.name)
+      }
+    }
+  }
+
+  // ---- 广度优先展开 ----
+  const queue = [sessionId]
+  let guard = 0
+  while (queue.length > 0 && guard++ < 5000) {
+    const parent = queue.shift()
+    const kids = childrenOf.get(parent) || []
+    for (const k of kids) {
+      if (seen.has(k.id)) continue
+      seen.add(k.id)
+      seen.add('session-' + k.id.replace(/^session-/, ''))
+      seen.add(k.id.replace(/^session-/, ''))
+      out.push({ id: k.id, dir: k.dir, workspace: k.workspace })
+      queue.push(k.id)
+    }
+  }
+
+  return out
+}

package/package.json

@@ -1,6 +1,59 @@
-{
-  "name": "@device1999/dsh-session-archive-delete",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+{
+  "name": "@device1999/dsh-session-archive-delete",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "给 DeepSeek Harness 的会话列表加一个安全的删除入口：先完整备份到本地、校验通过后再删除，支持子代理会话级联处理与自定义备份位置。",
+  "license": "MIT",
+  "author": "",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./assets/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "assets",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "session",
+    "delete",
+    "backup",
+    "archive",
+    "cleanup"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ]
+    }
+  },
+  "engines": {
+    "node": "^20.0.0 || >=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/device1999/dsh-session-archive-delete.git"
+  },
+  "homepage": "https://github.com/device1999/dsh-session-archive-delete#readme",
+  "bugs": {
+    "url": "https://github.com/device1999/dsh-session-archive-delete/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }