Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
b672a39
fix: 协议端没有回执的发送记为结果未知,插件不再换写法重发
LEN5010 Nov 10, 2026
9a2fe82
feat: 回复效果双向调整插话间隔,放宽慢于收紧
LEN5010 Nov 10, 2026
20164d7
test: 插件卡片不占模型的发言节奏、发言计数和对话继续
LEN5010 Nov 10, 2026
3d35087
自我重复提醒扩到句式
LEN5010 Nov 10, 2026
06a5df1
整理回合统计本群发言形态,作为每轮参考
LEN5010 Nov 10, 2026
eb36191
每轮参考材料最后复述角色材料里写明不做的句子
LEN5010 Nov 10, 2026
d93b2f7
feat: 回想单独限额,模型连续失败提醒主人,恢复后只追赶最近的消息
LEN5010 Nov 10, 2026
1a81ed8
Merge branch 'feat/group-voice' of https://github.com/lendevs/LenBot …
LEN5010 Nov 10, 2026
826347b
每轮末尾的参考材料单独组装,角色写明不做的固定排最后
LEN5010 Nov 10, 2026
0b0eef3
Merge remote-tracking branch 'origin/feat/group-voice' into feat/grou…
LEN5010 Nov 10, 2026
42f7e6e
fix: 模型恢复后,因服务商报错停下的后台整理重新开始
LEN5010 Nov 10, 2026
82d380c
Merge branch 'feat/group-voice' of https://github.com/lendevs/LenBot …
LEN5010 Nov 10, 2026
a71993c
把群友对最近几句话的反应放进每轮参考
LEN5010 Nov 10, 2026
123caef
Merge branch 'feat/group-voice' of https://github.com/lendevs/LenBot …
LEN5010 Nov 10, 2026
c9d480b
持续关注默认打开,同一条关注两分钟内只由消息叫醒一次
LEN5010 Nov 10, 2026
98b65ec
主动开口时附上话题隔了多久、后面是否已经聊到别处
LEN5010 Nov 10, 2026
474633b
feat: 模型失败提醒的连续回合数可配置,单次请求超时也计入失败
LEN5010 Nov 10, 2026
0842c22
chore: 去掉两个文件末尾多余的空行
LEN5010 Nov 10, 2026
57e9d5b
revert: 协议端报告未确认的发送仍记为失败
LEN5010 Nov 10, 2026
9037062
fix: 复述角色原句时不取引号里的台词、固定词和条件分句
LEN5010 Nov 10, 2026
7f4439b
fix: 窗口内被攒下的意图命中在窗口结束时补开一次唤醒 [skip ci]
LEN5010 Nov 10, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ Before the first release candidate (RC), all six format and interface numbers we
| Format or interface | Current value | Location |
|---|---|---|
| Plugin interface | `1` | `INTERFACE` in `src/len_bot/plugin.py` |
| Root configuration | `5` | `CONFIG_VERSION` in `src/len_bot/next/config.py` |
| Root configuration | `6` | `CONFIG_VERSION` in `src/len_bot/next/config.py` |
| Business database | `2` | `FORMAT_VERSION` in `src/len_bot/next/storage/store.py` |
| Memory job database | `1` | `FORMAT_VERSION` in `src/len_bot/next/memory/jobs.py` |
| Local memory index | `1` | `FORMAT_VERSION` in `src/len_bot/next/memory/local.py` |
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ uv run --no-sync ruff check src/len_bot scripts deploy/package tests
| 编号项 | 当前值 | 定义位置 |
|---|---|---|
| 插件接口版本 | `1` | `src/len_bot/plugin.py` 的 `INTERFACE` |
| 根配置格式 | `5` | `src/len_bot/next/config.py` 的 `CONFIG_VERSION` |
| 根配置格式 | `6` | `src/len_bot/next/config.py` 的 `CONFIG_VERSION` |
| 业务数据库 | `2` | `src/len_bot/next/storage/store.py` 的 `FORMAT_VERSION` |
| 记忆处理库 | `1` | `src/len_bot/next/memory/jobs.py` 的 `FORMAT_VERSION` |
| 本地记忆索引 | `1` | `src/len_bot/next/memory/local.py` 的 `FORMAT_VERSION` |
Expand Down
4 changes: 2 additions & 2 deletions developer/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ OneBot ────────────> 平台适配器 ──> 消息入

### 持续关注与局部收尾

