Lapin Tools

Lapin Tools is a personal VS Code extension written using OpenAI Codex.

Lapin Tools 是使用 OpenAI Codex 编写的个人 VS Code 辅助扩展。 这是一个独立的个人项目，维护以作者的实际工作流为主。

它合并了运行按钮和 LaTeX PDF 预览辅助功能：

• 当前文件配置了 Code Runner 运行方式时，显示“Run Code”按钮。实际运行仍由 Code Runner 执行；按钮不检查编译器或解释器是否已经安装。
• LaTeX 编译成功后，在源码右侧自动打开尚未打开的 PDF，并保持当前焦点。已有预览交由 LaTeX Workshop 正常刷新，保留窗口及阅读位置；隐藏的 PDF 标签页也不会被强行切到前台。
• 隐藏自动编译的错误和警告弹窗，保留手动编译提示。被隐藏的提示写入“Lapin Tools”输出日志。

设置

这些设置修改后立即生效。关闭运行按钮功能会隐藏本扩展的按钮，Code Runner 自带的快捷键和菜单仍可使用。 关闭 LaTeX 总开关时，即使两个旧设置为 true，也不再自动打开 PDF 或隐藏弹窗。

安装与自动更新

需要 Code Runner 和 LaTeX Workshop。继续保留用户设置 code-runner.showRunIconInEditorTitleMenu: false，避免出现重复的运行按钮。

从 VS Code 扩展商店安装 Lapin Tools，发布者为 ljxlapin，扩展标识为 ljxlapin.lapin-tools。在本扩展的菜单中启用“自动更新”。以后更新由 VS Code 的商店机制提供，不需要另外安装更新检查程序。

如果以前通过 VSIX 手动安装，需先迁移到商店发行版，再检查本扩展的“自动更新”是否开启。VSIX 安装默认关闭自动更新。

从两个旧扩展迁移时，卸载旧的 Code Runner Button Visibility 和 LaTeX Auto PDF Preview，再重新加载窗口。如果以前安装的 Lapin Tools 本地版与商店版的发布者不同，也应停用或卸载旧的本地版。不要同时启用新旧扩展。 原命令 code-runner-visibility.run 和原 LaTeX 设置名称保留，已有快捷键和配置无需更名。

在 Remote-SSH 窗口中，本扩展应安装在工作区所在的远程电脑上，与 LaTeX Workshop 在同一扩展环境运行。 编辑本地文件时，需要在当前电脑的本地 VS Code 安装；通过 Remote-SSH 编辑远程文件时，需要在远程端安装。两处的更新状态分别检查。

兼容性与维护范围

LaTeX 功能沿用对 LaTeX Workshop 内部运行模块的集成；Workshop 更新后需要重新验证兼容性。 两部分独立初始化、记录错误，但声明的两个依赖都必须可用，VS Code 才能正常激活扩展。

已测试的环境：

安装包采用通用平台格式；macOS 尚未实际验证。当前测试覆盖代码运行、成功编译后打开 PDF、编译期间切换焦点和保留预览位置、自动和手动报错的区分，以及功能开关。

Lapin Tools 不添加使用情况遥测。诊断消息写入本地的“Lapin Tools”输出日志，可能包含正在处理的文件名或路径。

旧版本与许可证

保留原设置名称，便于迁移或回退。许可证为 MIT，见随安装包提供的 LICENSE。