5.2 KiB

Raw Blame History

Phase 7: 发送时拼接附件与Skill优先提示词并在消息区过滤 - Context

Gathered: 2026-04-17 Status: Ready for planning

## Phase Boundary

在用户发送消息时，将“附件/引用文件 + 已选 Skill”转换为一段附加指令并拼接到提交给后端的提示词中；同时保证消息区仍只展示用户原始输入，不展示这段拼接指令。

本阶段不新增新的消息协议主结构，不改变现有 additional_kwargs.files 的来源语义，只在发送链路中补充“提交态提示词增强”。

## Implementation Decisions

拼接文案规则

D-01: 统一使用格式：优先使用【附件1、附件2】和【Skill1、Skill2】。
D-02: 仅存在一类时只输出该类（仅附件或仅 Skill），两类都为空时不拼接。
D-03: 名称去重后再拼接，顺序固定为“附件 → Skill”。

拼接时机与作用域

D-04: 仅在真正提交到后端前拼接，不改输入框内文本。
D-05: 覆盖所有发送入口：发送按钮、回车发送、建议词自动发送。

消息区过滤策略

D-06: 采用“提交态增强、展示态原文”策略： UI 和消息区始终使用用户原文；仅请求 payload 使用“原文 + 拼接文案”。
D-07: 不采用渲染层二次过滤（避免把拼接后文本写入消息主内容）。

数据来源与去重口径

D-08: 附件名使用最终提交文件名（references + uploads 汇总后的文件名）。
D-09: Skill 名使用当前选中 Skill tag 的 title。
D-10: 去重采用大小写不敏感规则。

the agent's Discretion

拼接文案中附件与 Skill 的最大展示数量（若过长时是否截断与“等N项”策略）。
“名称标准化”细节（如首尾空白裁剪、重复空格折叠）。
内部 helper 命名与模块拆分方式（前提是不改变已锁定行为）。

<canonical_refs>

Canonical References

Downstream agents MUST read these before planning or implementing.

阶段边界与既有决策

.planning/ROADMAP.md — Phase 7 条目与边界（发送时拼接 + 消息区不显示）。
.planning/STATE.md — 当前里程碑状态与 Phase 7 演进记录。
.planning/PROJECT.md — 核心原则：保持现有体验并稳定新系统行为。
.planning/REQUIREMENTS.md — 现有约束基线（特别是稳定性与回归要求）。
.planning/phases/06-/06-CONTEXT.md — Phase 6 已锁定的文件引用/提交语义（additional_kwargs.files）。

发送链路与输入框集成点

frontend/src/components/workspace/input-box.tsx — 输入框提交入口（handleSubmit）与 references/selectedSkills 来源。
frontend/src/app/workspace/chats/[thread_id]/page.tsx — 页面级 handleSubmit 到 sendMessage 的调用边界。
frontend/src/core/threads/hooks.ts — 实际提交到线程流的发送逻辑（payload 组装主入口）。
frontend/src/components/ai-elements/prompt-input.tsx — PromptInputMessage 结构与表单提交机制。

消息展示与文件渲染链路

frontend/src/components/workspace/messages/message-list-item.tsx — 人类消息展示内容与附件列表渲染逻辑。
frontend/src/core/threads/submit-files.ts — references/uploads 汇总为 additional_kwargs.files 的归一化逻辑。

</canonical_refs>

<code_context>

Existing Code Insights

Reusable Assets

InputBox.handleSubmit 已是发送前最后一层前端聚合点，可在此构建“提交态增强文案”。
useThreadStream.sendMessage 已集中处理 payload 发送，可作为最终拼接注入点。
PromptInputMessage 与 message.references 已具备附件/引用上下文，不需要新增输入结构。
useIframeSkill 暴露 selectedSkills（含 title），可直接提供 Skill 名来源。

Established Patterns

文件信息通过 additional_kwargs.files 单一 envelope 传递，消息正文与文件元数据分离。
人类消息展示默认使用 rawContent（并对 <uploaded_files> 标签做兼容剥离），适合维持“展示态原文”。
错误处理采用软失败 + toast，不阻断主发送链路。

Integration Points

入口：input-box.tsx 的 handleSubmit（拿到原文、references、selectedSkills）。
提交：core/threads/hooks.ts 的 sendMessage（对后端 payload 的最终写入点）。
展示：message-list-item.tsx（保持仅展示用户原文，不反显拼接提示）。

</code_context>

## Specific Ideas

拼接模板固定为：优先使用【附件...】和【Skill...】，并按“附件→Skill”顺序输出。
覆盖建议词自动发送路径，避免不同发送入口行为不一致。
消息区不做“后置过滤黑科技”，而是从源头保证展示内容就是原文。

## Deferred Ideas

按模型能力动态调整拼接策略（如不同模型使用不同提示语模板）。
将“优先使用”文案国际化为多语言可配置模板。
在 UI 中显式展示“将附加系统提示”的可见开关。

Phase: 07-phase-06-mention-upload Context gathered: 2026-04-17

5.2 KiB Raw Blame History Unescape Escape