灵境 / Soul Bleach

中文说明

灵境（Soul Bleach）是一个 VS Code 侧边栏智能体插件。它可以和 OpenAI 兼容格式的大模型对话，并通过工具调用读取、查看或写入当前工作区中的文件。

当前支持千问、智谱和自定义 OpenAI-compatible Chat Completions 接口。

功能特性

• 在 VS Code Activity Bar 中打开独立的「灵境」侧边栏。
• 与 AI 助手进行流式对话。
• 支持让模型通过工具调用列出文件、搜索文件、搜索文本、分段读取文件和写入文件。
• 支持受限命令验证，例如编译、测试、lint 和只读 git 检查。
• Webview 重新加载后保留可见聊天记录。
• 支持停止正在生成的回复。
• 支持清空当前聊天记录。

使用要求

你需要准备一个兼容 OpenAI Chat Completions 格式的接口。如果接口需要鉴权，请填写 API Key；如果是无鉴权模型，可以留空。

千问默认接口地址：

https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

智谱默认接口地址：

https://api.z.ai/api/paas/v4/chat/completions

插件配置

插件提供以下 VS Code 设置项：

• soul-bleach.provider：模型服务商，可选 qwen、zhipu-open、zhipu-coding、zai、custom。
• soul-bleach.modelPreset：常用模型下拉框，可选跟随服务商、千问模型、glm-5.2、glm-5.2[1m]、glm-5.1、glm-5、glm-4.7、glm-4.7-flash 或自定义。
• soul-bleach.baseUrl：Chat Completions 完整接口地址。留空时使用 modelPreset 或 provider 的默认地址。
• soul-bleach.apiKey：API Key。填写后会作为 Authorization: Bearer ... 请求头发送；无鉴权模型可以留空。
• soul-bleach.model：自定义模型名称。留空时使用 modelPreset 或 provider 的默认模型；填写后会覆盖下拉框选择。

智谱配置示例

如果使用智谱官方接口：

1. 如果使用普通开放平台 Key，将 soul-bleach.provider 设置为 zhipu-open。
2. 如果使用 GLM Coding Plan Key，将 soul-bleach.provider 设置为 zhipu-coding。
3. 将 soul-bleach.modelPreset 设置为 glm-5.2 或 glm-4.7，也可以保持跟随服务商。
4. 填写 soul-bleach.apiKey。
5. soul-bleach.baseUrl 可以留空，插件会使用对应服务商默认地址。
6. soul-bleach.model 可以留空；如需其他支持 Function Calling 的 GLM 模型，再手动填写。

注意：插件里的 baseUrl 填的是完整请求地址，也就是包含 /chat/completions 的地址；这和 OpenAI SDK 示例中的 baseURL 根地址不是同一个概念。

目前公开文档中没有确认智谱存在 glm-4.8 模型；文档里出现的 4.8 多数是和 Claude Opus 4.8 的对比。插件因此没有内置 glm-4.8 预设，如需测试内部模型名，可以把 modelPreset 设为 custom 后手动填写 soul-bleach.model。

使用方式

1. 打开 VS Code 设置。
2. 搜索 soul-bleach。
3. 选择 soul-bleach.provider。
4. 选择 soul-bleach.modelPreset。
5. 按需填写 soul-bleach.apiKey、soul-bleach.baseUrl 和 soul-bleach.model。
6. 从 Activity Bar 打开「灵境」视图。
7. 输入问题，或让智能体查看当前工作区文件。

注意事项

智能体可以通过工具读取和写入当前工作区文件。请在保留生成结果前检查代码改动。

代码文件默认使用 search_text 定位关键行，再使用 read_file_with_line_numbers 分段读取片段，避免把大文件一次性放入模型上下文。

修改文件后，智能体会优先重新读取修改区域确认结果，并可使用受限的 run_command 执行 pnpm run compile、pnpm run lint、pnpm run test、git diff --stat 等验证命令。

当前聊天历史主要用于恢复侧边栏中可见的对话记录，暂未实现跨会话的长期模型记忆。

更新记录

0.0.10

增加搜索文件功能search_file

初始开发版本。

English

Soul Bleach, displayed as 灵境 in VS Code, is a sidebar assistant for chatting with an OpenAI-compatible model and letting it inspect or edit files in the current workspace.

The extension supports Qwen, Zhipu, and custom OpenAI-compatible Chat Completions endpoints.

Features

• Open a dedicated 灵境 assistant view from the VS Code Activity Bar.
• Chat with an AI assistant using streamed responses.
• Let the assistant list files, search files, search text, read file ranges, and write files through tool calls.
• Run restricted verification commands such as compile, test, lint, and read-only git checks.
• Preserve visible chat history while the webview is reloaded.
• Stop an in-progress response.
• Clear the current chat history.

Requirements

You need an OpenAI-compatible chat completions endpoint. If the endpoint requires authentication, set an API key. For unauthenticated internal endpoints, leave it empty.

The default Qwen endpoint is:

https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

The default Zhipu endpoint is:

https://api.z.ai/api/paas/v4/chat/completions

Extension Settings

This extension contributes the following settings:

• soul-bleach.provider: Model provider. Supported values are qwen, zhipu-open, zhipu-coding, zai, and custom.
• soul-bleach.modelPreset: Common model dropdown. Supported values include provider default, Qwen models, glm-5.2, glm-5.2[1m], glm-5.1, glm-5, glm-4.7, glm-4.7-flash, and custom.
• soul-bleach.baseUrl: Full Chat Completions endpoint. Leave it empty to use the selected model preset or provider default.
• soul-bleach.apiKey: Optional API key. When set, it is sent as the Authorization: Bearer ... request header. Leave it empty for unauthenticated internal endpoints.
• soul-bleach.model: Custom model name. Leave it empty to use the selected model preset or provider default. When set, it overrides the dropdown selection.

Zhipu Configuration

To use the official Zhipu API:

1. Use zhipu-open for a regular Zhipu Open Platform key.
2. Use zhipu-coding for a GLM Coding Plan key.
3. Set soul-bleach.modelPreset to glm-5.2 or glm-4.7, or keep provider default.
4. Fill in soul-bleach.apiKey.
5. Leave soul-bleach.baseUrl empty to use the built-in endpoint.
6. Leave soul-bleach.model empty, or set another GLM model that supports Function Calling.

Note: the extension expects a full request endpoint in baseUrl, including /chat/completions. This differs from the baseURL root used in OpenAI SDK examples.

No public Zhipu glm-4.8 model was confirmed in the current documentation. Mentions of 4.8 usually refer to Claude Opus 4.8 comparisons. Use the custom model field if you need to test an internal model name.

Usage

1. Open VS Code settings.
2. Search for soul-bleach.
3. Choose soul-bleach.provider.
4. Choose soul-bleach.modelPreset.
5. Fill in soul-bleach.apiKey, soul-bleach.baseUrl, and soul-bleach.model as needed.
6. Open the 灵境 view from the Activity Bar.
7. Ask the assistant a question or request a workspace file inspection.

Notes

The assistant can read and write files in the open workspace through its tools. Review generated changes before keeping them.

Code files are usually handled by locating key lines with search_text first, then reading focused ranges with read_file_with_line_numbers.

After edits, the assistant should reread the changed range and can use the restricted run_command tool for commands such as pnpm run compile, pnpm run lint, pnpm run test, and git diff --stat.

Chat history currently preserves the visible sidebar conversation state. Long-term model memory across sessions is not enabled yet.

Release Notes

0.0.1

Initial development release.