sleepy

一个用于 视奸 查看个人在线状态 (以及正在使用软件) 的 Flask 应用，让他人能知道你不在而不是故意吊他/她

功能 / TODO / 演示 / 部署 / 使用 / 关于

功能

• 自行设置在线状态
• 实时更新设备打开应用 (名称)
• 美观的展示页面 [见 Preview]
• 开放的 Query / Metrics 接口, 方便统计

TODO

• 拆分 config.jsonc (只读) 和 data.json (#3)
• 网页使用 api 请求，并实现定时刷新
• 设备使用状态
• Windows 客户端 (Python)
• Android 客户端 (Autox.js)
• 查看更多客户端 (如浏览器脚本)
• Metrics API (统计页面访问 / 接口调用次数)
• 设备状态使用 Heartbeat 超时判定未在使用
• 更多状态存储选项 (如 SQLite)

Tip

最新开发进度/ TODOs 见: Discord Server
如有 Bug / 建议, 可 issue 或 More contact (注明来意).

对智能家居 / Home Assistant 感兴趣的朋友，一定要看看 WinMEMZ 的 sleepy 重生版: maoawa/project-sleepy!

Preview

演示站 (较稳定): sleepy.wyf9.top

开发预览 (不保证可用): sleepy-preview.wyf9.top

区别: 演示站为 wyf9 个人站点; 预览站允许测试 API，且直接运行开发版本 (密钥 wyf9test)

Warning

不要拿演示站做坏事 (比如 js 注入，已由 DeepSeek 强力修复) ，没准哪天我会加访问日志

部署

理论上全平台通用, 安装了 Python >= 3.6 即可 (建议: 3.10+)

1. Clone 本仓库 (建议先 Fork / Use this template)

git clone --depth=1 -b main https://github.com/wyf9/sleepy.git

2. 安装依赖

pip install flask pytz

3. 编辑配置文件

先启动一遍程序:

python3 server.py

如果不出意外，会提示: config.jsonc not exist, creating，同时目录下出现 config.jsonc 文件，编辑该文件中的配置后重新运行即可

>> 配置示例 << (config.jsonc 从此复制)

使用

Important

使用宝塔面板 (uwsgi) 等部署时，请确定只为本程序分配了 1 个进程, 如设置多个服务进程可能导致数据不同步!!!

有两种启动方式:

# 直接启动
python3 server.py
# 简易启动器
python3 start.py

默认服务 http 端口: 9010 (可在 config.jsonc 中修改)

我承认你的代码写的确实很nb，但对我来说还是太吃操作了

by @kmizmal

点!此!展!开! (大图警告)

有没有更简单无脑的方法推荐一下
有的兄弟，有的！ 这样的方法有很多个，各个都是GitHub T_0.5的操作
我怕教太多了你学不会，现在只要点
这里
然后自己去注册一个账号 填入一个秘钥（随便写但不推荐特殊符号及中文 然后在这里 就可以复制你的URL，填入你选择的 /client 对应的url配置中即可快速开始

客户端示例

如果你想直接开始使用，可在 /client 找到客户端 (用于手动更新状态/自动更新设备打开应用)

API

详细的 API 文档见 doc/api.md.

优化站点

见 Best Practice

更新

只需 4 步:

1. 使用 git pull 拉取最新代码 (注意查看所在分支是否存在)
2. 启动服务 (应提示 Config fotmat updated, please change your config.jsonc 并退出)
3. 对照 config.example.jsonc 和 doc/config_update.md 编辑你的 config.jsonc，并将 version 字段改为最新版本
4. 再次启动服务，更新完成.

Huggingface

对照 config.example.jsonc 和 doc/config_update.md 编辑Files下的 config.example.jsonc，并将 version 字段改为最新版本

Star History

关于

本项目灵感由 Bilibili UP @WinMEMZ 而来: site / blog, 并部分借鉴使用了前端代码, 在此十分感谢。

也欢迎参观 WinMEMZ (GitHub: maoawa) 的原版！maoawa/sleepy 已归档

感谢 @1812z 的 B 站视频推广~ (BV1LjB9YjEi3)