exflower-license-server 1.3.1 → 1.3.2

package/Dockerfile

@@ -13,7 +13,10 @@
 FROM node:18-alpine
 
 # better-sqlite3 原生模块编译工具（alpine/musl 无预编译二进制）
-RUN apk add --no-cache python3 make g++
+# apk 源切腾讯云镜像（默认 dl-cdn 国内不可达）；海外机构建可 --build-arg APK_MIRROR=dl-cdn.alpinelinux.org
+ARG APK_MIRROR=mirrors.cloud.tencent.com
+RUN sed -i "s|dl-cdn.alpinelinux.org|${APK_MIRROR}|g" /etc/apk/repositories \
+    && apk add --no-cache python3 make g++
 
 # 从 npm registry 全局安装已发布版本（国内机构建机可换 npmmirror）
 ARG VERSION=latest

package/README.md

@@ -12,7 +12,7 @@ npm install -g exflower-license-server
 
 # 查看版本
 exflower-license-server --version
-# 输出: 1.0.7
+# 输出: 1.3.1
 
 # 运行
 exflower-license-server
@@ -23,7 +23,19 @@ ADMIN_TOKEN=your-secret-token PORT=4001 exflower-license-server
 
 ### 方式二：Docker
 
+镜像构建直接从 npm registry 拉取已发布版本（构建机无需源码）：
+
 ```bash
+# 构建（默认 latest；指定版本用 --build-arg VERSION=x.y.z）
+docker build -t exflower/license-server:latest .
+
+# 国内构建机走镜像源（npm registry 与 alpine apk 源都可换）
+docker build \
+  --build-arg VERSION=1.3.1 \
+  --build-arg NPM_REGISTRY=https://registry.npmmirror.com \
+  --build-arg APK_MIRROR=mirrors.cloud.tencent.com \
+  -t exflower/license-server:1.3.1 .
+
 # 使用 docker-compose（推荐）
 docker-compose up -d
 
@@ -174,7 +186,7 @@ sudo systemctl enable --now exflower-license-server
 - **License 管理**：创建 License 时填写备注（如"市场部"）并选择有效期（1/3/6 个月、1 年、2 年、永久）；列表显示剩余天数（<30 天标黄、过期标红）；支持编辑（改有效期/配额）、暂停/恢复、删除、**重置 Key**
 - **品牌（白标）**：全局工作台名称设置（见下方"白标品牌名"）
 - **实例监控**：查看已激活的实例列表
-- **模板管理**：按类型选择上传方式（见下方"模板系统"），支持按 License 分发，查看导入统计
+- **模板管理**：按类型页签组织（agent/excard/doc/资料图谱），卡片式列表，支持分类管理与分类过滤、按 License 定向分发（多选），查看导入统计
 - **轻应用分发**：上传 `.exfapp` 包并按 License 隔离分发；客户端「轻应用」页可浏览/下载/导入（上限 5GB，含图谱的包注意部署机磁盘）
 - **客户端更新**：上传各平台更新包（mac 传 **zip**、win 传 NSIS **exe**），客户端启动自动检查 + 帮助菜单手动检查，electron-updater 静默下载安装（每个包 ~700MB+，注意部署机磁盘余量）
 
@@ -206,6 +218,7 @@ sudo systemctl enable --now exflower-license-server
 | `/api/license/heartbeat` | POST | 心跳上报（响应含 `brand_name`） |
 | `/api/templates` | GET | 获取模板列表（需 `x-license-key`） |
 | `/api/templates/:id` | GET | 获取模板详情（需 `x-license-key`） |
+| `/api/templates/:id/download` | GET | 下载资料图谱模板 `.exflib`（需 `x-license-key`） |
 | `/api/packages` | GET | 轻应用包列表，按公司隔离（需 `x-license-key`） |
 | `/api/packages/:id/download` | GET | 下载轻应用包（需 `x-license-key`） |
 | `/api/updates/latest.yml` | GET | Windows 更新清单（electron-updater，需 `x-license-key`） |
@@ -224,6 +237,9 @@ sudo systemctl enable --now exflower-license-server
 | `/api/admin/instances/:id` | DELETE | 删除实例 |
 | `/api/admin/templates` | GET/POST | 模板列表/创建 |
 | `/api/admin/templates/:id` | PATCH/DELETE | 更新/删除模板 |
+| `/api/admin/templates/library` | POST | 资料图谱模板上传（multipart，字段 `file`，`.exflib`） |
+| `/api/admin/template-categories` | GET/POST | 模板分类列表/创建（按类型分组） |
+| `/api/admin/template-categories/:id` | PATCH/DELETE | 分类改名/删除 |
 | `/api/admin/imports` | GET | 导入统计（支持 `?template_id=` / `?company_id=` 过滤） |
 | `/api/admin/packages` | GET/POST | 轻应用包列表/上传（multipart，字段 `file`+`company_id`） |
 | `/api/admin/packages/:id` | DELETE | 删除轻应用包 |
@@ -234,16 +250,19 @@ sudo systemctl enable --now exflower-license-server
 
 ## 模板系统
 
-模板用于向客户端分发预设配置。管理后台支持创建 `agent`、`excard`、`workflow`、`doc` 四种类型的模板。
+模板用于向客户端分发预设配置。管理后台支持 `agent`、`excard`、`doc`、`library`（资料图谱）四种类型的模板。
+
+> **workflow 类型暂不开放**：上传/下载形态待重新设计，管理台与客户端均已隐藏入口；API 与存量数据保留，重新开放前不要清理 workflow 数据。
 
 ### 上传方式（v1.0.7 起）
 
 管理后台根据类型提供不同的上传方式：
 
 - **agent / excard / doc**：**Markdown 原生上传**。直接上传客户端导出的 `.md` 文件（或粘贴 Markdown 文本），后台自动解析 frontmatter 预填模板名称并生成 `content_json`，无需手写 JSON。
-- **workflow**：仍以 JSON 描述步骤结构（步骤间的 excardId 引用和分支跳转无法由 Markdown 表达），上传框预填骨架示例。
+- **library**：上传客户端导出的 `.exflib` 包（multipart `POST /api/admin/templates/library`，字段 `file`），服务端解包校验 manifest（`format: exflower-library`）并记录文件大小与 sha256；客户端经 `GET /api/templates/:id/download` 下载导入。
+- **workflow**（暂不开放）：以 JSON 描述步骤结构，上传框预填骨架示例。
 
-通过 API 创建模板时，`content_json` 与 `content_md` 至少提供一个（`workflow` 类型必须提供 `content_json`）。
+通过 API 创建模板时，`content_json` 与 `content_md` 至少提供一个（`workflow` 类型必须提供 `content_json`；`library` 类型走专用上传端点）。
 
 ### 通用字段
 
@@ -412,9 +431,16 @@ node scripts/seed-templates.js \
 - 导入的模板均为**全局模板**（所有 License 可见）。
 - 脚本遵守 admin 接口限速（60 次/分钟），遇到 429 自动退避重试。
 
-## 构建 Docker 镜像
+## 发布新版本（厂商侧）
 
 ```bash
