@starpak/os 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024-present Spak Team
+Copyright (c) 2019-present Shigma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/index.d.ts

@@ -0,0 +1,29 @@
+export interface OsOptions {
+    /** 工程根目录（默认当前目录）。 */
+    root?: string;
+    /** 静态 UI 目录（默认：包内 ui/）。 */
+    uiDir?: string;
+    /** 监听端口（默认 8008）。 */
+    port?: number;
+    /** 监听地址（默认 127.0.0.1）。 */
+    host?: string;
+}
+export interface OsHandle {
+    port: number;
+    host: string;
+    url: string;
+    close(): Promise<void>;
+}
+export declare function startOs(options?: OsOptions): Promise<OsHandle>;
+/** 插件入口：宿主提供 router 时挂载 API（UI 由 startOs 提供）。 */
+export declare function apply(ctx: {
+    router?: any;
+    logger?: any;
+}, config?: OsOptions): void;
+/** CLI：阻塞运行直到 SIGINT/SIGTERM。 */
+export declare function runOsCli(options?: {
+    root?: string;
+    port?: number;
+    host?: string;
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAmDD,wBAAsB,OAAO,CAAC,OAAO,GAAE,SAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkExE;AAED,iDAAiD;AACjD,wBAAgB,KAAK,CAAC,GAAG,EAAE;IAAE,MAAM,CAAC,EAAE,GAAG,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAE,EAAE,MAAM,GAAE,SAAc,GAAG,IAAI,CAevF;AAED,iCAAiC;AACjC,wBAAsB,QAAQ,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3G"}

package/lib/index.js

@@ -0,0 +1,170 @@
+"use strict";
+// ===== spm os — Spak OS 桌面壳（默认 8008）=====
+//
+// 提供 apps/spak-os 的静态页面与最小 API：
+//   GET /           桌面
+//   GET /api/apps   已安装应用（扫描 apps/*/spak.app.json）
+//
+// 端口固定默认 8008；监听地址默认 127.0.0.1，可用 --host 0.0.0.0 对外。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startOs = startOs;
+exports.apply = apply;
+exports.runOsCli = runOsCli;
+const node_http_1 = require("node:http");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+};
+async function listApps(root) {
+    const appsDir = (0, node_path_1.join)(root, 'apps');
+    const apps = [];
+    let names = [];
+    try {
+        names = await (0, promises_1.readdir)(appsDir);
+    }
+    catch {
+        return apps;
+    }
+    for (const name of names.sort()) {
+        if (name.startsWith('.'))
+            continue;
+        const manifestPath = (0, node_path_1.join)(appsDir, name, 'spak.app.json');
+        try {
+            const manifest = JSON.parse(await (0, promises_1.readFile)(manifestPath, 'utf-8'));
+            apps.push({ id: manifest.id ?? name, ...manifest });
+        }
+        catch {
+            // 不是应用目录就跳过
+        }
+    }
+    return apps;
+}
+async function listMods(root) {
+    const modsDir = (0, node_path_1.join)(root, 'mods');
+    const mods = [];
+    let names = [];
+    try {
+        names = await (0, promises_1.readdir)(modsDir);
+    }
+    catch {
+        return mods;
+    }
+    for (const name of names.sort()) {
+        if (name.startsWith('.'))
+            continue;
+        try {
+            const manifest = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(modsDir, name, 'mod.json'), 'utf-8'));
+            mods.push({ id: manifest.id ?? name, ...manifest });
+        }
+        catch {
+            // 不是模组目录就跳过
+        }
+    }
+    return mods;
+}
+function json(response, status, body) {
+    const text = JSON.stringify(body);
+    response.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'content-length': Buffer.byteLength(text) });
+    response.end(text);
+}
+async function startOs(options = {}) {
+    const root = (0, node_path_1.resolve)(options.root || process.cwd());
+    // UI 资源随包发布（packages/os/ui），宿主只提供端口与应用目录
+    const uiDir = options.uiDir ? (0, node_path_1.resolve)(options.uiDir) : (0, node_path_1.join)(__dirname, '..', 'ui');
+    const port = options.port ?? 8008;
+    const host = options.host ?? '127.0.0.1';
+    const server = (0, node_http_1.createServer)(async (request, response) => {
+        try {
+            const url = new URL(request.url || '/', `http://${request.headers.host || 'localhost'}`);
+            if (url.pathname === '/api/apps') {
+                return json(response, 200, { apps: await listApps(root) });
+            }
+            if (url.pathname === '/api/mods') {
+                return json(response, 200, { mods: await listMods(root) });
+            }
+            if (url.pathname === '/api/health') {
+                return json(response, 200, { status: 'ok', os: 'spak-os', uptime: Math.round(process.uptime()) });
+            }
+            // 静态文件（禁止路径穿越）
+            const relative = (0, node_path_1.normalize)(decodeURIComponent(url.pathname)).replace(/^([/\\])+/, '');
+            const target = (0, node_path_1.resolve)(uiDir, relative || 'index.html');
+            if (!target.startsWith(uiDir + node_path_1.sep) && target !== uiDir) {
+                return json(response, 403, { error: 'forbidden' });
+            }
+            let file = target;
+            try {
+                const info = await (0, promises_1.stat)(file);
+                if (info.isDirectory())
+                    file = (0, node_path_1.join)(file, 'index.html');
+            }
+            catch {
+                if ((0, node_path_1.extname)(relative))
+                    return json(response, 404, { error: 'not_found' });
+                file = (0, node_path_1.join)(uiDir, 'index.html'); // SPA 回退
+            }
+            const data = await (0, promises_1.readFile)(file);
+            response.writeHead(200, {
+                'content-type': MIME[(0, node_path_1.extname)(file)] ?? 'application/octet-stream',
+                'content-length': data.length,
+                'cache-control': 'no-cache',
+            });
+            response.end(data);
+        }
+        catch (error) {
+            json(response, 500, { error: 'internal_error', message: error.message });
+        }
+    });
+    await new Promise((resolveListen, rejectListen) => {
+        server.once('error', rejectListen);
+        server.listen(port, host, () => {
+            server.off('error', rejectListen);
+            resolveListen();
+        });
+    });
+    const address = server.address();
+    const actualPort = typeof address === 'object' && address ? address.port : port;
+    return {
+        port: actualPort,
+        host,
+        url: `http://${host}:${actualPort}`,
+        close: () => new Promise(resolveClose => server.close(() => resolveClose())),
+    };
+}
+/** 插件入口：宿主提供 router 时挂载 API（UI 由 startOs 提供）。 */
+function apply(ctx, config = {}) {
+    const root = (0, node_path_1.resolve)(config.root || process.cwd());
+    const router = ctx?.router;
+    if (!router) {
+        ctx?.logger?.info?.('os 插件未挂载 router：请使用 startOs() 直接提供服务');
+        return;
+    }
+    router.get('/api/apps', async () => ({
+        headers: { 'content-type': 'application/json; charset=utf-8' },
+        body: JSON.stringify({ apps: await listApps(root) }),
+    }));
+    router.get('/api/mods', async () => ({
+        headers: { 'content-type': 'application/json; charset=utf-8' },
+        body: JSON.stringify({ mods: await listMods(root) }),
+    }));
+}
+/** CLI：阻塞运行直到 SIGINT/SIGTERM。 */
+async function runOsCli(options = {}) {
+    const handle = await startOs(options);
+    console.log(`\n  ◉ Spak OS → ${handle.url}`);
+    console.log(`    桌面: apps/spak-os   应用: ${(0, node_path_1.join)(options.root || process.cwd(), 'apps')}`);
+    console.log('    Ctrl+C 退出\n');
+    await new Promise((resolveStop) => {
+        const stop = () => { void handle.close().then(() => resolveStop()); };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    });
+    console.log('Spak OS 已停止');
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@starpak/os",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Spak OS - desktop shell plugin (window manager, taskbar, launcher) served on :8008",
+  "version": "0.1.0",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "ui"
+  ],
+  "author": "Spak Team",
+  "license": "MIT",
+  "dependencies": {}
 }

