@rooode/dsh-plugin-preview 0.1.20 → 0.1.21

package/lib/client.js

@@ -27,6 +27,7 @@
     const STORAGE_KEY_TREE_OPEN = 'dsh:preview:tree:open:v1';
     const STORAGE_KEY_TREE_WIDTH = 'dsh:preview:tree:width:v1';
     const STORAGE_KEY_MANUAL_WS = 'dsh:preview:manual_workspace:v1';
+    const STORAGE_KEY_SHOW_HIDDEN = 'dsh:preview:tree:show_hidden:v1';
     const DEFAULT_PANEL_WIDTH = 700;
     const MIN_PANEL_WIDTH = 380;
     const DEFAULT_TREE_WIDTH = 220;
@@ -55,6 +56,7 @@
     let globalIsPanelOpen = false;
     let globalIsTreeOpen = true;
     let globalIsMaximized = false;
+    let globalShowHidden = true;
     let globalManualWorkspace = null;
     let globalPanelWidth = DEFAULT_PANEL_WIDTH;
     let globalTreeWidth = DEFAULT_TREE_WIDTH;
@@ -73,6 +75,13 @@
       }
     } catch (e) {}
 
+    try {
+      const savedShowHidden = localStorage.getItem(STORAGE_KEY_SHOW_HIDDEN);
+      if (savedShowHidden !== null) {
+        globalShowHidden = savedShowHidden === 'true';
+      }
+    } catch (e) {}
+
     try {
       const savedWidth = localStorage.getItem(STORAGE_KEY_WIDTH);
       if (savedWidth) {
@@ -100,6 +109,14 @@
       }
     } catch (e) {}
 
