dsh-linked-workspace 0.6.2 → 0.8.0

package/lib/index.js

@@ -34,7 +34,7 @@ export const inject = ['webServer', 'tools', 'systemPrompt', 'workingDirectory']
 
 const DATA_VERSION = 1
 const SETTINGS_VERSION = 1
-const SETTINGS_DEFAULTS = Object.freeze({ editorTheme: 'github-light', editorThemeFamily: 'github', editorThemeMode: 'system', fileOpenMode: 'editor' })
+const SETTINGS_DEFAULTS = Object.freeze({ editorTheme: 'github-light', editorThemeFamily: 'github', editorThemeMode: 'system', fileOpenMode: 'editor', autoSave: false })
 const EDITOR_THEME_FAMILIES = new Set(['github', 'solarized', 'one', 'dracula', 'monokai', 'nord', 'vscode', 'xcode', 'catppuccin'])
 const THEME_FAMILY_OF = (id) => {
   const value = String(id || '')
@@ -67,6 +67,18 @@ const EDITABLE_LIMIT = 2 * 1024 * 1024
 const PEEK_LIMIT = 512 * 1024
 const READ_CAP = 8 * 1024 * 1024
 const MAX_WRITE_BYTES = 8 * 1024 * 1024
+const MAX_MEDIA_BYTES = 24 * 1024 * 1024
+const IMAGE_MIME = Object.freeze({
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.webp': 'image/webp',
+  '.bmp': 'image/bmp',
+  '.ico': 'image/x-icon',
+  '.avif': 'image/avif',
+  '.svg': 'image/svg+xml',
+})
 const MAX_NAME_LENGTH = 120
 const CONNECT_TIMEOUT_MS = 20_000
 const OP_TIMEOUT_MS = 60_000
@@ -87,6 +99,7 @@ const ERROR_STATUS = {
   FS_IS_DIR: 400,
   FS_NOT_DIR: 400,
   FS_TOO_LARGE: 413,
+  FS_EXISTS: 409,
   CONFLICT: 409,
   INTERNAL: 500,
 }
@@ -183,6 +196,85 @@ function openWithSystem(targetPath) {
   }
 }
 
