📒 拾光备忘录 2.0 · 知识库文档

网址收藏 · 备忘录 · 定时提醒 —— 一站式个人效率工具 网页版 + Windows 桌面版双端同步，数据随身走。

---

一、产品介绍

拾光备忘录 2.0 是一个集 网址收藏、备忘录、定时提醒、数据看板 于一体的个人效率工具，采用「网页版 + Windows 桌面版」双端形态：

形态	说明
🌐 网页版	浏览器访问即用，适配手机/平板/电脑，数据存 MySQL
🖥️ 桌面版	Windows 单文件绿色 exe（WebView2），支持离线缓存、剪贴板收藏、全局快捷键、系统托盘
🖥️ 单机版	Windows 单文件绿色 exe（WebView2），支持离线缓存、剪贴板收藏、全局快捷键、系统托盘

核心亮点

• 三页独立界面：网址 / 备忘录 / 提醒，各司其职，信息不混杂
• 11 种提醒通道：邮件、企业微信、Bark、钉钉、飞书、Telegram 等，任选推送
• 自然语言添加提醒：输入"明天下午 3 点提醒我开会"，自动解析时间和内容
• AI 增强：配置 AI 接口后支持笔记 AI 摘要（自动分类即将上线）
• 桌面端离线可用：没网也能查网址、写备忘、看提醒，联网自动同步
• 数据看板：网址/备忘/提醒统计、推送成功率一目了然

---

二、快速开始

网页版

入口	地址
前台	http://你的域名或IP/index.php
后台	http://你的域名或IP/admin.php
默认管理员	admin / 123456（登录后请尽快修改）

演示账号：admin、xiaochen、lisi，密码均为 123456。

桌面版

从网页版下载页（或 download/ 目录）下载 exe，双击运行即可。 首次启动输入网页版服务器地址（局域网/公网/本地均可），登录后自动全量缓存。

单机版

所有数据仅保存在本机，不上传任何服务器。适合介意数据上云的场景。 ✅ 网址 / 备忘 / 提醒 全功能 ✅ 不上传任何数据，纯本地保存 ✅ 不联网、不登录、无账号，打开即用 ✅ 数据仅存本机 %APPDATA%\SGBWL2Lite ✅ 与联网版数据互不干扰，可同时安装

---

三、网址收藏（前台第 1 页）

功能

• 🔗 收藏网址：标题、链接、分类、标签、备注、置顶
• 🗂️ 分类管理：常用 / 工作 / 学习 / 生活，可自定义增删改
• 🏷️ 多彩标签：给网址打标签，快速筛选
• 📋 剪贴板收藏（桌面端）：复制链接后自动弹出收藏卡片，一键入藏
• 🕵️ 死链检测：定时扫描失效链接并标记
• ⭐ 置顶 / 🆕 新收藏标识：重要网址置顶，新收藏高亮

数据看板

首页看板展示：网址总数、备忘录数、提醒总数、注册用户、提醒发送量、推送成功率，以及今日新增、最近备份等系统状态。

---

四、备忘录（前台第 2 页）

功能

• 📝 富文本笔记：标题 + 内容，自动统计字数
• 📚 笔记本分类：工作 / 生活 / 灵感，可自定义管理（新建/重命名/删除）
• 🏷️ 彩色标签：笔记标签多彩展示
• 📌 置顶笔记：重要笔记置顶显示
• 🔗 分享链接：生成分享 Token，对外分享单篇笔记
• 🤖 AI 摘要：配置 AI 后一键生成 100 字以内要点摘要
• 🗑️ 回收站：删除的笔记进回收站（deleted_at），可恢复

---

五、定时提醒（前台第 3 页）

功能

• ⏰ 创建提醒：内容 + 时间 + 重复方式 + 渠道 + 提前提醒
• 🗣️ 自然语言添加：输入一句话自动解析
  • 明天下午3点提醒我开会 → 明天 15:00
  • 每周一早上9点吃药 → 每周一 09:00（重复）
  • 30分钟后提醒我喝水 → 30 分钟后
• 🔁 重复方式：仅一次 / 每天 / 每周 / 每月 / 工作日
• ⭐ 重要提醒：标记后推送时高亮提示
• ⏰ 提前提醒：支持提前 N 分钟推送（如提前 10 分钟）
• 📊 提醒日志：每次推送记录状态（成功/失败）与结果
• 🖥️ 桌面弹窗通道：桌面端到点弹窗，100% 可见

到点提醒怎么触发？

依赖 cron 计划任务（服务器端每分钟执行一次扫描）。见 部署安装。

---

六、通知渠道（11 种）