+    function setGlobalShowHidden(show) {
+      globalShowHidden = !!show;
+      try {
+        localStorage.setItem(STORAGE_KEY_SHOW_HIDDEN, String(globalShowHidden));
+      } catch (e) {}
+      notifyStateChange();
+    }
+
     function loadAllWorkspaceTabsFromStorage() {
       try {
         const raw = localStorage.getItem(STORAGE_KEY_WS_TABS);
@@ -247,10 +264,23 @@
       return parts[parts.length - 1] || filePath;
     }
 
+    const KNOWN_TEXT_DOTFILES = new Set([
+      '.gitignore', '.gitattributes', '.gitmodules', '.gitconfig',
+      '.dockerignore', 'dockerfile', '.editorconfig',
+      '.prettierrc', '.eslintrc', '.eslintignore', '.prettierignore',
+      '.npmrc', '.nvmrc', '.yarnrc', '.babelrc', '.swcrc',
+      '.cursorrules', '.commitlintrc', '.env',
+      'license', 'makefile', 'gemfile', 'procfile', 'caddyfile'
+    ]);
+
     function isPreviewableFile(filePath) {
       if (!filePath) return false;
+      const cleanName = getFileName(filePath).toLowerCase();
+      if (KNOWN_TEXT_DOTFILES.has(cleanName) || cleanName.startsWith('.env')) return true;
       const ext = getFileExtension(filePath);
-      return SUPPORTED_EXTENSIONS.has(ext);
+      if (SUPPORTED_EXTENSIONS.has(ext)) return true;
+      if (cleanName.startsWith('.') && !['.png', '.jpg', '.jpeg', '.gif', '.zip', '.tar', '.gz', '.exe', '.dll', '.bin', '.pdf'].includes(ext)) return true;
+      return false;
     }
 
     function formatBytes(bytes) {
@@ -263,8 +293,20 @@
 
     function getFileIcon(node) {
       if (node.isDir) {
+        const dName = (node.name || '').toLowerCase();
+        if (dName === '.git') return { icon: '🌿', color: '#f05032' };
+        if (dName === '.github') return { icon: '🐙', color: '#8b5cf6' };
+        if (dName === '.vscode' || dName === '.idea' || dName === '.cursor') return { icon: '⚙️', color: '#38bdf8' };
         return { icon: '📁', color: '#eab308' };
       }
+      const rawName = (node.name || '').toLowerCase();
+      if (rawName.startsWith('.env')) return { icon: '🔒', color: '#10b981' };
+      if (rawName.startsWith('.git')) return { icon: '🌿', color: '#f05032' };
+      if (rawName === '.dockerignore' || rawName === 'dockerfile') return { icon: '🐳', color: '#2496ed' };
+      if (rawName.startsWith('.prettier') || rawName.startsWith('.eslint')) return { icon: '✨', color: '#f59e0b' };
+      if (rawName === '.npmrc' || rawName === '.nvmrc' || rawName === '.yarnrc') return { icon: '📦', color: '#cb3837' };
+      if (rawName === '.editorconfig' || rawName === '.cursorrules' || rawName === '.commitlintrc') return { icon: '⚙️', color: '#0284c7' };
+
       const ext = (node.extension || getFileExtension(node.name || node.path || '')).toLowerCase();
       if (ext === '.md' || ext === '.markdown') return { icon: '📝', color: '#0284c7' };
       if (ext === '.json') return { icon: '{ }', color: '#10b981' };
@@ -287,9 +329,16 @@
       return { icon: '📄', color: '#94a3b8' };
     }
 
-    
     function getFileTypeCategory(filePath) {
       if (!filePath) return 'text';
+      const cleanName = getFileName(filePath).toLowerCase();
+      if (cleanName.startsWith('.env') || cleanName === '.gitignore' || cleanName === '.gitattributes' || cleanName === '.dockerignore' || cleanName === '.editorconfig' || cleanName === '.npmrc' || cleanName === '.nvmrc' || cleanName === '.cursorrules') return 'config';
+      if (cleanName.startsWith('.prettier') || cleanName.startsWith('.eslint')) {
+        if (cleanName.endsWith('.json')) return 'json';
+        if (cleanName.endsWith('.js') || cleanName.endsWith('.cjs')) return 'javascript';
+        if (cleanName.endsWith('.yml') || cleanName.endsWith('.yaml')) return 'yaml';
+        return 'json';
+      }
       const ext = getFileExtension(filePath).toLowerCase();
       if (['.md', '.markdown', '.mdown', '.mkdn', '.mdwn'].includes(ext)) return 'markdown';
       if (['.json', '.jsonc', '.json5', '.geojson', '.lock'].includes(ext)) return 'json';
@@ -1278,6 +1327,41 @@
       );
     }
 
+    function IconEye() {
+      return h('svg', {
+        width: 13,
+        height: 13,
+        viewBox: '0 0 16 16',
+        fill: 'none',
+        stroke: 'currentColor',
+        strokeWidth: 1.4,
+        strokeLinecap: 'round',
+        strokeLinejoin: 'round',
+        style: { display: 'block', flexShrink: 0 }
+      },
+        h('path', { d: 'M1.5 8s2.5-4.5 6.5-4.5 6.5 4.5 6.5 4.5-2.5 4.5-6.5 4.5S1.5 8 1.5 8z' }),
+        h('circle', { cx: 8, cy: 8, r: 2.2 })
+      );
+    }
+
+    function IconEyeOff() {
+      return h('svg', {
+        width: 13,
+        height: 13,
+        viewBox: '0 0 16 16',
+        fill: 'none',
+        stroke: 'currentColor',
+        strokeWidth: 1.4,
+        strokeLinecap: 'round',
+        strokeLinejoin: 'round',
+        style: { display: 'block', flexShrink: 0 }
+      },
+        h('path', { d: 'M2 8s2.2-3.8 6-3.8c1.5 0 2.8.6 3.9 1.5M14 8s-2.2 3.8-6 3.8c-1.5 0-2.8-.6-3.9-1.5' }),
+        h('circle', { cx: 8, cy: 8, r: 2.2 }),
+        h('line', { x1: 2, y1: 2, x2: 14, y2: 14 })
+      );
+    }
+
     function IconChevronRight() {
       return h('svg', {
         width: 9,
@@ -1453,7 +1537,7 @@
       );
     }
 
-    function TreeContextMenu({ x, y, node, isRoot, clipboard, onAction, onClose }) {
+    function TreeContextMenu({ x, y, node, isRoot, showHidden, clipboard, onAction, onClose }) {
       const menuRef = useRef(null);
       useEffect(() => {
         const handleDown = (e) => {
@@ -1535,6 +1619,12 @@
           )
         ] : null,
 
+        h('div', { key: 'div-hidden', className: 'dsh-menu-divider' }),
+        h('div', { key: 'toggle-hidden', className: 'dsh-menu-item', onClick: () => { onClose(); onAction('toggle-hidden'); } },
+          h('span', { className: 'dsh-menu-icon' }, showHidden ? '👁️' : '🙈'),
+          h('span', null, showHidden ? '隐藏点文件与隐藏项' : '显示点文件与隐藏项')
+        ),
+
         isRoot ? [
           h('div', { key: 'refresh', className: 'dsh-menu-item', onClick: () => { onClose(); onAction('refresh'); } },
             h('span', { className: 'dsh-menu-icon' }, '🔄'),
@@ -1636,7 +1726,7 @@
 
       return h(Fragment, null,
         h('div', {
-          className: `dsh-tree-node-row ${isDir ? 'is-dir' : 'is-file'} ${isActive ? 'active' : ''} ${isDropTarget ? 'drop-target' : ''} ${isDragged ? 'is-dragged' : ''} ${isCut ? 'is-cut' : ''}`,
+          className: `dsh-tree-node-row ${isDir ? 'is-dir' : 'is-file'} ${isActive ? 'active' : ''} ${isDropTarget ? 'drop-target' : ''} ${isDragged ? 'is-dragged' : ''} ${isCut ? 'is-cut' : ''} ${node.isHidden ? 'is-hidden' : ''}`,
           style: indentStyle,
           onClick: handleClick,
           onContextMenu: handleContextMenu,
@@ -1646,7 +1736,7 @@
           onDragOver: handleDragOver,
           onDragLeave: handleDragLeave,
           onDrop: handleDrop,
-          title: `${node.name}\n${node.path}${node.size ? ' (' + formatBytes(node.size) + ')' : ''}`,
+          title: `${node.name}${node.isHidden ? ' (隐藏项)' : ''}\n${node.path}${node.size ? ' (' + formatBytes(node.size) + ')' : ''}`,
         },
           // Chevron indicator for directory
           isDir ? h('span', {
@@ -1773,6 +1863,7 @@
       const [clipboard, setClipboard] = useState(null); // { action: 'cut', path: string, name: string, isDir: boolean } | null
 
       const [currentWs, setCurrentWs] = useState(getCurrentWorkspaceRoot());
+      const [showHidden, setShowHidden] = useState(globalShowHidden);
 
       useEffect(() => {
         const handleStateUpdate = () => {
@@ -1780,10 +1871,13 @@
           if (newWs !== currentWs) {
             setCurrentWs(newWs);
           }
+          if (globalShowHidden !== showHidden) {
+            setShowHidden(globalShowHidden);
+          }
         };
         stateListeners.add(handleStateUpdate);
         return () => stateListeners.delete(handleStateUpdate);
-      }, [currentWs]);
+      }, [currentWs, showHidden]);
 
       const loadTree = useCallback(async (force = false, targetWs) => {
         setIsLoading(true);
@@ -1795,26 +1889,29 @@
             return;
           }
           const query = encodeURIComponent(rootPath);
-          const res = await fetch(`/api/preview/workspace-tree?path=${query}`);
+          const res = await fetch(`/api/preview/workspace-tree?path=${query}&showHidden=${showHidden}`);
           if (!res.ok) throw new Error(`HTTP ${res.status}`);
           const json = await res.json();
           if (!json.ok) throw new Error(json?.error?.message || '读取工作区目录失败');
           setTreeData(json);
-          // By default expand top 1 level directories
+          // By default expand top 1 level directories if not already expanded
           if (json.tree) {
             const topDirs = json.tree.filter(n => n.isDir).map(n => n.path);
-            setExpandedPaths(new Set(topDirs));
+            setExpandedPaths(prev => {
+              if (prev.size === 0) return new Set(topDirs);
+              return prev;
+            });
           }
         } catch (err) {
           setError(err.message || '加载工作空间文件树失败');
         } finally {
           setIsLoading(false);
         }
-      }, [currentWs]);
+      }, [currentWs, showHidden]);
 
       useEffect(() => {
         loadTree(false, currentWs);
-      }, [loadTree, currentWs, globalManualWorkspace]);
+      }, [loadTree, currentWs, showHidden, globalManualWorkspace]);
 
       const handleToggleExpand = (dirPath) => {
         setExpandedPaths(prev => {
@@ -2061,11 +2158,20 @@
           if (node) triggerOpenNative(node.path);
         } else if (action === 'delete') {
           if (node) handleDelete(node);
+        } else if (action === 'toggle-hidden') {
+          handleToggleShowHidden();
         } else if (action === 'refresh') {
           loadTree(true);
         }
       };
 
+      const handleToggleShowHidden = () => {
+        const next = !showHidden;
+        setShowHidden(next);
+        setGlobalShowHidden(next);
+        showToast(next ? '已开启显示隐藏文件与点文件' : '已隐藏点文件与隐藏项', 'info');
+      };
+
       const rootPath = treeData?.workspaceRoot || currentWs;
       const isCreatingAtRoot = creatingItem && creatingItem.parentPath && rootPath && creatingItem.parentPath.replace(/\\/g, '/').toLowerCase() === rootPath.replace(/\\/g, '/').toLowerCase();
       const isRootDropTarget = dragOverNode && rootPath && dragOverNode.path && dragOverNode.path.replace(/\\/g, '/').toLowerCase() === rootPath.replace(/\\/g, '/').toLowerCase();
@@ -2098,6 +2204,12 @@
               onClick: () => handleStartCreate(rootPath, 'dir'),
               title: '新建文件夹 (在根目录)',
             }, h(IconNewFolder)),
+            h('button', {
+              type: 'button',
+              className: `dsh-tree-action-btn ${showHidden ? 'active' : ''}`,
+              onClick: handleToggleShowHidden,
+              title: showHidden ? '隐藏点文件与隐藏项 (当前已显示)' : '显示点文件与隐藏项 (当前已隐藏)',
+            }, showHidden ? h(IconEye) : h(IconEyeOff)),
             h('button', {
               type: 'button',
               className: 'dsh-tree-action-btn',
@@ -2289,6 +2401,7 @@
           y: contextMenu.y,
           node: contextMenu.node,
           isRoot: contextMenu.isRoot,
+          showHidden,
           clipboard,
           onAction: handleContextMenuAction,
           onClose: () => setContextMenu(null),
@@ -5609,6 +5722,10 @@
           background: rgba(255, 255, 255, 0.1);
           color: #ffffff;
         }
+        .dsh-tree-action-btn.active {
+          color: var(--dsw-static-deepseek-500, #3b82f6);
+          background: rgba(59, 130, 246, 0.12);
+        }
 
         .dsh-tree-sidebar-search {
           padding: 6px 8px;
@@ -5724,6 +5841,13 @@
           background: rgba(56, 189, 248, 0.16);
           color: #38bdf8;
         }
+        .dsh-tree-node-row.is-hidden {
+          opacity: 0.72;
+        }
+        .dsh-tree-node-row.is-hidden:hover,
+        .dsh-tree-node-row.is-hidden.active {
+          opacity: 1;
+        }
 
         .dsh-tree-chevron {
           width: 14px;

package/lib/index.js

@@ -29,7 +29,7 @@ export class PreviewService extends Service {
             handler: this.handleHttpRequest.bind(this),
           });
         });
-        console.log('[PreviewService] Registered /api/preview route on webServer (v0.1.20)');
+        console.log('[PreviewService] Registered /api/preview route on webServer (v0.1.21)');
       } else {
         console.warn('[PreviewService] webServer not available yet in ctx');
       }
@@ -130,7 +130,19 @@ export class PreviewService extends Service {
     });
   }
 
