dsh-input-file-ref

5. 使用

1. 选定工作目录：会话需要有工作目录（cwd）。
2. 在输入框输入 @ → 弹出与输入框同宽的文件选择面板。
3. 顶层 = 浏览当前目录：直接看到当前目录的文件与子文件夹；点文件夹可逐级进入（.git、node_modules、target 等也会显示，可一级级往下选）。
4. 顶部搜索栏（也可直接在输入框 @ 后继续输入）：输入关键字即时递归搜索整个 cwd；默认只显示 50 条，多输入几个字符会显示更多（逐步放宽到 100 / 200 / 500）。
5. 返回上级：当前进入某文件夹时，列表顶部有"↑ 上级目录"，或按 Backspace 返回。
6. 用 ↑/↓ + Enter（或鼠标点击 📄 文件行）选择文件 → 保留 @ 并把文件相对全路径以普通文本回填进输入框（末尾一个空格），例如 @src/main.ts 。
7. 发送后，消息中带有所引用的相对路径，模型可用 fs 工具按该路径读取内容。
8. 删除/修改：回填的是普通文本，直接当作普通文字编辑或删除即可；末尾空格会让 @ 停止触发选择；可连续引用多个文件（每次输入空格 + @ 重新打开选择）。

未选择工作目录的会话：输入 @ 时面板显示"当前会话没有工作目录"提示，不会崩溃。搜索时 .git、node_modules、target 等目录里的文件不会出现（但可以逐级进入选择）。

7. 配置项

键	默认值	说明
trustedHosts	来自 webRuntime（loopback + LAN + --trusted-host）	浏览器信任围栏的非回环授权主机列表。
ignore	.git、node_modules、target、.venv 等（见下）	搜索模式下跳过的目录名列表（浏览下钻仍可进入）。默认忽略 .git、node_modules、.venv、venv、__pycache__、.next、.nuxt、dist、build、target、.idea、.vscode、.DS_Store。

ignore 可在组合层覆盖：在 cordis.patch.yml 的 config 下追加即可（默认已内置，通常无需改动）。