dsh-long-plugins 1.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jackylong1987
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# dsh-long-plugins
+
+Merged plugin bundle for [DeepSeek Harness](https://github.com/deepseek-ai/dsh) (DSH) Web:
+upload manager, workspace **输出文件** section, top-bar **文件** browser with a real Word (docx) preview,
+**技能文档** (skill docs) browser, and DeepSeek account balance — all in one installable plugin.
+Also ships an auto-repair install that relinks DSH core patches (reverse-proxy WebSocket heartbeat, upgrade relink).
+
+一个插件整合 DSH Web 的常用增强：上传管理、顶栏「📂文件」工作区浏览 + Word 真实预览、工作区「输出文件」面板、技能文档浏览、账户余额显示。并自带修复安装，自动重连 DSH 核心补丁（反代 WebSocket 心跳、升级重连）。
+
+## Features / 功能
+
+| Feature | 说明 |
+|---|---|
+| Upload manager | 输入框回形针按钮上传本地文件，待发送文件栏管理，设置面板「上传文件」（预览/下载/删除） |
+| Workspace output files | 设置面板「输出文件」：按工作区文件夹分组、预览、**编辑/保存**、复制全部、**放大窗口** |
+| Workspace file browser (顶栏「📂文件」) | 顶栏「📂文件」打开工作区/全部文件浏览，按文件夹分组；点文件名或「预览」在面板内预览，**Word (.docx) 用 docx-preview 浏览器端真实渲染（所见即所得）**；支持「←返回」「✕关闭」两层退出回列表，底部仅列表根时才整体退出；含下载/放大 |
+| Skill docs | 设置面板「技能文档」：按技能目录浏览 SKILL.md、弹窗预览、编辑/保存、复制、放大窗口 |
+| Account balance | 输入框下方显示 DeepSeek 账户余额（60s 自动刷新） |
+| md2docx | DSH 工具：把 Markdown 一键转成带页码页脚的 Word（`.docx`），标题/表格/加粗/列表/引用，生成的文件作为可点击交付物出现在消息里 |
+| Turn ruler | 会话右侧轮次导航：3 个比例刻度（最早/中间/最新）+ 预览窗列出全部轮次标题，光标点亮、点击蓝色标记并定位会话，滚到顶部自动加载更早历史，手机端竖向把手打开预览窗 |
+| Auto-repair install | 安装时自动重打 DSH 核心补丁：反代 WebSocket 心跳（修复提问窗口自己消失）、升级后重连 |
+| Mobile layout | 手机端布局优化（输入栏、设置面板、主题选择、模型选择器） |
+| Drag & drop upload | 拖任意文件到会话框直接附加为「待发送」卡片（走与回形针同一上传管线）；全屏虚线投掷遮罩提示；消除 DSH 核心"仅支持 PNG/JPG/WebP/GIF 格式的图片"误报 |
+
+## 更新记录 / Releases
+
+### v1.3.1
+
+**新增 · 顶栏「📂 文件」工作区浏览器 + Word 真实预览**：顶栏「📂文件」打开工作区/全部文件浏览，按文件夹分组；点文件名或「预览」在面板内预览。Word（`.docx`）走 `docx-preview` 浏览器端真实渲染（所见即所得，无需服务端转换），并随包打包前端库 `client/vendor`（docx-preview / jszip）。
+
+**优化 · 两层关闭**：预览某文件时「✕关闭」/ Esc / 预览页自带「关闭」都回到文件列表，仅列表根部才整体退出面板；头部新增「←返回」按钮。Word 预览页也补上自带「✕关闭」，与 md 预览一致的两层关闭。
+
+### v1.3.0
+
+**新增 · 拖放上传**：拖文件到网页任意位置松手即附加为「待发送」卡片；支持 `md / docx / xlsx / pptx / pdf / txt / csv` 及 `png / jpg / webp / gif`；与回形针同一条上传管线；拖放时全屏虚线投掷遮罩。
+
+**🐛 修复**：消除核心"仅支持 PNG/JPG/WebP/GIF"误报——捕获阶段接管文件拖放。
+
+**兼容性**：仅对真正拖入文件生效；拖文本/链接不受影响；标准浏览器事件，多设备通用。
+
+## Turn ruler / 轮次导航
+
+- 桌面端：会话右侧 3 个比例刻度点，悬停打开「历史提问」预览窗
+- 预览窗：列出全部已加载轮次的标题；光标悬停点亮该行，点击行以蓝色标记并定位主会话
+- 滚动到预览窗顶部自动加载更早历史（内容锚定恢复焦点，无震动、不跳跃）；手机端触摸滚动已做性能优化
+- 手机端：右边缘竖向把手点击打开预览窗（居中弹窗，✕ 关闭）
+
+## Install / 安装
+
+> **目录约定**：插件放 `$DSH_HOME/plugins/dsh-long-plugins`，DSH 运行脚本（`bin`）放 `$DSH_HOME/bin`，都别放工作目录。你的**工作目录**（名字任意）由用户指定，其下 `upload` 为上传根（`DSH_UPLOAD_DIR`）。目录缺失用 `mkdir -p` 补建。
+
+### 方式 A：`install.sh`（Unix/Linux/NAS）
+```sh
+git clone https://github.com/jackylong1987/dsh-long-plugins.git "$HOME/.dsh/plugins/dsh-long-plugins"
+cd "$HOME/.dsh/plugins/dsh-long-plugins"
+./install.sh web "$HOME/.dsh" "$HOME/.dsh/plugins/dsh-long-plugins"
+```
+
+### 方式 B：Windows（PowerShell）
+```powershell
+git clone https://github.com/jackylong1987/dsh-long-plugins.git "$env:USERPROFILE\.dsh\plugins\dsh-long-plugins"
+dsh plugin --profile web add "file:$env:USERPROFILE\.dsh\plugins\dsh-long-plugins"
+# 把 "dsh-long-plugins" 追加到 profile package.json 的 dsh.profile.bundles
+```
+Windows 不跑 `install.sh`，skill 需手动放到 `$env:USERPROFILE\.dsh\skills\`。
+
+### 方式 C：用 skill 安装（推荐）
+前置把 skill 放进 `$DSH_HOME/skills/`。之后在 DSH 会话中：安装 `dsh-long-plugins`，agent 按 skill 指引自动完成。
+
+### 手动
+在 `<DSH_HOME>/profiles/<profile>/package.json` 加 `file:` 依赖与 bundle，然后 `pnpm install`：
+```json
+{ "dependencies": { "dsh-long-plugins": "file:/home/me/.dsh/plugins/dsh-long-plugins" }, "dsh": { "profile": { "bundles": ["dsh-long-plugins"] } } }
+```
+
+### 工作目录 / 上传目录
+按你的工作目录设上传根（目录缺失 `mkdir -p` 补建），并写进启动脚本、确认可写：
+```sh
+mkdir -p "/home/me/project/upload"
+export DSH_UPLOAD_DIR="/home/me/project/upload"   # 工作区根 = /home/me/project
+```
+
+## Configuration / 配置
+
+Add to the profile's `cordis.patch.yml`:
+
+```yaml
+- id: dsh-long-plugins
+  config:
+    priority: -10
+    trustedHosts: !!js ctx.webRuntime.trustedHosts
+    skillsRoot: !!js dshHomePath('skills')   # default <DSH_HOME>/skills; override with your path
+```
+
+- `trustedHosts` — required for the browser trust fence (same as the built-in Web API).
+- `skillsRoot` — root directory browsed by the「技能文档」section. Defaults to `<DSH_HOME>/skills`.
+- `md2docxScript` — (optional) override the Markdown→Word script path. Defaults to the bundled `lib/md2docx.py`.
+
+## md2docx 工具（Markdown → Word）
+
+Agent 可直接调用 `md2docx` 工具，把 Markdown 转成带页码页脚的 Word 文档：
+
+- 输入 `input`（必填）：`.md` 文件绝对路径。
+- 输出 `output`（可选）：`.docx` 路径；缺省为同目录同名 `.docx`。
+- 生成的文件会作为可点击交付物卡片出现在消息里（复用插件内置预览/打开链路）。
+
+**前置依赖：** 宿主需安装 `python3` 与 `python-docx`（`pip install python-docx`）。转换脚本随包分发（`lib/md2docx.py`），无需额外安装脚本；也无需 pandoc。
+
+## Server routes / 服务端路由
+
+```
+/api/dsh-uploads/workspace               output files (grouped by folder)
+/api/dsh-uploads/workspace-browse        workspace file browser (top-bar「📂文件」)
+/api/dsh-uploads/workspace-file          preview / download
+/api/dsh-uploads/workspace-file/delete   delete (POST)
+/api/dsh-uploads/workspace-file/save     save edited content (POST)
+/api/dsh-uploads/docx-preview            Word (.docx) real render page (browser-side docx-preview)
+/api/dsh-uploads/docx-preview-asset       serve docx-preview / jszip vendor libs
+/dsh-skill-docs/skill-docs               skill docs list (grouped by skill)
+/dsh-skill-docs/skill-doc                preview / download
+/dsh-skill-docs/skill-doc/save           save (POST)
+/dsh-token-usage/balance                 DeepSeek account balance proxy
+```
+
+Plus the upload manager's core routes (`/api/dsh-uploads`, download, preview).
+
+## License
+
+MIT