Xenon Widgets

io.github.marcimastro98由 GitHub 帳號 marcimastro98 發布v1.0.0更新於 Oct 30, 2026

Build widgets for the Xenon dashboard: SDK reference, install, runtime errors, tile screenshots.

已驗證STDIO僅桌面開發者工具媒體與設計

概覽

AI 產生的概覽

為 Xenon 桌面儀表板建立、檢查、安裝與偵錯小工具,提供 SDK 文件、執行階段錯誤與磚塊截圖。

可以做什麼
  • 檢查 Xenon 是否在本機執行,並回報版本、SDK 版本、社群小工具開關與儀表板狀態
  • 閱讀 Widget SDK 參考文件,涵蓋清單、訊息協定、資料串流、動作、儲存、尺寸與沙箱規則
  • 在資料夾中產生入門小工具,並對小工具套件執行安裝前的檢查
  • 將小工具安裝或更新到儀表板,列出使用者自建的小工具或匯出其檔案
  • 檢視執行階段錯誤、被封鎖的請求、權限狀態與資源用量,並截取小工具磚塊畫面
  • 為使用者自己的小工具產生分享碼,並附上商店審查說明
適用情境
適合為 Xenon 儀表板開發自訂小工具的人,讓助理直接對執行中的應用程式完成樣板產生、驗證、安裝與偵錯,不必在編輯器與儀表板之間來回切換。
執行需求
以本機 stdio 程序執行(npm 套件 xenon-mcp),需在桌上型電腦使用,且同一台電腦需已安裝並執行 Xenon。未宣告任何驗證、環境變數或請求標頭。Linux 的 Wayland 環境下無法截圖。
安裝前請注意
安裝或更新小工具會寫入檔案並放上儀表板,其申請的權限仍須由本人在儀表板上核准。分享碼會讓任何貼進 Xenon 的人取得該小工具。小工具程式碼在沙箱中執行,若未以 try/catch 包住並用 console.error 輸出,錯誤只會顯示為籠統的指令碼錯誤。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Xenon Widgets,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

該儲存庫沒有 README。

工具

9

xenon_status

Check that Xenon is running on this computer and ready for widgets: its version, the Widget SDK version, whether community widgets are on and whether a dashboard is open. Call it first.

無需輸入參數。

sdk_reference

Read the Xenon Widget SDK reference: the manifest, the message protocol, data streams, actions, storage, sizing and the sandbox rules. With no section you get the table of contents. Read it before writing a widget.

輸入參數section

new_widget

Write a working starter widget (manifest, HTML, CSS, JS showing live CPU and memory) into a new or empty folder. Edit it from there, then install_widget.

輸入參數idnamesizefolder必填overwrite

check_widget

Run the checks Xenon runs before installing, without installing: the package rules, what the sandbox will refuse (inline scripts, remote code, hosts) and the Store's review notes.

輸入參數idfolder必填

install_widget

Install or update the widget from its folder put it on the dashboard and show its page (a new page when the one in view is full). Permissions it asks for still wait for the person to approve them on the dashboard. Then call widget_issues and widget_screenshot.

輸入參數idfolder必填

widget_issues

What went wrong in an installed widget while it ran: errors and console.error lines, requests the sandbox blocked, whether its permissions are approved, and how heavy it is. Errors thrown in widget code show as "Script error." because of the sandbox: wrap code in try/catch and console.error the message to see it.

輸入參數id必填

widget_screenshot

A picture of the widget's tile as it is on screen now. Anything on top of the dashboard shows too. Not available on Linux under Wayland.

輸入參數id必填

my_widgets

List the widgets the person made (not Store downloads). With an id and a folder, write that widget's files into the folder to keep working on it.

輸入參數idfolderoverwrite

share_widget

A share code for one of the person's own widgets, which anyone can paste into Xenon, plus the Store review notes. To put it in the Store the person sends it from xenon-app.com/submit.

輸入參數id必填

版本歷史

1
  1. v1.0.0最新Oct 30, 2026

評分

已滿足適用檢查項的 65%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。