@leeoohoo/ui-apps-devkit 0.1.1 → 0.1.2

package/templates/notepad/docs/CHATOS_UI_APPS_PLUGIN_MANIFEST.md

@@ -4,9 +4,9 @@
 
 实现对照（以代码为准）：
 
-- schema：`deepseek_cli/electron/ui-apps/schemas.js`
-- 扫描/校验：`deepseek_cli/electron/ui-apps/index.js`
-- 导入/安装：`deepseek_cli/electron/ui-apps/plugin-installer.js`
+- schema：`chatos/electron/ui-apps/schemas.js`
+- 扫描/校验：`chatos/electron/ui-apps/index.js`
+- 导入/安装：`chatos/electron/ui-apps/plugin-installer.js`
 
 另见：
 
@@ -18,8 +18,9 @@
 
 - 每个插件一个目录，目录根部必须包含 `plugin.json`。
 - 插件目录可放在：
-  - `deepseek_cli/ui_apps/plugins`（内置/开发）
-  - `~/.deepseek_cli/chatos/ui_apps/plugins`（用户插件目录）
+  - `chatos/ui_apps/plugins`（内置/开发）
+  - `<stateDir>/ui_apps/plugins`（用户插件目录；`stateDir = <stateRoot>/<hostApp>`）
+  - 兼容旧路径：若存在 `legacyStateRoot/<hostApp>/ui_apps/plugins`，启动时会自动迁移到 `stateDir`
 - 也可通过桌面端 UI：`应用` → `导入应用包`（目录或 `.zip`）安装到用户插件目录。
 
 ## 2. 顶层 schema（`uiAppsPluginSchema`）
@@ -128,16 +129,16 @@
 
 | 字段 | 类型 | 必填 | 默认 | 说明 |
 |---|---:|---:|---|---|
-| `url` | `string` | 二选一 | - | 远程 MCP Server 地址（`http(s)://` / `ws(s)://` 等） |
-| `entry` | `string` | 二选一 | - | 本地脚本入口（相对插件目录）；宿主会转换为 `cmd://...` |
-| `command` | `string` | 否 | `"node"` | 拉起本地 `entry` 时使用的命令 |
-| `args` | `string[]` | 否 | `[]` | 拉起时追加参数 |
-| `callMeta` | `object` | 否 | - | 调用 MCP 工具时注入到 `_meta` 的附加字段（不会暴露给 AI）；支持 `$pluginId/$appId/$pluginDir/$dataDir/$stateDir/$sessionRoot/$projectRoot` 变量 |
-| `description` | `string` | 否 | `""` | 描述 |
-| `tags` | `string[]` | 否 | `[]` | 标签（宿主还会自动附加 `uiapp*` 标签） |
-| `enabled` | `boolean` | 否 | - | 是否启用（未填则宿主同步时默认 `true`） |
-| `allowMain` | `boolean` | 否 | - | 是否允许主流程使用（未填则宿主同步时默认 `true`） |
-| `allowSub` | `boolean` | 否 | - | 是否允许子代理使用（未填则宿主同步时默认 `true`） |
+| `url` | `string` | 二选一 | - | 远程 MCP Server 地址（`http(s)://` / `ws(s)://` 等） |
+| `entry` | `string` | 二选一 | - | 本地脚本入口（相对插件目录）；宿主会转换为 `cmd://...` |
+| `command` | `string` | 否 | `"node"` | 拉起本地 `entry` 时使用的命令 |
+| `args` | `string[]` | 否 | `[]` | 拉起时追加参数 |
+| `callMeta` | `object` | 否 | - | 调用 MCP 工具时注入到 `_meta` 的附加字段（不会暴露给 AI）；支持 `$pluginId/$appId/$pluginDir/$dataDir/$stateDir/$sessionRoot/$projectRoot` 变量 |
+| `description` | `string` | 否 | `""` | 描述 |
+| `tags` | `string[]` | 否 | `[]` | 标签（宿主还会自动附加 `uiapp*` 标签） |
+| `enabled` | `boolean` | 否 | - | 是否启用（未填则宿主同步时默认 `true`） |
+| `allowMain` | `boolean` | 否 | - | 是否允许主流程使用（未填则宿主同步时默认 `true`） |
+| `allowSub` | `boolean` | 否 | - | 是否允许子代理使用（未填则宿主同步时默认 `true`） |
 | `auth` | `object` | 否 | - | 认证信息（token/basic/headers） |
 
 强约束：
