Skip to content

模板系统 ​

模板不是一份参数快照,而是一段可执行的 JavaScript 脚本。

它决定两件事:

能力由谁决定
点进模板后看到的编辑界面脚本的 buildUI()
点「生成」时产出什么数据脚本的 listDates() + generate(date)

所以模板能做到「参数快照」做不到的事:自己算分布、联网拉数据、按日期做不同策略、弹窗交互。

一句话

模板 = 一个小 App:自己画界面、自己算数据。

模板能干什么 ​

  • 自定义编辑界面(滑条、开关、24 小时权重柱状图、下拉、按钮……)
  • 用最大余数法精确分配时长,保证总和相等
  • 读取已有数据,做「增量修改」
  • 联网拉权重(比如让 AI 生成一天的分布)
  • 保存自己的私有设置,下次打开还在

模板存在哪 ​

Android/data/com.naclxia.mifaketime/files/templates/
└── <模板id>/
    ├── manifest.json   元信息 + 权限
    ├── main.js         脚本(必须)
    ├── store.json      模板私有设置
    └── icon.png        可选图标

怎么用模板 ​

打开 ​

配置中心 → 模板 标签 → 查看全部模板 → 选一个

进去后看到的就是这个模板自己画的编辑界面。

生成 ​

界面底部有「生成」按钮:

  1. 模板先告诉 App 「要生成哪几天」(listDates())
  2. App 对每一天调用 generate(date)
  3. 写入数据,提示「已写入 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 里补。

仅供学习与界面体验使用