intools-cli 1.0.2 → 1.0.3

package/PLUGIN_API.md

@@ -0,0 +1,434 @@
+# InTools 插件 API 参考
+
+> 本文档包含 InTools 插件开发可用的全部 API。
+> - **UI/渲染进程**：`window.intools.{模块名}`
+> - **插件后端**：`context.api.{模块名}`
+
+---
+
+## 1. 剪贴板 (clipboard)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `readText()` | R/B | 读取文本 → `string` |
+| `writeText(text)` | R/B | 写入文本 |
+| `readImage()` | R/B | 读取图片 → `Buffer | null` |
+| `writeImage(image)` | R/B | 写入图片（路径/Buffer/DataURL） |
+| `writeFiles(paths)` | R | 写入文件路径 |
+| `readFiles()` | R/B | 读取文件列表 → `ClipboardFileInfo[]` |
+| `getFormat()` | R/B | 获取格式 → `'text' | 'image' | 'files' | 'html' | 'empty'` |
+
+---
+
+## 2. 文件系统 (filesystem)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `readFile(path, encoding?)` | R/B | 读取文件 → `Buffer | string` |
+| `writeFile(path, data, encoding?)` | R/B | 写入文件 |
+| `exists(path)` | R/B | 检查是否存在 → `boolean` |
+| `unlink(path)` | R/B | 删除文件 |
+| `readdir(path)` | R/B | 读取目录 → `string[]` |
+| `mkdir(path)` | R/B | 创建目录（递归） |
+| `stat(path)` | R/B | 获取文件信息 → `FileStat` |
+| `copy(src, dest)` | R/B | 复制文件 |
+| `move(src, dest)` | R/B | 移动/重命名文件 |
+| `extname(path)` | B | 获取扩展名 |
+| `join(...paths)` | B | 拼接路径 |
+| `dirname(path)` | B | 获取目录名 |
+| `basename(path, ext?)` | B | 获取文件名 |
+
+---
+
+## 3. 存储 (storage)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `get(key, namespace?)` | R/B | 获取数据 |
+| `set(key, value, namespace?)` | R/B | 存储数据 |
+| `remove(key, namespace?)` | R/B | 删除数据 |
+| `clear()` | B | 清空存储 |
+| `keys()` | B | 获取所有键 |
+
+---
+
+## 4. 对话框 (dialog)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `showOpenDialog(options?)` | R/B | 打开文件对话框 → `string[]` |
+| `showSaveDialog(options?)` | R/B | 保存文件对话框 → `string | null` |
+| `showMessageBox(options)` | R/B | 消息框 → `{ response, checkboxChecked }` |
+| `showErrorBox(title, content)` | R/B | 错误框（同步） |
+
+**OpenDialogOptions**: `title`, `defaultPath`, `buttonLabel`, `filters`, `properties`  
+**properties**: `'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'`
+
+---
+
+## 5. 通知 (notification)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `show(message, type?)` | R/B | 显示通知（`type='error'` 时不静音） |
+
+---
+
+## 6. Shell
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `openPath(path)` | R/B | 用默认应用打开文件 |
+| `openExternal(url)` | R/B | 用浏览器打开 URL |
+| `showItemInFolder(path)` | R/B | 在文件管理器中显示 |
+| `openFolder(path)` | R/B | 打开文件所在目录 |
+| `trashItem(path)` | R/B | 移动到回收站 |
+| `beep()` | R/B | 播放系统提示音 |
+
+---
+
+## 7. HTTP 请求 (http)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `request(options)` | R/B | 发起请求 → `HttpResponse` |
+| `get(url, headers?)` | R/B | GET 请求 |
+| `post(url, body?, headers?)` | R/B | POST 请求 |
+| `put(url, body?, headers?)` | R/B | PUT 请求 |
+| `delete(url, headers?)` | R/B | DELETE 请求 |
+
+**HttpRequestOptions**: `url`, `method`, `headers`, `body`, `timeout`  
+**HttpResponse**: `{ status, statusText, headers, data }`
+
+---
+
+## 8. 系统 (system)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `getSystemInfo()` | R/B | 获取系统信息 → `SystemInfo` |
+| `getAppInfo()` | R/B | 获取应用信息 → `AppInfo` |
+| `getPath(name)` | R/B | 获取特定路径 |
+| `getEnv(name)` | R/B | 获取环境变量 |
+| `getIdleTime()` | R/B | 获取空闲时间（秒） |
+| `getFileIcon(path)` | R/B | 获取文件图标 → base64 DataURL |
+| `getNativeId()` | R/B | 获取设备唯一标识 |
+| `isDev()` | R/B | 是否开发环境 |
+| `isMacOS() / isWindows() / isLinux()` | R/B | 判断操作系统 |
+
+**getPath 支持**: `'home' | 'appData' | 'userData' | 'temp' | 'exe' | 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos' | 'logs'`
+
+---
+
+## 9. 屏幕 (screen)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `getAllDisplays()` | R/B | 获取所有显示器 → `DisplayInfo[]` |
+| `getPrimaryDisplay()` | R/B | 获取主显示器 |
+| `getDisplayNearestPoint(point)` | R/B | 获取坐标位置的显示器 |
+| `getCursorScreenPoint()` | R/B | 获取鼠标位置 |
+| `getSources(options?)` | R/B | 获取捕获源列表 |
+| `capture(options?)` | R/B | 截取屏幕 → `Buffer` |
+| `captureRegion(region, options?)` | R/B | 截取指定区域 |
+| `screenCapture()` | R | 交互式区域截图 → DataURL |
+| `colorPick()` | R | 屏幕取色 → `{ hex, rgb, r, g, b }` |
+| `getMediaStreamConstraints(options)` | R/B | 获取录屏约束配置 |
+
+---
+
+## 10. 输入 (input)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `hideMainWindowPasteText(text)` | R/B | 粘贴文本到焦点应用 |
+| `hideMainWindowPasteImage(image)` | R/B | 粘贴图片到焦点应用 |
+| `hideMainWindowPasteFile(paths)` | R/B | 粘贴文件到焦点应用 |
+| `hideMainWindowTypeString(text)` | R/B | 模拟键入文本 |
+| `simulateKeyboardTap(key, ...modifiers)` | R/B | 模拟按键 |
+| `simulateMouseMove(x, y)` | R/B | 移动鼠标 |
+| `simulateMouseClick(x, y)` | R/B | 左键单击 |
+| `simulateMouseDoubleClick(x, y)` | R/B | 左键双击 |
+| `simulateMouseRightClick(x, y)` | R/B | 右键点击 |
+
+**修饰键**: `'ctrl' | 'alt' | 'shift' | 'command'`
+
+---
+
+## 11. 窗口 (window)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `hide(restorePreWindow?)` | R | 隐藏窗口 |
+| `show()` | R | 显示窗口 |
+| `setSize(width, height)` | R | 设置尺寸 |
+| `setExpendHeight(height)` | R | 调整高度 |
+| `center()` | R | 窗口居中 |
+| `setAlwaysOnTop(flag)` | R | 设置置顶 |
+| `detach()` | R | 分离为独立窗口 |
+| `close()` | R | 关闭窗口 |
+| `reload()` | R | 重新加载 |
+| `getMode()` | R | 获取模式 → `'attached' | 'detached'` |
+| `getWindowType()` | R | 获取类型 → `'main' | 'detach'` |
+| `getState()` | R | 获取状态 |
+| `minimize() / maximize()` | R | 最小化/最大化 |
+| `create(url, options?)` | R | 创建子窗口 → `ChildWindowHandle` |
+| `sendToParent(channel, ...args)` | R | 向父窗口发消息 |
+| `onChildMessage(callback)` | R | 监听子窗口消息 |
+| `findInPage(text, options?)` | R | 页面内查找 |
+| `startDrag(filePath)` | R | 触发文件拖拽 |
+
+### 子输入框 (subInput)
+
+| 方法 | 说明 |
+|------|------|
+| `set(placeholder?, isFocus?)` | 显示子输入框 |
+| `remove()` | 移除子输入框 |
+| `setValue(text)` | 设置内容 |
+| `focus() / blur() / select()` | 焦点控制 |
+| `onChange(callback)` | 监听变化 |
+
+---
+
+## 12. 主题 (theme)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `get()` | R | 获取主题信息 → `{ mode, actual }` |
+| `set(mode)` | R | 设置主题 → `'light' | 'dark' | 'system'` |
+| `getActual()` | R | 获取实际主题 → `'light' | 'dark'` |
+| `onThemeChange(callback)` | R | 监听主题变化 |
+
+---
+
+## 13. 插件管理 (plugin)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `getAll()` | R | 获取所有插件 |
+| `search(query)` | R | 搜索插件功能 |
+| `run(name, featureCode, input?)` | R | 执行插件功能 |
+| `install(filePath)` | R | 安装插件 |
+| `enable(name) / disable(name)` | R | 启用/禁用插件 |
+| `uninstall(name)` | R | 卸载插件 |
+| `getReadme(name)` | R | 获取 README |
+| `redirect(label, payload?)` | R | 跳转到其他插件 |
+| `outPlugin(isKill?)` | R | 退出当前插件 |
+
+### 事件
+
+| 事件 | 说明 |
+|------|------|
+| `onPluginInit(callback)` | 插件初始化 |
+| `onPluginAttach(callback)` | 插件附着 |
+| `onPluginDetached(callback)` | 插件分离 |
+
+---
+
+## 14. 动态指令 (features)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `getFeatures(codes?)` | B | 获取动态指令 |
+| `setFeature(feature)` | B | 注册动态指令 |
+| `removeFeature(code)` | B | 删除动态指令 |
+
+**DynamicFeatureInput**: `code`, `explain`, `icon`, `platform`, `mode`, `route`, `cmds`  
+**mode**: `'ui' | 'silent' | 'detached'`
+
+---
+
+## 15. 快捷键 (shortcut)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `register(accelerator)` | R/B | 注册全局快捷键 |
+| `unregister(accelerator)` | R/B | 注销快捷键 |
+| `unregisterAll()` | R/B | 注销所有快捷键 |
+| `isRegistered(accelerator)` | R/B | 检查是否已注册 |
+| `onTriggered(callback)` | R | 监听触发事件 |
+
+**accelerator 格式**: `CommandOrControl+Shift+X`, `Alt+P`, `F12`
+
+---
+
+## 16. 权限 (permission)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `getStatus(type)` | R/B | 获取权限状态 |
+| `request(type)` | R/B | 请求权限 |
+| `canRequest(type)` | R/B | 是否可请求 |
+| `openSystemSettings(type)` | R/B | 打开系统设置 |
+| `isAccessibilityTrusted()` | R/B | macOS 辅助功能权限 |
+
+**type**: `'accessibility' | 'screen' | 'camera' | 'microphone' | 'geolocation' | 'notifications' | 'contacts' | 'calendar'`
+
+---
+
+## 17. 安全存储 (security)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `isEncryptionAvailable()` | R/B | 检查加密可用性 |
+| `encryptString(plainText)` | R/B | 加密字符串 → `Buffer` |
+| `decryptString(encrypted)` | R/B | 解密字符串 → `string` |
+
+---
+
+## 18. 托盘 (tray)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `create(options)` | R/B | 创建托盘图标 |
+| `destroy()` | R/B | 销毁托盘 |
+| `setIcon(icon)` | R/B | 更新图标 |
+| `setTooltip(tooltip)` | R/B | 设置提示 |
+| `setTitle(title)` | R/B | 设置标题（macOS） |
+| `exists()` | R/B | 检查是否存在 |
+
+**TrayOptions**: `icon`, `tooltip`, `title`
+
+---
+
+## 19. 菜单 (menu)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `showContextMenu(items)` | R | 显示右键菜单 → `id | null` |
+
+**MenuItemOptions**: `label`, `type`, `checked`, `enabled`, `id`, `submenu`
+
+---
+
+## 20. 网络状态 (network)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `isOnline()` | R/B | 检查是否在线 |
+| `onOnline(callback)` | R | 网络恢复事件 |
+| `onOffline(callback)` | R | 网络断开事件 |
+
+---
+
+## 21. 电源 (power)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `getSystemIdleTime()` | R/B | 获取空闲时间 |
+| `getSystemIdleState(threshold)` | R/B | 获取空闲状态 |
+| `isOnBatteryPower()` | R/B | 是否电池供电 |
+| `getCurrentThermalState()` | R/B | 获取热状态（macOS） |
+| `onSuspend / onResume` | R | 休眠/唤醒事件 |
+| `onAC / onBattery` | R | 电源切换事件 |
+| `onLockScreen / onUnlockScreen` | R | 锁屏事件 |
+
+---
+
+## 22. 媒体 (media)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `getAccessStatus(type)` | R/B | 获取权限状态 |
+| `askForAccess(type)` | R/B | 请求权限 |
+| `hasCameraAccess()` | R/B | 检查摄像头权限 |
+| `hasMicrophoneAccess()` | R/B | 检查麦克风权限 |
+
+**type**: `'camera' | 'microphone'`
+
+---
+
+## 23. 地理位置 (geolocation)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `getAccessStatus()` | R | 获取权限状态 |
+| `requestAccess()` | R | 请求权限 |
+| `canGetPosition()` | R | 是否可获取位置 |
+| `openSettings()` | R | 打开系统设置 |
+| `getCurrentPosition()` | R | 获取当前位置 → `GeolocationPosition` |
+
+---
+
+## 24. TTS 语音合成 (tts)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `speak(text, options?)` | R | 朗读文本 |
+| `stop()` | R | 停止朗读 |
+| `pause() / resume()` | R | 暂停/恢复 |
+| `getVoices()` | R | 获取语音列表 |
+| `isSpeaking()` | R | 是否正在朗读 |
+
+**options**: `lang`, `rate`, `pitch`, `volume`
+
+---
+
+## 25. Host 调用 (host)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `invoke(pluginName, method, ...args)` | R | 调用插件后端方法 |
+| `status(pluginName)` | R | 获取 Host 状态 |
+| `restart(pluginName)` | R | 重启 Host 进程 |
+
+---
+
+## 26. Sharp 图像处理 (sharp)
+
+| 方法 | 说明 |
+|------|------|
+| `sharp(input?, options?)` | 创建实例 |
+| `.resize(w?, h?, opts?)` | 调整尺寸 |
+| `.extract({ left, top, width, height })` | 裁剪区域 |
+| `.rotate(angle?)` | 旋转 |
+| `.flip() / .flop()` | 翻转 |
+| `.blur(sigma?) / .sharpen()` | 模糊/锐化 |
+| `.grayscale() / .negate()` | 灰度/反相 |
+| `.modulate({ brightness, saturation, hue })` | 调整色彩 |
+| `.composite(images)` | 合成 |
+| `.png() / .jpeg() / .webp()` | 设置格式 |
+| `.toBuffer()` | 输出 ArrayBuffer |
+| `.toFile(path)` | 输出文件 |
+| `.metadata()` | 获取元数据 |
+
+---
+
+## 27. FFmpeg 音视频 (ffmpeg)
+
+| 方法 | 环境 | 说明 |
+|------|------|------|
+| `isAvailable()` | R | 检查是否已安装 |
+| `getVersion()` | R | 获取版本 |
+| `getPath()` | R | 获取可执行文件路径 |
+| `download(onProgress?)` | R | 下载 FFmpeg |
+| `run(args, onProgress?)` | R | 执行命令 → `{ promise, kill, quit }` |
+
+---
+
+## 28. InBrowser 自动化 (inbrowser)
+
+| 方法 | 说明 |
+|------|------|
+| `.goto(url, headers?, timeout?)` | 导航 |
+| `.click(selector) / .dblclick(selector)` | 点击 |
+| `.input(selector, text) / .type(selector, text)` | 输入 |
+| `.press(key, modifiers?)` | 按键 |
+| `.hover(selector) / .focus(selector)` | 悬停/聚焦 |
+| `.wait(ms) / .wait(selector)` | 等待 |
+| `.evaluate(func, ...args)` | 执行脚本 |
+| `.screenshot(target?, savePath?)` | 截图 |
+| `.pdf(options?, savePath?)` | 导出 PDF |
+| `.cookies(filter?)` | 获取 Cookie |
+| `.setCookies(...) / .clearCookies()` | 设置/清除 Cookie |
+| `.viewport(w, h)` | 设置视口 |
+| `.show() / .hide() / .end()` | 窗口控制 |
+| `.run(options?)` | 执行队列 |
+
+---
+
+## 环境标识说明
+
+- **R** = 渲染进程可用 (`window.intools.xxx`)
+- **B** = 插件后端可用 (`context.api.xxx`)
+- **R/B** = 两者都可用

