exflower-license-server 1.0.7 → 1.0.8

package/README.md

@@ -12,7 +12,7 @@ npm install -g exflower-license-server
 
 # 查看版本
 exflower-license-server --version
-# 输出: 1.0.2
+# 输出: 1.0.7
 
 # 运行
 exflower-license-server
@@ -145,9 +145,9 @@ sudo systemctl enable --now exflower-license-server
 启动后访问 `http://localhost:4001/admin`，使用 `ADMIN_TOKEN` 登录。
 
 管理后台功能：
-- **企业管理**：创建/编辑/禁用/删除公司，设置授权配额
+- **企业管理**：创建公司时可选择有效期（1/3/6 个月、1 年、2 年、永久）；列表显示剩余天数（<30 天标黄、过期标红）；支持编辑（改有效期/配额）、暂停/恢复、删除
 - **实例管理**：查看已激活的实例列表
-- **模板管理**：上传/编辑/删除模板（agent/crew/excard/workflow），支持按公司分发，查看导入统计（次数/公司/实例）
+- **模板管理**：按类型选择上传方式（见下方"模板系统"），支持按公司分发，查看导入统计（次数/公司/实例）
 
 ## API 端点
 
@@ -177,17 +177,26 @@ sudo systemctl enable --now exflower-license-server
 
 ## 模板系统
 
-模板用于向客户端分发预设配置。管理后台支持创建 `agent`、`crew`、`excard`、`workflow`、`doc` 五种类型的模板。
+模板用于向客户端分发预设配置。管理后台支持创建 `agent`、`excard`、`workflow`、`doc` 四种类型的模板。
+
+### 上传方式（v1.0.7 起）
+
+管理后台根据类型提供不同的上传方式：
+
+- **agent / excard / doc**：**Markdown 原生上传**。直接上传客户端导出的 `.md` 文件（或粘贴 Markdown 文本），后台自动解析 frontmatter 预填模板名称并生成 `content_json`，无需手写 JSON。
+- **workflow**：仍以 JSON 描述步骤结构（步骤间的 excardId 引用和分支跳转无法由 Markdown 表达），上传框预填骨架示例。
+
+通过 API 创建模板时，`content_json` 与 `content_md` 至少提供一个（`workflow` 类型必须提供 `content_json`）。
 
 ### 通用字段
 
 | 字段 | 必填 | 说明 |
 |------|------|------|
-| `type` | 是 | 模板类型：`agent` / `crew` / `excard` / `workflow` / `doc` |
+| `type` | 是 | 模板类型：`agent` / `excard` / `workflow` / `doc` |
 | `name` | 是 | 模板名称 |
 | `description` | 否 | 模板简介（一句话描述） |
-| `content_json` | 是 | 结构化数据（JSON 对象），各类型字段见下方 |
-| `content_md` | 否 | Markdown 格式说明文档，部分类型必须 |
+| `content_json` | 视类型 | 结构化数据（JSON 对象）；`workflow` 必填，其余类型可由 `content_md` 代替 |
+| `content_md` | 视类型 | Markdown 内容；`agent` / `excard` / `doc` 推荐以此为主 |
 | `company_id` | 否 | `NULL` = 全局模板（所有公司可见）；指定公司 ID = 仅该公司可见 |
 | `tags` | 否 | 标签数组 JSON，如 `["营销", "运营"]` |
 | `version` | 否 | 版本号，默认 `1.0` |
@@ -196,9 +205,9 @@ sudo systemctl enable --now exflower-license-server
 
 #### `agent` — Agent 成员模板
 
-用于创建 CrewAI Agent。
+用于创建 CrewAI Agent。**推荐直接上传客户端 agent 的 `.md` 文件**（YAML frontmatter + Backstory/Experience 正文），frontmatter 字段即 `content_json`。
 
-**content_json 字段：**
+**frontmatter / content_json 字段：**
 
 | 字段 | 必填 | 类型 | 说明 |
 |------|------|------|------|
