插件目录内包含了打包的二进制依赖，导致在 macOS ARM 上产生冲突

[ShimizuRiko]

Plugin Version

2.0.6

AstrBot Version

AstrBot v4.19.4

Database Type

SQLite (default)

Operating System

macOS

Bug Description

插件目录内打包了大量第三方依赖（包括含 .so 二进制的包），在 macOS ARM（Apple Silicon）环境下与系统全局依赖冲突，导致其他插件的子进程启动时崩溃。

报错信息：
ModuleNotFoundError: No module named 'jiter.jiter'
ModuleNotFoundError: No module named 'pydantic_core._pydantic_core'
ModuleNotFoundError: No module named 'rpds.rpds'

根本原因：插件目录内的 jiter/、pydantic/、pydantic_core/、rpds/ 等包含的二进制文件是 Linux x86 环境下编译的，无法在 macOS ARM 上加载。由于 AstrBot 会将所有插件目录加入 sys.path，当其他插件开启子进程时，Python 优先找到了插件目录内的残缺版本，导致进程池崩溃。

建议修复：将所有第三方依赖加入 .gitignore，改用 requirements.txt 声明依赖，由用户环境自行安装适配本地平台的版本。

Steps to Reproduce

1. 在 macOS ARM (Apple Silicon) 上安装插件
2. 启动 AstrBot
3. 触发任何需要子进程的插件功能（如 astrbot_plugin_help_typst 的 /helps 命令）
4. 子进程因加载插件目录内残缺的二进制包而崩溃

Expected Behavior

插件正常加载，不影响其他插件的子进程运行

Error Logs

ModuleNotFoundError: No module named 'jiter.jiter'
File "/Users/.../data/plugins/astrbot_plugin_self_learning/jiter/__init__.py"

ModuleNotFoundError: No module named 'pydantic_core._pydantic_core'
File "/Users/.../data/plugins/astrbot_plugin_self_learning/pydantic_core/__init__.py"

ModuleNotFoundError: No module named 'rpds.rpds'
File "/Users/.../data/plugins/astrbot_plugin_self_learning/rpds/__init__.py"

concurrent.futures.process.BrokenProcessPool: A process in the process pool was terminated abruptly while the future was running or pending.

Relevant Configuration

Additional Context

临时修复方法：手动删除插件目录内的以下文件夹即可恢复正常：
jiter/、jiter-0.13.0.dist-info/
pydantic/、pydantic_core/
rpds/、rpds_py-0.30.0.dist-info/
以及其他所有打包进插件目录的第三方库文件夹。

根本修复建议：在 .gitignore 中排除所有第三方依赖目录，改用 requirements.txt 管理依赖。

[NickCharlie]

@ShimizuRiko
感谢反馈！这个问题并非插件源码本身导致的：

1. 插件仓库不包含任何第三方依赖

无论是从 GitHub 下载还是通过 AstrBot 插件市场安装，本插件的发行版目录中不包含 jiter/、pydantic/、pydantic_core/、rpds/ 等第三方包。你可以查看仓库文件列表确认——所有第三方依赖均通过 requirements.txt 声明，由 AstrBot 在安装时自动 pip install。

检查：你本地的插件目录中出现这些文件夹，很可能是之前某次本地操作（如手动 pip install --target .、拷贝了其他环境的文件、或某个旧版本的残留）导致的。

2. 依赖管理已完全使用 requirements.txt

当前版本的所有依赖（包括 pydantic>=2.0.0）均在 requirements.txt 中声明，由用户本地环境的 pip 安装平台适配的版本。不存在打包二进制依赖的问题。

3. venv 路径冲突属于 AstrBot 框架层面的问题

你描述的根本原因是 AstrBot 将所有插件目录加入 sys.path，导致插件目录内的残留文件优先于全局安装的正确版本被加载，这是没有按照Astrbot官方文档的建议使用venv或者是docker容器部署Astrbot框架导致的问题，建议使用venv环境或者容器部署运行Astrbot框架解决该问题

我的建议

1. 清理插件目录中的残留依赖：
   如果不确定哪些文件是插件本身的，可以对比插件仓库源码，删除所有不在仓库中的目录。
2. 重新安装插件： 在 AstrBot 中卸载后重新从插件市场安装，确保获得干净的插件目录。
3. 如果使用 Docker 部署 AstrBot： Docker 环境下各插件的依赖隔离更好，可以避免此类平台不匹配问题。

如出现依赖缺失，请参照issue #62 的方案解决问题

[ShimizuRiko]

感谢解释！确认了残留文件应该是之前某次手动 pip install --target . 操作遗留的，并非插件本身的问题。删除残留文件后恢复正常 :)

[NickCharlie]

Resolved - confirmed as leftover files from a previous manual pip install, not a plugin packaging issue.