SuperAPI AI 工具集

editor-context

编程与开发

查看项目

更新于 10-16 06:57

技能介绍

用途

editor-context 用于弥合终端 AI 工具与 IDE 编辑器之间的信息鸿沟。当用户在终端中向 AI 提问,但问题涉及当前在 IDE 中打开或选中的代码时,AI 往往缺少必要的上下文。该技能通过调用 one-ide-cli 命令,自动获取当前编辑器的状态,使 AI 的回答能够基于用户实际打开的文件和选中的代码,而不是凭空推测。

主要能力

该技能能够检测并返回以下编辑器上下文信息:

  • activeProject:当前活动项目的绝对路径。
  • activeFile:当前聚焦文件的绝对路径,若无文件打开则为 null。
  • activeSelection:选中文本的行列范围,包含 startLine、startColumn、endLine、endColumn,若无选中则为 null。
  • openedFiles:所有已打开的编辑器标签页路径数组,若无则为空数组。
  • activeFileText:活动文件的完整内容,若无文件打开则为 null。
  • activeSelectionText:选中的文本内容,若无选中则为 null。

此外,one-ide-cli 还提供其他命令:

  • one-ide-cli active-project:获取活动项目的工作区根目录。
  • one-ide-cli active-file <project-path>:获取指定项目中的活动文件。
  • one-ide-cli opened-files <project-path>:获取指定项目中所有打开的文件(JSON 数组)。
  • one-ide-cli ide:获取当前活动 IDE 的名称(如 VSCode、IntelliJ IDEA)。
  • one-ide-cli --help:查看帮助信息。

使用方式

检测当前编辑器上下文的基本命令为:

one-ide-cli context /path/to/current/workspace

激活时机:

  • 在新会话的首次编码回合中始终运行——在回答之前获取上下文,使回答基于用户实际打开的内容。
  • 当问题与代码相关且活动文件未知时也应激活。触发短语包括:
    • 显式:“this file”“current file”“selected code”“what I have open”
    • 隐式:“this”“that”“it”“this field”“this function”“this class”“what does this mean”“explain this”“why is this”

跳过时机:

  • AI 已经在上下文中拥有文件内容或路径(例如用户直接粘贴了代码)。
  • 问题明确仅涉及粘贴的内容,没有歧义。

输出示例:

{
  "activeProject": "/Users/you/project",
  "activeFile": "/Users/you/project/src/main.ts",
  "activeSelection": {
    "startLine": 10,
    "startColumn": 0,
    "endLine": 20,
    "endColumn": 5
  },
  "openedFiles": [
    "/Users/you/project/src/main.ts",
    "/Users/you/project/src/utils.ts"
  ],
  "activeFileText": "...full file content...",
  "activeSelectionText": "...selected text..."
}

适用场景

该技能适用于任何安装了 One-IDE 插件的 IDE,包括 VS Code、Cursor、Windsurf、JetBrains IDEs(IntelliJ、WebStorm、PyCharm 等)及其分支。典型使用场景包括:

  • 用户在终端 AI 工具中提问“解释这个函数”,但未提供代码,AI 可通过该技能获取当前选中的函数代码。
  • 用户询问“这个文件有什么问题”,AI 可获取活动文件全文进行分析。
  • 用户提到“当前打开的项目”,AI 可获取项目路径和已打开文件列表。

限制

  • 需要安装 One-IDE 插件,且 IDE 需在支持列表中。
  • 需要安装 one-ide-cli 命令行工具,若未找到可通过 npm install -g one-ide-cli 安装。
  • 若没有打开的文件或没有选中文本,相关字段返回 null 或空数组。
  • 该技能仅提供编辑器上下文信息,不包含代码分析、修改或执行功能。
  • 具体支持的 IDE 版本、插件安装方式等细节暂未提供。