# 打卡便利贴

**Repository Path**: chen_yunyu/time-keeping-sticky-note

## Basic Information

- **Project Name**: 打卡便利贴
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📌 打卡便利贴（中转站每日打卡 + 额度记录）

一个以"便利贴"形态贴在桌面上的 Electron 小工具，用来提醒免费中转站的每日打卡，并记录每天的剩余额度、生成随时间变化的额度曲线。

## ✨ 功能

- **打卡提醒**：按中转站网址折叠分组；每个账号点一下「打卡」标记今日已打卡，跨天自动回到未打卡状态。
- **连续打卡**：自动统计每个账号的 🔥 连续天数。
- **额度记录**：手动给每个账号录入当天的剩余额度（支持小数），顶部与组头实时汇总今日合计。
- **额度曲线**：单账号或整组绘制的随时间变化曲线（纯 canvas 自绘，无第三方依赖），按真实日期间隔展示，断档一眼可见。
- **便利贴交互**：无边框半透明窗口、可置顶、可拖动/缩放、位置记忆；点 × 收起到底栏托盘。
- **窗口找回**：托盘菜单「窗口移到主屏中央」，窗口跑丢或插拔显示器后一键拉回。
- **数据本地化**：全部数据存在本机 `userData` 目录，不联网、不上传，使用者的私人数据安全。

## 🚀 快速开始

需要 [Node.js](https://nodejs.org/)（建议 18+）。

### 1. 安装依赖

```bash
npm install
```

> 国内网络较慢时可使用镜像：`npm install --registry=https://registry.npmmirror.com`，
> 若 Electron 二进制下载慢，可加 `ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/`。

### 2. 启动

- Windows 直接双击 `打卡便利贴.vbs`（无黑框、后台启动），或 `启动.bat`
- 或命令行：`npm start`

想固定在桌面用，可自建快捷方式：目标填
`<项目目录>\node_modules\electron\dist\electron.exe`，参数填 `"<项目目录>"`。

> `启动.bat` / `打卡便利贴.vbs` 内部注释刻意保持纯英文：cmd 与 wscript 按系统 ANSI
> 代码页解析脚本，若在其中写 UTF-8 中文会导致命令本身乱码、双击无反应。

### 3. 首次使用

- 点右下角「➕ 添加」录入中转站名称、GitHub 账号、网址。
- 每天点账号行「打卡」；点「💰」录入当日剩余额度。
- 点账号行「📜」看该账号的打卡+额度；点组头「📈」看整组额度曲线对比。

## 🗂️ 数据存放位置

Windows：

```
%APPDATA%\checkin-sticky\checkin-data.json
```

> 数据、备份都不在仓库内，不会随 git 上传，也不存在泄露风险。

## 🛠️ 技术栈

- [Electron](https://www.electronjs.org/)（主进程 / `src/main.js`）
- 原生 HTML/CSS/JS（渲染层），`contextIsolation` + preload 白名单 IPC

## 📄 许可

MIT