| 渠道 | code | 说明 | |---|---|---| | 📧 邮件 | email | 站点 SMTP 发送到用户绑定邮箱 | | 💬 企业微信 | wechat | 群机器人 Webhook（markdown 卡片样式） | | 🔔 Bark | bark | iOS 端 Bark App 推送 | | 📢 Server酱 | serverchan | ServerChan 微信推送 | | 🤖 钉钉 | dingtalk | 钉钉群机器人 | | ✈️ 飞书 | feishu | 飞书群机器人 | | 📡 Telegram | telegram | Bot API 推送 | | 📮 PushPlus | pushplus | 微信服务号推送 | | ⚡ Gotify | gotify | 自建 Gotify 推送 | | 📣 ntfy | ntfy | 开源 ntfy 推送 | | 🔗 自定义 Webhook | webhook | 任意 HTTP 回调 | | 🖥️ 桌面弹窗 | desktop | 桌面端应用内弹窗（系统级） |

特性

• 通道配置：后台「通知渠道」页逐通道填写参数（Key/Token/Webhook 等）
• 测试推送：每个通道可单独发送测试；一键「全局测试」发到所有已启用通道
• 兜底机制：所选通道发送失败时，自动降级发到用户绑定邮箱（需配置 SMTP）
• 用户自选：用户可在设置中勾选自己的通知通道；未启用则跳过
• 状态监控：通道故障自动标记红点告警

---

七、AI 能力

后台「站点设置 → AI 配置」填写 OpenAI 兼容接口（如 DeepSeek）： | 字段 | 示例 | |---|---| | AI 接口地址 | https://api.deepseek.com/v1 | | API Key | sk-xxx | | 模型名称 | deepseek-chat |

已上线能力

| 能力 | 状态 | 说明 | |---|---|---| | 🤖 AI 摘要 | ✅ 已上线 | 笔记详情页一键生成要点摘要（≤100 字） | | 🗣️ 自然语言提醒 | ✅ 已上线 | 本地规则解析，不依赖 AI、不耗 token | | 🗂️ 自动分类 | 🔜 开发中 | 收藏网址自动分入类别/打标签（界面占位，待实现） |

未配置 Key 时，「自然语言添加提醒」仍可正常使用（本地解析）。

---

八、后台管理

后台入口 admin.php，登录后左侧菜单分组： | 分组 | 功能 | |---|---| | 📊 总览 | 仪表盘、数据趋势 | | 👥 运营 | 用户管理、提醒日志、公告管理、审计日志 | | ⚙️ 配置 | 站点设置、通知渠道、推送模板、定时任务 | | 🛡️ 安全 | 安全风控（登录锁定/2FA/敏感词）、API 令牌 | | 🎨 内容与数据 | 品牌与内容（Logo/主题色/ICP）、数据管理（备份/恢复）、系统信息 |

关键配置项

• 站点设置：站点标题/描述/关键词、SMTP 邮件、桌面版下载地址、注册开关（邀请码）、AI 配置、品牌色/Logo
• 推送模板：各渠道消息模板（{内容} {时间} 占位符）
• 定时任务：提醒扫描、自动备份、日志清理、死链检测
• 安全风控：登录失败锁定、两步验证、敏感词过滤、审计日志保留天数

---

九、Windows 桌面版

形态

单文件绿色 exe（约 24MB），无需安装，双击运行。基于 pywebview + WebView2。

功能

| 功能 | 说明 | |---|---| | 📂 三页界面 | 网址 / 备忘录 / 提醒，与网页端一致 | | 📴 离线模式 | 断网可用，数据存本地 SQLite，联网自动双向同步 | | 📋 剪贴板收藏 | 复制链接自动弹出收藏卡片 | | ⌨️ 全局快捷键 | 任意界面唤出（默认 Ctrl+Alt+U） | | 🗂️ 系统托盘 | 最小化/关窗隐藏到托盘，右键菜单：打开主界面/快速提醒/快速记事/今日待办/退出 | | 🔔 智能通知 | 主窗口可见→应用内弹窗；隐藏/最小化→右下角系统气泡 | | 🔒 单实例检测 | 已在运行时再双击不会开第二个实例，自动唤回主窗口 | | 🔐 启动密码锁 | 可设置启动密码 | | 🚀 开机自启 | 可选开机自动启动（注册表 Run） |

使用流程

1. 下载 exe → 双击运行
2. 首次启动：设置服务器地址（网页版地址）→ 登录
3. 自动全量同步 → 日常使用
4. 退出程序：托盘图标右键 → 「退出」（不是关窗口，关窗口=隐藏到托盘）

更新

下载页（download/）随版本更新 exe 文件，后台「站点设置 → 桌面版下载」配置最新版本号与更新日志。