package/README.md

@@ -141,6 +141,7 @@ my-plugin/
 ├── tsconfig.json         # TypeScript 配置
 ├── vite.config.ts        # Vite 配置
 ├── icon.png              # 插件图标
+├── PLUGIN_API.md         # API 参考文档
 ├── src/
 │   ├── main.ts           # 后端逻辑（沙箱运行）
 │   ├── types/
@@ -166,6 +167,7 @@ my-plugin/
 ├── package.json
 ├── manifest.json
 ├── icon.png
+├── PLUGIN_API.md         # API 参考文档
 └── src/
     └── main.ts
 ```
@@ -364,131 +366,35 @@ npm run build
 ### 插件 API
 
 插件在沙箱中运行，通过 `context.api` 访问各种 API。
-完整类型请参考模板生成的 `src/types/intools.d.ts`。
 
-#### 剪贴板 API (clipboard)
+> 📚 **完整 API 参考请查看 [`PLUGIN_API.md`](./PLUGIN_API.md)**
+> 
+> 该文件会在创建插件时自动生成，包含全部 28 个 API 模块的详细说明。
 
-```typescript
-const { clipboard } = context.api
-
-// 读取文本
-const text = clipboard.readText()
-
-// 写入文本
-await clipboard.writeText('Hello World')
-
-// 读取图片（返回 PNG Buffer）
-const imageBuffer = clipboard.readImage()
-
-// 写入图片
-clipboard.writeImage(imageData)
-
-// 读取文件列表
-const files = clipboard.readFiles()
-// 返回: [{ path, name, size, isDirectory }]
-
-// 获取剪贴板格式
-const format = clipboard.getFormat()
-// 返回: 'text' | 'image' | 'files' | 'empty'
-```
-
-#### 通知 API (notification)
+#### 常用 API 快速示例
 
 ```typescript
