一个「卡通小猫 × 复古报刊编辑部」风格的个人记账平台 —— 无后端、无数据库、数据完全自持
米白旧报纸 · 手绘多彩图标 · PWA · 微信 / 支付宝账单导入 · GitHub 私有仓库同步 · 自动归类
喵账本（MeowLedger）是一个部署在哪里都能跑的个人记账平台。它用「卡通小猫 × 复古报刊编辑部」的视觉语言来记账：本月账本是收支结余总览，统计报表是分类占比与趋势，「记一笔」是一张记账单，手绘记账助手「墨墨」替你核对每一笔——报刊只是它的样子，记账才是它做的事。
- 纯静态前端：构建产物只是一堆 HTML/JS/CSS，任何静态托管（Qoder Sites、Cloudflare Pages、Vercel、GitHub Pages…）免费部署
- 云端账本：邮箱验证码注册 / 登录（QQ 邮箱 SMTP 发信），数据存 Cloudflare D1，手机电脑自动同步；离线照常记账，联网自动补同步
- 数据自持：也可不登录纯本地使用，或同步到你自己的 GitHub 私有仓库作备用导出——天然带版本历史
- 微信 / 支付宝账单导入：上传官方导出的账单 CSV，自动识别消费来源账户、按关键词自动归类、按交易单号去重
- 读者档案：改昵称 / 头像 / 个性签名，头像可上传照片（本地压到 96×96）、选内置墨墨贴纸或 emoji，直接存进 D1，不依赖图床
- 读者对话室：全站读者共用一间聊天室，15 秒增量轮询、2 秒发言冷却、500 字上限；管理员发言带金箔高亮与「主编」印章
- 平台看板（管理员）：注册读者 / 当前在线 / 来信数 / 数据行 / 云端占用 / 覆盖地区六联 KPI、近 14 天注册·登录·发言趋势、地区 Top10、最近读者（邮箱脱敏）
- 离线可用：PWA + Service Worker，记账这件事不需要网络
🌐 在线体验：mindofqc.github.io/inkledger/#demo（
#demo会自动载入示例数据；深链#dashboard/#home/#stats/#chat/#profile/#settings/#add/#admin（管理员）/#light/#dark可直达对应视图或主题）另有 Qoder Sites 私有部署：
inkledger-j8vzdjdlheu.qoder.website（需 Qoder 账号登录访问）
| 桌面端 · 日刊（本月账本） | 移动端 |
|---|---|
 |
 |
| 统计报表 | 夜班主题 |
 |
 |
| 记一笔 · 记账单 | 账本设置 |
 |
 |
