@leeoohoo/ui-apps-devkit 0.1.0

package/templates/notepad/plugin/backend/index.mjs

@@ -0,0 +1,99 @@
+import { createNotepadStore } from '../shared/notepad-store.mjs';
+import { resolveUiAppDataDir } from '../shared/notepad-paths.mjs';
+
+function normalizeString(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function resolveFallbackDataDir(ctx) {
+  const pluginId = normalizeString(ctx?.pluginId) || '__PLUGIN_ID__';
+  return resolveUiAppDataDir({ pluginId });
+}
+
+export async function createUiAppsBackend(ctx) {
+  const dataDir = normalizeString(ctx?.dataDir) || resolveFallbackDataDir(ctx);
+  const store = createNotepadStore({ dataDir });
+
+  return {
+    methods: {
+      async ping(params, ctx2) {
+        return { ok: true, params: params ?? null, pluginId: ctx2?.pluginId || '' };
+      },
+
+      async 'notes.init'() {
+        return await store.init();
+      },
+
+      async 'notes.listFolders'() {
+        return await store.listFolders();
+      },
+
+      async 'notes.createFolder'(params) {
+        return await store.createFolder({ folder: params?.folder });
+      },
+
+      async 'notes.renameFolder'(params) {
+        return await store.renameFolder({ from: params?.from, to: params?.to });
+      },
+
+      async 'notes.deleteFolder'(params) {
+        return await store.deleteFolder({ folder: params?.folder, recursive: params?.recursive === true });
+      },
+
+      async 'notes.listNotes'(params) {
+        return await store.listNotes({
+          folder: params?.folder,
+          recursive: params?.recursive,
+          tags: params?.tags,
+          match: params?.match,
+          query: params?.query,
+          limit: params?.limit,
+        });
+      },
+
+      async 'notes.createNote'(params) {
+        return await store.createNote({
+          folder: params?.folder,
+          title: params?.title,
+          content: params?.content,
+          tags: params?.tags,
+        });
+      },
+
+      async 'notes.getNote'(params) {
+        return await store.getNote({ id: params?.id });
+      },
+
+      async 'notes.updateNote'(params) {
+        return await store.updateNote({
+          id: params?.id,
+          title: params?.title,
+          content: params?.content,
+          folder: params?.folder,
+          tags: params?.tags,
+        });
+      },
+
+      async 'notes.deleteNote'(params) {
+        return await store.deleteNote({ id: params?.id });
+      },
+
+      async 'notes.listTags'() {
+        return await store.listTags();
+      },
+
+      async 'notes.searchNotes'(params) {
+        return await store.searchNotes({
+          query: params?.query,
+          folder: params?.folder,
+          recursive: params?.recursive,
+          tags: params?.tags,
+          match: params?.match,
+          includeContent: params?.includeContent !== false,
+          limit: params?.limit,
+        });
+      },
+    },
+    async dispose() {},
+  };
+}

package/templates/notepad/plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "manifestVersion": 1,
+  "id": "__PLUGIN_ID__",
+  "name": "__PLUGIN_NAME__",
+  "version": "__VERSION__",
+  "description": "A ChatOS UI Apps example: Markdown notepad with folders & tags.",
+  "backend": { "entry": "backend/index.mjs" },
+  "apps": [
+    {
+      "id": "__APP_ID__",
+      "name": "__PLUGIN_NAME__",
+      "description": "Markdown 编辑/预览，文件夹分类，标签管理与快速检索。",
+      "entry": { "type": "module", "path": "apps/__APP_ID__/index.mjs" },
+      "ai": {
+        "mcpPrompt": {
+          "title": "__PLUGIN_NAME__ · MCP Prompt",
+          "zh": "apps/__APP_ID__/mcp-prompt.zh.md",
+          "en": "apps/__APP_ID__/mcp-prompt.en.md"
+        }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,62 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+function normalizeString(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function resolveHostApp(env) {
+  const hostApp = normalizeString(env?.MODEL_CLI_HOST_APP);
+  return hostApp || 'chatos';
+}
+
+function resolveHomeDir(env) {
+  const homeEnv = normalizeString(env?.HOME) || normalizeString(env?.USERPROFILE);
+  if (homeEnv) return homeEnv;
+  try {
+    return os.homedir();
+  } catch {
+    return '';
+  }
+}
+
+function resolveSessionRoot(env) {
+  return normalizeString(env?.MODEL_CLI_SESSION_ROOT);
+}
+
+function tryEnsureWritableDir(dirPath) {
+  const target = normalizeString(dirPath);
+  if (!target) return false;
+  try {
+    fs.mkdirSync(target, { recursive: true });
+  } catch {
+    return false;
+  }
+  try {
+    fs.accessSync(target, fs.constants.W_OK);
+    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;
+  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));
+
+  for (const candidate of candidates) {
+    if (tryEnsureWritableDir(candidate)) return candidate;
+  }
+  return candidates[0];
+}
+