[Bug]压缩包打包zip格式打包好 用网页上传插件报错

[Snian629]

What happened / 发生了什么

zip格式打包好 用网页上传插件报错 提示无法安装报错 然后重启astrbot安装好了

Reproduce / 如何复现？

1.自己魔改了插件然后上传astrbot的控制ui
2.发生报错请看下方
3.然后重启astrbot
4.重启之后插件正常安装好

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

Linux 手动部署
astrbot 4.23.1

OS

Windows

Logs / 报错日志

[2026-04-17 00:55:18.368] [Core] [WARN] [v4.23.1] [star.star_manager:1812]: 安装插件 plugin_upload_astrbot_plugin_gitee_aiimg 失败，插件安装目录：/root/AstrBot/data/plugins/plugin_upload_9hzpufvs
[2026-04-17 00:55:18.369] [Core] [ERRO] [v4.23.1] [routes.plugin:571]: Traceback (most recent call last):
File "/root/AstrBot/astrbot/dashboard/routes/plugin.py", line 554, in install_plugin_upload
plugin_info = await self.plugin_manager.install_plugin_from_file(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/AstrBot/astrbot/core/star/star_manager.py", line 1737, in install_plugin_from_file
self.updator.unzip_file(zip_file_path, desti_dir)
File "/root/AstrBot/astrbot/core/star/updator.py", line 63, in unzip_file
files = os.listdir(os.path.join(target_dir, update_dir))
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
NotADirectoryError: [Errno 20] Not a directory: '/root/AstrBot/data/plugins/plugin_upload_9hzpufvs/main.py'

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

这个 bug 的根因在 unzip_file 方法中 [1]，它假设 zip 文件的第一个条目一定是一个目录：

update_dir = z.namelist()[0]  # 假设第一个条目是目录
z.extractall(target_dir)
files = os.listdir(os.path.join(target_dir, update_dir))  # 对文件调用 listdir 就会报错

当你打包 zip 时，文件直接在根层级（如 main.py）而没有被一个顶层目录包裹，z.namelist()[0] 返回的是文件路径而非目录，导致 os.listdir() 触发 NotADirectoryError。

修复方向：需要在解压前检测 zip 内的文件是否共享一个公共根目录，如果没有则跳过扁平化步骤，直接解压到目标目录。示例逻辑：

namelist = z.namelist()
root_dirs = set(name.split('/')[0] for name in namelist if name)

if len(root_dirs) == 1 and all('/' in name or name.endswith('/') for name in namelist):
    # 有顶层目录包裹，走原有逻辑
    update_dir = list(root_dirs)[0]
    # ...
else:
    # 文件在根层级，直接解压
    z.extractall(target_dir)

临时解决方法：打包 zip 时，把所有插件文件放进一个同名子目录里再压缩（例如 astrbot_plugin_xxx/main.py），就可以避免这个问题。

看到你愿意提交 PR，上面的思路可以作为参考 👍

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[zouyonghe]

尝试直接clone插件到插件目录呢？

[p1930n]

我提交了一个 PR 尝试修复这个问题 #8018

这个问题的根因是网页上传插件时，如果 zip 根目录直接包含 main.py，旧逻辑会把 zip 第一个条目当成目录处理，导致 NotADirectoryError

PR 里现在会区分 flat zip 和 single-root zip：

• flat zip：直接保留根部文件；
• single-root zip：保持原来的 flatten 行为；
• 同时补了 unsafe path、空 zip、多根目录等边界测试。

本地验证：
pytest tests/test_updator_socks.py -q：19 passed
ruff format --check / ruff check：通过