nonebot-plugin-daily-attendance 0.1.0__tar.gz

nonebot_plugin_daily_attendance-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+.pytest_cache/
+.ruff_cache/
+dist/
+.DS_Store
+nonebot_plugin_daily_attendance/data/

nonebot_plugin_daily_attendance-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 QingYingX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nonebot_plugin_daily_attendance-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-daily-attendance
+Version: 0.1.0
+Summary: 移植自 Daily-Attendance-plugin 的每日运势签到插件：运势生成、等级系统、随机一言、搞怪黄历
+Project-URL: Homepage, https://github.com/TonyLiangP2010405/nonebot-plugin-daily-attendance
+Project-URL: Repository, https://github.com/TonyLiangP2010405/nonebot-plugin-daily-attendance
+Author: TonyLiangP2010405
+License: MIT
+License-File: LICENSE
+Keywords: attendance,daily,fortune,level-system,nonebot,nonebot2,plugin,sign-in
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: nonebot-adapter-onebot>=2.4.0
+Requires-Dist: nonebot-plugin-apscheduler>=0.3.0
+Requires-Dist: nonebot-plugin-htmlrender>=0.3.0
+Requires-Dist: nonebot2>=2.2.0
+Provides-Extra: dev
+Requires-Dist: nonebot2[fastapi]>=2.2.0; extra == 'dev'
+Requires-Dist: nonebug>=0.3; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# nonebot-plugin-daily-attendance
+
+移植自 [Daily-Attendance-plugin](https://gitee.com/qingyingxbot/Daily-Attendance-plugin)（TRSS-Yunzai 插件）的 NoneBot2 每日运势签到插件。
+
+## 功能
+
+- **每日运势生成** —— 基于用户ID和日期的伪随机运势（Beta 分布），确保每日不同
+- **等级系统** —— 经验值累积，50 个等级等你挑战
+- **随机一言** —— 来自一言 API 的精选语录，支持本地备用库
+- **搞怪黄历** —— 每日宜忌事项，趣味十足
+- **时间问候** —— 根据当前时间智能问候
+- **特殊日期** —— 支持特定日期自定义运势、一言、黄历、经验加成
+- **美观渲染** —— 基于 HTML 模板的精美图片展示（nonebot-plugin-htmlrender）
+- **自动清理** —— 快照数据每日 00:00 自动清理，60 天未签到用户数据自动归档
+
+## 安装
+
+### 使用 nb-cli 安装
+
+```bash
+nb plugin install nonebot-plugin-daily-attendance
+```
+
+### 使用 pip 安装
+
+```bash
+pip install nonebot-plugin-daily-attendance
+```
+
+### 使用 poetry 安装
+
+```bash
+poetry add nonebot-plugin-daily-attendance
+```
+
+图片渲染依赖 Playwright，首次使用需要安装浏览器：
+
+```bash
+playwright install chromium
+```
+
+## 配置
+
+在 NoneBot 项目的 `.env` 文件中添加（可选，均有默认值）：
+
+```env
+# 用户数据存储目录（默认为插件包内 data/ 目录）
+DAILY_ATTENDANCE_DATA_DIR=/path/to/data
+```
+
+其他业务数据配置位于插件包 `config_data/` 目录下的 JSON 文件：
+
+- `levelData.json` —— 等级数据配置
+- `fortuneData.json` —— 运势描述配置
+- `timeGreetings.json` —— 时间问候语配置
+- `Things.json` —— 黄历事件配置（包含宜忌事项）
+- `apis.json` —— API 地址配置（一言 API、背景图 API）
+- `specialDates.json` —— 特殊日期配置（可选，用于设置特定日期的运势、一言等）
+
+备用一言库 `hitokotoBackup.json` 会在数据目录中自动生成，无需手动配置。
+
+## 使用方法
+
+| 指令 | 权限 | 范围 | 说明 |
+|---|---|---|---|
+| #今日运势 / #jrys / #孑然一身 | 所有人 | 群聊/私聊 | 获取今日运势并签到 |
+| #运势统计 / #ystj | 所有人 | 群聊/私聊 | 查看个人统计信息 |
+| #运势数据 / #yssj | 所有人 | 仅群聊 | 查询当前群聊今日签到情况 |
+| #运势总数据 / #yszsj | 所有人 | 群聊/私聊 | 查询总的今日签到情况（仅当日数据） |
+| #运势排行榜 / #ysphb | 所有人 | 群聊/私聊 | 查看全局运势排行榜 |
+| #一言统计 / #yytj | 所有人 | 群聊/私聊 | 查看备用一言库统计信息 |
+| #运势帮助 / #ysbz | 所有人 | 群聊/私聊 | 查看帮助 |
+
+所有指令的 `#` 前缀均可省略。
+
+## 示例
+
+用户：#今日运势
+机器人：[运势图片]（运势值、等级进度、今日宜忌、一言）
+
+用户：#运势统计
+机器人：📊 个人统计信息 ……
+
+## 数据存储
+
+- 用户签到数据：`{数据目录}/user_signs/{user_id}.json`
+- 每日快照数据：`{数据目录}/snapshot/{user_id}_{date}.json`（每日 00:00 自动清空）
+- 过期用户数据：`{数据目录}/expired/`（60 天未签到自动归档，再次签到时自动恢复）
+- 备用一言库：`{数据目录}/hitokotoBackup.json`（自动生成）
+
+## 许可证
+
+MIT（与原项目一致）
+
+**免责声明**：本插件仅供娱乐使用，运势内容为随机生成，请勿迷信。

nonebot_plugin_daily_attendance-0.1.0/README.md

@@ -0,0 +1,95 @@
+# nonebot-plugin-daily-attendance
+
+移植自 [Daily-Attendance-plugin](https://gitee.com/qingyingxbot/Daily-Attendance-plugin)（TRSS-Yunzai 插件）的 NoneBot2 每日运势签到插件。
+
+## 功能
+
+- **每日运势生成** —— 基于用户ID和日期的伪随机运势（Beta 分布），确保每日不同
+- **等级系统** —— 经验值累积，50 个等级等你挑战
+- **随机一言** —— 来自一言 API 的精选语录，支持本地备用库
+- **搞怪黄历** —— 每日宜忌事项，趣味十足
+- **时间问候** —— 根据当前时间智能问候
+- **特殊日期** —— 支持特定日期自定义运势、一言、黄历、经验加成
+- **美观渲染** —— 基于 HTML 模板的精美图片展示（nonebot-plugin-htmlrender）
+- **自动清理** —— 快照数据每日 00:00 自动清理，60 天未签到用户数据自动归档
+
+## 安装
+
+### 使用 nb-cli 安装
+
+```bash
+nb plugin install nonebot-plugin-daily-attendance
+```
+
+### 使用 pip 安装
+
+```bash
+pip install nonebot-plugin-daily-attendance
+```
+
+### 使用 poetry 安装
+
+```bash
+poetry add nonebot-plugin-daily-attendance
+```
+
+图片渲染依赖 Playwright，首次使用需要安装浏览器：
+
+```bash
+playwright install chromium
+```
+
+## 配置
+
+在 NoneBot 项目的 `.env` 文件中添加（可选，均有默认值）：
+
+```env
+# 用户数据存储目录（默认为插件包内 data/ 目录）
+DAILY_ATTENDANCE_DATA_DIR=/path/to/data
+```
+
+其他业务数据配置位于插件包 `config_data/` 目录下的 JSON 文件：
+
+- `levelData.json` —— 等级数据配置
+- `fortuneData.json` —— 运势描述配置
+- `timeGreetings.json` —— 时间问候语配置
+- `Things.json` —— 黄历事件配置（包含宜忌事项）
+- `apis.json` —— API 地址配置（一言 API、背景图 API）
+- `specialDates.json` —— 特殊日期配置（可选，用于设置特定日期的运势、一言等）
+
+备用一言库 `hitokotoBackup.json` 会在数据目录中自动生成，无需手动配置。
+
+## 使用方法
+
+| 指令 | 权限 | 范围 | 说明 |
+|---|---|---|---|
+| #今日运势 / #jrys / #孑然一身 | 所有人 | 群聊/私聊 | 获取今日运势并签到 |
+| #运势统计 / #ystj | 所有人 | 群聊/私聊 | 查看个人统计信息 |
+| #运势数据 / #yssj | 所有人 | 仅群聊 | 查询当前群聊今日签到情况 |
+| #运势总数据 / #yszsj | 所有人 | 群聊/私聊 | 查询总的今日签到情况（仅当日数据） |
+| #运势排行榜 / #ysphb | 所有人 | 群聊/私聊 | 查看全局运势排行榜 |
+| #一言统计 / #yytj | 所有人 | 群聊/私聊 | 查看备用一言库统计信息 |
+| #运势帮助 / #ysbz | 所有人 | 群聊/私聊 | 查看帮助 |
+
+所有指令的 `#` 前缀均可省略。
+
+## 示例
+
+用户：#今日运势
+机器人：[运势图片]（运势值、等级进度、今日宜忌、一言）
+
+用户：#运势统计
+机器人：📊 个人统计信息 ……
+
+## 数据存储
+
+- 用户签到数据：`{数据目录}/user_signs/{user_id}.json`
+- 每日快照数据：`{数据目录}/snapshot/{user_id}_{date}.json`（每日 00:00 自动清空）
+- 过期用户数据：`{数据目录}/expired/`（60 天未签到自动归档，再次签到时自动恢复）
+- 备用一言库：`{数据目录}/hitokotoBackup.json`（自动生成）
+
+## 许可证
+
+MIT（与原项目一致）
+
+**免责声明**：本插件仅供娱乐使用，运势内容为随机生成，请勿迷信。