用途
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 版本、插件安装方式等细节暂未提供。