Yar's DeepSeek Copilot
EnglishEspañol中文
DeepSeek Platform

用户手册

配置 API key，选择权限模式，然后从侧边栏使用 DeepSeek，并明确控制每一项工作区操作。

开始使用

  • 从 Activity Bar 打开 Yar's DeepSeek Copilot，并在 Settings 中输入 API key。凭据按规范化 API 来源存储在 VS Code Secret Storage 中；重新打开 Settings 时只会显示遮罩占位符预览。
  • 选择 V4 Vision (Flash) 或 V4 Pro、thinking mode、reasoning effort、输出预留和并发上限。已注册的 V4 能力使用 1M Token 总上下文和 384K 最大输出；扩展默认预留 8,192 个输出 Token。默认并发数为 8，可设置为 1 到 16。
  • 输入 ./ 可自动补全安全的工作区路径；始终拒绝 ../ 父目录遍历。多根工作区路径以稳定别名开头，例如 ./frontend/src/App.tsx。
  • 使用统一的 + 操作或资源管理器/编辑器命令添加上下文。普通外部文件会成为受限只读快照；图像会在验证二进制签名后上传到 DeepSeek。
  • 使用 Stop generation 可取消当前请求和终端进程树。已提交提示、部分 timeline 和已完成工具结果会作为 cancelled 轮次保留；已发生的外部副作用不会回滚。

图像与视觉

  • 同一选择器支持上下文文件以及最多八张 JPEG、PNG、GIF 或 WebP 图像。也可使用 Ctrl+V 或 Cmd+V 粘贴；剪贴板图像限制为 16 MiB，选择器图像遵循 DeepSeek 的 64 MiB 限制。
  • V4 Vision (Flash) 直接接收 DeepSeek file ID。只有当前提示包含图像时，V4 Pro 才会获得 analyze_images；该工具让 Vision 返回可供 Pro 阅读的受限文本描述。
  • 如果官方 API 上的实验性 Vision 不可用，纯文本工作会使用稳定 V4 Flash 重试一次。直接图像聊天会移除图像并说明限制；V4 Pro 图像分析会显式失败，避免把纯文本模型误认为具有视觉能力。
  • 上传使用 DeepSeek Files API、purpose user_data 和 30 天到期时间。Base64 仅用于临时剪贴板 IPC，绝不会进入历史记录或提供商消息。
  • 移除草稿图像会尝试删除本地和远程资源。永久删除会话时，只有撤销窗口结束后才清理图像。

并发生成和队列

  • 每个会话同一时间只运行一个生成任务。该会话中的其他提示会按提交顺序排队。
  • 不同会话可以并发生成，直到达到配置的全局上限。
  • 响应进行期间只显示一个按钮：草稿为空时为 Stop，有内容时为 Guide。Enter 会重启传输并按新指导继续同一任务；按住 Ctrl 时按钮变为 Queue，Ctrl+Enter 会将独立草稿排到当前响应之后；Shift+Enter 插入换行。
  • 切换会话或重新创建 webview 不会让流式或工具事件串到其他任务；每个事件都绑定到其生成任务和会话。
  • 如果 VS Code 关闭，部分输出会恢复为 interrupted，未完成的工具会变为 cancelled，排队提示会在下次激活时作为可恢复草稿提供。

权限和工具状态

  • default 会确认每个工具；auto-approve 可在任何位置自动执行常规操作，并确认提权或关键操作；full-access 可在任何位置自动执行常规和提权操作，只确认可能导致计算机无法使用或造成大范围不可逆损失的关键操作。
  • 不再提供逐工具权限矩阵。关闭 Web 搜索开关后，模型请求中不会包含 search_web 和 read_web。工作区绑定和 VS Code Workspace Trust 仍然生效。
  • 工具调用依次经过 awaiting confirmation、running，并最终进入 completed、rejected、cancelled 或 error 中的一种状态。
  • 扩展宿主会先确认执行或拒绝操作，然后 webview 才会提交可见状态。
  • 同一轮内的工具调用按顺序执行。相同调用会被跳过，直到工作区修改使合理的重复调用变得有用。工具循环没有可配置的轮次或每块调用上限；独立审查器会在完成 20 轮后检查进度，此后每五轮再次检查，且不会禁用工具。
  • 只读工具可以跨并发会话运行，而文件和终端变更在同一工作区内按顺序执行。

活动和文件结果

  • 相邻的推理和工具调用默认折叠在 Activity 面板中。展开后可检查各个推理步骤、工具状态、参数和相关结果。
  • 会话用量会显示在权限选择器旁的紧凑弹出面板中；切换模型后还会按模型汇总。如果部分 DeepSeek 请求省略用量，已报告的请求仍会生成明确标记的最低费用。
  • 成功的 read_file 不会在聊天中重复文件正文。可使用 Open file 在编辑器中查看；读取失败时仍会显示诊断结果。
  • 完成的 create_file、edit_file 和 apply_patch 在拥有完整 diff 时会提供 View change。它会打开该次工具执行记录的前后内容，不受之后工作树变更影响。

