在 CodeFree 中打开

在 VSCode 资源管理器右键菜单、编辑器标签右键菜单、命令面板和状态栏中添加“在 CodeFree 中打开”入口，一键在新终端窗口中启动 CodeFree-O CLI，并自动切换到所选目录。

功能

• 在此打开 CodeFree：在右键选中的文件夹（或文件所在目录）中启动 CodeFree-O CLI。可在资源管理器右键、编辑器右键、命令面板触发。开启 open-co.copyRelativePathOnHere 后自动复制相对于打开目录的相对路径。
• 在根路径打开 CodeFree：在当前工作区根目录中启动 CodeFree-O CLI；开启 open-co.copyRelativePathOnRoot 后，自动将右键选中文件（或当前编辑器聚焦文件）的相对路径复制到剪贴板。可在资源管理器右键、编辑器右键、命令面板、状态栏按钮触发。
• 复制相对路径：独立命令，将右键选中文件（或当前编辑器打开的文件）的相对路径复制到剪贴板，以 / 分隔。仅在命令面板触发（不占用右键菜单）。
• 状态栏按钮：左下角显示 $(terminal) CodeFree 按钮，点击在工作区根目录打开 CodeFree。
• 多根工作区支持：右键文件时以其所属 folder 为根；从命令面板调用且无选中文件时，弹出 QuickPick 让用户选择 folder。
• 跨平台终端选择：Windows/macOS/Linux 均可配置使用的终端。
• 命令存在性检查结果缓存，避免每次启动都同步探测；启动报错或配置变更时自动重置缓存。

前置要求

• 已安装 CodeFree-O CLI，且 codefree-o 命令位于系统 PATH 中。
• 在终端中执行 codefree-o --version 能正常输出版本号即表示配置成功。

使用方法

1. 在 VSCode 资源管理器中右键单击文件夹或文件，或在编辑器标签上右键，或打开命令面板（Ctrl+Shift+P），或点击状态栏 CodeFree 按钮。
2. 选择 在此打开 CodeFree / 在根路径打开 CodeFree / 复制相对路径。
3. 打开 CodeFree 命令将启动一个新的终端窗口并执行配置的命令；复制相对路径命令将路径写入剪贴板并弹出提示。

平台行为说明

Linux 设为 auto 时自动探测，探测失败回退到 VSCode 集成终端。

命令

所有命令均可在 VSCode 的 Keyboard Shortcuts 中自定义快捷键。

配置项