+/** Spawn a detached console process and report whether the executable started. */
+function launchDetached(command, args, extra = {}) {
+  return new Promise((resolveLaunch) => {
+    let child
+    try {
+      child = spawn(command, args, { detached: true, stdio: 'ignore', ...extra })
+    } catch {
+      resolveLaunch(false)
+      return
+    }
+    let settled = false
+    child.once('error', () => {
+      if (settled) return
+      settled = true
+      resolveLaunch(false)
+    })
+    child.once('spawn', () => {
+      if (settled) return
+      settled = true
+      try { child.unref() } catch { /* already detached */ }
+      resolveLaunch(true)
+    })
+  })
+}
+
+function quotePosix(text) {
+  return `'${String(text).replace(/'/g, `'\\''`)}'`
+}
+
+function quotePowerShell(text) {
+  return `'${String(text).replace(/'/g, "''")}'`
+}
+
+function quoteAppleScript(text) {
+  return `"${String(text).replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`
+}
+
+function remoteTerminalCommand(remotePath) {
+  return `cd ${quotePosix(remotePath)} && exec bash -l`
+}
+
+function sshTarget(host, username) {
+  return `${username || ''}@${host}`
+}
+
+/** Open a local terminal whose working directory is `dir`. */
+async function openLocalTerminal(dir) {
+  if (process.platform === 'win32') {
+    if (await launchDetached('wt.exe', ['-d', dir], { windowsHide: false })) return true
+    const script = `Set-Location -LiteralPath ${quotePowerShell(dir)}`
+    return launchDetached('powershell.exe', ['-NoLogo', '-NoExit', '-Command', script], { windowsHide: false })
+  }
+  if (process.platform === 'darwin') {
+    return launchDetached('open', ['-a', 'Terminal', dir])
+  }
+  if (await launchDetached('x-terminal-emulator', [`--working-directory=${dir}`])) return true
+  return launchDetached('gnome-terminal', [`--working-directory=${dir}`])
+}
+
+/** Open a terminal that SSHes into `host` and cd's to `remotePath`. */
+async function openRemoteTerminal(host, port, username, remotePath) {
+  const target = sshTarget(host, username)
+  const command = remoteTerminalCommand(remotePath)
+  if (!username) return false
+  if (process.platform === 'win32') {
+    const sshArgs = ['-p', String(port || 22), '-t', `${username}@${host}`, command]
+    if (await launchDetached('wt.exe', ['new-tab', '--', 'ssh.exe', ...sshArgs], { windowsHide: false })) return true
+    const script = `& ssh.exe -p ${Number(port) || 22} -t ${quotePowerShell(`${username}@${host}`)} ${quotePowerShell(command)}`
+    return launchDetached('powershell.exe', ['-NoLogo', '-NoExit', '-Command', script], { windowsHide: false })
+  }
+  if (process.platform === 'darwin') {
+    const line = `ssh -p ${Number(port) || 22} -t ${target} ${command}`
+    return launchDetached('osascript', ['-e', `tell application "Terminal" to do script ${quoteAppleScript(line)}`])
+  }
+  const sshArgs = ['-p', String(port || 22), '-t', target, command]
+  if (await launchDetached('x-terminal-emulator', ['-e', 'ssh', ...sshArgs])) return true
+  return launchDetached('gnome-terminal', ['--', 'ssh', ...sshArgs])
+}
+
 function readJsonFile(file, fallback) {
   try {
     return JSON.parse(readFileSync(file, 'utf8'))
@@ -216,6 +308,12 @@ function isInside(root, target) {
   return next === base || next.startsWith(`${base}/`)
 }
 
+function isInsideLocal(root, target) {
+  const base = resolve(root)
+  const next = resolve(target)
+  return next === base || next.startsWith(`${base}${sep}`)
+}
+
 function withTimeout(promise, ms, label) {
   let timer
   const timeout = new Promise((_, reject) => {
@@ -336,6 +434,9 @@ class SettingsStore {
     if (settings && typeof settings === 'object' && FILE_OPEN_MODES.has(settings.fileOpenMode)) {
       this.value.fileOpenMode = settings.fileOpenMode
     }
+    if (settings && typeof settings === 'object' && typeof settings.autoSave === 'boolean') {
+      this.value.autoSave = settings.autoSave
+    }
     if (settings && typeof settings === 'object' && settings.themeExplicit === true) {
       this.themeExplicit = true
     }
@@ -388,6 +489,10 @@ class SettingsStore {
       if (!FILE_OPEN_MODES.has(patch.fileOpenMode)) throw new ApiError('BAD_REQUEST', '文件打开方式无效')
       this.value.fileOpenMode = patch.fileOpenMode
     }
+    if (patch && typeof patch === 'object' && patch.autoSave !== undefined) {
+      if (typeof patch.autoSave !== 'boolean') throw new ApiError('BAD_REQUEST', '自动保存设置无效')
+      this.value.autoSave = patch.autoSave
+    }
     writeJsonAtomic(this.file, { version: SETTINGS_VERSION, settings: { ...this.value, themeExplicit: this.themeExplicit === true } })
     return this.get()
   }
@@ -1739,6 +1844,24 @@ export function apply(ctx) {
       }
     },
 
+    async 'media.read'(params = {}) {
+      const scope = await requireScope(params)
+      const target = scopeTarget(scope, params.path)
+      const mime = imageMimeOf(target)
+      if (!mime) throw new ApiError('BAD_REQUEST', '该文件不是支持的图片格式')
+      const stat = await scope.remote.stat(target)
+      if (stat.type === 'dir') throw new ApiError('FS_IS_DIR', '目标是目录，无法预览')
+      if (stat.size > MAX_MEDIA_BYTES) throw new ApiError('FS_TOO_LARGE', '图片超过 24 MB，无法预览')
+      const read = await scope.remote.readFile(target, { maxBytes: MAX_MEDIA_BYTES })
+      return {
+        path: target,
+        size: stat.size,
+        mtime: stat.mtime,
+        mime,
+        base64: read.data.toString('base64'),
+      }
+    },
+
     async 'fs.write'(params = {}) {
       const scope = await requireScope(params)
       if (typeof params.content !== 'string') throw new ApiError('BAD_REQUEST', 'content is required')
@@ -1950,6 +2073,27 @@ export function apply(ctx) {
       return {}
     },
 
+    async 'fs.move'(params = {}) {
+      const scope = await requireScope(params)
+      const source = scopeTarget(scope, params.path)
+      if (source === scope.root) throw new ApiError('BAD_REQUEST', '不能移动工作区根目录')
+      const sourceStat = await scope.remote.stat(source)
+      const targetDir = params.targetDir === undefined || params.targetDir === ''
+        ? posix.dirname(source)
+        : scopeTarget(scope, params.targetDir)
+      const dirStat = await scope.remote.stat(targetDir)
+      if (dirStat.type !== 'dir') throw new ApiError('FS_NOT_DIR', '目标不是目录')
+      if (sourceStat.type === 'dir' && (targetDir === source || targetDir.startsWith(`${source}/`))) {
+        throw new ApiError('BAD_REQUEST', '不能把目录移动到自身内部')
+      }
+      const target = posix.join(targetDir, posix.basename(source))
+      if (target === source) return { path: target }
+      if (await scope.remote.stat(target).catch(() => null)) throw new ApiError('FS_EXISTS', '目标目录中已存在同名文件或文件夹')
+      await scope.remote.rename(source, target)
+      await scopeMirrorRemove(scope, source)
+      return { path: target }
+    },
+
     async 'fs.delete'(params = {}) {
       const scope = await requireScope(params)
       const target = scopeTarget(scope, params.path)
@@ -2123,6 +2267,29 @@ export function apply(ctx) {
       }
     },
 
+    async 'local.media'(params = {}) {
+      const target = typeof params.path === 'string' ? params.path.trim() : ''
+      if (target === '' || !isAbsolute(target)) throw new ApiError('BAD_REQUEST', '本地路径必须是绝对路径')
+      const absolute = resolve(target)
+      const mime = imageMimeOf(absolute)
+      if (!mime) throw new ApiError('BAD_REQUEST', '该文件不是支持的图片格式')
+      let info
+      try {
+        info = await fsStat(absolute)
+      } catch (error) {
+        throw mapLocalFsError(error)
+      }
+      if (info.isDirectory()) throw new ApiError('FS_IS_DIR', '目标是目录，无法预览')
+      if (info.size > MAX_MEDIA_BYTES) throw new ApiError('FS_TOO_LARGE', '图片超过 24 MB，无法预览')
+      let data
+      try {
+        data = readFileSync(absolute)
+      } catch (error) {
+        throw mapLocalFsError(error)
+      }
+      return { path: absolute, size: info.size, mtime: info.mtimeMs, mime, base64: data.toString('base64') }
+    },
+
     async 'local.write'(params = {}) {
       const target = typeof params.path === 'string' ? params.path.trim() : ''
       if (target === '' || !isAbsolute(target)) throw new ApiError('BAD_REQUEST', '本地路径必须是绝对路径')
@@ -2169,6 +2336,46 @@ export function apply(ctx) {
       return { path: resolve(to) }
     },
 
+    async 'local.move'(params = {}) {
+      const source = typeof params.path === 'string' ? params.path.trim() : ''
+      const targetDir = typeof params.targetDir === 'string' ? params.targetDir.trim() : ''
+      if (source === '' || targetDir === '' || !isAbsolute(source) || !isAbsolute(targetDir)) {
+        throw new ApiError('BAD_REQUEST', '本地路径必须是绝对路径')
+      }
+      const root = typeof params.root === 'string' && params.root.trim() !== '' ? resolve(params.root.trim()) : ''
+      const sourcePath = resolve(source)
+      const dirPath = resolve(targetDir)
+      if (root && sourcePath === root) throw new ApiError('BAD_REQUEST', '不能移动工作区根目录')
+      if (root && (!isInsideLocal(root, sourcePath) || !isInsideLocal(root, dirPath))) {
+        throw new ApiError('BAD_REQUEST', '移动范围超出本地目录')
+      }
+      let sourceInfo
+      try {
+        sourceInfo = await fsStat(sourcePath)
+      } catch (error) {
+        throw mapLocalFsError(error)
+      }
+      let dirInfo
+      try {
+        dirInfo = await fsStat(dirPath)
+      } catch (error) {
+        throw mapLocalFsError(error)
+      }
+      if (!dirInfo.isDirectory()) throw new ApiError('FS_NOT_DIR', '目标不是目录')
+      if (sourceInfo.isDirectory() && (dirPath === sourcePath || dirPath.startsWith(sourcePath + sep))) {
+        throw new ApiError('BAD_REQUEST', '不能把目录移动到自身内部')
+      }
+      const target = join(dirPath, basename(sourcePath))
+      if (target === sourcePath) return { path: target }
+      if (existsSync(target)) throw new ApiError('FS_EXISTS', '目标目录中已存在同名文件或文件夹')
+      try {
+        renameSync(sourcePath, target)
+      } catch (error) {
+        throw mapLocalFsError(error)
+      }
+      return { path: target, type: sourceInfo.isDirectory() ? 'dir' : 'file' }
+    },
+
     async 'local.delete'(params = {}) {
       const target = typeof params.path === 'string' ? params.path.trim() : ''
       if (target === '' || !isAbsolute(target)) throw new ApiError('BAD_REQUEST', '本地路径必须是绝对路径')
@@ -2279,6 +2486,35 @@ export function apply(ctx) {
       return { opened: true, localPath, size: read.data.length }
     },
 
+    async 'terminal.open'(params = {}) {
+      const side = params.side === 'local' ? 'local' : 'remote'
+      const testMode = process.env.DSH_LINKED_WORKSPACE_NO_TERMINAL === '1'
+      const scope = await requireScope(params)
+      const snapshot = scope.kind === 'linked' ? (scope.record.hostSnapshot || {}) : (scope.workspace.hostSnapshot || {})
+      if (side === 'local') {
+        if (scope.kind !== 'linked') throw new ApiError('BAD_REQUEST', '该工作区没有本地目录')
+        const target = scope.record.localPath
+        let info
+        try {
+          info = await fsStat(target)
+        } catch (error) {
+          throw mapLocalFsError(error)
+        }
+        if (!info.isDirectory()) throw new ApiError('FS_NOT_DIR', '本地目录不存在')
+        if (testMode) return { opened: true, side, path: target, test: true }
+        if (!(await openLocalTerminal(target))) throw new ApiError('INTERNAL', '无法启动本地终端')
+        return { opened: true, side, path: target }
+      }
+      const stat = await scope.remote.stat(scope.root)
+      if (stat.type !== 'dir') throw new ApiError('FS_NOT_DIR', '远程目录不存在')
+      if (!snapshot.host || !snapshot.username) throw new ApiError('AUTH_FAILED', '缺少 SSH 主机或用户名，无法打开终端')
+      if (testMode) return { opened: true, side, path: scope.root, host: snapshot.host, test: true }
+      if (!(await openRemoteTerminal(snapshot.host, snapshot.port, snapshot.username, scope.root))) {
+        throw new ApiError('INTERNAL', '无法启动远程终端（找不到可用的终端程序）')
+      }
+      return { opened: true, side, path: scope.root, host: snapshot.host }
+    },
+
     async 'session.info'(params = {}) {
       const sessionId = typeof params.sessionId === 'string' ? params.sessionId.trim() : ''
       if (sessionId === '') throw new ApiError('BAD_REQUEST', 'sessionId is required')
@@ -2984,6 +3220,10 @@ function loopbackRejection(req) {
 
 // ── file helpers ────────────────────────────────────────────────────────────
 
+function imageMimeOf(filePath) {
+  return IMAGE_MIME[extname(String(filePath || '')).toLowerCase()] || ''
+}
+
 function looksBinary(buffer) {
   const sample = buffer.subarray(0, Math.min(buffer.length, 8192))
   for (let index = 0; index < sample.length; index += 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-linked-workspace",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "description": "Linked local ⇄ remote workspaces and SSH-backed remote directories for DeepSeek Harness: theme-aware split editor, file-type icons, and an agent tool that edits remote files directly.",
   "type": "module",
   "main": "lib/index.js",