盼历 · 原型 v1（协作说明）

这是产品原型，不是最终工程。最终产品会用 Go + SQLite + Vue 3 重写（产品定义见 panli 仓库 docs/IDEA.md）。

预览地址：https://moyi.fan/panli/v1/home.html （部署后生效）

完整源码包下载：https://moyi.fan/panli/panli-v1.zip （解压即用；改完重新打包发回即可）

文件结构

• home.html — 盼头首屏：撕页日历倒数、再往后、今年进度
• shelf.html — 方块货架：分类方块，点击选中/取消（选择存在 localStorage）
• year.html — 年度日历：12 个月网格，圆点颜色 = 类别，悬停看日子名字
• assets/style.css — 全部样式，设计 tokens 在顶部 :root
• assets/blocks.js — 数据与逻辑：CATS 类别配色、BLOCKS 方块库、FAMILY 家人、TRIPS 单次事件、规则展开

从哪里下手改

• 换文案 / 预置方块：改 assets/blocks.js 里的 BLOCKS（emoji、名称、slogan、频率、rule）
• 换配色：改 assets/style.css 的 :root 与 blocks.js 里的 CATS
• 新增方块：往 BLOCKS 数组加一项，rule 支持五种写法：
  • { type:"nthDow", nth:1, dow:6 } 每月第一个周六（nth 为 -1 表示最后一个；dow：0=周日…6=周六）
  • { type:"weekly", dow:0 } 每周日
  • { type:"quarterly" } 每季度第一个周六（可加 offset 错开月份）
  • { type:"md", m:4, d:12 } 每年 4 月 12 日
  • { type:"seasons", months:[4,11] } 每年 4 月和 11 月的第二个周六

版本管理约定

• 每次给家人确认的大改版：复制 v1/ 为 v2/ 再改，旧版保留可对比
• 在 ../index.html 的版本列表里登记新版本
• 部署跟着 moyi.fan 现有流程走（vitepress build docs）