package/ui/index.html

@@ -0,0 +1,40 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">
+<title>Spak OS</title>
+<link rel="stylesheet" href="./os.css">
+</head>
+<body>
+  <div id="boot"><div class="logo">Spak OS</div><div class="bar"><i></i></div></div>
+
+  <main id="desktop" aria-label="桌面">
+    <div id="icons"></div>
+    <div id="windows"></div>
+  </main>
+
+  <nav id="bar" aria-label="任务栏">
+    <button id="start" title="开始菜单" aria-label="开始菜单">
+      <svg viewBox="0 0 24 24" aria-hidden="true">
+        
+      </svg>
+    </button>
+    <div id="tasks"></div>
+    <div id="clock"></div>
+  </nav>
+
+  <div id="launcher" hidden>
+    <div class="launcher-box" role="dialog" aria-label="开始菜单">
+      <div class="launcher-head">
+        <h1>Spak OS</h1>
+        <span class="ver">0.1</span>
+      </div>
+      <div id="apps" class="grid"></div>
+      <div class="launcher-foot"><span>Alt+Tab 切换 · Esc 关闭 · Ctrl+K 唤起</span></div>
+    </div>
+  </div>
+
+  <script src="./os.js"></script>
+</body>
+</html>

package/ui/os.css

@@ -0,0 +1,219 @@
+:root {
+  color-scheme: dark;
+  --bg: #0b1020;
+  --fg: #e8ecf7;
+  --dim: #8b93a7;
+  --accent: #ff8a00;
+  --accent2: #ffb03a;
+  --glass: rgba(22, 27, 45, .72);
+  --line: rgba(255, 255, 255, .12);
+  --win: #131a2c;
+  --radius: 14px;
+  --bar-h: 56px;
+}
+[data-theme="light"] {
+  --bg: #eef1f8;
+  --fg: #131a2c;
+  --dim: #5b6478;
+  --glass: rgba(255, 255, 255, .78);
+  --line: rgba(0, 0, 0, .1);
+  --win: #ffffff;
+}
+* { box-sizing: border-box; }
+html { height: 100%; }
+body {
+  position: fixed;
+  inset: 0;
+  height: 100dvh;
+  margin: 0;
+}
+body {
+  font: 14px/1.5 system-ui, -apple-system, "Noto Sans CJK SC", sans-serif;
+  color: var(--fg);
+  background:
+    radial-gradient(1100px 680px at 12% -12%, #1e3358 0%, transparent 58%),
+    radial-gradient(900px 640px at 108% 108%, #4a2158 0%, transparent 55%),
+    linear-gradient(160deg, #070b16 0%, #0d1428 45%, #121021 100%);
+  overflow: hidden;
+  user-select: none;
+  -webkit-user-select: none;
+  touch-action: none;
+}
+
+/* boot */
+#boot {
+  position: fixed; inset: 0; z-index: 90;
+  display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 18px;
+  background: var(--bg);
+  transition: opacity .5s ease, visibility .5s;
+}
+#boot.done { display: none; }
+#boot .logo {
+  font-size: clamp(26px, 8vw, 34px); letter-spacing: .04em; font-weight: 700;
+  background: linear-gradient(100deg, var(--accent2), var(--accent));
+  -webkit-background-clip: text; background-clip: text; color: transparent;
+}
+#boot .bar { width: 180px; height: 4px; border-radius: 2px; background: var(--line); overflow: hidden; }
+#boot .bar i { display: block; height: 100%; width: 40%; border-radius: 2px; background: var(--accent); animation: boot 1.1s ease-in-out infinite; }
+@keyframes boot { 0% { transform: translateX(-120%); } 100% { transform: translateX(320%); } }
+
+/* desktop */
+#desktop { position: absolute; inset: 0 0 var(--bar-h) 0; overflow: hidden; }
+#icons {
+  position: absolute; inset: 16px auto auto 16px;
+  display: grid; gap: 10px; width: 96px;
+}
+#desktop::before {
+  content: "";
+  position: absolute; inset: -20%;
+  background:
+    radial-gradient(42% 34% at 24% 28%, rgba(255, 138, 0, .12), transparent 70%),
+    radial-gradient(38% 30% at 76% 66%, rgba(122, 92, 255, .14), transparent 70%);
+  filter: blur(48px);
+  pointer-events: none;
+}
+.icon {
+  display: grid; justify-items: center; gap: 7px;
+  width: 86px; padding: 8px 6px; border-radius: 14px; cursor: pointer;
+  color: var(--fg); background: transparent; border: 0; font: inherit;
+}
+.icon:hover, .icon:focus-visible { background: rgba(255, 255, 255, .08); outline: none; }
+.icon .glyph {
+  width: 54px; height: 54px; display: grid; place-items: center;
+  border-radius: 16px; color: #ffcf87;
+  background: linear-gradient(160deg, rgba(255, 255, 255, .14), rgba(255, 255, 255, .05));
+  border: 1px solid rgba(255, 255, 255, .20);
+  box-shadow: inset 0 1px 0 rgba(255, 255, 255, .22), 0 8px 22px rgba(0, 0, 0, .40);
+}
+.icon span { color: #c8d0e2; }
+.icon .glyph svg, .tile .glyph svg { width: 26px; height: 26px; fill: none; stroke: currentColor; stroke-width: 1.8; stroke-linejoin: round; stroke-linecap: round; }
+.icon span { font-size: 12px; color: var(--dim); }
+
+/* windows */
+.win {
+  position: absolute; min-width: 280px; min-height: 160px;
+  background: var(--win); border: 1px solid var(--line);
+  border-radius: var(--radius); box-shadow: 0 24px 60px rgba(0, 0, 0, .45);
+  display: flex; flex-direction: column; overflow: hidden;
+  animation: pop .16s ease-out;
+}
+@keyframes pop { from { transform: scale(.97); opacity: 0; } }
+.win:focus-within { border-color: rgba(255, 138, 0, .5); }
+.win header {
+  display: flex; align-items: center; gap: 8px;
+  padding: 10px 12px; cursor: grab; touch-action: none;
+  background: rgba(255, 255, 255, .04); border-bottom: 1px solid var(--line);
+}
+.win header:active { cursor: grabbing; }
+.win header b { font-weight: 600; font-size: 13px; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.win header .spacer { flex: 1; }
+.win header button {
+  width: 34px; height: 34px; border-radius: 9px; border: 0;
+  background: transparent; color: var(--dim); font-size: 16px; cursor: pointer;
+}
+.win header button:hover { background: rgba(255, 255, 255, .1); color: var(--fg); }
+.win .body { flex: 1; overflow: auto; padding: 14px; -webkit-overflow-scrolling: touch; }
+.win .body p { margin: 0 0 8px; color: var(--dim); }
+.win .body code { color: var(--accent2); }
+
+/* terminal */
+.term { font: 13px/1.6 ui-monospace, "SF Mono", Menlo, monospace; background: #080b14; color: #cfe3ff; }
+.term .body { padding: 12px; }
+.term .out { white-space: pre-wrap; min-height: 120px; }
+.term .row { display: flex; gap: 8px; align-items: center; border-top: 1px solid var(--line); padding-top: 8px; margin-top: 8px; }
+.term .row { border-top: 0; }
+
+/* files */
+.files .row { display: flex; align-items: center; gap: 10px; padding: 10px; border-radius: 10px; }
+.files .row:hover { background: rgba(255, 255, 255, .06); }
+.files .row .dot { width: 8px; height: 8px; border-radius: 50%; background: var(--accent); }
+
+.term .term-line { flex: 1; min-height: 24px; color: #cfe3ff; white-space: pre-wrap; word-break: break-all; }
+.term .term-capture {
+  position: absolute; opacity: 0; width: 1px; height: 1px;
+  border: 0; padding: 0; background: transparent; pointer-events: none;
+}
+.term { position: relative; }
+
+/* taskbar */
+#bar {
+  position: fixed; left: 0; right: 0; bottom: 0; height: var(--bar-h);
+  display: flex; align-items: center; gap: 8px; padding: 0 10px;
+  background: var(--glass); backdrop-filter: blur(18px);
+  border-top: 1px solid var(--line);
+}
+#bar button {
+  height: 40px; min-width: 44px; padding: 0 12px; border-radius: 10px;
+  border: 1px solid transparent; background: transparent; color: var(--fg);
+  font: inherit; cursor: pointer;
+}
+#start { display: grid; place-items: center; color: var(--accent2); }
+#start svg { width: 24px; height: 24px; fill: currentColor; }
+#bar button:hover, #bar button[aria-pressed="true"] { background: rgba(255, 255, 255, .1); }
+#tasks { display: flex; gap: 6px; flex: 1; overflow: hidden; }
+#tasks .task {
+  max-width: 180px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+  border-radius: 9px; padding: 8px 12px; font-size: 12px; color: var(--dim);
+  background: rgba(255, 255, 255, .05); border: 1px solid transparent; cursor: pointer;
+}
+#tasks .task.active { color: var(--fg); border-color: var(--line); }
+#clock { font-size: 12px; color: var(--dim); padding-right: 6px; text-align: right; }
+
+/* launcher */
+#launcher {
+  position: fixed; inset: 0; z-index: 60;
+  background: rgba(4, 6, 14, .35);
+}
+#launcher[hidden] { display: none; }
+.launcher-box {
+  position: absolute; left: 8px; bottom: calc(var(--bar-h) + 8px);
+  width: min(380px, calc(100vw - 16px)); max-height: 70dvh; overflow: auto;
+  padding: 16px;
+  background: var(--glass); backdrop-filter: blur(26px) saturate(1.25);
+  border: 1px solid var(--line); border-radius: 18px;
+  box-shadow: 0 24px 60px rgba(0, 0, 0, .5), inset 0 1px 0 rgba(255, 255, 255, .08);
+}
+.launcher-head { display: flex; align-items: baseline; gap: 8px; margin-bottom: 12px; }
+.launcher-head h1 { margin: 0; font-size: 17px; letter-spacing: .02em; }
+.launcher-head .ver { color: var(--dim); font-size: 11px; }
+.launcher-box .search {
+  width: 100%; margin: 0 0 12px; padding: 9px 12px;
+  border-radius: 10px; border: 1px solid var(--line); outline: none;
+  background: rgba(255, 255, 255, .06); color: var(--fg); font: inherit;
+}
+.launcher-box .search::placeholder { color: var(--dim); }
+.launcher-foot { margin-top: 12px; color: var(--dim); font-size: 11px; }
+.grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 8px; }
+.tile {
+  display: grid; gap: 6px; justify-items: center; padding: 12px 6px;
+  border-radius: 12px; border: 1px solid transparent; background: transparent;
+  color: var(--fg); font: inherit; cursor: pointer; transition: background .15s, border-color .15s;
+}
+.tile:hover { border-color: rgba(255, 138, 0, .5); }
+.tile .glyph { font-size: 22px; }
+
+/* touch: 放大热区 */
+@media (pointer: coarse) {
+  .win header { padding: 8px 8px; gap: 6px; }
+  :root { --bar-h: 64px; }
+  .icon { padding: 10px 8px; gap: 9px; }
+  .icon .glyph { width: 58px; height: 58px; }
+  #bar button { height: 48px; min-width: 52px; }
+  .win header button { width: 42px; height: 42px; }
+  #desktop { inset: 0 0 64px 0; }
+}
+
+/* 手机：窗口铺满可视区，保证标题栏按钮不被裁掉 */
+#windows { position: absolute; inset: 0; pointer-events: none; }
+.win { pointer-events: auto; }
+
+@media (max-width: 600px) {
+  .win {
+    left: 8px !important;
+    top: 8px !important;
+    width: calc(100vw - 16px) !important;
+    height: calc(100dvh - var(--bar-h) - 16px) !important;
+  }
+}
+
+/* 终端输入：彻底去掉 UA 边框/背景 */

