dsh-plugins

持续开发的 DeepSeek Harness (DSH) Web 插件源码仓库。每个插件一个文件夹；配合内置的「插件管理器」（dsh-repo-sync）可一键安装/卸载/提交。安装采用官方 pnpm 方式（pnpm add link:...，等价 dsh plugin --profile web add），记录进 profile 的 package.json，源码即本仓库，改代码刷新即生效。

远端：https://github.com/Daisywait/dsh-plugins（公开）

结构

dsh-plugins/
├── dsh-skin-shiguangdailiren/   # 《时光代理人》皮肤：壁纸 + 暖粉毛玻璃主题 + GenUI 网页质感
├── dsh-repo-sync/               # 插件管理器：「仓库」标签页，一键安装/卸载/提交
├── dsh-quote/                   # 消息「引用」：选中文本引用（开发中，暂未收录到远端）
├── dsh-video/                   # 视频工作室：Remotion 实时预览 + 参数交互 + 渲染 MP4（新「视频」标签页）
└── README.md

快速开始（一条命令，无需克隆）

在 PowerShell 里运行：

powershell -Command "irm https://raw.githubusercontent.com/Daisywait/dsh-plugins/master/install-remote.ps1 | iex"

脚本自动：拉取插件源码到托管目录 ~\.dsh\plugins-src\（git clone，重跑自动 pull 更新）→ 用 pnpm add link: 按官方方式安装到 profile（记录进 package.json）→ 写入 cordis.patch.yml 注册行（幂等）。完成后重启 DSH。

之后打开会话头部「仓库」标签页（插件管理器），所有插件的安装/卸载/提交都在这里。

本机开发建议：如果你自己有本地克隆（如 D:\Documents\dsh-plugins），直接用它跑 powershell -ExecutionPolicy Bypass .\install.ps1，链接会指向本地克隆——改代码刷新即生效。 远程一条命令适合新机器/快速引导（会建 ~\.dsh\plugins-src 托管副本，编辑要在那里改）。

想指定插件或复制模式，远程脚本也透传参数：... | iex 后接 dsh-repo-sync -Copy 之类（用法与本地 install.ps1 相同）。

安装插件（管理器一键安装）

1. 打开 DSH 会话头部的「仓库」标签页（插件管理器）。
2. 「仓库可安装」列表里点插件旁的 安装：
   • 用官方方式 pnpm add link:<仓库目录> 安装（记录进 profile 的 package.json）
   • 自动写入 cordis.patch.yml 注册行（幂等，不会重复）
3. 重启 DSH 生效。

之后改本仓库里的插件源码 → 刷新页面即生效（链接直达，无需复制）。

卸载插件

「仓库」标签 → 已安装插件 → 卸载：移除链接 + 移除注册行，重启生效。

手动安装（备用，不走管理器）

1. 复制插件文件夹到 C:\Users\<你的用户名>\.dsh\profiles\web\node_modules\
2. cordis.patch.yml 顶层数组加：

   - insert:
       - id: <注册id>
         name: 'dsh-<name>'
   

3. 重启 DSH。

各插件注册 id：dsh-skin-shiguangdailiren → skin-shiguangdailiren；dsh-repo-sync → repo-sync；dsh-video → dsh-video（注意：dsh-video 手动安装后还要运行它的 scripts/install-deps.ps1 装渲染依赖）。

插件清单

插件	功能
dsh-skin-shiguangdailiren	时光代理人壁纸 + 毛玻璃主题（明暗双套）；会话头部 🖌 打开右侧栏调节：透明度/水平位置/图片大小/GenUI 浓度/上传壁纸，全部自动保存；GenUI 卡片网页质感样式
dsh-repo-sync	插件管理器：「仓库」标签页。已安装插件（状态 + 提交/同步 + 卸载）+ 仓库可安装（安装，官方 pnpm 方式）。提交自动 git add + commit + push
dsh-quote	消息引用：助手消息操作区 ⤴ 按钮，把该消息文本带进输入框（方便引用上下文）
dsh-video	视频工作室：会话头部「视频」标签页。Remotion 实时预览（标题卡/结束卡两种合成，可改文字、配色、Emoji、时长/帧率），一键渲染 H.264 MP4（720p/1080p），「全屏预览」在新浏览器标签页打开交互工作室。智能体可直接调用 video_render / video_job_status 工具生成视频

