sudoboard / sudb

它是什么

以往搭建一块数据看板，需要自行接入数据、编写页面、调试设备。使用本技能后，这些工作都交给 AI：你只需说明「要显示什么」，数据源接入、页面生成、浏览器预览与一键上屏，均由它完成。

上屏有两种方式，可任选其一，也可同时使用：

• 有设备：同步至局域网内的 SudoBoard 设备，设备屏 1 秒内自动更新，同一局域网内任何浏览器均可打开同一画面；
• 无设备：将整块看板部署到 Cloudflare（数据抓取、播放页、定时刷新均在云端），电视或浏览器打开网址即可查看，无需安装应用。

关键在于：预览与屏幕使用同一套渲染，所见即所得；不满意可继续修改，直至确认。

页面能力同样交由 AI 完成：横向瀑布流排版、折线 / 柱状 / 仪表盘等图表、多块看板轮播、深浅两套主题、数字旁的环比涨跌标注。

可以这样对 AI 说

• 「用 sudoboard 给这个项目建个数据看板，显示 GitHub Star 数、DeepSeek 余额、本周注册量」
• 「新增一个数据源：抓取官网每日访问量，每 5 分钟更新」
• 「页面改为浅色主题，数字字号再大一些」
• 「增加一个柱状图，展示最近 7 天趋势」
• 「再建一块销量看板，与上一块排入轮播，每屏停留 30 秒」
• 「我没有电视，请直接部署到 Cloudflare，给我一个可访问的网址」
• 「请把配置打包，我要装到客厅的电视上（它不在同一网络）」

如何安装

最简单的方式：把下面这段提示词复制给 AI 助手，它会自行下载技能、安装到技能目录并按流程执行。

请用 SudoBoard 技能帮我搭一块数据看板。

第一步 · 安装技能
下载 https://sudoboard.pages.dev/download/sudoboard-skill.zip
解压到你的技能目录，保持目录名为 sudoboard：
  · Claude Code：~/.claude/skills/
  · DeepSeek Harness：~/.dsh/skills/
确认 sudoboard/SKILL.md 存在后再继续。

第二步 · 按技能执行
完整阅读 sudoboard/SKILL.md，并严格按其中流程执行：
连接与登录 → 盘点数据源 → 生成看板工程 → 编写展示模板 → 本地预览 → 部署（Cloudflare 或同步到设备）。

第三步 · 我要展示的数据
（在这里写清指标与来源，例如：GitHub Star 数、DeepSeek 余额、官网每日访问量，每 5 分钟更新）

也可以自行安装（技能随 SudoBoard 仓库分发，软链接方式，仓库更新后无需重装）：

git clone https://gitea.land.ftqq.com/easychen/SudoBoard.git && cd SudoBoard
bash skills/sudoboard/scripts/install-skill.sh          # 默认装到 ~/.claude/skills
bash skills/sudoboard/scripts/install-skill.sh --host dsh   # 或装到 ~/.dsh/skills
bash skills/sudoboard/scripts/install-skill.sh --uninstall  # 卸载

准备工作

技能会先探测当前条件，再选择路线并全程引导。两条路线的前置条件不同：

路线 A · 部署到 Cloudflare（无需任何设备）

• 一个可从公网访问的网页接口（返回数据，不要求同一网络）；
• 本机已安装并登录 Cloudflare 命令行工具 wrangler（部署时用于创建云端资源）；
• 可选：一个 Cloudflare 授权令牌，用于为线上看板设置访问限制（仅允许指定邮箱访问）。

路线 B · 同步到局域网设备

• 一台已安装 SudoBoard 的设备（旧手机 / 电视 / 盒子），已完成首次启动并正在运行；
• 设备与电脑处于同一局域网（跨网络安装电视时，可使用打包直链方式，不要求同一网络）；
• 设备已开启局域网访问（在设备的「菜单 → 进入管理 → 设备信息」中打开）；
• 管理密码（即首次启动引导时设置的密码，AI 需要它完成登录）。

常见问题

修改看板后如何生效？

让 AI 再改一次即可：设备方案修改后设备屏即时更新，无需重启或接触设备；Cloudflare 方案重新执行一次部署命令即可，同名覆盖更新。

没有电视或旧手机，可以使用吗？

可以。技能会将整块看板部署到 Cloudflare，数据抓取、播放页与定时刷新均在云端运行，打开网址即可查看，无需任何设备，也无需安装应用。

部署到 Cloudflare 后，谁可以访问？

默认对公网可见，技能部署完成后会明确提示，并提供 Cloudflare 访问控制（Access）的做法：仅允许指定邮箱或邮箱域名访问。若数据敏感且不希望上云，可只采用设备方案。

可以放多块看板轮流播放吗？

可以。对 AI 说「再做一块销量看板，两块排进轮播」即可：设备端支持多屏轮播与转场；Cloudflare 方案只服务主看板（其余看板技能会提示改用设备方案）。

深色看板看起来发灰怎么办？

技能会在模板中显式声明深浅色，并自动检查其与看板主题是否一致，不一致时会当场提示——直接对 AI 说「这块改成浅色」即可。

设备连不上怎么办？

请先确认设备正在运行、与电脑处于同一局域网，并已在「设备信息」中打开「局域网访问」。技能也会逐步协助排查。

电视与电脑不在同一网络，可以安装吗？

可以。由 AI 将配置打包为直链，电视首次开机时选择「从看板包恢复」，粘贴地址并输入打包时设置的密码，即可自动完成部署。

数据安全吗？

设备方案：数据源的账号与密码仅保存在设备本地，打包传输时加密；数据库连接默认只读，AI 不会修改你的数据。
Cloudflare 方案：接口凭据仅存在于云端服务端配置中，播放页与公开查询地址均不会下发，可配合 Access 限制访问者。

这个技能收费吗？

技能本身是 SudoBoard 项目的一部分，免费使用。AI 助手端是否收费，取决于你所使用的 AI 服务。