@civilization/dsh-workspace-files 0.2.0 → 0.3.0

package/src/client/icons.tsx

@@ -159,3 +159,11 @@ export function IconTree({ size = 13 }: { size?: number }): JSX.Element {
   )
 }
 
+export function IconChevronDown({ size = 14 }: { size?: number }): JSX.Element {
+  return (
+    <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 }}>
+      <polyline points="4 6 8 10 12 6" />
+    </svg>
+  )
+}
+

package/src/client/index.tsx

@@ -8,6 +8,7 @@ import {
   FileGlyphIcon,
   IconAt,
   IconCheck,
+  IconChevronDown,
   IconClose,
   IconCollapseAll,
   IconCopy,
@@ -111,6 +112,436 @@ export function apply(ctx: Context): void {
       key: OFFICIAL_FILES_TAB_ID,
     }, WorkspaceFilesTabTitle)), 'dsh-workspace-files: official tab title')
   }
+
+  // 注入设置中心“插件配置”卡片（命名空间必须为 workspace-files，与 Host settings 服务注册一致）
+  const registerSettingsCard = (targetCtx: any) => {
+    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 as any).inject) {
+    (ctx as any).inject(['settingsScope'], (scoped: any) => {
+      registerSettingsCard(scoped)
+    })
+  }
+}
+
+/* ── Workspace Files Configuration Store ── */
+export interface WorkspaceFilesConfig {
+  maxDepth: number
+  showHidden: boolean
+}
+
+const CONFIG_STORAGE_KEY = 'dsh_workspace_files_config'
+
+export function loadWorkspaceFilesConfig(): WorkspaceFilesConfig {
+  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 }
+}
+
+export function saveWorkspaceFilesConfig(cfg: WorkspaceFilesConfig): void {
+  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)
+}
+
+export function WorkspaceFilesSettingsCard(): JSX.Element {
+  const [open, setOpen] = useState(false)
+  const [config, setConfig] = useState<WorkspaceFilesConfig>(() => loadWorkspaceFilesConfig())
+  const [savedTick, setSavedTick] = useState(false)
+
+  useEffect(() => {
+    ensureSettingsStyle()
+  }, [])
+
+  const updateConfig = (patch: Partial<WorkspaceFilesConfig>) => {
+    const next = { ...config, ...patch }
+    setConfig(next)
+    saveWorkspaceFilesConfig(next)
+    setSavedTick(true)
+    setTimeout(() => setSavedTick(false), 2000)
+  }
+
+  const handleDepthSelect = (depth: number) => {
+    updateConfig({ maxDepth: depth })
+  }
+
+  const handleDepthInput = (e: React.ChangeEvent<HTMLInputElement>) => {
+    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), 2000)
+  }
+
+  return (
+    <div className={open ? 'dsh-wf-card dsh-wf-card-open' : 'dsh-wf-card'}>
+      <button
+        type="button"
+        className="dsh-wf-header"
+        aria-expanded={open}
+        onClick={() => setOpen(!open)}
+      >
+        <div className="dsh-wf-head-text">
+          <div className="dsh-wf-name">
+            <span>工作区文件</span>
+            <span className="dsh-wf-version">v0.3.0</span>
+          </div>
+          <div className="dsh-wf-desc">
+            浏览与检索工作区文件树，支持递归目录扫描与一键引用。
+          </div>
+        </div>
+        <span className={open ? 'dsh-wf-chevron dsh-wf-chevron-open' : 'dsh-wf-chevron'}>
+          <IconChevronDown size={14} />
+        </span>
+      </button>
+
+      {open && (
+        <div className="dsh-wf-body">
+          <div className="dsh-wf-row">
+            <div className="dsh-wf-label-box">
+              <div className="dsh-wf-label">目录扫描最大深度</div>
+              <div className="dsh-wf-hint">
+                工作区递归扫描的最大目录层级（默认 16，范围 1~100）。若工程目录较深可适当调大。
+              </div>
+            </div>
+            <div className="dsh-wf-ctrl">
+              <div className="dsh-wf-seg">
+                {[8, 16, 32, 64].map((d) => (
+                  <button
+                    key={d}
+                    type="button"
+                    className={config.maxDepth === d ? 'dsh-wf-seg-btn dsh-wf-seg-active' : 'dsh-wf-seg-btn'}
+                    onClick={() => handleDepthSelect(d)}
+                  >
+                    {d}
+                  </button>
+                ))}
+              </div>
+              <input
+                type="number"
+                min="1"
+                max="100"
+                className="dsh-wf-input"
+                value={config.maxDepth}
+                onChange={handleDepthInput}
+                title="自定义深度 (1-100)"
+              />
+            </div>
+          </div>
+
+          <div className="dsh-wf-row">
+            <div className="dsh-wf-label-box">
+              <div className="dsh-wf-label">默认显示隐藏文件</div>
+              <div className="dsh-wf-hint">
+                打开文件树时是否默认展示以点开头的隐藏文件或文件夹（如 .gitignore, .env 等）。
+              </div>
+            </div>
+            <div className="dsh-wf-ctrl">
+              <label className="dsh-wf-toggle">
+                <input
+                  type="checkbox"
+                  checked={config.showHidden}
+                  onChange={handleToggleHidden}
+                />
+                <span className="dsh-wf-toggle-track">
+                  <span className="dsh-wf-toggle-thumb" />
+                </span>
+              </label>
+            </div>
+          </div>
+
+          <div className="dsh-wf-footer">
+            <div>
+              {savedTick ? (
+                <span className="dsh-wf-saved-hint">
+                  <IconCheck size={12} />
+                  <span>已保存设置</span>
+                </span>
+              ) : (
+                <span style={{ fontSize: 11, color: 'var(--dsw-alias-label-tertiary, #8b93a1)' }}>
+                  设置改动即时生效并同步至工作区文件树
+                </span>
+              )}
+            </div>
+            <button
+              type="button"
+              className="dsh-wf-btn-reset"
+              onClick={handleReset}
+            >
+              恢复默认
+            </button>
+          </div>
+        </div>
+      )}
+    </div>
+  )
 }
 
 /* ── Main Workspace Files View ── */
