Docs: update zh-CN translations and pipeline

What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
This commit is contained in:
Josh Palmer
2026-02-03 13:23:00 -08:00
parent 9f03791aa9
commit a3ec2d0734
228 changed files with 10651 additions and 10475 deletions
@@ -2,7 +2,7 @@
description: Track outbound session mirroring refactor notes, decisions, tests, and open items.
title: 出站会话镜像重构(Issue
x-i18n:
generated_at: "2026-02-01T21:36:30Z"
generated_at: "2026-02-03T07:53:51Z"
model: claude-opus-4-5
provider: pi
source_hash: b88a72f36f7b6d8a71fde9d014c0a87e9a8b8b0d449b67119cf3b6f414fa2b81
@@ -15,69 +15,69 @@ x-i18n:
## 状态
- 进行中。
- 核心 + 插件渠道路由已针对出站镜像进行更新。
- Gateway网关发送现在在省略 sessionKey 时自动推导目标会话。
- 核心 + 插件渠道路由已更新以支持出站镜像
- Gateway 网关发送现在在省略 sessionKey 时派生目标会话。
## 背景
出站发送过去被镜像到*当前*智能体会话(工具会话键)而目标渠道会话。入站路由使用渠道/对会话键,因此出站响应落入了错误的会话,首次联系的目标通常缺少会话条目。
出站发送被镜像到*当前*智能体会话(工具会话键)而不是目标渠道会话。入站路由使用渠道/对等方会话键,因此出站响应落错误的会话,首次联系的目标通常缺少会话条目。
## 目标
- 将出站消息镜像到目标渠道会话键。
- 在缺少会话条目时,于出站创建会话条目。
- 在缺失时为出站创建会话条目。
- 保持线程/话题作用域与入站会话键对齐。
- 盖核心渠道及捆绑扩展。
- 盖核心渠道加内置扩展。
## 实现摘要
-出站会话路由辅助模块
-出站会话路由辅助
- `src/infra/outbound/outbound-session.ts`
- `resolveOutboundSessionRoute` 使用 `buildAgentSessionKey`dmScope + identityLinks)构建目标 sessionKey。
- `ensureOutboundSessionEntry` 通过 `recordSessionMetaFromInbound` 写入最小`MsgContext`
- `runMessageAction`(发送)推导目标 sessionKey 并传递给 `executeSendAction` 用于镜像。
- `message-tool` 不再直接镜像;它从当前会话键解析 agentId。
- 插件发送路径使用推导的 sessionKey 通过 `appendAssistantMessageToSessionTranscript` 进行镜像。
- Gateway网关发送在未提供 sessionKey 时推导目标会话键(默认智能体),并确保会话条目存在
- `ensureOutboundSessionEntry` 通过 `recordSessionMetaFromInbound` 写入最小的 `MsgContext`
- `runMessageAction`(发送)派生目标 sessionKey 并将其传递给 `executeSendAction` 进行镜像。
- `message-tool` 不再直接镜像;它从当前会话键解析 agentId。
- 插件发送路径使用派生的 sessionKey 通过 `appendAssistantMessageToSessionTranscript` 进行镜像。
- Gateway 网关发送在未提供时派生目标会话键(默认智能体),并确保会话条目。
## 线程/话题处理
- SlackreplyTo/threadId -> `resolveThreadSessionKeys`(后缀)。
- DiscordthreadId/replyTo -> `resolveThreadSessionKeys``useSuffix=false` 以匹配入站(线程频道 ID 已限定会话作用域)。
- Telegram:话题 ID 通过 `buildTelegramGroupPeerId` 映射 `chatId:topic:<id>`
- DiscordthreadId/replyTo -> `resolveThreadSessionKeys``useSuffix=false` 以匹配入站(线程频道 id 已经作用域会话)。
- Telegram:话题 ID 通过 `buildTelegramGroupPeerId` 映射 `chatId:topic:<id>`
## 已覆盖的扩展
## 盖的扩展
- Matrix、MS Teams、Mattermost、BlueBubbles、Nextcloud Talk、Zalo、Zalo Personal、Nostr、Tlon。
- 注:
- Mattermost 目标现在为 私信 会话键路由去除 `@` 前缀
- Zalo Personal 对 1:1 目标使用 私信 对端类型(仅存在 `group:` 时使用群组)。
-
- Mattermost 目标现在为私信会话键路由去除 `@`
- Zalo Personal 对 1:1 目标使用私信对等方类型(仅存在 `group:`使用群组)。
- BlueBubbles 群组目标去除 `chat_*` 前缀以匹配入站会话键。
- Slack 自动线程镜像不区分频道 ID 大小写进行匹配
- Gateway网关发送在镜像前将提供的会话键转为小写。
- Slack 自动线程镜像不区分大小写地匹配频道 id
- Gateway 网关发送在镜像前将提供的会话键转为小写。
## 决策
- **Gateway网关发送会话推导**:如果提供了 `sessionKey`,则直接使用。如果省略,从目标 + 默认智能体推导 sessionKey 并镜像到该会话
- **会话条目创建**:始终使用 `recordSessionMetaFromInbound``Provider/From/To/ChatType/AccountId/Originating*` 与入站格式对齐。
- **目标规范化**:出站路由在可用时使用解析的目标(经过 `resolveChannelTarget` 处理后)。
- **会话键大小写**:在写入和迁移将会话键规范化为小写。
- **Gateway 网关发送会话派生**:如果提供了 `sessionKey`,则使用。如果省略,从目标 + 默认智能体派生 sessionKey 并镜像到那里
- **会话条目创建**:始终使用 `recordSessionMetaFromInbound``Provider/From/To/ChatType/AccountId/Originating*` 与入站格式对齐。
- **目标规范化**:出站路由在可用时使用解析的目标(`resolveChannelTarget` 后)。
- **会话键大小写**:在写入和迁移期间将会话键规范化为小写。
## 新增/更新的测试
## 添加/更新的测试
- `src/infra/outbound/outbound-session.test.ts`
- Slack 线程会话键。
- Telegram 话题会话键。
- 使用 Discord 的 dmScope identityLinks。
- dmScope identityLinks 与 Discord
- `src/agents/tools/message-tool.test.ts`
- 从会话键推导 agentId(不传递 sessionKey)。
- 从会话键派生 agentId(不传递 sessionKey)。
- `src/gateway/server-methods/send.test.ts`
- 省略时推导会话键并创建会话条目。
- 省略时派生会话键并创建会话条目。
## 待办事项 / 后续跟进
## 待处理项目 / 后续跟进
- 语音通话插件使用自定义 `voice:<phone>` 会话键。此处的出站映射尚未标准化;如果 message-tool 需要支持语音通话发送,添加显式映射。
- 确认是否有外部插件使用超出捆绑集合的非标准 `From/To` 格式。
- 语音通话插件使用自定义 `voice:<phone>` 会话键。出站映射在这里没有标准化;如果 message-tool 应该支持语音通话发送,添加显式映射。
- 确认是否有任何外部插件使用内置集之外的非标准 `From/To` 格式。
## 涉及的文件
@@ -86,7 +86,7 @@ x-i18n:
- `src/infra/outbound/message-action-runner.ts`
- `src/agents/tools/message-tool.ts`
- `src/gateway/server-methods/send.ts`
- 测试文件
- 测试:
- `src/infra/outbound/outbound-session.test.ts`
- `src/agents/tools/message-tool.test.ts`
- `src/gateway/server-methods/send.test.ts`