dsh-UEAssetsOperator 面向 DeepSeek Harness(DSH)的 Unreal Engine .uasset 检查与蓝图节点编辑插件。 - lib/index.js 导出 nameinjectapply,不需要安装额外 npm 运行时依赖。 - 通过 ctx.tools.register() 注册原生工具 ue_uasset_inspectue_blueprint_python_edit。 - 当用户消息出现 .uasset / .uproject / /Game/...、Blueprint / DataTable(含 蓝图 / 数据表)等明确意图,或 UE 项目目录中的 BP_* 等资产名时,插件会主动注入上述两个工具 schema 和完整 ue-uasset-operator 操作说明,引导模型直接调用原生工具而不是用 strings、十六进制或自写脚本解析 .uasset。 - 资产路径解析始终从会话工作目录或最近的 .uproject 根开始做有界搜索, 禁止 find /、盘符根或整个引擎目录的全盘扫描;工作区未命中时报告缺失 路径,而不是扩大扫描范围。 - 当宿主提供 skills 服务时,通过 ctx.skills.register() 注册配套的 DSH 内置操作说明;仅提供 tools 的极简宿主仍可使用原生工具。 - skills/ue-uasset-operator 保存 PowerShell 启动器、Unreal Python 检查器、受限蓝图编辑脚本及参考文档。 插件支持三种检查模式: | 模式 | 行为 | |---|---| | resolve | 只解析 .uproject、UE 版本和虚拟包路径,不启动 UE | | registry | 通过 Asset Registry 读取类型、标签、依赖和引用,默认模式 | | load | 加载 UObject,额外读取选定属性和元数据 | ## 安装到 EAC 先将仓库克隆或复制到固定目录: powershell git clone https://github.com/QSWWLTN/dsh-UEAssetsOperator.git X:\Tools\dsh-UEAssetsOperator C:\Users\<用户名>\.dsh\profiles\web\cordis.patch.yml 中加入: yaml - insert: - id: ue-uasset-operator name: 'file:///X:/Tools/dsh-UEAssetsOperator/lib/index.js' 如果已经存在 id: ue-uasset-operator,只替换该行的 name,不要再添加第二个 insert 块。重启 EAC 后生效。这个入口没有额外 npm 运行时依赖,Cordis、工具 和技能注册表由 EAC 宿主提供。 路径中的空格必须按 URL 规则编码,例如 Deepseek%20Harness%20EAC。Windows 盘符路径使用三个斜杠的 file:///X:/... 形式。 ## 安装到普通 DSH 环境 ### 推荐:bundle 安装 插件包含 cordis.patch.yml bundle。环境已经安装 dsh CLI 与 pnpm 时, 可以直接安装到目标 profile: powershell dsh plugin --profile my-profile add X:\Tools\dsh-UEAssetsOperator 该命令会把插件安装到 profile 的依赖中,并自动写入 dsh.profile.bundles。发布到 npm 后也可以按包名安装: powershell dsh plugin --profile my-profile add @deepseek-dsh-desktop/dsh-ue-uasset-operator EAC 安装包未附带 pnpm,应使用上一节的 profile patch 方式。不要同时使用 bundle 和手工 insert 块,否则 DSH 会因重复 loader id 拒绝启动。 ### 外部 patch 开发时也可以把同样的 insert 块保存为 ue-assets.patch.yml,再启动独立 DSH: powershell dsh web --patch X:\Tools\ue-assets.patch.yml --host 127.0.0.1 --port 0 在插件清单中确认 ue-uasset-operator 已加载。随后模型可以调用 ue_uasset_inspectue_blueprint_python_edit;也可以显式调用 ue-uasset-operator 配套技能。 ## 极简模式与 Anchored Standard - 官方极简模式和 极简模式_win 会继承全局注册的两个 UE 工具,可以直接 调用。 - Anchored Standard 会按上文规则在检测到 .uasset 意图时主动把 ue_uasset_inspectue_blueprint_python_edit 加回当前工具 schema, 因此命中的那一轮即可直接调用,不必等待解锁。 - 若两个 UE 工具因宿主策略仍未出现,进入提升阶段后先通过 skill_search / skill_load 加载 ue-uasset-operator;随后调用: json {"toolNames":["ue_uasset_inspect","ue_blueprint_python_edit"]} 这是 dev_tool_search 的精确解锁参数,工具会从下一轮开始出现。不要把两个 工具名拼成一个自由文本 query,该模式的搜索会要求所有关键词同时命中 同一个工具。 ## 前置条件 目标 .uasset 通常应位于项目或插件的 Content 目录中,并保留同名 .uexp.ubulk.uptnl sidecar。项目需要安装匹配的 Unreal Editor, 且 PythonScriptPlugin 应已启用;插件不会自动修改 .uproject。 ## 开发验证 在插件目录运行: powershell npm test