@sophiacyl/dsh-plugin-waves 0.0.0-stage → 0.1.0-beta.1

package/service/rover/hooks.py

@@ -0,0 +1,420 @@
+"""对插件行为的运行时改造。
+
+插件目录保持上游原样以便随时更新, 本地需要的差异全部在这里施加:
+渲染改为直接产出 HTML、卡片内角色可点击、裁掉本地用不到的命令。
+"""
+
+import importlib
+from typing import Dict, List, Set, Tuple
+
+from rover.logger import logger
+
+# (SV 名, 触发词) —— 群聊/多用户场景才有意义的命令, 本地不注册
+DROP_TRIGGERS: List[Tuple[str, str]] = [
+    ("鸣潮删除群成员", "^删除群成员"),
+    ("鸣潮删除群成员", "^(删除|清除|清理)不活跃"),
+    ("waves面板图权限提示和审核", "*"),
+    ("ww角色排行", "*"),
+    ("ww声骸排行", "*"),
+    ("ww练度排行", "*"),
+    ("waves无尽排行", "*"),
+    ("waves矩阵排行", "*"),
+    ("waves抽卡排行", "*"),
+    ("订阅鸣潮公告", "*"),
+    ("RoverSign-全部签到", "^(订阅|取消订阅)签到结果$"),
+    # 本机就是主人自己, 这条只是往订阅表里写一行
+    ("联系主人", "*"),
+]
+
+# 帮助里的扩展模块条目按实际装了哪些插件给, 否则会列出根本没装的功能
+HELP_EXTRA_MODULES = {
+    "roversign": ("RoverSign",),
+    "scoreecho": ("ScoreEcho",),
+    "roverreminder": ("RoverReminder",),
+    "todayecho": ("WavesTodayEcho", "TodayEcho"),
+}
+
+# 各卡片模板里的用户头像字段
+AVATAR_CONTEXT_KEY = "avatar_url"
+
+# 帮助条目里含这些词的均属已裁功能, 渲染时一并剔除
+DROP_HELP_MARKERS = (
+    "群成员", "不活跃", "群排行", "群排名", "抽卡排行", "练度排行", "群持有率",
+    "订阅公告", "退订公告", "订阅签到结果", "联系主人",
+)
+
+# 命令里的这些关键词只在群里有意义, 从触发词元组中摘掉
+DROP_KEYWORDS: Set[str] = {
+    "群角色持有率",
+    "群角色持有率列表",
+    "群持有率",
+    "群练度排行",
+    "练度群排行",
+    "练度群排行榜",
+    "群练度排名",
+    "练度群排名",
+}
+
+
+def _iter_triggers():
+    from rover.sv import SL
+
+    for sv in SL.lst.values():
+        for ttype, table in list(sv.TL.items()):
+            for key, trigger in list(table.items()):
+                yield sv, ttype, key, trigger
+
+
+def _drop_buttons() -> int:
+    """快捷按钮里指向已裁命令的条目一并去掉, 免得点了没反应。"""
+    from rover.segment import MessageSegment
+
+    original = MessageSegment.buttons
+
+    @staticmethod
+    def buttons(items=None):
+        if items:
+            kept = []
+            for row in items:
+                if isinstance(row, list):
+                    row = [b for b in row if getattr(b, "data", "") not in DROP_KEYWORDS]
+                    if row:
+                        kept.append(row)
+                elif getattr(row, "data", "") not in DROP_KEYWORDS:
+                    kept.append(row)
+            items = kept
+        return original(items)
+
+    MessageSegment.buttons = buttons
+    return 0
+
+
+def align_help_modules(installed=None) -> None:
+    """帮助里的扩展模块条目跟着已装插件走, 没装的模块不列。
+
+    帮助表是在插件 import 时一次性建好的, 所以这一步必须赶在载入插件之前。
+    """
+    from rover.utils.plugins_config.gs_config import all_config_list
+
+    if installed is None:
+        from rover.sv import SL
+
+        installed = set(SL.plugins)
+    config = all_config_list.get("XutheringWavesUID")
+    if config is None:
+        return
+    item = config.get_config("HelpExtraModules")
+    if item is None:
+        return
+    want = sorted(
+        key for key, names in HELP_EXTRA_MODULES.items()
+        if any(name in installed for name in names)
+    )
+    if list(getattr(item, "data", []) or []) != want:
+        config.set_config("HelpExtraModules", want)
+        logger.info(f"[改造] 帮助扩展模块按已装插件对齐: {want}")
+
+
+def drop_commands() -> int:
+    """按黑名单摘掉触发器。上游改名导致某条失配时告警, 不静默。"""
+    from rover.sv import SL
+
+    dropped = 0
+    matched_rules: Set[Tuple[str, str]] = set()
+
+    for sv_name, keyword in DROP_TRIGGERS:
+        sv = SL.lst.get(sv_name)
+        if sv is None:
+            continue
+        for ttype, table in list(sv.TL.items()):
+            for key, trigger in list(table.items()):
+                if keyword == "*" or trigger.keyword.startswith(keyword):
+                    del table[key]
+                    dropped += 1
+                    matched_rules.add((sv_name, keyword))
+            if not table:
+                sv.TL.pop(ttype, None)
+
+    for sv, ttype, key, trigger in _iter_triggers():
+        if trigger.keyword in DROP_KEYWORDS:
+            sv.TL[ttype].pop(key, None)
+            dropped += 1
+
+    stale = [f"{n}:{k}" for n, k in DROP_TRIGGERS if (n, k) not in matched_rules]
+    if stale:
+        logger.warning(f"[改造] 命令黑名单有 {len(stale)} 条未命中(上游可能已改名): {stale}")
+    _drop_buttons()
+    logger.info(f"[改造] 已裁掉 {dropped} 个触发器")
+    return dropped
+
+
+def _patch_render(module) -> None:
+    """把截图渲染换成直接产出 HTML, 并给卡片里的角色挂上点击命令。"""
+    from rover.html_actions import annotate_html
+    from rover.media import HtmlBytes
+
+    def apply_avatar(context: dict) -> None:
+        """深塔/海墟/矩阵/全息/资源/体力等模板的头像字段统一叫 avatar_url。"""
+        from rover.avatar import get_avatar_url
+
+        if AVATAR_CONTEXT_KEY not in context:
+            return
+        url = get_avatar_url()
+        if url:
+            context[AVATAR_CONTEXT_KEY] = url
+
+    def font_css_url() -> str:
+        """字体由本服务自己挂载, 不依赖外部部署。"""
+        from rover.config import core_config
+
+        if getattr(module, "_FONTS_DIR", None) is not None and module._FONTS_DIR.exists():
+            host = core_config.get_config("HOST") or "127.0.0.1"
+            if host in ("0.0.0.0", ""):
+                host = "127.0.0.1"
+            return f"http://{host}:{core_config.get_config('PORT')}/waves/fonts/fonts.css"
+        return module._get_font_css_url()
+
+    async def render_html(waves_templates, template_name: str, context: dict):
+        try:
+            template = waves_templates.get_template(template_name)
+            context["font_css_url"] = font_css_url()
+            try:
+                apply_avatar(context)
+            except Exception as e:
+                logger.warning(f"[渲染] 头像覆盖失败: {e}")
+            html = template.render(**context)
+        except Exception as e:
+            logger.error(f"[渲染] 模板失败 {template_name}: {e}")
+            return None
+        html = annotate_html(html, template_name, context)
+        logger.info(f"[渲染] {template_name} {len(html) / 1024 / 1024:.2f}MB")
+        return HtmlBytes(html, template_name)
+
+    module.render_html = render_html
+    module.PLAYWRIGHT_AVAILABLE = True
+
+
+def _patch_stamina(module) -> None:
+    """体力卡多账号时拼接 HTML, 不再走 PIL 画布。"""
+    from rover.html_actions import merge_html_cards
+    from rover.media import HtmlBytes
+
+    original = module._assemble_stamina_canvas
+
+    def assemble(stamina_imgs: list, canvas_w: int, row_h: int):
+        html_parts = [i for i in stamina_imgs if isinstance(i, HtmlBytes)]
+        if html_parts and len(html_parts) == len(stamina_imgs):
+            return merge_html_cards(html_parts)
+        return original(stamina_imgs, canvas_w, row_h)
+
+    module._assemble_stamina_canvas = assemble
+
+    original_convert = module.convert_img
+
+    async def convert_img(img, *args, **kwargs):
+        if isinstance(img, HtmlBytes):
+            return img
+        return await original_convert(img, *args, **kwargs)
+
+    module.convert_img = convert_img
+
+    # 上游把渲染结果交给 Image.open 包装, HTML 要在这一步放行
+    image_module = module.Image
+
+    class _ImageProxy:
+        def __getattr__(self, name):
+            return getattr(image_module, name)
+
+        @staticmethod
+        def open(fp, *args, **kwargs):
+            # BytesIO 会拷贝字节丢掉类型, 只能按内容判断
+            raw = fp.getvalue() if hasattr(fp, "getvalue") else b""
+            if raw[:400].lstrip()[:15].lower().startswith((b"<!doctype", b"<html")):
+                return HtmlBytes(raw.decode("utf-8", "replace"), "stamina_card.html")
+            return image_module.open(fp, *args, **kwargs)
+
+    module.Image = _ImageProxy()
+
+
+# 签到侧与查询侧同名的配置, 统一读查询侧的值
+RS_SHARED_KEYS = {"LocalProxyUrl", "KuroUrlProxyUrl", "NeedProxyFunc", "HideUid"}
+
+
+def _patch_rs_shared(module) -> None:
+    config = module.RoverSignConfig
+    original = config.get_config
+
+    def get_config(key: str, *args, **kwargs):
+        item = original(key, *args, **kwargs)
+        if key not in RS_SHARED_KEYS:
+            return item
+        from rover.utils.plugins_config.gs_config import all_config_list
+
+        waves = all_config_list.get("XutheringWavesUID")
+        if waves is None:
+            return item
+        shared = waves.get_config(key)
+        if shared is not None:
+            item.data = shared.data
+        return item
+
+    config.get_config = get_config
+
+
+# 插件名 → {模块后缀: 补丁}
+def _patch_skip_ai(module) -> None:
+    """本地由 dsh 自己的模型对话, 插件侧的知识库注册跳过。"""
+    import sys
+    from types import ModuleType
+
+    name = f"{module.__name__.rsplit('.', 3)[0]}.wutheringwaves_ai_rag"
+    if name in sys.modules:
+        return
+    stub = ModuleType(name)
+
+    async def reload_ai_rag(*args, **kwargs):
+        return None
+
+    stub.reload_ai_rag = reload_ai_rag
+    sys.modules[name] = stub
+
+
+def _patch_score_token(module) -> None:
+    """评分与排行是同一套 token, 让评分侧直接读排行的配置项。"""
+    config = module.seconfig
+    original = config.get_config
+
+    def get_config(key: str, *args, **kwargs):
+        item = original(key, *args, **kwargs)
+        if key != "xwtoken":
+            return item
+        from rover.utils.plugins_config.gs_config import all_config_list
+
+        waves = all_config_list.get("XutheringWavesUID")
+        if waves is None:
+            return item
+        shared = waves.get_config("WavesToken")
+        if shared is not None and shared.data:
+            item.data = shared.data
+        return item
+
+    config.get_config = get_config
+
+
+def _patch_help_period(module) -> None:
+    """帮助的深塔查询分组补一条挑战周期说明。"""
+    group = module.plugin_help.get("深塔查询")
+    data = group.get("data") if isinstance(group, dict) else None
+    if not isinstance(data, list) or any(i.get("name") == "挑战周期" for i in data):
+        return
+    data.append({
+        "name": "挑战周期",
+        "desc": "深塔/冥海每 28 天一期、矩阵约 42 天一期(实际以游戏内为准)，当天 04:00 换期。"
+                "换期后接口只保留新一期数据：查询时挑战记录缺失或变空说明挑战已更新，打完新一期再查。",
+        "eg": "深塔",
+        "need_ck": False,
+        "need_sk": False,
+        "need_admin": False,
+    })
+
+
+_PATCHES = {
+    "XutheringWavesUID": {
+        "utils.render_utils": _patch_render,
+        "utils.resource.download_all_resource": _patch_skip_ai,
+        "wutheringwaves_stamina.draw_waves_stamina": _patch_stamina,
+        "wutheringwaves_help.get_help": _patch_help_period,
+    },
+    "RoverSign": {
+        "roversign_config.roversign_config": _patch_rs_shared,
+    },
+    "ScoreEcho": {
+        "scoreecho_config.config": _patch_score_token,
+    },
+}
+
+
+_cards_patches = None
+
+
+def _all_patches(plugin_name: str) -> Dict[str, object]:
+    """内置补丁 + rover/cards 下自动发现的模板补丁。"""
+    global _cards_patches
+    if _cards_patches is None:
+        from rover import cards
+
+        _cards_patches = cards.discover()
+    table = dict(_PATCHES.get(plugin_name, {}))
+    table.update(_cards_patches.get(plugin_name, {}))
+    return table
+
+
+def patch_modules(plugin_name: str, package: str) -> None:
+    """在插件功能模块被 import 之前打补丁, 让它们按值绑定到新实现。"""
+    for suffix, patch in _all_patches(plugin_name).items():
+        name = f"{package}.{suffix}"
+        try:
+            module = importlib.import_module(name)
+        except Exception as e:
+            logger.warning(f"[改造] 跳过 {name}: {e}")
+            continue
+        try:
+            patch(module)
+            logger.debug(f"[改造] 已改造 {name}")
+        except Exception as e:
+            logger.error(f"[改造] {name} 失败: {e}")
+
+
+def align_local_urls() -> None:
+    """配置里指向别处部署的地址改成本服务自己的。"""
+    from rover.config import core_config
+    from rover.utils.plugins_config.gs_config import all_config_list
+
+    waves = all_config_list.get("XutheringWavesUID")
+    if waves is None:
+        return
+    host = core_config.get_config("HOST") or "127.0.0.1"
+    if host in ("0.0.0.0", ""):
+        host = "127.0.0.1"
+    local = f"http://{host}:{core_config.get_config('PORT')}/waves/fonts/fonts.css"
+    item = waves.get_config("FontCssUrl")
+    if item is not None and item.data != local:
+        waves.set_config("FontCssUrl", local)
+        logger.info(f"[改造] 字体地址改为本服务 {local}")
+
+
+def seed_defaults(configs: Dict[str, Dict[str, object]]) -> None:
+    """初值只写一次。写过就记在案, 之后用户在设置页改成什么就是什么。"""
+    from rover.config import core_config
+    from rover.utils.plugins_config.gs_config import all_config_list
+
+    seeded = list(core_config.get_config("seeded") or [])
+    for config_name, values in configs.items():
+        if config_name in seeded:
+            continue
+        config = all_config_list.get(config_name)
+        if config is None:
+            continue
+        for key, value in values.items():
+            item = config.get_config(key)
+            if item is not None and item.data != value:
+                config.set_config(key, value)
+        seeded.append(config_name)
+        logger.info(f"[改造] {config_name} 首次装载, 已写入初值")
+    if seeded != (core_config.get_config("seeded") or []):
+        core_config.set_config("seeded", seeded)
+
+
+def apply_defaults(configs: Dict[str, Dict[str, object]]) -> None:
+    """运行时前提项, 每次启动都校正; 这些键不进设置页, 不会和用户的选择打架。"""
+    from rover.utils.plugins_config.gs_config import all_config_list
+
+    for config_name, values in configs.items():
+        config = all_config_list.get(config_name)
+        if config is None:
+            logger.warning(f"[改造] 未找到配置 {config_name}")
+            continue
+        for key, value in values.items():
+            item = config.get_config(key)
+            if item is not None and item.data != value:
+                config.set_config(key, value)

