Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Plugins from an outside folder, each with its own packages (M6)

未关闭
#326 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
35/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
python

调研方向

Read the dependency issue #325 first, then inspect src/paperpi/plugins/__init__.py, src/paperpi/runner.py, and src/paperpi/cli.py, along with the web Library and install paths. The issue divides the work into outside plugin loading, the paperpi plugin commands and per-plugin packages, and an optional template repository. Completion means the agreed plugin layout and isolation work, the CLI commands are available, and the web interface and documentation reflect outside plugins.

由索引模型根据 Issue 内容生成。

描述

Let other people build and share plugins without merging them into PaperPi's main. Replaces old #13 ("packaging plugin").

Decided

  • Outside plugins are folders in /opt/paperpi/plugins/ (root-owned, so a running plugin can't change itself or other plugins), with the same layout as the built-in ones (__init__.py with PLUGIN, README.md). The web interface shows them like built-in ones, marked as outside plugins. Updates of PaperPi don't touch them.
  • Added on the command line first: sudo paperpi plugin add <github url>, plus list, update, remove. Adding from the web interface maybe later.
  • Extra Python packages: each plugin lists them in a file in its folder; they go into its own folder /opt/paperpi/plugin-packages/<plugin>/, used only in that plugin's process. PaperPi's own packages (uv.lock) never change; on a version clash PaperPi's version wins and add warns.
  • System packages (apt): never installed by PaperPi; the plugin's README says what to install and setup="..." shows it in the web interface.

PRs
3. Outside plugin folder: loading, web Library, docs/writing-plugins.md.
4. paperpi plugin command with the per-plugin packages folder.
5. (optional) a plugin template repository to copy from.

Area: src/paperpi/plugins/__init__.py, src/paperpi/runner.py, src/paperpi/cli.py, web Library, docs, install (uninstall/paths). Comes after the install issue #325.

主要语言
Python
星标
205
派生
17
平均合并
3 小时 49 分钟
30 天内合并 PR
89

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

txoof/PaperPi 的其他 Issue

查看 txoof/PaperPi 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。