[Idea] 文件/Markdown 预览中选中文本 → 以「@路径:行号」精确引用插入输入框（官方内建 + 行级语法）

[shenxiuqiang]

需求概述

在文件 / Markdown 预览中选中一段文本后，一键把「精确位置」插入输入框：@路径:起始行-结束行 加上摘录内容，让 Agent 准确知道要改哪里。希望作为官方内建能力提供，并统一到现有的 @file 引用语法。

使用场景

1. 在右侧预览里读 Markdown / 代码，发现某处需要修改
2. 选中那几行 → 点击浮动「引用到输入框」
3. 输入框出现 @docs/plan.md:42-48 引用 chip（悬浮可查看摘录）
4. 补一句「把这段的三级标题改成二级」并发送
5. Agent 用 read 定位后直接 edit，零歧义

现状调研（避免重复造轮子）

社区已经验证了这类交互，但都是第三方插件，且集中在会话记录或完整工作台：

• dsh-quote-followup — native select-to-quote for DSH Web #5855 dsh-quote-followup：会话记录内选区引用 + 轮次溯源，已较成熟
• 选区引用与锚点批注：让 DeepSeek Harness 会话支持「引用 + 批注」 #1139 dsh-quote-annotate：选区引用 + 锚点批注（引用#N，可点击跳回原文并高亮）
• DSH｜DSH Workbench｜在 DeepSeek Harness Web 中查看文件与审查改动 #5577 dsh-workbench：文件树 + Markdown/代码预览，已支持 “Reference files, folders, and selected preview lines in the composer”，是功能上最接近本需求的实现
• dsh-file-explorer: 轻量级可扩展的 DSH Web 的文件浏览器插件：浏览工作区文件树、预览文件，支持通过插件扩展预览器。 #5921 dsh-file-explorer：文件预览（Markdown 渲染 + 行号），未明确支持引用回对话
• feat(web): 右侧栏 Markdown 预览与 Mermaid 图渲染 #6056：右侧栏 Markdown 预览 + Mermaid 图渲染的尝鲜补丁

官方侧：@deepseek-ai/dsh-client-ui-sidebar-documentpreview 是纯查看器——其 README 明确写着「模型体验：无」「用户在这里读到的东西永不进入模型请求」「预览而非编辑」，并且未包含在默认 bundle 中。

本需求的具体缺口（三点）

1. 官方内建：默认安装即可用，不必依赖第三方插件；
2. 行级精确引用语法：当前 @file 只传路径（dsh-file-reference README：「选择候选项不会读取或附加文件内容」），不支持 @path:12-20 或 @path#L12-L20；行号范围正是「准确告诉修改位置」的关键，也能与 edit 工具基于 old_string 的精确匹配形成互补；
3. 统一语义与推荐接口：选区引用应复用官方已有管线（ReferenceChipNode、inputTriggers、conversation.input），并明确官方推荐的插入路由（dsh-quote-followup — native select-to-quote for DSH Web #5855 评论区提到 session 作用域的 slash/input-insert-reference），避免社区实现各自 hack 编辑器内部字段（如 __lexicalEditor、_nodes）。

建议实现要点（供维护者参考）

• 预览 tab（内置文档预览，或 feat(web): 右侧栏 Markdown 预览与 Mermaid 图渲染 #6056 提出的 ui-sidebar-markdown）在文本选区上提供浮动动作；
• 通过 inputTriggers 注册一个 source，或经 conversation.input 插入原子引用 chip；
• 引用载荷建议包含：path、startLine、endLine、excerpt；
• 发送时序列化为 Markdown 引用块 + 行号锚点，例如先给 @docs/plan.md:42-48，再附原文块；
• 若维护者认为该能力更适合由插件承担，也希望能提供官方推荐的插入接口文档，便于社区统一实现。

价值

• 把「读预览 → 精确指位 → 让 Agent 改」闭环，减少来回确认，长文档 / 大文件尤其明显；
• 预览不再只是只读的查看器，而能成为精确的上下文来源；
• 与 @file / @session 引用形成一致的交互语言。

---

English TL;DR: Make the built-in file / Markdown preview support select → insert a line-precise @path:Lstart-Lend reference into the composer, reusing the official reference-chip pipeline, so the agent can target edits exactly. Community plugins (#5855, #1139, #5577) already validate the interaction on the transcript / a full workbench; this asks for the native, line-precise core version plus a documented insertion interface.