feat(context): 增加跨上下文黑名单模式

为跨上下文共享功能引入了黑名单模式,并增加了相应的配置选项。

- 在 `ContextGroup` 配置中增加了 `mode` 字段,支持 "whitelist"(白名单)和 "blacklist"(黑名单)模式。
- 增加了 `default_limit` 配置项,用于黑名单模式下的默认消息获取数量。
- 重构了 `cross_context_api` 以支持新的黑名单逻辑,现在可以共享除了黑名单中指定聊天外的所有聊天上下文。
- 更新了配置文件模板以包含新模式的说明和示例。
This commit is contained in:
minecraft1024a
2025-10-11 19:45:32 +08:00
parent 989956ed57
commit f7ed5211a3
4 changed files with 106 additions and 28 deletions

View File

@@ -630,15 +630,28 @@ class SleepSystemConfig(ValidatedConfigBase):
class ContextGroup(ValidatedConfigBase):
"""上下文共享组配置"""
"""
上下文共享组配置
name: str = Field(..., description="共享组的名称")
定义了一个聊天上下文的共享范围和规则。
"""
name: str = Field(..., description="共享组的名称,用于唯一标识一个共享组")
mode: Literal["whitelist", "blacklist"] = Field(
default="whitelist",
description="共享模式。'whitelist'表示仅共享chat_ids中列出的聊天'blacklist'表示共享除chat_ids中列出的所有聊天。",
)
default_limit: int = Field(
default=5,
description="'blacklist'模式下对于未明确指定数量的聊天默认获取的消息条数。也用于s4u_ignore_whitelist开启时获取私聊消息的数量。",
)
s4u_ignore_whitelist: bool = Field(
default=False, description="在s4u模式下, 是否无视白名单, 获取用户所有私聊消息"
default=False,
description="在s4u模式下是否无视白名单获取目标用户与Bot的所有私聊消息以构建更完整的用户画像。",
)
chat_ids: list[list[str]] = Field(
...,
description='属于该组的聊天ID列表格式为 [["type", "chat_id"], ...],例如 [["group", "123456"], ["private", "789012"]]',
description='定义组内成员的列表格式为 [["type", "id", "limit"(可选)]]。type为"group""private"id为群号或用户IDlimit为可选的消息条数。',
)