源码插件购买与安装
源码插件在门户中选购和下载,再集成到你的 Forge 工程。门户与文档站共用账号, 插件下载按具体商品的权益核验,文档会员不会自动获得插件源码。
若你要开发并上架源码插件,请遵循与后台上传校验一致的 源码插件开发与上架规范,不要只参考框架内 Starter / Plugin 拆模块文档。
购买和开通
- 在门户的「插件目录」选择插件,查看已发布版本和核心兼容范围。
- 使用现有文档站账号登录,或注册一个账号。注册本身不会开通任何权益。
- 打开「购买 / 申请开通」,核对商品价格、账号与商品编码,按该商品的收款说明操作。 没有配置收款码时,先联系运营人员确认方式,不要使用其它商品的二维码付款。
- 向运营人员提供账号、商品编码及付款凭证,不要提供密码。运营核款后在后台开通该商品权益。
- 刷新授权,或进入「我的插件」选择版本下载。页面不会把扫码或点击按钮视为支付成功。
权益期限以实际开通记录为准。过期、撤销、商品停用或版本撤回后不能继续下载, 但服务端不能回收已经下载的源码,也不能以下载权益替代商业许可证。
下载和安装
门户通过受保护接口下载 ZIP,核对响应 SHA-256 与文件内容后才保存。 请使用 HTTPS 门户;本地 localhost 也支持浏览器摘要校验。
在带有源码插件 CLI 的客户工程根目录执行以下命令,路径替换为实际下载文件:
pnpm forge:plugin check "/absolute/path/to/plugin.zip"
pnpm forge:plugin add "/absolute/path/to/plugin.zip"
pnpm forge:plugin list预检不能代替源码安全审查。安装前核对核心版本、插件 edition、数据库迁移、菜单权限和业务影响, 保留工程及数据库备份。安装后重新构建、部署,再验收接口、菜单及权限;不是 Java 运行时热加载。 具体构建命令使用客户工程自身文档,避免误构建其它工程。
升级和卸载
升级前提交或备份插件的定制改动,核对新版本兼容范围。整包升级可能覆盖定制代码:
pnpm forge:plugin check "/absolute/path/to/new-plugin.zip" --force
pnpm forge:plugin add "/absolute/path/to/new-plugin.zip" --force
pnpm forge:plugin list卸载使用 pnpm forge:plugin remove <插件ID>,然后重新构建、部署。 CLI 保留恢复备份,不自动删除数据库表、业务数据和迁移历史。 关联菜单、数据库回退及客户定制需要人工评估,不能简单删除已执行的 Flyway 脚本。
账号和部署
同一域名下的 /forge-official-ui/ 和 /forge-docs/ 共享登录凭证及设备 ID, 切换页面或在另一标签页退出时会同步会话。不同端口、子域或域名并非同源, 可使用同一账号分别登录,但不自动共享登录状态。需要跨域单点登录时,应另接授权码交换, 不要在跳转 URL 中传递 Token。
当前沿用文档账号的设备策略,新设备登录可能退出其它设备。购买后仍看不到插件时, 先核对登录账号和商品编码,再联系运营检查权益有效期及发布状态。
