[Feature] 用户识别标识的位置：内联前缀 vs 尾部 system_reminder

未关闭
  • 哪里不对？
#10,887 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
25/100
Issue 类型
功能
描述清晰度
需要澄清
活跃度
活跃
技术栈
python
领域
ai, backend

调研方向

Read astrbot/core/config/default.py and astrbot/core/astr_main_agent.py to compare the identifier hint with where the reminder is added; then inspect openai_source.py and builtin_stars/astrbot/group_chat_context.py for the content-block and formatting context. This issue is explicitly for discussion, not a PR, and leaves the desired behavior undecided, so there is no implementation or test-defined completion criterion yet.

由索引模型根据 Issue 内容生成。

描述

enhancement
功能描述

功能描述

provider_settings.identifier（面板：配置 → AI → 用户识别）的 UI 文案与实现不一致，且实现位置对"让模型区分发言人"这个目标可能不是最优。想就此发起一次讨论。

文案（astrbot/core/config/default.py:4173，v4.29.3 与 master 一致）：

"provider_settings.identifier": {
    "description": "用户识别",
    "type": "bool",
    "hint": "在用户提示词前带上用户 ID 信息。",
},

实现（astrbot/core/astr_main_agent.py → _append_system_reminders）：

if cfg.get("identifier"):
    user_id = event.message_obj.sender.user_id
    user_nickname = event.message_obj.sender.nickname
    system_parts.append(f"User ID: {user_id}, Nickname: {user_nickname}")

system_parts 最终拼成 <system_reminder>...</system_reminder>，经 req.extra_user_content_parts 走 assemble_context() 追加到 content_blocks 末尾。openai_source.py 里对应位置也注明「用户原始发言在前，额外内容块在后」。

也就是说，实际位置在用户原话之后，与文案写的"前"相反。

（group_name_display 的 hint 同样写"前"，实现同理，属于同一模式，可一并考虑。）

使用场景

群聊里希望模型准确判断"这句话是谁说的"。

两种位置的差异：

  • 尾部独立块：标识与消息内容在结构上分离（同一条 message 的不同 content block），模型需要做相邻关联。群里连续多条发言、交叉对话、互相引用时，存在错配的空间。
  • 内联前缀：标识与内容在同一字符串内，物理上不可分离，关联更直接。

补充一点实测数据，供讨论参考。若改为内联 f"{nickname}: {prompt}"，昵称自带冒号会产生歧义。某 700 条真实群聊记录里，29 位发言人中有 4 位昵称含冒号（约 14%）：

增强:123sdx53228
求崩:Cartethyia_Ni
增强🆔：doro994645（职业进度21
增强:芣婹説話，閉仩觜妑

拼出来是 增强:123sdx53228: 我来了，可被读作「'增强' 说：123sdx53228: 我来了」。

而群聊上下文注入用的 _format_message（builtin_stars/astrbot/group_chat_context.py）是 [昵称/时间]: 内容，方括号把昵称整体框住，恰好规避了这类歧义——同样是内联，包装方式值得对齐。

建议（供参考，不代表必须这么做）

  1. 最低成本：让文案与实现一致。要么改 hint 的"前"，要么改实现位置。
  2. 若倾向内联，建议用 [昵称]: 内容，与注入块 [昵称/时间]: 保持同一套包装，避免昵称含冒号时的歧义。
  3. 无论选哪种，都可以考虑在 system prompt 补一句格式说明（例如「[昵称]: 前缀表示发言人，昵称可能重复」），让模型知道如何解读，收益比单纯换位置更大。
  4. 附带说明：位置不影响前缀缓存。两种做法都在当前 user message 内部，不改变历史前缀，只影响模型对发言人的归因。

声明

本 issue 由AI代写，仅为讨论与建议，不打算提交 PR。是否调整、怎么调整，交由维护者判断。

使用场景

No response

检查清单
  • 我已在 Issue 列表中搜索过相关功能，确认该功能想法从未被提出过。
  • 我建议的功能与 AstrBot 本体相关，而非在建议某一插件的功能。
  • 我已阅读并同意本项目的贡献者行为准则。
  • (可选)我愿意提交 PR 以帮助实现该功能。
主要语言
Python
星标
46.4k
派生
3.4k
平均合并
1 天 11 小时
30 天内合并 PR
120

环境准备

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

AstrBotDevs/AstrBot 的其他 Issue

查看 AstrBotDevs/AstrBot 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。