@jidekaixin2dian/dsh-file-actions 0.1.15 → 0.1.16

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/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.16 — 2026-10-26
4
+
5
+ - 重整中英文 README:安装更新优先,保留兼容与权限边界,开发说明移入独立文档。
6
+ - Refresh Chinese/English documentation and installation guidance; runtime behavior is unchanged.
7
+ - 明确市场与 npm 更新入口,指定公开截图,收起首页维护流程。
8
+
9
+
3
10
  ## 0.1.15 — 2026-10-25
4
11
 
5
12
  - 审查修复:工作区外复制在确认不可用或异常时拒绝读取;无效 UTF-8 不再静默替换后报告成功;分块下载核对版本、路径、偏移和大小,读取期间变化会中止。
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 jidekaixin2dian
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.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 jidekaixin2dian
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.en.md CHANGED
@@ -1,129 +1,76 @@
1
- # dsh-file-actions
1
+ # File Actions
2
2
 
3
- [中文](README.md)
3
+ **Turn a file reference in your conversation into the next action.**
4
4
 
5
- **0.1.15** improves inline references, video previews and menu interaction, and fixes file-read integrity, preview isolation and application caches. npm and GitHub Release use the same verified archive, with npm provenance. See [npm](https://www.npmjs.com/package/@jidekaixin2dian/dsh-file-actions), [Releases](https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest) and the [Changelog](CHANGELOG.md).
5
+ [中文](README.md) · [Marketplace](https://awesome-dsh-plugin.com/p/jidekaixin2dian/dsh-file-actions/) · [Download](https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest) · [Changelog](CHANGELOG.md)
6
6
 
7
- Right-click files and links to open, reveal, copy or save them.
7
+ Right-click a file or link to open it, choose an application, reveal it, copy it or save it. Works with chat references, delivery cards, tool results and sidebars that expose file paths.
8
8
 
9
- ![File context menu](assets/preview-dark.png)
9
+ ![File menu appearance example](assets/preview-glass.png)
10
10
 
11
- ## Install
11
+ | Your next step | Available actions |
12
+ |---|---|
13
+ | Keep editing | Open with the default app, search applications, save a preference per file type |
14
+ | Locate and reference | Reveal in the file manager; copy paths, names or references with line numbers |
15
+ | View and export | Preview supported documents and media, copy text, save a local file |
16
+ | Share a link | Open, copy the URL or text, copy as Markdown |
17
+
18
+ ## Install and update
19
+
20
+ Requires **DSH >=0.2.1-rc.2 and Node >=24**. CI verifies DSH rc.2 / rc.3.
21
+
22
+ Search for **dsh-file-actions** in the marketplace and verify author **jidekaixin2dian**. Existing users can check updates under installed plugins. Catalog and registry mirrors may take time to refresh.
12
23
 
13
- Requires DSH `>=0.2.1-rc.2` (CI continuously verifies both 0.2.1-rc.2 and 0.2.1-rc.3) and Node >=24. Quit the DSH desktop app completely, then run:
24
+ Alternatively, quit DSH completely and use the same command for installation or updates:
14
25
 
15
26
  ```powershell
16
27
  dsh plugin --profile desktop add @jidekaixin2dian/dsh-file-actions --registry=https://registry.npmjs.org
17
28
  ```
18
29
 
19
- Reopen DSH to activate it. The explicit npm registry avoids mirror synchronization delays. Append `@0.1.11` to the package name to install that exact version.
30
+ Reopen DSH. Downloadable archives are available in [Releases](https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest). A plain `npm install` does not register the plugin with DSH.
20
31
 
21
- GitHub Release installation remains available:
32
+ <details>
33
+ <summary>Alternative installation and removal</summary>
22
34
 
23
35
  ```powershell
24
36
  dsh plugin --profile desktop add https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest/download/dsh-file-actions.tgz
25
37
  ```
26
38
 
27
- To download the npm archive without installing the plugin:
39
+ Remove, then reopen DSH:
28
40
 
29
41
  ```powershell
30
- npm pack @jidekaixin2dian/dsh-file-actions --registry=https://registry.npmjs.org
42
+ dsh plugin --profile desktop remove @jidekaixin2dian/dsh-file-actions
31
43
  ```
32
44
 
33
- A plain `npm install` does not register the plugin with DSH; use `dsh plugin` above. To follow source instead, use `dsh plugin --profile desktop add github:jidekaixin2dian/dsh-file-actions`.
34
-
35
- To remove it: dsh plugin --profile desktop remove @jidekaixin2dian/dsh-file-actions, then reopen DSH.
36
-
37
- ## Using it
38
-
39
- Right-click a file name in any of these places:
40
-
41
- - inline code in the transcript (blue, dotted underline)
42
- - delivery cards and the changed-files list
43
- - file links in tool-call rows (read, write, edit)
44
- - the right Sidebar file tree
45
- - the document preview title
46
- - web links with the same blue style (GitHub releases, discussions, …)
47
-
48
- ![Open with](assets/preview-open-with.png)
49
-
50
- The rows follow the file type:
51
-
52
- | File | What you get |
53
- |---|---|
54
- | Code, text, config, subtitles | open, open in editor, open with, reveal, copy path, copy relative path, copy file name, copy contents, save as |
55
- | Markdown, HTML, SVG, PDF, images | the same plus *Open in browser*; images and SVG also show a thumbnail |
56
- | Video, audio | open, open with, play in browser (mp4 / mov / webm, mp3 / wav / flac …), save as |
57
- | Office, archives, design files, 3D, disk images, binaries | open, open with, reveal, copy path, save as |
58
- | Folders | open folder, reveal, copy path, copy relative path |
59
- | Web links | open link, copy link, copy link text, copy as Markdown |
60
-
61
- The link menu:
62
-
63
- ![Link menu](assets/preview-link.png)
64
-
65
- *Open with* keeps every registered application, ordered by preferred application, system default, editors, then other applications. A search box appears above seven entries.
45
+ </details>
66
46
 
67
- Click the star beside an application to prefer it for that file type; click again to clear it. Keyboard users can press `Shift+Enter`. Preferences stay in this browser and do not change OS associations. Stored associations paint immediately and are validated in the background. An unavailable preference falls back to an available editor shortcut. Failed opens refresh associations without automatically repeating the action.
47
+ ## Use
68
48
 
69
- Explicit file references show progress and a retryable error when verification fails. Guessed text paths are verified on hover or focus; until verified, they retain the native menu. `Shift` lets the page handle a right-click first; if nobody handles it, the plugin falls back to its own menu.
49
+ 1. Right-click a file reference, delivery card or file tree. Explicit references open directly; guessed text paths are verified first.
50
+ 2. Search **Open with** and star an application to remember it for that file type. OS defaults stay unchanged.
51
+ 3. Enlarge image thumbnails or view supported documents, audio and video in the browser.
70
52
 
71
- ![Search applications](assets/preview-search.png)
53
+ Keyboard: `Shift+F10` opens the menu, `↑ ↓` move, `→` enters a submenu, `Enter` runs and `Esc` closes. `Shift+right-click` gives the page's own handler priority.
72
54
 
73
- Image files get a thumbnail:
55
+ ## Boundaries
74
56
 
75
- ![Image thumbnail](assets/preview-image.png)
57
+ - File operations use official DSH APIs and path authorization. Application lists depend on system associations; the plugin does not repair registry entries.
58
+ - Copy contents accepts **valid UTF-8 up to 2 MiB**. Copies outside the workspace require explicit confirmation; unavailable confirmation cancels the read.
59
+ - Save and browser previews read up to **64 MiB** and stop on inconsistent chunks. This is not an atomic filesystem snapshot.
60
+ - HTML / SVG previews block scripts and external resources by default. Enable scripts and networking only for a trusted file; the preview remains isolated from DSH. Relative assets may not work. Clicking a document link is an explicit navigation.
61
+ - Editor actions do not jump to line/column positions. Save uses browser download behavior. The plugin needs the graphical / Web UI.
76
62
 
77
- Keyboard works too: `Shift+F10` or the menu key opens the same menu, `↑ ↓` move, `→` enters the submenu, `Enter` runs, `Esc` closes.
78
-
79
- Readable on a wallpaper with a liquid-glass theme — the menu paints a near-opaque base under the themed layer:
80
-
81
- ![Readability over a wallpaper](assets/preview-glass.png)
82
-
83
- ![Light theme](assets/preview-light.png)
84
-
85
- ## Limitations
86
-
87
- - Not a native menu. Text follows the page root font size and page zoom, not the operating system text-size setting directly.
88
- - *Open with* only lists registered applications. Preferences do not change OS defaults.
89
- - Opening an editor currently opens the file only; the pinned Host API does not accept line or column positions.
90
- - Save as uses the browser's download dialog with the original file name.
91
- - Copy contents is capped at 2 MiB and accepts valid UTF-8 only. Other encodings require an editor. Copies outside the workspace require confirmation; unavailable confirmation cancels the read.
92
- - Save as and browser previews read chunks up to 64 MiB total and stop if the file version changes. Larger files must be opened externally.
93
- - HTML/SVG previews initially disable scripts, forms, automatic refresh and external resource loading. Trusted files can opt in to scripts and network access using the preview button. The opaque-origin sandbox still blocks access to DSH DOM/cookies. Relative sibling assets, top navigation and same-origin storage may not work. Clicking a link inside a file is an explicit user navigation.
94
- - Web UI only — the terminal build has nothing to right-click.
95
-
96
- ## FAQ
97
-
98
- **Why does the native menu appear?** Plain prose and editable fields keep it. Guessed file paths are verified on hover or focus; cold or failed guesses retain the native menu. Explicit file references show a reason and a retry action on failure.
99
-
100
- **Is *Open with* unavailable?** Loading keeps placeholders; empty or failed results hide the association rows. Another right-click retries. Broken OS associations can fail the entire Host query; the plugin does not repair registry entries.
101
-
102
- **Nothing opens in the browser?** The popup may have been blocked; allow popups and retry.
103
-
104
- **How do I choose an application?** Click the star in *Open with*. Without a preference, the shortcut uses a recognised editor. *Open file* continues to use the system default.
105
-
106
- ## Development and verification
107
-
108
- Node >=24, Git and pnpm:
109
-
110
- ```sh
111
- npm ci --ignore-scripts
112
- npm test
113
- npm run setup:host
114
- npm run test:host
115
- npm run pack:check
116
- ```
63
+ <details>
64
+ <summary>FAQ</summary>
117
65
 
118
- The default pinned host is DSH **0.2.1-rc.3** (`1f81c047fc48fa190a683e469daa699857e9afe8`). Set `DFA_HOST_VERSION=rc.2` to verify the minimum supported host (`687f282e8625c6b8d11ff58211a90524be2e4317`). `DFA_HOST` can reuse the matching clean checkout. Windows uses headless Edge; Linux needs `npx --no-install playwright install --with-deps chromium`. CI covers rc.2/rc.3 on both systems. The plugin still has no runtime dependencies or build step.
66
+ **Why the native menu?** Plain text, editable fields and unverified guessed paths retain it. Failed explicit references show a reason and retry action.
119
67
 
120
- The browser suite uses the actual client bundle and real WorkspaceFiles over synthetic references. It checks Session identity, sandboxed script isolation, a real 3 MiB download and unload behavior. A separate browser suite uses deterministic Remote responses for native-menu fallback, preferences, asynchronous stability, search and large text. This is not a complete Desktop or OS application-launch test. Optional full-Web drivers and historical assertion counts are documented in [test-e2e](test-e2e/README.md).
68
+ **Where is Open with?** Empty or failed queries hide those rows; right-click again to retry. Broken associations need a system or host fix.
121
69
 
122
- ## Releases
70
+ **No preview window?** Check whether the browser blocked a popup.
123
71
 
124
- - [Latest release](https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest)
125
- - [Announcement](https://github.com/deepseek-ai/deepseek-harness/discussions/10576)
72
+ </details>
126
73
 
127
- ## License
74
+ [Development and verification](https://github.com/jidekaixin2dian/dsh-file-actions/blob/main/docs/development.md) · [Security](SECURITY.md) · [Issues](https://github.com/jidekaixin2dian/dsh-file-actions/issues)
128
75
 
129
- MIT
76
+ MIT · Independent community plugin, not affiliated with DeepSeek.
package/README.md CHANGED
@@ -1,132 +1,78 @@
1
1
  # File Actions · 文件与链接操作
2
2
 
3
- [English](README.en.md)
3
+ **从聊天里的文件引用,直接到你要做的操作。**
4
4
 
5
- **0.1.15** 补齐行内引用、视频预览与菜单交互,并修复文件读取、预览隔离和应用缓存问题。npm 与 GitHub Release 使用同一份校验归档,npm 发布附带 provenance 来源证明。安装包见 [npm](https://www.npmjs.com/package/@jidekaixin2dian/dsh-file-actions) 和 [Release](https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest),详情见[变更记录](CHANGELOG.md)。
5
+ [English](README.en.md) · [插件市场](https://awesome-dsh-plugin.com/p/jidekaixin2dian/dsh-file-actions/) · [下载](https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest) · [更新记录](CHANGELOG.md)
6
6
 
7
- 右键文件和链接,直接打开、定位、复制或另存。
7
+ 右键文件名或链接,即可打开、选择应用、定位、复制与另存。支持聊天引用、交付卡片、工具结果,以及提供文件路径的侧栏。
8
8
 
9
- ![文件右键菜单](assets/preview-dark.png)
9
+ ![文件右键菜单外观示例](assets/preview-glass.png)
10
10
 
11
- ## 安装
11
+ | 想做什么 | 可以怎么做 |
12
+ |---|---|
13
+ | 接着编辑文件 | 用默认应用打开,或搜索「打开方式」并收藏首选应用 |
14
+ | 找到文件与引用 | 在文件管理器定位,复制绝对 / 相对路径、文件名或带行号引用 |
15
+ | 查看与带走内容 | 预览支持的文档、图片或媒体;复制文本;另存为本地文件 |
16
+ | 分享链接 | 打开网页,复制链接、链接文字或 Markdown |
17
+
18
+ ## 安装与更新
19
+
20
+ 需要 **DSH >=0.2.1-rc.2、Node >=24**;持续验证 DSH rc.2 / rc.3。
21
+
22
+ 在插件市场搜索 **dsh-file-actions**,确认作者为 **jidekaixin2dian** 后安装;已有用户在「已安装」中检查更新。市场数据与 npm 镜像可能有同步延迟。
12
23
 
13
- 需要 DSH `>=0.2.1-rc.2`(CI 持续验证 0.2.1-rc.2 与 0.2.1-rc.3 双版本)与 Node >=24。先完全退出 DSH 桌面端,再执行:
24
+ 也可完全退出 DSH 后,使用同一条 CLI 命令安装或更新:
14
25
 
15
26
  ```powershell
16
27
  dsh plugin --profile desktop add @jidekaixin2dian/dsh-file-actions --registry=https://registry.npmjs.org
17
28
  ```
18
29
 
19
- 装完重开 DSH 生效。指定官方 npm 源可以避开镜像同步延迟;安装固定版本时,在包名后加 `@0.1.13`。
30
+ 重新打开 DSH 生效。离线包可从 [Release](https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest) 下载;普通 `npm install` 不会把插件注册进 DSH。
20
31
 
21
- 也可继续通过 GitHub Release 安装:
32
+ <details>
33
+ <summary>其他安装方式与卸载</summary>
34
+
35
+ GitHub Release 安装:
22
36
 
23
37
  ```powershell
24
38
  dsh plugin --profile desktop add https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest/download/dsh-file-actions.tgz
25
39
  ```
26
40
 
27
- 只下载 npm 安装包、不安装插件:
41
+ 卸载后重新打开 DSH:
28
42
 
29
43
  ```powershell
30
- npm pack @jidekaixin2dian/dsh-file-actions --registry=https://registry.npmjs.org
44
+ dsh plugin --profile desktop remove @jidekaixin2dian/dsh-file-actions
31
45
  ```
32
46
 
33
- 普通 `npm install` 不会把插件注册到 DSH;请使用上面的 `dsh plugin` 命令。想跟 main 源码走可以用 `dsh plugin --profile desktop add github:jidekaixin2dian/dsh-file-actions`。
34
-
35
- 卸载:dsh plugin --profile desktop remove @jidekaixin2dian/dsh-file-actions,然后重开 DSH。
36
-
37
- ## 怎么用
38
-
39
- 在聊天里右键这些位置的文件名:
40
-
41
- - 正文里的行内代码(蓝色、点线下划线)
42
- - 交付卡片和「已编辑」文件列表
43
- - 工具调用行(读取、写入、编辑)里的文件链接
44
- - 右侧文件树
45
- - 文档预览标题
46
- - GitHub 等网页链接(同一个蓝色样式)
47
-
48
- ![打开方式](assets/preview-open-with.png)
49
-
50
- 菜单按文件类型给不同的项:
51
-
52
- | 文件 | 能做什么 |
53
- |---|---|
54
- | 代码、文本、配置、字幕 | 打开、在编辑器中打开、打开方式、在资源管理器中显示、复制路径、复制相对路径、复制文件名、复制文件内容、另存为 |
55
- | Markdown、HTML、SVG、PDF、图片 | 同上,多一项「在浏览器中打开」;图片和 SVG 会在菜单里显示缩略图 |
56
- | 视频、音频 | 打开、打开方式、在浏览器中播放(mp4 / mov / webm、mp3 / wav / flac 等)、另存为 |
57
- | Office、压缩包、设计稿、3D、磁盘镜像、二进制 | 打开、打开方式、在资源管理器中显示、复制路径、另存为 |
58
- | 文件夹 | 打开文件夹、在资源管理器中打开、复制路径、复制相对路径 |
59
- | 网页链接 | 打开链接、复制链接、复制链接文字、复制为 Markdown |
60
-
61
- 网页链接的菜单:
62
-
63
- ![链接菜单](assets/preview-link.png)
64
-
65
- 「打开方式」完整保留系统关联应用,按首选、系统默认、编辑器、其他应用排序;超过 7 个会出现搜索框。
47
+ </details>
66
48
 
67
- 点击应用旁的星标,将它设为该文件类型的首选;再次点击取消。键盘选中应用后也可用 `Shift+Enter` 设置或取消。首选仅保存在当前浏览器中,不修改系统文件关联。持久缓存先展示、后台重新核对;失效首选会从快捷行回落到可用编辑器。打开失败会刷新关联,不自动重复打开文件。
49
+ ## 用起来
68
50
 
69
- 引用里带行号(src/app.ts:42:7、
70
- otes.md#L42-L48)时,菜单头部会显示「第 42 行」,并多出「复制引用」——原样复制这段引用,粘回聊天就能对上位置。宿主暂时不能把编辑器定位到该行。
51
+ 1. 在聊天文件名、文件卡片或文件树上右键。明确引用可直接操作,普通文字里的疑似路径会先验证。
52
+ 2. 选择「打开方式」可搜索应用,点击星标保存当前文件类型的首选;不会改变系统默认应用。
53
+ 3. 图片支持缩略图与放大预览;支持的文档、音视频可在浏览器中查看。
71
54
 
72
- 明确的文件引用会先显示读取状态,失败时可重试。普通文本中猜测的路径先在悬停或聚焦时验证,验证前保留原生菜单。任何位置按住 `Shift` 再右键,都保留原生菜单。
55
+ 键盘:`Shift+F10` 打开菜单,`↑ ↓` 移动,`→` 进入子菜单,`Enter` 执行,`Esc` 关闭。`Shift+右键` 优先交给页面原有菜单。
73
56
 
74
- ![搜索应用](assets/preview-search.png)
57
+ ## 使用边界
75
58
 
76
- 图片文件的缩略图:
59
+ - 打开与定位沿用 DSH 官方接口和路径授权;应用列表取决于系统关联。失效关联可能导致列表不可用,插件不会修改注册表。
60
+ - 复制内容仅支持 **有效 UTF-8、最大 2 MiB**。工作区外复制需要明确确认;确认不可用时取消读取。
61
+ - 另存为和浏览器预览最多读取 **64 MiB**,分块内容不一致时中止;不是文件系统原子快照。
62
+ - HTML / SVG 默认静态预览并阻止脚本和外部资源。仅在信任文件后启用脚本与联网;预览仍与 DSH 页面隔离。相对资源可能不可用,点击文件内链接属于主动导航。
63
+ - 编辑器打开暂不跳到行列位置;另存为使用浏览器下载行为。插件用于 DSH 图形 / Web 界面,终端界面不适用。
77
64
 
78
- ![图片缩略图](assets/preview-image.png)
79
-
80
- 键盘也能用:`Shift+F10` 或菜单键打开,`↑ ↓` 移动,`→` 进子菜单,`Enter` 执行,`Esc` 关闭。
81
-
82
- 壁纸 + 液态玻璃主题下也能看清(菜单底下垫了一层接近不透明的底):
83
-
84
- ![玻璃主题下的可读性](assets/preview-glass.png)
85
-
86
- ![浅色主题](assets/preview-light.png)
87
-
88
- ## 限制
89
-
90
- - 不是系统原生菜单;字号跟随页面根字号和页面缩放,不直接读取操作系统的文字大小设置。
91
- - 「打开方式」只列系统已注册的关联应用;首选设置不修改系统默认关联。
92
- - 打开编辑器目前只定位到文件;固定版本宿主的打开接口不支持传入行号和列号。
93
- - 另存为走浏览器的下载对话框,文件名固定为原文件名。
94
- - 复制文件内容上限 2 MiB,只接受有效 UTF-8;其它编码请用编辑器打开。工作区外复制需要确认,确认失败时取消读取。
95
- - 另存为和浏览器预览分块读取,总上限 64 MiB;读取期间文件版本变化会中止,避免导出混合内容。更大的文件请使用外部应用。
96
- - HTML/SVG 默认静态预览,关闭脚本、表单、自动跳转和外部资源加载;可信文件可点「信任此文件,启用脚本与联网」。启用后仍在独立来源的 sandbox iframe 内,不能读取 DSH 页面或 Cookie。相邻文件的相对资源、顶层跳转和同源存储可能不可用;点击文件内超链接属于用户主动导航。
97
- - 只支持网页版界面,终端里的 DSH 没有可右键的元素。
98
-
99
- ## 常见问题
100
-
101
- **右键出现原生菜单?** 普通文字与输入框保留原生菜单。猜测的文件路径需要先在悬停或聚焦时验证;未验证或验证失败时也保留原生菜单。明确文件引用失败时,菜单内会显示原因与重试入口。
102
-
103
- **「打开方式」不可用?** 查询时保留加载占位;空结果或失败时隐藏关联行,下次右键重新查询。系统里有损坏的应用关联时,宿主可能整批查询失败,插件无法自行修复注册表。
104
-
105
- **「在浏览器中打开」没反应?** 浏览器可能拦了新窗口,允许弹窗后重试。
106
-
107
- **怎么指定首选应用?** 在「打开方式」中点击应用旁的星标。未指定首选时,快捷打开行采用系统关联里能识别的编辑器;「打开文件」仍按系统默认方式打开。
108
-
109
- ## 开发与验证
110
-
111
- 需要 Node >=24、Git、pnpm:
112
-
113
- ```sh
114
- npm ci --ignore-scripts
115
- npm test
116
- npm run setup:host
117
- npm run test:host
118
- npm run pack:check
119
- ```
65
+ <details>
66
+ <summary>常见问题</summary>
120
67
 
121
- 默认固定宿主为 DSH **0.2.1-rc.3**(`1f81c047fc48fa190a683e469daa699857e9afe8`);`DFA_HOST_VERSION=rc.2` 可验证最低支持版本(`687f282e8625c6b8d11ff58211a90524be2e4317`)。`DFA_HOST` 可复用对应 commit 的干净 checkout。Windows 使用 headless Edge;Linux 先运行 `npx --no-install playwright install --with-deps chromium`。CI 在两种系统中分别覆盖 rc.2/rc.3。插件仍无运行时依赖、无构建步骤。
68
+ **为什么还是原生右键菜单?** 普通文字、输入框,以及尚未验证的疑似路径保留原生菜单。明确引用验证失败时会显示原因与重试入口。
122
69
 
123
- 浏览器套件把实际 client bundle 与真实 WorkspaceFiles 接到合成文件引用上,检查会话身份、预览脚本隔离、真实 3 MiB 下载及卸载行为;另用确定性 Remote 响应检查右键回退、首选应用、异步菜单稳定性、搜索和大字号。这不是完整 Desktop 或外部应用启动验收。可选完整 Web 驱动和历史断言计数见 [test-e2e](test-e2e/README.md)。
70
+ **找不到「打开方式」?** 查询为空或失败时会隐藏关联行,下次右键重试。系统损坏的应用关联需要在系统或宿主侧处理。
124
71
 
125
- ## 版本
72
+ **预览没有打开?** 检查浏览器是否拦截了弹窗。
126
73
 
127
- - [最新版本](https://github.com/jidekaixin2dian/dsh-file-actions/releases/latest)
128
- - [讨论帖](https://github.com/deepseek-ai/deepseek-harness/discussions/10576)
74
+ </details>
129
75
 
130
- ## 许可
76
+ [开发与验证](https://github.com/jidekaixin2dian/dsh-file-actions/blob/main/docs/development.md) · [安全说明](SECURITY.md) · [反馈问题](https://github.com/jidekaixin2dian/dsh-file-actions/issues)
131
77
 
132
- MIT
78
+ MIT · 独立社区插件,与 DeepSeek 官方无隶属关系。
package/cordis.patch.yml CHANGED
@@ -1,5 +1,5 @@
1
- # Bundle patch: one row mounts the (stateless) host half; `dsh.client` in
2
- # package.json makes the web app load ./client as the browser half.
3
- - insert:
4
- - id: dsh-file-actions
5
- name: '@jidekaixin2dian/dsh-file-actions'
1
+ # Bundle patch: one row mounts the (stateless) host half; `dsh.client` in
2
+ # package.json makes the web app load ./client as the browser half.
3
+ - insert:
4
+ - id: dsh-file-actions
5
+ name: '@jidekaixin2dian/dsh-file-actions'
package/icon.svg CHANGED
@@ -1,7 +1,7 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="dsh-file-actions">
2
- <rect width="64" height="64" rx="14" fill="#1b1d21"/>
3
- <path d="M18 16h18l10 10v22a4 4 0 0 1-4 4H18a4 4 0 0 1-4-4V20a4 4 0 0 1 4-4z" fill="none" stroke="#e8e8e8" stroke-width="2.4" stroke-linejoin="round"/>
4
- <path d="M36 16v10h10" fill="none" stroke="#e8e8e8" stroke-width="2.4" stroke-linejoin="round"/>
5
- <circle cx="45" cy="45" r="11" fill="#c8f663"/>
6
- <path d="M40.5 45h9M45 40.5v9" stroke="#1b1d21" stroke-width="2.6" stroke-linecap="round"/>
7
- </svg>
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="dsh-file-actions">
2
+ <rect width="64" height="64" rx="14" fill="#1b1d21"/>
3
+ <path d="M18 16h18l10 10v22a4 4 0 0 1-4 4H18a4 4 0 0 1-4-4V20a4 4 0 0 1 4-4z" fill="none" stroke="#e8e8e8" stroke-width="2.4" stroke-linejoin="round"/>
4
+ <path d="M36 16v10h10" fill="none" stroke="#e8e8e8" stroke-width="2.4" stroke-linejoin="round"/>
5
+ <circle cx="45" cy="45" r="11" fill="#c8f663"/>
6
+ <path d="M40.5 45h9M45 40.5v9" stroke="#1b1d21" stroke-width="2.6" stroke-linecap="round"/>
7
+ </svg>
package/lib/index.js CHANGED
@@ -1,13 +1,13 @@
1
- // dsh-file-actions — host half.
2
- //
3
- // The whole feature lives in the browser half: it reuses the Session Remote
4
- // (`session.openWorkspacePath` / `session.workspacePathApplications`) and the
5
- // workspace-files Remote (`stat` / `readBytes`) that the shipped Web bundle
6
- // already serves. Nothing here touches the filesystem or the desktop, so this
7
- // module only satisfies the bundle row and declares its identity.
8
-
9
- export const name = 'dsh-file-actions'
10
-
11
- export const inject = []
12
-
13
- export function apply() {}
1
+ // dsh-file-actions — host half.
2
+ //
3
+ // The whole feature lives in the browser half: it reuses the Session Remote
4
+ // (`session.openWorkspacePath` / `session.workspacePathApplications`) and the
5
+ // workspace-files Remote (`stat` / `readBytes`) that the shipped Web bundle
6
+ // already serves. Nothing here touches the filesystem or the desktop, so this
7
+ // module only satisfies the bundle row and declares its identity.
8
+
9
+ export const name = 'dsh-file-actions'
10
+
11
+ export const inject = []
12
+
13
+ export function apply() {}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jidekaixin2dian/dsh-file-actions",
3
- "version": "0.1.15",
3
+ "version": "0.1.16",
4
4
  "description": "File and link actions for DeepSeek Harness: open, choose applications, reveal, copy paths or contents, and save files from the chat.",
5
5
  "icon": "icon.svg",
6
6
  "type": "module",