数据源与本地插件
区分电脑提供的数据和设备直接获取的数据,并配置主题字段。
App“数据源”管理电脑指标、Codex 和本地插件;设备 HTTP 数据源在各个主题编辑器内配置。设备只接收当前主题实际引用的电脑字段,也只请求当前主题引用的 HTTP 数据源。配置后还需要绑定字段并发布;仅在电脑悬浮层展示的字段则由悬浮层设置控制。
先选择合适的数据来源
| 数据来源 | 由谁获取 | 关闭电脑后 |
|---|---|---|
| 设备传感器、番茄钟 | DeskPulse 自己 | 继续运行 |
| 电脑 CPU/GPU 使用率、温度、内存、磁盘和网络速率 | 桌面 App | 停止刷新 |
| Codex 集成、本地数据插件 | 电脑上的集成或插件进程 | 停止刷新 |
| 设备 HTTP 数据源 | DeskPulse 直接访问目标接口 | 设备有网络且对应主题激活时继续刷新 |
数据失效后的显示由主题的过期策略决定,可能变成占位、隐藏,或保持旧值。
电脑指标
在主题编辑器选择相应电脑字段并发布,再到“数据源”查看电脑指标。App 需要保持后台运行,且电脑与设备保持局域网连接。
电脑指标按显示需求采集:当前设备主题或已开启的桌面悬浮层需要它们时才刷新。未使用任何电脑字段时,卡片可能没有新值,这不一定是采集故障。
电脑悬浮层也可以显示这些字段,设置入口为“应用设置 → 桌面悬浮显示”,无需为了悬浮显示重新发布设备主题。
App 0.1.10 新增“电脑 GPU 使用率”“电脑 CPU 温度”和“电脑 GPU 温度”。在主题编辑器绑定到文字、进度条或圆弧后,重新发布并激活主题;已有固件 0.1.7 支持这些字段,无需仅为此升级。
| 平台 | 读数条件 |
|---|---|
| macOS | 取决于机型和驱动暴露的传感器;不是所有 Mac 都能提供全部指标 |
| Windows GPU | 使用系统首选高性能显卡,驱动未提供温度时该字段不可用 |
| Windows CPU 温度 | 需要正在运行且提供 WMI 数据的 LibreHardwareMonitor |
这些是电脑硬件温度,不是 DeskPulse 测得的室温。没有有效读数时不以 0 代替,主题按失效策略显示占位、隐藏或保留旧值。新增电脑采集功能仅适用于 macOS 和 Windows 桌面端。
Codex 集成
- 在“数据源”找到 Codex 区域,检查显示的配置目录是否正确;不是实际使用目录时,点击“选择配置目录”。
- 点击“安装 Codex 连接”,按安装结果提示,在 Codex 中审阅并信任相应 hooks。
- 回到 DeskPulse 点击“检查安装”。配置已写入但尚未信任、尚未收到事件,与已经观察到运行事件是不同状态。
- 执行一次正常 Codex 操作,再查看状态、耗时、会话数量等是否更新。
- 需要额度数据时点击“刷新额度”,或设置额度自动刷新间隔。间隔可选 1、5、10、15、30、60 分钟;只有主题或悬浮层实际展示额度时才自动刷新,否则保留手动刷新。
- 在主题或桌面悬浮层中选择需要显示的字段。
DeskPulse 的事件采集记录事件名、哈希会话标识、时间和目录末级名称;不读取提示词、回复或工具内容。额度查询依赖电脑本地 Codex 环境和登录状态,安装 hooks 不代表额度读取也已经成功。
不再使用时,点击 Codex 区域的“卸载”。这会移除 DeskPulse 集成,不是卸载 Codex 应用本身。
安装本地数据插件
- 准备来源可信且适配当前系统的
.deskpulse-plugin包。 - 在“数据源 → 本地数据插件”点击“安装或升级插件”,选择文件。
- 首次安装默认关闭。查看插件说明和设置,填写需要的参数后点击“保存设置”。
- 点击“开启”,确认状态进入“运行中”。启动失败时查看卡片错误信息,再按需“重试”。
- 在主题编辑器选择插件字段并发布到设备。
本地插件会作为电脑进程运行。安装相同 ID 的包会执行升级;修改设置会让插件使用新配置重启。
“关闭”停止插件运行,“卸载”移除插件。卸载后主题中的字段绑定仍保留,可能显示数据源未安装,需要改绑字段或重新安装插件。
插件市场尚未开放,不影响手工安装已有本地包。插件开发和打包不属于本成品用户手册。
设备 HTTP 数据源:完整示例
适用于设备直接读取一个返回 JSON 的 GET 接口。先确认该接口能从设备所在网络访问;电脑能访问不代表设备也能访问,例如电脑代理或仅监听电脑本机的服务。
- 在 macOS 或 Windows 打开本地主题,进入“HTTP 数据源”并点击“新增数据源”;也可“从其他主题复制”接口定义,个人参数需要重新填写。
- 填写名称和“公开 GET 接口 URL”。公开地址、查询参数和公开 Header 会随主题分享;公网接口使用 HTTPS,局域网接口可使用 HTTP。
- 需要个人地址或认证信息时,在“由使用者填写的个人参数”添加定义,选择填入 URL、查询参数或 Header。例如认证可用 Header
Authorization和前缀Bearer,将令牌值填在“本机参数与试请求”中,不要填入公开 Header。 - 选择刷新间隔,设置数据有效期。
- 添加字段,填写名称、读取路径、类型和必要的数值转换参数。
- 填好本机参数后可分别从电脑和设备试请求;“设备试请求”需要连接设备,检查字段值或错误。试请求不会保存参数。
- 点击“保存主题与本机参数”,在文字、进度条、圆弧或条件中绑定当前主题字段,再发布并激活。缺失参数、数据源或字段类型不匹配时,先修正校验提示。
例如接口返回:
{"result":{"items":[{"temperature":26.4}]}}可将字段配置为:
| 项目 | 示例值 |
|---|---|
| 名称 | 温度 |
| 读取路径 | result.items[0].temperature |
| 类型 | 数字 |
| 乘数 / 偏移 | 1 / 0 |
| 精度 | 1 位小数 |
此时主题应显示 26.4。若设置最小/最大传输值,注意使用精度缩放后的整数单位:一位小数的 26.4 对应 264。
路径可读取数组和带点号的键,例如 result["a.b"]。空路径读取根标量;不支持脚本、通配符、筛选或聚合。
刷新、类型和失效
- 刷新间隔可选 10 秒、30 秒、1 分钟、5 分钟、10 分钟、30 分钟、1 小时,默认 1 分钟。
- 有效期默认是刷新间隔的三倍,不能短于刷新间隔或超过一天。
- 数字按“原值 × 乘数 + 偏移”转换;文本最多 47 个 UTF-8 字节,中文通常占多个字节。
- 布尔字段要求 JSON 的
true或false。需要把字符串转成枚举或数值时,可填写精确值映射,再配置枚举显示文字。 - 一次主题最多引用 4 个 HTTP 数据源;HTTP 和电脑外部字段合计最多 16 个。
- 设备忙、未校时或请求未结束时会延后;失败会退避重试,刷新间隔不是准点完成承诺。
当前仅支持 GET,不支持 POST、OAuth 自动续期、自定义 CA、压缩响应或自动跟随重定向。需要认证的接口应使用适当权限的令牌,并注意目标服务是否限流。
修改和删除如何生效
数据源与字段属于当前主题,随主题保存和撤销;不同主题可使用相同的数据源 ID,互不干扰。“保存”和“删除数据源”先改变本地主题。要更新设备,必须重新发布引用它的主题。 仅删除本地的源不会停止设备已发布的请求;应重新发布不含该字段的主题,或删除设备对应槽位。
V4 主题包包含 HTTP 请求与字段定义、公开 URL/Header 及个人参数定义,不包含本机个人参数值。导入或从市场获取后,填写自己的参数,再测试和发布。导出前确认令牌、个人服务器地址等已放入个人参数,而不是公开 URL、Header、主题文字或素材。
App 0.1.7 起不再读取旧全局 HTTP 配置,也不迁移 V3 主题工程。旧项目需要重新创建为 V4;旧市场包需要作者重新发布。
AI Agent 辅助创作
在“应用设置 → AI Agent 接入”开启本机 MCP,可让 Agent 配置 HTTP 数据源并生成可编辑主题。仍需在 App 检查并发布,MCP 保存不直接更新设备。见MCP 接入。