工作区内容搜索

  • search_content 通过 VS Code 工作区文件系统执行不区分大小写的字面文本搜索；它不会运行 shell，也不会将查询解释为正则表达式。查询必须包含文本，且最多为 4,096 个字符。
  • 可选的 filePattern 是工作区相对 glob，例如 *.ts 或 src/**/*.md。其默认值为 **/*，最多为 1,024 个字符，并拒绝绝对路径和父目录遍历。
  • 敏感路径、二进制文件和大于 2 MiB 的文件会被跳过。敏感文件在读取内容前就会被过滤。
  • 每次搜索最多检查 10,000 个文件并返回 50 个匹配项。结果行和总输出均有上限，响应还会报告已扫描文件数、已跳过文件数以及是否发生截断。
  • 请求取消时搜索会停止，并在 15 秒后超时。

网页搜索

  • 启用网页搜索时，扩展会管理默认的 http://127.0.0.1:8888 端点。首次启动会下载当前平台对应的固定 SearXNG 运行时，验证预期大小和 SHA-256 摘要，并且只在 loopback 上运行；无需系统 Python、Docker、Podman 或 Chromium。
  • Settings 会加载已配置实例的引擎目录。保持自动选择时使用实例默认值；手动选择引擎后，每次搜索都会发送经过验证的快捷名称。
  • 也可以配置兼容的自定义 SearXNG 端点。非 loopback 端点必须使用 HTTPS，并且拒绝包含凭据的 URL。
  • search_web 最多返回十个规范化 HTTPS 结果。read_web 只接受该搜索已登记或用户明确提供的 URL，然后提取有界、惰性的页面分段。

终端执行

  • 每个代理命令都会通过 Shell Integration 在专用 VS Code 集成终端中以非交互、可见方式运行。命令完成后终端会关闭，捕获的结果仍保留在聊天中。
  • 结果会记录有界 stdout/stderr、退出码、信号、超时、取消状态、实际工作目录和 shell。
  • 输出有大小限制；发生截断时会保留开头和结尾，并标记被省略的中间部分。
  • 系统会拒绝分离式或后台进程启动器。代理终端会禁用 .NET 构建服务器与节点复用，避免在构建完成后留下孤儿 worker 或锁定项目文件。
  • 在自动模式下，独立的 DeepSeek 实例会将终端命令和文件修改分类为常规、提权或关键；不再使用本地危险分析器。
  • 审查器接收初始用户请求、不含内容的操作说明、机械范围事实，以及显式命名且非敏感工作区文件的受限上下文。
  • 审查器可以批准、返回重新规划约束或要求手动确认。auto-approve 确认提权和关键操作；full-access 确认关键操作。自动决策至少需要 medium-high 置信度。

历史记录和隐私

  • 设置保存在 ~/.yrs-dpsk-copilot/settings.json 中。API 凭据按规范化来源隔离保存在 VS Code Secret Storage 中，绝不会进入 WebviewConfig、历史记录或 checkpoint。
  • 历史记录以每个会话一个 JSON 文件的形式全局保存在 ~/.yrs-dpsk-copilot/history/ 中，每条记录都会显示其来源工作区。
  • 可以禁用历史记录，也可以将保留期设为 0 天（仅手动删除）到 3650 天；默认值为 30 天。
  • 禁用历史记录会进入无痕模式。如果存在活动生成或排队消息，停止并清空前会要求确认。无痕聊天仅保留在内存中，在聊天、历史记录和设置之间切换时不会丢失，但重新加载扩展或 VS Code 时会被丢弃。退出时可以明确保存为新会话或直接丢弃。
  • 历史列表直接从经过验证的会话文件重建。存储上限为 100 个会话和 24 MiB。
  • 删除单个会话或所有可见会话时会使用 VS Code 原生确认，并提供撤销。删除前先取消活动任务并清空队列和 checkpoint；图像资源会等撤销窗口结束后再清理，以便完整恢复。
  • 会话文件必须使用 schema version 2，并包含完整的工作区绑定和当前格式的上下文摘要。激活时，所有不兼容、格式错误、过大或文件名不匹配的历史文件及其消息分段都会被永久删除，不再尝试旧版迁移。
  • 活动任务的 checkpoint 保存在 ~/.yrs-dpsk-copilot/generation-checkpoints/ 下，且不包含 API key。中断时处于 pending 或 running 的工具会恢复为 cancelled；仅恢复包含完整工作区绑定的 schema-3 checkpoint，不兼容记录会被删除。

上下文和斜杠命令

  • 自动上下文会在时间和大小限制内包含当前编辑器以及 Git 的 staged 和 unstaged 更改。
  • 引用文件和 AGENTS.md 指令有大小限制，使用工作区相对标签，并作为不受信任的数据进行分隔。
  • 总请求预算包含系统提示、工具 schema、历史记录、引用内容、预留输出和安全余量。较旧的完整生成会按原子轮次摘要，大文件只保留与请求相关的原始行范围；工具参数、协议所需推理和活动工具周期绝不会被截断。
  • 使用 /context 可检查普通请求将发送的内容。其他命令包括 /status、/tools、/mode、/auto-context、/review、/goal、/summarize 和 /clear-context。