@@ -156,13 +157,13 @@
 }
 ```
 
-当使用 `entry` 时，宿主会把它转换为可运行的 `cmd://`：
-
-- `command` 默认为 `node`
-- `args` 会追加到命令行末尾
-- 宿主会把空格/引号等做安全引用，以避免路径包含空格时解析失败
-
-`callMeta` 会随每次 `tools/call` 请求发送给 MCP server（位于 `request.params._meta`），默认会合并宿主注入的 `_meta.chatos.uiApp`（含 `pluginId/appId/pluginDir/dataDir/stateDir/sessionRoot/projectRoot`）与 `_meta.workdir`（默认等于 `dataDir`，可被 `callMeta.workdir` 覆盖）。
+当使用 `entry` 时，宿主会把它转换为可运行的 `cmd://`：
+
+- `command` 默认为 `node`
+- `args` 会追加到命令行末尾
+- 宿主会把空格/引号等做安全引用，以避免路径包含空格时解析失败
+
+`callMeta` 会随每次 `tools/call` 请求发送给 MCP server（位于 `request.params._meta`），默认会合并宿主注入的 `_meta.chatos.uiApp`（含 `pluginId/appId/pluginDir/dataDir/stateDir/sessionRoot/projectRoot`）与 `_meta.workdir`（默认等于 `dataDir`，可被 `callMeta.workdir` 覆盖）。
 
 ## 6. `ai.mcpPrompt`：应用默认 Prompt 声明
 

package/templates/notepad/docs/CHATOS_UI_APPS_TROUBLESHOOTING.md

@@ -38,8 +38,8 @@
 - 原因: 未调用 `host.uiPrompts.open()`, 或 `prompt.kind` 填写错误.
 - 处理: 先调用 `open()` 打开面板, 并按协议填写 `prompt`.
 
-## 7. MCP 不生效
-
-- 现象: MCP tools / prompts 未出现.
-- 原因: 未在 `plugin.json` 启用 `ai.mcp` 或未 bundle 依赖.
-- 处理: bundle 成单文件, 并检查 `ai.mcp.entry` / `ai.mcpPrompt` 配置.
+## 7. MCP 不生效
+
+- 现象: MCP tools / prompts 未出现.
+- 原因: 未在 `plugin.json` 启用 `ai.mcp`, 或 MCP 依赖未 bundle（ChatOS 导入会剔除 `node_modules`）.
+- 处理: 将 MCP server bundle 成单文件（或 vendor 依赖）, 并检查 `ai.mcp.entry` / `ai.mcpPrompt` 配置.

package/templates/notepad/docs/CHATOS_UI_PROMPTS_PROTOCOL.md

@@ -11,9 +11,9 @@ UI Prompts 是 ChatOS 的全局交互队列：任意组件（AI / MCP / UI Apps
 
 实现对照（以代码为准）：
 
-- UI 渲染：`deepseek_cli/apps/ui/src/features/session/floating-island/FloatingIslandPrompt.jsx`
-- 笑脸面板：`deepseek_cli/apps/ui/src/components/UiPromptsSmileHub.jsx`
-- Host IPC：`deepseek_cli/electron/main.js`（`uiPrompts:*`）
+- UI 渲染：`chatos/apps/ui/src/features/session/floating-island/FloatingIslandPrompt.jsx`
+- 笑脸面板：`chatos/apps/ui/src/components/UiPromptsSmileHub.jsx`
+- Host IPC：`chatos/electron/main.js`（`uiPrompts:*`）
 - 写入/读取日志：`aide/electron/session-api.js`（`requestUiPrompt` / `respondUiPrompt` / `readUiPromptsPayload`）
 - MCP `ui_prompter`：`aide/mcp_servers/ui-prompt-server.js`
 

