{"id":31664042,"url":"https://github.com/ljzd-pro/chatloggerplugin","last_synced_at":"2026-04-09T01:31:43.324Z","repository":{"id":311476048,"uuid":"1043812069","full_name":"Ljzd-PRO/ChatLoggerPlugin","owner":"Ljzd-PRO","description":"LangBot 聊天记录插件，将群聊消息和机器人回复记录到数据库中，支持多种数据库和群聊黑白名单过滤","archived":false,"fork":false,"pushed_at":"2025-08-24T17:25:43.000Z","size":9,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-07T20:56:09.705Z","etag":null,"topics":["database","langbot","mysql","postgresql","sqlalchemy","sqlite"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ljzd-PRO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-24T17:09:15.000Z","updated_at":"2025-09-06T07:04:55.000Z","dependencies_parsed_at":"2025-08-24T21:55:07.038Z","dependency_job_id":"41f2ffa1-2199-4845-934a-ef26d68b4f82","html_url":"https://github.com/Ljzd-PRO/ChatLoggerPlugin","commit_stats":null,"previous_names":["ljzd-pro/chatloggerplugin"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Ljzd-PRO/ChatLoggerPlugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ljzd-PRO%2FChatLoggerPlugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ljzd-PRO%2FChatLoggerPlugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ljzd-PRO%2FChatLoggerPlugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ljzd-PRO%2FChatLoggerPlugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ljzd-PRO","download_url":"https://codeload.github.com/Ljzd-PRO/ChatLoggerPlugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ljzd-PRO%2FChatLoggerPlugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31581864,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","langbot","mysql","postgresql","sqlalchemy","sqlite"],"created_at":"2025-10-07T20:53:57.533Z","updated_at":"2026-04-09T01:31:43.294Z","avatar_url":"https://github.com/Ljzd-PRO.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chat Logger\n\n### 概述\nChatLoggerPlugin 是一个 LangBot 插件，用于将群聊消息和机器人回复内容记录到数据库。它支持多种数据库，能自由配置群聊黑白名单过滤，便于个性化管理和多场景应用。\n\n### 功能特色\n- **多数据库支持**：兼容 SQLite、PostgreSQL、MySQL 及其他 SQLAlchemy 支持的数据库。\n- **群组选择性记录**：可通过白名单/黑名单灵活选择记录哪些群组。\n- **机器人消息控制**：可配置是否记录机器人的回复消息。\n- **自动结构管理**：自动创建所需的数据库表，无需手动操作。\n- **异步操作**：所有数据库操作均为异步，确保系统高性能。\n- **信息完整记录**：记录用户ID、昵称、消息内容、时间戳和群组标识等信息。\n  - 目前不包含图片\n\n### 安装步骤\n\u003e [!Important]\n\u003e 仅支持 LangBot v4.0.0 之后的版本\n\n1. 在 LangBot WebUI 中安装，或使用管理员账号向机器人发送命令：\n   ```\n   !plugin get https://github.com/Ljzd-PRO/ChatLoggerPlugin\n   ```\n\n2. 安装所需依赖（选择您的数据库类型安装相关驱动）\n   - 修改 LangBot 安装目录下的 `plugins/ChatLoggerPlugin/requirements.txt` 依赖文件\n     - 不需要的驱动可以注释掉\n   ```requirements.txt\n   # ORM 框架，默认已包含，无需在意\n   sqlalchemy[asyncio]\n\n   # SQLite 驱动（默认）\n   aiosqlite\n\n   # PostgreSQL 驱动\n   asyncpg\n\n   # MySQL 驱动\n   aiomysql\n   ```\n\n3. 重启 LangBot，依赖自动安装\n\n### 配置方法\n请在 LangBot WebUI 中配置\n\n\u003e [!Note]\n\u003e 默认的 SQLite 数据库位于 `data/plugins/ChatLogger/chat_logs.db`\n\n#### 常见数据库连接地址示例\n- **SQLite**：`sqlite+aiosqlite:///./data/plugins/ChatLogger/chat_logs.db`\n- **PostgreSQL**：`postgresql+asyncpg://用户名:密码@主机:端口/数据库名`\n  - 使用 `public` 架构（Schema）\n- **MySQL**：`mysql+aiomysql://用户名:密码@主机:端口/数据库名`\n\n### 数据库结构说明\n插件会自动创建一个名为 `chat_records` 的表，其结构如下：\n\n```sql\nCREATE TABLE group_msg (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    datetime DATETIME,\n    user_id TEXT NOT NULL,\n    nickname TEXT,\n    message TEXT,\n    group_id TEXT NOT NULL\n);\n\n```\n\n### 常见问题排查\n1. **数据库连接失败**：请确认连接URL格式和帐号密码是否正确。\n3. **依赖缺失**：请根据所用数据库安装正确的驱动（aiosqlite、asyncpg、aiomysql）。\n4. **插件无法加载**：检查插件配置是否正确。\n\n### 技术支持\n如有疑问或需帮助，请访问 [GitHub 仓库](https://github.com/Ljzd-PRO/ChatLoggerPlugin) 反馈 Issue 或查阅相关文档。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fljzd-pro%2Fchatloggerplugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fljzd-pro%2Fchatloggerplugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fljzd-pro%2Fchatloggerplugin/lists"}