Typecho handsome 睡眠记录数据展示插件 - SleepData

SleepData 插件是一个用于在 Typecho 博客系统中记录、存储和分析个人睡眠数据的工具。它解决了部分健康应用（如 OPPO 健康）数据封闭、无公开 API 的问题，允许用户将数据掌握在自己手中。

核心问题与解决方案

许多健康应用（例如 OPPO 健康）不提供公开的 API 接口，也无法将数据同步到 Google Fit 等开放平台，导致用户的健康数据完全封闭，难以进行统一管理和长期分析。

本插件通过提供一个独立的数据录入和存储系统来解决此问题。用户可以通过截图 OCR 识别、手动录入或 API 调用等方式，将睡眠数据保存在自己的服务器上，从而实现数据的自主掌控和长期追踪。

工作流程

整个数据处理流程从用户手机端的健康应用开始，经过前端的 OCR 识别与数据提交，再到服务器端的处理与存储，最后通过不同的页面进行展示。

插件特性

• 数据自主可控: 所有数据存储在用户自己的服务器上。
• 双重存储: 同时保存到数据库和 JSON 文件，保证数据安全。
• OCR 自动录入: 通过识别截图，简化数据输入过程。
• API 支持: 开放 API 接口，方便进行二次开发或批量导入。
• 自适应存储: 自动检测服务器环境，寻找可写目录，无需手动配置。
• 双重配置: 支持后台配置和文件配置两种方式，提高灵活性。
• Handsome 主题集成: 与 Handsome 主题无缝集成，支持顶部导航栏和侧边栏展示。

使用指南

1. 安装插件

1. 从源码地址下载插件压缩包。
2. 解压后，将文件夹重命名为 SleepData。
3. 上传 SleepData 文件夹到 Typecho 的 usr/plugins 目录下。
4. 登录 Typecho 后台，进入"控制台" -> "插件"，找到"SleepData"并启用。

2. 配置插件

启用插件后，点击"设置"进入配置页面。

• API 访问令牌: 设置一个足够复杂的字符串作为 API 访问的密钥。这是保证数据安全的关键。
  

此令牌有两种配置方式，系统会优先使用方法一：

1. 方法一（推荐）: 直接在后台设置页面填写并保存。
2. 方法二（备用）: 编辑插件目录下的 data_config.php 文件，修改 API_ACCESS_TOKEN 的值。

3. 数据录入

方式一：OCR 识别上传（推荐）

这是最便捷的方式，尤其适用于从手机健康 App 录入数据。

1. 在浏览器中打开插件目录下的 https://博客地址/sleep-data-uploader/index.html 文件。
2. 填写您的 API 地址 和 访问令牌 （一次填写后浏览器会记住）。
3. 点击"拍照识别"或"选择截图"按钮，上传您在健康 App 中截取的睡眠数据图片。
4. 系统会自动识别图片中的数据并填充到表单中。
5. 核对无误后，点击"发送数据"。

方式二：手动输入

如果 OCR 识别有误或没有截图，可以选择手动填写所有睡眠数据，然后点击"发送数据"。

方式三：通过 API 上传

对于有开发能力的用户，可以通过 POST 请求直接向 API https://博客地址/usr/plugins/SleepData/simple-api.php 提交数据。请求体为 JSON 格式，需包含access_token及所有睡眠数据字段。

4. 查看数据

1. 后台查看: 在 Typecho 后台的插件设置页面，会直接展示最近 50 条睡眠记录。
2. 独立页面查看: 访问 https://博客地址/usr/plugins/SleepData/view-data.php 可以查看 JSON 文件中的所有数据记录。
3. 数据库查看: 在数据库中的typecho_sleep_data表中查看所有数据记录。
4. 根目录查看: 在根目录下的temp/sleep_data.json文件中查看所有数据记录。

5. 在 Handsome 主题中展示睡眠数据

展示一：添加到顶部导航栏

1. 效果展示
   

2. 添加代码到主题的headnav.php文件中。
   
   

   php代码，放在nav navbar-nav hidden-sm的ul中

   
   

   此处内容需要评论回复后（审核通过）方可阅读。

   
   

   
   
   JS代码，添加到前面

   
   

   此处内容需要评论回复后（审核通过）方可阅读。

   
   

展示二：添加到侧边栏

1. 效果展示
   

2. 添加代码到主题的sidebar.php文件中。
   
   

   php代码，放在博客信息的上下即可

   
   

   此处内容需要评论回复后（审核通过）方可阅读。

   
   

最后

插件使用过程中有任何问题，欢迎在评论区留言。

插件Github地址：

网盘下载：