- 🗒️ 记账：支出 / 收入 / 转账，二级语义清晰的账户体系（微信零钱、支付宝、现金、银行卡…即「消费来源」）
- ↩️ 安心操作：删除账目 / 账户 / 分类 / 周期账单 / 储蓄目标、清空与导入数据均可一键撤销；危险操作走主题化确认框，不再用浏览器原生弹窗
- 🔎 流水工作台：四种实时排序（日期 / 金额升降）、批量勾选删除、保存视图（把常用筛选 + 排序收藏成快捷方式，跨月复用）
- 📥 账单导入：微信支付、支付宝官方导出的 CSV 一键导入；自动建户（按银行卡尾号识别同一账户）、关键词自动归类、交易单号去重、退款标记
- 📊 统计分析：分类占比环图、近六个月收支趋势、消费来源分布、分类排行与日均支出
- 📋 数据看板：打开账本第一眼——本月收支结余、净资产、预算执行、分类 Top5、账户余额、近 7 天待还与最近流水
- ☁️ 云端同步：Cloudflare Workers + D1 后端，邮箱 + 密码 + 验证码登录，多端按
updatedAt合并、乐观锁防冲突；GitHub 私有仓库同步保留为备用导出 - 🎨 双主题：日刊（默认）/ 夜班——日刊是米白旧报纸底纹 + 浅棕文字 + 橘黄墨绿点缀，夜班是暖棕台灯暗色；全站手绘多彩图标，左上角品牌标识与报头、侧栏、空态、便签、记账单、设置页统一为同一只手绘记账助手猫「墨墨」的多姿势形象
- 📱 PWA：可安装到手机桌面，Service Worker 离线访问
- 👤 读者档案：昵称（≤24 字）/ 头像 / 个性签名（≤200 字节）三选一头像方案——上传照片本地压到 96×96、内置墨墨贴纸、emoji；报头右上角常驻读者证，一键进档案
- 💬 读者对话室：全站共用聊天室，15 秒增量轮询、本人发言靠右贴纸色、快捷表情、2 秒发言冷却与 500 字计数；管理员金箔高亮 + 「主编」印章
- 🛡️ 平台看板：仅管理员可见——六联 KPI、近 14 天注册/登录/发言三线趋势（可点图例切换）、地区 Top10、最近读者表（搜索 / 排序 / 邮箱脱敏），60 秒自动刷新
- 🔒 隐私：无统计、无追踪；密码 PBKDF2 加盐哈希，GitHub Token 仅存于浏览器 localStorage、不上云；平台看板只回聚合数据与脱敏邮箱，不含任何账本内容
git clone https://github.com/MindOfqc/inkledger.git
cd inkledger
pnpm install # 或 npm install
pnpm dev # http://localhost:5173喵账本是纯静态应用，pnpm build 后把 dist/ 扔到任意静态托管即可。
Qoder Sites / Cloudflare Pages / Vercel / Netlify / GitHub Pages 的图文步骤见 DEPLOY.md。
| 平台 | 路径 | 说明 |
|---|---|---|
| 微信 | 我 → 服务 → 钱包 → 账单 → 右上角「…」→ 导出账单记录 → 用于个人对账 | 新版直接生成 xlsx，旧版经邮箱发送 CSV（解压密码为身份证号）；两种都支持 |
| 支付宝 | 我的 → 账单 → 右上角「…」→ 开具交易流水 / 对账单 | 解压后得到 CSV |
导出后在喵账本「设置 → 微信 / 支付宝账单导入」上传即可。xlsx / CSV 自动识别；CSV 支持 UTF-8 与 GBK 编码；xlsx 内的 Excel 序列日期会自动转换。已用真实微信账单（134 笔）验证：导入笔数与金额和账单自述完全一致。
- 在 GitHub Settings → Developer settings 创建 Fine-grained Token（只需仓库读写权限，建议设置有效期）
- 在喵账本「设置 → GitHub 同步」粘贴 Token 并校验
- 点击「立即同步」——首次会自动创建
<你的用户名>-inkledger-data私有仓库，账本以data.json存于其中
Token 与数据都不会离开你的浏览器到任何第三方服务器（仅 GitHub 官方 API）。合并策略为按条目 updatedAt 新者胜。
- Vue 3（Composition API，无 UI 框架依赖，样式手写设计系统）
- Vite 6
- ECharts 5（按需引入 Tree-shaking）
- 原生 PWA（手写 Service Worker）
账单导入解析器为纯函数实现，测试覆盖见 tests/（pnpm test）。
- 预算管理与超支提醒（v1.3 分类预算 · v1.5 信封结转）
- 数据报表导出（v1.4 账目 CSV · v1.6 一键打印报告）
- 账单快照识别（截图 OCR）
- WebDAV / S3 同步端点
- PDF 报表直出（现经浏览器打印另存为 PDF）
欢迎 Issue 与 PR。提交前请跑 pnpm test && pnpm build。
- fix：新账号首次登录时自动播放的使用指引会把
#chat/#profile/#admin等深链强行拽回看板（指引首步navigate('dashboard')）；现在检测到 URL 已点名非看板视图就让路，深链直达目标页，指引仍可在设置页手动重看 - fix：对话室历史来信的头像与昵称改为实时跟随读者档案（后端
chatListJOINml_users取live_nickname/live_avatar），改了资料后旧消息里的形象一起换装，不再停留在发言当时的快照
- feat：读者档案（
#profile）——改昵称 / 头像 / 个性签名。头像三选一：上传照片（本地 canvas 裁方 + 压到 96×96 WebP，不支持时退回 PNG）、5 张内置墨墨贴纸（主编 / 招呼 / 读报 / 打盹 / 存钱）、12 个 emoji；昵称 ≤24 字、签名 ≤200 UTF-8 字节，实时字数与字节计数；新增Avatar组件统一渲染图片 / 贴纸 / emoji / 首字母四类头像，报头右上角常驻「读者证」，设置页账号卡改用真实头像并提供「编辑资料」入口 - feat：读者对话室（
#chat）——全站读者共用一间聊天室，消息落 D1ml_chat_messages；15 秒增量轮询、本人发言靠右贴纸色、快捷表情条、字数计数与 2 秒发言冷却倒计时、在线人数、新消息回到底部 - feat：管理员身份与高亮——
235173498@qq.com设为主编（wrangler.toml的ADMIN_EMAIL支持逗号分隔多邮箱，也可UPDATE ml_users SET is_admin=1）；对话室内管理员气泡金箔描边 + 头像金环 + 「主编」印章，报头读者证同步挂主编徽标 - feat：平台看板（
#admin，仅管理员）——注册读者 / 当前在线 / 对话室来信 / 账目数据行 / 云端占用 / 覆盖地区六联 KPI，近 14 天注册·登录·发言三色趋势（图例可切换、hover 十字线读数），地区 Top10 条形，最近读者表（搜索 / 按注册或最近登录排序 / 邮箱脱敏），60 秒自动刷新可关；非管理员访问返回403 forbidden，前端隐藏入口并在身份撤销时自动退出 - feat：后端新增
GET|PUT /api/user/profile、POST /api/presence（60 秒心跳，5 分钟窗口判在线）、GET|POST /api/chat、GET /api/admin/stats；ml_users加avatar/bio/is_admin，ml_sessions加location，新建ml_login_logs/ml_chat_messages（迁移0002_profile_chat_admin.sql，首次请求自动执行） - fix：CORS 白名单补上 GitHub Pages 公开体验站
https://mindofqc.github.io（只放行该账号名，不用通配*.github.io），此前线上前端调云端 API 会被浏览器拦下 - style：新增 13 枚手绘贴纸图标
chat / user / users / shield / crown / pin / camera / smile / pulse / clock / globe / send / image（图标总数 73），侧栏与底部导航加入「对话室」，管理员额外显示「平台看板」（带皇冠角标） - PWA 缓存版本升至
meowledger-v1.12.0；本地账本数据格式与同步行为零变化，未登录仍可纯本地使用
- feat：新用户使用指引——首次登录自动播放 6 步 spotlight 高亮指引（看板 KPI / 记一笔 / 预算待办 / 账目 / 统计 / 设置），报纸风介绍卡 + 进度点，支持上一步 / 跳过 / 键盘方向键；按账号记忆不再重复打扰，设置页「使用指引」可随时重看
- style：界面不再强调云端概念——同步全程自动无感，登录页 / 设置页 / 启动页文案回归记账本身（设置页「云端账号 · 多端同步」改为「账号」）
- PWA 缓存版本升至
meowledger-v1.11.1；数据与同步行为零变化
- feat：云端账本——新增 Cloudflare Workers + D1 后端（
cloudflare/api/，与热点雷达同架构）：QQ 邮箱 SMTP 验证码注册 / 登录 / 找回密码，PBKDF2 加盐哈希 + 90 天会话；账本数据按用户存 D1，多端按updatedAt合并、乐观锁防冲突，离线记账联网自动补同步；GitHub 同步保留为备用导出（PAT 不上云） - feat：数据看板成为默认首页——本月收支结余 / 净资产四联 KPI、预算执行进度、近 6 个月趋势、分类 Top5、账户余额、近 7 天待还、最近流水
- feat：登录门「读者登记处」整页（登录 / 注册 / 忘记密码三 tab）、设置页「云端账号」卡片（同步状态 / 立即同步 / 退出登录 / API 线路切换：自定义域名默认 + workers.dev 备用）
- PWA 缓存版本升至
meowledger-v1.11.0；本地数据格式零迁移，未登录仍可纯本地使用
- style：品牌标识升级为完整实体猫——左上角徽章与 favicon / PWA 图标不再用简笔 SVG 探头猫，改为 AI 手绘生成、与报头主编同一形象的完整全身橘猫抱账本实体贴纸（抠底透明 + alpha WebP 约 239KB），经 Edge/Pillow 同源管线重生成
favicon.png/icon-192.png/icon-512.png（maskable），左上角、桌面图标、GitHub 封面三处完全一致 - PWA 缓存版本升至
meowledger-v1.10.1；功能、数据、快捷键、深链零变化
- change：项目更名 「爪爪日报 PawPress」→「喵账本 MeowLedger」，明确个人记账平台定位。报刊编辑部只是视觉语言，名称、导航、组件与文案全部回到记账口径：本月账本 / 收支流水 / 统计报表 / 记账单 / 账本设置，「投稿 / 改稿 / 存档 / 副刊」等隐喻改为「记账 / 编辑 / 账目 / 报表」
- style：左上角品牌标识重做——新增手绘 SVG 徽章
brand-mark.svg（米白报纸底 + 橘猫探头 + 墨绿账本 + 金币 ¥ + 铅笔），BrandMark组件接入侧栏，做成可点击回首页的品牌按钮（44px 徽章 + 「喵账本」+「MeowLedger · 个人记账」副标题），hover 微旋转、键盘可达 - style：favicon 与 PWA 图标同源重制——左上角标识、
favicon.png/icon-192.png/icon-512.png（maskable）共用同一份 SVG，经 Edge 渲染 + Pillow 合成，品牌视觉完全一致 - feat：新增 GitHub 仓库介绍封面
docs/brand-cover.png（品牌标识 + 记账定位文案 + 真实界面截图），用于 README 顶部与仓库 Social Preview - compat：保存视图存储键
pawpress:views→meowledger:views，读取时自动从旧键无损迁移（新键优先、空数组不复活旧视图、新键损坏回退旧键）；主账本 key、导出文件名、GitHub 数据仓库名、npm 包名、仓库 slug 保持不变，老数据零迁移 - test：单测扩充至 146 项断言（新增保存视图旧键迁移 / 新键优先 / 损坏回退）；DOM 探针新增品牌标识加载、左上角品牌名与记账定位副标题断言
- PWA 缓存版本升至
meowledger-v1.10.0；全部功能、快捷键、深链、打印、数据格式零迁移兼容
- feat：破坏性操作全面可撤销——删除单笔 / 批量账目、账户、分类（含级联预算与规则）、周期账单、储蓄目标，以及清空数据、导入备份、一键缴账、目标存入，完成后提示条带「撤销」按钮，一键回到操作前。撤销采用操作级恢复而非整库回滚，不会覆盖撤销之前的其它编辑
- feat：主题化确认框——所有危险操作改走编辑部「审稿签」弹层（
ConfirmDialog，alertdialog语义、焦点默认落在「取消」、Esc 或回车即取消、Tab 到「确定」再回车才确认、关闭后焦点归还触发按钮），替代浏览器原生confirm，与报刊视觉统一 - feat：流水实时排序——最新 / 最早在前、金额从高到低 / 从低到高四种排序，抽为纯函数
lib/ledger.js（筛选 / 稳定排序 / 按日分组） - feat：批量选择删除——勾选模式 + 全选 + 计数 + 整批删除并整批撤销；切换筛选 / 排序 / 月份自动清空选择，避免误删不可见账目
- feat：保存视图——把常用「筛选 + 排序」收藏为命名快捷方式（
lib/views.js，localStoragepawpress:views，上限 12 条，同名覆盖），刻意不含月份以便跨月复用，一键套用 / 移除 - style：新增手绘多彩图标
undo / sort / bookmark / select；排版工具条、批量操作条、保存视图缎带、确认框与可撤销提示条均复用报刊设计令牌；打印时自动隐藏这些交互控件 - test：单测扩充至 140 项断言（新增流水筛选 / 排序 / 分组、保存视图、撤销 / 确认 / 批量删除三组）
- PWA 缓存版本升至
pawpress-v1.9.0；全部功能、快捷键、深链、打印、数据格式零迁移兼容
- change：项目更名 「墨账日报 InkLedger」→「爪爪日报 PawPress」（爪印 × 报刊）。仅改展示层品牌与文档；内部标识（localStorage key、导出文件名、GitHub 数据仓库名、npm 包名、仓库 slug）保持不变，老数据零迁移
- style：全站猫咪统一为同一只手绘插画主编猫「墨墨」的多姿势形象——读报（报头 / 投稿单）、蜷睡（空态）、挥手（侧栏 / 便签 / 设置 / 统计署名）、抱存钱罐（储蓄目标），替代原简笔 SVG 大头猫；
CatArt组件改为透明 WebP 插画 - style：favicon 与 PWA 全套图标重制——以手绘主编猫合成米白报纸圆角徽章，输出
favicon.png/icon-192.png/icon-512.png（512 为 maskable 铺满安全区），移除旧 SVG 图标 - perf：5 张猫插画统一转 alpha WebP（总约 268KB，较 PNG 约 1.1MB 大幅瘦身），经 Vite 构建期资源引用，任意子目录部署可离线加载
- PWA 缓存版本升至
pawpress-v1.8.0；全部功能、快捷键、深链、打印、数据格式零迁移兼容
- style：报头主编猫「墨墨」升级为完整全身手绘插画——AI 手绘水彩生成后抠成透明贴纸（橘猫主编戴圆框眼镜、端坐捧读旧报纸、尾巴卷在身侧、耳后别红铅笔），替代原简笔 SVG 猫；日刊 / 夜班 / 移动端报头同步换装
- feat：新增
#dark深链，与#light对称，可直达夜班主题（可与#demo/#stats组合） - fix：报头插画改走构建期资源引用（
new URL相对路径），任意子目录静态部署均可正确加载 - PWA 缓存版本升至 v1.7.1，报头插画加入离线外壳预缓存
- style：全站改版为**「卡通小猫 × 复古报刊编辑部」**——米白旧报纸底纹（SVG 噪点纸纹）、浅棕文字、橘黄与墨绿点缀；报头「墨账日报」+ 手绘主编猫 + 日期期号邮戳，首页改「头版」双栏（左生活流水账 / 右编辑部专栏），统计页改「数据副刊」，设置页改「编辑部」，记一笔改「投稿单」
- style：全部图标重绘为手绘多彩贴纸风（固定彩色填充 + 深棕描边、微歪手绘线条），新增猫 / 爪印 / 铃铛 / 日历 / 同步 / 上传下载 / 邮票等 20+ 键；分类图标点选器同步换装；旧数据自定义图标与 emoji 仍兼容
- feat：手绘小猫插画
CatArt——报头读报主编猫、空态蜷睡猫、侧栏 / 便签探头猫三形态；favicon 与 PWA 全套图标换为猫报 logo - style：新增胶带、邮票齿孔、铅笔批注（楷体）、报纸双线分栏等报刊元素；图表色板改走
--chart-1..8报刊色，随主题切换重渲染 - change：默认主题改为日刊（米白报纸），原夜墨 / 宣纸更名为夜班 / 日刊；夜班为编辑部台灯暖棕暗色
- fix：dev server 忽略编辑器原子写入的
.tmpdir临时目录，避免 Windows 文件锁导致 watcher EBUSY 崩溃 - 全部功能、快捷键、深链、打印、数据格式零迁移兼容；PWA 缓存版本升至 v1.7
- feat：自定义自动归类规则（参考 Firefly III 规则引擎）——按顺序匹配商户/商品关键词,命中即归入指定分类,优先于分类自带关键词;账单导入与手动记一笔均生效,记一笔输入商户时未选分类会智能预选
- feat：统计页一键打印报告——隐藏交互组件,界面文字自动切换浅色打印配色(图表按当前主题原样输出)
- feat：PWA 快捷方式 + URL 快速记账——长按应用图标直达「记一笔」;支持
?type=expense&amount=30&payee=xx&tag=a,b参数预填,可配合系统快捷指令秒记 - 规则数据随 GitHub 同步与 JSON 备份;全部纯前端实现
- feat：信封式预算结转（参考 Actual Budget）——分类预算可开启「结转」，未用完额度滚入下月、超支扣减后续信封；额度修改不重置基线，首页预算卡实时按信封口径展示
- feat：储蓄目标（参考 Firefly III 存钱罐）——目标进度条、按目标月倒推月存额、首页快捷存入；纯进度追踪，不影响账户余额与总资产
- feat：资产走势（参考 Sossoldi / Wealthfolio）——统计页新增月度净值曲线与当前总资产（按账户余额推算，含信用卡负债）
- feat：标签增强——统计页新增标签排行（多标签分别计入并注明），记一笔标签输入自动补全（高频 Top 20）
- 全部纯前端实现；目标数据随 GitHub 同步与 JSON 备份；老数据零迁移兼容
- feat：周期账单 / 订阅管理——房租、会员、话费等固定扣费设置周期（每月 / 每季 / 每年）与扣费日，首页「近期账单」到期提醒（逾期标红），点「缴账」一键入账并自动顺延；每月固定支出自动折算
- feat：统计新增年度总览——年份切换、年度总收支 / 结余 / 月均支出与 12 个月收支柱状图
- feat：数据管理新增导出账目 CSV（UTF-8 + BOM，Excel 直接打开不乱码）
- feat：键盘快捷键——
N记一笔、/聚焦搜索、Esc关闭弹层 - 周期账单数据随 GitHub 同步与备份导出，纯前端实现，不影响静态部署
- feat：月度分类预算——设置中为支出分类设定每月额度，首页新增预算执行卡片（总额度进度 + 各分类余/超提示，超支标红），预算数据随 GitHub 同步与备份导出
- feat：统计总支出新增环比（较上月 ±%，支升红 / 支降绿）
- feat：账目列表新增类型筛选（全部 / 支出 / 收入 / 转账）
- feat：记一笔金额框支持算式输入（如
12+8、(30+6)/2，失焦自动求值回显） - style：应用图标全新设计——金字「墨」+ 账线落墨点，替换 favicon 与 PWA 全套图标
- feat：全站图标升级为 Lucide 线性图标库（统一 24×24 描边风格、颜色跟随主题）——导航、统计、记一笔、设置、主题切换、搜索、转账及全部分类与账户图标不再依赖 emoji，跨平台显示一致
- feat：新增图标注册表
src/lib/icons.js与AppIcon/DataIcon组件；分类编辑器改为图标点选器（21 个语义图标） - compat：旧数据兼容——已保存的分类若仍是默认 emoji 图标会自动升级为线性图标，自定义图标保持不变
- feat：支持微信新版 xlsx 账单直接导入——零依赖解析器（原生
DecompressionStream解 zip + 正则解析 sheet XML），按文件魔数与 CSV 自动分流 - feat：适配真实账单数据特征——Excel 序列日期转换、
"/"空值清洗、空支付方式的红包收入默认记入零钱、商户名空白修剪 - test：新增匿名化 xlsx 夹具与 13 项断言，并以真实账单（134 笔）完成端到端验证（笔数与金额和账单自述一致）
GUI 黑盒功能测试后的问题修复：
- fix：点击已有账目无法打开编辑弹层，导致编辑/删除不可用——
TxEditor对 Vue 响应式对象使用structuredClone抛DataCloneError，改为 JSON 深拷贝 - fix：移动端（<900px）桌面侧边栏未隐藏、堆叠在页面顶部——补充
.sidenav基础display:none规则
首个版本：记账（支出/收入/转账）、微信/支付宝账单导入、统计图表、GitHub 私有仓库同步、夜墨/宣纸双主题、PWA 离线可用。
MIT © rwzdk