@seastudio/sdk 3.0.0

package/README.md

@@ -0,0 +1,108 @@
+# @seastudio/sdk
+
+SeaStudio SDK v3.0 - UI 组件 + MCP 信息交换中心
+
+## 安装
+
+```bash
+# 本地开发（在插件前端目录下）
+pnpm add @seastudio/sdk
+```
+
+## 架构
+
+```
+seastudio-sdk/
+├── src/
+│   ├── ui/                    # UI 组件
+│   │   ├── Tab.tsx
+│   │   ├── Menu.tsx
+│   │   ├── Dialog.tsx
+│   │   ├── cosmos.css         # 设计系统样式
+│   │   └── index.ts
+│   └── mcp/                   # MCP 信息交换中心
+│       ├── core/              # MCP 基础设施
+│       ├── seastudio/         # 主程序 Tools
+│       ├── plugin-editor/     # 编辑器插件 Tools
+│       ├── plugin-preview/    # 预览插件 Tools
+│       └── index.ts
+└── dist/                      # 构建产物
+```
+
+## 功能模块
+
+| 模块 | 说明 |
+|------|------|
+| UI Components | Tab、Menu、Dialog 等通用组件 |
+| MCP Core | JSON-RPC 2.0 传输层和客户端 |
+| MCP Tools | 主程序和各插件的 MCP Tools 定义 |
+
+## 快速开始
+
+### UI 组件
+
+```typescript
+import { Tab, MenuContainer, MenuItem, DialogOverlay, cn } from '@seastudio/sdk/ui';
+
+// 样式
+import '@seastudio/sdk/ui/cosmos.css';
+```
+
+### MCP Tools
+
+```typescript
+import { listAvailableTools, listAllTools, seastudio, editor, preview } from '@seastudio/sdk/mcp';
+
+// 列出可用 Tools（从 SDK 静态获取，不依赖 Host）
+const tools = listAvailableTools();
+
+// 如需内部/runtime 全量工具面，使用 listAllTools()
+const allTools = listAllTools();
+
+// 使用便捷方法调用 Tool
+await seastudio.file.read('/path/to/file');
+await seastudio.file.write('/path/to/file', 'content');
+await editor.openFile('/path/to/file');
+await preview.get('/path/to/file');
+```
+
+说明：`@seastudio/sdk/mcp` 现在的官方稳定支持面聚焦在 raw MCP catalog、包索引和通用转换能力，不包含额外的上层适配逻辑。
+
+### 动态加载插件 MCP
+
+```typescript
+import { loadPlugin } from '@seastudio/sdk/mcp';
+
+// 动态加载插件模块
+const editorModule = await loadPlugin('plugin-editor');
+```
+
+## 导入路径
+
+| 路径 | 说明 |
+|------|------|
+| `@seastudio/sdk` | 完整导出（UI + MCP） |
+| `@seastudio/sdk/ui` | UI 组件 |
+| `@seastudio/sdk/mcp` | MCP 完整模块 |
+| `@seastudio/sdk/mcp/core` | MCP 基础设施 |
+| `@seastudio/sdk/mcp/seastudio` | 主程序 Tools |
+| `@seastudio/sdk/mcp/plugin-editor` | 编辑器插件 Tools |
+| `@seastudio/sdk/mcp/plugin-preview` | 预览插件 Tools |
+
+## 开发
+
+```bash
+# 构建
+pnpm build
+
+# 开发模式（监听变化）
+pnpm dev
+```
+
+## 迁移指南
+
+从 v2.x 迁移到 v3.x，请参阅项目根目录的 `MCP_MIGRATION_GUIDE.md`。
+
+如果你正在开发上层运行时：
+- 优先使用 `listAvailableTools()`、`listAllTools()`、`mcpToolToOpenAI()`、`getMCPPackageIdForTool()` 这类 raw MCP 基础能力。
+- 如需额外的工具投影或执行适配，请在各自仓库内自行维护，不要继续把上层语义收敛进 SDK。

package/bin/seastudio.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../dist/develop-tool/cli/index.js';