October CMS插件和主题必须安装到plugins/或themes/目录下，而非vendor/，因系统仅扫描这些路径下的Plugin.php或Theme.php文件；正确方式是用php artisan plugin:install VendorName.PluginName安装插件，主题需手动解压至themes/并配置activeTheme。
直接用 composer require 安装插件或主题，绝大多数情况下会失败——October CMS 不走标准 Composer 自动加载路径，也不依赖 autoload 注册类，而是靠系统扫描 plugins/ 和 themes/ 目录下的注册文件（如 Plugin.php 或 Theme.php）来识别扩展。硬塞进 vendor/ 里，它根本看不见。
为什么 composer require rainlab/blog 不生效
October CMS 的插件和主题不是 Composer 包的“运行时依赖”，而是“运行时可发现资源”。Composer 把包下到 vendor/ 后，October 的核心（System\Classes\PluginManager）不会去那里找 Plugin.php；它只扫描 plugins/rainlab/blog/Plugin.php 这种固定路径。
-
composer require下载的是 PSR-4 自动加载包，但 October 插件的启动逻辑在Plugin.php::pluginInit()，必须被主动加载才能注册路由、事件、组件等 - 即使你手动把
vendor/rainlab/blog复制到plugins/rainlab/blog，也大概率报错——因为composer.json中声明的 autoload、scripts、extra 字段（比如"october": {"type": "plugin"}）在 vendor 里不触发 - 某些插件（如
rainlab/user）还依赖特定版本的october/system，直接require可能引发 Laravel facade 冲突或服务提供者重复注册
正确安装插件：用 php artisan plugin:install
October 提供了原生命令行工具，这才是官方支持、路径安全、版本兼容的安装方式。前提是你的 October 已正确初始化（storage/ 可写、数据库连接正常、artisan 可执行）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保你在项目根目录（即包含
artisan文件的位置），而不是plugins/或themes/子目录里执行命令 - 运行
php artisan plugin:install RainLab.Blog—— 注意命名格式是VendorName.PluginName，全部大驼峰，中间用点分隔，不是小写或下划线 - 命令会自动：下载 ZIP 包 → 解压到
plugins/rainlab/blog/→ 运行Plugin::boot()→ 执行迁移（如有）→ 刷新插件缓存 - 如果提示
Class 'RainLab\Blog\Plugin' not found，先确认是否已启用插件：后台「Settings → Plugins」里勾选启用，或运行php artisan plugin:enable RainLab.Blog
安装主题：不能用 artisan，得手动或用 oc:theme:install
October 没有内置 theme:install 命令（直到 3.3 版仍无），所以主题安装比插件更原始，但逻辑一致：必须放在 themes/ 下且结构合规。
- 推荐方式：下载主题 ZIP（如
demo-theme.zip），解压后整个文件夹（如demo-theme）放进themes/，确保里面有Theme.php和layouts/default.htm等必要文件 - 命令行辅助：可写个简单脚本，用
wget+unzip自动化，例如：cd themes && wget https://github.com/octobercms/theme-demo/archive/refs/heads/master.zip && unzip master.zip && mv theme-demo-master demo
- 激活主题必须改配置：编辑
config/cms.php，把'activeTheme' => 'demo'；或者后台「Settings → Front-end Theme」里选中并保存——改完要清缓存：php artisan cache:clear && php artisan view:clear - 注意权限：Web 服务器用户（如
www-data）必须对themes/demo/有读取权，否则 Twig 加载模板时会file_get_contents(): failed to open stream
绕过 Marketplace 的私有插件怎么装
如果你有自己开发的插件 ZIP 或 Git 仓库地址，又不想上传到 October Marketplace，可以跳过 plugin:install，但绝不能丢进 vendor/。
- 方法一（推荐）：把插件源码整个放到
plugins/yourname/yourplugin/，确保Plugin.php存在且命名空间为YourName\YourPlugin\Plugin，然后运行php artisan plugin:refresh YourName.YourPlugin - 方法二：用 Composer 的
pathrepository，把本地插件目录映射为包源，在composer.json中加："repositories": [{"type": "path", "url": "./plugins/yourname/yourplugin"}],<br>"require": {"yourname/yourplugin": "*"}<br>再composer install——但这只是让 Composer “知道”这个包，仍需手动复制到plugins/并运行plugin:refresh - 关键点：无论怎么拉代码，最终生效的只有
plugins/xxx/yyy/Plugin.php这个路径。所有逻辑（组件注册、API 路由、后台菜单）都从这里启动，没这文件，其他都白搭
最常被忽略的是：插件安装后不启用、主题放错目录层级、Plugin.php 里的命名空间和实际路径不匹配——这三个问题占了 80% 的“装了但没反应”案例。别急着查日志，先 ls plugins/rainlab/blog/Plugin.php 和 cat config/cms.php | grep activeTheme 看两眼。
