DSH WebUI Plugin

DeepSeek Harness WebUI 插件 - 液体玻璃风格界面增强

📦 安装方式

1. Bundle 型安装（推荐）

dsh plugin --profile web add "github:your-org/dsh-webui-plugin#main"

2. 本地开发

dsh plugin --profile web add link:/path/to/dsh-webui-plugin

3. Patch 层手动挂载

创建 cordis.patch.yml:

- insert:
    - id: dsh-webui
      name: 'dsh-webui-plugin'

启动时加载:

dsh web --patch ./cordis.patch.yml

✨ 功能特性

• 🌊 液体玻璃风格 UI - 高斯模糊、半透明渐变、液态光斑动画
• ❓ 智能意图询问系统 - 首次访问强制弹出用途选择
• 📦 5 种预设套件 - 开发者/创作者/数据分析师/学习助手/通用增强
• ⚡ 自动安装引擎 - 根据选择自动配置插件组合，实时进度显示
• 🖼️ 自定义背景系统 - 支持图片/视频上传，预设壁纸库
• 💼 主工作台界面 - 聊天区域 + 插件面板

🛠️ 开发指南

前置要求

• Node.js: ^22.19.0 || >=24.0.0
• pnpm (推荐)

项目结构

dsh-webui-plugin/
├── package.json           # 清单 (含 dsh 声明)
├── cordis.patch.yml       # bundle 型需要
├── src/
│   └── index.ts          # 插件本体
└── lib/                   # 构建输出

快速开始

# 安装依赖
pnpm install

# 构建 TypeScript
pnpm build

# 验证插件已加载
dsh web --dump-config | grep dsh-webui

# 重启生效
dsh web

开发循环

# 监听模式开发
pnpm dev

# 热更新（仅 cordis.patch.yml 支持热更新）
# 编辑 cordis.patch.yml 后自动重载

📋 配置选项

| 选项 | 类型 | 默认值 | 说明 | |------|------|--------|------| | greeting | string | 'Welcome to DSH WebUI' | 问候语 | | enableLiquidGlass | boolean | true | 启用液体玻璃风格 | | enablePurposeSelector | boolean | true | 启用意图询问 | | presetKits | string[] | ['developer', 'creator', ...] | 预设套件列表 |

🔧 使用示例

插件会自动在首次访问 DSH WebUI 时弹出用途询问：

1. 选择用途: 开发者/创作者/数据分析师/学习助手/通用
2. 自动推荐: 根据选择推荐对应插件套件
3. 一键安装: 自动安装推荐的插件组合
4. 开始使用: 进入主工作台，加载对应插件

⚠️ 常见坑

| 问题 | 解决方案 | |------|----------| | 裸名 cordis 解析失败 | 使用 @deepseek-ai/cordis | | 未声明 inject 就访问服务 | 先 inject: ['tools'] 再 ctx.tools | | patch 路径写相对路径 | 使用绝对路径 | | 只导 Config interface | 必须导出 Schemastery schema |

📚 参考文档

• 官方教程：第一个插件
• 插件解剖
• 配置与发布

📄 许可证

MIT