开发流程

1. 在本仓库改插件源码（host 半区 index.js、客户端 bundle client.js）。
2. 已安装（链接模式）→ 刷新页面即生效；host 改动需重启 DSH。
3. 改完在「仓库」页点 提交 → git commit + push 到 GitHub（自动）。
4. 新插件：先在仓库建文件夹（package.json 带 dsh.client: { platform: "web" } + exports["./client"]）→ 「仓库」页点安装。

dsh-video 的依赖与构建（其余插件无此步骤）

dsh-video 的 host 渲染栈（@remotion/bundler、@remotion/renderer）装在插件自己的目录（链接安装不共享 profile 的 node_modules）：

• 首次安装：仓库「仓库」页点安装会自动运行 scripts/install-deps.ps1（pnpm install --ignore-scripts + node scripts/build.mjs）；或用 install.ps1 一并处理。
• 手动：cd dsh-video && powershell -ExecutionPolicy Bypass .\scripts\install-deps.ps1
• 改客户端源码（src/、remotion/src/）后重跑 node scripts/build.mjs 重建 client.js / studio/studio.js，刷新页面生效。
• node_modules/、output/、.bundle/ 均已 gitignore。

让智能体生成视频（模型工具）

dsh-video 在 host 端通过 ctx.tools 注册两个模型可调用工具（无需额外配置，重启 DSH 后模型自动可见）：

• video_render：渲染一段视频。参数：kind（Title/End）、seconds（5/10/15/20）、fps（24/30/60）、width/height、以及全部文案与配色（title/subtitle/byline/emoji/bg1/bg2/accent/textColor），wait 默认 true 等待完成并返回 outputUrl 成品地址；false 则立即返回 jobId。
• video_job_status：按 jobId 查询进度与结果（适合 wait:false 后轮询）。

用法示例（对模型说）：「用 video_render 生成一个 10 秒 1080p 的标题卡视频，标题『你好，世界』，紫色渐变背景，等渲染完把链接给我」。渲染结果同时出现在「视频」标签页的「最近渲染」列表里，可重播/下载。工具注册失败会把原因写进 /video/status 的 lastError，不影响标签页使用。

技术要点

• 客户端 bundle 格式：window.__ModuleLoader__.load({ id, factory })，由 DSH 的 clientModules 服务按需读取（no-cache，改文件刷新即生效）。
• 插件包声明：package.json 里 dsh.client: { platform: "web" } + exports["./client"] 指向 bundle 文件；exports["./package.json"] 也需导出。
• Host 半区用 node:child_process 执行 git（web profile 未挂载 shell/subprocess 服务，不要用 ctx.get('shell')）。
• 安装用 junction 链接（fs.symlinkSync(..., 'junction')），Node/浏览器按普通目录解析。
• 客户端与 Host 通信：Host 注册 webServer HTTP 路由（如 /repo-sync/plugins），客户端用 fetch 轮询/调用；不要用动态插件的 harness.handle/host.call（常驻插件没有这两个内置）。
• 常驻插件给模型加工具：ctx.inject(['tools'], (toolsCtx) => toolsCtx.tools.register({ name, description, parameters, output: { schema, render }, execute })) —— 直接注册 raw ToolDefinition 对象即可（defineTool 只是 TS 辅助），插件目录解析不到 @deepseek-ai/* 平台包，不要 import 它们。

贡献者

• Daisywait（仓库作者，方向与使用）
• DeepSeek（deepseek-ai）：AI 开发助手，实现皮肤插件、插件管理器、引导脚本与文档

本仓库的插件与脚本由 DeepSeek 持续迭代维护；历史提交均署名 DeepSeek（deepseek-ai）。