DSH 插件开发工作空间

基于 deepseek-harness（DeepSeek 官方 Agent Harness）的插件开发工作空间：官方源码以 submodule 隔离管理，插件在 plugins/ 下独立开发、通过 profile 挂载运行。

结构

dsh-work/
├── deepseek-harness/         # 官方源码（git submodule，服务与依赖都在这里）
├── plugins/
│   └── brand-profile/        # 品牌定制插件（见下）
├── .agents/notes/            # 开发日志（Agent Note，仿 harness 规范，中英双版）
├── AGENTS.md                 # 协作说明：环境、命令、API 契约
└── LICENSE                   # MIT

插件

brand-profile

DSH Web GUI 的可配置品牌插件，一张「设置 → 通用」卡片定制全部品牌元素：

• 侧边栏品牌名 / Logo（图片 URL 或 emoji，折叠栏同步）
• 新会话中央 Logo 与大标题
• AI 思考中文案、浏览器标签页标题
• favicon 跟随 Logo（emoji 自动栅格化为 PNG）
• Logo Emoji 为弹出式分类选择器（8 分类精选，零依赖）

所有值留空即回归官方 UI；设置持久化在 ~/.dsh/settings.yaml，即时生效。

快速开始

# 1. 初始化 submodule 与依赖
git submodule update --init deepseek-harness
cd deepseek-harness && pnpm install && pnpm run build:lib:host

# 2. 启动 Web 服务（输出 http://127.0.0.1:3080/?token=…）
pnpm dsh web --no-open

插件以 link: 挂在 ~/.dsh/profiles/web/package.json，改代码后重新构建、刷新页面即生效（patchReload: live）。

构建插件

cd plugins/brand-profile
node build.mjs <esbuild.exe>
# esbuild.exe 取自 deepseek-harness/node_modules/.pnpm/@esbuild+win32-x64@*/…/esbuild.exe

DSH 沙箱封禁 esbuild 的 JS API service pipe，必须直调二进制。

注意事项

• alpha 通道 API 漂移：harness 处于 0.1.2-alpha 阶段，升级 submodule 后先核对插件占用的 API
  （slot 契约、模块表种子、settings API）再重新构建——经验记录见
  Agent Note。
• 客户端模块表契约：插件浏览器半区的外部依赖只能是 react、@deepseek-ai/* 平台种子词。

许可证

MIT