Skip to content
FunCoding

Search

Search docs, Skills and MCP

文件、附件与工作目录

为提示提供文件和图像,添加目录并区分直接 Shell 与模型调用。

This page has not been translated into English yet. The original Chinese version is shown below.

提供明确的文件上下文,比让智能体从整个仓库猜测目标更直接。CLI 支持文件提及、图片和 PDF 附件,也允许调整会话工作目录;这些操作仍受当前模型能力和权限控制。

提及代码文件

在提示中写 @ 加相对路径,例如:

Explain @config/ci/ci-required-checks.yml
Fix the bug in @src/app.js

文件内容会作为上下文加入提示。输入路径时,匹配项显示在输入框下方,使用方向键选择并按 Tab 补全。文件内容同样占用模型上下文,长会话可用上下文检查观察占用。

图片与 PDF

当前官方使用说明列出 JPEG(.jpg、.jpeg)、PNG、GIF、WEBP、PDF、HEIC、HEIF。必须选择支持图像输入的模型;功能面向所有 Copilot 套餐默认启用,无需额外的启用策略。

交互会话中可以用 @路径 引用文件,拖入附件,或从剪贴板粘贴图片。引用图片或 PDF 后,应在提示中说明希望检查什么,例如布局差异或错误信息,而不是只提供附件。

访问其他目录

任务需要修改工作目录以外的文件时,CLI 会请求访问相关目录。也可以主动添加:

/add-dir /path/to/directory

如果整个任务都应切换到另一个位置,可使用 /cwd 或别名 /cd:

/cwd /path/to/directory

添加可访问目录和切换当前工作目录不是同一操作。前者扩展可用位置,后者改变会话当前目录;具体批准范围见路径与 URL 权限。

直接运行 Shell

在输入前加 ! 会直接运行 Shell 命令,不调用模型。例如,用 !git status 检查本地改动。此时执行的是你输入的命令,不应把它当作自然语言问题期待模型解释。

若希望智能体分析命令结果并继续任务,应在主对话中明确说明需要的分析。需要不进入主会话的临时解释时,可以使用旁支提问,但 /ask 本身不能调用工具。