`attention.declarations` 开启后,允许 `attention` 工具的角色可以创建跨回合意图;`attention.disposition` 独立控制本轮收尾的 `open/closed`。两项均默认关闭。意图跨回合保留,条件命中后由模型判断是否完成。配置、工具和调度语义见[持续关注](attention.md)。
`attention.declarations` 开启后,允许 `attention` 工具的角色可以创建跨回合意图;`attention.disposition` 独立控制本轮收尾的 `open/closed`。前者默认开启(写 `null` 关闭),后者默认关闭。意图跨回合保留,条件命中后由模型判断是否完成。配置、工具和调度语义见[持续关注](attention.md)。

### 请求顺序

Expand Down Expand Up @@ -173,7 +173,7 @@ OneBot ────────────> 平台适配器 ──> 消息入
- 只执行 `memory` 工具,其他工具返回未执行。角色没有开放 `memory` 时不能整理记忆。
- 已在会话历史里的消息按消息 id 指明范围,不在历史里的(已压缩进回想或还没进会话)附原文。
- 最后一次回复正文是 JSON,含 `expressions`、`terms`、`effects`;说法来源为本批群友消息,黑话还可引用本次提供的既有用例及相邻人类消息;不合格的条目丢掉,其余照常落库,丢掉的原因记在该批的回复记录里。读不出 JSON 时请模型重答一次,工具轮数用完时请模型直接给结果。结果写进原有的 `memory_jobs`、`learning_batches`、`jargon_calls` 和 `reply_effect_calls`;请求以 `upkeep` 用途记在 `model_calls`,用量只计一次。
- 触发沿用 `memory.ingest` 和 `learning` 的阈值,聊天模型开轮时不取快照,轮次结束后再唤醒;会话压缩前强制整理一次。一批失败时四类结果都不落库,进度不前进;60 秒后自动重跑同一范围,连续失败 3 次后等面板重试。memory 工具调用出错时把错误交给模型,不让整批失败。工作者遇到意外错误时在面板显示,暂停 60 秒后继续。
- 触发沿用 `memory.ingest` 和 `learning` 的阈值,聊天模型开轮时不取快照,轮次结束后再唤醒;会话压缩前强制整理一次。一批失败时四类结果都不落库,进度不前进;60 秒后自动重跑同一范围,连续失败 3 次后等面板重试;若这 3 次都是服务商 HTTP 错误、连接失败或请求超时,聊天模型在一段失败后重新答复时(`ModelAlerts` 判定恢复)把失败次数清零一次,同一范围按原规则重新开始,不另加重试次数。memory 工具调用出错时把错误交给模型,不让整批失败。工作者遇到意外错误时在面板显示,暂停 60 秒后继续。
- 手动整理与会话压缩请求按本次请求标记消费;规划读库或准备会话历史期间收到的新请求保留给下一轮整理。

