From 0ecb077fe7c0c1927d7c5dc43c2d2ed498f68691 Mon Sep 17 00:00:00 2001 From: illusion Date: Tue, 22 Sep 2026 18:21:53 +0800 Subject: [PATCH] docs(zh): add the missing Reading a Referenced Conversation section to README_zh (#5657) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(zh): add the missing Reading a Referenced Conversation section to README_zh Adds the 'Reading a Referenced Conversation' section to the Chinese README, mirroring the section #5465 added to the English README. Same position (between Context Engineering and Long-Term Memory), translated rather than paraphrased — including the read_conversation / conversation_references run fields, the context.conversation_references SDK fallback, the web '引用会话' (Reference a conversation) button, and both doc links (targets verified to exist). The English TOC does not list this section either, so the zh TOC is left unchanged to stay consistent. * docs(zh): address conversation reference review feedback --------- Co-authored-by: Willem Jiang --- README_zh.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README_zh.md b/README_zh.md index 471850efc..488b41a97 100644 --- a/README_zh.md +++ b/README_zh.md @@ -782,6 +782,12 @@ workspace 的 Browser Live 客户端通过二进制 JPEG WebSocket 帧协商画 **摘要压缩**:在单个 session 内,DeerFlow 会比较积极地管理上下文,包括总结已完成的子任务、把中间结果转存到文件系统、压缩暂时不重要的信息。这样在长链路、多步骤任务里,它也能保持聚焦,而不会轻易把上下文窗口打爆。 +### 读取引用的会话 + +Gateway API 调用方可以启用 `read_conversation`,并在一次 run 中提交 `conversation_references` 列表。主 agent 随后可以分页读取这些归属会话当前可见文本的有界页面。读取权限随该次 run 结束而失效,旧消息中的文本不会授予访问权限。访问权限失效或来源被删除后,agent 已经读过的文本仍会保留在目标会话中。一条消息如果单次读取放不下,会带有续接,agent 可以继续读取剩余部分;只有在那次读取不可用时,它才会请求缺失的部分。 + +无法在请求顶层添加字段的 SDK 客户端可以把同样的列表放在 `context.conversation_references` 中发送,`GET /api/features` 会报告该工具是否启用。启用后,Web UI 输入框会在附件按钮旁边显示一个"引用会话"按钮:最多选择你最近的三个会话,它们只附加到下一条消息上,以 chips 的形式显示在输入框与对话记录里。不会自动搜索历史。参见[配置](backend/docs/CONFIGURATION.md#reading-referenced-conversations)与[请求契约](backend/docs/API.md#referencing-a-previous-conversation)。 + ### 长期记忆 大多数 agents 会在对话结束后把一切都忘掉,DeerFlow 不一样。