-docker build -t exflower/license-server:latest .
+# 1. 提升 package.json 版本号
+# 2. 确认 files 白名单覆盖全部运行时文件（activation.js / seed-templates.js /
+#    central-public.pem / seeds/ 缺一个都会发出启动即崩的包）
+npm pack --dry-run   # 检查 Tarball Contents
+# 3. 发布（npm 已下线 Classic Token，用勾了 bypass 2FA 的 Granular Token）
+npm publish
 ```
 
+Docker 镜像构建参数见上方「方式二：Docker」。
+

package/admin/index.html

@@ -415,6 +415,10 @@
         <label>Markdown 文件（直接上传客户端导出的 .md）</label>
         <input type="file" id="tmpl-md-file" accept=".md,.markdown,text/markdown,text/plain" onchange="onTemplateFileSelected(event)">
       </div>
+      <div id="tmpl-doc-zip-group" class="hidden">
+        <label>文档 zip 包（含 README.md + assets/；选择了则以包为准，下方 Markdown 忽略）</label>
+        <input type="file" id="tmpl-doc-zip" accept=".zip,application/zip">
+      </div>
       <div id="tmpl-json-group">
         <label>内容 (JSON) <span class="muted" id="tmpl-json-hint"></span></label>
         <textarea id="tmpl-json" rows="8"></textarea>
@@ -967,12 +971,15 @@
         tbody.innerHTML = '<tr><td colspan="3" class="muted" style="text-align:center;padding:16px">暂无分类</td></tr>';
         return;
       }
-      for (const c of categoriesCache) {
+      for (let i = 0; i < categoriesCache.length; i++) {
+        const c = categoriesCache[i];
         const tr = document.createElement('tr');
         tr.innerHTML = `
           <td><strong>${c.name}</strong></td>
           <td>${c.template_count}</td>
           <td>
