+
+ GitHub Repository
+{_html_text(info.full_name or info.repo_id)}
+{_status_badges(info)}
+ {_html_text(description)}
+{stats}
+ {chips}
+ {_topic_html(info)}
+
+ 视频发送
• 视频消息 • 降级信息卡片"] end + subgraph GitHubModule["GitHub 模块 (github/)"] + GitHubParser["parser.py
仓库标识解析
• URL • SSH • owner/repo • JSON"] + GitHubClient["client.py
public API 获取
• 仓库信息 • contributors"] + GitHubSender["sender.py
图片卡片发送
• 头像 • 简介 • 统计"] + end + subgraph SecurityLayer["安全防线 (services/)"] SecurityService["SecurityService
安全服务
• 注入攻击检测
• 速率限制
[security.py]"] InjectionAgent["InjectionResponseAgent
注入响应生成
[injection_response_agent.py]"] end - CommandDispatcher["CommandDispatcher
命令分发器
• /help /stats /lsadmin
• /addadmin /rmadmin
• /bugfix /lsfaq
[services/command.py]"] + CommandDispatcher["CommandDispatcher
命令分发器
• /help /stats /lsadmin
• /addadmin /rmadmin
• /bugfix /faq
[services/command.py]"] subgraph QueueSystem["车站-列车 队列系统 (services/)"] AICoordinator["AICoordinator
AI 协调器
• Prompt 构建
• 队列管理
• 回复执行
[ai_coordinator.py]"] @@ -95,7 +101,7 @@ graph TB TS_Messages["messages.*
• send_message
• get_recent_messages
• get_forward_msg"] TS_Memory["memory.*
• add / delete
• list / update"] TS_Contacts["contacts.*
• query_friends
• query_groups"] - TS_GroupAnalysis["group_analysis.*
• analyze_member_messages
• analyze_join_statistics
• analyze_new_member_activity"] + TS_GroupAnalysis["group_analysis.*
• member_structure
• message_mix
• member_activity
• activity_trend
• inactive_risk
• member_messages
• join_statistics
• new_member_activity"] TS_Notices["notices.*
• list / get / stats"] TS_Render["render.*
• render_html
• render_latex
• render_markdown"] TS_Scheduler["scheduler.*
• create_schedule_task
• delete_schedule_task
• list_schedule_tasks"] @@ -116,7 +122,7 @@ graph TB subgraph CommandsLayer["平台指令 (skills/commands/)"] Cmd_Core["核心指令
• help • stats"] Cmd_Admin["管理指令
• addadmin
• rmadmin • lsadmin"] - Cmd_FAQ["FAQ 指令
• lsfaq • viewfaq
• searchfaq • delfaq"] + Cmd_FAQ["FAQ 指令
• faq (ls/view/search/del)"] Cmd_Fun["娱乐指令
• bugfix"] end @@ -208,13 +214,16 @@ graph TB SecurityService -.->|"API 调用"| LLM_API SecurityService -->|"注入攻击"| InjectionAgent - MessageHandler -->|"1.5 Bilibili检测"| BilibiliParser + MessageHandler -->|"2. 指令?"| CommandDispatcher + CommandDispatcher -->|"执行结果经统一发送层写历史"| OneBotClient + MessageHandler -->|"2.5 非命令自动管线"| BilibiliParser BilibiliParser -->|"BV号"| BilibiliDownloader BilibiliDownloader -->|"视频文件"| BilibiliSender BilibiliSender -->|"发送"| OneBotClient - - MessageHandler -->|"2. 指令?"| CommandDispatcher - CommandDispatcher -->|"执行结果"| OneBotClient + MessageHandler -->|"2.6 非命令自动管线"| GitHubParser + GitHubParser -->|"仓库ID"| GitHubClient + GitHubClient -->|"public仓库信息"| GitHubSender + GitHubSender -->|"发送图片卡片"| OneBotClient MessageHandler -->|"3. 自动回复"| AICoordinator AICoordinator -->|"创建上下文"| RequestContext @@ -353,21 +362,22 @@ sequenceDiagram alt 检测到注入 SS->>MH: 拦截并响应 else 安全 - %% Bilibili 自动提取 - alt 消息包含B站链接/BV号 - MH->>MH: extract_bilibili_ids() - MH->>MH: download_video() - MH->>OH: 发送视频/信息卡片 - OH->>OB: WebSocket API - OB->>U: 显示视频 - else 非B站内容 - %% 指令处理 - MH->>CD: 解析斜杠命令 + %% 指令处理 + MH->>CD: 解析斜杠命令 alt 是命令 CD->>ST: FAQ/管理员操作 + CD->>ST: 写入命令输出历史 CD-->>OB: 返回结果 OB->>U: 发送响应 - else 是AI消息 + else 非命令消息 + MH->>MH: 并行检测 skills/auto_pipeline 管线 + opt 命中自动提取管线 + MH->>MH: 并行处理全部命中的自动提取 + MH->>OH: 发送视频/卡片/PDF + OH->>OB: WebSocket API + OB->>U: 显示自动提取结果 + MH->>ST: 写入自动提取结果历史和附件 UID + end %% AI处理流程 MH->>AC: handle_auto_reply() @@ -810,6 +820,7 @@ description: 从 PDF 文件中提取文本和表格，填写表单。当用户 | **认知记忆** | `cognitive.enabled`, `cognitive.query.*`, `models.embedding.*` | 事件检索、时间衰减加权、侧写与后台史官 | | **Bilibili** | `bilibili.auto_extract_enabled`, `bilibili.cookie`, `bilibili.prefer_quality` | B站视频自动提取与下载 | | **arXiv** | `arxiv.auto_extract_enabled`, `arxiv.max_file_size`, `arxiv.auto_extract_max_items` | arXiv 论文自动提取、搜索与 PDF 发送 | +| **GitHub** | `github.auto_extract_enabled`, `github.request_timeout_seconds`, `github.auto_extract_max_items` | GitHub public 仓库自动提取与图片卡片发送 | | **思考链** | `*.thinking_enabled` | 思维链支持 | | **思维链兼容** | `*.thinking_tool_call_compat` | 思维链 + 工具调用兼容 | | **WebUI** | `webui.url`, `webui.port`, `webui.password` | 配置控制台 | @@ -820,7 +831,8 @@ description: 从 PDF 文件中提取文本和表格，填写表单。当用户 1. **外部实体层**：用户、管理员、OneBot 协议端 (NapCat/Lagrange.Core)、大模型 API 服务商 2. **核心入口层**：main.py 启动入口、配置管理器 (config/loader.py)、热更新应用器 (config/hot_reload.py)、OneBotClient (onebot.py)、RequestContext (context.py)、Runtime API Server (api/app.py → api/routes/ 路由子模块) -3. **消息处理层**：MessageHandler (handlers.py)、SecurityService (security.py)、CommandDispatcher (services/command.py)、AICoordinator (ai_coordinator.py)、QueueManager (queue_manager.py)、Bilibili 自动提取 (bilibili/) +3. **消息处理层**：MessageHandler (handlers.py)、SecurityService (security.py)、CommandDispatcher (services/command.py)、AICoordinator (ai_coordinator.py)、QueueManager (queue_manager.py)、自动处理管线 (skills/auto_pipeline/)、Bilibili/arXiv/GitHub 解析与发送模块 + 自动提取由 `AutoPipelineRegistry` 并行检测、并行处理全部命中的管线；发送结果写入历史后继续进入 AI 自动回复。 4. **AI 核心能力层**：AIClient (client.py)、PromptBuilder (prompts.py)、ModelRequester (llm.py)、ToolManager (tooling.py)、MultimodalAnalyzer (multimodal.py)、SummaryService (summaries.py)、TokenCounter (tokens.py) 5. **存储与上下文层**：MessageHistoryManager (utils/history.py, 10000条限制)、MemoryStorage (memory.py, 置顶备忘录, 500条上限)、EndSummaryStorage、CognitiveService + JobQueue + HistorianWorker + VectorStore + ProfileStorage、MemeService + MemeWorker + MemeStore + MemeVectorStore (表情包库)、FAQStorage、ScheduledTaskStorage、TokenUsageStorage (自动归档) 6. **技能系统层**：ToolRegistry (registry.py)、AgentRegistry、6个 Agents、11类 Toolsets diff --git a/CHANGELOG.md b/CHANGELOG.md index 5db78b07..422c313e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,43 @@ +## v3.3.3 命令推断、自动处理管线与统一附件上下文 + +本版本重点优化了命令系统的交互体验、AI 工具边界和消息前置处理链路。新增 GitHub 链接自动卡片生成，并将 Bilibili、arXiv、GitHub 等自动提取迁入 `skills/auto_pipeline` 热重载管线，使预处理结果能写入历史并进入后续 AI 回复上下文。同时，帮助说明与用户侧写默认改为图片输出，系统剥离独立群聊分析工具集，全面推行统一附件标签，并为远程附件加入可配置下载上限和 URL 引用降级，完善底层用户识别机制与模型高级透传配置。 + +- 优化命令系统：支持声明式子命令与用户意图推断。如 `/faq` 合并了列表、阅读、搜索与删除入口，可自然理解省略部分参数后的交互意图；旧 `/lsfaq`、`/viewfaq`、`/searchfaq`、`/delfaq` 入口已移除。 +- 改善长文本呈现：`/help` 与 `/profile` 默认渲染为图片分发，避免长内容刷屏；保留 `-t` 参数用于强制返回纯文本，`/profile` 仍支持 `-f` 合并转发模式。 +- 新增自动处理管线：在 `skills/auto_pipeline` 下提供 `config.json + handler.py` 结构，支持热重载、并行检测和并行处理多个命中结果；首批内置 Bilibili、arXiv、GitHub 三条管线，且斜杠命令优先级高于自动管线，命中命令后不会触发后续自动提取或 AI 自动回复。 +- 优化自动管线启动加载：首次目录扫描、配置读取和 handler 导入改为异步线程加载，避免启动初始化阶段阻塞事件循环。 +- 修复自动管线兜底初始化：未显式执行异步初始化的兼容路径会按未初始化处理并主动加载管线，避免静默跳过自动提取。 +- 新增 GitHub 自动卡片：支持在对话中检测 GitHub 链接及 `owner/repo` 标识，自动生成包含项目简介、Stars、Forks、贡献者等信息的卡片；支持独立开关与白名单控制，并裁剪渲染截图底部空白。 +- 打通命令与自动提取历史上下文：斜杠命令输入、命令输出、自动管线发送的信息、图片、文件和视频摘要都会写入消息历史；统一发送层会自动把本地 CQ 图片、视频、语音和上传文件登记为当前会话可见的 `pic_*` / `file_*` UID，并记录群合并转发摘要，后续 AI 回复可直接看到这些结果并用 `
'
+ f'
"
+ )
+
+
+def _chip(label: str, value: str) -> str:
+ if not value:
+ value = "-"
+ return (
+ '{_html_text(_format_count(value))}
'
+ f'{_html_text(label)}
'
+ "'
+ f"{_html_text(label)}"
+ f"{_html_text(value)}"
+ "
"
+ )
+
+
+def _status_badges(info: GitHubRepoInfo) -> str:
+ badges: list[str] = ['Public']
+ if info.archived:
+ badges.append('Archived')
+ if info.fork:
+ badges.append('Fork')
+ return "".join(badges)
+
+
+def _topic_html(info: GitHubRepoInfo) -> str:
+ topics = info.topics[:6]
+ if not topics:
+ return ""
+ topic_items = "".join(f"{_html_text(topic)}" for topic in topics)
+ return f'{topic_items}
'
+
+
+def _build_repo_card_html(info: GitHubRepoInfo) -> str:
+ description = info.description or "No description provided."
+ avatar = info.owner_avatar_url
+ avatar_html = (
+ f'{_html_text(text)}"
+
+
+def _markdown_to_html(markdown_text: str) -> str:
+ return str(markdown.markdown(markdown_text, extensions=_MARKDOWN_EXTENSIONS))
+
+
+def _build_meta_item(label: str, value: str, *, code: bool = False) -> str:
+ value_html = _html_code(value) if code else _html_text(value)
+ return (
+ '"
+ )
+
+
+def _format_subcommands_html(meta: CommandMeta) -> str:
+ if not meta.subcommands:
+ return ""
+ rows: list[str] = []
+ for subcmd in meta.subcommands.values():
+ args_str = f" {subcmd.args}" if subcmd.args else ""
+ perm_mark = ""
+ if subcmd.permission != meta.permission:
+ perm_mark = (
+ f'{_permission_label(subcmd.permission)}'
+ )
+ rows.append(
+ "子命令
" + '{_html_text(item.description or "暂无说明")}{subcommand_badge}
Undefined 命令帮助
+可用命令
+当前会话可见的斜杠命令速查表
+
+ 会话：{_html_text(scope_hint)}
+ 权限：{_html_text(perm_hint)}
+ 命令：{len(commands)}
+
+
+ {"".join(command_rows)}
+
+
+
+ 自动推断
" + f'{_html_text(hint_text)}
' + "说明文档
" + f'Undefined 命令帮助
+{_html_text(title)}
+{_html_text(description)}
+
+
+ {_format_subcommands_html(meta)}
+ {inference_section}
+ {doc_section}
+
+