docs: align CSM terminology with code

This commit is contained in:
nav
2026-03-30 18:24:24 +00:00
parent 3b5ca21f40
commit 4dde4f6efe

View File

@@ -13,10 +13,10 @@
本方案采用: 本方案采用:
- 由发起讨论的 Agent 直接调用 `create private channel` - 由发起讨论的 Agent 直接调用 `discord_channel_create`
- 为该工具新增两个可选参数,以标记“讨论模式” - 为该工具新增两个可选参数,以标记“讨论模式”
- 由插件侧 moderator bot 用纯字符串拼接方式驱动讨论流程 - 由插件侧 moderator bot 用纯字符串拼接方式驱动讨论流程
- 由发起讨论的 Agent 在讨论结束时显式调用新工具 `discuss-callback` - 由发起讨论的 Agent 在讨论结束时显式调用新工具 `discuss-callback`
- 回调后关闭讨论 channel并唤醒原工作 channel 继续处理 - 回调后关闭讨论 channel并唤醒原工作 channel 继续处理
--- ---
@@ -31,7 +31,7 @@
4. 讨论结果能回传到原工作 channel 4. 讨论结果能回传到原工作 channel
5. 讨论结束后,讨论 channel 不再继续处理任何 Agent 发言 5. 讨论结束后,讨论 channel 不再继续处理任何 Agent 发言
6. moderator bot 不使用任何模型,所有发言均为固定模板/字符串拼接 6. moderator bot 不使用任何模型,所有发言均为固定模板/字符串拼接
7. 整个机制尽量复用现有插件顺序讨论能力 7. 整个机制尽量复用现有插件中的 turn-manager 轮转发言能力
--- ---
@@ -55,16 +55,16 @@
- 由工作中的 Agent 主动创建 - 由工作中的 Agent 主动创建
- 创建时提供原工作 channel idcallback channel id和讨论指引discuss guide - 创建时提供原工作 channel idcallback channel id和讨论指引discuss guide
- 插件识别该频道为特殊讨论频道 - 插件识别该频道为特殊讨论频道
- moderator bot 在频道中发布一条固定 kickoff message说明 - moderator bot 通过插件内部 `sendModeratorMessage(...)` 在频道中发布一条固定 kickoff message说明
- 讨论目的 - 讨论目的
- 应如何进行讨论 - 应如何进行讨论
- 结束条件 - 结束条件
- 发起讨论的 Agent 在结束时必须写总结文档并调用 `discuss-callback` - 发起讨论的 Agent 在结束时必须写总结文档并调用 `discuss-callback`
- 讨论期间复用现有“顺序讨论”机制驱动 Agent 发言 - 讨论期间复用现有 turn-manager 轮转发言机制驱动 Agent 发言
- 如果轮转一圈无人发言,则 moderator 提醒发起者执行 callback 收尾 - 如果轮转一圈无人发言,则 moderator 提醒发起者执行 callback 收尾
- callback 成功后: - callback 成功后:
- 检查总结文档是否存在,且必须位于发起讨论 Agent 的 workspace 下 - 检查总结文档是否存在,且必须位于发起讨论 Agent 的 workspace 下
- 将讨论 channel 中对应 session 的模型覆盖为 `NO_REPLY` - 将讨论 channel 中对应 session 的 provider/model override 到 `noReplyProvider` / `noReplyModel`
- 讨论 channel 后续任何消息都不再参与讨论,仅由 moderator 回复“channel 已关闭,仅留档” - 讨论 channel 后续任何消息都不再参与讨论,仅由 moderator 回复“channel 已关闭,仅留档”
- moderator 在原工作 channel 发消息,给出讨论结果文档路径,唤醒原工作流 - moderator 在原工作 channel 发消息,给出讨论结果文档路径,唤醒原工作流
@@ -72,9 +72,9 @@
## 5. 工具设计 ## 5. 工具设计
### 5.1 扩展 `create private channel` ### 5.1 扩展 `discord_channel_create`
在现有 `create private channel` 工具上新增两个可选参数: 在现有 `discord_channel_create` 工具上新增两个可选参数:
- `callbackChannelId?: string` - `callbackChannelId?: string`
- `discussGuide?: string` - `discussGuide?: string`
@@ -107,7 +107,7 @@
```text ```text
讨论私密协作 channel 的回调机制,需要明确: 讨论私密协作 channel 的回调机制,需要明确:
1. create private channel 扩展参数设计 1. `discord_channel_create` 扩展参数设计
2. discuss-callback 工具的行为 2. discuss-callback 工具的行为
3. 讨论结束后的 session 收口方式 3. 讨论结束后的 session 收口方式
4. MVP 范围内的异常处理策略 4. MVP 范围内的异常处理策略
@@ -147,7 +147,7 @@
## 6. 讨论模式 Channel 的元数据 ## 6. 讨论模式 Channel 的元数据
`create private channel` 以讨论模式创建 channel 时,插件需要记录对应 metadata。 `discord_channel_create` 以讨论模式创建 channel 时,插件需要记录对应 metadata。
建议结构如下: 建议结构如下:
@@ -234,7 +234,7 @@ After callback:
### 7.2 空转提醒机制 ### 7.2 空转提醒机制
插件当前已有顺序讨论机制。 插件当前已有基于 turn-manager 的轮转发言机制。
现有逻辑: 现有逻辑:
- 发言列表轮转一圈,如果没有人发言且所有人均回复 `NO_REPLY`,则认为 channel 休眠 - 发言列表轮转一圈,如果没有人发言且所有人均回复 `NO_REPLY`,则认为 channel 休眠
@@ -271,7 +271,7 @@ If more discussion is still needed, continue the discussion in this channel.
`discuss-callback` 成功后: `discuss-callback` 成功后:
1. 讨论 channel 标记为关闭/完成 1. 讨论 channel 标记为关闭/完成
2. 讨论 channel 中所有相关 session 的模型覆盖为 `NO_REPLY` 2. 讨论 channel 中所有相关 session 的 provider/model override 到 `noReplyProvider` / `noReplyModel`
3. 后续任何在该 channel 中的发言均不再触发实际讨论流程 3. 后续任何在该 channel 中的发言均不再触发实际讨论流程
4. 如果讨论结束后仍有人发言,由 moderator 统一回复: 4. 如果讨论结束后仍有人发言,由 moderator 统一回复:
- `channel 已关闭channel 仅做留档使用` - `channel 已关闭channel 仅做留档使用`
@@ -525,7 +525,7 @@ plans/discussions/csm-discussion-summary.md
- 内容包含 callback 操作说明 - 内容包含 callback 操作说明
### 第三步:接入空转提醒 ### 第三步:接入空转提醒
- 复用现有顺序讨论逻辑 - 复用现有 turn-manager 轮转逻辑
- 在讨论模式 channel 中改为空转提醒发起者 callback - 在讨论模式 channel 中改为空转提醒发起者 callback
### 第四步:实现 `discuss-callback` ### 第四步:实现 `discuss-callback`
@@ -536,7 +536,7 @@ plans/discussions/csm-discussion-summary.md
- metadata 更新 - metadata 更新
### 第五步:完成关闭逻辑 ### 第五步:完成关闭逻辑
- 指定 session 模型覆盖为 `NO_REPLY` - 指定 session 的 provider/model override 到 `noReplyProvider` / `noReplyModel`
- 结束后任何发言统一由 moderator 回复 channel 已关闭 - 结束后任何发言统一由 moderator 回复 channel 已关闭
### 第六步:原 channel 唤醒 ### 第六步:原 channel 唤醒
@@ -565,11 +565,11 @@ plans/discussions/csm-discussion-summary.md
本方案将 Agent 间讨论能力实现为一种“特殊模式的私密 Discord channel”通过 本方案将 Agent 间讨论能力实现为一种“特殊模式的私密 Discord channel”通过
- 扩展 `create private channel` - 扩展 `discord_channel_create`
- 新增 `discuss-callback` - 新增 `discuss-callback`
- 复用现有顺序讨论机制 - 复用现有 turn-manager 轮转发言机制
- 使用纯规则驱动的 moderator bot - 使用纯规则驱动的 moderator bot
- 在指定 session 上临时覆盖 `NO_REPLY` 模型 - 在指定 session 上临时应用 `noReplyProvider` / `noReplyModel` 覆盖
形成一个完整闭环: 形成一个完整闭环: