前言¶

DeepSeek Harness (DSH) 的理念是「一切皆插件」。在构建智能体工作流时，我们常需要处理文档、图表或复杂的业务说明。SpecDev Workbench 是为此设计的一个插件，它将传统的文档和 Archify 图表阅读器与可交互的 3D 房间相结合。通过它，可以在空间中浏览内容，或利用 AI 技能生成可供步行的 3D 场景。

插件简介¶

SpecDev Workbench 是一个 DSH 插件，用于在 3D 空间中浏览文档、Archify 图表和房间。
* 作者：pioneer666-user
* 许可证：MIT
* 核心价值：将业务材料（文档/图表）映射为可探索的 3D 环境，支持离线阅读和场景导出。

核心功能¶

插件提供以下能力：
1. 文档与图表浏览：支持浏览 Markdown 文档、交互式工作流和生命周期图表。
2. AI 生成 3D 房间：使用 AI 技能创建 3D 房间，支持森林或陶瓷主题，内置 12 种家具模型。
3. 空间交互：在房间内步行，通过书架、桌子等物体打开材料列表。
4. 氛围控制：支持调整亮度、雨、反射和声音效果。
5. 场景导出：导出包含房间和材料的 HTML 文件，供他人在不安装插件的情况下浏览。

安装与启用¶

安装前需确保已安装 DeepSeek Harness (DSH)。该插件在 Windows DSH Desktop 和 Web 0.2.0-rc.2 上经过验证。

Windows Desktop 安装¶

在 PowerShell 中执行以下命令（请替换 $DesktopDir 为实际的 DSH 安装目录）：

$DesktopDir = 'C:\Apps\DSH' # 替换为你的 DSH 安装目录
& "$DesktopDir\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add '@pioneer_zmc/dsh-workbench@0.2.3' '--registry=https://registry.npmjs.org/'
& "$DesktopDir\DeepSeek Harness.exe"

安装完成后，在 DSH 的侧边栏中找到 SpecDev Workbench。

典型用法¶

1. 选择工作空间¶

在 DSH 中选择一个 Git 项目作为工作空间。

2. 注册材料¶

在 DSH 聊天中，使用 specdev-business 技能将业务文档和设计图注册到项目中。

3. 创建房间¶

在聊天中使用 specdev-room 技能创建 3D 房间。例如，可以指定创建森林或陶瓷主题的房间，让 AI 根据现有材料进行布置。

4. 探索与导出¶

刷新工作台，进入生成的房间进行步行交互。阅读完毕后，可导出包含房间的 HTML 文件。

注意事项¶

• 权限与网络：源链接需要网络连接和访问权限。
• 写操作范围：插件唯一的写操作是给 Git 提交挂附注标签，不会修改业务项目的文件、分支或提交。
• 兼容性：目前主要在 Windows DSH Desktop 和 Web 0.2.0-rc.2 上验证。

总结¶

SpecDev Workbench 提供了一种从平面文档向空间场景转化的工作方式。对于需要可视化展示项目材料或进行沉浸式设计的场景，它是一个实用的工具。源码位于 GitHub，可通过 DSH 生态目录查看更多信息。