dsh-workboard

注：Agent、Prompt 快启、待处理与每日简报共用同一个默认工作区选择；待处理里的 PR 复用 GitHub widget 的查询与缓存。多个组件共用的偏好（称呼、每周起始日、城市、温度单位、格言来源）也可在「设置 → 工作台」中统一修改。版本升级新增的内置 widget 仅加入组件库，不会改动已有看板。

所有外部网络请求均由 Host 端发出并缓存：

• 天气与城市搜索：Open-Meteo，仅在设置城市后请求
• 格言：一言，仅在格言来源设为「一言」时请求，默认只取文学、诗词、哲学分类
• 诗词典籍：默认使用内置传世名篇库，不联网；仅在来源设为「今日诗词」时请求 今日诗词 公开接口（v2.jinrishici.com）
• 微信读书：榜单读取微信读书公开分类接口（weread.qq.com，非官方，缓存 30 分钟）；仅在填入 WEREAD_API_KEY（或配置本机环境变量）并切换到「书架」或「划线」时请求微信读书官方 Agent 网关（i.weread.qq.com/api/agent/gateway，缓存 5 分钟）
• 日历与订阅：仅请求列表中的 ICS 与 RSS / Atom 地址（rsshub:// 路由展开到所填的 RSSHub 实例，留空时回退 rsshub.app）；订阅 widget 默认预填爱范儿与阮一峰的网络日志（英文界面为 hnrss.org 首页），可在设置中修改
• 行情：股票走腾讯行情接口（qt.gtimg.cn），汇率走 open.er-api.com，加密货币走 CoinGecko
• GitHub：调用本机 gh CLI，复用其已有登录态
• 热榜：微博、知乎、36 氪、少数派、B 站、V2EX 使用各站公开网页接口（非官方，站点改版可能失效）；Hacker News 使用 HN Algolia API；GitHub 读取 Trending 页面；Product Hunt 与 Reddit 读取官方订阅源；结果缓存 10 分钟
• 视频订阅：YouTube 频道 RSS（仅在解析 @handle 时请求频道页）、B 站 UP 主投稿公开接口（非官方，偶尔限频），封面由 Host 代理成 data URL；缓存 15 分钟
• 播客：请求所填的 Podcast RSS / Atom 地址、小宇宙播客主页（xiaoyuzhoufm.com，非官方）或经 Apple iTunes Podcast Directory API（itunes.apple.com）解析出的订阅源与科技播客榜，封面由 Host 代理成 data URL；列表缓存 20 分钟、榜单缓存 60 分钟
• 网络：公网 IP 查询使用 ipinfo.io（失败时回退至 ip.sb），站点延迟通过 curl 测算（配置了系统代理时自动走代理），默认测百度、GitHub 与 Google（英文界面为 Google、GitHub 与 Cloudflare）
• 服务状态：请求各状态页的 Statuspage 接口 /api/v2/summary.json；DeepSeek 状态页托管在 Flashcat，没有公开接口，改为解析页面内嵌数据（非官方，页面改版可能失效）；默认 DeepSeek、Claude、OpenAI、GitHub 与 npm；缓存 2 分钟
• AI 论文：Hugging Face 每日论文与热门 Spaces 接口（huggingface.co 不通时改走 hf-mirror.com 镜像），以及 arXiv API 按领域筛选的最新论文；缓存 30 分钟
• 模型行情：OpenRouter 公开模型列表接口（无需 key）；用量 widget 开启「按 OpenRouter 公开价估算」时也读取同一接口；缓存 30 分钟
• 大模型竞技场：经 Hugging Face Datasets Server 读取 LMArena 官方发布的 lmarena-ai/leaderboard-dataset（文本、WebDev、Agent、视觉、搜索）；缓存 60 分钟
• 热门 MCP：npm 搜索接口、GitHub 仓库搜索接口 与 官方 MCP Registry；缓存 30 分钟
• 发版追踪：所填 GitHub 仓库的公开 releases.atom 订阅源（无需 key、不占 REST API 配额），默认预填 anthropics/claude-code、badlogic/pi-mono 与 deepseek-ai/deepseek-harness；缓存 15 分钟
• 包下载量：npm（registry.npmjs.org 与 api.npmjs.org）、PyPI 与 PyPI Stats、Crates.io 公开接口，默认预填 dsh-workboard、@modelcontextprotocol/sdk、pypi:openai 与 crate:tokio；缓存 30 分钟
• 节假日：经 jsDelivr 读取 holiday-cn 今明两年的数据，失败时回退至 GitHub raw；缓存 12 小时
• 历史上的今天 / 每日壁纸：Wikimedia Feed API（历史上的今天与每日图片）、百度百科历史上的今天月度 JSON（baike.baidu.com，非官方）与 Bing 每日壁纸接口（www.bing.com/HPImageArchive.aspx，非官方）；壁纸图片由 Host 代理成 data URL；列表缓存 2 小时、图片缓存 6 小时
• 自定义 widget：仅可请求各自在 fetch 字段声明的 http(s) 地址前缀，Host 缓存 30 秒，强制刷新时也至少缓存 5 秒

