astrbot_plugin_imagestudio/adapters/astrbot_command_adapter.py

111 行
3.6 KiB
Python

"""Pure helpers for the AstrBot chat command surface."""
from __future__ import annotations
from dataclasses import dataclass
from typing import Any
from core.chat_access_policy import chat_action_allowed
@dataclass(frozen=True)
class ChatCommandContext:
user_id: str
group_id: str | None
message_origin: str
platform: str
message_id: str
def command_context_from_event(event: Any) -> ChatCommandContext:
return ChatCommandContext(
user_id=_event_value(event, "get_sender_id", "sender_id", "user_id"),
group_id=_optional_event_value(event, "get_group_id", "group_id"),
message_origin=_event_value(event, "unified_msg_origin", "message_origin"),
platform=_event_value(event, "get_platform_name", "platform_name", fallback="unknown"),
message_id=_event_value(event, "message_id", "get_message_id"),
)
def command_allowed(config: dict[str, Any], action: str, context: ChatCommandContext) -> bool:
return chat_action_allowed(
config,
action,
group_id=context.group_id,
user_id=context.user_id,
)
def message_text_from_event(event: Any) -> str:
for name in ("message_str", "get_message_str", "raw_message"):
value = getattr(event, name, None)
if callable(value):
try:
value = value()
except (TypeError, AttributeError):
continue
text = str(value or "").strip()
if text:
return text
return ""
def help_text() -> str:
return """🎨 ImageStudio 命令
/影棚 帮助 或 /yp 帮助
/影棚 状态 或 /yp 状态
/影棚 快速角色 <角色描述>
/影棚 工作流 <角色名或角色 ID>
/影棚 单图 <提示词>
/影棚 轮次 <node_id> [4|5] [提示词]
/影棚 候选 <round_id>
/影棚 反馈 <round_id> <自然语言反馈>
/影棚 下一轮 <round_id> [4|5]
/影棚 定稿 <round_id> <候选编号>
/影棚 审查 <round_id> <候选编号> [审核|跳过]
/影棚 素材 <node_id> [material_id,...]
/影棚 分支 <workflow_id>
/影棚 档案卡 <workflow_id> [人设文档]
权限规则:
• 快速角色、角色工作流:群聊和用户白名单必须同时命中
• 单图:群聊或用户任一白名单命中即可
详细工作流使用稳定候选编号;只有“定稿/审查通过”会正式采用并推进节点。"""
def access_denied_text(action: str, context: ChatCommandContext) -> str:
scope = f"群聊 {context.group_id}" if context.group_id else "私聊"
return f"⛔ 当前{scope}或用户 {context.user_id or '未知'}不满足「{action}」的白名单规则。"
def accepted_text(action: str, argument: str, context: ChatCommandContext) -> str:
value = argument.strip() or "未提供"
return (
f"✅ ImageStudio 已接收「{action}」命令框架请求\n\n"
f"输入:{value}\n"
f"平台:{context.platform}\n"
f"用户:{context.user_id or '未知'}\n"
f"群聊:{context.group_id or '私聊'}\n\n"
"当前阶段已完成命令注册、参数接收与白名单校验;业务执行器将在下一阶段接入。"
)
def _event_value(event: Any, *names: str, fallback: str = "") -> str:
for name in names:
value = getattr(event, name, None)
if callable(value):
try:
value = value()
except (TypeError, AttributeError):
continue
text = str(value or "").strip()
if text:
return text
return fallback
def _optional_event_value(event: Any, *names: str) -> str | None:
value = _event_value(event, *names)
return value or None