package/service/rover/html_actions.py

@@ -0,0 +1,236 @@
+"""给渲染好的 HTML 挂上点击动作: 点角色出面板。按渲染上下文的顺序与文档顺序一一对应。"""
+
+import re
+from typing import Any, Callable, Dict, Iterable, List, Optional
+
+from rover.logger import logger
+
+
+
+# 角色格子的开标签, 与各模板中的写法一致
+_ROLE_TAG = re.compile(r'<div class="role-mini(?![-\w])(?P<rest>[^>]*)>')
+# 模板用别的格子类名时在这里挂对应模式
+_ROLE_TAGS: dict = {
+    "roleinfo/role_card.html": re.compile(r'<div class="role-card(?![-\w])(?P<rest>[^>]*)>'),
+}
+_BODY_END = re.compile(r"</body\s*>", re.I)
+
+_BRIDGE = """
+<style>
+[data-ww-cmd]{cursor:pointer;position:relative}
+[data-ww-cmd]:hover{outline:2px solid rgba(255,214,102,.95);outline-offset:2px}
+html,body{margin:0;padding:0;overflow:hidden;background:transparent}
+html{width:100%}
+</style>
+<script>
+(function(){
+  var availW = 0;
+  var settled = false;
+  // 设计宽度只量一次: 模板多是 body 定宽 + 内层 width:100%, 一旦把 body 改窄,
+  // 内层跟着缩, 里面的定宽行就溢出被裁。量完就把 body 钉死在设计宽度上。
+  var designW = 0;
+  function root(){ return document.querySelector('.container') || document.body }
+  function post(msg){ try{ parent.postMessage(Object.assign({source:'ww-card'},msg),'*') }catch(e){} }
+  // scrollWidth/scrollHeight 是布局值, 不受 transform 影响
+  function apply(){
+    var el = root();
+    if(!designW){
+      designW = Math.max(el.scrollWidth, document.body.scrollWidth, 1);
+      document.body.style.width = designW + 'px';
+    }
+    var h = Math.max(el.scrollHeight, document.body.scrollHeight, 1);
+    var scale = availW ? Math.min(1, availW / designW) : 1;
+    // 缩放整个 body: 卡片外层的背景层之类不在 .container 里的元素也一起等比缩
+    document.body.style.transformOrigin = 'top left';
+    document.body.style.transform = scale < 1 ? 'scale(' + scale + ')' : '';
+    var w = Math.ceil(designW * scale), sh = Math.ceil(h * scale);
+    document.documentElement.style.width = w + 'px';
+    document.documentElement.style.height = sh + 'px';
+    if(settled) post({kind:'size', width: w, height: sh});
+  }
+  window.addEventListener('message', function(e){
+    var d = e.data;
+    if(d && d.source === 'ww-host' && d.kind === 'width'){ availW = d.width || 0; apply(); }
+  });
+  document.addEventListener('click', function(e){
+    var t = e.target && e.target.closest ? e.target.closest('[data-ww-cmd]') : null;
+    if(!t) return;
+    e.preventDefault();
+    post({kind:'command', command:t.getAttribute('data-ww-cmd')});
+  });
+  // 字体和图片没落定就报尺寸, 宿主会先按半成品高度撑开再跳一次;
+  // 所以量归量, 落定之后才往外报, 卡片一次到位。
+  function settle(){ settled = true; apply(); }
+  function whenLoaded(fn){
+    if(document.readyState === 'complete') fn();
+    else window.addEventListener('load', fn);
+  }
+  function ready(){ post({kind:'ready'}); apply(); }
+  document.addEventListener('DOMContentLoaded', ready);
+  whenLoaded(function(){
+    var fonts = document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+    fonts.then(settle, settle);
+  });
+  if(window.ResizeObserver){ new ResizeObserver(apply).observe(root()); }
+  setTimeout(ready, 300);
+  // 字体加载卡住也不能一直不出, 到点就认
+  setTimeout(settle, 2500);
+})();
+</script>
+"""
+
+
+def _walk(node: Any, path: Iterable[str]) -> List[dict]:
+    """按 key 路径逐层展开嵌套列表, 结果保持模板遍历顺序。"""
+    keys = list(path)
+    current: List[Any] = [node]
+    for key in keys:
+        nxt: List[Any] = []
+        for item in current:
+            if isinstance(item, dict):
+                value = item.get(key)
+                if isinstance(value, list):
+                    nxt.extend(value)
+        current = nxt
+    return [i for i in current if isinstance(i, dict)]
+
+
+def _roles_from(context: dict, *paths: Iterable[str]) -> List[dict]:
+    out: List[dict] = []
+    for path in paths:
+        out.extend(_walk(context, path))
+    return out
+
+
+# 矩阵模板的上下文里只有图标没有角色 id, 由 cards/matrix_roles 在构图时记下来补上
+_RECORDED_ROLE_IDS: List[str] = []
+
+
+def record_role_id(role_id: Any) -> None:
+    _RECORDED_ROLE_IDS.append(str(role_id))
+
+
+def _matrix_roles(context: dict) -> List[dict]:
+    roles = _roles_from(context, ("modes", "teams", "roles"))
+    recorded = list(_RECORDED_ROLE_IDS)
+    _RECORDED_ROLE_IDS.clear()
+    real = [r for r in roles if not r.get("is_placeholder")]
+    # 条数对不上说明记录与实际渲染错位了, 宁可不挂也不能挂错人
+    if len(recorded) == len(real):
+        for role, role_id in zip(real, recorded):
+            role.setdefault("id", role_id)
+    elif recorded:
+        logger.debug(f"[鸣潮·交互] 矩阵角色 id 记录 {len(recorded)} 个, 实到 {len(real)} 个, 跳过")
+    return roles
+
+
+_EXTRACTORS: Dict[str, Callable[[dict], List[dict]]] = {
+    "abyss/abyss_card.html": lambda c: _roles_from(c, ("towers", "floors", "roles")),
+    "abyss/slash_card.html": lambda c: _roles_from(c, ("challenges", "half_list", "roles")),
+    "abyss/challenge_card.html": lambda c: _roles_from(c, ("challenges", "roles")),
+    "abyss/matrix_detail_card.html": _matrix_roles,
+    "roleinfo/role_card.html": lambda c: [r for r in c.get("role_list") or [] if isinstance(r, dict)],
+}
+
+
+def _char_name(role_id: str) -> Optional[str]:
+    """角色名转换在插件侧, 延迟取用避免本模块依赖插件。"""
+    import importlib
+    import sys
+
+    suffix = "XutheringWavesUID.utils.name_convert"
+    for name, module in list(sys.modules.items()):
+        if name.endswith(suffix) and module is not None:
+            return module.char_id_to_char_name(str(role_id))
+    for package in ("plugins.XutheringWavesUID.XutheringWavesUID", "waves"):
+        try:
+            convert = importlib.import_module(f"{package}.utils.name_convert")
+        except ModuleNotFoundError:
+            continue
+        return convert.char_id_to_char_name(str(role_id))
+    return None
+
+
+def _prefix() -> str:
+    from rover.sv import all_prefixes
+
+    items = all_prefixes()
+    return items[0] if items else ""
+
+
+def _role_name(role: dict) -> Optional[str]:
+    role_id = role.get("id") or role.get("role_id") or role.get("roleId")
+    name = role.get("name") or role.get("role_name")
+    if not name and role_id:
+        name = _char_name(role_id)
+    return name or None
+
+
+def _role_command(role: dict) -> Optional[str]:
+    name = _role_name(role)
+    return f"{_prefix()}{name}面板" if name else None
+
+
+_CONTAINER = re.compile(
+    r'<div[^>]*class="[^"]*\bcontainer\b[^"]*"[^>]*>.*</div>', re.S | re.I
+)
+
+
+def merge_html_cards(parts: List[Any]) -> Any:
+    """多张同模板卡片竖排成一页。"""
+    from rover.media import HtmlBytes
+
+    if not parts:
+        return None
+    if len(parts) == 1:
+        return parts[0]
+    base = parts[0].html
+    extra: List[str] = []
+    for part in parts[1:]:
+        found = _CONTAINER.search(part.html)
+        if found:
+            extra.append(found.group(0))
+    if not extra:
+        return parts[0]
+    block = "\n".join(extra)
+    if "</body" in base:
+        merged = base.replace("</body", block + "\n</body", 1)
+    else:
+        merged = base + block
+    return HtmlBytes(merged, getattr(parts[0], "template_name", ""))
+
+
+def annotate_html(html: str, template_name: str, context: dict) -> str:
+    """在角色格子上写入命令, 并注入点击/尺寸桥接脚本。"""
+    try:
+        extractor = _EXTRACTORS.get(template_name)
+        if extractor:
+            roles = extractor(context)
+            names = [_role_name(r) for r in roles]
+            commands = [_role_command(r) for r in roles]
+            if commands:
+                counter = {"i": 0}
+
+                def repl(match: re.Match) -> str:
+                    idx = counter["i"]
+                    counter["i"] += 1
+                    command = commands[idx] if idx < len(commands) else None
+                    tag = match.group(0)
+                    if not command:
+                        return tag
+                    # 角色在卡面上只有头像, 名字另存一份: 给模型的文字摘要要认得出是谁
+                    name = names[idx] if idx < len(names) else ""
+                    extra = f' data-ww-name="{name}"' if name else ""
+                    return f'{tag[:-1]} data-ww-cmd="{command}"{extra}>'
+
+                html = _ROLE_TAGS.get(template_name, _ROLE_TAG).sub(repl, html)
+                if counter["i"] != len(commands):
+                    logger.debug(
+                        f"[鸣潮·交互] {template_name} 角色格 {counter['i']} 个, 上下文 {len(commands)} 个"
+                    )
+        if _BODY_END.search(html):
+            return _BODY_END.sub(_BRIDGE + "</body>", html, count=1)
+        return html + _BRIDGE
+    except Exception as e:
+        logger.warning(f"[鸣潮·交互] 注入失败 {template_name}: {e}")
+        return html

package/service/rover/i18n.py

@@ -0,0 +1,19 @@
+"""文案取用。本项目不做多语言 UI, 词条表为空, t() 直接回落 key 本身。"""
+
+from typing import Optional
+
+DEFAULT_LANG: str = "zh-cn"
+
+
+def t(key: str, /, lang: Optional[str] = None, **params: object) -> str:
+    """按 key 取词条; 无词条时回落 key 本身并填充具名占位符。"""
+    if not params:
+        return key
+    try:
+        return key.format(**params)
+    except (KeyError, IndexError, ValueError):
+        return key
+
+
+def get_lang() -> str:
+    return DEFAULT_LANG