仅读取本机数据的组件：

• 用量 / 活跃热力图 / 产出物：读取 ~/.dsh/sessions 下的会话日志
• 待处理：汇总 Harness 的会话、目标与后台作业状态，以及本地待办；开启 GitHub 时调用本机 gh CLI（与 GitHub widget 共用 5 分钟缓存）
• 每日简报：由 Agent 在新会话里调用 workboard_context 读取上述本机数据后写入；开启「每天自动生成」时在 Harness 定时任务里新建一个每日任务，关闭即删除
• Git 工作区：默认仅执行 git status，点击「获取远端」时才执行 git fetch
• 系统状态：在 macOS 上调用 vm_stat 与 pmset
• 相框：在 macOS 上用 sips 生成缩略图并缓存在系统临时目录
• 正在播放：通过内置的 mediaremote-adapter（vendor/，BSD-3-Clause）读取系统「正在播放」，它由 /usr/bin/perl 运行，无需授权；此路不通时退回用 osascript 查询已在运行的「音乐」或 Spotify，首次使用时 macOS 会请求自动化权限
• 端口：在 macOS 与 Linux 上调用 lsof 和 ps 列出监听中的 TCP 端口、工作目录与命令行；「停止」仅向仍在监听该端口的进程发送 SIGTERM，无需额外授权
• 快捷应用：在 macOS 上列出 /Applications、/System/Applications、~/Applications 及其 Utilities 子目录顶层的应用，用 osascript（JavaScript for Automation）读取 Finder 显示名与图标，用 ps 判断是否在运行；只用 open -a 打开上述目录内的应用，无需授权；在 Windows 上通过 PowerShell 读取「开始」菜单的应用列表（shell:AppsFolder，含商店应用），图标取自快捷方式指向的程序，用 Get-Process 判断是否在运行，只经 explorer.exe 打开列表内的应用；商店应用不显示图标与运行圆点
• 白噪音：在页面内用 Web Audio 合成，不读文件、不联网
• 日出日落与月相：在页面内按所选城市经纬度计算（NOAA 太阳位置算法与朔望月周期），不读文件、不联网（搜索城市时复用天气 widget 的 Open-Meteo 城市搜索）
• 最近文件：仅列出目标文件夹顶层文件，不递归扫描
• 剪贴板：仅在卡片可见期间每 2 秒读取一次 pbpaste（macOS）或 wl-paste / xclip（Linux），历史仅保存在内存中，不落盘

首次启动时会自动迁移早期版本（@lukeinx/dsh-desk 或 dsh-bento）的数据，原文件保留不动。

其他插件 bundle 可在 client.js 中将 React 组件注册到 workboard.widget slot。widget 元信息（manifest）挂在组件的静态属性 workboard 上，slot 注册参数仅需保留 id、order 和 label：

function Hello({size, config}) {
  return h('b', null, `Hello (${size})`);
}
Hello.workboard = {apiVersion: 1, sizes: ['m', 's']};

ctx.effect(() => ctx.slots.inject('workboard.widget', () => ctx.slots.register({
  name: 'workboard.widget', id: 'hello.widget', order: 100, label: 'Hello',
}, Hello)), 'hello widget');

完整示例见 examples/hello-widget。新安装的第三方 widget 会在首次加载时自动加入当前打开的看板一次，其余看板可在组件库中手动添加。

Manifest 字段说明：

• sizes：支持的尺寸档位数组；defaultSize 须包含在其中，默认取第一项。
• title: false：隐藏卡片标题栏；banner: true：无边框渲染。
• description：组件库中展示的简介。
• category：组件库分组，可选 daily（日常）、agent（DeepSeek）、news（资讯）、tools（效率与工具），其他值归入「插件」。
• settings：卡片设置项数组 {key, type, label, default?, options?, placeholder?}，type 支持 text、textarea、select（需配 options: [{value, label}]）与 toggle。label 支持字符串或返回字符串的函数。

组件渲染时会收到 {size, config, editing, openSettings} 属性。