一组真正「跑在 any-sync 上」的桌面悬浮小组件：
- 数据存哪：每个纪念日/资产是一个 Anytype 对象（纪念日类型
ji_nian_ri、资产类型zi_chan，聚合面板类型ju_he_mian_ban），存放在官方客户端正在同步的空间里。官方客户端通过你部署的 any-sync 网络把对象同步到所有设备。 - 怎么读写：命令行和小组件都走官方桌面端本地 API（
127.0.0.1:31009），同步那块脏活由官方客户端搞定。 - 跨设备同步：任何设备改了对象（应用里改、或命令行改），小组件 60 秒内自动跟上。
环境要求：
- Apple Silicon（M 系列）Mac、macOS 12 或更高；
- 已安装并登录 Anytype 桌面端（0.46 及以上版本，支持本地 API）；
- 不需要 Python 环境，也不需要任何命令行依赖（发布包已内置数据脚本）。
到 Releases 下载最新的 CountdownWidget-vX.Y.Z-macOS.zip，解压后把 CountdownWidget.app 拖进「应用程序」文件夹。
应用使用本地自签名（ad-hoc），未经过 Apple 公证，首次双击会提示「无法验证开发者」。任选其一放行：
- 图形方式：在「应用程序」里右键点
CountdownWidget.app→ 打开 → 再点「打开」（只需一次，之后可正常双击）。 - 命令行方式：
xattr -dr com.apple.quarantine /Applications/CountdownWidget.app应用是无 Dock 图标的后台悬浮组件（
LSUIElement），启动后只看到桌面上的悬浮卡，Dock 与程序坞中不会出现图标——这是正常的。
小组件通过本地 API 读取你的 Anytype 数据，需要一个 API Key（仅保存在本机）：
- 打开 Anytype 桌面端并登录；
- 打开 设置（Settings）→ API Keys（中文版为「设置 → API 密钥」）；
- 点击 Create new（新建），起个名字（如
macOS 小组件）； - 桌面端弹出 4 位验证码确认时，在应用内输入确认；
- 复制生成的 Key（形如
zhSG/xxxx…=，只显示一次）。
旧版 Anytype 没有该入口时，可在桌面端运行时用浏览器打开 http://127.0.0.1:31009 ，按页面引导完成 4 位码授权后取得 Key。
打开「终端」，执行（把 <你的API Key> 换成上一步复制的内容）：
/usr/bin/python3 /Applications/CountdownWidget.app/Contents/Resources/anniversary.py init --api-key <你的API Key>看到 ✅ 已初始化：space=… 即成功。配置保存在 ~/.whynownote/wnn.json（权限 600，不会上传到任何地方）。
有多个 Anytype 空间时，用 --space-id <空间id> 指定；默认使用第一个空间。
想在终端直接敲 anniversary 命令，可加软链（可选）：
ln -s /Applications/CountdownWidget.app/Contents/Resources/anniversary.py /usr/local/bin/anniversary- 双击
CountdownWidget.app即出现一个悬浮小组件窗口（默认绑定空间里第一个纪念日对象，右键即可改绑）； - 再次双击会再开一个新窗口，每个窗口独立绑定对象、独立配置，想多开几个都行；
- 窗口配置自动保存在
~/.whynownote/widgets/<实例id>.json，重启后位置/样式不变。
- 在 Anytype 里准备对象：新建一个对象，类型选「纪念日」，填写对象名称（如「恋爱纪念日」）与「纪念日日期」字段；可再设置颜色和图标。「资产」「聚合面板」同理，类型分别选对应名称。
- 双击启动
CountdownWidget.app，桌面出现悬浮卡。 - 绑定对象：在卡片上右键 → 选择对象，点击目标对象；类型不对时先在右键 → 对象类型 中切换。
- 调整样式：拖动卡片移动位置；右上角三条斜线抓手拖放调整大小；鼠标悬停在卡片上滚轮/双指滑动缩放字号；右键 → 迷你模式可切成单行小长条。
| 操作 | 方式 |
|---|---|
| 移动窗口 | 按住卡片任意空白处拖动 |
| 调整大小 | 拖右上角斜线抓手（资产卡仅可调宽）；右键可「锁定大小」 |
| 整体缩放 | 卡片聚焦时滚轮 / 双指上下滑（0.7～1.8 倍，步进 0.05，自动记忆） |
| 切换对象 | 右键 → 对象类型 / 选择对象 |
| 改计数模式 | 右键 → 模式（正计日、倒计日、周年计数等 6 种） |
| 改纪念日日期 | 右键 → 修改时间… |
| 立即同步 | 右键 → 马上刷新最新数据（默认每 60 秒自动拉取） |
| 复制同款窗口 | 右键 → 复制窗口 |
| 资产次数 +1 | 「使用次数计费」的资产卡：单击卡片右下角图标 |
| 资产次数 −1 | 长按图标 0.6 秒，在确认窗中确认 |
| 置顶 / 迷你 / 排版 | 均在右键菜单中 |
小组件是普通 App，加入登录项即可开机自启：
- 打开 系统设置 → 通用 → 登录项与扩展；
- 在「登录时打开」下点 ＋，选择「应用程序」里的
CountdownWidget.app； - 开机登录后会自动出现一个默认窗口。想要多个固定窗口，当前可用「复制窗口」开好后保持窗口配置（登录项只会自启一个 App 进程；双击 App 图标可随时再加新窗口）。
- 先在卡片上右键 → 关闭此窗口（或直接退出进程），删除「应用程序」中的
CountdownWidget.app； - 如需同时清除授权与窗口配置，删除目录
~/.whynownote/（含 API Key 与各窗口配置，不可恢复）； - Anytype 侧在 设置 → API Keys 中删除对应 Key。
卡片只显示 -- 或一直空白？
确认 Anytype 桌面端正在运行且已登录；小组件依赖它的本地 API。然后右键 → 马上刷新最新数据。检查 API Key 是否仍有效（在 Anytype 设置 → API Keys 中查看），失效就重新生成并再跑一次第 4 步的 init。
双击 App 没反应？ 组件没有 Dock 图标，请看桌面上是否多了悬浮卡；App 已在运行时再次双击会新开一个窗口。若所有窗口都找不到，见下一条。
重启后窗口「消失」了？
窗口可能停在已拔掉的外接显示器坐标上——v1.0.0 起启动时会检测，落在屏幕外的窗口自动回到主屏右上角。仍异常时可删除 ~/.whynownote/widgets/ 下对应实例配置后重开。
手机/其他设备上改的数据会更新吗？ 会。数据通过 any-sync 同步到运行官方客户端的这台 Mac，卡片最多 60 秒内跟上（右键可立即刷新）。
会上传我的数据吗？
不会。App 只访问 127.0.0.1:31009 本机接口，API Key 与配置只存在本机 ~/.whynownote/。
每个窗口 = 一个独立实例 = 绑定一个对象（纪念日 / 资产）或一个聚合面板。 可多开、各自独立。
- 启动：双击
CountdownWidget.app即开新窗口（默认第一个纪念日）；终端可用anniversary widget 恋爱纪念日 正计日指定对象启动 - 右键菜单：
对象类型→ 列出空间内所有类型；当前支持「纪念日」「聚合面板」「资产」，其它灰显标注（暂不支持）选择对象→ 二级菜单列出该类型对象，点击即切换该窗口模式/计费方式→ 纪念日：正计日/倒计日/正计时/倒计时/周年计数/最近重复日；资产：使用时长计费/使用次数计费（默认跟随对象）迷你模式→ 单行小长条；高度锁定贴合，横向拉伸显示完整排版→ 迷你行：居中/左对齐/两端对齐；面板行：自然紧凑/两端对齐（标题截断加省略号）修改时间…→ 时间选择器改「纪念日日期」字段，立刻刷新复制窗口→ 以当前对象+配置新开一个窗口（位置偏移 +24/+24 避免重叠）新建聚合面板→ 再开一个聚合面板马上刷新最新数据→ 不等 60s，立即重新拉取对象锁定大小→ 禁止拖拽缩放置顶→ 切换是否永远悬浮在其他窗口之上关闭此窗口→ 关闭该窗口
- 纪念日 UI：标题（粗体）+ 小字（已经/还有）→ 大号数值 → 小号单位；数值按对象「颜色」字段上色；单位随模式在「日/小时」间切换
- 图标背景：纪念日对象设置了图标时，去掉毛玻璃、改用图标图片做背景（70% 透明度，随 60s 拉取刷新）；无图标则沿用毛玻璃。支持
file与emoji两种图标（资产/聚合面板/迷你模式恒用毛玻璃） - 滚轮缩放：窗口聚焦时滚轮/双指上下调整整体字号（0.7~1.8 倍，步进 0.05），缩放值持久化在实例配置里
- 缩放抓手：统一在窗口右上角（三条斜线），拖动调整大小
- 刷新：每 60s 拉一次对象（标题/日期/颜色/图标变动自动跟上），每 30s 本地重算数值
- 对象偏好（Anytype 里配置）：
默认模式（mo_shi）、迷你模式（mi_ni_mo_shi）、资产默认计费方式在首次绑定对象时作为默认值应用；纪念日拖动/缩放结束自动把尺寸写回对象当前宽度/当前高度 - 恢复：每个实例配置存
~/.whynownote/widgets/<id>.json（对象/模式/位置/锁定/置顶/迷你/缩放/排版），实例 ID 用毫秒时间戳，操作后自动保存
- 字段：
购买日期(gou_mai_iso)、保修到期日(bao_xiu_iso)、价格(price)、使用次数(uses)、计数周期(period：日/月/年)、默认计费方式(asset_mode) - 标准模式（js.design 规格）：圆角 20 卡片，四边内边距 20；第一行左列＝标题 20pt Heavy ＋ 50pt 大数字（anytype 颜色）+20pt 单位 ＋ 15pt「在保：N日」；第二行＝左下价格/均价两行 11pt（白 60%）＋ 右下 56×56 圆角 8 图标。高固定（184×缩放）、宽贴合内容、可拖宽只扩不收
- 图标即热区（仅「使用次数计费」可交互）：单击图标次数 +1，长按 0.6s 弹确认窗 −1；悬停手型光标、0.9→1.0 增亮反馈；按下图标时不会误拖窗口
- 迷你模式：单行
购买{标题}已经{N}{周期} {均价}（均价半透明小字；次数计费单位「元/次」，时长计费单位「元/日·月·年」）；不显示图标 - 计数规则：按完整周期（日/月/年）计数；不足 1 周期显示 1、到期显示 0；价格或除数为 0 时均价显示
–；价格整数、均价两位小数
- 一个窗口按行列出成员对象（左标题+小字、右数值+单位，数值按各对象「颜色」字段上色）；高度随行数自动贴合，宽可拉伸
- 成员类型：纪念日 / 聚合面板 / 资产（资产行按迷你模式逻辑显示）
- 面板配置（Anytype 面板对象字段）：成员类型、日期计数默认模式、分类/标签筛选、手选显示对象（非空则只显示手选）、排序（名称/计数值 升降序）、
限制显示数量(xian_zhi_xian_shi_shu_liang) - 标题变量：
{日期::format}按 format 渲染当前日期时间（如{日期::MM-dd}），{星期}渲染为「星期一」~「星期日」；变量只对面板顶部大标题生效
说明：倒计模式是「绝对倒数」——只有目标时间在未来才有值；目标是过去时间时显示 0。想看"已经过了多久"请用正计模式。
命令行是高级/调试入口，日常只看卡片可以跳过本节。脚本仅依赖 Python 3 标准库，无需 pip 安装任何包。
anniversary init [--api-key KEY] [--space-id ID] # 初始化配置（首次使用）
anniversary objects [类型key] # 列对象（缺省纪念日；zi_chan=资产，ju_he_mian_ban=聚合面板）
anniversary read-object <id> # 读单个对象：{name, date_iso, color, icon, 偏好…}
anniversary set-date <id> "2026-12-25 08:00" # 改「纪念日日期」字段（本地时间）
anniversary icon-image <id> [输出路径] # 取对象图标（file→下载图片；emoji→返回emoji）
anniversary set-size <id> <宽> <高> # 把当前宽度/当前高度写回对象
anniversary set-mini <id> <是|否> # 写回对象「迷你模式」字段
anniversary inc-uses <id> [增量] # 资产使用次数 +N（减一传 -1，默认 1）
anniversary types # 列空间内所有对象类型
anniversary widget <对象名> [模式] # 开一个新小组件窗口绑定该对象
anniversary panel [面板名] # 开一个聚合面板窗口(会在anytype回写新建一个类型为“聚合面板”的对象)
anniversary panel-data <面板id> # 读面板配置 + 成员行数据
anniversary panel-set <面板id> '<属性json>' # 改面板属性（排序/筛选/限制数量等）
anniversary panel-set-types <面板id> <类型key逗号列表> # 改面板成员类型
anniversary new-panel [名称] # 新建聚合面板对象模式：正计日（已经多少天）/ 倒计日（还有多少天）/ 正计时（多少小时）/ 倒计时（还有多少小时）/ 周年计数（已经多少周年）/ 最近重复日（下一个同月日还有多少天）。
从源码使用时安装到 PATH：
chmod +x anniversary.py
ln -s "$PWD/anniversary.py" /usr/local/bin/anniversary # 或 ln 到 ~/bin 等 PATH 目录环境：macOS（自带 Swift 与 /usr/bin/python3，无需 pip 安装任何包），且 Anytype 桌面端正在运行。
# 0. 一次性授权（源码目录里）
/usr/bin/python3 anniversary.py init --api-key <你的API Key>
# 1. 编译小组件（仓库根目录产出可执行文件）
/usr/bin/swiftc CountdownWidget.swift -o CountdownWidget-bin
# 2a. 直接运行（可重复执行开多个实例）
./CountdownWidget-bin --instance <实例id，任意字符串>
# 2b. 打包为 .app：组装 bundle（Info.plist 模板 + 内置 CLI 脚本）后本地签名
mkdir -p CountdownWidget.app/Contents/MacOS CountdownWidget.app/Contents/Resources
cp CountdownWidget-bin CountdownWidget.app/Contents/MacOS/CountdownWidget
cp anniversary.py CountdownWidget.app/Contents/Resources/anniversary.py
cp Info.plist CountdownWidget.app/Contents/Info.plist
codesign --force --sign - CountdownWidget.app
open -n CountdownWidget.app
# 3. 发布用压缩包（ditto 保留代码签名与权限，不要用 Finder 直接压缩）
ditto -c -k --keepParent CountdownWidget.app CountdownWidget-v1.0.0-macOS.zip小组件按以下顺序查找 anniversary.py（不写死个人路径）：
- 环境变量
WNN_ANNIVERSARY_PY指向的脚本 .app包 Resources 内的anniversary.py（发布包默认走这里）- 可执行文件同目录（仓库根直接编译运行）
.app包上一级目录（.app放在仓库根时）.app包根目录- PATH 中的
anniversary命令（如上面的软链） - 兜底：当前工作目录下的
anniversary.py
| 文件 | 作用 |
|---|---|
anniversary.py |
命令行（数据入口：objects / read-object / set-date / panel-* / widget） |
CountdownWidget.swift |
小组件源码（单文件，直接 swiftc 编译） |
CountdownWidget.app |
本地构建的应用包（BundleID local.whynownote.countdownwidget，不入库） |
Info.plist |
应用包配置模板（版本号 / LSUIElement 后台组件 / 最低系统版本），打包时复制进 .app |
LICENSE |
MIT 许可证 |
~/.whynownote/wnn.json |
API 配置（权限 600，别外传） |
~/.whynownote/widgets/*.json |
各实例配置 |
你的 any-sync 网络 (6 节点)
▲ 同步
官方 Anytype 桌面端 (已授权)
▲ 本地 API (127.0.0.1:31009)
┌──────┬──────────┐
anniversary 命令 小组件实例1 小组件实例2 …