vite-plugin-aipanel 1.2.0-beta.4 → 1.2.0
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 +49 -11
- package/package.json +5 -9
package/README.md
CHANGED
|
@@ -2,15 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
在 Vite 开发环境中嵌入 AIPanel AI 助手，边聊天边改代码，HMR 实时预览。
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
### 前置条件
|
|
5
|
+
支持 OpenCode 与 DeepSeek Harness (dsh) 两种 AI 引擎，通过 `provider` 配置一键切换。
|
|
8
6
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
curl -fsSL https://opencode.ai/install | bash
|
|
13
|
-
```
|
|
7
|
+
## 快速开始
|
|
14
8
|
|
|
15
9
|
### 1. 安装插件
|
|
16
10
|
|
|
@@ -30,6 +24,8 @@ export default defineConfig({
|
|
|
30
24
|
});
|
|
31
25
|
```
|
|
32
26
|
|
|
27
|
+
默认使用 **OpenCode** 引擎（详见下方「选择 AI 引擎」）。
|
|
28
|
+
|
|
33
29
|
### 3. 启动开发服务器
|
|
34
30
|
|
|
35
31
|
```bash
|
|
@@ -40,7 +36,7 @@ Vite 插件会自动启动 AIPanel Web 服务并创建当前项目的 AI 会话
|
|
|
40
36
|
|
|
41
37
|
### 4. 安装浏览器扩展
|
|
42
38
|
|
|
43
|
-
1. [下载扩展包](https://github.com/code-farmer-i/vite-plugin-aipanel/raw/main/packages/extension/
|
|
39
|
+
1. [下载扩展包](https://github.com/code-farmer-i/vite-plugin-aipanel/raw/main/packages/extension/opencode-assistant.zip)
|
|
44
40
|
2. 打开 Chrome，地址栏输入 `chrome://extensions/`
|
|
45
41
|
3. 打开右上角**「开发者模式」**开关
|
|
46
42
|
4. 解压下载的 `.zip`，点击**「加载已解压的扩展程序」**，选择解压后的文件夹
|
|
@@ -48,12 +44,54 @@ Vite 插件会自动启动 AIPanel Web 服务并创建当前项目的 AI 会话
|
|
|
48
44
|
|
|
49
45
|
> Edge / Arc / Brave 操作步骤相同，入口分别是 `edge://extensions/` / `arc://extensions/` / `brave://extensions/`。
|
|
50
46
|
|
|
47
|
+
## 选择 AI 引擎
|
|
48
|
+
|
|
49
|
+
插件内置两套 AI 引擎，通过 `providerOptions` 段的 `provider` 字段选择：
|
|
50
|
+
|
|
51
|
+
| provider | 引擎 | 额外依赖 | 特点 |
|
|
52
|
+
| ------------ | ----------------------- | ------------------------------- | ------------------------------ |
|
|
53
|
+
| `opencode` | [OpenCode CLI](https://opencode.ai) | 无（插件内置） | 默认引擎，通用 AI CLI |
|
|
54
|
+
| `deepseek` | DeepSeek Harness (dsh) | 另装 `@aipanel/provider-deepseek` | DeepSeek 官方 Web 对话界面 |
|
|
55
|
+
|
|
56
|
+
使用 DeepSeek Harness 引擎需先安装依赖：
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
npm install -D @aipanel/provider-deepseek
|
|
60
|
+
npm install -g @deepseek-ai/dsh
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
```ts
|
|
64
|
+
// 使用 DeepSeek Harness 引擎
|
|
65
|
+
aipanelAssistant({
|
|
66
|
+
provider: "deepseek",
|
|
67
|
+
providerOptions: {
|
|
68
|
+
// dsh 专属配置，详见在线文档
|
|
69
|
+
// home: "~/.dsh", // dsh 数据目录
|
|
70
|
+
// agentPreset: "standard", // 新建会话的默认 Agent 预设
|
|
71
|
+
// permissionPreset: "read-only", // 默认权限预设
|
|
72
|
+
// busyEnter: "queue", // 繁忙时 Enter 行为
|
|
73
|
+
},
|
|
74
|
+
});
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
> 已预装 OpenCode 与 dsh 其中之一的用户，插件会自动检测并使用。
|
|
78
|
+
|
|
79
|
+
## 纯净 MCP 模式
|
|
80
|
+
|
|
81
|
+
`mcpOnly: true` 时，插件只暴露 MCP 工具服务（Chrome DevTools 控制、Vue DevTools、日志读取等），不注入挂件、不启动 AI 引擎，适合作为独立 MCP server 供外部 Agent 消费。
|
|
82
|
+
|
|
83
|
+
```ts
|
|
84
|
+
aipanelAssistant({ mcpOnly: true });
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
启动后 MCP 端点挂在 Vite dev server 上，外部 MCP 客户端配置 Streamable HTTP 接入 `http://localhost:5173/__aipanel_mcp__`。
|
|
88
|
+
|
|
51
89
|
## 工作原理
|
|
52
90
|
|
|
53
91
|
```
|
|
54
92
|
┌────────────────┐ ┌────────────────┐ ┌─────────────┐
|
|
55
|
-
│ Vite 插件 │ │ 浏览器扩展 │ │
|
|
56
|
-
│ 启动 Web 服务 │◀────▶│ 侧边栏面板 │◀────▶│ AI 引擎
|
|
93
|
+
│ Vite 插件 │ │ 浏览器扩展 │ │ OpenCode/dsh │
|
|
94
|
+
│ 启动 Web 服务 │◀────▶│ 侧边栏面板 │◀────▶│ AI 引擎 │
|
|
57
95
|
│ 代理跨域 │ │ 页面上下文同步 │ │ 会话管理 │
|
|
58
96
|
└────────────────┘ └────────────────┘ └─────────────┘
|
|
59
97
|
```
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "vite-plugin-aipanel",
|
|
3
|
-
"version": "1.2.0
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "Embed OpenCode Web UI in your Vite dev server for real-time code modification and preview",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.cjs",
|
|
@@ -41,12 +41,12 @@
|
|
|
41
41
|
"execa": "^9.6.1",
|
|
42
42
|
"typescript-language-server": "^5.3.0",
|
|
43
43
|
"unplugin-vue-inspector": "^3.0.0",
|
|
44
|
-
"@aipanel/
|
|
45
|
-
"@aipanel/
|
|
44
|
+
"@aipanel/provider-opencode": "1.2.0",
|
|
45
|
+
"@aipanel/core": "1.2.0"
|
|
46
46
|
},
|
|
47
47
|
"peerDependencies": {
|
|
48
48
|
"vite": ">=5.0.0",
|
|
49
|
-
"@aipanel/provider-deepseek": "1.2.0
|
|
49
|
+
"@aipanel/provider-deepseek": "1.2.0"
|
|
50
50
|
},
|
|
51
51
|
"peerDependenciesMeta": {
|
|
52
52
|
"@aipanel/provider-deepseek": {
|
|
@@ -55,14 +55,10 @@
|
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|
|
57
57
|
"sharp": "^0.34.5",
|
|
58
|
-
"@aipanel/client": "1.2.0
|
|
58
|
+
"@aipanel/client": "1.2.0"
|
|
59
59
|
},
|
|
60
60
|
"scripts": {
|
|
61
|
-
"prepare-eslint-lsp": "node scripts/prepare-eslint-lsp.mjs",
|
|
62
61
|
"build": "pagoda-cli build && vite build -c vite.client.config.ts",
|
|
63
|
-
"dev": "pagoda-cli dev",
|
|
64
|
-
"site": "pagoda-cli site",
|
|
65
|
-
"build:site": "pagoda-cli build-site",
|
|
66
62
|
"typecheck": "tsc -p tsconfig.declaration.json --noEmit"
|
|
67
63
|
}
|
|
68
64
|
}
|