主题
模板开发
面向想写模板的人。模板就是一段 JavaScript,决定「编辑界面长什么样」和「生成出什么数据」。
从这里开始
| 想做什么 | 看哪篇 |
|---|---|
| 了解模板的结构、能调哪些 API | 模板 SDK 规范 |
| 直接抄一个能跑的模板 | 模板示例 |
一句话理解模板
| 能力 | 由谁决定 |
|---|---|
| 用户看到的编辑界面 | buildUI() |
| 要生成哪几天 | listDates() |
| 每天产出什么数据 | generate(date) |
三个函数都实现,就是完整模板。
js
function buildUI() { return { sections: [...] } } // 界面
function listDates() { return ['2026-11-15'] } // 生成哪几天
function generate(date) { /* ... */ } // 一天的数据模板长什么样
files/templates/<模板id>/
├── manifest.json 元信息 + 权限(必须)
├── main.js 脚本(必须)
├── store.json 模板私有存储(App 维护)
└── icon.png 可选图标json
// manifest.json
{
"id": "game-day",
"name": "游戏日",
"permissions": ["write:usage"],
"apiLevel": 1
}运行时
| 项 | 值 |
|---|---|
| 引擎 | Mozilla Rhino 1.9.2(纯 Java,无 native 库) |
| 沙箱 | 无文件系统 / 无 DOM / 无 network(除非声明权限) |
| 超时 | 3 秒 + 已用网络时间 |
| 调试 | 没有 console.log,用 ui.alert |
脚本不直接写盘,通过 data.writeDay / store.set 记录意图,由 App 按权限统一执行。
需要记住的两条
1. 数据必须自洽
total = Σ hourly
Σ apps[].minutes = total
eyes.total = Σ eyes.categories
unlocks = Σ unlockHourly
hourly[i] ≤ 602. 分配用最大余数法
模板里直接用 calc.largestRemainder(total, weights) / calc.fill(total, weights, cap), 保证取整后总和精确相等。手写随机数容易对不上,统计页就会露馅。
展示层只读数据文件、不做校验。数据不自洽时页面会照原样渲染, 但柱子高度、百分比这类派生显示就会看起来不对。