-const { notification } = context.api
+// 剪贴板
+const text = clipboard.readText()
+await clipboard.writeText('Hello')
 
+// 通知
 notification.show('操作成功')
 notification.show('发生错误', 'error')
-// type: 'info' | 'success' | 'warning' | 'error'
-```
-
-#### 存储 API (storage)
-
-```typescript
-const { storage } = context.api
-
-// 存储数据
-await storage.set('key', { foo: 'bar' })
 
-// 读取数据
+// 存储
+await storage.set('key', { data: 'value' })
 const data = await storage.get('key')
 
-// 删除数据
-await storage.remove('key')
-```
-
-#### 网络 API (http)
-
-```typescript
-const { http } = context.api
-
-// 完整请求
-const response = await http.request({
-  url: 'https://api.example.com/data',
-  method: 'POST',
-  headers: { 'Authorization': 'Bearer token' },
-  body: { key: 'value' },
-  timeout: 5000
-})
-
-// 快捷方法
-await http.get(url, headers?)
-await http.post(url, body?, headers?)
-await http.put(url, body?, headers?)
-await http.delete(url, headers?)
-```
-
-#### 窗口 API (window，仅 UI)
+// 文件系统
+const content = filesystem.readFile('/path/file.txt', 'utf-8')
+filesystem.writeFile('/path/output.txt', 'content', 'utf-8')
 
-```typescript
-const { window } = window.intools
-
-// 设置窗口大小
-await window.setSize(600, 400)
-
-// 隐藏窗口
-await window.hide()
-```
+// HTTP 请求
+const response = await http.post('https://api.example.com', { key: 'value' })
 
-#### 输入 API (input，仅 UI)
-
-```typescript
-const { input } = window.intools
-
-await input.hideMainWindowPasteText('Hello')
-await input.simulateKeyboardTap('A', 'cmd')
-```
-
-#### 权限 API (permission，仅 UI)
-
-```typescript
-const status = await window.intools?.permission?.getStatus('screen')
-```
-
-#### 文件系统 API (filesystem)
-
-```typescript
-const { filesystem } = context.api
-
-// 读写文件
-const buffer = filesystem.readFile('/path/to/file.png')
-const text = filesystem.readFile('/path/to/file.txt', 'utf-8')
-filesystem.writeFile('/path/to/output.txt', 'content', 'utf-8')
-
-// 文件操作
-filesystem.exists('/path')
-filesystem.unlink('/path')
-filesystem.mkdir('/path')
-filesystem.readdir('/path')
-filesystem.stat('/path')
-filesystem.copy(src, dest)
-filesystem.move(src, dest)
-
-// 路径工具
-filesystem.extname('/file.txt')   // '.txt'
-filesystem.dirname('/path/file')  // '/path'
-filesystem.basename('/path/file.txt')  // 'file.txt'
-filesystem.join('/path', 'to', 'file')
+// 对话框
+const files = await dialog.showOpenDialog({ properties: ['openFile'] })
 ```
 
 ---
@@ -668,21 +574,34 @@ cd json-formatter
 
 **src/main.ts:**
 ```typescript
