dsh-houdini

dsh-houdini

用自然语言构建、检查和维护可编辑的 Houdini 工程。

dsh-houdini 将 Houdini 的真实场景接入 DeepSeek Harness Desktop。在同一份对话中描述目标，Agent 可以读取场景、创建和修改节点、调整参数、制作工具，并根据实际执行结果继续迭代。

主要产物保留为原生节点网络、控制参数、关键帧、HDA 和工程文件。你可以查看构建过程、手工编辑结果，也可以继续通过对话提出修改。

核心能力 · 快速开始 · 工作原理 · 文档

核心能力

能力	可以完成的工作
场景理解与诊断	读取节点、参数、连接和几何信息，检查 Cook 错误与依赖，结合界面截图和预览定位问题。
程序化建模	使用 SOP、属性、VEX 和 Python 搭建可编辑网络，暴露控制参数，进行局部修改与几何检查。
HDA 与艺术家工具	将流程封装为 HDA，制作参数界面、Shelf、Python Panel、Viewer State 和 Package，组织源码、资源与使用入口。
材质、灯光与渲染	处理 UV 与贴图，搭建 MaterialX / Solaris / Karma 工作流，配置相机、灯光并生成预览或渲染输出；按需使用 COP 图层与图像处理。
参数控制与动画	设置参数依赖和关键帧，组织机械层级、绑定与动画网络，观察控制量变化后的实际输出。
参考资料辅助	使用图文、参考图和视频资料辅助工作；通过配置的模型生成或编辑图片，转录讲解、抽取画面并整理有来源依据的步骤。
工程组织与交付	整理节点命名、分组、子网、输出和资源路径，保存 HIP、工具源码与相关文件，便于继续修改和复用。
长任务与执行接续	通过 DSH 后台任务观察渲染或计算，查回原请求结果，在独立 Houdini 进程中构建与验证，并查看执行记录和错误。

这些能力可以组合使用：从检查现有网络开始，逐步改成参数化资产，再封装为工具；也可以从参考资料出发，构建场景并制作展示。具体方法由 Agent 根据你的目标、已有工程和当前可用能力选择。

快速开始

环境要求

项目	支持范围
操作系统	Windows x64
宿主	0.1.8：DSH 0.2.2-rc.1。DSH 0.2.1-rc.5 / rc.3 用户须精确选择旧版 0.1.6，升级插件前先确认宿主版本；精确兼容范围与验证边界见兼容清单
Houdini	21.0 / 22.0；构建兼容信息见安装说明
模型	在 DSH 中配置可用的主聊天模型；图像理解、生图和语音按所用模型与服务的实际能力配置

安装

1. 安装兼容的官方 DSH Desktop 和 Houdini，在 DSH 原生模型设置中配置主模型。
2. 在 Desktop 的 插件 → 添加插件 → 包名或地址 中填写下方完整地址，点击 安装；也可下载正式发布页的 .tgz，填写文件的本地绝对路径。
3. 点击 立即启用，或在插件列表启用 dsh-houdini。

https://github.com/eee1723/dsh-houdini/releases/download/v0.1.8/dsh-houdini-0.1.8.tgz

GitHub 正式包及校验文件提供完整安装包，无须解压或运行脚本。地址安装的后续版本按更新说明在原生插件管理中处理。

使用npm 包名安装前，须确认所选源已公开目标版本，且该版本支持当前 DSH。仅填写 dsh-houdini 会查询该源的 latest，不会自动寻找兼容当前宿主的版本。镜像缺少已公开版本时可切换官方源；上游尚未公开的版本须使用已有的正式安装地址，不能靠换源取得。

新装插件默认停用，启用后才会提供 Houdini 模式。完整包包含 FFmpeg / ffprobe，普通 Python 自动从 Houdini 安装定位；使用插件无需另装 Node、编译源码或配置 FFmpeg PATH。

安装、组件更新、旧入口迁移及卸载详见安装与使用指南。

连接场景

入口	操作方式
从 DSH Desktop 进入	新建或选择 Houdini 模式 的对话，在工程控件中绑定已连接窗口，或选择 Houdini 安装后新建场景、打开 HIP。
从 Houdini 进入	使用 DSH-Houdini → Open Workspace，根据当前工程进入同一个 Desktop 中的对应 Houdini 对话。

插件启用或更新后会自动安装／更新连接组件，新建工程复用同一准备过程，通常不需要手动安装。已有窗口若仍加载旧组件，保存并重开对应窗口即可；准备失败时工程菜单会提供重试。每段对话可以明确选择自己的工程；打开其他 HIP 默认使用新进程，保留已有窗口。

Houdini 相关控件随当前对话的 Houdini 模式 显示，其他模式继续使用 DSH 原有界面。多工程选择、工作区与工程接续见工程使用说明。

Windows Desktop的Houdini模式提供 置顶 按钮，便于同时操作场景和对话；返回其他模式时恢复原来的窗口层级。需要ChatGPT/Codex订阅时，可通过官方插件管理安装社区插件 dsh-codex-subscription@3.1.8；它独立授权和维护，不随Houdini发行包捆绑，模型仍从DSH原生菜单选择。

