OpenSquilla 🦐

简体中文 | English

Visual Studio Code 里的 AI 编码智能体：聊天面板、原生 Diff 审阅、 工作区感知上下文，以及可配置模型路由的托管本地后端。

OpenSquilla 官方 Visual Studio Code 插件，由 TokenRhythm 发布。

当前版本：0.1.9 · 查看完整功能说明、平台支持与已知限制

简体中文

扩展开箱即用：它会在你的本机启动一个捆绑的伴侣进程，仅绑定环回地址 （loopback），并以每次启动生成的高熵凭据保护——无需单独安装 CLI，也无需 配置任何额外服务。

界面默认使用中文。将 opensquilla-agent.language 设置为 en 可切换到英文（聊天 界面、通知与快速选择的文案）；命令面板中的命令标题则跟随 VS Code 的显示 语言。

功能

• 聊天面板：侧边栏与编辑器区域中的专用聊天视图——让它写新代码、解释 代码、修 Bug 或做多文件修改。
• 原生 Diff 审阅：在 VS Code 内置 Diff 编辑器中审阅、编辑并采纳智能体 提出的修改。
• 代码比较与单文件恢复：当一轮产生可展示的文件修改时，显示不依赖 Git 的文件清单、增删行统计和修改前后 Diff。普通 UTF-8 修改文件可把旧内容载入 未保存的编辑器；不提供批量或直接磁盘撤销。
• 模型路由：在 Direct 单模型、Router 自动路由和 Ensemble 多模型集成间 切换；新安装默认使用 Router，Direct 默认模型为 glm-5.3。
• 文件与选区上下文：默认加载当前文件或选区，并支持 @ 提及工作区 文件。
• 执行与安全模式：任务固定使用执行模式；安全模式提供完全访问和风险操作 人工确认两种选择。
• 会话历史与多会话：回看历史会话，并排运行多个会话；同一会话繁忙时可 选择排队或立即引导。
• 通知：面板隐藏时，任务完成或需要你关注可选标签圆点提示与声音通知。

图片粘贴、预览和历史显示已经存在，但 0.1.9 生产 Gateway 尚不会把图片 内容发送给模型。

0.1.9 已知问题

Windows 全量验收仍在进行，以下问题已复现，尚未修复：

• 重载窗口可能丢失尚未执行的排队消息。
• 执行 VS Code 的“Restart Extension Host”后，已有编辑器聊天页可能无法发送消息；执行“Reload Window”可恢复。伴侣进程单独重启已通过重连验证。

本次已修复并通过 Windows 实机回归：键盘拒绝审批误触发允许、长安装路径下的后端和模板加载、相对 .txt 链接、模型菜单 Escape 误取消回复、中文斜杠命令补全，以及图片粘贴错误提示和多文件粘贴。

环境要求

• Visual Studio Code 1.96.0 或更新版本。
• 受信任的本地工作区。由于智能体会执行命令并编辑文件，扩展在受限模式 （Restricted Mode）与虚拟工作区中保持禁用。
• 一个 TokenRhythm API key。密钥仅保存在 VS Code Secret Storage 中，绝不 写入设置文件或日志。

快速开始

1. 在 VS Code Marketplace 搜索 tokenrhythm.opensquilla-coding-agent，或安装与平台匹配的 VSIX。
2. 打开聊天面板：点击活动栏或编辑器标题栏中的 🦐 虾图标，或在命令面板 （Ctrl+Shift+P / Cmd+Shift+P）运行 OpenSquilla: 打开。
3. 运行 OpenSquilla: 认证，输入 TokenRhythm API key 并选择模型。单独运行 OpenSquilla: 设置 TokenRhythm API Key只会保存 key，不代表远端验证 已经成功。
4. 开始聊天。🦐

命令

命令标题跟随 VS Code 显示语言；下表为中文界面下的标题。

设置

安全说明

• 伴侣后端仅监听环回地址（127.0.0.1），并要求每次启动生成的高熵凭据；不向 网络暴露任何端口。
• 你的 API key 保存在 VS Code Secret Storage 中，仅在启动时注入捆绑 Gateway 的子进程环境——绝不写入设置文件、Webview 状态或日志。
• 每个扩展版本首次激活时，扩展会发送一次匿名装机事件，字段仅包括安装方式 （vscode）、扩展与捆绑 OpenSquilla 版本、操作系统、架构、随机持久化 UUID 和发送时间；绝不包含凭据、工作区路径、文件名、代码、Prompt 或会话 内容。捆绑后端自身的装机遥测和更新检查仍保持关闭，以免重复上报。

卸载与本地数据

卸载扩展不保证清除 VS Code 保存的全部数据。同一 VS Code 用户配置下重新安装时， Secret Storage 中的密钥及部分全局设置可能恢复；会话历史也不应依赖卸载保留。 需要移除密钥时，请先运行 OpenSquilla: 清除 TokenRhythm API Key。 独立测试配置需要彻底清理时，应在关闭 VS Code 后另行删除该测试配置的数据目录。

