Skip to content

模板开发 ​

面向想写模板的人。模板就是一段 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]          ≤ 60

2. 分配用最大余数法

模板里直接用 calc.largestRemainder(total, weights) / calc.fill(total, weights, cap), 保证取整后总和精确相等。手写随机数容易对不上,统计页就会露馅。

展示层只读数据文件、不做校验。数据不自洽时页面会照原样渲染, 但柱子高度、百分比这类派生显示就会看起来不对。

仅供学习与界面体验使用