@civilization/dsh-workspace-files 0.2.0 → 0.3.0

package/README.md

@@ -27,6 +27,22 @@ DeepSeek Harness (DSH) 原生增强型文件浏览器插件。
 
 ---
 
+## 插件配置项 (设置中心 -> 插件 -> 插件配置)
+
+可在 DSH 设置界面的「插件配置」列表展开卡片，或直接在 `cordis.patch.yml` 中自定义配置：
+
+- **`maxDepth`** (number，默认 `16`，范围 1~100)：工作区文件树扫描的最大文件夹深度（层级）。
+- **`showHidden`** (boolean，默认 `false`)：默认是否显示以点开头的隐藏文件。
+
+```yaml
+- id: dsh-workspace-files
+  config:
+    maxDepth: 20
+    showHidden: false
+```
+
+---
+
 ## 安装
 
 ```powershell

package/lib/client.js

@@ -247,6 +247,24 @@ window.__ModuleLoader__.load({
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M2 3h4v4H2zM10 9h4v4h-4zM4 7v6h6" })
 			});
 		}
+		function IconChevronDown({ size = 14 }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+				width: size,
+				height: size,
+				viewBox: "0 0 16 16",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: "1.5",
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				style: {
+					display: "inline-block",
+					verticalAlign: "middle",
+					flexShrink: 0
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("polyline", { points: "4 6 8 10 12 6" })
+			});
+		}
 		//#endregion
 		//#region src/client/index.tsx
 		const inject = ["slots", "sidebarRightTabs"];
@@ -309,6 +327,422 @@ window.__ModuleLoader__.load({
 					key: OFFICIAL_FILES_TAB_ID
 				}, WorkspaceFilesTabTitle)), "dsh-workspace-files: official tab title");
 			}
+			const registerSettingsCard = (targetCtx) => {
+				if (!targetCtx?.slots) return;
+				targetCtx.effect?.(() => targetCtx.slots.inject("settings.plugin.item", function* () {
+					yield targetCtx.slots.register({
+						name: "settings.plugin.item",
+						key: "workspace-files"
+					}, WorkspaceFilesSettingsCard);
+					yield targetCtx.slots.register({
+						name: "settings.plugin.item",
+						key: "@civilization/dsh-workspace-files"
+					}, WorkspaceFilesSettingsCard);
+				}), "dsh-workspace-files: settings card");
+			};
+			if (slots) registerSettingsCard(ctx);
+			if (ctx.inject) ctx.inject(["settingsScope"], (scoped) => {
+				registerSettingsCard(scoped);
+			});
+		}
+		const CONFIG_STORAGE_KEY = "dsh_workspace_files_config";
+		function loadWorkspaceFilesConfig() {
+			try {
+				const raw = typeof localStorage !== "undefined" ? localStorage.getItem(CONFIG_STORAGE_KEY) : null;
+				if (raw) {
+					const parsed = JSON.parse(raw);
+					return {
+						maxDepth: typeof parsed.maxDepth === "number" && parsed.maxDepth > 0 ? parsed.maxDepth : 16,
+						showHidden: Boolean(parsed.showHidden)
+					};
+				}
+			} catch {}
+			return {
+				maxDepth: 16,
+				showHidden: false
+			};
+		}
+		function saveWorkspaceFilesConfig(cfg) {
+			try {
+				if (typeof localStorage !== "undefined") localStorage.setItem(CONFIG_STORAGE_KEY, JSON.stringify(cfg));
+				if (typeof window !== "undefined") window.dispatchEvent(new CustomEvent("dsh-workspace-files:config-change", { detail: cfg }));
+				fetch("/dsh-workspace-files/api/config.set", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify(cfg)
+				}).catch(() => {});
+			} catch {}
+		}
+		function ensureSettingsStyle() {
+			if (typeof document === "undefined") return;
+			const id = "dsh-workspace-files-settings-style";
+			if (document.getElementById(id)) return;
+			const style = document.createElement("style");
+			style.id = id;
+			style.textContent = `
+.dsh-wf-card {
+  border: 1px solid var(--dsw-alias-border-l2, #e5e7eb);
+  background: var(--dsw-alias-bg-layer-3, #fff);
+  border-radius: 12px;
+  list-style: none;
+  transition: border-color .16s, background .16s;
+  box-sizing: border-box;
+}
+.dsh-wf-card-open {
+  background: var(--dsw-alias-bg-layer-2, #f7f8fa);
+  border-color: var(--dsw-alias-label-dimmed, #c8ccd4);
+}
+.dsh-wf-header {
+  -webkit-appearance: none;
+  appearance: none;
+  width: 100%;
+  font: inherit;
+  color: inherit;
+  text-align: left;
+  cursor: pointer;
+  background: 0 0;
+  border: 0;
+  border-radius: 12px;
+  align-items: center;
+  gap: 12px;
+  padding: 14px 16px;
+  display: flex;
+}
+.dsh-wf-head-text {
+  flex-direction: column;
+  flex: 1;
+  gap: 4px;
+  min-width: 0;
+  display: flex;
+}
+.dsh-wf-name {
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font-size: 15px;
+  font-weight: 600;
+  line-height: 1.4;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.dsh-wf-version {
+  font-size: 12px;
+  font-weight: 400;
+  color: var(--dsw-alias-label-tertiary, #8b93a1);
+}
+.dsh-wf-desc {
+  color: var(--dsw-alias-label-tertiary, #8b93a1);
+  font-size: 13px;
+  line-height: 1.5;
+}
+.dsh-wf-chevron {
+  color: var(--dsw-alias-label-tertiary, #8b93a1);
+  flex: none;
+  transition: transform .16s ease-in-out;
+  display: inline-flex;
+}
+.dsh-wf-chevron-open {
+  transform: rotate(180deg);
+}
+.dsh-wf-body {
+  border-top: 1px solid var(--dsw-alias-border-l2, #e5e7eb);
+  margin: 0 16px;
+  padding: 8px 0 12px;
+}
+.dsh-wf-row {
+  align-items: center;
+  gap: 16px;
+  padding: 12px 0;
+  display: flex;
+  justify-content: space-between;
+}
+.dsh-wf-row + .dsh-wf-row {
+  border-top: 1px solid var(--dsw-alias-border-l2, rgba(118, 137, 166, 0.12));
+}
+.dsh-wf-label-box {
+  flex-direction: column;
+  flex: 1;
+  gap: 3px;
+  min-width: 0;
+  display: flex;
+}
+.dsh-wf-label {
+  font-size: 13.5px;
+  font-weight: 550;
+  color: var(--dsw-alias-label-primary, #1f2328);
+}
+.dsh-wf-hint {
+  color: var(--dsw-alias-label-tertiary, #8b93a1);
+  font-size: 12px;
+  line-height: 18px;
+}
+.dsh-wf-ctrl {
+  flex-shrink: 0;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.dsh-wf-seg {
+  border: 1px solid var(--dsw-alias-border-l2, #e5e7eb);
+  border-radius: 8px;
+  gap: 2px;
+  padding: 2px;
+  display: inline-flex;
+  background: var(--dsw-alias-bg-layer-1, rgba(255, 255, 255, 0.05));
+}
+.dsh-wf-seg-btn {
+  font: inherit;
+  color: var(--dsw-alias-label-secondary, #6b7280);
+  cursor: pointer;
+  background: 0 0;
+  border: none;
+  border-radius: 6px;
+  padding: 4px 10px;
+  font-size: 12px;
+  line-height: 18px;
+  transition: all 0.15s;
+}
+.dsh-wf-seg-btn:hover {
+  color: var(--dsw-alias-label-primary, #1f2328);
+}
+.dsh-wf-seg-active {
+  background: var(--dsw-alias-bg-layer-3, #eef0f4);
+  color: var(--dsw-alias-brand-primary, #4f6ef7);
+  font-weight: 600;
+  box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+}
+.dsh-wf-input {
+  box-sizing: border-box;
+  border: 1px solid var(--dsw-alias-border-l2, #d1d5db);
+  background: var(--dsw-alias-bg-layer-3, #fff);
+  width: 64px;
+  text-align: center;
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font: inherit;
+  border-radius: 7px;
+  padding: 4px 6px;
+  font-size: 12.5px;
+  line-height: 18px;
+}
+.dsh-wf-input:focus {
+  border-color: var(--dsw-alias-brand-primary, #4f6ef7);
+  outline: 2px solid color-mix(in srgb, var(--dsw-alias-brand-primary, #4f6ef7) 18%, transparent);
+}
+.dsh-wf-toggle {
+  position: relative;
+  display: inline-block;
+  width: 40px;
+  height: 22px;
+  cursor: pointer;
+}
+.dsh-wf-toggle input {
+  opacity: 0;
+  width: 0;
+  height: 0;
+  position: absolute;
+}
+.dsh-wf-toggle-track {
+  position: absolute;
+  top: 0; left: 0; right: 0; bottom: 0;
+  background-color: var(--dsw-alias-border-l2, #ccc);
+  transition: .2s cubic-bezier(.4, 0, .2, 1);
+  border-radius: 22px;
+}
+.dsh-wf-toggle input:checked + .dsh-wf-toggle-track {
+  background-color: var(--dsw-alias-brand-primary, #4f6ef7);
+}
+.dsh-wf-toggle-thumb {
+  position: absolute;
+  height: 16px;
+  width: 16px;
+  left: 3px;
+  bottom: 3px;
+  background-color: white;
+  transition: .2s cubic-bezier(.4, 0, .2, 1);
+  border-radius: 50%;
+  box-shadow: 0 1px 3px rgba(0,0,0,0.2);
+}
+.dsh-wf-toggle input:checked + .dsh-wf-toggle-track .dsh-wf-toggle-thumb {
+  transform: translateX(18px);
+}
+.dsh-wf-footer {
+  margin-top: 8px;
+  padding-top: 10px;
+  border-top: 1px solid var(--dsw-alias-border-l2, rgba(118, 137, 166, 0.12));
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.dsh-wf-saved-hint {
+  font-size: 11.5px;
+  color: var(--dsw-alias-state-success-primary, #10b981);
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+.dsh-wf-btn-reset {
+  background: transparent;
+  border: 1px solid var(--dsw-alias-border-l2, #e5e7eb);
+  border-radius: 6px;
+  padding: 3px 10px;
+  font-size: 12px;
+  color: var(--dsw-alias-label-secondary, #6b7280);
+  cursor: pointer;
+  transition: all 0.15s;
+}
+.dsh-wf-btn-reset:hover {
+  background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.08));
+  color: var(--dsw-alias-label-primary, #1f2328);
+}
+`;
+			document.head.appendChild(style);
+		}
+		function WorkspaceFilesSettingsCard() {
+			const [open, setOpen] = (0, react.useState)(false);
+			const [config, setConfig] = (0, react.useState)(() => loadWorkspaceFilesConfig());
+			const [savedTick, setSavedTick] = (0, react.useState)(false);
+			(0, react.useEffect)(() => {
+				ensureSettingsStyle();
+			}, []);
+			const updateConfig = (patch) => {
+				const next = {
+					...config,
+					...patch
+				};
+				setConfig(next);
+				saveWorkspaceFilesConfig(next);
+				setSavedTick(true);
+				setTimeout(() => setSavedTick(false), 2e3);
+			};
+			const handleDepthSelect = (depth) => {
+				updateConfig({ maxDepth: depth });
+			};
+			const handleDepthInput = (e) => {
+				const val = parseInt(e.target.value, 10);
+				if (!isNaN(val) && val >= 1 && val <= 100) updateConfig({ maxDepth: val });
+			};
+			const handleToggleHidden = () => {
+				updateConfig({ showHidden: !config.showHidden });
+			};
+			const handleReset = () => {
+				const def = {
+					maxDepth: 16,
+					showHidden: false
+				};
+				setConfig(def);
+				saveWorkspaceFilesConfig(def);
+				setSavedTick(true);
+				setTimeout(() => setSavedTick(false), 2e3);
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: open ? "dsh-wf-card dsh-wf-card-open" : "dsh-wf-card",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					className: "dsh-wf-header",
+					"aria-expanded": open,
+					onClick: () => setOpen(!open),
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dsh-wf-head-text",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-wf-name",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "工作区文件" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dsh-wf-version",
+								children: "v0.3.0"
+							})]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dsh-wf-desc",
+							children: "浏览与检索工作区文件树，支持递归目录扫描与一键引用。"
+						})]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: open ? "dsh-wf-chevron dsh-wf-chevron-open" : "dsh-wf-chevron",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconChevronDown, { size: 14 })
+					})]
+				}), open && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dsh-wf-body",
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-wf-row",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dsh-wf-label-box",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dsh-wf-label",
+									children: "目录扫描最大深度"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dsh-wf-hint",
+									children: "工作区递归扫描的最大目录层级（默认 16，范围 1~100）。若工程目录较深可适当调大。"
+								})]
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dsh-wf-ctrl",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dsh-wf-seg",
+									children: [
+										8,
+										16,
+										32,
+										64
+									].map((d) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: config.maxDepth === d ? "dsh-wf-seg-btn dsh-wf-seg-active" : "dsh-wf-seg-btn",
+										onClick: () => handleDepthSelect(d),
+										children: d
+									}, d))
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "number",
+									min: "1",
+									max: "100",
+									className: "dsh-wf-input",
+									value: config.maxDepth,
+									onChange: handleDepthInput,
+									title: "自定义深度 (1-100)"
+								})]
+							})]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-wf-row",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dsh-wf-label-box",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dsh-wf-label",
+									children: "默认显示隐藏文件"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dsh-wf-hint",
+									children: "打开文件树时是否默认展示以点开头的隐藏文件或文件夹（如 .gitignore, .env 等）。"
+								})]
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dsh-wf-ctrl",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dsh-wf-toggle",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										type: "checkbox",
+										checked: config.showHidden,
+										onChange: handleToggleHidden
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dsh-wf-toggle-track",
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "dsh-wf-toggle-thumb" })
+									})]
+								})
+							})]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-wf-footer",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { children: savedTick ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dsh-wf-saved-hint",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconCheck, { size: 12 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "已保存设置" })]
+							}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: {
+									fontSize: 11,
+									color: "var(--dsw-alias-label-tertiary, #8b93a1)"
+								},
+								children: "设置改动即时生效并同步至工作区文件树"
+							}) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dsh-wf-btn-reset",
+								onClick: handleReset,
+								children: "恢复默认"
+							})]
+						})
+					]
+				})]
+			});
 		}
 		function WorkspaceFilesView({ sessionId, cwd, onOpenFile }) {
 			const [data, setData] = (0, react.useState)(null);
@@ -317,13 +751,24 @@ window.__ModuleLoader__.load({
 			const [query, setQuery] = (0, react.useState)("");
 			const [toast, setToast] = (0, react.useState)(null);
 			const [expandedPaths, setExpandedPaths] = (0, react.useState)(() => /* @__PURE__ */ new Set());
-			const [showHidden, setShowHidden] = (0, react.useState)(false);
+			const [activeConfig, setActiveConfig] = (0, react.useState)(() => loadWorkspaceFilesConfig());
+			const [showHidden, setShowHidden] = (0, react.useState)(() => loadWorkspaceFilesConfig().showHidden);
 			const toastTimer = (0, react.useRef)(null);
 			const showToastMsg = (0, react.useCallback)((msg) => {
 				setToast(msg);
 				if (toastTimer.current) window.clearTimeout(toastTimer.current);
 				toastTimer.current = window.setTimeout(() => setToast(null), 2e3);
 			}, []);
+			(0, react.useEffect)(() => {
+				const handleCfgChange = (e) => {
+					if (e.detail) {
+						setActiveConfig(e.detail);
+						setShowHidden(Boolean(e.detail.showHidden));
+					}
+				};
+				window.addEventListener("dsh-workspace-files:config-change", handleCfgChange);
+				return () => window.removeEventListener("dsh-workspace-files:config-change", handleCfgChange);
+			}, []);
 			const loadTree = (0, react.useCallback)(async (quiet = false) => {
 				if (!quiet) setLoading(true);
 				setError(null);
@@ -331,7 +776,8 @@ window.__ModuleLoader__.load({
 					const res = await call("files.tree", {
 						sessionId,
 						cwd,
-						showHidden
+						showHidden,
+						maxDepth: activeConfig.maxDepth
 					});
 					setData(res);
 					setExpandedPaths((prev) => {
@@ -348,7 +794,8 @@ window.__ModuleLoader__.load({
 			}, [
 				sessionId,
 				cwd,
-				showHidden
+				showHidden,
+				activeConfig.maxDepth
 			]);
 			(0, react.useEffect)(() => {
 				loadTree();
@@ -1624,8 +2071,11 @@ window.__ModuleLoader__.load({
 ` });
 		}
 		//#endregion
+		exports.WorkspaceFilesSettingsCard = WorkspaceFilesSettingsCard;
 		exports.apply = apply;
 		exports.inject = inject;
+		exports.loadWorkspaceFilesConfig = loadWorkspaceFilesConfig;
+		exports.saveWorkspaceFilesConfig = saveWorkspaceFilesConfig;
 		return module.exports;
 	}
 });