许可

Apache-2.0。本扩展衍生自以 Apache-2.0 许可发布的 qwen-code IDE 伴侣，并捆绑了同为 Apache-2.0 许可的 OpenSquilla 后端（名称与 Logo 亦来源于它）；第三方许可 信息见捆绑的 NOTICES 文件。本扩展是由 TokenRhythm 发布的 OpenSquilla 官方 VS Code 插件，与 Qwen 团队无隶属或背书关系。

English

An AI coding agent for Visual Studio Code: a chat panel with native diff review, workspace-aware context, and a managed local backend with configurable model routing.

The official OpenSquilla extension for Visual Studio Code, published by TokenRhythm.

Current version: 0.1.9. See the complete Chinese feature reference for platform support, detailed behavior, and known limitations.

The extension ships with everything it needs. It launches a bundled companion process on your machine, bound to loopback only and protected by per-launch credentials — no separate CLI install and no extra services to configure.

The product UI defaults to Chinese. Set opensquilla-agent.language to en to switch the chat UI, notifications, and quick picks to English; Command Palette titles follow the VS Code display language.

Features

• Chat panel: A dedicated chat view in the sidebar and editor area — ask for new code, explanations, bug fixes, or multi-file changes.
• Native diff review: Review, edit, and accept the agent's proposed changes in VS Code's built-in diff editor.
• Code comparison and single-file restore: Review a Git-independent file list, line statistics, and before/after diffs. Modified UTF-8 files can load their old content into an unsaved editor while Auto Save is off. Bulk and direct-disk revert are not provided.
• Model routing: Switch between Direct, Router, and Ensemble. New installs default to Router; Direct defaults to glm-5.3.
• File and selection context: Automatically include the active file or selection and @-mention workspace files.
• Execution and safety modes: Tasks use execution mode. Choose full access or explicit confirmation for risky operations.
• Conversation history & multiple sessions: Revisit past conversations and run several sessions side by side; queue or steer a follow-up while a session is busy.
• Notifications: Optional tab-dot indicator and sound notifications when a task finishes or needs your attention while the panel is hidden.

Image paste, preview, and history UI exists, but the 0.1.9 production Gateway does not yet send image content to the model.

Known issues in 0.1.9

Full Windows acceptance testing is still in progress. These reproduced issues remain open:

• Reloading can lose queued messages that have not started.
• After VS Code's “Restart Extension Host”, existing editor chat tabs may stop sending messages. Use “Reload Window” to recover. Reconnection after restarting only the companion process has passed verification.

Fixes verified in the Windows UI include keyboard denial of approvals, backend and template loading under long installation paths, relative .txt links, Escape in the model menu, Chinese slash completion, visible image-paste errors, and multi-file clipboard handling.

Requirements

• Visual Studio Code 1.96.0 or newer.
• A trusted, local workspace. The extension stays disabled in Restricted Mode and in virtual workspaces, because the agent runs commands and edits files.
• A TokenRhythm API key. The key is stored in VS Code Secret Storage only and never written to settings files or logs.

Quick Start

1. Find tokenrhythm.opensquilla-coding-agent in the VS Code Marketplace, or install the VSIX for your platform.
2. Open the chat panel: click the 🦐 shrimp icon in the activity bar or the editor title bar, or run OpenSquilla: Open from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
3. Run OpenSquilla: Auth, enter your TokenRhythm API key, and choose a model. OpenSquilla: Set TokenRhythm API Key only stores the key; it does not prove that the remote service has accepted it.
4. Start chatting. 🦐

Commands

Command titles follow the VS Code display language; the table below shows the English titles.

Settings

Security notes

• The companion backend listens on loopback (127.0.0.1) only and requires high-entropy per-launch credentials; nothing is exposed to the network.
• Your API key lives in VS Code Secret Storage and is injected only into the bundled Gateway subprocess environment at launch — never into settings files, webview state, or logs.
• On first activation of each extension version, the extension sends one anonymous installation event with the install method (vscode), extension and bundled OpenSquilla versions, OS, architecture, a random persisted UUID, and send time. It never includes credentials, workspace paths, file names, code, prompts, or conversations. The bundled backend's separate install telemetry and update check stay disabled to avoid duplicate reporting.

Uninstall and local data

Uninstalling does not guarantee removal of all data retained by VS Code. Reinstalling in the same VS Code user profile can restore the Secret Storage key and some global settings; do not rely on uninstall preserving conversation history. Run OpenSquilla: Clear TokenRhythm API Key before uninstalling to remove the key. To fully clean up an isolated test profile, close VS Code and separately remove that test profile's data directory.

License

Apache-2.0. This extension is derived from the Apache-2.0 licensed qwen-code IDE companion, and bundles — and takes its name and logo from — the Apache-2.0 licensed OpenSquilla backend; see the bundled NOTICES for third-party license information. This is the official OpenSquilla VS Code extension, published by TokenRhythm. It is not affiliated with or endorsed by the Qwen team.