dsh-vscode-workbench 0.1.12 → 0.2.0

package/lib/index.js

@@ -1,11 +1,14 @@
 import { createRequire } from "node:module";
+import { chmodSync, constants, createReadStream, realpathSync, statSync } from "node:fs";
 import { access, lstat, mkdir, open, readFile, readdir, realpath, rename, rm, stat } from "node:fs/promises";
 import { basename, dirname, extname, isAbsolute, join, normalize, relative, resolve, sep } from "node:path";
+import { execFile, spawn } from "node:child_process";
 import chokidar from "chokidar";
 import { WebSocket, WebSocketServer } from "ws";
 import { createHash, randomUUID } from "node:crypto";
-import { spawn } from "node:child_process";
-import { chmodSync, constants, realpathSync, statSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { pathToFileURL } from "node:url";
+import { promisify } from "node:util";
 import * as pty from "node-pty";
 //#region src/wire.ts
 var WorkbenchError = class extends Error {
@@ -127,6 +130,86 @@ function relativePath(root, absolute) {
 function revision(content, mtimeMs) {
 	return createHash("sha256").update(content).update(String(mtimeMs)).digest("hex");
 }
+const PROJECT_SOURCE = /\.(?:[cm]?[jt]sx?|d\.ts)$/i;
+const PROJECT_CONFIG = /* @__PURE__ */ new Set([
+	"tsconfig.json",
+	"jsconfig.json",
+	"package.json"
+]);
+const PROJECT_SKIP = /* @__PURE__ */ new Set([
+	".git",
+	"node_modules",
+	"dist",
+	"build",
+	"out",
+	"coverage",
+	".next",
+	".nuxt",
+	".turbo",
+	".cache",
+	"vendor",
+	"third_party"
+]);
+/** Add a folder picked in the OS chooser to DSH's workspace list, reusing an existing registration. */
+async function openWorkspaceFromPicker(picker, registry, signal) {
+	if (picker === void 0) throw new WorkbenchError("picker-unavailable", "当前环境没有可用的文件夹选择器", 409);
+	const capability = picker.capability();
+	if (capability.kind !== "native" || capability.pick === void 0) throw new WorkbenchError("picker-browse", "浏览器模式暂不支持从工作台选择文件夹，请使用 DSH 侧栏的「添加工作区」", 409);
+	const picked = await capability.pick(signal);
+	if (picked === null) return { opened: false };
+	if (registry === void 0) throw new WorkbenchError("workspace-unavailable", "工作区服务不可用", 503);
+	const workspace = await registry.create(picked);
+	return {
+		opened: true,
+		workspace: {
+			id: workspace.id,
+			path: workspace.path,
+			title: workspace.title
+		}
+	};
+}
+/** TS/JS sources the editor's language service indexes, bounded so huge repos stay responsive. */
+async function projectSources(cwd, limits = {}) {
+	const { files: maxFiles = 2e3, bytes: maxBytes = 25165824, fileBytes = 524288 } = limits;
+	const { root } = await workspacePath(cwd, "");
+	const files = [];
+	let total = 0;
+	let truncated = false;
+	const queue = [root];
+	while (queue.length > 0) {
+		const directory = queue.shift();
+		const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+		entries.sort((a, b) => a.name.localeCompare(b.name));
+		for (const entry of entries) {
+			const full = join(directory, entry.name);
+			if (entry.isDirectory()) {
+				if (!PROJECT_SKIP.has(entry.name) && !entry.name.startsWith(".")) queue.push(full);
+				continue;
+			}
+			if (!entry.isFile() || !(PROJECT_SOURCE.test(entry.name) || PROJECT_CONFIG.has(entry.name))) continue;
+			const info = await stat(full).catch(() => void 0);
+			if (info === void 0 || info.size > fileBytes) continue;
+			if (files.length >= maxFiles || total + info.size > maxBytes) {
+				truncated = true;
+				return {
+					files,
+					truncated
+				};
+			}
+			const content = await readFile(full, "utf8").catch(() => void 0);
+			if (content === void 0) continue;
+			total += info.size;
+			files.push({
+				path: relativePath(root, full),
+				content
+			});
+		}
+	}
+	return {
+		files,
+		truncated
+	};
+}
 async function listFiles(cwd, path) {
 	const { root, absolute } = await workspacePath(cwd, path);
 	const values = await readdir(absolute, { withFileTypes: true });
@@ -265,7 +348,13 @@ const PREVIEW_TYPES = {
 	".pdf": "application/pdf",
 	".doc": "application/msword",
 	".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-	".odt": "application/vnd.oasis.opendocument.text"
+	".odt": "application/vnd.oasis.opendocument.text",
+	".xls": "application/vnd.ms-excel",
+	".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+	".xlsm": "application/vnd.ms-excel.sheet.macroEnabled.12",
+	".ods": "application/vnd.oasis.opendocument.spreadsheet",
+	".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+	".pptm": "application/vnd.ms-powerpoint.presentation.macroEnabled.12"
 };
 /** Resolve a supported preview file inside the workspace. */
 async function workspacePreviewFile(cwd, path) {
@@ -277,6 +366,17 @@ async function workspacePreviewFile(cwd, path) {
 		type
 	};
 }
+/** Resolve a regular workspace file for drag-out downloads. */
+async function workspaceDownloadFile(cwd, path) {
+	const resolved = await workspacePath(cwd, path);
+	const info = await stat(resolved.absolute);
+	if (!info.isFile()) throw new WorkbenchError("not-file", "only files can be downloaded", 400);
+	return {
+		path: resolved.absolute,
+		name: basename(resolved.absolute),
+		size: info.size
+	};
+}
 /** Resolve the PDF.js worker shipped with this plugin's runtime dependency. */
 function pdfWorkerAsset() {
 	return {
@@ -367,7 +467,7 @@ async function searchWorkspace(cwd, request, signal) {
 		if (event.type !== "match" || event.data?.path?.text === void 0 || event.data.lines?.text === void 0) continue;
 		for (const hit of event.data.submatches ?? []) {
 			matches.push({
-				path: event.data.path.text.replace(/^\.\//, ""),
+				path: event.data.path.text.replace(/\\/g, "/").replace(/^\.\//, ""),
 				line: event.data.line_number ?? 1,
 				column: hit.start + 1,
 				preview: event.data.lines.text.trimEnd(),
@@ -405,18 +505,21 @@ async function gitObject(repository, spec) {
 	], repository);
 	return result.code === 0 ? result.stdout : "";
 }
-async function commitFiles(repository, hash) {
+async function commitParent(repository, hash) {
 	const parent = await run("git", [
 		"rev-parse",
 		"--verify",
 		`${hash}^1`
 	], repository);
-	const result = parent.code === 0 ? await run("git", [
+	return parent.code === 0 ? parent.stdout.trim() : void 0;
+}
+async function commitFiles(repository, hash, parent) {
+	const result = parent !== void 0 ? await run("git", [
 		"diff",
 		"--name-status",
 		"-z",
 		"-M",
-		parent.stdout.trim(),
+		parent,
 		hash,
 		"--"
 	], repository) : await run("git", [
@@ -585,6 +688,33 @@ async function gitAction(cwd, action, path, value) {
 		case "branch.switch":
 			args = ["switch", value ?? ""];
 			break;
+		case "branch.list": {
+			const refs = await run("git", [
+				"for-each-ref",
+				"--format=%(refname:short)",
+				"refs/heads"
+			], repository);
+			if (refs.code !== 0) throw new WorkbenchError("git-failed", refs.stderr, 500);
+			const worktrees = await run("git", [
+				"worktree",
+				"list",
+				"--porcelain"
+			], repository);
+			const used = /* @__PURE__ */ new Map();
+			if (worktrees.code === 0) {
+				const same = (a, b) => normalize(a) === normalize(b) || process.platform === "win32" && normalize(a).toLowerCase() === normalize(b).toLowerCase();
+				let worktree = "";
+				for (const line of worktrees.stdout.split("\n")) if (line.startsWith("worktree ")) worktree = line.slice(9).trim();
+				else if (line.startsWith("branch refs/heads/")) {
+					const name = line.slice(18).trim();
+					if (name !== "" && !same(worktree, repository)) used.set(name, worktree);
+				}
+			}
+			return refs.stdout.split("\n").filter(Boolean).map((name) => ({
+				name,
+				...used.has(name) ? { worktree: used.get(name) } : {}
+			}));
+		}
 		case "branches": {
 			const result = await run("git", [
 				"for-each-ref",
@@ -640,43 +770,44 @@ async function gitAction(cwd, action, path, value) {
 				modified: result.stdout
 			};
 		}
-		case "commit.files": return commitFiles(repository, validateCommitHash(value));
+		case "commit.files": {
+			const hash = validateCommitHash(value);
+			return commitFiles(repository, hash, await commitParent(repository, hash));
+		}
 		case "commit.file.diff": {
 			const hash = validateCommitHash(value);
 			const target = validateGitPath(repository, path);
-			const file = (await commitFiles(repository, hash)).find((item) => item.path === target);
+			const parent = await commitParent(repository, hash);
+			const file = (await commitFiles(repository, hash, parent)).find((item) => item.path === target);
 			if (file === void 0) throw new WorkbenchError("not-found", "file is not part of the commit", 404);
-			const parent = await run("git", [
-				"rev-parse",
-				"--verify",
-				`${hash}^1`
-			], repository);
-			const shown = parent.code === 0 ? await run("git", [
-				"diff",
-				"--no-ext-diff",
-				"--find-renames",
-				"--patch",
-				"--no-color",
-				parent.stdout.trim(),
-				hash,
-				"--",
-				file.previousPath ?? target,
-				target
-			], repository) : await run("git", [
-				"show",
-				"--no-ext-diff",
-				"--find-renames",
-				"--format=",
-				"--patch",
-				"--no-color",
-				hash,
-				"--",
-				file.previousPath ?? target,
-				target
-			], repository);
+			const [shown, original, modified] = await Promise.all([
+				parent !== void 0 ? run("git", [
+					"diff",
+					"--no-ext-diff",
+					"--find-renames",
+					"--patch",
+					"--no-color",
+					parent,
+					hash,
+					"--",
+					file.previousPath ?? target,
+					target
+				], repository) : run("git", [
+					"show",
+					"--no-ext-diff",
+					"--find-renames",
+					"--format=",
+					"--patch",
+					"--no-color",
+					hash,
+					"--",
+					file.previousPath ?? target,
+					target
+				], repository),
+				file.status === "A" || parent === void 0 ? "" : gitObject(repository, `${parent}:${file.previousPath ?? target}`),
+				file.status === "D" ? "" : gitObject(repository, `${hash}:${target}`)
+			]);
 			if (shown.code !== 0) throw new WorkbenchError("git-failed", shown.stderr || shown.stdout, 409);
-			const original = file.status === "A" || parent.code !== 0 ? "" : await gitObject(repository, `${parent.stdout.trim()}:${file.previousPath ?? target}`);
-			const modified = file.status === "D" ? "" : await gitObject(repository, `${hash}:${target}`);
 			return {
 				diff: shown.stdout,
 				original,
@@ -721,6 +852,14 @@ function codiconAsset() {
 		type: "font/ttf"
 	};
 }
+/** Browser build of SheetJS served as an asset so the client bundle stays free of Node builtins. */
+function xlsxAsset() {
+	const packageRoot = dirname(require$1.resolve("xlsx/package.json"));
+	return {
+		path: resolve(packageRoot, "dist", "xlsx.full.min.js"),
+		type: "text/javascript; charset=utf-8"
+	};
+}
 function monacoAsset(raw) {
 	const packageRoot = dirname(require$1.resolve("monaco-editor/package.json"));
 	const path = resolve(packageRoot, "min", raw);
@@ -730,6 +869,443 @@ function monacoAsset(raw) {
 		type: extname(path) === ".css" ? "text/css" : extname(path) === ".js" ? "text/javascript" : extname(path) === ".ttf" ? "font/ttf" : "application/octet-stream"
 	};
 }
+/** Resolve a vscode-icons SVG shipped by @vscode-icons/vscode-icons-api. */
+function fileIconAsset(raw) {
+	if (!/^[a-z0-9_-]+\.svg$/i.test(raw)) throw new WorkbenchError("asset-invalid", "invalid file icon path", 403);
+	const packageRoot = dirname(require$1.resolve("@vscode-icons/vscode-icons-api/package.json"));
+	return {
+		path: resolve(packageRoot, "icons", raw),
+		type: "image/svg+xml"
+	};
+}
+//#endregion
+//#region src/lsp.ts
+/** Host-side registry and process bridge for language servers exposed to the workbench editor. */
+/** The strongest maintained server for each language, installable where the ecosystem allows it. */
+const LSP_SERVERS = [
+	{
+		id: "python",
+		name: "Python · Pyright",
+		languages: ["python"],
+		install: {
+			kind: "npm",
+			package: "pyright",
+			bin: "pyright-langserver"
+		},
+		args: ["--stdio"]
+	},
+	{
+		id: "php",
+		name: "PHP · Intelephense",
+		languages: ["php"],
+		install: {
+			kind: "npm",
+			package: "intelephense",
+			bin: "intelephense"
+		},
+		args: ["--stdio"]
+	},
+	{
+		id: "shell",
+		name: "Shell · Bash Language Server",
+		languages: ["shell"],
+		install: {
+			kind: "npm",
+			package: "bash-language-server",
+			bin: "bash-language-server"
+		},
+		args: ["start"]
+	},
+	{
+		id: "yaml",
+		name: "YAML · YAML Language Server",
+		languages: ["yaml"],
+		install: {
+			kind: "npm",
+			package: "yaml-language-server",
+			bin: "yaml-language-server"
+		},
+		args: ["--stdio"]
+	},
+	{
+		id: "json",
+		name: "JSON · VS Code JSON",
+		languages: ["json"],
+		install: {
+			kind: "npm",
+			package: "vscode-langservers-extracted",
+			bin: "vscode-json-language-server"
+		},
+		args: ["--stdio"]
+	},
+	{
+		id: "css",
+		name: "CSS / SCSS / Less · VS Code CSS",
+		languages: [
+			"css",
+			"scss",
+			"less"
+		],
+		install: {
+			kind: "npm",
+			package: "vscode-langservers-extracted",
+			bin: "vscode-css-language-server"
+		},
+		args: ["--stdio"]
+	},
+	{
+		id: "html",
+		name: "HTML · VS Code HTML",
+		languages: ["html"],
+		install: {
+			kind: "npm",
+			package: "vscode-langservers-extracted",
+			bin: "vscode-html-language-server"
+		},
+		args: ["--stdio"]
+	},
+	{
+		id: "dockerfile",
+		name: "Dockerfile · Docker LS",
+		languages: ["dockerfile"],
+		install: {
+			kind: "npm",
+			package: "dockerfile-language-server-nodejs",
+			bin: "dockerfile-language-server-nodejs"
+		},
+		args: ["--stdio"]
+	},
+	{
+		id: "go",
+		name: "Go · gopls",
+		languages: ["go"],
+		install: {
+			kind: "system",
+			command: "gopls",
+			hint: "在终端运行：go install golang.org/x/tools/gopls@latest（需要 Go 工具链）"
+		},
+		args: ["serve"]
+	},
+	{
+		id: "rust",
+		name: "Rust · rust-analyzer",
+		languages: ["rust"],
+		install: {
+			kind: "system",
+			command: "rust-analyzer",
+			hint: "运行：rustup component add rust-analyzer"
+		},
+		args: []
+	},
+	{
+		id: "cpp",
+		name: "C / C++ · clangd",
+		languages: [
+			"c",
+			"cpp",
+			"objective-c"
+		],
+		install: {
+			kind: "system",
+			command: "clangd",
+			hint: "安装 LLVM（Windows：winget install LLVM.LLVM），并确保 clangd 在 PATH 中"
+		},
+		args: []
+	},
+	{
+		id: "java",
+		name: "Java · Eclipse JDT LS",
+		languages: ["java"],
+		install: {
+			kind: "system",
+			command: "jdtls",
+			hint: "下载 eclipse.jdt.ls 并让 jdtls 启动脚本在 PATH 中"
+		},
+		args: []
+	},
+	{
+		id: "csharp",
+		name: "C# · csharp-ls",
+		languages: ["csharp"],
+		install: {
+			kind: "system",
+			command: "csharp-ls",
+			hint: "运行：dotnet tool install --global csharp-ls（需要 .NET SDK）"
+		},
+		args: []
+	},
+	{
+		id: "lua",
+		name: "Lua · Lua Language Server",
+		languages: ["lua"],
+		install: {
+			kind: "system",
+			command: "lua-language-server",
+			hint: "从 github.com/LuaLS/lua-language-server/releases 下载，并把 lua-language-server 加入 PATH"
+		},
+		args: []
+	}
+];
+/** Private install root so language servers never touch the user's global npm state. */
+function lspRoot() {
+	return join(homedir(), ".dsh", "dsh-vscode-workbench", "lsp");
+}
+function npmBinPath(id, bin) {
+	const path = join(lspRoot(), id, "node_modules", ".bin", bin);
+	return process.platform === "win32" ? `${path}.cmd` : path;
+}
+async function exists$1(path) {
+	return access(path).then(() => true, () => false);
+}
+function which$1(command) {
+	return new Promise((resolve) => {
+		const child = spawn(process.platform === "win32" ? "where" : "which", [command], { windowsHide: true });
+		let output = "";
+		child.stdout.on("data", (chunk) => {
+			output += String(chunk);
+		});
+		child.on("error", () => resolve(void 0));
+		child.on("close", (code) => resolve(code === 0 ? output.split(/\r?\n/).map((line) => line.trim()).find(Boolean) : void 0));
+	});
+}
+function definition(id) {
+	const found = LSP_SERVERS.find((server) => server.id === id);
+	if (found === void 0) throw new WorkbenchError("lsp-unknown", `unknown language server: ${id}`, 404);
+	return found;
+}
+async function commandFor(server) {
+	if (server.install.kind === "npm") {
+		const command = npmBinPath(server.id, server.install.bin);
+		return await exists$1(command) ? {
+			command,
+			shell: process.platform === "win32"
+		} : void 0;
+	}
+	const command = await which$1(server.install.command);
+	return command === void 0 ? void 0 : {
+		command,
+		shell: process.platform === "win32"
+	};
+}
+async function lspStatuses() {
+	return Promise.all(LSP_SERVERS.map(async (server) => {
+		const resolved = await commandFor(server);
+		return {
+			id: server.id,
+			name: server.name,
+			languages: server.languages,
+			installable: server.install.kind === "npm",
+			installed: resolved !== void 0,
+			...server.install.kind === "system" ? { hint: server.install.hint } : {}
+		};
+	}));
+}
+/** Install an npm-distributed server into the plugin's private directory. */
+async function installLsp(id) {
+	const server = definition(id);
+	if (server.install.kind !== "npm") throw new WorkbenchError("lsp-manual", server.install.hint, 409);
+	const directory = join(lspRoot(), id);
+	await mkdir(directory, { recursive: true });
+	await new Promise((resolve, reject) => {
+		const child = spawn("npm", [
+			"install",
+			"--prefix",
+			directory,
+			"--no-save",
+			"--no-audit",
+			"--no-fund",
+			"--loglevel=error",
+			server.install.kind === "npm" ? server.install.package : ""
+		], {
+			cwd: directory,
+			shell: process.platform === "win32",
+			windowsHide: true
+		});
+		let error = "";
+		child.stderr.on("data", (chunk) => {
+			error = (error + String(chunk)).slice(-4e3);
+		});
+		const timer = setTimeout(() => {
+			child.kill();
+			reject(new WorkbenchError("lsp-timeout", "语言服务器安装超时", 504));
+		}, 6e5);
+		child.on("error", (cause) => {
+			clearTimeout(timer);
+			reject(new WorkbenchError("lsp-install", String(cause), 500));
+		});
+		child.on("close", (code) => {
+			clearTimeout(timer);
+			if (code === 0) resolve();
+			else reject(new WorkbenchError("lsp-install", error.trim() || `npm exited with ${code}`, 500));
+		});
+	});
+}
+async function uninstallLsp(id) {
+	if (definition(id).install.kind !== "npm") return;
+	await rm(join(lspRoot(), id), {
+		recursive: true,
+		force: true
+	});
+}
+/** Resolve the spawn command for a running server, or explain what the user must install. */
+async function resolveLsp(id) {
+	const server = definition(id);
+	const resolved = await commandFor(server);
+	if (resolved === void 0) throw new WorkbenchError("lsp-missing", server.install.kind === "system" ? server.install.hint : "语言服务器尚未安装", 409);
+	return {
+		...resolved,
+		args: server.args
+	};
+}
+/** Serialize a JSON-RPC message using the Language Server Protocol base framing. */
+function frameLsp(message) {
+	const body = JSON.stringify(message);
+	return `Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`;
+}
+/** Incremental decoder for LSP frames arriving in arbitrary chunks. */
+function lspFrameParser(onMessage) {
+	let buffer = Buffer.alloc(0);
+	return (chunk) => {
+		buffer = Buffer.concat([buffer, chunk]);
+		for (;;) {
+			const headerEnd = buffer.indexOf("\r\n\r\n");
+			if (headerEnd < 0) return;
+			const header = buffer.subarray(0, headerEnd).toString("ascii");
+			const length = /content-length:\s*(\d+)/i.exec(header)?.[1];
+			if (length === void 0) {
+				buffer = buffer.subarray(headerEnd + 4);
+				continue;
+			}
+			const size = Number(length);
+			if (buffer.length < headerEnd + 4 + size) return;
+			const body = buffer.subarray(headerEnd + 4, headerEnd + 4 + size).toString("utf8");
+			buffer = buffer.subarray(headerEnd + 4 + size);
+			try {
+				onMessage(JSON.parse(body));
+			} catch {}
+		}
+	};
+}
+/** Wire a spawned language server's stdio to JSON-RPC frames in both directions. */
+function pipeLanguageServer(child, handlers) {
+	const parse = lspFrameParser((message) => handlers.onMessage(message));
+	child.stdout?.on("data", (chunk) => parse(chunk));
+	child.stderr?.on("data", (chunk) => handlers.onStderr?.(String(chunk)));
+	child.stdin?.on("error", () => void 0);
+	child.on("exit", (code) => handlers.onExit?.(code));
+	return {
+		write(text) {
+			try {
+				child.stdin?.write(frameLsp(JSON.parse(text)));
+			} catch {}
+		},
+		kill() {
+			child.kill();
+		}
+	};
+}
+//#endregion
+//#region src/office.ts
+/** Convert Word and PowerPoint documents to PDF with a locally installed LibreOffice, like DSH's own preview. */
+/** Whether a path is a document that can only be shown through the converter. */
+function needsOfficeConversion(path) {
+	const extension = extname(path).toLowerCase();
+	return extension === ".doc" || extension === ".docx" || extension === ".ppt" || extension === ".pptx" || extension === ".odt" || extension === ".odp" || extension === ".rtf";
+}
+/** Install guidance mirrors DSH: the preview never downloads an engine itself. */
+const OFFICE_HINT = "未检测到 LibreOffice。安装 LibreOffice 后可像 DSH 官方预览一样把 Word / PowerPoint 转成 PDF 查看。";
+function candidates() {
+	const list = [process.env.DVW_SOFFICE];
+	if (process.platform === "win32") list.push("soffice", "C:\\Program Files\\LibreOffice\\program\\soffice.exe", "C:\\Program Files (x86)\\LibreOffice\\program\\soffice.exe");
+	else if (process.platform === "darwin") list.push("soffice", "/Applications/LibreOffice.app/Contents/MacOS/soffice");
+	else list.push("soffice", "libreoffice", "/usr/bin/soffice", "/usr/bin/libreoffice", "/snap/bin/libreoffice");
+	return list.filter((value) => typeof value === "string" && value !== "");
+}
+function which(command) {
+	return new Promise((resolve) => {
+		const child = spawn(process.platform === "win32" ? "where" : "which", [command], { windowsHide: true });
+		let output = "";
+		child.stdout.on("data", (chunk) => {
+			output += String(chunk);
+		});
+		child.on("error", () => resolve(void 0));
+		child.on("close", (code) => resolve(code === 0 ? output.split(/\r?\n/).map((line) => line.trim()).find(Boolean) : void 0));
+	});
+}
+async function exists(path) {
+	return access(path).then(() => true, () => false);
+}
+let detected;
+/** Locate LibreOffice without repeatedly probing the system for every open tab. */
+async function findOfficeConverter() {
+	if (detected !== void 0 && Date.now() - detected.checked < 6e4) return detected.path;
+	let found;
+	for (const candidate of candidates()) {
+		if ((candidate.includes("/") || candidate.includes("\\")) && await exists(candidate)) {
+			found = candidate;
+			break;
+		}
+		const resolved = await which(candidate);
+		if (resolved !== void 0) {
+			found = resolved;
+			break;
+		}
+	}
+	detected = {
+		path: found,
+		checked: Date.now()
+	};
+	return found;
+}
+/** Availability payload for the settings and preview UI. */
+async function officeStatus() {
+	return await findOfficeConverter() === void 0 ? {
+		available: false,
+		hint: OFFICE_HINT
+	} : { available: true };
+}
+/** Convert one workspace document to a cached PDF and return its absolute path. */
+async function officePdf(cwd, path) {
+	if (!needsOfficeConversion(path)) throw new WorkbenchError("unsupported-media", "file is not a Word or PowerPoint document", 415);
+	const source = await workspacePath(cwd, path);
+	const converter = await findOfficeConverter();
+	if (converter === void 0) throw new WorkbenchError("converter-missing", OFFICE_HINT, 503);
+	const info = await stat(source.absolute);
+	const root = join(tmpdir(), "dsh-vscode-workbench-office");
+	const key = createHash("sha1").update(`${source.absolute}:${info.size}:${info.mtimeMs}`).digest("hex").slice(0, 20);
+	const target = join(root, `${key}.pdf`);
+	if (await exists(target)) return { path: target };
+	await mkdir(root, { recursive: true });
+	const output = join(root, `out-${key}`);
+	await mkdir(output, { recursive: true });
+	const profile = pathToFileURL(join(root, `profile-${key}-${process.pid}-${Date.now()}`)).href;
+	try {
+		await promisify(execFile)(converter, [
+			"--headless",
+			"--norestore",
+			"--invisible",
+			"--convert-to",
+			"pdf",
+			"--outdir",
+			output,
+			`-env:UserInstallation=${profile}`,
+			source.absolute
+		], {
+			timeout: 12e4,
+			windowsHide: true,
+			maxBuffer: 4194304
+		});
+		const produced = join(output, `${basename(source.absolute, extname(source.absolute))}.pdf`);
+		if (!await exists(produced)) throw new WorkbenchError("converter-failed", "LibreOffice 未能生成 PDF", 500);
+		await rename(produced, target);
+		return { path: target };
+	} finally {
+		await rm(output, {
+			recursive: true,
+			force: true
+		}).catch(() => void 0);
+	}
+}
 //#endregion
 //#region src/terminal.ts
 const require = createRequire(import.meta.url);
@@ -968,9 +1544,96 @@ function installTerminal(ctx) {
 	}, "dsh-vscode-workbench: terminal teardown");
 }
 //#endregion
+//#region src/watch-ignore.ts
+/** Exclusion rules for the recursive workspace file watcher. */
+/** Directory names skipped by default; large dependency and build trees exhaust inotify watches. */
+const DEFAULT_WATCH_IGNORES = [
+	".git",
+	".hg",
+	".svn",
+	"node_modules",
+	"bower_components",
+	".pnpm-store",
+	".yarn",
+	".next",
+	".nuxt",
+	".turbo",
+	".vite",
+	".cache",
+	"coverage",
+	"vendor",
+	"third_party",
+	"third-party",
+	"third_part",
+	"third-part",
+	"build",
+	"dist",
+	"out",
+	"target",
+	".venv",
+	"venv",
+	"__pycache__",
+	".mypy_cache",
+	".pytest_cache",
+	".ruff_cache",
+	".gradle",
+	".idea",
+	".vs",
+	"Pods"
+];
+function normalize$1(entry) {
+	return entry.trim().replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+}
+function segmentsOf(entry) {
+	return normalize$1(entry).split("/").filter((part) => part !== "" && part !== ".");
+}
+/** Return true when a workspace-relative path contains one of the excluded segment sequences. */
+function isIgnoredPath(relativePath, patterns) {
+	const segments = relativePath.split(/[\\/]+/).filter(Boolean).map((segment) => segment.toLowerCase());
+	if (segments.length === 0) return false;
+	for (const pattern of patterns) {
+		const parts = segmentsOf(pattern).map((part) => part.toLowerCase());
+		if (parts.length === 0 || parts.includes("..")) continue;
+		if (parts.length === 1) {
+			if (segments.includes(parts[0])) return true;
+			continue;
+		}
+		for (let index = 0; index + parts.length <= segments.length; index++) if (parts.every((part, offset) => segments[index + offset] === part)) return true;
+	}
+	return false;
+}
+/** Literal directory/path rules from a .gitignore; glob and negation rules are left to git itself. */
+function parseGitIgnore(text) {
+	const entries = /* @__PURE__ */ new Set();
+	for (const raw of text.split(/\r?\n/)) {
+		const line = raw.trim();
+		if (line === "" || line.startsWith("#") || line.startsWith("!") || /[*?[\]{}]/.test(line)) continue;
+		const parts = segmentsOf(normalize$1(line).replace(/^\//, ""));
+		if (parts.length === 0 || parts.includes("..")) continue;
+		entries.add(parts.slice(0, 8).join("/").slice(0, 200));
+		if (entries.size >= 200) break;
+	}
+	return [...entries];
+}
+/** Ignore patterns derived from the workspace's root .gitignore, without asking the user to type exclusions. */
+async function workspaceWatchIgnores(workspace) {
+	return parseGitIgnore(await readFile(join(workspace, ".gitignore"), "utf8").catch(() => ""));
+}
+/** Build a chokidar `ignored` predicate for one workspace and the user's extra exclusions. */
+function watchIgnore(workspace, extra) {
+	const patterns = [...DEFAULT_WATCH_IGNORES, ...extra];
+	return (path) => {
+		const path_ = relative(workspace, path);
+		if (path_ === "" || path_.startsWith("..") || isAbsolute(path_)) return false;
+		return isIgnoredPath(path_.split(sep).join("/"), patterns);
+	};
+}
+//#endregion
 //#region src/index.ts
 /** DSH host plugin for the VS Code workbench. */
 const name = "dsh-vscode-workbench";
+let dshDirectoryPicker;
+let dshWorkspaceRegistry;
 const inject = [
 	"webServer",
 	"sessions",
@@ -990,6 +1653,16 @@ async function dispatch(ctx, method, body, signal) {
 		case "fs.create": return createEntry(cwd, stringField(body, "path"), body.kind === "directory" ? "directory" : "file").then(() => ({ ok: true }));
 		case "fs.rename": return renameEntry(cwd, stringField(body, "path"), stringField(body, "nextPath")).then(() => ({ ok: true }));
 		case "fs.delete": return deleteEntry(cwd, stringField(body, "path")).then(() => ({ ok: true }));
+		case "project.sources": return projectSources(cwd);
+		case "office.status": return officeStatus();
+		case "workspace.open": return openWorkspaceFromPicker(dshDirectoryPicker, dshWorkspaceRegistry, AbortSignal.timeout(6e5));
+		case "lsp.status": return lspStatuses();
+		case "lsp.install":
+			await installLsp(stringField(body, "id"));
+			return lspStatuses();
+		case "lsp.uninstall":
+			await uninstallLsp(stringField(body, "id"));
+			return lspStatuses();
 		case "search": return searchWorkspace(cwd, body, signal);
 		case "git.status": return gitStatus(cwd);
 		case "git.action": return gitAction(cwd, stringField(body, "action"), typeof body.path === "string" ? body.path : void 0, typeof body.value === "string" ? body.value : void 0);
@@ -997,6 +1670,21 @@ async function dispatch(ctx, method, body, signal) {
 	}
 }
 function apply(ctx) {
+	ctx.effect(() => {
+		if (typeof ctx.inject !== "function") return;
+		const fiber = ctx.inject(["directoryPicker", "workspaceRegistry"], (child) => {
+			const services = child;
+			dshDirectoryPicker = services.directoryPicker;
+			dshWorkspaceRegistry = services.workspaceRegistry;
+			return () => {
+				dshDirectoryPicker = void 0;
+				dshWorkspaceRegistry = void 0;
+			};
+		});
+		return () => {
+			fiber.dispose?.();
+		};
+	}, "dsh-vscode-workbench: optional DSH services");
 	installTerminal(ctx);
 	ctx.effect(() => ctx.webServer.register({
 		kind: "exact",
@@ -1015,6 +1703,40 @@ function apply(ctx) {
 			}
 		}
 	}), "dsh-vscode-workbench: Codicon font");
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: "/dsh-vscode/xlsx.js",
+		handler: async (req, res) => {
+			if (!authorize(req, res, ctx.connection)) return;
+			try {
+				const asset = xlsxAsset();
+				res.writeHead(200, {
+					"content-type": asset.type,
+					"cache-control": "public, max-age=31536000, immutable"
+				});
+				res.end(await readFile(asset.path));
+			} catch (error) {
+				sendError(res, error);
+			}
+		}
+	}), "dsh-vscode-workbench: SheetJS asset");
+	ctx.effect(() => ctx.webServer.register({
+		kind: "prefix",
+		path: "/dsh-vscode/file-icons",
+		handler: async (req, res) => {
+			if (!authorize(req, res, ctx.connection)) return;
+			try {
+				const asset = fileIconAsset(decodeURIComponent(new URL(req.url ?? "/", "http://dsh.local").pathname.slice(23)));
+				res.writeHead(200, {
+					"content-type": asset.type,
+					"cache-control": "public, max-age=31536000, immutable"
+				});
+				res.end(await readFile(asset.path));
+			} catch (error) {
+				sendError(res, error);
+			}
+		}
+	}), "dsh-vscode-workbench: file icons");
 	ctx.effect(() => ctx.webServer.register({
 		kind: "exact",
 		path: "/dsh-vscode/pdfjs/worker.mjs",
@@ -1105,6 +1827,54 @@ function apply(ctx) {
 			}
 		}
 	}), "dsh-vscode-workbench: file preview");
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: "/dsh-vscode/download",
+		handler: async (req, res) => {
+			if (!authorize(req, res, ctx.connection)) return;
+			try {
+				const url = new URL(req.url ?? "/", "http://dsh.local");
+				const sessionId = url.searchParams.get("sessionId");
+				const path = url.searchParams.get("path");
+				if (sessionId === null || path === null) throw new WorkbenchError("bad-request", "sessionId and path are required");
+				const file = await workspaceDownloadFile(cwdFor(ctx, sessionId), path);
+				res.writeHead(200, {
+					"content-type": "application/octet-stream",
+					"content-length": file.size,
+					"content-disposition": `attachment; filename*=UTF-8''${encodeURIComponent(file.name)}`,
+					"x-content-type-options": "nosniff",
+					"cache-control": "no-store"
+				});
+				createReadStream(file.path).on("error", (error) => res.destroy(error)).pipe(res);
+			} catch (error) {
+				sendError(res, error);
+			}
+		}
+	}), "dsh-vscode-workbench: file download");
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: "/dsh-vscode/office",
+		handler: async (req, res) => {
+			if (!authorize(req, res, ctx.connection)) return;
+			try {
+				const url = new URL(req.url ?? "/", "http://dsh.local");
+				const sessionId = url.searchParams.get("sessionId");
+				const path = url.searchParams.get("path");
+				if (sessionId === null || path === null) throw new WorkbenchError("bad-request", "sessionId and path are required");
+				const pdf = await officePdf(cwdFor(ctx, sessionId), path);
+				const info = await stat(pdf.path);
+				res.writeHead(200, {
+					"content-type": "application/pdf",
+					"content-length": info.size,
+					"x-content-type-options": "nosniff",
+					"cache-control": "no-store"
+				});
+				createReadStream(pdf.path).on("error", (error) => res.destroy(error)).pipe(res);
+			} catch (error) {
+				sendError(res, error);
+			}
+		}
+	}), "dsh-vscode-workbench: office preview");
 	ctx.effect(() => ctx.webServer.register({
 		kind: "prefix",
 		path: "/dsh-vscode/monaco",
@@ -1143,35 +1913,107 @@ function apply(ctx) {
 					ws.close(1008, "session workspace unavailable");
 					return;
 				}
-				const watcher = chokidar.watch(workspace, {
-					ignoreInitial: true,
-					ignored: /(^|[/\\])(\.git|node_modules|\.next|\.nuxt|\.turbo|\.vite|coverage)([/\\]|$)/,
-					awaitWriteFinish: {
-						stabilityThreshold: 100,
-						pollInterval: 25
-					}
-				});
+				let watcher;
 				let paths = /* @__PURE__ */ new Set();
 				let timer;
-				watcher.on("all", (_event, path) => {
-					const changed = isAbsolute(path) ? relative(workspace, path) : path;
-					paths.add(changed.split(sep).join("/"));
-					clearTimeout(timer);
-					timer = setTimeout(() => {
+				workspaceWatchIgnores(workspace).then((extra) => {
+					const instance = watcher = chokidar.watch(workspace, {
+						ignoreInitial: true,
+						ignored: watchIgnore(workspace, extra),
+						awaitWriteFinish: {
+							stabilityThreshold: 100,
+							pollInterval: 25
+						}
+					});
+					instance.on("error", (error) => {
+						console.warn("[dsh-vscode-workbench] file watcher stopped:", error);
 						if (ws.readyState === WebSocket.OPEN) ws.send(JSON.stringify({
-							type: "files.changed",
-							paths: [...paths]
+							type: "files.watch-error",
+							message: String(error)
 						}));
-						paths = /* @__PURE__ */ new Set();
-					}, 150);
+						instance.close();
+					});
+					instance.on("all", (_event, path) => {
+						const changed = isAbsolute(path) ? relative(workspace, path) : path;
+						paths.add(changed.split(sep).join("/"));
+						clearTimeout(timer);
+						timer = setTimeout(() => {
+							if (ws.readyState === WebSocket.OPEN) ws.send(JSON.stringify({
+								type: "files.changed",
+								paths: [...paths]
+							}));
+							paths = /* @__PURE__ */ new Set();
+						}, 150);
+					});
 				});
 				ws.on("close", () => {
 					clearTimeout(timer);
-					watcher.close();
+					watcher?.close();
 				});
 			});
 		}
 	}), "dsh-vscode-workbench: file watcher");
+	const lspWss = new WebSocketServer({ noServer: true });
+	ctx.effect(() => ctx.webServer.registerUpgrade({
+		path: "/dsh-vscode/ws/lsp",
+		handler(req, socket, head) {
+			if (ctx.connection.requestRejection(req) !== void 0) {
+				socket.destroy();
+				return;
+			}
+			lspWss.handleUpgrade(req, socket, head, (ws) => {
+				const search = new URL(req.url ?? "/", "http://dsh.local").searchParams;
+				const sessionId = search.get("sessionId");
+				const serverId = search.get("server");
+				if (sessionId === null || serverId === null) {
+					ws.close(1008, "sessionId and server required");
+					return;
+				}
+				let workspace;
+				try {
+					workspace = cwdFor(ctx, sessionId);
+				} catch {
+					ws.close(1008, "session workspace unavailable");
+					return;
+				}
+				(async () => {
+					try {
+						const server = await resolveLsp(serverId);
+						const child = spawn(server.command, server.args, {
+							cwd: workspace,
+							stdio: [
+								"pipe",
+								"pipe",
+								"pipe"
+							],
+							shell: server.shell,
+							windowsHide: true
+						});
+						const bridge = pipeLanguageServer(child, {
+							onMessage: (message) => {
+								if (ws.readyState === WebSocket.OPEN) ws.send(JSON.stringify(message));
+							},
+							onStderr: (text) => console.warn("[dsh-vscode-workbench] lsp:", text.trim().slice(0, 500)),
+							onExit: (code) => {
+								if (ws.readyState === WebSocket.OPEN) ws.close(1e3, `server exited ${code ?? ""}`.trim());
+							}
+						});
+						ws.on("message", (data) => bridge.write(String(data)));
+						ws.on("close", () => bridge.kill());
+						ws.on("error", () => bridge.kill());
+						child.on("error", (error) => {
+							if (ws.readyState === WebSocket.OPEN) ws.close(1011, String(error).slice(0, 120));
+						});
+					} catch (error) {
+						ws.close(1008, (error instanceof Error ? error.message : "language server unavailable").slice(0, 120));
+					}
+				})();
+			});
+		}
+	}), "dsh-vscode-workbench: language server bridge");
+	ctx.effect(() => () => {
+		lspWss.close();
+	}, "dsh-vscode-workbench: language server teardown");
 	ctx.effect(() => () => {
 		wss.close();
 	}, "dsh-vscode-workbench: watcher teardown");