当前版本 v1.50（2026-08-05）
公益站自动签到助手用于在 Chrome 中管理多个公益 API 站点的每日签到。扩展支持NewAPI、Sub2API等多类型站点，并兼容 ZenAPI、页面按钮签到、仅访问页面等场景。
- 快捷键：非输入态下按
/直接聚焦搜索框。 - 筛选新增「待手动」与「今日失败」：一键筛出需人工处理或失败的站点。
- 统计区「待手动」计数：有待手动站时自动显示。
- 审查修复：目录自动同步 / 单站重试现也正确保留
manual模式与「待手动」语义（不再被错误归为 checkin/硬失败）。
- 列表搜索框：站点列表上方新增搜索框，输入关键字实时过滤（按站名 + 网址/域名 + 备注匹配，大小写不敏感，多关键字需全部命中）。Esc 或 ✕ 清空。
- 手动模式：站点新增第三模式。模式按钮三态循环 自动 → 访问 → 手动 → 自动。手动模式会先试自动签到，失败才标记为「待手动」，交给你点「手动打开」在页面内完成（不算失败）。
- 签到只签一次：每站每天最多真正签一次（本地已尝试 + 在线探测已签双重去重），定时/补跑/一键/手动均不重签。
- 网页只打开一次：当日共享台账（
sitePageOpenLog），失败开页 / 手动打开 / 7 天复查共用，同一天同一站不重复开页（跨日自动重置）。 - 重试不再重复开页：同一站点的多次重试复用同一个后台标签页，不再每次新开。
- 一键签到：点主按钮立刻后台跑，弹窗不卡整轮；有未签签未签，只剩失败则重试失败
- 手动打开：只开网站，由你在页面点签到
- 签完开失败：一键签到结束后自动打开失败站
- 一键签到进度：主按钮
3/12 签到中+ 当前站名；收尾摘要「成功/已签/失败/跳过」 - 站内自动重试：主循环接回
retryTimes退避重试（invalid 不重试） - 成功站零间隔：API 成功/已签站间不等待，整体更快
- 自动签到 / 手动打开：自动=插件完成；手动=打开网站由你点签到
- 一键签未完成 / 打开无法签到 / 7天复查打开
- 收藏置顶、站点类型徽章、总金额汇总
- 导入智能合并：识别重复域名并合并差异字段
- 站点数量统计、修改站点可改类型/模式/备注/收藏
- 数据防丢：保存即备份，更新后可「恢复数据」
- 每站每天只签一次，失败立刻下一站；fetch 软失败降噪汇总
- 自动识别站点类型：新增站点默认自动识别 NewAPI、Sub2API、ZenAPI 等类型。
- 登录态优先复用：优先使用缓存认证头和浏览器已有登录态，必要时才触发 linux.do OAuth。
- 接口签到：根据站点类型调用对应签到接口。
- 页面兜底签到：接口失败时后台打开填写的签到页链接，查找并点击“签到 / 签 / Check in”等按钮。
- 访问模式：适合只需要每天访问页面的站点。
- 余额展示：本轮签到或访问后获取到余额才展示；本轮没获取到就不展示旧余额。
- 后台静默处理：临时标签页后台打开，不抢焦点，任务结束后自动关闭。
- 站点名称获取：站点名默认用域名，运行时可从页面标题或元信息自动更新。
- 配置导入导出：支持备份和恢复站点、类型、模式、签到页链接和每日签到时间。
- 打开 Chrome 扩展管理页：
chrome://extensions/。 - 开启“开发者模式”。
- 点击“加载已解压的扩展程序”。
- 选择本目录所在的
chrome-extension文件夹。 - 固定扩展图标，方便打开弹窗。
- 点击扩展图标。
- 点击“添加站点签到页”。
- 输入签到页链接，例如
c.com/console/personal或https://c.com/console/personal。 - 如果站点只需要访问页面，勾选“仅访问”。
- 点击“添加”。
扩展会保存域名用于自动识别和接口请求，同时保存完整签到页链接用于站点跳转和页面兜底签到。
点击“立即签到”后，扩展会对所有启用站点依次执行签到。执行过程中会显示进度，站点状态会实时更新为“签到中 / 成功 / 已签 / 失败 / 失效”。
默认每天 09:00 执行。可在弹窗底部“每日签到”时间选择器中修改并保存。
- 点击站点名前的开关可启用或禁用。
- 点击站点名可后台打开签到页链接。
- 点击右侧删除按钮可删除站点。
- 没有站点或所有站点都被禁用时，“立即签到”按钮不可点击。
- 加载启用站点，并清除上一轮余额展示。
- 自动站点先识别类型，识别结果会保存到配置中。
- 如果站点名称仍是域名，尝试从页面标题或元信息获取显示名称。
- 获取认证信息：
- 使用缓存认证头。
- 缓存不可用时检查浏览器已有登录态。
- 仍不可用时，按站点类型触发 linux.do OAuth 或读取本地 token。
- 执行对应类型的签到接口。
- 接口失败时，打开填写的签到页链接进行页面兜底签到。
- 页面显示已签到、按钮不可点击、接口返回已签到时，结果记为“已签”。
- 签到结束后尝试获取最新余额。
- 保存本轮结果，关闭临时标签页。
余额只展示本轮获取到的值：
- 签到成功后会尝试获取余额。
- 今日已签也会尝试获取余额。
- 签到失败但仍有登录态或页面结果时，也会尝试获取余额。
- 页面兜底签到会在兜底页关闭前读取页面余额。
- 访问模式会从访问页面正文中识别余额。
- 如果本轮没有获取到余额，则不展示。
- NewAPI：常见接口为
/api/user/checkin，支持 linux.do OAuth。 - Sub2API：常见接口为
/api/v1/user/check-in，从本地存储读取 token。 - ZenAPI：常见接口为
/api/u/checkin，支持 linux.do OAuth。 - 页面签到站点：通过填写的签到页链接查找按钮完成签到。
- 访问站点：只访问页面并记录结果。
导出内容包含：
domain：站点域名。name：站点展示名称。enabled：是否启用。type：站点类型，通常为auto、newapi、sub2api、zenapi。mode：站点模式，访问模式为visit。pageUrl：签到页链接。autoSignTime：每日签到时间。
导入旧版配置时，缺少 type 的站点会补为 auto，下次签到时重新识别并保存。
cookies：读取目标站点和 linux.do 登录态。storage：保存站点配置、签到结果、认证缓存。alarms：每日自动签到。tabs：后台打开临时页面、站点页面和 OAuth 页面。scripting：在页面上下文中读取登录态、点击签到按钮、获取余额。webRequest：捕获站点页面发出的认证请求头。
所有数据保存在本地 Chrome Storage，不会上传到第三方服务器。
只有缓存认证和浏览器已有登录态都不可用时才会触发。已登录且能复用的站点不会每次触发 OAuth。
自动处理使用临时后台标签页。失败后也会关闭页面，不再停留给用户手动操作。
余额是可选信息。只有本轮能从响应、账户接口或页面文字中识别到余额时才显示。
Chrome 错误页、404、410 等会标记为“失效”，避免一直重复尝试。
manifest.json 扩展清单
background.js 后台签到、认证、页面兜底
popup.html 弹窗页面
popup.js 弹窗交互和列表渲染
config.js 站点配置读写和去重
schedule.js 每日定时逻辑
site-url.js 站点输入和页面 URL 处理
auth-headers.js 认证头工具
newapi-auth.js NewAPI 登录态判断
zenapi-auth.js ZenAPI OAuth 工具
checkin-result.js 签到响应解析
checkin-run-state.js 签到运行态
balance.js 余额解析
site-name.js 站点名称获取
page-status.js 页面失效判断
tab-options.js 临时标签页策略
render-guard.js 弹窗渲染并发保护
backup-config.js 导入导出
icons/ 扩展图标
node --test tests/*.test.js
node --check chrome-extension/background.js
node --check chrome-extension/popup.js
git diff --checkMIT License