@@ -129,7 +560,8 @@ function WorkspaceFilesView({
   const [query, setQuery] = useState('')
   const [toast, setToast] = useState<string | null>(null)
   const [expandedPaths, setExpandedPaths] = useState<Set<string>>(() => new Set())
-  const [showHidden, setShowHidden] = useState(false)
+  const [activeConfig, setActiveConfig] = useState<WorkspaceFilesConfig>(() => loadWorkspaceFilesConfig())
+  const [showHidden, setShowHidden] = useState(() => loadWorkspaceFilesConfig().showHidden)
 
   const toastTimer = useRef<number | null>(null)
 
@@ -139,11 +571,27 @@ function WorkspaceFilesView({
     toastTimer.current = window.setTimeout(() => setToast(null), 2000)
   }, [])
 
+  useEffect(() => {
+    const handleCfgChange = (e: any) => {
+      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 = useCallback(async (quiet = false) => {
     if (!quiet) setLoading(true)
     setError(null)
     try {
-      const res = await call<WorkspaceFilesResult>('files.tree', { sessionId, cwd, showHidden })
+      const res = await call<WorkspaceFilesResult>('files.tree', {
+        sessionId,
+        cwd,
+        showHidden,
+        maxDepth: activeConfig.maxDepth,
+      })
       setData(res)
 
       // 默认折叠，并从 localStorage 恢复已记录的展开状态
@@ -159,7 +607,7 @@ function WorkspaceFilesView({
     } finally {
       if (!quiet) setLoading(false)
     }
-  }, [sessionId, cwd, showHidden])
+  }, [sessionId, cwd, showHidden, activeConfig.maxDepth])
 
   useEffect(() => {
     void loadTree()

package/src/files.ts

@@ -39,7 +39,7 @@ export async function scanWorkspaceTree(
   options: { maxDepth?: number; showHidden?: boolean; showIgnored?: boolean } = {},
 ): Promise<WorkspaceFilesResult> {
   const root = resolve(cwd)
-  const maxDepth = options.maxDepth ?? 8
+  const maxDepth = options.maxDepth ?? 16
   const showHidden = options.showHidden ?? false
   const showIgnored = options.showIgnored ?? false
 

package/src/index.ts

@@ -1,9 +1,20 @@
 import type { Context } from '@deepseek-ai/cordis'
+import Schema from '@deepseek-ai/schemastery'
 import { scanWorkspaceTree } from './files.js'
 
 export const name = '@civilization/dsh-workspace-files'
 export const inject = ['webServer']
 
+export interface Config {
+  maxDepth?: number
+  showHidden?: boolean
+}
+
+export const Config: Schema<Config> = Schema.object({
+  maxDepth: Schema.natural().min(1).max(100).default(16).description('工作区文件树扫描的最大文件夹深度（层级）'),
+  showHidden: Schema.boolean().default(false).description('默认是否显示以点开头的隐藏文件'),
+}).description('工作区文件：浏览与检索工作区文件树')
+
 async function readJsonBody(req: any): Promise<Record<string, any>> {
   if (req.body && typeof req.body === 'object') {
     return req.body
@@ -79,7 +90,34 @@ function resolveCwd(ctx: Context, body: Record<string, any>): string {
   return process.cwd()
 }
 
-export function apply(ctx: Context): void {
+export const SETTINGS_NS = 'workspace-files'
+
+export function apply(ctx: Context, config: Config = {}): void {
+  const liveConfig = {
+    maxDepth: typeof config?.maxDepth === 'number' && config.maxDepth > 0 ? config.maxDepth : 16,
+    showHidden: Boolean(config?.showHidden),
+  }
+
+  // 关键：向 Host 的 settings 服务注册 settings namespace，使设置面板的前端控制器能够枚举到此插件卡片
+  if ((ctx as any).inject) {
+    (ctx as any).inject(['settings'], (scopedCtx: any) => {
+      try {
+        const scope = scopedCtx.settings?.register(SETTINGS_NS, Config, {
+          base: liveConfig,
+        })
+        const applyChange = () => {
+          const current = scope?.get?.()
+          if (typeof current?.maxDepth === 'number') liveConfig.maxDepth = current.maxDepth
+          if (typeof current?.showHidden === 'boolean') liveConfig.showHidden = current.showHidden
+        }
+        applyChange()
+        scope?.watch?.(applyChange)
+      } catch (err) {
+        console.warn('[dsh-workspace-files] failed to register settings scope:', err)
+      }
+    })
+  }
+
   const webServer = (ctx as any).webServer
   if (!webServer) return
 
@@ -92,6 +130,23 @@ export function apply(ctx: Context): void {
     const pathname = new URL(req.url ?? '/', 'http://dsh.internal').pathname
     const method = pathname.startsWith(prefix) ? pathname.slice(prefix.length) : undefined
 
+    if (method === 'config.get') {
+      writeJson(res, 200, { ok: true, value: liveConfig })
+      return
+    }
+
+    if (method === 'config.set') {
+      try {
+        const body = await readJsonBody(req)
+        if (typeof body.maxDepth === 'number' && body.maxDepth > 0) liveConfig.maxDepth = body.maxDepth
+        if (typeof body.showHidden === 'boolean') liveConfig.showHidden = body.showHidden
+        writeJson(res, 200, { ok: true, value: liveConfig })
+      } catch (err: any) {
+        writeJson(res, 500, { ok: false, error: { message: err?.message || String(err) } })
+      }
+      return
+    }
+
     if (method !== 'files.tree') {
       writeJson(res, 404, { ok: false, error: { message: `Unknown method: ${method}` } })
       return
@@ -101,9 +156,9 @@ export function apply(ctx: Context): void {
       const body = await readJsonBody(req)
       const cwd = resolveCwd(ctx, body)
       const result = await scanWorkspaceTree(cwd, {
-        showHidden: Boolean(body.showHidden),
+        showHidden: typeof body.showHidden === 'boolean' ? body.showHidden : liveConfig.showHidden,
         showIgnored: Boolean(body.showIgnored),
-        maxDepth: typeof body.maxDepth === 'number' ? body.maxDepth : 8,
+        maxDepth: typeof body.maxDepth === 'number' && body.maxDepth > 0 ? body.maxDepth : liveConfig.maxDepth,
       })
       writeJson(res, 200, { ok: true, value: result })
     } catch (err: any) {