OpenChamber Text 模块解析：本地文本清洗与摘要回退机制实战指南

AI Agent人工智能代码智能体交互助手【免费下载链接】openchamberAgentic Development Environment based on OpenCode AI agent项目地址https://gitcode.com/gh_mirrors/op/openchamber点击查看免费下载导读OpenChamber 的packages/web/server/lib/text模块是服务端共享的文本变换工具箱为 TTS 朗读、通知正文、项目记忆笔记等多个产品面提供统一的文本清洗与摘要能力。本文将带你完整掌握该模块的公开 API、三种处理模式tts/notification/note的差异与底层实现并结合源码与测试用例说明摘要服务在模型提供商不可用时的本地回退机制以及如何通过 HTTP 端点正确调用它。模块定位不属于任何单一产品面的共享文本管线在 OpenChamber 服务端text模块的设计原则是中立——它不被 TTS、通知或笔记任何一个产品面独占而是为所有需要把一段文本变成更干净、更简短、适合特定出口的文本的场景提供共享能力。值得特别说明的是该模块的历史沿革它此前通过 opencode.ai 的 Zen 提供商代理模型驱动的摘要能力由于该提供商不再适用于此用途摘要功能现已完全本地化——只返回经过清洗/蒸馏的本地回退文本不再发起任何外部模型调用。这一点在模块文档的 Purpose 一节中有明确交代也是理解整个模块设计的关键背景。模块唯一的入口文件为 summarization.js它同时包含摘要桩函数与全部清洗辅助函数文件头部注释即声明了三种模式的语义/** * Shared text summarization service. * * Modes: * - tts: concise speakable text * - notification: concise notification text * - note: distilled project note */公共导出 API模块对外暴露以下四个函数导出函数签名用途summarizeText({ text, threshold, maxLength, zenModel, mode })摘要入口API 兼容桩zenModel被忽略sanitizeForTTSsanitizeForTTS(text)为语音输出清洗文本sanitizeForNotificationsanitizeForNotification(text)为紧凑通知正文清洗文本sanitizeForNotesanitizeForNote(text)为短笔记/蒸馏输出清洗文本其中summarizeText的完整签名与默认值如下见 summarization.js#L119export async function summarizeText({ text, threshold 200, maxLength 500, zenModel, mode tts })参数含义text待处理的原始文本必需。threshold默认200。当text长度不超过该阈值时直接判定为无需摘要并原样返回清洗结果。maxLength默认500。蒸馏算法尝试将结果控制在的目标长度。zenModel历史遗留参数代码中以void zenModel;显式忽略见 summarization.js#L120。mode默认tts决定走哪条清洗/蒸馏管线。三种模式tts / notification / note三个模式对应三条不同的文本出口清洗策略差异显著。从源码的sanitizeByMode分发逻辑summarization.js#L65-L69可以看出function sanitizeByMode(text, mode) { if (mode note) return sanitizeForNote(text); if (mode notification) return sanitizeForNotification(text); return sanitizeForTTS(text); }tts可朗读的语音摘要sanitizeForTTS是三种清洗器中最激进的一个目标是让文本读起来自然见 summarization.js#L10-L26代码块 围栏与行内代码 整体替换为空格——避免 TTS 把代码读出来删除 Markdown 强调符号* _ ~ #删除行首的$ # 引用符将| ; 等符号替换为空格移除反斜杠、括号、引号把 URL 替换为可朗读的占位短语 a link 例如https://example.com会变成 a link移除路径类片段最终把连续空白折叠为单个空格并trim()。典型输入输出对照输入输出Read \const value 1 aloud|Read aloudBefore\njs\nconst value 1\n\nAfterBefore Afternotification紧凑的通知正文sanitizeForNotificationsummarization.js#L28-L44更注重保真度行内代码保留内容本身code→code仅移除反引号删除列表符号- * 与标题符号#剥离加粗/斜体的 Markdown 包裹符**、__、*、_把 Markdown 链接text收敛为纯文本text将换行折叠为单个空格压缩连续空白。note蒸馏后的项目记忆笔记sanitizeForNotesummarization.js#L46-L63在 notification 的基础上更近一步额外移除 URL与引号适合把一段对话内容沉淀为简短的项目记忆条目。本地回退摘要的蒸馏实现由于模型提供商不可用summarizeText的摘要能力由两个本地蒸馏函数承担见 summarization.js#L71-L111distillNoteFallback(text, maxLength)note 模式先经sanitizeForNote清洗剥离常见的 AI 风格前缀如In summary:、Here is a note:按句子切分取第一句作为候选再按;:()-与逗号逐级截断到更短的片段理想上限取min(maxLength, max(32, 原文长度 × 0.65))若候选超长则截取到idealLimit - 1并追加省略号…。distillNotificationFallback(text, maxLength)notification 模式清洗后按句子切分优先选取长度 ≥ 20 的第一句话避免选出残缺碎片否则回退到第一句或全文长度上限为max(20, maxLength)maxLength非有限数值时取 100超出时截断并追加省略号。而tts模式走的是纯清洗路径sanitizeByMode不做句子级蒸馏——因为语音场景优先保证完整性由上层自行控制篇幅。响应契约summarizeText始终返回一个对象summarization.js#L122-L137字段说明summary本地清洗/蒸馏后的回退文本summarized恒为false模型提供商不可用期间reason跳过原因文本超过阈值时通常为Model summarization provider unavailableoriginalLength可选仅文本超阈值时返回的原始长度summaryLength可选仅文本超阈值时返回的摘要长度注意两条边界分支文本为空返回{ summary: , summarized: false, reason: No text provided }文本长度 ≤threshold返回{ summary: 清洗结果, summarized: false, reason: Text under threshold }此时不附带长度字段。HTTP 集成POST /api/text/summarize该模块通过 TTS 路由注册了一个公开端点tts/routes.js#L108-L131app.post(/api/text/summarize, async (req, res) { const { text, threshold 200, maxLength 500, mode } req.body || {}; if (!text || typeof text ! string || !text.trim()) { return res.status(400).json({ error: Text is required }); } const result await summarizeText({ text, threshold, maxLength, mode: typeof mode string ? mode : tts, }); return res.json(result); });实际调用示例curlcurl -X POST http://localhost:PORT/api/text/summarize \ -H Content-Type: application/json \ -d { text: First sentence. Second sentence with the useful insight., threshold: 0, maxLength: 100, mode: note }预期响应{ summary: First sentence., summarized: false, reason: Model summarization provider unavailable }要点text缺失或非字符串时返回400mode缺省时回退为tts路由的 catch 分支tts/routes.js#L126-L129在异常时按mode选用sanitizeForNote或sanitizeForTTS兜底保证接口始终能返回一个干净的summary字段。通知模块中的兼容桩除了 HTTP 端点通知模块也直接复用了该管线。template-runtime.js 内部定义了一个同名的summarizeText兼容桩以threshold: 0、mode: notification调用共享的summarizeText把targetLength映射为maxLength并在结果为空时回退返回原文确保通知正文渲染不因摘要失败而中断。这正是模块文档所说Add new mode semantics here when multiple product surfaces need the same text pipeline的实例——多个产品面共享同一条文本管线而不是各自复制实现。测试验证回退行为有据可查模块的行为由 summarization.test.js 覆盖三组测试直接印证了核心契约TTS 清洗验证代码块在剥离 Markdown 标点前被移除Read \const value 1 aloud→Read aloud不再调用 Zen 提供商传入zenModel: gpt-5-nano后断言summarized false且reason Model summarization provider unavailable同时校验 notification 蒸馏在 80 字符上限下的省略号截断结果note 本地回退两句话的输入在maxLength: 100下仅保留第一句验证取首句的蒸馏策略。这些测试同时是贡献者的行为规范任何对清洗规则的调整都应在该测试文件中同步补充用例。给贡献者的维护约定模块文档在 Notes for contributors 一节给出了三条边界源码中也一一对应保持模块中立不要将本模块重新耦合到 TTS 专属的命名或路由例如不要在清洗器里加入语音相关的分支共享模式优先当多个产品面需要相同的文本管线时在此处新增模式语义扩展sanitizeByMode与fallbackByMode的分发而不是在其他模块里复制粘贴一套新的清洗器模式化清洗倾向于为每个模式提供专属的 prompt 与清洗行为避免在无关模块中重复实现。小结packages/web/server/lib/text是 OpenChamber 服务端一条轻量但职责清晰的共享文本管线对外提供summarizeText这一 API 兼容的摘要入口内部以三种模式分别驱动 TTS、通知与笔记三种出口的清洗与蒸馏回退在模型提供商不可用期间它以完全本地、可测试、行为明确的方式保证了所有调用方的文本输出质量。理解这个模块有助于你在接入 TTS、通知或记忆笔记功能时正确选择清洗模式并准确解读summarized: false与reason字段所表达的回退语义。赞分享AI Agent人工智能代码智能体交互助手【免费下载链接】openchamberAgentic Development Environment based on OpenCode AI agent项目地址https://gitcode.com/gh_mirrors/op/openchamber点击查看免费下载相关推荐用 PocketFlow Node 构建带重试与回退机制的 LLM 文本摘要工具用 PocketFlow Node 构建带重试与回退机制的 LLM 文本摘要工具 本文围绕 Pocket Flow 仓库中 cookbook/pocketflo人工智能大模型AI Agent工作流自动化RAGLangchain-Chatchat 文档块摘要机制深度解析SummaryAdapter 与 MapReduce 摘要流水线实战Langchain Chatchat 文档块摘要机制深度解析SummaryAdapter 与 MapReduce 摘要流水线实战 在基于 Langchain桌面应用跨平台workerd 模块回退机制实战指南用 moduleFallback 动态解析 Worker 模块workerd 模块回退机制实战指南用 moduleFallback 动态解析 Worker 模块 导读 workerd 是支撑 Cloudflare Wor后端语言运行时WebAssembly上一篇FSNotes终极指南简单高效的跨平台笔记管理解决方案下一篇如何用Power Apps扩展Tailwind Traders业务流程零代码开发教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考