前言¶
在《原神》千星奇域 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
