@rooode/dsh-plugin-preview 0.1.5 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +52 -55
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,46 +1,54 @@
1
- # DeepSeek Harness - 右侧 Markdown 文档预览插件 (`@rooode/dsh-plugin-preview`)
1
+ # DeepSeek Harness - 多功能文档与工作空间代码预览插件 (`@rooode/dsh-plugin-preview`)
2
2
 
3
3
  [![npm version](https://img.shields.io/npm/v/@rooode/dsh-plugin-preview.svg?style=flat-square)](https://www.npmjs.com/package/@rooode/dsh-plugin-preview)
4
4
  [![license](https://img.shields.io/npm/l/@rooode/dsh-plugin-preview.svg?style=flat-square)](https://github.com/rooode)
5
5
 
6
- 本插件为 **DeepSeek Harness (DSH)** 与 **WorkBuddy** 对话界面提供了参考 WorkBuddy `FileTabs` 设计的**右侧多标签 Markdown 与文档预览面板**。
6
+ 本插件为 **DeepSeek Harness (DSH)** 与 **WorkBuddy** 对话界面提供了参考 WorkBuddy `FileTabs` 设计的**右侧多标签 Markdown、代码与工作空间文件树浏览器**。
7
7
 
8
- 在 DSH 中，大模型经常会生成、改写或读取 `.md` 文档。默认情况下，点击生成的文档链接会直接调用 Windows 系统的本地记事本 (Notepad) 打开，打断了用户在 Web 会话中的阅读与操作体验。通过安装本插件，点击任何 Markdown 文档将直接在**右侧滑出多标签预览抽屉**，提供富文本渲染、目录大纲、源码分栏、一键复制、实时刷新以及按需本地打开等全套能力。
8
+ 在 DSH 中，大模型经常会生成、改写或读取 `.md` 文档与各类代码文件。默认情况下，点击生成的文档链接会直接调用 Windows 系统的本地记事本 (Notepad) 打开，打断了用户在 Web 会话中的阅读与操作体验。通过安装本插件，点击任何文档或代码将直接在**右侧滑出多标签预览抽屉**，提供工作空间目录树浏览、多语言代码高亮与符号大纲、JSON 交互结构树、GFM 富文本渲染、一键复制、实时刷新以及按需本地打开等全套能力。
9
9
 
10
10
  ---
11
11
 
12
12
  ## 🌟 核心特性 (Features)
13
13
 
14
- 1. **自动拦截与无感打开**：
15
- - 自动拦截对话底部 **产出文件行 (`ProducedFiles`)**、**工具执行行 (`ToolRow`)** 以及对话正文中的所有 `.md`、`.markdown`、`.txt`、`.json` 等文档点击。
16
- - 不再弹出本地记事本，直接在右侧平滑滑出预览面板。
17
-
18
- 2. **右侧多标签页支持 (FileTabs)**：
19
- - 支持同时打开多个文档，标签栏清晰展示文件图标、文档名、修改标记与独立关闭按钮。
20
- - 支持快速切换激活标签、一键全部关闭。
21
- - 左侧边框支持 **鼠标自由拖拽调节宽度 (ResizeHandle)**（支持 380px 至 90vw 自由调整）。
22
-
23
- 3. **全功能 GFM Markdown 渲染引擎**：
24
- - **三模视图切换**：
25
- - 📖 **渲染预览 (Preview)**：排版精美的富文本 Markdown 渲染。
26
- - 📝 **源码模式 (Source)**：带行号与等宽字体的 Markdown 原文。
27
- - 🌓 **分栏对比 (Split)**：左右双栏并排对照。
14
+ 1. **📁 工作空间目录树浏览器 (Workspace Tree Explorer)**：
15
+ - 树状层级展开/折叠项目所有目录与文件，支持文件大小与修改时间展示。
16
+ - 文件名即时过滤搜索，自动展开命中路径并折叠无关项。
17
+ - 快捷折叠全部目录、一键刷新磁盘目录结构。
18
+ - 目录树宽度支持鼠标自由拖拽调节。
19
+
20
+ 2. **💡 对话区智能交互与自动收起**：
21
+ - 当预览抽屉处于打开状态时，点击左侧会话列表或对话输入框，抽屉自动平滑收起/隐藏，保证专注对话输入。
22
+ - 收起后右下角保留胶囊浮窗，一键随时恢复展开。
23
+
24
+ 3. **🌳 交互式 JSON 结构树检查器 (JSON Tree Inspector)**：
25
+ - `.json` 文件默认以交互结构树呈现，支持 `Object{N}` 与 `Array[N]` 多层级折叠展开。
26
+ - 属性名与属性值即时过滤搜索。
27
+ - 单击快捷复制指定字段路径（如 `scripts.build`）或字段值。
28
+ - 提供 `⚡ 格式化 (2空格对齐)` 与 `🗜️ 压缩 (单行)` 快捷操作，并支持随时切换至高亮代码模式。
29
+
30
+ 4. **🌐 多语言语法高亮与符号大纲 (Polyglot Highlighting & Symbol TOC)**：
31
+ - 采用单趟扫描分词器（Single-Pass Tokenizer），杜绝 HTML 嵌套污染。
32
+ - **全面支持主流语言**：
33
+ - ☕ **Java**：注解（`@Service`, `@Autowired`, `@Override`）、泛型、集合类、文本块、Package/Class/Method 符号大纲。
34
+ - ⚙️ **C / C++**：预处理指令（`#include <...>`）、命名空间、模板、标准库类型、智能指针、Namespace/Class/Struct/Function 符号大纲。
35
+ - 🐍 **Python**：装饰器（`@dataclass`, `@property`）、多行 Docstrings、异步协程（`async def`）、类型标注、Class/Def 符号大纲。
36
+ - ⚡ **JavaScript / TypeScript**：ES 模块、JSX 标签、接口/枚举、模板字符串、箭头函数、Class/Fn/Type/Export 符号大纲。
37
+ - 🦀 **Rust** / 🌐 **Go** / ⌨️ **Shell** / 🗄️ **SQL** / ⚙️ **YAML** / 📝 **Markdown** 等。
38
+ - **大纲点击平滑跳转**：点击大纲侧栏任一项，代码区域自动平滑滚动定位至目标代码行，并在行号及对应行触发高亮闪烁反馈。
39
+ - **代码排版优化**：默认水平滚动，点击 `↩️ 换行` 可在单行与自动折行（`overflow-wrap: break-word`）间无缝切换，杜绝单词被撕裂打碎。
40
+
41
+ 5. **📖 全功能 GFM Markdown 渲染引擎**：
42
+ - **三模视图切换**：📖 渲染预览 (Preview) / 📝 源码模式 (Source) / 🌓 分栏对比 (Split)。
28
43
  - **GitHub Alerts 提示框**：完整支持 `> [!NOTE]`、`> [!TIP]`、`> [!IMPORTANT]`、`> [!WARNING]`、`> [!CAUTION]` 彩色卡片渲染。
29
- - **代码块语法高亮**：支持 JavaScript/TypeScript、Python、JSON、Bash、HTML、CSS 等多种语言关键字高亮，顶部附带语言标识与**一键复制代码**按钮。
30
44
  - **LaTeX 数学公式**：支持 `$inline$` 与 `$$block$$` 数学公式排版。
31
45
  - **数据表格与任务清单**：斑马纹表格自适应排版、交互式勾选框列表。
32
- - **目录大纲导航 (TOC)**：自动提取 H1~H6 标题生成侧栏目录，点击平滑滚动跳转至对应章节。
46
+ - **目录大纲导航 (TOC)**：自动提取 H1~H6 标题生成侧栏目录，点击平滑滚动跳转。
33
47
 
34
- 4. **实用操作工具栏**：
35
- - 📋 **一键复制 (Copy)**：一键复制完整 Markdown 内容至系统剪贴板。
36
- - 🔄 **实时刷新 (Refresh)**：重新从磁盘加载最新文件内容（Agent 持续写入时可一键更新）。
37
- - 🖥️ **本地应用打开 (Open Native)**：若确需在系统外部编辑器（记事本/VSCode）中打开，可一键唤起。
38
- - 📁 **资源管理器中定位 (Reveal)**：一键调用系统资源管理器定位并高亮选中该文件。
39
- - 🔍 **文档内关键词搜索 (Find)**：快速高亮匹配文本。
40
- - ✕ **快捷收起与悬浮入口**：支持 Esc 快捷键关闭；收起后右下角保留胶囊浮窗，一键随时恢复展开。
41
-
42
- 5. **Node 端服务与安全保障**：
43
- - 配合 Node 端 Cordis `PreviewService`，提供 `/api/preview/read`、`/api/preview/reveal` 等 REST 路由，解决本地工作区文件跨目录读取与超大文件防护。
48
+ 6. **📑 右侧多标签页 (FileTabs)**：
49
+ - 支持同时打开多个文档与代码文件，标签栏展示对应语言彩色图标、文件名与独立关闭按钮。
50
+ - 支持快速切换激活标签、一键全部关闭。
51
+ - 左侧边框支持鼠标自由拖拽调节宽度（支持 380px 至 90vw 自由调整）。
44
52
 
45
53
  ---
46
54
 
@@ -67,32 +75,9 @@ npx @deepseek-ai/dsh web
67
75
 
68
76
  ---
69
77
 
70
- ## 📁 目录结构 (Directory Structure)
71
-
72
- ```text
73
- dsh-plugin-preview/
74
- ├── package.json # 插件元信息与 npm 脚本配置
75
- ├── cordis.patch.yml # DSH 组合包 patch 描述文件
76
- ├── tsconfig.json # TypeScript 编译配置
77
- ├── README.md # 插件说明文档
78
- ├── scripts/
79
- │ └── build.js # 自动构建、分发与补丁安装脚本
80
- ├── src/
81
- │ ├── types.ts # 核心 TypeScript 类型定义
82
- │ ├── service.ts # Node 端 PreviewService 服务 (HTTP 路由)
83
- │ ├── index.ts # Node 端 Cordis Service 注册与 Schema 导出
84
- │ └── client.js # Web 浏览器端 React 预览面板与拦截器
85
- └── lib/
86
- ├── index.js # Node ESM 导出产物
87
- ├── index.d.ts # 类型声明文件
88
- └── client.js # Web 端 ModuleLoader 加载产物
89
- ```
90
-
91
- ---
92
-
93
78
  ## ⚙️ 配置项说明 (Configuration)
94
79
 
95
- 可以在 `cordis.patch.yml` 或配置中自定义以下参数：
80
+ 可以在 `cordis.patch.yml` 或配置文件中自定义以下参数：
96
81
 
97
82
  ```yaml
98
83
  - id: ui-preview
@@ -106,12 +91,24 @@ dsh-plugin-preview/
106
91
  - .json
107
92
  - .yaml
108
93
  - .yml
94
+ - .js
95
+ - .ts
96
+ - .java
97
+ - .cpp
98
+ - .c
99
+ - .h
100
+ - .hpp
101
+ - .py
102
+ - .go
103
+ - .rs
104
+ - .sh
105
+ - .sql
109
106
  # 最大允许读取的文件大小 (MB)
110
107
  maxFileSizeMb: 10
111
- # 默认打开视图: 'preview' (预览) | 'source' (源码) | 'split' (分栏)
108
+ # 默认打开视图: 'preview' (预览) | 'source' (源码) | 'split' (分栏) | 'json-tree' (树) | 'code' (代码)
112
109
  defaultViewMode: preview
113
110
  # 右侧预览面板默认宽度 (px)
114
- defaultPanelWidth: 620
111
+ defaultPanelWidth: 760
115
112
  ```
116
113
 
117
114
  ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rooode/dsh-plugin-preview",
3
- "version": "0.1.5",
3
+ "version": "0.1.6",
4
4
  "description": "DeepSeek Harness Markdown 文档与工作空间文件浏览器右侧预览插件 (支持工作区文件树、JSON 交互结构树/格式化、Java/C++/Python/JS/TS/YAML/Go/Rust 多语言语法高亮与符号大纲、自动换行与多标签 FileTabs)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",