前言¶
在 DeepSeek Harness(DSH)里做智能体开发,项目目录、历史会话和手头待办往往分散在宿主默认界面与各自入口中;切换上下文时,要找「这个项目上次聊到哪」「还有没有未完成的项」,成本不低。DSH 生态强调「一切皆插件」——能力以插件形式挂接,社区目录由独立站点维护,与 DeepSeek / 幻方无官方从属关系。
下面介绍维护者 zhileyo 发布的客户端插件 dsh-workbase(仓库 zhileyo/dsh-workbase):在 DSH 内提供统一工作台,集中管理项目、会话与待办,并为 Agent 暴露在当前项目中创建与更新任务的工具。目录页见 SkillHub · dsh-workbase。
这是什么¶
dsh-workbase 是 DeepSeek Harness 的工作台插件,npm 包名为 dsh-workbase(资料中版本 0.3.1,许可证 MIT)。项目、待办和设置由宿主持久化;未提交草稿及滚动位置保存在当前浏览器。
核心功能¶
项目管理¶
支持宫格与列表视图,可添加目录、新建项目、重命名、移除、置顶、收藏,以及归档与恢复;归档后项目变为只读,可随时恢复。
会话管理¶
可查看最近会话、按项目浏览,支持重命名、归档、置顶及收藏;可从工作台选择 Agent 模式和模型发起会话。
待办管理¶
支持创建、编辑、备注、完成、重新打开、删除确认及撤销。
分支与工作树¶
输入卡下方显示当前分支。宿主启用 experimental-forge-bundle 时,可指定基准分支并在新工作树中发起会话;非 Git 项目自动降级为普通发起。
全局搜索¶
可搜索项目、会话标题与正文、待办标题与备注,并跳转到对应内容。资料注明:会话正文搜索要求宿主索引 openAt 为 first-search 或 startup;默认 never 时正文搜索不可用,且插件不会自动修改宿主配置;正文搜索最多返回 20 条结果。
工作台设置与界面¶
首页模块、主题、项目根目录、Agent 权限及布局偏好可配置;通用设置支持侧边栏名称(默认「项目概览」)、侧边栏入口和会话 Header 工作台按钮显隐。配色主题包括跟随 DSH、DSH 默认、清爽、温暖阅读、紫晶工作台;明暗外观跟随宿主,支持即时预览与保存。布局为响应式:双栏列表或整体卡片,窄屏切换会话与待办页签;断点按面板宽度计算,不依赖浏览器视口。
环境要求¶
| 项目 | 要求 |
|---|---|
| DeepSeek Harness | 当前适配 0.2.2-rc.1 |
| Cordis | ~4.1.0 |
| Node.js | 本地开发使用 22 或以上 |
| 运行环境 | Web;桌面 profile 验收进行中 |
安装与启用¶
插件以当前 DSH 进程权限运行;安装前应查看仓库源码与 LICENSE,确认许可与行为符合你的环境。
从 npm 安装(推荐)¶
已发布到 npm,安装最新版并启动 Web profile:
dsh plugin --profile web add dsh-workbase
dsh web
需要固定版本时,将包名写成 dsh-workbase@<版本>;桌面端将命令中的 web 替换为实际运行的 profile。
本地安装包¶
在源码目录先构建再打本地包(npm pack 不会触发构建):
npm pack
dsh plugin --profile web add ./dsh-workbase-<版本>.tgz
dsh web
将 <版本> 换成 npm pack 实际输出的版本号。
本地链接开发¶
在插件源码根目录:
dsh plugin --profile web add "$(pwd)"
dsh web
改动源码后需重新构建并重启宿主。
Agent 工具¶
Agent 通过以下工具操作所属会话的当前项目;不能删除待办,状态修改受项目权限设置控制。
| 工具 | 功能 |
|---|---|
workbase_list_todos |
查看当前项目待办 |
workbase_create_todo |
创建待办 |
workbase_update_todo |
更新待办内容或完成状态 |
典型用法:在已绑定项目的会话中,让 Agent 列出待办、创建新项或标记完成;具体调用方式遵循 DSH 宿主对插件工具的定义。
适用场景与注意¶
适合谁:长期在 DSH 中维护多个本地或工作区项目、需要按项目组织会话、并希望人与 Agent 共用同一套待办视图的开发者。
已知限制(摘自 README):
- 项目归档由插件自行记录,宿主原生归档接口缺失时,宿主自己的归档视图不感知该状态。
- 修改绑定目录、跨目录迁移及 72 小时撤销、会话永久删除等,因缺少安全的宿主公开接口,部分能力尚未完整对接。
- 真实模型发送、正文命中及桌面环境的部分交互仍待完整验收。
社区目录页与主库:
经过上面的步骤,可将分散的项目、会话与待办收拢到单一工作台,并在 Agent 侧用三个 workbase_* 工具与人工界面保持一致的任务上下文。