dsh-houdini

DeepSeek Harness的Houdini插件，提供场景读取、节点操作、执行记录和领域资料。目标是帮助用户在真实Houdini中做出可编辑、能继续修改的工程与工具。

插件仍在完善，复杂任务的稳定性、成品质量和后续修改效果需要继续验证。试用时建议先在练习工程里做容易检查的小任务，按实际结果判断哪些部分有帮助。

DSH负责模型、会话和Agent循环；插件提供真实场景信息、批量操作、执行反馈、图像与文件。Houdini界面只显示 Houdini 模式，按任务读取领域知识。

工具

工具分别负责现场观察、执行、原生界面截图、请求查回、历史资料、图像通道和长任务控制。每个工具为何存在、输入和返回详见工具说明，在界面的 Houdini 工具 页也可以查看。

Python能力目录见动词词表。陌生节点可用node_info，准确动词签名可用verb_help；对象父级使用set_object_parent。构造方法与操作顺序由模型根据任务选择。

启动

用户安装使用正式发行包与安装说明。正式包、源码和当前已加载版本分别判断。

源码开发只用npm：

npm install
npm run build
python houdini/install.py

完整重开Houdini，点击 DSH-Houdini → Open Workspace。已保存 .hip 的父目录成为DSH workspace；未命名场景使用仓库外scratch。切换HIP后再次打开工作区即可选择对应任务。

本项目锁定官方 DSH 0.2.0-rc.2，由兼容清单决定启动/修复版本。唯一Houdini preset通过插件bundle声明式注册，源码在presets/houdini。

Host/Bridge/helper重载使用 Version & Updates → 高级设置 → 运行诊断 → 修复并重启运行环境；客户端、menu或package变化需要完整重开Houdini。构建通过不能证明已有进程加载了新代码。

领域资料

资料	用途
SOP	程序化模型、局部修改和几何观察
COP（按需能力）	程序化贴图和图层；完整材质与教程交付仍待验收
工具开发	HDA、脚本、界面、回调和交付
参数界面	共享控制与参数绑定
网络交接	主动节点入口、跨领域分组说明与布局观察
Rig与动画	动画、骨架和运动
Solaris与Karma	材质、USD与正式渲染
视频教程	资料读取与教学工程
Trace分析	查看实际请求、工具调用与失败
知识维护	显式维护领域资料

开发

长期入口：文档索引、系统架构、维护规范。未完成验证见交接。

npm run build
npm run docs:check
npm test

验证按实际改动选择；执行内核使用必要的隔离HOM回归。实际建模质量和运行耗时由真实任务测量，代码与测试数量不能代替成品结果。

HOM在Houdini主线程串行执行，长任务通过队列提交。请求未知时查回原回执，错误和恢复状态如实返回；几何测量、图像观察与文件保存各自说明范围。