-module.exports = {
-  async run(context: any) {
-    const { clipboard, notification } = context.api
-    const text = context.input || await clipboard.readText()
-
-    try {
-      const obj = JSON.parse(text)
-      const formatted = JSON.stringify(obj, null, 2)
-      await clipboard.writeText(formatted)
-      notification.show('JSON 格式化成功')
-    } catch (e) {
-      notification.show('无效的 JSON', 'error')
+interface PluginContext {
+  api: {
+    clipboard: {
+      readText: () => string
+      writeText: (text: string) => Promise<void>
     }
+    notification: {
+      show: (message: string, type?: string) => void
+    }
+  }
+  input?: string
+}
+
+export async function run(context: PluginContext) {
+  const { clipboard, notification } = context.api
+  const text = context.input || clipboard.readText()
+
+  try {
+    const obj = JSON.parse(text)
+    const formatted = JSON.stringify(obj, null, 2)
+    await clipboard.writeText(formatted)
+    notification.show('JSON 格式化成功')
+  } catch (e) {
+    notification.show('无效的 JSON', 'error')
   }
 }
+
+export default { run }
 ```
 
 ### 示例 2：翻译插件（带 UI）
@@ -717,16 +636,16 @@ npm install
 
 **src/main.ts:**
 ```typescript
-module.exports = {
-  onLoad() {
-    console.log('翻译插件已加载')
-  },
+export function onLoad() {
+  console.log('翻译插件已加载')
+}
 
-  async run(context: any) {
-    // UI 插件通常不需要在 run 中做太多事
-    // 主要逻辑在 UI 中处理
-  }
+export async function run() {
+  // UI 插件通常不需要在 run 中做太多事
+  // 主要逻辑在 UI 中处理
 }
+
+export default { onLoad, run }
 ```
 
 **src/ui/App.tsx:**
@@ -813,11 +732,3 @@ A: 修改 `manifest.json` 中的 `version` 字段，重新打包后安装即可
 
 A: 前端通过 `window.intools.shell` 调用系统能力；后端运行在沙箱中，仅能使用 `context.api` 暴露的接口。具体能力以 `intools.d.ts` 为准。
 
----
-
-## 相关文档
-
-- [InTools 插件开发规范](../../docs/plugin-spec.md)
-- [InTools API 接口参考](../../docs/api-reference.md)
-- [Manifest 规范 v2](../../docs/manifest-v2.md)
-- [插件打包说明](../../docs/plugin-packaging.md)

package/dist/commands/create/basic.js

@@ -55,4 +55,10 @@ async function createBasicProject(targetDir, name) {
     const mainTs = (0, basic_1.buildBasicMain)(name);
     fs.writeFileSync(path.join(targetDir, 'src/main.ts'), mainTs);
     console.log(chalk_1.default.green('  ✓ src/main.ts'));
+    // 复制 API 参考文档
+    const apiDocSrc = path.join(__dirname, '../../..', 'PLUGIN_API.md');
+    if (fs.existsSync(apiDocSrc)) {
+        fs.copyFileSync(apiDocSrc, path.join(targetDir, 'PLUGIN_API.md'));
+        console.log(chalk_1.default.green('  ✓ PLUGIN_API.md'));
+    }
 }

package/dist/commands/create/react.js

@@ -54,6 +54,12 @@ async function createReactProject(targetDir, name) {
     createBackendMain(targetDir, name);
     createReactUI(targetDir, name);
     createIntoolsTypes(targetDir);
+    // 复制 API 参考文档
+    const apiDocSrc = path.join(__dirname, '../../..', 'PLUGIN_API.md');
+    if (fs.existsSync(apiDocSrc)) {
+        fs.copyFileSync(apiDocSrc, path.join(targetDir, 'PLUGIN_API.md'));
+        console.log(chalk_1.default.green('  ✓ PLUGIN_API.md'));
+    }
 }
 function createReactManifest(targetDir, name) {
     const manifest = (0, react_1.buildReactManifest)(name);

package/dist/commands/dev.js

@@ -98,7 +98,31 @@ async function startViteDevServer(cwd) {
         console.log(chalk_1.default.yellow('跳过 UI 开发服务器: 未找到 vite.config.ts'));
         return;
     }
+    // 每次启动开发模式都构建 UI
+    // 这样应用可以加载最新的插件 UI
+    console.log(chalk_1.default.blue('构建 UI...'));
+    await new Promise((resolve, reject) => {
+        const viteBuild = (0, child_process_1.spawn)('npx', ['vite', 'build'], {
+            cwd,
+            stdio: 'inherit',
+            shell: true
+        });
+        viteBuild.on('close', (code) => {
+            if (code === 0) {
+                console.log(chalk_1.default.green('✓ UI 构建完成: ui/'));
+                resolve();
+            }
+            else {
+                reject(new Error(`Vite 构建失败，退出码: ${code}`));
+            }
+        });
+        viteBuild.on('error', reject);
+    });
+    console.log();
     console.log(chalk_1.default.blue('启动 Vite 开发服务器...'));
+    console.log(chalk_1.default.gray('  💡 提示: Vite 开发服务器提供 UI 预览，修改 UI 代码后'));
+    console.log(chalk_1.default.gray('           在 InTools 中点击「刷新插件」或执行 npm run build 更新'));
+    console.log();
     viteProcess = (0, child_process_1.spawn)('npx', ['vite', '--host'], {
         cwd,
         stdio: 'inherit',

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "intools-cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "InTools 插件开发 CLI 工具",
   "main": "dist/index.js",
   "files": [
     "dist",
-    "assets"
+    "assets",
+    "PLUGIN_API.md"
   ],
   "bin": {
     "intools": "dist/index.js"
@@ -28,4 +29,4 @@
     "@types/fs-extra": "^11.0.0",
     "typescript": "^5.0.0"
   }
-}
+}