dsh-long-plugins

Merged plugin bundle for DeepSeek Harness (DSH) Web: upload manager, workspace 输出文件 section, 技能文档 (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 的常用增强：上传管理、工作区「输出文件」面板、技能文档浏览、账户余额显示。并自带修复安装，自动重连 DSH 核心补丁（反代 WebSocket 心跳、升级重连）。

Features / 功能

Feature	说明
Upload manager	输入框回形针按钮上传本地文件，待发送文件栏管理，设置面板「上传文件」（预览/下载/删除）
Workspace output files	设置面板「输出文件」：按工作区文件夹分组、预览、编辑/保存、复制全部、放大窗口
Skill docs	设置面板「技能文档」：按技能目录浏览 SKILL.md、弹窗预览、编辑/保存、复制、放大窗口
Account balance	输入框下方显示 DeepSeek 账户余额（60s 自动刷新）
md2docx	DSH 工具：把 Markdown 一键转成带页码页脚的 Word（.docx），标题/表格/加粗/列表/引用，生成的文件作为可点击交付物出现在消息里
Turn ruler	会话右侧轮次导航：3 个比例刻度（最早/中间/最新）+ 预览窗列出全部轮次标题，光标点亮、点击蓝色标记并定位会话，滚到顶部自动加载更早历史，手机端竖向把手打开预览窗
Auto-repair install	安装时自动重打 DSH 核心补丁：反代 WebSocket 心跳（修复提问窗口自己消失）、升级后重连
Mobile layout	手机端布局优化（输入栏、设置面板、主题选择、模型选择器）

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）

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）

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：

{ "dependencies": { "dsh-long-plugins": "file:/home/me/.dsh/plugins/dsh-long-plugins" }, "dsh": { "profile": { "bundles": ["dsh-long-plugins"] } } }

工作目录 / 上传目录

按你的工作目录设上传根（目录缺失 mkdir -p 补建），并写进启动脚本、确认可写：

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:

- 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-file          preview / download
/api/dsh-uploads/workspace-file/delete   delete (POST)
/api/dsh-uploads/workspace-file/save     save edited content (POST)
/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