使用示例

可以直接描述目标、要修改的范围和希望保留的内容。例如：

创建参数化资产

在当前场景中新建一套螺旋楼梯，暴露踏步数、宽度和总高。保留可编辑的 SOP 网络，并检查改变参数后踏步之间的关系。

检查和修改已有网络

检查我选中的节点链为什么没有几何输出。在这条链内定位并修复问题，保留其他网络，说明改动和检查结果。

制作可复用工具

把这套生成器封装为 HDA，整理输入输出和参数界面，在新实例中检查，并说明文件位置和加载方式。

完成材质与展示

在这个已保存的工程中，为选中资产配置 MaterialX 材质、Karma 灯光和相机，输出一张预览，检查材质绑定与渲染错误。

利用教程资料

分析这个视频中的构建方法，先整理关键步骤、参数和来源时间，再在 Houdini 中分阶段复现，标出原视频中看不清的部分。

任务可以从观察、构建、修改或排错中的任意一步开始。修改现有工程时，请明确对象和范围；交付时可以要求 Agent 展示关键网络、控制参数、实际输出与文件位置。模型提出的方案仍应结合几何、画面和工程检查判断效果。

工作原理

DSH 提供对话与通用 Agent 能力，插件将模型的操作连接到真实 Houdini。工程操作的主要链路如下：

flowchart LR
    subgraph desktop["DSH Desktop"]
        A["会话 · 模型 · Agent 任务"] <--> B["dsh-houdini<br/>上下文 · 工具 · 按需技能"]
    end
    subgraph houdini["Houdini"]
        C["Bridge<br/>主线程执行队列"] <--> D["HOM 与操作能力库<br/>节点 · 参数 · 几何 · 场景"]
    end
    B <-->|本机 HTTP| C

部分	职责
DSH Desktop	管理模型、账户、凭据、会话、工作区和通用任务，承载用户与 Agent 的持续交互。
插件适配层	提供 Houdini 模式、工程上下文、工具与界面，按任务加载领域技能，呈现执行结果。
Houdini Bridge	在 Houdini 内接收请求，核对工程身份与操作范围，通过主线程队列执行操作并返回真实结果。

Houdini 的 Python API（HOM）只在 Houdini 侧运行。媒体准备在普通 Python 工作进程中执行，独立构建与验证使用一次性 Houdini 进程；它们与当前场景的主线程执行分开。

执行结果、错误、图片和文件返回原对话，支持在实际结果上继续修改。请求响应丢失时可以查回原请求，减少重复操作；长任务由 DSH 跟踪，同一 Houdini 工程中的操作仍按队列串行执行。

详细职责与源码入口见系统架构，工具参数见工具说明与操作能力目录。

模型与扩展配置

主聊天模型、账户和凭据统一在 DSH 原生设置中管理。需要看图时使用具备图片输入能力的模型；图片生成或编辑可使用单独配置的图片服务。

语音转录在实际需要时配置。在任意模式的 设置 → 教程视频 选择地址来源、实际协议和准确模型，确认调度后直接保存，无须先发起模型对话；对话中也可让 Agent 使用同一份配置。API Key 直接在安全输入框录入 DSH 凭据服务，不作为聊天答案。

已有 DSH 提供方可以明确复用，独立语音服务也可按实际接口接入。只做媒体解析不必先连接场景。配置方法、依赖与接口范围见模型及媒体设置。

文档

入口	内容
安装与使用	安装、连接、更新、迁移、模型配置与卸载
多工程与接续	多窗口、明确绑定、工作区和工程恢复
工具说明	工具职责、参数与返回
操作能力目录	节点、参数、几何、资产、观察与渲染操作
工程文件与输出	HIP、图片、资源及输出目录
执行记录与诊断	Trace 中的执行、资料与诊断信息
故障报告	收集、检查和导出诊断资料
文档索引	完整设计、接口与维护说明

按需加载的领域技能

领域	用途
任务拆分	按目标与依赖组织模块、观察和集成
独立执行	在独立 Houdini 进程中构建与验证
SOP	程序化建模、曲线与几何操作
外部资产接入	生成／导入模型的组件替换、材质、实例与高低模；含离线GLB资源整理
模拟	反馈求解、时序、缓存与模拟修改
表面外观	参考图、表面细节、UV 与贴图
COP	按需进行图层与图像处理
工具开发	HDA、脚本、面板与工具交付
参数界面	控制参数、界面组织与绑定
网络交接	节点入口、分组、说明与布局
Rig 与动画	骨架、层级与动画
Solaris 与 Karma	材质、USD 与渲染
视频教程	转录、画面依据与教学工程
Trace 分析	查看请求、工具调用和失败原因
知识维护	按明确请求维护领域资料

开发与反馈

源码构建与检查：

npm install
npm run build
npm run docs:check
npm test

扩展职责、接口和验证方法见开发规范与架构代码地图。问题和建议可以提交到 GitHub Issues；报告时请说明操作目标、版本、现象和复现步骤，并按故障报告指南检查需要分享的内容。