dsh-plugin-miliastra-toolbox

在 DeepSeek Harness 里直接问千星沙箱（原神千星奇域 UGC 编辑器）的问题：节点用法与参数、官方指南 / 教程 / FAQ、玩法排障。覆盖 300+ 篇官方文档，另含 10 篇客户端控件与客户端脚本（lua）文档。

dsh plugin --profile web add github:1475505/dsh-plugin-miliastra-toolbox
dsh web

能问什么

装好之后，正常聊天就行，问法不用特殊：

• 「角色实体和玩家实体有什么区别？」
• 「复杂造物怎么做定点位移？」
• 「我的碰撞触发器不触发是为什么？」
• 「嘲讽目标节点的参数是什么？」
• 「奥黛塔的经典模式 ID 是？」
• 「预设按钮控件的四种状态怎么配？」（2D + lua 场景）

和直接问模型有什么不同：答案取自知识库原文，不是模型的记忆。查节点会附上归属端（服务端 / 客户端 / 双端）和来源文档路径；查文档返回正文全文，可以自己核对。版本更新过的内容也不会答成旧版。

安装

前置条件

• 已安装 DeepSeek Harness，Node 22.19+
• Harness 版本落在支持区间内：0.1.0-rc.6 起、含 0.2.x。区间外的版本 dsh plugin add 会按 peer 校验判定「不兼容」并直接拒绝安装（可用 dsh plugin allow-version <pkg>@<ver> --dsh-version <ver> --accept-risk 逐版本强制放行）
• 能访问知识库 https://ugc.070077.xyz

方式一：装成插件（推荐）

一条命令写进 profile，之后每次启动自动生效：

# 从本仓库安装（建议固定 commit：#<sha>）
dsh plugin --profile web add github:1475505/dsh-plugin-miliastra-toolbox

# 本地路径（开发调试时）
dsh plugin --profile web add /path/to/dsh-plugin-miliastra-toolbox

dsh web   # 启动即带插件

卸载：

dsh plugin --profile web remove dsh-plugin-miliastra-toolbox

方式二：临时试一下（不改动任何配置）

仅本次启动生效，插件路径必须是绝对路径：

dsh web --patch /path/to/dsh-plugin-miliastra-toolbox/cordis.yml
dsh --profile headless --patch /path/to/dsh-plugin-miliastra-toolbox/cordis.yml "嘲讽目标节点的参数是什么"

装进来了什么

6 个工具

模型会自动选用，不需要你指定名字。

工具	用途
get_node_info	按节点名查功能、参数、归属端（服务端 / 客户端 / 双端）与来源文档
list_documents	按关键词列出文档标题（不含正文），不确定文档名时先看有哪些
get_document	按标题获取官方文档全文
rag_search	自然语言语义检索文档片段，适合开放问题与排障
list_client_documents	按关键词列出客户端控件 / 客户端脚本文档标题，仅 2D + lua 场景
get_client_document	按标题获取客户端控件 / 客户端脚本文档全文，仅 2D + lua 场景

2 个技能（按场景分流）

• miliastra-knowledge（通用）：服务端节点图、系统配置、排障。模型遇到相关问题会先加载技能正文，按其中的指引（工具选型、批量原则、输出规范）调用工具。不涉及客户端工具。
• miliastra-knowledge-lua（仅 2D + lua 脚本）：客户端控件与客户端脚本（lua）编程，是 list_client_documents / get_client_document 的唯一入口。

也可以主动指定：「用 miliastra-knowledge-lua 技能查一下」，或发送 /miliastra-knowledge-lua。

为什么要分两个：服务端节点图和客户端 lua 编程是两套完全不同的 API 与概念。分开注册可以让通用问题不加载 lua 语料，避免模型在错误的语料里找答案。

配置

在 profile 的 cordis.patch.yml 里覆盖插件行配置（不需要可跳过）：

- insert:
    - id: miliastra-knowledge
      name: dsh-plugin-miliastra-toolbox
      config:
        baseUrl: 'https://ugc.070077.xyz'  # 知识库服务器地址
        timeoutMs: 30000                    # 单次工具调用的超时预算（毫秒）
        clientTools: true                   # 是否注册仅客户端 lua 场景的 2 个工具（list/get_client_document）

clientTools: false 适合只做服务端玩法、完全不需要 lua 文档的场景——这 2 个工具会彻底不注册。

常见问题

查节点查不到，但文档里明明有？ get_node_info 只索引节点图节点；编辑器组件和概念 / 功能章节不在其中（例如「投射运动器」是组件）。这类内容用 get_document 或 list_documents。

get_document 只返回了一串标题？ 单个关键词命中超过 5 篇时会返回 status: too_many 和标题列表，换更精确的关键词重查即可。

list_client_documents 一直返回空？ 它读的是服务端 knowledge/Miliastra-knowledge/client/ 目录（10 篇）。这个目录如果没同步到部署环境就会恒空——属于部署问题，不是你的用法问题，见 #2。

答案里有重复条目或标题末尾带 \？ 上游知识库的数据质量问题（同一节点挂在多个章节下会重复返回），已记录在 #2。插件按设计原样透传 API 返回，不在客户端侧改写。

进阶：不装插件，只用技能

…