@@ -217,6 +226,18 @@ sudo systemctl enable --now exflower-license-server
 **content_md 格式（推荐提供）：**
 
 ```markdown
+---
+id: agent-xxx
+name: 小红书运营专家
+role: 小红书内容运营与增长策略师
+goal: 帮助用户制定并执行高效的小红书内容策略
+tools: []
+allowDelegation: false
+maxIter: 25
+memory: true
+allowScriptExecution: disabled
+---
+
 # Backstory
 
 Agent 的完整背景故事，支持 Markdown 格式...
@@ -231,33 +252,11 @@ Agent 的完整背景故事，支持 Markdown 格式...
 
 ---
 
-#### `crew` — 项目组模板
-
-用于创建 Crew（Agent 团队）。
-
-**content_json 字段：**
-
-| 字段 | 必填 | 类型 | 说明 |
-|------|------|------|------|
-| `name` | 是 | string | 项目组名称 |
-| `description` | 否 | string | 项目组描述 |
-| `agentIds` | 否 | string[] | 成员 Agent ID 列表 |
-| `tasks` | 否 | object[] | 任务列表，每个任务包含： |
-| `tasks[].id` | 是 | string | 任务 ID |
-| `tasks[].agentId` | 是 | string | 执行任务的 Agent ID |
-| `tasks[].description` | 是 | string | 任务描述 |
-| `tasks[].order` | 否 | number | 执行顺序 |
-| `tasks[].expectedOutput` | 否 | string | 期望输出 |
-| `process` | 否 | string | 执行流程：`sequential`（顺序）/ `hierarchical`（层级），默认 `sequential` |
-| `managerAgentId` | 否 | string | Manager Agent ID（层级流程时必填） |
-
----
-
 #### `excard` — ExCard 执行模板
 
-用于创建工作流执行的 ExCard 模板。
+用于创建工作流执行的 ExCard 模板。**推荐直接上传客户端导出的标准 ExCard `.md` 文件**（与客户端"导出 ExCard"产物格式一致）：模板只需存 `content_md`，客户端导入时走标准 MD 导入链路（`POST /api/excards/import`），由客户端解析为结构化数据。frontmatter 会被后台自动提取为 `content_json` 用于列表展示。
 
-**content_json 字段：**
+**frontmatter / content_json 字段：**
 
 | 字段 | 必填 | 类型 | 说明 |
 |------|------|------|------|
@@ -271,7 +270,7 @@ Agent 的完整背景故事，支持 Markdown 格式...
 
 **content_md 格式（必须提供）：**
 
-ExCard 的完整 Markdown 文档，包含执行约定、资源依赖、工作流步骤等。
+ExCard 的完整 Markdown 文档（frontmatter + 资源依赖 + 执行步骤 + 执行约定），与客户端 `~/.exflower/excards-md/` 下的文件格式一致。
 
 ---
 

package/package.json

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

package/routes.js

@@ -267,11 +267,18 @@ function setupRoutes(app) {
       return res.status(404).json({ success: false, message: 'Invalid license key' });
     }
 
-    const rows = queryAll(
-      `SELECT template_id, COUNT(*) as count, MIN(imported_at) as first_import, MAX(imported_at) as last_import
-       FROM template_imports WHERE company_id = ? GROUP BY template_id`,
-      [company.id]
-    );
+    // 按设备过滤：导入状态跟着设备（instance_id）走，而非激活码；
+    // 未传 instance_id 的旧版客户端保持 company 级聚合（向后兼容）
+    const instanceId = req.query.instance_id;
+    let sql = `SELECT template_id, COUNT(*) as count, MIN(imported_at) as first_import, MAX(imported_at) as last_import
+       FROM template_imports WHERE company_id = ?`;
+    const params = [company.id];
+    if (instanceId) {
+      sql += ' AND instance_id = ?';
+      params.push(instanceId);
+    }
+    sql += ' GROUP BY template_id';
+    const rows = queryAll(sql, params);
     const map = {};
     for (const r of rows) {
       map[r.template_id] = { count: r.count, first_import: r.first_import, last_import: r.last_import };
@@ -511,11 +518,16 @@ function setupRoutes(app) {
       return res.status(404).json({ success: false, message: 'Invalid license key' });
     }
 
-    const stats = queryGet(
-      `SELECT COUNT(*) as count, MIN(imported_at) as first_import, MAX(imported_at) as last_import
-       FROM template_imports WHERE template_id = ? AND company_id = ?`,
-      [req.params.id, company.id]
-    );
+    // 按设备过滤（见 import-summary 注释）
+    const instanceId = req.query.instance_id;
+    let sql = `SELECT COUNT(*) as count, MIN(imported_at) as first_import, MAX(imported_at) as last_import
+       FROM template_imports WHERE template_id = ? AND company_id = ?`;
+    const params = [req.params.id, company.id];
+    if (instanceId) {
+      sql += ' AND instance_id = ?';
+      params.push(instanceId);
+    }
+    const stats = queryGet(sql, params);
     res.json({ success: true, imported: stats.count > 0, count: stats.count, first_import: stats.first_import, last_import: stats.last_import });
   });