说法去重:没有向量时,同一说法且情境字词重合度不低于 0.6 的新候选并入已有说法;有向量时按余弦相似度 0.9 合并。
Expand Down
30 changes: 28 additions & 2 deletions developer/attention.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,10 +55,24 @@ min(ambient_max_interval_seconds, ambient_min_interval_seconds × 2^silence_leve

## 回复效果系数

插话间隔除以一个系数。系数取本群最近 3 天内、由环境插话或随机探索唤醒的回合里最多 10 条已判定的回复效果:`agree` 和 `continue` 记 1,`unrelated` 和 `negative` 记 -1,其余记 0,每条按 24 小时半衰加权。加权平均(分母另加 2,避免一两条判定就大幅变化)小于 0 时,系数为 1 加上它的一半,最低 0.5;不小于 0 时为 1。直接联系、点名、对话继续和持续关注不受系数影响。系数随唤醒判定保存为 `effect_factor`,写进 `attention_ambient` 日志,现场的唤醒详情在系数小于 1 时显示。
插话间隔除以一个系数。系数取本群最近 3 天内、由环境插话或随机探索唤醒的回合里最多 10 条已判定的回复效果:`agree` 和 `continue` 记 1,`unrelated` 和 `negative` 记 -1,其余记 0,每条按 24 小时半衰加权。加权平均(分母另加 2,避免一两条判定就大幅变化)小于 0 时,系数为 1 加上它的一半,最低 0.5,插话间隔最多延长到 2 倍;大于 0 时,系数为 1 加上它的四分之一,最高 1.25,插话间隔最多缩短到 0.8 倍。同样多的判定,收紧比放宽快。直接联系、点名、对话继续和持续关注不受系数影响。系数随唤醒判定保存为 `effect_factor`,写进 `attention_ambient` 日志,现场的唤醒详情在系数不为 1 时显示。

`uv run --no-sync python scripts/first_reply_latency.py batches` 用固定 OneBot 到达序列核对图片后补文字、同一人续发、换人、隔着别人续发、旁人发图和上限;`report <数据库>` 读取实际回合的首句等待与合批、模型、工具、发送耗时。

## 恢复后的追赶

宿主启动时还有上一个进程留下的未读消息,或一个回合因聊天模型的服务商错误失败后,场景进入追赶状态,直到某个回合拿到模型回复。追赶期间:

- 环境插话和随机探索只在最近 5 分钟(`CATCH_UP_SECONDS`)内有可以接的话时开轮;只有旧消息时撤下这次唤醒,消息留给下一轮,日志 `attention_catch_up`。
- 开轮时 5 分钟以前的消息单独成段,标题写明追赶开始时间、这些消息当时没有回应、按原时间理解且不逐条补回;@ Bot 的旧消息照常唤醒,按原时间交给模型。失败回合已经读入会话的批次不再重发,恢复回合的批次标题同样带这段说明。
- 恢复未结束对话(`resume`)的回合不受影响。

## 模型故障提醒

`runtime/model_alerts.py` 按聊天绑定(服务商和模型)统计所有场景连续以服务商错误结束的回合(`ModelHTTPError`、`ModelConnectionError` 或单次请求自身的 `TimeoutError`,回合结果的 `model_failure`;以 `error` 或 `timeout` 结束的回合都会带上)。整轮超时由外层取消,不算服务商错误。达到根配置 `model_alert_failed_turns`(默认 3)个时私聊每位主人一次:错误类别、最早失败时间、涉及场景数和最近一次错误;之后第一个拿到模型回复的回合(`model_replies` 大于 0)再发一次恢复。主人的私聊场景已接入时经该场景的发送出口并入库,否则直接经平台发送;非真实发送时只写 `model_alert` 日志。失败计数只在内存中,重启后清零。宿主不切换模型,不重试。

一段失败结束时(不论是否已提醒),`SessionUpkeep.model_recovered()` 让因服务商错误(含请求超时)用完 3 次自动重试的后台整理清零一次失败次数,积压的整理不必等面板重试;它不增加请求,也不对其他原因的失败生效。

## 唤醒判定记录

每条收到的消息在 `messages.wake_verdict` 里保存一次判定:`woke`、`channel`、`reason` 和 `effect_factor`。`effect_factor` 只在消息可以接话时计算,其余为 `null`。
Expand All @@ -74,7 +88,7 @@ min(ambient_max_interval_seconds, ambient_min_interval_seconds × 2^silence_leve
}
```

不配置即关闭。配置在场景重新装配时生效。面板群设置的持续关注与对话收尾一节提供两个开关,运行模式和上限在高级设置中。
`declarations` 默认开启(`enforce` 与下文的默认限制),写 `null` 关闭;`disposition` 不配置即关闭。根配置格式 5 及更早的文件里 `declarations: null` 是面板保存的旧默认值,升级到格式 6 时去掉,按新默认开启;格式 6 起 `null` 表示主动关闭。配置在场景重新装配时生效。面板群设置的持续关注与对话收尾一节提供两个开关,运行模式和上限在高级设置中。

面板读取与取消:

Expand Down Expand Up @@ -124,6 +138,18 @@ min(ambient_max_interval_seconds, ambient_min_interval_seconds × 2^silence_leve

候选由聊天模型判断后执行 `keep` 或 `resolve`,例如指定账号的一条闲聊也会匹配 `person`。定时条件触发一次后不再自动重复,意图仍保留;再次定时需要修改意图。

### 由模型决定关注什么

持续意图是插话的主要来源:模型在回合里声明接下来要跟的人、话题和时长,命中时宿主按声明唤醒。插话间隔退为兜底,没有声明或声明没命中时才按它偶尔看一眼群:

- 意图唤醒的回合开始时和环境插话一样记一次 `ambient_last_at`,插话间隔从这时重新起算,意图唤醒替代而不是叠加在插话之上。
- 同一个意图由消息命中开轮后,`REWAKE_SECONDS`(120 秒)内再命中的消息先只记为候选,日志 `attention_candidate_held`;窗口结束时这些候选按计时条件的方式一起开一次意图唤醒(`next_due` 包含这个时间,状态保存后重启仍有效,遵守安静时段和只回应直接联系)。窗口内已有别的回合开轮并带走了候选时,不再补开。计时条件不受限制。
- 不增加模型调用:意图命中直接开一个普通回合,没有额外的判断请求。

### 话题新鲜度

环境插话、随机探索和意图唤醒的批次末尾附 `<话题新鲜度>`(`chat/freshness.py`、`next_topic_freshness.md`),只写事实:叫醒这次的那条消息的时间和距今多久,之后又有几条、几个人在说,其中几条和它有相同的字词(汉字两字组或两个以上字母数字),最后一条距今多久,中间停了 5 分钟以上的次数和最长一次。提示词说明隔得久、后面在聊别的就不回头接,模型判断值得回头时再接。直接联系、点名和对话继续不附这一段。叫醒这次的消息取唤醒时间当时或之后收到的第一条成员消息;窗口结束后补开的意图唤醒取被攒下的候选消息;只由计时条件开轮、批次里没有这样的消息时不附这一段。追赶期间仍按上文只看最近 5 分钟开轮,新鲜度按实际开轮的批次计算。

## 局部收尾

可在最后一次 say、react、message_reaction 或 attention 调用上附加:
Expand Down
6 changes: 3 additions & 3 deletions developer/context.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

一轮回复的开始时间是固定的。之后到达的消息批次和 wait 的结果,会提供新的真实时间依据。任务快照只列出活动身份、状态和待回答的问题,较长的结果通过实际的结束事件或 task 工具读取。

参考材料末尾可能附一段最近的说法,列出最近几次发言里反复出现的词和表情图,提醒下一条换个说法。这段内容每次请求从原生历史重新统计,不写入历史,规则见[群聊表达](expression-materials.md#不照抄自己)。
参考材料末尾依次可能附上:最近一次整理回合统计的本群发言形态;最近的说法,列出最近几次发言里反复出现的词、句式和表情图,提醒下一条换个说法;最后是角色材料里带否定的原句。后两段每次请求重新计算,都不写入历史,规则见[群聊表达](expression-materials.md#参考材料的来源)和[不照抄自己](expression-materials.md#不照抄自己)。

临时召回的内容不写入原生历史,也不作为旧段落摘要的来源。执行记忆工具前,先撤下旧的召回内容。群概览在下一次请求时重新读取,工具只完成一部分就报错时也是如此。配置或能力发生变化时,按最新能力重建请求前缀。

Expand Down Expand Up @@ -88,7 +88,7 @@ send_file 返回可以操作的回执和原事件 ID,完整的平台原始帧

原生摘要接着聊天请求续写:沿用同一份 system、tools、回想和历史,去掉本轮参考,末尾追加一条整理指令(`next_recap_continue.md`),用切分点两侧消息的片段标出移出范围,并沿用聊天的缓存亲和标识。服务商的前缀缓存因此覆盖整段历史,新输入只有这条指令。这一轮请求带着 tools,回复里出现工具调用或空正文时按摘要失败处理。续写请求超出上下文窗口时,改用只含旧回想和即将移出旧段落的独立请求。角色交接和插件压缩使用独立请求的资料。手动压缩也计入当前参考的预算。

摘要成功、内容非空并且满足空间要求后,在原事务中移动起点,并重置已发现的工具集合。摘要失败时,旧的回想和原始记录保持原样。最新的不可拆分单位或摘要输入过大时,错误信息会给出估算值、预留量和窗口大小。
摘要成功、内容非空并且满足空间要求后,在原事务中移动起点,并重置已发现的工具集合。摘要失败时,旧的回想和原始记录保持原样。回合内的自动压缩因回想输出额度用完(`ModelOutputLimitError`)或预算错误失败、并且未压缩的请求加聊天输出额度仍放得进窗口时,本轮用未压缩的请求继续,日志记 `compaction_held`;此后输入估算比失败时多出 `keep_recent_tokens` 之前不再自动压缩,放不进窗口时照常压缩,再失败则本轮失败。回想插件的失败不走这条路径。最新的不可拆分单位或摘要输入过大时,错误信息会给出估算值、预留量和窗口大小。

## 临时请求

Expand All @@ -98,7 +98,7 @@ send_file 返回可以操作的回执和原事件 ID,完整的平台原始帧
- 插件的 generate 只使用插件明确提供的 system 和 prompt。
- 独立抽取请求使用各自原有的游标、记录表和真实消息样本,不复制聊天会话历史。

这些请求使用各自所属绑定的输出额度。recap 单独使用 `compaction.max_output_tokens`。
这些请求使用各自所属绑定的输出额度。recap 单独使用 `compaction.max_output_tokens`,思考强度用 `compaction.reasoning_effort`,未设置时沿用聊天绑定的 `quick_reasoning_effort`;思考预留按这个强度计算,`none`、`off` 不预留。

`say.mention` 使用平台账号,例如 `onebot:70001`,格式与消息的发送者身份和平台发送端一致。只写账号本身、不带平台前缀时,工具参数解析阶段会直接报错。

Expand Down
Loading