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 分

    请在仓库或注册中心条目中声明许可证。