neoctl-web 0.1.12 → 0.1.14

package/README.md

@@ -13,6 +13,46 @@ neow
 
 当前版本目标：先复刻 `neo web` 的能力；绘图工具等待后续 `neoctl` 更新后再接入。
 
+## 隔离模式
+
+默认关闭，仅通过文件配置。配置文件为用户数据目录下的 `isolation.json`，或由 `NEO_ISOLATION_CONFIG` 指定绝对路径；指定文件缺失或格式错误时拒绝启动。
+
+在 `web` 目录执行。超管交互设密，普通用户仅分配用户名：
+
+```bash
+node scripts/isolation-user.mjs /absolute/path/isolation.json admin admin
+node scripts/isolation-user.mjs /absolute/path/isolation.json alice user
+```
+
+普通用户首次登录输入的密码保存为后续密码，仅保存 scrypt 哈希。新密码至少 1 位，仅允许英文字母和数字，不设业务长度上限。已有密码保持有效。用户名同时用于数据目录，不应改名或复用。编辑文件：
+
+```json
+{
+  "enabled": true,
+  "secureCookie": true,
+  "cookiePath": "/neo/",
+  "sessionHours": 12,
+  "retiredUsernames": [],
+  "users": [
+    { "username": "admin", "role": "admin", "passwordHash": "保留脚本生成的哈希" },
+    { "username": "alice", "role": "user" }
+  ]
+}
+```
+
+本地 HTTP 使用 `secureCookie: false`、`cookiePath: "/"`。HTTPS 部署使用 `secureCookie: true`，反向代理保留原始 `Host`。修改配置或账号后重启 Web；重启会清除全部登录态。关闭时改为 `enabled: false`，无需前端操作。
+
+- 后台按用户分组会话，列表、恢复、删除、SSE 和详情均校验归属；不向新用户分配原有公共会话。
+- 超管可在页面创建、删除普通用户并读取全部用户会话。超管查看会话时前端隐藏输入、新建和删除入口；底层会话接口不额外限制。删除账号不删除历史数据，用户名不可复用。
+- 会话、上传及内置插件记录保存在 `isolated-users/<用户名>/`，工作目录位于 `workspaces/users/<用户名>/`。旧模式数据不迁移、不删除。
+- 登录前不创建用户运行时；开启时直接嵌入运行时路由，不另开无认证 core HTTP 端口。
+- 超管显示完整模型配置页：模型、CPA、工具、插件、系统提示词。模型和工具保存后同步全部用户；插件按原逻辑重启生效，系统提示词按原逻辑在后续请求生效。
+- 普通用户不显示模型配置、提示词管理，配置接口拒绝访问。所有用户显示服务端内存，有有效额度时显示 CPA 额度卡片。
+- Cookie 使用 HttpOnly、SameSite=Strict、过期时间；登录有限流，退出或过期关闭对应 SSE。凭据文件不放工程公开目录或挂进工作容器。
+- 此处隔离的是 Web 账号和会话访问，不是 OS 沙箱。唯一 root 工作容器仍共享文件与进程；恶意 Agent 的跨用户文件访问需要额外执行层隔离。本地执行同样继承运行服务的系统权限。
+
+源码部署先运行 `npm --prefix ../engine run build`，生产页面运行 `npm run build`。`npm run dev` 和 `server.mjs` 均支持该配置。第三方插件需自行遵守传入的用户专属 `appDataDir`，不要使用共享数据目录。
+
 ## 开发启动
 
 ```bash
@@ -70,7 +110,7 @@ Vite 会把以下路径代理到 Neo 运行时，确保本应用使用与 `neo w
 - `/api/login`：模型供应商配置
 - `/vendor/*`：neo web 运行时静态资源
 
-`expose_downloads` 可暴露任意现有绝对文件路径，不受当前工作目录限制；下载链接仍为临时链接并按注册表有效期失效。
+`expose_downloads` 可暴露任意现有绝对文件路径，不受当前工作目录限制；下载链接无自动过期，仅持久保存原始路径映射、不复制文件；原文件移动、删除或不可读后链接失效。详见 `plugins/downloads/README.md`。独立视频播放插件见 `plugins/video-share/README.md`。
 
 如果只想启动纯前端 Vite：
 

package/chunk-uploads.mjs

