docs: finalize channel mode and shuffle docs

This commit is contained in:
zhi
2026-04-02 07:48:25 +00:00
parent 15f7d211d7
commit 29f1f01219
5 changed files with 36 additions and 15 deletions

View File

@@ -28,13 +28,13 @@
### 1.2 配置项
建议新增以下可配置项:
新增并已实现以下可配置项:
- `multiMessageStartMarker`:默认 `↗️`
- `multiMessageEndMarker`:默认 `↙️`
- `multiMessagePromptMarker`:默认 `⤵️`
这些配置加入插件 config schema并在运行时hook/turn-manager 使用。
这些配置加入插件 config schema并在运行时被 `message-received` / `before-message-write` / `before-model-resolve` 使用。
---
@@ -100,13 +100,17 @@ multi-message mode 应与 discussion channel / wait-for-human / no-reply 决策
并新增 slash command
- `/turn-shuffling on`
- `/turn-shuffling off`
- `/turn-shuffling`(查看当前状态)
- `/dirigent turn-shuffling on`
- `/dirigent turn-shuffling off`
- `/dirigent turn-shuffling`(查看当前状态)
该状态应与 channel 级 policy / runtime state 做清晰分工
- 若只是运行时开关,可放 runtime memory
- 若希望重启保留,则需要落盘策略
当前实现结论
- `shuffling`**channel 级 runtime state**,存放在 `plugin/core/channel-modes.ts`
- 默认值为 `false`
- 当前版本**不新增**全局 `shuffle default` 配置项
- 重启后会恢复为默认关闭,如需开启需要再次执行命令
这样与现有实现保持一致,也避免把一次性的实验性调度偏好混入全局静态配置。
---
@@ -208,8 +212,9 @@ Multi-Message Mode 与 Shuffle Mode 已经在代码中实现,包括:
- Shuffle Mode 实现:
- `plugin/core/channel-modes.ts` - 管理 shuffle 状态
- `plugin/turn-manager.ts` - 在每轮结束后根据 shuffle 设置决定是否重洗牌
- `/turn-shuffling` slash command 实现,支持 `on`/`off`/`status` 操作
- `/dirigent turn-shuffling` slash command 实现,支持 `on`/`off`/`status` 操作
- 确保上一轮最后发言者不会在下一轮中成为第一位
- 当前行为是运行时开关,默认关闭,不落盘
## 7. 验收清单
@@ -224,7 +229,7 @@ Multi-Message Mode 与 Shuffle Mode 已经在代码中实现,包括:
- [x] 与 mention override 模式兼容
### Shuffle Mode 验收
- [x] `/turn-shuffling on/off` 命令生效
- [x] `/dirigent turn-shuffling on/off` 命令生效
- [x] shuffling 关闭时 turn order 保持不变
- [x] shuffling 开启时每轮结束后会重洗牌
- [x] 上一轮最后发言者不会在下一轮中成为第一位