+            <button class="btn-sm btn-plain" ${i === 0 ? 'disabled' : ''} onclick="moveCategory('${c.id}', -1)" title="上移">↑</button>
+            <button class="btn-sm btn-plain" ${i === categoriesCache.length - 1 ? 'disabled' : ''} onclick="moveCategory('${c.id}', 1)" title="下移">↓</button>
             <button class="btn-sm btn-plain" onclick="renameCategory('${c.id}')">改名</button>
             <button class="btn-sm btn-danger" onclick="deleteCategory('${c.id}', '${c.name.replace(/'/g, "\\'")}')">删除</button>
           </td>
@@ -981,6 +988,18 @@
       }
     }
 
+    async function moveCategory(id, dir) {
+      const idx = categoriesCache.findIndex(c => c.id === id);
+      const swap = idx + dir;
+      if (idx < 0 || swap < 0 || swap >= categoriesCache.length) return;
+      const ids = categoriesCache.map(c => c.id);
+      [ids[idx], ids[swap]] = [ids[swap], ids[idx]];
+      const res = await api('PUT', '/api/admin/template-categories/order', { type: currentAssetType, ids });
+      if (!res.success) return toast(res.message || '排序失败');
+      await loadCategories();
+      renderCategoryList();
+    }
+
     async function renameCategory(id) {
       const cat = categoriesCache.find(c => c.id === id);
       if (!cat) return;
@@ -1144,6 +1163,9 @@
       const isMd = MD_TYPES.includes(type);
       document.getElementById('tmpl-json-group').classList.toggle('hidden', isMd);
       document.getElementById('tmpl-md-file-group').classList.toggle('hidden', !isMd);
+      // doc zip 上传只在新建时提供（编辑模式只改元信息与 md）
+      const isDocCreate = type === 'doc' && !document.getElementById('tmpl-id').value;
+      document.getElementById('tmpl-doc-zip-group').classList.toggle('hidden', !isDocCreate);
       document.getElementById('tmpl-md-label').textContent = isMd
         ? 'Markdown 内容（上传文件后可编辑）'
         : 'Markdown 内容 (可选)';
@@ -1220,6 +1242,7 @@
       document.getElementById('tmpl-json').value = '';
       document.getElementById('tmpl-md').value = '';
       document.getElementById('tmpl-md-file').value = '';
+      document.getElementById('tmpl-doc-zip').value = '';
       populateCompanySelect();
       onTemplateTypeChange();
       document.getElementById('template-modal').classList.add('show');
@@ -1267,6 +1290,7 @@
       document.getElementById('tmpl-json').value = jsonStr;
       document.getElementById('tmpl-md').value = t.content_md || '';
       document.getElementById('tmpl-md-file').value = '';
+      document.getElementById('tmpl-doc-zip').value = '';
       onTemplateTypeChange();
       document.getElementById('template-modal').classList.add('show');
     }
@@ -1289,6 +1313,29 @@
 
       if (!name) return toast('请输入模板名称');
 