-  readWorkspaceTree(targetDir, maxDepth = 4, includeAll = false) {
+  isAllowedDotfile(name) {
+    const lower = name.toLowerCase();
+    if (lower.startsWith('.env')) return true;
+    if (lower.startsWith('.gitignore') || lower.startsWith('.dockerignore') || lower.startsWith('.npmignore')) return true;
+    if (lower.startsWith('.prettier') || lower.startsWith('.eslint') || lower.startsWith('.stylelint') || lower.startsWith('.editorconfig')) return true;
+    if (lower.startsWith('.babel') || lower.startsWith('.swcrc') || lower.startsWith('.postcss') || lower.startsWith('.tailwind')) return true;
+    if (lower.startsWith('.vscode') || lower.startsWith('.github') || lower.startsWith('.husky')) return true;
+    if (lower.startsWith('.cursor') || lower.startsWith('.windsurf')) return true;
+    if (lower.startsWith('.npmrc') || lower.startsWith('.yarnrc') || lower.startsWith('.nvmrc') || lower.startsWith('.node-version')) return true;
+    return false;
+  }
+
+  readWorkspaceTree(targetDir, maxDepth = 4, includeAll = false, showHidden = false) {
     try {
       const normalizedRoot = path.resolve(targetDir);
       if (!fs.existsSync(normalizedRoot)) {
@@ -140,10 +152,10 @@ export class PreviewService extends Service {
       if (!stat.isDirectory()) {
         return { ok: false, error: { code: 'NOT_A_DIRECTORY', message: '目标路径不是目录: ' + normalizedRoot } };
       }
-      const ignoreDirs = new Set([
-        'node_modules', '.git', '.dsh', '.gemini', '.tempmediastorage', '.idea', '.vscode',
-        'dist', 'build', 'coverage', '.next', '.nuxt', '.output', '.turbo', '.cache',
-        '__pycache__', '.pytest_cache', 'target', 'vendor'
+      const defaultIgnoreDirs = new Set([
+        'node_modules', 'dist', 'build', 'coverage', '.next', '.nuxt', '.output', '.turbo', '.cache',
+        '__pycache__', '.pytest_cache', 'target', 'vendor', 'tmp', 'temp',
+        '.dsh', '.gemini', '.idea', '.tempmediastorage', '.git'
       ]);
       let totalFiles = 0;
       let totalDirs = 0;
@@ -160,10 +172,18 @@ export class PreviewService extends Service {
         for (const entry of entries) {
           const entryName = entry.name;
           const lowerName = entryName.toLowerCase();
+          const isHidden = entryName.startsWith('.') || entryName.startsWith('~$');
+
           if (!includeAll) {
-            if (ignoreDirs.has(lowerName)) continue;
-            if (entryName.startsWith('.') && entryName !== '.env' && entryName !== '.gitignore') continue;
+            if (!showHidden) {
+              if (defaultIgnoreDirs.has(lowerName)) continue;
+              if (lowerName === '.git' || lowerName === '.dsh' || lowerName === '.gemini' || lowerName === '.idea') continue;
+              if (isHidden && !this.isAllowedDotfile(entryName)) continue;
+            } else {
+              if (lowerName === 'node_modules' || lowerName === '__pycache__' || lowerName === '.pytest_cache') continue;
+            }
           }
+
           const fullPath = path.join(dirPath, entryName);
           const relPath = path.relative(normalizedRoot, fullPath).replace(/\\/g, '/');
           try {
@@ -175,6 +195,7 @@ export class PreviewService extends Service {
                 path: fullPath,
                 relativePath: relPath,
                 isDir: true,
+                isHidden,
                 children,
                 childCount: children.length,
               });
@@ -193,6 +214,7 @@ export class PreviewService extends Service {
                 path: fullPath,
                 relativePath: relPath,
                 isDir: false,
+                isHidden,
                 extension: ext,
                 size,
                 mtime,
@@ -222,21 +244,34 @@ export class PreviewService extends Service {
     }
   }
 
-  listDirectoryEntries(targetDir, includeAll = false) {
+  listDirectoryEntries(targetDir, includeAll = false, showHidden = false) {
     try {
       const normalized = path.resolve(targetDir);
       if (!fs.existsSync(normalized) || !fs.statSync(normalized).isDirectory()) {
         return { ok: false, error: { code: 'DIR_NOT_FOUND', message: '目录不存在' } };
       }
-      const ignoreDirs = new Set(['node_modules', '.git', '.dsh', '.gemini', '.tempmediastorage', '.idea', '.vscode']);
+      const defaultIgnoreDirs = new Set([
+        'node_modules', 'dist', 'build', 'coverage', '.next', '.nuxt', '.output', '.turbo', '.cache',
+        '__pycache__', '.pytest_cache', 'target', 'vendor', 'tmp', 'temp',
+        '.dsh', '.gemini', '.idea', '.tempmediastorage', '.git'
+      ]);
       const rawEntries = fs.readdirSync(normalized, { withFileTypes: true });
       const nodes = [];
       for (const entry of rawEntries) {
         const name = entry.name;
+        const lowerName = name.toLowerCase();
+        const isHidden = name.startsWith('.') || name.startsWith('~$');
+
         if (!includeAll) {
-          if (ignoreDirs.has(name.toLowerCase())) continue;
-          if (name.startsWith('.') && name !== '.env' && name !== '.gitignore') continue;
+          if (!showHidden) {
+            if (defaultIgnoreDirs.has(lowerName)) continue;
+            if (lowerName === '.git' || lowerName === '.dsh' || lowerName === '.gemini' || lowerName === '.idea') continue;
+            if (isHidden && !this.isAllowedDotfile(name)) continue;
+          } else {
+            if (lowerName === 'node_modules' || lowerName === '__pycache__' || lowerName === '.pytest_cache') continue;
+          }
         }
+
         const fullPath = path.join(normalized, name);
         const isDir = entry.isDirectory();
         let size = 0;
@@ -255,6 +290,7 @@ export class PreviewService extends Service {
           path: fullPath,
           relativePath: name,
           isDir,
+          isHidden,
           extension: ext,
           size,
           mtime,
@@ -425,7 +461,8 @@ export class PreviewService extends Service {
         const targetPath = url.searchParams.get('path') || process.cwd();
         const depth = parseInt(url.searchParams.get('depth') || '4', 10);
         const includeAll = url.searchParams.get('includeAll') === 'true';
-        const result = this.readWorkspaceTree(targetPath, isNaN(depth) ? 4 : depth, includeAll);
+        const showHidden = url.searchParams.get('showHidden') === 'true';
+        const result = this.readWorkspaceTree(targetPath, isNaN(depth) ? 4 : depth, includeAll, showHidden);
         res.statusCode = result.ok ? 200 : 404;
         res.end(JSON.stringify(result));
         return;
@@ -433,7 +470,8 @@ export class PreviewService extends Service {
       if (pathname === '/api/preview/list-dir' && req.method === 'GET') {
         const targetPath = url.searchParams.get('path') || process.cwd();
         const includeAll = url.searchParams.get('includeAll') === 'true';
-        const result = this.listDirectoryEntries(targetPath, includeAll);
+        const showHidden = url.searchParams.get('showHidden') === 'true';
+        const result = this.listDirectoryEntries(targetPath, includeAll, showHidden);
         res.statusCode = result.ok ? 200 : 404;
         res.end(JSON.stringify(result));
         return;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rooode/dsh-plugin-preview",
-  "version": "0.1.20",
-  "description": "DeepSeek Harness Markdown 文档与工作空间文件浏览器右侧预览插件 (支持工作区文件树、文件夹创建与文件移动、JSON 交互结构树/格式化、Java/C++/Python/JS/TS/YAML/Go/Rust 多语言语法高亮与符号大纲、自动换行与多标签 FileTabs)",
+  "version": "0.1.21",
+  "description": "DeepSeek Harness Markdown 文档与工作空间文件浏览器右侧预览插件 (支持查看/切换隐藏文件与点文件、工作区文件树、文件夹创建与文件移动、JSON 交互结构树/格式化、Java/C++/Python/JS/TS/YAML/Go/Rust 多语言语法高亮与符号大纲、自动换行与多标签 FileTabs)",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",