主题
模板系统
模板不是一份参数快照,而是一段可执行的 JavaScript 脚本。
它决定两件事:
| 能力 | 由谁决定 |
|---|---|
| 点进模板后看到的编辑界面 | 脚本的 buildUI() |
| 点「生成」时产出什么数据 | 脚本的 listDates() + generate(date) |
所以模板能做到「参数快照」做不到的事:自己算分布、联网拉数据、按日期做不同策略、弹窗交互。
一句话
模板 = 一个小 App:自己画界面、自己算数据。
模板能干什么
- 自定义编辑界面(滑条、开关、24 小时权重柱状图、下拉、按钮……)
- 用最大余数法精确分配时长,保证总和相等
- 读取已有数据,做「增量修改」
- 联网拉权重(比如让 AI 生成一天的分布)
- 保存自己的私有设置,下次打开还在
模板存在哪
Android/data/com.naclxia.mifaketime/files/templates/
└── <模板id>/
├── manifest.json 元信息 + 权限
├── main.js 脚本(必须)
├── store.json 模板私有设置
└── icon.png 可选图标怎么用模板
打开
配置中心 → 模板 标签 → 查看全部模板 → 选一个
进去后看到的就是这个模板自己画的编辑界面。
生成
界面底部有「生成」按钮:
- 模板先告诉 App 「要生成哪几天」(
listDates()) - App 对每一天调用
generate(date) - 写入数据,提示「已写入 N 天数据」
同日期会被覆盖
模板生成不弹窗询问,目标日期已有数据会直接覆盖。
导入 / 导出
| 操作 | 说明 |
|---|---|
| 导出模板 | 打包成 zip(manifest + main.js + store + icon) |
| 导入模板 | 选 zip 导入,会新建一个副本 |
订阅
模板页 → 订阅地址 → 填入订阅链接,可以直接拉取别人维护的模板库。
权限
模板必须在 manifest.json 里声明要用什么能力,没声明就调不了:
| 权限 | 能干什么 |
|---|---|
read:usage | 读取已有的使用数据 |
write:usage | 写入使用数据 |
network | 联网 |
导入模板时请留意它要了哪些权限。
自己写模板
模板脚本就是 JavaScript,需要实现三个函数:
js
function buildUI() { return { sections: [...] }; } // 界面
function listDates() { return ['2026-11-15']; } // 要生成哪几天
function generate(date) { /* ... */ } // 一天的数据完整的 SDK 文档(组件清单、API、限制、示例):
- 开发仓库里的
docs/TEMPLATE-SDK.md - 或者让 App 里的 AI 帮你写:直接说「帮我做一个晚上打游戏的模板」
和 AI 的关系
AI 助手可以直接新建模板:它输出一段完整脚本,客户端自动建目录和清单,你确认后就能用。
帮我做一个模板:工作日晚上 8-11 点玩和平精英 2 小时,
白天微信零星使用,夜间不产生数据AI 生成的模板默认只有 write:usage 权限;需要读旧数据或联网时,自己往 manifest.json 里补。