+      // 知识库文档 + 选了 zip 包：走 zip 上传通道（携带 assets），以包内 README.md 为内容
+      const docZip = type === 'doc' && !id ? document.getElementById('tmpl-doc-zip').files[0] : null;
+      if (docZip) {
+        const fd = new FormData();
+        fd.append('file', docZip);
+        fd.append('name', name);
+        fd.append('description', desc);
+        if (version) fd.append('version', version);
+        if (category !== undefined) fd.append('category', category);
+        fd.append('company_ids', JSON.stringify(companyIds));
+        const res = await fetch('/api/admin/templates/doc-upload', {
+          method: 'POST',
+          headers: { 'x-admin-token': ADMIN_TOKEN },
+          body: fd
+        });
+        const data = await res.json();
+        if (!data.success) return toast(data.message || '上传失败');
+        closeTemplateModal();
+        toast('文档包上传成功');
+        loadTemplates();
+        return;
+      }
+
       let contentJson, contentMd;
       if (type === 'workflow') {
         if (!jsonRaw) return toast('请输入 JSON 内容');

package/db.js

@@ -205,6 +205,9 @@ db.exec(`
 // 幂等列迁移：轻应用分类（受管分类 template_categories type='app'）
 try { db.exec('ALTER TABLE app_packages ADD COLUMN category TEXT'); } catch { /* 已存在 */ };
 
+// 幂等列迁移：分类手动排序（0 序并列时按 created_at，保持存量行为）
+try { db.exec('ALTER TABLE template_categories ADD COLUMN sort_order INTEGER NOT NULL DEFAULT 0'); } catch { /* 已存在 */ };
+
 // ── 轻应用定向分享（多 License 可见；语义同 template_companies） ──
 db.exec(`
   CREATE TABLE IF NOT EXISTS package_companies (

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exflower-license-server",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "ExFlower License Server - 在线授权验证服务",
   "main": "index.js",
   "bin": {

package/routes.js

@@ -574,8 +574,12 @@ function setupRoutes(app) {
     sql += ' ORDER BY type, name';
 
     const templates = queryAll(sql, params);
+    // 分类手动排序下发：客户端按服务端顺序展示分类筛选（各类型全量，体积小）
+    const orderRows = queryAll('SELECT type, name FROM template_categories ORDER BY sort_order ASC, created_at ASC');
+    const categoryOrder = {};
+    for (const r of orderRows) (categoryOrder[r.type] = categoryOrder[r.type] || []).push(r.name);
     const hint = upgradeHint(req);
-    res.json({ success: true, templates, ...(hint ? { upgrade_hint: hint } : {}) });
+    res.json({ success: true, templates, category_order: categoryOrder, ...(hint ? { upgrade_hint: hint } : {}) });
   });
 
   // Import summary (must come before /:id to avoid matching 'import-summary' as an id)
@@ -697,7 +701,7 @@ function setupRoutes(app) {
     `;
     const params = [];
     if (type) { sql += ' WHERE c.type = ?'; params.push(type); }
-    sql += ' ORDER BY c.created_at ASC';
+    sql += ' ORDER BY c.sort_order ASC, c.created_at ASC';
     const cats = queryAll(sql, params);
     // 轻应用分类的计数走 app_packages（模板计数查 templates 永远是 0）
     if (type === 'app') {
@@ -718,10 +722,25 @@ function setupRoutes(app) {
     const dup = queryGet('SELECT id FROM template_categories WHERE type = ? AND name = ?', [type, name]);
     if (dup) return res.status(409).json({ success: false, message: '该类型下分类已存在' });
     const id = generateId();
-    queryRun('INSERT INTO template_categories (id, type, name) VALUES (?, ?, ?)', [id, type, name]);
+    const maxOrder = queryGet('SELECT MAX(sort_order) AS m FROM template_categories WHERE type = ?', [type])?.m ?? -1;
+    queryRun('INSERT INTO template_categories (id, type, name, sort_order) VALUES (?, ?, ?, ?)', [id, type, name, maxOrder + 1]);
     res.json({ success: true, category: { id, type, name } });
   });
 
+  // 手动排序：按 ids 数组顺序重排该类型下分类（未列入的保持相对顺序排在末尾）
+  app.put('/api/admin/template-categories/order', requireAdmin, (req, res) => {
+    const { type, ids } = req.body || {};
+    if (!type || !Array.isArray(ids)) {
+      return res.status(400).json({ success: false, message: 'type 与 ids 必填' });
+    }
+    const rows = queryAll('SELECT id FROM template_categories WHERE type = ? ORDER BY sort_order ASC, created_at ASC', [type]);
+    const rest = rows.map(r => r.id).filter(id => !ids.includes(id));
+    [...ids, ...rest].forEach((id, i) => {
+      queryRun('UPDATE template_categories SET sort_order = ? WHERE id = ? AND type = ?', [i + 1, id, type]);
+    });
+    res.json({ success: true });
+  });
+
   app.patch('/api/admin/template-categories/:id', requireAdmin, (req, res) => {
     const cat = queryGet('SELECT * FROM template_categories WHERE id = ?', [req.params.id]);
     if (!cat) return res.status(404).json({ success: false, message: 'Category not found' });
@@ -984,6 +1003,85 @@ function setupRoutes(app) {
     }
   });
 
+  // ── Admin: 知识库文档 zip 上传（README.md + assets/，与客户端发布产物的存储契约一致） ──
+  const docZipUpload = multer({
+    storage: multer.memoryStorage(),
+    limits: { fileSize: 200 * 1024 * 1024 }
+  });
+  const DOC_ASSET_MIMES = {
+    '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif', '.svg': 'image/svg+xml', '.webp': 'image/webp',
+    '.pdf': 'application/pdf', '.md': 'text/markdown', '.txt': 'text/plain',
+  };
+  app.post('/api/admin/templates/doc-upload', requireAdmin, docZipUpload.single('file'), async (req, res) => {
+    try {
+      if (!req.file) return res.status(400).json({ success: false, message: 'file is required' });
+
+      let zip;
+      try {
+        zip = await unzipper.Open.buffer(req.file.buffer);
+      } catch {
+        return res.status(400).json({ success: false, message: '无效的 zip 包' });
+      }
+      const readme = zip.files.find(f => f.type === 'File' && f.path.toLowerCase() === 'readme.md');
+      if (!readme) {
+        return res.status(400).json({ success: false, message: '无效的文档包：根目录缺少 README.md' });
+      }
+      const contentMd = (await readme.buffer()).toString('utf8');
+
+      const assets = [];
+      for (const f of zip.files) {
+        if (f.type !== 'File' || !f.path.startsWith('assets/')) continue;
+        const filename = path.basename(f.path);
+        if (!filename) continue;
+        const buf = await f.buffer();
+        assets.push({
+          filename,
+          mimeType: DOC_ASSET_MIMES[path.extname(filename).toLowerCase()] || 'application/octet-stream',
+          data: buf.toString('base64'),
+        });
+      }
+
+      const { company_id, category, version } = req.body || {};
+      let shareIds = null;
+      if (req.body?.company_ids) {
+        try { shareIds = JSON.parse(req.body.company_ids).filter(Boolean); } catch { shareIds = null; }
+      }
+      if (company_id && !shareIds) {
+        const company = queryGet('SELECT id FROM companies WHERE id = ?', [company_id]);
+        if (!company) return res.status(404).json({ success: false, message: 'Company not found' });
+      }
+
+      const h1 = contentMd.match(/^#\s+(.+)$/m)?.[1]?.trim();
+      const name = (req.body?.name || '').trim() || h1 || '未命名文档';
+      const id = generateId();
+      queryRun(
+        `INSERT INTO templates (id, company_id, type, name, description, content_json, content_md, tags, category, version, created_at, updated_at)
+         VALUES (?, ?, 'doc', ?, ?, ?, ?, '[]', ?, ?, datetime('now'), datetime('now'))`,
+        [
+          id,
+          shareIds ? null : (company_id || null),
+          name,
+          (req.body?.description || '').trim(),
+          JSON.stringify({ assets }),
+          contentMd,
+          category || null,
+          (version || '').trim() || '1.0',
+        ]
+      );
+      if (shareIds && shareIds.length) {
+        const err = setTemplateCompanies(id, shareIds);
+        if (err) {
+          queryRun('DELETE FROM templates WHERE id = ?', [id]);
+          return res.status(404).json({ success: false, message: err });
+        }
+      }
+      res.json({ success: true, template: { id, name, assets: assets.length } });
+    } catch (err) {
+      res.status(500).json({ success: false, message: err.message });
+    }
+  });
+
   // ── Template Import Log (client-facing) ──
   app.post('/api/templates/:id/import-log', (req, res) => {
     const licenseKey = req.headers['x-license-key'];