---

十、部署安装（网页版）

环境要求

组件	要求
PHP	7.4+（推荐 8.x）
MySQL	5.7+（推荐 8.0），需 utf8mb4
Web 服务器	Nginx / Apache 均可，不依赖伪静态/重写规则
系统	Windows（phpstudy）/ Linux（宝塔/云服务器）通用

安装步骤（全新安装）

1. 上传：将安装包解压到网站根目录
   • 例：phpstudy D:\phpstudy_pro\WWW\站点目录 或宝塔 /www/wwwroot/站点目录
2. 建库：在 MySQL 中创建数据库并授权账号

   CREATE DATABASE 库名 DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. 访问安装向导：浏览器打开 http://你的域名或IP/install.php
4. 填写数据库信息：地址 / 端口 / 库名 / 用户名 / 密码 → 点「开始安装」
   • 自动完成：建表（17 张）→ 写基础配置 → 生成 db_config.php
5. 登录使用：打开前台 index.php，管理员 admin / 123456
6. 删除安装文件：安装完成后删除 install.php，防止被重复安装重置数据

配置定时任务（重要！）

提醒推送依赖 cron 每分钟执行：

Linux / 宝塔

# 添加到 crontab
* * * * * php /网站根目录/cron.php >/dev/null 2>&1

宝塔面板：计划任务 → Shell 脚本 → 每分钟执行 php /网站根目录/cron.php

Windows / phpstudy

schtasks /create /tn "拾光cron" /tr "D:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe D:\phpstudy_pro\WWW\站点\cron.php" /sc minute

不配置计划任务，提醒不会自动推送。

目录结构

文件	作用
index.php	前台（网址/备忘/提醒/看板）
admin.php	后台管理
api.php	前端接口 + 桌面端同步接口
cron.php	定时任务执行器
install.php	安装向导（安装后删除）
share.php	笔记分享页
db.php / functions.php	数据库连接 / 公共函数
config.php	全局配置（默认本机；db_config.php 优先覆盖）
assets/	静态资源（favicon、CA 证书）
backup/	自动备份目录
download/	桌面版下载页 + exe
error/	错误页

---

十一、数据备份与安全

自动备份

• cron 每天 03:00 自动备份全库 → backup/auto-YYYYMMDD-HHMMSS.json
• 保留最近 30 份，超限自动清理
• 后台「数据管理」可手动备份 / 恢复 / 下载

安全特性

• 🔒 登录失败锁定：连续 5 次失败锁定 15 分钟
• 🔑 两步验证（2FA）可开启
• 🚫 敏感词过滤（sensitive_words 表）
• 📋 审计日志：后台关键操作全程留痕（保留 90 天，可配）
• 🔐 密码哈希存储（password_hash）

---

十二、常见问题 FAQ

Q1：安装时报"创建数据表失败"？

A：数据库账号缺少 CREATE 权限，或数据库未提前创建。请先用 root 建库并授权。

Q2：提醒不推送？

A：先确认 cron 计划任务已配置（每分钟执行 cron.php）。再检查：通道是否启用、用户是否勾选该通道、通道参数是否正确（后台可点「发送测试」验证）。

Q3：页面乱码/emoji 报错？

A：数据库排序规则必须为 utf8mb4（安装脚本已强制），PHP 连接用 SET NAMES utf8mb4。

Q4：邮箱收不到提醒？

A：后台「站点设置 → 邮件 SMTP」填写真实 SMTP（QQ/163 需授权码而非密码），用「全局测试推送」验证。邮件通道失败会自动降级发到用户绑定邮箱。

Q5：桌面版提示"正在运行"但看不到窗口？

A：有残留进程占着单实例锁。任务管理器结束所有"拾光备忘录"进程，或重启电脑。

Q6：桌面版怎么改服务器地址？

A：锁屏界面可修改服务器地址；或删除本地数据目录 %APPDATA%\SGBWL2 后重新配置。

Q7：桌面版断网能用吗？

A：能。离线模式下本地 SQLite 照常读写，联网后自动双向同步（防冲突合并）。

Q8：安装包里的 backup/ 目录是干嘛的？

A：自动备份目录。cron 会自动创建，无需手动建。若手动建目录，请确保有写权限。

---

附：技术栈

层	技术
后端	PHP 8.x（原生，无框架）+ MySQL 5.7/8.0
前端	原生 HTML/CSS/JS，扁平多彩 UI，前后端控制器模式
桌面端	Python + pywebview（WebView2）+ SQLite，PyInstaller 打包
通知	纯 PHP SMTP / cURL 多通道推送

---

文档版本：2026-08-13 · 拾光备忘录 2.0