多插件合集 MaximFedorovtoo/dsh-plugins

DeepSeek Harness 插件：开销、截图、本地化、Codex、指令与项目迁移

八个 DeepSeek Harness（DSH）插件：

| 插件 | 功能 | 运行平台 |
| dsh-api-spend | 在当前项目里显示 API 开销，紧挨 token 计数器；点击可查看按项目拆分的「今天 / 7 天 / 全部时间」明细，以及平台官方汇总数据，方便核对。 | Windows、macOS、Linux |
| dsh-screenshot | 输入框里的「截图」按钮（从剪贴板取图，或打开文件选择），附件内直接带标注编辑器（画笔、箭头、方框、文字），还有智能体工具「查看屏幕 / 查看剪贴板」和「放大图片局部」。 | 界面——全平台可用；截屏与剪贴板取图——仅 Windows |
| dsh-locale-ru | Web 客户端完整俄语本地化：64 个命名空间、2910 条界面文案、545 个插件名称与描述。 | Windows、macOS、Linux |
| dsh-codex-bridge | 把项目和对话从 OpenAI Codex 迁移到 DSH：项目留在原文件夹，聊天在 DSH 里继续。 | Windows、macOS、Linux |
| dsh-agents-md | 把全局指令 AGENTS.md 放进 DSH_HOME，让它在任何项目的每个会话里都自动加载。已有文件不会被覆盖，除非显式指定 overwrite。 | Windows、macOS、Linux |
| dsh-instructions | 「指令」面板：上传文件、编辑并保存为 DSH_HOME/AGENTS.md——规则默认在所有会话中生效。 | Windows、macOS、Linux |
| dsh-project-portability | 把整个项目导出成单个 .dshpack 归档（文件、带完整历史和上下文的所有聊天、附件），在另一台电脑上导入——接着在同样的聊天里继续干活。 | Windows、macOS、Linux |
| dsh-voice-ru | 俄语语音输入：用「语音」按钮替代内置麦克风——本地 GigaAM 识别（CTC 或带标点的 e2e），口述的要点会结合项目上下文变成连贯的任务，插入输入框供你检查并手动发送。 | Windows、macOS、Linux |

所有插件都是纯 JavaScript，无依赖、无构建步骤。各系统安装方式相同；平台限制只涉及 dsh-screenshot 的屏幕捕获（见平台兼容性）。

英文版 · 安装说明

要求

- DeepSeek Harness 0.2.x（已在 0.2.1-rc.3 上验证）——Desktop 应用或命令行。
- Web / Desktop 界面：插件往聊天界面里添加元素。
- 无需额外安装任何东西：不用 Node.js，不用 Python，也不用编译器。这些包没有依赖。
安装已用真实配置档做过端到端验证：包既能从本地文件夹安装，也能用 git 链接加 path: 子目录从本仓库安装；插件条目会汇总进 dsh --profile <name> --dump-config。

快速安装

完整说明、所有安装方式和错误排查见 INSTALL.md。简要版：

方式 1 — Discover（插件索引）。 在 DSH 中打开 Plugins → Discover，点 Add index source，粘贴：

https://raw.githubusercontent.com/MaximFedorovtoo/dsh-plugins/main/index.json

Discover 标签页要在 Plugins 页面启用实验性包 Custom plugin indexes 后才会出现。

方式 2 — 用仓库链接。 打开 Plugins → Add plugin → Install a third-party plugin，粘贴目标包的地址：

github:MaximFedorovtoo/dsh-plugins#<commit>&path:/plugins/dsh-screenshot
github:MaximFedorovtoo/dsh-plugins#<commit>&path:/plugins/dsh-api-spend

<commit> 是 提交记录页 里的提交 SHA。完整写法 git+https://github.com/MaximFedorovtoo/dsh-plugins.git#<commit>&path:/plugins/dsh-screenshot 效果相同。用 git 安装时，机器上必须装好 git。

方式 3 — 命令行。 在终端里做同样的事：

dsh plugin --profile desktop add 'github:MaximFedorovtoo/dsh-plugins#<commit>&path:/plugins/dsh-screenshot'
dsh --profile desktop

在 PowerShell 里，这种参数中的 & 会被 dsh.cmd 包装层截断；请用停止解析符或 cmd.exe：

dsh --% plugin --profile desktop add "github:MaximFedorovtoo/dsh-plugins#<commit>&path:/plugins/dsh-screenshot"

详见 INSTALL.md。

方式 4 — 本地文件夹。 下载仓库（Code → Download ZIP），解压后在 Add plugin 里填插件文件夹的绝对路径，例如 C:\Users\Имя\dsh-plugins\plugins\dsh-api-spend（Windows）或 /Users/имя/dsh-plugins/plugins/dsh-api-spend（macOS）。命令行同理：dsh plugin --profile desktop add ./dsh-plugins/plugins/dsh-api-spend。

安装完成后启用插件：Plugins → Installed → 打开目标包的开关（或在安装窗口点 Enable now）。

平台兼容性