package/ui/os.js

@@ -0,0 +1,311 @@
+/* Spak OS — 桌面壳（窗口 / 任务栏 / 启动器 / 三端输入） */
+(() => {
+  const $ = (sel, root = document) => root.querySelector(sel)
+  const desktop = $('#desktop')
+  const layer = $('#windows')
+  const iconBox = $('#icons')
+  const tasks = $('#tasks')
+  const launcher = $('#launcher')
+  const clock = $('#clock')
+
+  const state = { z: 10, open: new Map(), seq: 0, focused: null, installed: [], mods: [] }
+
+  const svg = (body) => `<svg viewBox="0 0 24 24" aria-hidden="true">${body}</svg>`
+  const APPS = {
+    files: { title: '文件', glyph: svg('<path d="M3 6h6l2 2h10v10H3z"/>'), mount: mountFiles },
+    terminal: { title: '终端', glyph: svg('<rect x="3" y="4" width="18" height="16" rx="2"/><path d="m7 9 3 3-3 3M13 15h4"/>'), mount: mountTerminal },
+    settings: { title: '设置', glyph: svg('<circle cx="12" cy="12" r="3"/><path d="M12 3v2m0 14v2M3 12h2m14 0h2M5.6 5.6l1.4 1.4m10 10 1.4 1.4m0-12.8-1.4 1.4m-10 10-1.4 1.4"/>'), mount: mountSettings },
+    mods: { title: '模组', glyph: svg('<path d="M4 7h7v7H4zM13 4h7v7h-7zM13 13h7v7h-7zM4 15h7v5H4z"/>'), mount: mountMods },
+  }
+
+  /* ---------- 窗口 ---------- */
+  function openApp(id, payload) {
+    const app = APPS[id]
+    if (!app) return toast(`没有应用：${id}`)
+    const key = payload ? `${id}:${payload}` : id
+    if (state.open.has(key)) return focus(state.open.get(key).el)
+
+    const el = document.createElement('section')
+    el.className = `win ${id}${id === 'terminal' ? ' term' : ''}`
+    el.tabIndex = 0
+    el.innerHTML = `
+      <header><b>${app.title}</b><span class="spacer"></span>
+        <button data-act="min" title="最小化">–</button>
+        <button data-act="close" title="关闭">×</button>
+      </header>
+      <div class="body"></div>`
+    const body = $('.body', el)
+
+    const narrow = desktop.clientWidth < 600
+    const width = narrow ? desktop.clientWidth - 16 : Math.min(560, Math.max(300, desktop.clientWidth - 60))
+    const height = narrow ? desktop.clientHeight - 16 : Math.min(380, Math.max(180, desktop.clientHeight - 80))
+    const n = state.seq++
+    el.style.width = width + 'px'
+    el.style.height = height + 'px'
+    el.style.left = narrow ? '8px' : Math.min(150 + n * 26, Math.max(10, desktop.clientWidth - width - 10)) + 'px'
+    el.style.top = narrow ? '8px' : Math.min(40 + n * 22, Math.max(10, desktop.clientHeight - height - 10)) + 'px'
+
+    layer.appendChild(el)
+    const rec = { el, id, key, body, min: false }
+    state.open.set(key, rec)
+    bindDrag(el, $('header', el))
+    bindTask(rec)
+    app.mount(body, payload, el)
+    focus(el)
+    el.addEventListener('pointerdown', () => focus(el))
+    $('[data-act="close"]', el).onclick = () => close(rec)
+    $('[data-act="min"]', el).onclick = () => minimize(rec)
+    return rec
+  }
+
+  function focus(el) {
+    state.focused = el
+    el.style.zIndex = ++state.z
+    for (const rec of state.open.values()) rec.el.classList.toggle('focused', rec.el === el)
+    renderTasks()
+  }
+
+  function close(rec) {
+    rec.el.remove()
+    state.open.delete(rec.key)
+    rec.task?.remove()
+    renderTasks()
+  }
+
+  function minimize(rec) {
+    rec.min = !rec.min
+    rec.el.hidden = rec.min
+    renderTasks()
+  }
+
+  function bindTask(rec) {
+    const task = document.createElement('button')
+    task.className = 'task'
+    task.textContent = APPS[rec.id].title
+    task.onclick = () => (rec.min || rec.el.hidden ? (rec.min = false, rec.el.hidden = false, focus(rec.el)) : minimize(rec))
+    tasks.appendChild(task)
+    rec.task = task
+  }
+
+  function renderTasks() {
+    for (const rec of state.open.values()) {
+      rec.task?.classList.toggle('active', rec.el === state.focused && !rec.el.hidden)
+    }
+  }
+
+  function bindDrag(el, handle) {
+    let dx = 0, dy = 0, dragging = false
+    handle.addEventListener('pointerdown', (event) => {
+      if (event.target.closest('button')) return
+      dragging = true
+      const rect = el.getBoundingClientRect()
+      dx = event.clientX - rect.left
+      dy = event.clientY - rect.top
+      handle.setPointerCapture(event.pointerId)
+      el.style.transition = 'none'
+    })
+    handle.addEventListener('pointermove', (event) => {
+      if (!dragging) return
+      const maxX = desktop.clientWidth - el.offsetWidth
+      const maxY = desktop.clientHeight - el.offsetHeight
+      el.style.left = Math.max(0, Math.min(maxX, event.clientX - dx)) + 'px'
+      el.style.top = Math.max(0, Math.min(maxY, event.clientY - dy)) + 'px'
+    })
+    const stop = (event) => {
+      if (!dragging) return
+      dragging = false
+      try { handle.releasePointerCapture(event.pointerId) } catch {}
+    }
+    handle.addEventListener('pointerup', stop)
+    handle.addEventListener('pointercancel', stop)
+  }
+
+  /* ---------- 应用实现 ---------- */
+  function mountFiles(body) {
+    body.innerHTML = '<p>已安装应用（来自 apps/）</p><div class="list"></div>'
+    const list = $('.list', body)
+    const rows = [...state.installed.map(app => ({ name: app.name || app.id, note: app.description || '已安装应用', id: app.id }))]
+    if (!rows.length) list.innerHTML = '<p>还没有安装应用喵</p>'
+    for (const row of rows) {
+      const el = document.createElement('div')
+      el.className = 'row'
+      el.innerHTML = `<span class="dot"></span><div><b>${row.name}</b><br><small>${row.note}</small></div>`
+      list.appendChild(el)
+    }
+  }
+
+  function mountTerminal(body) {
+    body.innerHTML = `
+      <div class="out">Spak OS shell · 输入 help 查看命令</div>
+      <div class="row"><span>❯</span><span class="term-line" aria-hidden="true"></span></div>
+      <input class="term-capture" autocomplete="off" spellcheck="false" aria-label="终端输入">`
+    const out = $('.out', body)
+    const capture = $('.term-capture', body)
+    const display = $('.term-line', body)
+    const print = (text) => { out.textContent += `\n${text}`; out.scrollTop = out.scrollHeight }
+
+    body.addEventListener('pointerdown', () => capture.focus())
+    capture.addEventListener('input', () => { display.textContent = capture.value })
+    capture.addEventListener('keydown', (event) => {
+      if (event.key !== 'Enter') return
+      event.preventDefault()
+      const line = capture.value.trim()
+      capture.value = ''
+      display.textContent = ''
+      if (!line) return
+      print(`❯ ${line}`)
+      const [cmd, ...rest] = line.split(/\s+/)
+      if (cmd === 'help') print('help · date · ls · open <app> · theme · clear')
+      else if (cmd === 'date') print(new Date().toLocaleString())
+      else if (cmd === 'ls') print(Object.keys(APPS).join('  '))
+      else if (cmd === 'open') rest[0] ? openApp(rest[0]) : print('用法：open <files|terminal|settings>')
+      else if (cmd === 'theme') toggleTheme()
+      else if (cmd === 'clear') out.textContent = ''
+      else print(`未知命令：${cmd}`)
+    })
+    setTimeout(() => capture.focus(), 50)
+  }
+
+  function mountMods(body) {
+    body.innerHTML = '<p>已安装模组（来自 mods/）</p><div class="list"></div>'
+    const list = $('.list', body)
+    if (!state.mods.length) { list.innerHTML = '<p>还没有装模组喵</p>'; return }
+    for (const mod of state.mods) {
+      const perms = mod.capabilities || mod.permissions || {}
+      const summary = Object.entries(perms).map(([key, value]) => `${key}=${value}`).join(' · ') || '无额外权限'
+      const row = document.createElement('div')
+      row.className = 'row'
+      row.innerHTML = `<span class="dot"></span><div><b>${mod.name || mod.id}</b> <small>v${mod.version || '0.0.0'}</small><br><small>${summary}</small></div>`
+      list.appendChild(row)
+    }
+  }
+
+  function mountSettings(body) {
+    const theme = localStorage.getItem('spak-theme') || 'dark'
+    body.innerHTML = `
+      <p>外观</p>
+      <div class="row"><span class="dot"></span><div>主题：<b data-theme-label>${theme}</b></div>
+      <button class="tile" data-act="theme" style="margin-left:auto;padding:8px 14px">切换</button></div>
+      <p style="margin-top:16px">输入</p>
+      <p>键盘：Alt+Tab 切换 · Esc 关闭 · Ctrl+K 启动器<br>鼠标：拖动标题栏 · 点击任务栏<br>触屏：单指拖动 · 双指滚动</p>`
+    $('[data-act="theme"]', body).onclick = () => {
+      toggleTheme()
+      $('[data-theme-label]', body).textContent = localStorage.getItem('spak-theme')
+    }
+  }
+
+  /* 叶序螺旋点阵（黄金角 137.507764°）：r = c*sqrt(n), theta = n*phi */
+  function phyllotaxis(n = 90, radius = 9.2) {
+    const angle = Math.PI * (3 - Math.sqrt(5))
+    const c = radius / Math.sqrt(n)
+    let out = ''
+    for (let i = 1; i <= n; i++) {
+      const r = c * Math.sqrt(i)
+      const t = i * angle
+      const alpha = (0.30 + 0.70 * (1 - i / n)).toFixed(2)
+      out += `<circle cx="${(12 + r * Math.cos(t)).toFixed(3)}" cy="${(12 + r * Math.sin(t)).toFixed(3)}" r="0.52" opacity="${alpha}"/>`
+    }
+    return out
+  }
+
+  /* ---------- 系统 ---------- */
+  function toggleTheme() {
+    const next = (localStorage.getItem('spak-theme') || 'dark') === 'dark' ? 'light' : 'dark'
+    localStorage.setItem('spak-theme', next)
+    document.documentElement.dataset.theme = next
+  }
+
+  function toast(text) {
+    const el = document.createElement('div')
+    el.textContent = text
+    el.style.cssText = 'position:absolute;left:50%;bottom:80px;transform:translateX(-50%);padding:10px 16px;border-radius:10px;background:var(--glass);border:1px solid var(--line);z-index:80'
+    document.body.appendChild(el)
+    setTimeout(() => el.remove(), 1800)
+  }
+
+  function renderIcons() {
+    iconBox.innerHTML = ''
+    for (const [id, app] of Object.entries(APPS)) {
+      const btn = document.createElement('button')
+      btn.className = 'icon'
+      btn.innerHTML = `<span class="glyph">${app.glyph}</span><span>${app.title}</span>`
+      btn.onclick = () => openApp(id)
+      iconBox.appendChild(btn)
+    }
+  }
+
+  function renderLauncher() {
+    const grid = $('#apps')
+    grid.innerHTML = ''
+    for (const [id, app] of Object.entries(APPS)) {
+      const tile = document.createElement('button')
+      tile.className = 'tile'
+      tile.dataset.name = `${app.title} ${id}`.toLowerCase()
+      tile.innerHTML = `<span class="glyph">${app.glyph}</span><span>${app.title}</span>`
+      tile.onclick = () => { launcher.hidden = true; openApp(id) }
+      grid.appendChild(tile)
+    }
+  }
+
+  function tick() {
+    clock.textContent = new Date().toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' })
+  }
+
+  /* ---------- 输入 ---------- */
+  document.addEventListener('keydown', (event) => {
+    const typing = event.target instanceof HTMLElement && event.target.matches('input, textarea, .term-line')
+    if (event.key === 'Escape') {
+      if (!launcher.hidden) { toggleLauncher(false); return }
+      if (typing) { event.target.blur(); return }
+      const rec = [...state.open.values()].find(entry => entry.el === state.focused)
+      if (rec) close(rec)
+      else if (state.open.size) close([...state.open.values()].pop())
+      return
+    }
+    if (event.ctrlKey && event.key.toLowerCase() === 'k') {
+      event.preventDefault()
+      toggleLauncher()
+      return
+    }
+    if (event.altKey && event.key === 'Tab') {
+      event.preventDefault()
+      const list = [...state.open.values()].filter(rec => !rec.el.hidden)
+      if (list.length < 2) return
+      const index = list.findIndex(rec => rec.el === state.focused)
+      focus(list[(index + 1) % list.length].el)
+    }
+  })
+
+  function toggleLauncher(force) {
+    const open = force ?? launcher.hidden
+    launcher.hidden = !open
+    if (open) for (const tile of $('#apps').children) tile.hidden = false
+  }
+
+  $('#start').onclick = () => toggleLauncher()
+  launcher.addEventListener('click', (event) => { if (event.target === launcher) toggleLauncher(false) })
+
+
+  /* ---------- 启动 ---------- */
+  async function boot() {
+    document.documentElement.dataset.theme = localStorage.getItem('spak-theme') || 'dark'
+    $('#start svg').innerHTML = phyllotaxis()
+    renderIcons()
+    renderLauncher()
+    tick()
+    setInterval(tick, 1000)
+    try {
+      const response = await fetch('/api/apps')
+      if (response.ok) state.installed = (await response.json()).apps || []
+      const mods = await fetch('/api/mods')
+      if (mods.ok) state.mods = (await mods.json()).mods || []
+    } catch { /* 离线也照常启动 */ }
+    setTimeout(() => {
+      $('#boot').classList.add('done')
+      if (location.hash === '#start') toggleLauncher(true)
+    }, 900)
+  }
+
+  boot()
+  window.SpakOS = { openApp, toggleTheme }
+})()

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.