package/templates/notepad/plugin/apps/app/mcp-server.mjs

@@ -1,4 +1,11 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * MCP server entry.
+ *
+ * Note: ChatOS import excludes `node_modules/`, so if you import third-party
+ * deps (e.g. @modelcontextprotocol/sdk, zod), you must bundle this file into
+ * a single output (or vendor deps into the plugin directory).
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import { createNotepadStore } from '../../shared/notepad-store.mjs';

package/templates/notepad/plugin/shared/notepad-paths.mjs

@@ -1,10 +1,13 @@
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-
-function normalizeString(value) {
-  return typeof value === 'string' ? value.trim() : '';
-}
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+const STATE_ROOT_DIRNAME = '.deepseek_cli';
+const COMPAT_STATE_ROOT_DIRNAME = '.chatos';
+
+function normalizeString(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
 
 function resolveHostApp(env) {
   const hostApp = normalizeString(env?.MODEL_CLI_HOST_APP);
@@ -25,9 +28,9 @@ function resolveSessionRoot(env) {
   return normalizeString(env?.MODEL_CLI_SESSION_ROOT);
 }
 
-function tryEnsureWritableDir(dirPath) {
-  const target = normalizeString(dirPath);
-  if (!target) return false;
+function tryEnsureWritableDir(dirPath) {
+  const target = normalizeString(dirPath);
+  if (!target) return false;
   try {
     fs.mkdirSync(target, { recursive: true });
   } catch {
@@ -38,21 +41,36 @@ function tryEnsureWritableDir(dirPath) {
     return true;
   } catch {
     return false;
-  }
-}
-
-export function resolveUiAppDataDir({ pluginId, env } = {}) {
-  const id = normalizeString(pluginId);
-  if (!id) throw new Error('pluginId is required');
-  const resolvedEnv = env && typeof env === 'object' ? env : process.env;
+  }
+}
+
+function pushDataDir(list, baseDir, rootDirName, hostApp, pluginId) {
+  const base = normalizeString(baseDir);
+  if (!base) return;
+  list.push(path.join(base, rootDirName, hostApp, 'ui_apps', 'data', pluginId));
+}
+
+export function resolveUiAppDataDir({ pluginId, env } = {}) {
+  const id = normalizeString(pluginId);
+  if (!id) throw new Error('pluginId is required');
+  const resolvedEnv = env && typeof env === 'object' ? env : process.env;
   const hostApp = resolveHostApp(resolvedEnv);
   const home = resolveHomeDir(resolvedEnv);
-  const sessionRoot = resolveSessionRoot(resolvedEnv);
-
-  const candidates = [];
-  if (home) candidates.push(path.join(home, '.deepseek_cli', hostApp, 'ui_apps', 'data', id));
-  if (sessionRoot) candidates.push(path.join(path.resolve(sessionRoot), '.deepseek_cli', hostApp, 'ui_apps', 'data', id));
-  candidates.push(path.join(path.resolve(process.cwd()), '.deepseek_cli', hostApp, 'ui_apps', 'data', id));
+  const sessionRoot = resolveSessionRoot(resolvedEnv);
+
+  const candidates = [];
+  if (home) {
+    pushDataDir(candidates, home, STATE_ROOT_DIRNAME, hostApp, id);
+    pushDataDir(candidates, home, COMPAT_STATE_ROOT_DIRNAME, hostApp, id);
+  }
+  if (sessionRoot) {
+    const root = path.resolve(sessionRoot);
+    pushDataDir(candidates, root, STATE_ROOT_DIRNAME, hostApp, id);
+    pushDataDir(candidates, root, COMPAT_STATE_ROOT_DIRNAME, hostApp, id);
+  }
+  const cwd = path.resolve(process.cwd());
+  pushDataDir(candidates, cwd, STATE_ROOT_DIRNAME, hostApp, id);
+  pushDataDir(candidates, cwd, COMPAT_STATE_ROOT_DIRNAME, hostApp, id);
 
   for (const candidate of candidates) {
     if (tryEnsureWritableDir(candidate)) return candidate;