前言¶
DeepSeek Harness Web 是一个智能体开发环境。在开发过程中，开发者通常需要频繁查看账户余额以控制成本，并管理工作区内的文件。现有的 Web 界面在文件导航和余额展示上存在操作层级较多的问题。dsh-custom-ui 插件通过扩展 Web 界面，直接在编辑器中提供这些功能，减少跳转开销。
插件概述¶
dsh-custom-ui 是一个为 DeepSeek Harness Web 提供自定义 UI 的插件，由用户 nailing10086-zx 维护。它主要解决 Web 端缺少文件树导航和余额实时监控的问题，通过服务端解析 API 密钥，确保安全性。
核心功能¶
-
余额监控
在编辑器的 composer 统计行显示 DeepSeek 账户余额。API 密钥仅通过凭证接口（credentialRef，来自@deepseek-ai/dsh-credentials）在服务端解析，不会传输到浏览器客户端。 -
文件树侧边栏
在界面右侧提供工作区文件树，支持折叠和展开操作。侧边栏可通过浮动按钮进行显隐切换，方便快速导航。 -
工作区文件打开
支持通过系统默认应用打开工作区内的文件或文件夹。该功能基于工作区根目录实现，并通过路径遍历检查进行防护。
安装与启用¶
- 安装插件
通过 DSH CLI 安装：
dsh plugin --profile web add dsh-custom-ui
-
重启服务
安装完成后，必须重启dsh web才能生效。 -
本地开发链接（可选）
若从本地代码检出安装，需在 package.json 中配置"dsh-custom-ui": "link:<path>"或使用pnpm link进行链接，然后重新构建。
典型用法¶
插件提供了以下 Host 路由接口：
* GET /api/custom-ui/balance：获取 DeepSeek 账户余额（需配置凭证）。
* GET /api/custom-ui/fs/list：列出目录内容（基于工作区根目录）。
* GET /api/custom-ui/fs/open：打开文件或文件夹。
适用场景与注意事项¶
- 运行环境：需要运行 DeepSeek Harness Web (
dsh web)。 - 凭证配置：余额监控功能需要配置
DEEPSEEK_API_KEY到 Harness 凭证中；文件树功能不需要该配置。 - 安全检查：文件路由基于工作区根目录，通过
resolve()和前缀检查防止路径遍历。如果未从官方仓库克隆，建议在安装前检查lib/index.js和lib/client.js源码。 - 许可证：MIT 许可证。