@@ -0,0 +1,125 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { randomUUID } from 'node:crypto'
+
+export const UPLOAD_CHUNK_BYTES = 4 * 1024 * 1024
+const prefix = '/api/uploads/chunks'
+
+// No total file-size limit. Only individual requests are bounded, keeping memory
+// usage constant. Each chunk is appended to one file; completion is an atomic rename.
+export function createChunkUploadHandler({ uploadsDir, baseDir, finalize }) {
+  const sessions = new Map()
+  const partialDir = path.join(uploadsDir, '.partial')
+  const reply = (res, value, status = 200) => {
+    res.writeHead(status, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' })
+    res.end(JSON.stringify(value))
+  }
+  const fail = (message, status = 400) => Object.assign(new Error(message), { status })
+  async function metadata(req) {
+    const chunks = []
+    let bytes = 0
+    for await (const chunk of req) {
+      bytes += chunk.length
+      if (bytes > 16384) throw fail('上传元数据过大')
+      chunks.push(chunk)
+    }
+    return JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}')
+  }
+  async function discard(id, session) {
+    await fs.rm(session.partialPath, { force: true })
+    sessions.delete(id)
+  }
+  // Only abandoned incomplete uploads are cleaned up; completed files never expire.
+  const cleanup = setInterval(() => {
+    for (const [id, session] of sessions) {
+      if (!session.busy && Date.now() - session.updated > 24 * 60 * 60 * 1000) {
+        session.busy = true
+        void discard(id, session).catch(() => { session.busy = false })
+      }
+    }
+  }, 60 * 60 * 1000)
+  cleanup.unref()
+
+  const handle = async (req, res, url) => {
+    if (url.pathname !== prefix && !url.pathname.startsWith(prefix + '/')) return false
+    try {
+      if (url.pathname === prefix && req.method === 'POST') {
+        const body = await metadata(req)
+        const name = path.basename(String(body.name || '').replace(/\\/g, '/')).replace(/[<>:"/\\|?*\u0000-\u001f]+/g, '-').trim().slice(0, 180)
+        if (!name || name === '.' || name === '..') throw fail('文件名无效')
+        if (!Number.isSafeInteger(body.size) || body.size < 0) throw fail('文件大小无效')
+        const id = randomUUID()
+        await fs.mkdir(partialDir, { recursive: true })
+        const partialPath = path.join(partialDir, id + '.part')
+        const file = await fs.open(partialPath, 'wx')
+        await file.close()
+        sessions.set(id, { name, size: body.size, mimeType: String(body.mimeType || 'application/octet-stream'), partialPath, offset: 0, busy: false, updated: Date.now() })
+        reply(res, { ok: true, uploadId: id, offset: 0, chunkBytes: UPLOAD_CHUNK_BYTES })
+        return true
+      }
+      const match = url.pathname.slice(prefix.length).match(/^\/([a-f0-9-]{36})(\/complete)?$/)
+      if (!match) throw fail('上传地址无效', 404)
+      const id = match[1]
+      const session = sessions.get(id)
+      if (!session) throw fail('未完成的上传不存在，请重新上传', 404)
+      session.updated = Date.now()
+      if (session.busy) throw fail('上一分片仍在处理中，请重试', 409)
+      if (req.method === 'GET' && !match[2]) {
+        reply(res, { ok: true, offset: session.offset })
+        return true
+      }
+      session.busy = true
+      try {
+        if (req.method === 'DELETE' && !match[2]) {
+          await discard(id, session)
+          reply(res, { ok: true })
+        } else if (req.method === 'PATCH' && !match[2]) {
+          const offset = Number(req.headers['x-upload-offset'])
+          if (!Number.isSafeInteger(offset) || offset !== session.offset) throw fail('分片偏移不匹配', 409)
+          const file = await fs.open(session.partialPath, 'r+')
+          let received = 0
+          try {
+            for await (const chunk of req) {
+              if (received + chunk.length > UPLOAD_CHUNK_BYTES || offset + received + chunk.length > session.size) throw fail('分片大小无效', 413)
+              let written = 0
+              while (written < chunk.length) {
+                const result = await file.write(chunk, written, chunk.length - written, offset + received + written)
+                if (!result.bytesWritten) throw new Error('磁盘写入失败')
+                written += result.bytesWritten
+              }
+              received += chunk.length
+            }
+            if (!received) throw fail('分片为空')
+            session.offset += received
+          } catch (error) {
+            await file.truncate(offset)
+            throw error
+          } finally {
+            await file.close()
+          }
+          reply(res, { ok: true, offset: session.offset })
+        } else if (req.method === 'POST' && match[2]) {
+          if (session.offset !== session.size) throw fail('文件尚未上传完整', 409)
+          const storedName = `${new Date().toISOString().replace(/[:.]/g, '-')}-${id}-${session.name}`
+          const absolutePath = path.join(uploadsDir, storedName)
+          await fs.rename(session.partialPath, absolutePath)
+          sessions.delete(id)
+          const file = {
+            id: `upload-${id}`, name: session.name, storedName, size: session.size,
+            mimeType: session.mimeType, absolutePath,
+            relativePath: path.relative(baseDir, absolutePath) || storedName,
+            url: `/api/uploads/${encodeURIComponent(storedName)}`,
+          };
+          reply(res, { ok: true, file: finalize ? await finalize(file, url) : file });
+        } else throw fail('不支持的上传操作', 405)
+      } finally {
+        session.busy = false
+      }
+    } catch (error) {
+      if (!res.destroyed && !res.headersSent) reply(res, { ok: false, error: error.message || '上传失败' }, error.status || 500)
+    }
+    return true
+  }
+  handle.close = () => clearInterval(cleanup)
+  return handle
+}

package/core-runtime.mjs

@@ -23,6 +23,7 @@ export const WebRepl = webModule.WebRepl;
 export const WebRuntimeRouter = webModule.WebRuntimeRouter;
 export const createWebRuntime = webModule.createWebRuntime;
 export const runWebServer = webModule.runWebServer;
+export const handleWebRequest = webModule.handleWebRequest;
 export const coreRuntimeInfo = Object.freeze({
   source,
   version: await readCoreVersion(),