前言¶
在《原神》千星奇域 UGC 编辑器里搭玩法，常见问题不是「会不会连线」，而是「这个触发器为什么不生效」「运动器参数该怎么填」「官方文档在哪一段」。节点类型多、排障语境又碎，单靠通用大模型容易猜参数或漏掉官方说明。下面介绍 SkillHub 上的 千星沙箱知识库（@user_3a6be892/miliastra-toolbox），它把节点用法、官方指南与语义检索打包成 Agent 可调用的知识能力，专门服务服务端节点图与玩法逻辑相关问题。
这是什么¶
千星沙箱知识库是 SkillHub 分类为 knowledge-management 的社区 Skill（发布者 user_3a6be892，当前版本 1.2.0）。一句话定位：查询千星沙箱（原神千星奇域 UGC 编辑器）知识库，覆盖节点用法与参数、官方指南/教程/FAQ，并支持语义检索。
它解决的是「问节点、查文档、拆需求、排障」时信息分散的问题；标签标明 requires_api_key=false，安装后无需额外 API Key 即可按 Skill 说明使用。
核心功能¶
依据 SkillHub 页面与已抓取简介，已核实的能力包括：
- 节点用法与参数：面向触发器、运动器、造物、仇恨、商店、背包等千星沙箱节点，回答怎么用、参数含义是什么。
- 官方文档聚合：可检索官方指南、教程、FAQ 等文档内容，减少自己在站内反复搜索。
- 语义检索：用自然语言描述玩法或问题，从知识库中匹配相关条目，而不必死记节点英文名。
- 需求拆解：当要把玩法需求落成具体节点组合时，Skill 会引导对照参考文档与节点选型。
- 排障导向：适合「为什么不触发 / 不生效」类问题，在服务端逻辑语境下查原因与配置要点。
范围说明（重要）：仅覆盖 服务端节点图与玩法逻辑，不含客户端控件与客户端脚本（lua）。界面与客户端 Lua 问题应改用同系列的 miliastra-knowledge-lua。
安装与启用¶
SkillHub 官方给出的安装方式是：让当前使用的 AI Agent 按安装文档拉取该 Skill。
方式一：提示词安装（页面推荐）
把下面提示发给支持 Skill 的 Agent（Cursor、Claude Code、Codex CLI 等，以各自是否支持 SkillHub 为准）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3a6be892/miliastra-toolbox`。
方式二：SkillHub CLI
先确认本机已安装 skillhub（安装步骤见 SkillHub 安装与优先源配置）。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
command -v skillhub && skillhub --version
skillhub install user_3a6be892/miliastra-toolbox --dir <当前 Agent 的 skills 目录>
常用 skills 目录示例（来自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
装好后按你所用客户端的规则重启或刷新 Agent，使 Skill 生效。Cursor / Codex CLI / Claude Code 在「是否内置 SkillHub、是否要重启」上的细节以各自当前文档为准；本文只保留 SkillHub 已写明的路径与命令。
典型用法¶
Skill 的触发条件写在官方简介里，可直接当作对话示例复现（无需编造具体关卡名或用户故事）：
- 问单个节点：例如询问某类触发器、运动器、造物节点的接法与参数含义。
- 查编辑器配置：询问千星奇域编辑器里与玩法逻辑相关的功能配置项。
- 排障：描述「条件满足但不触发」「逻辑写了但不生效」等现象，让 Agent 在知识库中查常见原因与检查项。
- 拆玩法：用自然语言描述目标玩法，请 Agent 拆解为节点步骤并附上可参考的官方文档方向。
对话时尽量说明是 服务端节点图 问题；若涉及 UI 控件或客户端 Lua，应切换到 miliastra-knowledge-lua，避免在本 Skill 范围内得到不完整答案。
适用场景与注意¶
适合谁
- 正在用千星奇域 UGC 编辑器做关卡、规则、战斗或经济玩法的创作者。
- 需要在 Agent 里快速查节点参数、官方 FAQ，或把口述需求对齐到节点图的开发者。
限制与注意
- 知识范围止于服务端节点图与玩法逻辑；客户端界面与 Lua 不在本 Skill 内。
- 社区来源（
community），内容与游戏版本、官方文档更新节奏相关，关键逻辑仍建议对照游戏内编辑器与最新官方说明。 - SkillHub 统计（截至页面展示）：评分 100000，下载 2020，安装 36；安装量不高时，更宜把它当作「文档与节点检索层」，而不是替代你自己的测试与验证。
结尾¶
千星沙箱知识库把节点说明、官方文档与语义检索收敛成一个 Agent Skill，适合在搭玩法、查参数和排「不触发」问题时挂在对话里用。官方入口：
- Skill 包地址：https://api.skillhub.cn/user_3a6be892/miliastra-toolbox
- SkillHub 页面：https://www.skillhub.cn/skills/user_3a6be892/miliastra-toolbox
