111 lines
5.2 KiB
Markdown
111 lines
5.2 KiB
Markdown
# Phase 7: 发送时拼接附件与Skill优先提示词并在消息区过滤 - Context
|
||
|
||
**Gathered:** 2026-04-17
|
||
**Status:** Ready for planning
|
||
|
||
<domain>
|
||
## Phase Boundary
|
||
|
||
在用户发送消息时，将“附件/引用文件 + 已选 Skill”转换为一段附加指令并拼接到提交给后端的提示词中；同时保证消息区仍只展示用户原始输入，不展示这段拼接指令。
|
||
|
||
本阶段不新增新的消息协议主结构，不改变现有 `additional_kwargs.files` 的来源语义，只在发送链路中补充“提交态提示词增强”。
|
||
|
||
</domain>
|
||
|
||
<decisions>
|
||
## 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 命名与模块拆分方式（前提是不改变已锁定行为）。
|
||
|
||
</decisions>
|
||
|
||
<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>
|
||
|
||
<specifics>
|
||
## Specific Ideas
|
||
|
||
- 拼接模板固定为：`优先使用【附件...】和【Skill...】`，并按“附件→Skill”顺序输出。
|
||
- 覆盖建议词自动发送路径，避免不同发送入口行为不一致。
|
||
- 消息区不做“后置过滤黑科技”，而是从源头保证展示内容就是原文。
|
||
|
||
</specifics>
|
||
|
||
<deferred>
|
||
## Deferred Ideas
|
||
|
||
- 按模型能力动态调整拼接策略（如不同模型使用不同提示语模板）。
|
||
- 将“优先使用”文案国际化为多语言可配置模板。
|
||
- 在 UI 中显式展示“将附加系统提示”的可见开关。
|
||
|
||
</deferred>
|
||
|
||
---
|
||
|
||
*Phase: 07-phase-06-mention-upload*
|
||
*Context gathered: 2026-04-17*
|