vite-plugin-aipanel 1.2.21 → 1.2.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -87
- package/lib/client.js +847 -854
- package/package.json +8 -8
package/README.md
CHANGED
|
@@ -10,25 +10,14 @@
|
|
|
10
10
|
- Chrome / Edge / Arc / Brave 等 Chromium 内核浏览器
|
|
11
11
|
- 任选其一：OpenCode CLI（默认）或 DeepSeek Harness (dsh) CLI
|
|
12
12
|
|
|
13
|
-
##
|
|
14
|
-
|
|
15
|
-
### 1. 安装 AI 引擎
|
|
16
|
-
|
|
17
|
-
**默认引擎 OpenCode CLI：**
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
curl -fsSL https://opencode.ai/install | bash
|
|
21
|
-
opencode --version # 验证
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
> 使用 DeepSeek Harness 请改装：`npm i -g @deepseek-ai/dsh` + `npm i -D @aipanel/provider-deepseek`，并配置 `provider: "deepseek"`（见下）。
|
|
25
|
-
|
|
26
|
-
### 2. 安装并配置 Vite 插件
|
|
13
|
+
## 安装
|
|
27
14
|
|
|
28
15
|
```bash
|
|
29
16
|
npm install -D vite-plugin-aipanel
|
|
30
17
|
```
|
|
31
18
|
|
|
19
|
+
## 快速开始
|
|
20
|
+
|
|
32
21
|
```ts
|
|
33
22
|
// vite.config.ts
|
|
34
23
|
import { defineConfig } from "vite";
|
|
@@ -39,90 +28,26 @@ export default defineConfig({
|
|
|
39
28
|
});
|
|
40
29
|
```
|
|
41
30
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
npm run dev
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
插件自动完成：校验引擎 → 启动 AIPanel Web 服务（默认 5097）与代理（默认 6097，端口占用自动换）→ 复用/创建当前项目会话。
|
|
49
|
-
|
|
50
|
-
### 4. 安装浏览器扩展
|
|
51
|
-
|
|
52
|
-
1. [下载扩展包](https://github.com/code-farmer-i/vite-plugin-aipanel/raw/main/packages/extension/aipanel-assistant.zip)
|
|
53
|
-
2. Chrome 打开 `chrome://extensions/`，开启右上角**「开发者模式」**
|
|
54
|
-
3. 解压 `.zip` → **「加载已解压的扩展程序」** → 选择解压目录
|
|
55
|
-
4. 打开 `localhost` 开发页面，点击工具栏 **AIPanel 图标**（或 `Ctrl/Cmd + K`）唤起侧边栏
|
|
56
|
-
|
|
57
|
-
> Edge / Arc / Brave 入口分别是 `edge://extensions/` / `arc://extensions/` / `brave://extensions/`。
|
|
31
|
+
启动 `npm run dev` 后，插件自动完成：校验引擎 → 启动 AIPanel Web 服务（默认 5097）与代理（默认 6097，端口占用自动换）→ 复用/创建当前项目会话。
|
|
58
32
|
|
|
59
33
|
## 切换 AI 引擎
|
|
60
34
|
|
|
61
35
|
插件默认 `provider: "default"`（等价 `"opencode"`，适配已内置，仅需安装 opencode CLI）。
|
|
62
36
|
|
|
63
|
-
| provider
|
|
64
|
-
|
|
|
65
|
-
| `default`
|
|
66
|
-
| `opencode`
|
|
67
|
-
| `deepseek`
|
|
68
|
-
|
|
69
|
-
```ts
|
|
70
|
-
// 使用 DeepSeek Harness 引擎（先安装其依赖）
|
|
71
|
-
aipanelAssistant({
|
|
72
|
-
provider: "deepseek",
|
|
73
|
-
providerOptions: {
|
|
74
|
-
// home: "~/.dsh", // dsh 数据目录
|
|
75
|
-
// agentPreset: "standard", // 新建会话的默认 Agent 预设
|
|
76
|
-
// permissionPreset: "read-only", // 默认权限预设
|
|
77
|
-
// busyEnter: "queue", // 繁忙时 Enter 行为
|
|
78
|
-
},
|
|
79
|
-
});
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
> **注意**：插件**不会自动探测**已安装的引擎，引擎由 `provider` 字段决定；切换前请确认对应 CLI 已安装。
|
|
37
|
+
| provider | 引擎 | 额外依赖 |
|
|
38
|
+
| ----------- | ---------------------- | ---------------------------------------- |
|
|
39
|
+
| `default` | OpenCode CLI | 无（适配内置；需另装 opencode CLI） |
|
|
40
|
+
| `opencode` | OpenCode CLI | 无（适配内置；需另装 opencode CLI） |
|
|
41
|
+
| `deepseek` | DeepSeek Harness (dsh) | `@aipanel/provider-deepseek` + dsh CLI |
|
|
83
42
|
|
|
84
43
|
## 纯净 MCP 模式
|
|
85
44
|
|
|
86
|
-
`mcpOnly: true`
|
|
87
|
-
|
|
88
|
-
```ts
|
|
89
|
-
aipanelAssistant({ mcpOnly: true });
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
端点挂在 Vite dev server 上（需保持 `vite dev` 运行），外部 MCP 客户端按 Streamable HTTP 配置：
|
|
93
|
-
|
|
94
|
-
```json
|
|
95
|
-
{
|
|
96
|
-
"mcpServers": {
|
|
97
|
-
"aipanel": {
|
|
98
|
-
"type": "http",
|
|
99
|
-
"url": "http://localhost:5173/__aipanel_mcp__"
|
|
100
|
-
}
|
|
101
|
-
}
|
|
102
|
-
}
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
> 端口随 Vite dev server 变化（默认 5173），以启动日志中的 `MCP endpoint` 为准；`Claude Code` / `Cursor` 等客户端配置详见在线文档。
|
|
106
|
-
|
|
107
|
-
## 工作原理
|
|
108
|
-
|
|
109
|
-
```
|
|
110
|
-
┌────────────────┐ ┌────────────────┐ ┌─────────────┐
|
|
111
|
-
│ Vite 插件 │ │ 浏览器扩展 │ │ OpenCode/dsh │
|
|
112
|
-
│ 启动 Web 服务 │◀────▶│ 侧边栏面板 │◀────▶│ AI 引擎 │
|
|
113
|
-
│ 代理跨域 │ │ 页面上下文同步 │ │ 会话管理 │
|
|
114
|
-
└────────────────┘ └────────────────┘ └─────────────┘
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
- Vite 插件在项目启动时自动拉起 AIPanel Web 服务
|
|
118
|
-
- 浏览器扩展检测到 `localhost` 页面后自动连接该服务
|
|
119
|
-
- 实时同步页面 URL、标题等上下文给 AI
|
|
120
|
-
- 多标签页自动切换对应项目的会话
|
|
45
|
+
`mcpOnly: true` 时插件只暴露 MCP 工具服务（Chrome DevTools 控制、Vue DevTools、日志读取等），不启动 AI 引擎、不注入对话界面，适合作为独立 MCP server 供外部 Agent 消费。
|
|
121
46
|
|
|
122
47
|
## 文档
|
|
123
48
|
|
|
124
|
-
|
|
49
|
+
完整使用指南（浏览器扩展安装、MCP 客户端配置等）请访问 [在线文档](https://code-farmer-i.github.io/vite-plugin-aipanel/)，仓库见 [code-farmer-i/vite-plugin-aipanel](https://github.com/code-farmer-i/vite-plugin-aipanel)。
|
|
125
50
|
|
|
126
51
|
## License
|
|
127
52
|
|
|
128
|
-
MIT
|
|
53
|
+
MIT
|