| 功能 | Windows 10/11 | macOS | Linux |
| 安装并启用插件 | 是 | 是 | 是 |
| dsh-api-spend：花费胶囊、明细拆分、平台汇总 | 是 | 是 | 是 |
| dsh-screenshot：输入框按钮、剪贴板、选择文件、标注编辑器、拖放 | 是 | 是 | 是 |
| dsh-screenshot：智能体工具 screenshot 和 zoom_image（截屏/截剪贴板、放大局部） | 是 | 否 | 否 |
| dsh-project-portability：导出为 .dshpack、导入并继续对话 | 是 | 是 | 是 |
为什么这样设计：dsh-screenshot 的屏幕与剪贴板捕获走 Windows PowerShell 5.1 和 System.Drawing/WPF，因为 DSH 宿主只是普通 Node，没有 Electron 的捕获 API。在 macOS 和 Linux 上，这两个工具会返回明确错误「需要 Windows PowerShell」，插件其余部分（按钮、编辑器、发送图片附件）照常工作。把捕获移植到 macOS（screencapture）和 Linux（grim/gnome-screenshot + ImageMagick）是显而易见的下一步；当前版本还没有。

这些插件具体装了什么

- dsh-api-spend（api-spend）——宿主部分通过 ctx.sessionQuery 读取会话日志，按 DeepSeek 官方价目表把 token 乘以单价，区分高峰/非高峰时段，再按项目汇总；客户端部分在输入框下方那一行画一个胶囊，并提供明细弹窗。价目表、货币、高峰时段和会话上限都在插件配置行里设置。
- dsh-screenshot（screenshot）——宿主部分注册 screenshot 和 zoom_image 两个工具，以及系统提示词里的「How to read a screenshot」一节；客户端部分把附件栏换成带标注编辑器的版本，并在输入框加一个捕获按钮。
- dsh-project-portability（project-portability）——宿主部分读取项目树、通过 ctx.sessionQuery/ctx.sessionPersistence 读取完整会话日志和内容寻址附件，写出单个 .dshpack；导入时创建新的 durable 会话并重写 cwd，用冷读校验，再绑定到工作区。工具为 project_list、project_export、project_import；客户端部分是侧边栏里的「项目迁移」页面。

配置

两个插件配置行都在配置档的 cordis.patch.yml 里设置（~/.dsh/profiles/<profile>/cordis.patch.yml，Windows 上是 %USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml），或者如果插件声明了自己的配置页面，就在 Plugins 里的插件页设置。

dsh-api-spend：

- id: api-spend
config:
currency: USD
symbol: '$'
priceUnit: 1000000
offPeakFactor: 0.5
peakWindows: [{ start: 1, end: 4 }, { start: 6, end: 10 }]
peakWeekdays: [1, 2, 3, 4, 5]
holidays: []
defaultModel: deepseek-flash
models:
deepseek-flash: { cacheHit: 0.006, cacheMiss: 0.3, output: 1.2 }
deepseek-v4-pro: { cacheHit: 0.044, cacheMiss: 1.32, output: 3.96 }
maxSessions: 400
platformRefreshMs: 120000

dsh-screenshot：

- id: screenshot
config:
cacheDir: '' # по умолчанию <DSH_HOME>/cache/screenshot
defaultZoomScale: 2
maxZoomScale: 4

dsh-project-portability：

- id: project-portability
config:
archiveDir: '' # по умолчанию <DSH_HOME>/exports
excludeNames: ['.dsh-portability.tmp']
includeSessions: true
includeAttachments: true
资费中的价格按高峰时段每 100 万 token 计；非高峰时段套用 offPeakFactor。对话里显示的平台汇总，统计的是 API 密钥下所有客户的花费，所以会比各项目金额之和大——这很正常，本来就是这么设计来对账的。

仓库结构

dsh-plugins/
├── plugins/
│ ├── dsh-screenshot/ # 包 dsh-screenshot │ ├── dsh-api-spend/ # 包 dsh-api-spend │ ├── dsh-locale-ru/ # 包 dsh-locale-ru（俄语本地化） │ ├── dsh-codex-bridge/ # 包 dsh-codex-bridge（从 Codex 迁移） │ ├── dsh-agents-md/ # 包 dsh-agents-md（全局指令 AGENTS.md） │ ├── dsh-instructions/ # 包 dsh-instructions（指令加载面板） │ └── dsh-project-portability/ # 包 dsh-project-portability（项目迁移） ├── icons/ # Discover 索引用的图标 ├── index.json # Discover 标签页的索引 ├── INSTALL.md # 安装说明（俄语） └── INSTALL.en.md # installation guide (English)

八个插件都放在这个仓库里；每个插件在 plugins/ 下有自己的文件夹，也有自己的 README 和安装说明。

许可证

MIT——见 LICENSE。

这些插件为 DeepSeek Harness 编写，使用它的内部服务（ctx.tools、ctx.systemPrompt、ctx.sessionQuery、ctx.webServer、ctx.connection、ctx.deepseekAccount、客户端插槽）。升级 DSH 时请检查兼容性：各包里的 engines.dsh 限定在 0.2.x 分支。