@dengsixue/dsh-file-menu 0.0.0-stage → 1.0.1

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 dengsixue
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,74 @@
1
- # Temporary Holding Version
1
+ # @dengsixue/dsh-file-menu
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ > DeepSeek Harness (DSH) 聊天区文件超链接右键上下文菜单增强插件。
4
+
5
+ [![npm](https://img.shields.io/npm/v/@dengsixue/dsh-file-menu.svg)](https://www.npmjs.com/package/@dengsixue/dsh-file-menu)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
7
+ [![DSH Plugin](https://img.shields.io/badge/DSH-Plugin-brightgreen.svg)](https://github.com/topics/dsh-plugin)
8
+
9
+ 在 DeepSeek Harness 对话区域中,右键点击本地文件超链接、文件引用标签(Chip)、代码块文件路径时,提供类似操作系统原生体验的快捷操作上下文菜单。
10
+
11
+ ![右键菜单截图](menu-preview.webp)
12
+
13
+ ---
14
+
15
+ ## ✨ 核心特性
16
+
17
+ - 🚀 **智能上次使用应用**:顶部第一行记忆上次用来打开该类型文件的应用,一键极速重开。
18
+ - 📂 **系统级打开方式**:
19
+ - **Windows**:自动解析系统注册表中的关联应用列表与 `OpenWithList`,使用 PowerShell 高性能批量提取对应高清应用图标。已修复 Electron 环境下外部应用(如 VS Code、Trae CN 等)继承 `ELECTRON_RUN_AS_NODE` 导致的唤起失效问题。
20
+ - **macOS**:通过 LaunchServices 提取与 Finder 完全一致的应用列表与图标。
21
+ - 🛡️ **丝滑子菜单防抖**:采用原生级悬停缓冲区与 280ms 延时保护,斜向滑动平滑稳定,杜绝鼠标稍微划偏子菜单就意外消失的问题。
22
+ - 💾 **另存为...**:直接呼出系统原生保存对话框,将工作区文件保存至任意自定义目录。
23
+ - 📋 **快速复制**:一键复制文件名/链接文本、绝对文件路径、文件内容(支持 5MB 以内文本文件)。
24
+ - 🔍 **在资源管理器/Finder 中显示**:直接打开父目录并在资源管理器中精准高亮选中该文件。
25
+ - ⚡ **原生快捷穿透**:按住 `Shift` 键再右键,无缝直通操作系统或浏览器原生菜单,完全不破坏原生体验。
26
+
27
+ ---
28
+
29
+ ## 🖥️ 平台兼容性
30
+
31
+ | 平台 | 打开方式支持 | 图标提取 | 状态 |
32
+ | :--- | :--- | :--- | :--- |
33
+ | **Windows** | 注册表关联应用 (`HKCU/HKLM`) | PowerShell 批量提取关联图标 | ✅ 已真机适配与环境净化 |
34
+ | **macOS** | LaunchServices 动态解析 | 系统原生图标映射 | ✅ 支持 |
35
+
36
+ > **提示**:Windows 上的部分受限 UWP 沙盒应用(如系统自带简易照片)不会出现在传统打开方式列表中。
37
+
38
+ ---
39
+
40
+ ## 📦 安装与使用
41
+
42
+ ### 方式 1:通过 npm 安装(推荐)
43
+
44
+ 在终端中执行:
45
+ ```powershell
46
+ dsh plugin --profile desktop add @dengsixue/dsh-file-menu
47
+ ```
48
+
49
+ ### 方式 2:通过 Release / 本地打包安装
50
+
51
+ 1. 从 GitHub Releases 下载最新安装包,或本地打包:
52
+ ```bash
53
+ pnpm pack
54
+ ```
55
+ 2. 在 DSH Desktop 的「插件」页面选择该 `.tgz` 安装;
56
+ 或者命令行安装:
57
+ ```powershell
58
+ dsh plugin --profile desktop add .\dengsixue-dsh-file-menu-1.0.0.tgz
59
+ ```
60
+
61
+ ### 方式 3:本地开发目录链接安装(便于调试)
62
+
63
+ 直接将本地源码目录作为插件加入:
64
+ ```powershell
65
+ dsh plugin --profile desktop add "C:\Users\Administrator\Documents\dsh-file-context-menu"
66
+ ```
67
+
68
+ > ⚠️ **重要提示**:安装、更新或修改前端 Client 注入代码后,**必须完全退出并重新打开 DSH Desktop**(重启主进程),仅在界面按 `Ctrl + R` 刷新无法重新加载底层客户端扩展。
69
+
70
+ ---
71
+
72
+ ## 📄 许可证
73
+
74
+ 本项目基于 [MIT 许可证](LICENSE) 开源。
@@ -0,0 +1,3 @@
1
+ - insert:
2
+ - id: file-menu
3
+ name: '@dengsixue/dsh-file-menu'