76147bae94
一切皆为插件的开发者工具运行时框架
🧩 核心特性:
- 插件热插拔 (importlib 动态加载)
- 依赖自动解析 (拓扑排序 + 循环检测)
- 企业级稳定 (熔断/降级/重试/隔离)
- 事件驱动 (发布/订阅事件总线)
- 完整配置 (YAML 配置 + 热重载)
100 lines
4.0 KiB
Python
100 lines
4.0 KiB
Python
"""HTML 渲染服务 - 通过 config.json 配置，统一文件入口"""
|
||
import json
|
||
from pathlib import Path
|
||
from oss.plugin.types import Plugin, register_plugin_type, Response
|
||
|
||
|
||
class HtmlRenderPlugin(Plugin):
|
||
"""HTML 渲染插件 - 渲染服务由 html-render 提供"""
|
||
|
||
def __init__(self):
|
||
self.http_api = None
|
||
self.storage = None # plugin-storage 入口
|
||
self.config = {}
|
||
self.root_dir = None # 解析后的网站根目录
|
||
|
||
def init(self, deps: dict = None):
|
||
"""初始化 - 读取 config.json 并解析网站根目录"""
|
||
self._load_config()
|
||
print(f"[html-render] 配置加载完成: root_dir={self.root_dir}")
|
||
|
||
def start(self):
|
||
"""启动 - 注册路由到 http-api，共享配置给 web-toolkit"""
|
||
# 注册首页路由
|
||
if self.http_api and hasattr(self.http_api, 'router'):
|
||
self.http_api.router.get("/", self._serve_html)
|
||
print("[html-render] 已注册路由到 http-api")
|
||
else:
|
||
print("[html-render] http-api 未加载")
|
||
|
||
# 将配置共享给 web-toolkit（通过 plugin-storage 的 DCIM 共享存储）
|
||
if self.storage:
|
||
shared = self.storage.get_shared()
|
||
shared.set_shared("html-render-config", {
|
||
"root_dir": str(self.root_dir),
|
||
"index_file": self.config.get("index_file", "index.html"),
|
||
"static_prefix": self.config.get("static_prefix", "/static"),
|
||
})
|
||
print("[html-render] 配置已共享到 DCIM")
|
||
|
||
def stop(self):
|
||
"""停止"""
|
||
pass
|
||
|
||
def set_http_api(self, instance):
|
||
"""设置 http-api 实例"""
|
||
self.http_api = instance
|
||
|
||
def set_plugin_storage(self, instance):
|
||
"""设置 plugin-storage 实例（唯一文件读写入口）"""
|
||
self.storage = instance
|
||
|
||
def _load_config(self):
|
||
"""读取 config.json，解析根目录"""
|
||
config_path = Path("./data/html-render/config.json")
|
||
if not config_path.exists():
|
||
print("[html-render] 警告: config.json 不存在，使用默认配置")
|
||
self.config = {"root_dir": "../website", "index_file": "index.html"}
|
||
else:
|
||
with open(config_path, "r", encoding="utf-8") as f:
|
||
self.config = json.load(f)
|
||
|
||
# 解析根目录（相对于 config.json 的路径）
|
||
root_relative = self.config.get("root_dir", "../website")
|
||
self.root_dir = (config_path.parent / root_relative).resolve()
|
||
|
||
def _serve_html(self, request):
|
||
"""提供 HTML 页面 - 通过 plugin-storage 读取并注入静态资源路径"""
|
||
index_file = self.config.get("index_file", "index.html")
|
||
if self.storage:
|
||
storage = self.storage.get_storage("html-render")
|
||
if storage.file_exists(index_file):
|
||
content = storage.read_file(index_file)
|
||
if content:
|
||
# 注入静态资源路径（相对路径 → /website/ 前缀）
|
||
content = self._inject_static_paths(content)
|
||
return Response(
|
||
status=200,
|
||
headers={"Content-Type": "text/html; charset=utf-8"},
|
||
body=content
|
||
)
|
||
return Response(status=404, body="Not Found")
|
||
|
||
def _inject_static_paths(self, html: str) -> str:
|
||
"""将相对静态资源路径替换为 /website/ 前缀"""
|
||
import re
|
||
# href="css/xxx" → href="/website/css/xxx"
|
||
html = re.sub(r'(href\s*=\s*["\'])css/', r'\1/website/css/', html)
|
||
# src="js/xxx" → src="/website/js/xxx"
|
||
html = re.sub(r'(src\s*=\s*["\'])js/', r'\1/website/js/', html)
|
||
# src="logo.svg" → src="/website/logo.svg"
|
||
html = re.sub(r'(src\s*=\s*["\'])(?!https?://|/)([\w.-]+\.(svg|png|jpg|gif|ico|webp))', r'\1/website/\2', html)
|
||
return html
|
||
|
||
|
||
register_plugin_type("HtmlRenderPlugin", HtmlRenderPlugin)
|
||
|
||
|
||
def New():
|
||
return HtmlRenderPlugin()
|