Add to Terminal

一键将文件引用、选中代码行范围、编译报错信息发送到终端，专为 Claude Code CLI 工作流优化。

痛点分析

在使用 Claude Code 等终端 AI 编程工具时，最常见的操作是让 AI 帮你定位问题、修改代码、修复报错。但每次你都需要手动完成以下步骤：

1. 在编辑器或资源管理器中复制出问题的文件路径
2. 回到终端，粘贴路径
3. 回编辑器复制报错信息
4. 又回到终端粘贴上错误信息
5. 最后输入你的问题，回车

这个流程频繁打断编码思路，每次至少要花 10-20 秒手动拼接路径和行号，一天下来浪费大量时间。文件路径一长，还容易打错。

解决方案

Add to Terminal 让这一切一键完成。无论你在编辑器中、在文件资源管理器中、还是看到编译报错的红色波浪线，只需要一次点击或快捷键，文件引用和诊断信息就直接出现在终端输入框中——未执行，你可以继续补充问题描述，然后回车。

核心功能

📄 文件 + 行号引用

在编辑器中 右键 或按 Ctrl+Alt+T（Mac: Cmd+Alt+T），自动将当前文件路径和选中行范围发送到终端：

`src/extension.ts:42-58`

• 单行光标：`src/extension.ts:42`
• 多行选中：`src/extension.ts:42-58`
• 路径格式可配置（相对路径 / 绝对路径 / 仅文件名）

📁 资源管理器文件引用

在文件资源管理器中右键任意文件，一键将文件路径发送到终端：

`src/extension.ts`

支持多选文件，用逗号分隔：

`src/extension.ts`, `src/utils.ts`, `package.json`

🔴 报错信息一键添加

光标放在红色波浪线（编译错误）或黄色波浪线（警告）上，点击出现的💡灯泡图标（或 Ctrl+.），在 Quick Fix 菜单中点击 "Add to Terminal"：

`src/app.ts:42` error: Cannot find name 'foo'
`src/utils.ts:15` warning: Unused variable 'x'

这意味着你看到报错 → 点灯泡 → 点 Add to Terminal → 终端里直接有了 路径+行号+错误信息 → 输入你的问题 → 回车，Claude Code 立刻开始分析。

使用场景

发送到 DSH Web 输入框

除终端外，引用也可以直接投递到 DSH Web 页面的输入框草稿（不提交，你补一句话再回车）。

@src/app.ts:30-45
@src/app.ts:42 error: Cannot find name 'foo'

• 面板/状态栏会告诉你投给了哪个会话（例如 docs.10coding-demos · 线性代数讲义）；
• 路径：相对路径只在文件确实位于该 DSH 会话工作目录下时使用，否则自动退化为绝对路径；
• 多个引用换行分隔；
• 目标页面断开或没有输入框时，按 addToTerminal.fallbackToTerminal 自动回退到终端。

前置条件：DSH 侧安装 dsh-add-to-terminal 桥接插件（它会把自己的地址与令牌写到 <系统临时目录>/dsh-add-to-terminal/bridge.json，本扩展读取后零配置可用）。

只用终端也完全没问题。 没装桥接插件、没开 DSH Web、或者你自己点了「断开」，这三种情况下扩展不会弹失败提示：引用直接发给终端，状态栏只说一句「只发到终端」。DSH 只是多出来的一个投递目标，不是必需条件。

选择投递到哪个 DSH 页面

左侧资源管理器侧边栏里会多出一个 DSH 页面 区块，列出当前打开着 DSH Web 的标签页：

• 每行显示 工作区 · 标题（例如 docs.10coding-demos · 线性代数讲义）与状态；正在投递的那一行标为 当前目标 · 可写 并带插头图标；
• 单击一行 = 连接它：设为投递目标 → 立刻把当前选区投过去（行尾也有一个 🔌 行内按钮）；
• 目标按工作区记住，之后 Ctrl+Alt+T 一直投给它；
• 状态栏右下角显示 🔌 DSH: docs.10coding-demos · 线性代数讲义，点它弹出 Quick Pick 换目标或断开（命令面板：Add to Terminal: 选择 DSH 页面）；
• 区块标题栏有刷新按钮与一个断开按钮（⏏）；可见时每 3 秒自动刷新；
• 收到内容的那个浏览器标签页会把自己的标题前面加上 ● 闪 6 秒 —— 这是"内容进了哪个标签页"最可靠的提示（页面无法可靠地把浏览器窗口提到前台）。

只有"页面开着、且当前有输入框"的标签页才会出现在列表里（草稿存在页面侧，宿主写不了）；没有打开 DSH 时列表显示「只发到终端」，引用按 fallbackToTerminal 发给终端。

断开 DSH · 只发到终端

接好之后想彻底不投 DSH 了，有三个入口，效果一样：

断开后：忘记记住的目标、不再探测桥接（省掉每次投递的一次 HTTP），引用直接发终端，状态栏变成 $(terminal) 只发到终端。想连回来，点列表里任意一个 DSH 页面即可（断开状态按工作区记，不影响 addToTerminal.destination 设置）。

addToTerminal.dshFocus 默认关闭：浏览器判断"这个地址是否已经打开"是按完整 URL 比对的，带上锚点（#...）就会被当成新地址而多开一个标签页，所以默认不去动浏览器。确实想让浏览器打开/切到该地址时再手动打开它（此时只使用不含锚点的裸地址）。

快捷键

配置

想要原来的行为（一律发到终端）：把 addToTerminal.destination 设为 terminal。

安装

从 VS Code 插件市场安装（推荐）

1. 打开 VS Code，按 Ctrl+Shift+X 打开扩展面板
2. 搜索 "Add to Terminal"
3. 点击 Install 安装
4. 安装后自动启用，无需额外配置

或者直接访问：VS Code Marketplace - Add to Terminal

为什么用 Add to Terminal？

License

MIT