smart-admin-web 10.10.0 → 10.11.0

package/README.md

@@ -49,6 +49,7 @@ createSmartAdmin({
 | `locales` | 文案。`locales/ext/<locale>/<命名空间>.ts` 默认导出该命名空间的键，按命名空间深合并进内置文案 |
 | `routes` | 布局壳之外的顶级静态路由，比如整屏看板、打印页 |
 | `icons` | 本地 SVG：`import.meta.glob('./assets/svg/*.svg', { query: '?raw', import: 'default', eager: true })` |
+| `iconSets` | 应用自己的 `ph` 图标子集，启动时同步注册。用包带的命令生成：`npx smart-admin-icons` 扫描 `src` 里的 `ph:*` 名字，写出 `src/assets/icons/ph-subset.json`；`--check` 给 CI 用 |
 | `menuTitles` | 菜单 path → i18n key，存量库的菜单标题是中文时用 |
 | `install(app)` | 需要 app 实例的注册：`registerHeaderTool`、`registerMenuBadge`、自己的 `app.use` |
 | `plugins` | 与上面同形的插件对象。覆盖顺序：内核 < 插件（按数组顺序）< 应用 |

package/cli/icon-subset.mjs

@@ -0,0 +1,132 @@
+// Phosphor 图标子集:扫描源码里的 ph:* 名字,从 @iconify-json/ph 整集裁出用到的那几个。
+// 内核的 scripts/gen-icon-subset.mjs 与随包发布的 smart-admin-icons 命令共用这一份,本模块没有副作用。
+//
+// 为什么要子集:整套 ph 有 9000+ 个图标(4.5 MB / 946 KB gz),一个应用的静态代码只用到几十个。
+// 启动时同步注册子集,首帧即可离线渲染;子集外的名字(菜单管理里配的图标)由 AppIcon 懒加载整集兜底。
+//
+// 裁剪不引 @iconify/utils:这里只用得到它的 getIcons,它却会给每个消费方多装三个传递依赖。
+// buildSubset 与 getIcons(data, names, true) 的产物逐字节一致,由 src/lib/iconSubset.spec.ts 拿 getIcons 对照锁住。
+
+import { readFile, readdir, writeFile, mkdir } from 'node:fs/promises'
+import { createRequire } from 'node:module'
+import path from 'node:path'
+
+const require = createRequire(import.meta.url)
+
+export const PREFIX = 'ph'
+
+const SCAN_EXT = new Set(['.vue', '.ts', '.tsx', '.js', '.jsx', '.mjs'])
+// 测试文件里的假图标名不进产物
+const TEST_FILE = /\.(spec|test)\.[^.]+$/
+const ICON_RE = /\bph:[a-z0-9]+(?:-[a-z0-9]+)*\b/g
+
+// 整集级的尺寸与 provider 字段,裁出的子集原样带上(同 getIcons 的 propsToCopy)
+const ROOT_PROPS = ['left', 'top', 'width', 'height', 'provider']
+
+/** 递归扫描目录,收集全部 `ph:xxx` 引用并入 `extra`,去重后升序返回。跳过 node_modules 与 . 开头的目录。 */
+export async function scanIconNames(srcDir, extra = []) {
+  const found = new Set(extra)
+  async function walk(dir) {
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name)
+      if (entry.isDirectory()) {
+        if (entry.name !== 'node_modules' && !entry.name.startsWith('.')) await walk(full)
+        continue
+      }
+      if (!SCAN_EXT.has(path.extname(entry.name)) || TEST_FILE.test(entry.name)) continue
+      const text = await readFile(full, 'utf8')
+      for (const m of text.matchAll(ICON_RE)) found.add(m[0])
+    }
+  }
+  await walk(srcDir)
+  return [...found].toSorted()
+}
+
+/** 读取完整的 @iconify-json/ph 图标集。它是本包的依赖,从本模块所在位置解析,消费方不必自己装。 */
+export async function loadFullSet() {
+  return JSON.parse(await readFile(require.resolve('@iconify-json/ph/icons.json'), 'utf8'))
+}
+
+/**
+ * 按名字裁出子集;`missing` 是 ph 里查无此名的(基本都是拼错)。别名沿 parent 链追到真图标,
+ * 链上每一环都进子集。结果的键序、别名处理与 getIcons 相同:prefix、icons、lastModified、aliases,最后是整集级字段。
+ */
+export function buildSubset(full, names) {
+  const bare = names.map(n => (n.startsWith(`${PREFIX}:`) ? n.slice(PREFIX.length + 1) : n))
+  const sourceIcons = full.icons
+  const sourceAliases = full.aliases || Object.create(null)
+
+  // 名字 → 追到真图标所经的 parent 链([] = 本身就是图标,null = 查无此名或链断了)
+  const resolved = Object.create(null)
+  const resolve = name => {
+    if (sourceIcons[name]) return (resolved[name] = [])
+    if (!(name in resolved)) {
+      resolved[name] = null
+      const parent = sourceAliases[name] && sourceAliases[name].parent
+      const chain = parent && resolve(parent)
+      if (chain) resolved[name] = [parent, ...chain]
+    }
+    return resolved[name]
+  }
+  bare.forEach(resolve)
+
+  const subset = { prefix: full.prefix, icons: Object.create(null) }
+  if (full.lastModified) subset.lastModified = full.lastModified
+  const missing = []
+  for (const name in resolved) {
+    if (!resolved[name]) {
+      if (bare.includes(name)) missing.push(`${PREFIX}:${name}`)
+    } else if (sourceIcons[name]) {
+      subset.icons[name] = { ...sourceIcons[name] }
+    } else {
+      subset.aliases ??= Object.create(null)
+      subset.aliases[name] = { ...sourceAliases[name] }
+    }
+  }
+  for (const key of ROOT_PROPS) if (key in full) subset[key] = full[key]
+  return { subset, missing }
+}
+
+/** 与写盘一致的序列化(--check 靠逐字节比对)。 */
+export function serialize(subset) {
+  return `${JSON.stringify(subset, null, 2)}\n`
+}
+
+/**
+ * 扫描 `src`、裁出子集后写进 `out`;`check` 为真时只比对不写盘。`extra` 是源码里没有、也要进子集的名字,
+ * `staleHint` 接在「已过期」提示后面告诉人怎么重生成。返回进程退出码:0 成功,1 有拼错的名字或产物已过期。
+ */
+export async function generate({ src, out, check = false, extra = [], staleHint }) {
+  let names
+  try {
+    names = await scanIconNames(src, extra)
+  } catch (e) {
+    if (e?.code !== 'ENOENT') throw e
+    console.error(`扫描目录不存在:${src}`)
+    return 1
+  }
+
+  const { subset, missing } = buildSubset(await loadFullSet(), names)
+  if (missing.length) {
+    console.error(`图标名在 Phosphor 里不存在(拼错?):\n  ${missing.join('\n  ')}`)
+    return 1
+  }
+
+  const text = serialize(subset)
+  const count = Object.keys(subset.icons).length
+  const shown = path.relative(process.cwd(), out) || out
+  if (check) {
+    const current = await readFile(out, 'utf8').catch(() => '')
+    if (current !== text) {
+      console.error(`${shown} 已过期,${staleHint}`)
+      return 1
+    }
+    console.log(`图标子集已是最新(${count} 个)`)
+    return 0
+  }
+
+  await mkdir(path.dirname(out), { recursive: true })
+  await writeFile(out, text, 'utf8')
+  console.log(`已写出 ${shown}(${count} 个图标)`)
+  return 0
+}

package/cli/smart-admin-icons.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+// smart-admin-icons:给应用生成自己的 ph 离线图标子集,交给 createSmartAdmin({ iconSets }) 启动时同步注册。
+// 扫描、裁剪、--check 的逻辑在 icon-subset.mjs,本文件只解析参数。退出码:0 成功;1 图标名拼错或 --check 下产物过期;2 参数错误。
+//
+// 不加「被 import 时不执行」的守卫:npm 在 POSIX 上把 node_modules/.bin 里的命令做成符号链接,
+// process.argv[1] 是链接路径而不是本文件,拿它和 import.meta.url 比对,命令会静默什么都不做。
+
+import path from 'node:path'
+import { generate } from './icon-subset.mjs'
+
+const USAGE = `用法:smart-admin-icons [--src <目录>] [--out <文件>] [--check]
+
+扫描 --src 下 .vue/.ts/.tsx/.js/.jsx/.mjs 里的 ph:* 图标名(跳过 *.spec.*、*.test.*、node_modules),
+从 Phosphor 整集裁出这些图标写进 --out,交给 createSmartAdmin({ iconSets }) 启动时同步注册。
+源码里没有、却要离线可用的名字(比如种子菜单的图标),写进 --src 下任意一个 .ts 就会被扫进来。
+
+  --src <目录>   扫描根,默认 src
+  --out <文件>   产物路径,默认 src/assets/icons/ph-subset.json
+  --check        只比对不写盘:产物过期或有拼错的名字时非 0 退出(CI 用)
+  --help         显示本说明`
+
+function parseArgs(argv) {
+  const opts = { src: 'src', out: 'src/assets/icons/ph-subset.json', check: false, help: false }
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i]
+    if (arg === '--check') opts.check = true
+    else if (arg === '--help' || arg === '-h') opts.help = true
+    else {
+      // --src x 与 --src=x 两种写法都认
+      const m = /^--(src|out)(?:=(.*))?$/.exec(arg)
+      if (!m) throw new Error(`未知参数:${arg}`)
+      const value = m[2] ?? argv[++i]
+      if (!value || value.startsWith('--')) throw new Error(`--${m[1]} 缺少值`)
+      opts[m[1]] = value
+    }
+  }
+  return opts
+}
+
+let opts
+try {
+  opts = parseArgs(process.argv.slice(2))
+} catch (e) {
+  console.error(`${e.message}\n\n${USAGE}`)
+  process.exitCode = 2
+}
+
+if (opts?.help) {
+  console.log(USAGE)
+} else if (opts) {
+  process.exitCode = await generate({
+    src: path.resolve(opts.src),
+    out: path.resolve(opts.out),
+    check: opts.check,
+    staleHint: '去掉 --check 再跑一次即可更新',
+  })
+}

package/dist/api/index.d.ts

@@ -1,5 +1,5 @@
 import { components } from './schema';
-import { AddUserInput, AddUserOutput, ChunkInitOutput, ConfigInput, CronPreviewOutput, DashboardSummary, DataScopeType, DictItem, DictItemInput, DictTypeInput, DuplicateStrategy, FileUploadOutput, ImportCommitResult, ImportPreview, ImportRow, JobDashboard, JobHandlersOutput, JobInput, LoginOutput, ModuleInput, ModuleRow, MyModulesOutput, MySessionItem, NoticeMineItem, NoticePublishInput, OnlineSessionItem, OrgInput, PermissionRouteItem, PositionInput, RoleInput, ServerInfoOutput, SysConfig, SysDictItem, SysDictType, SysExceptionLog, SysFile, SysJob, SysJobLog, SysLoginLog, SysNotice, SysOpLog, SysOrg, SysPosition, SysRole, SysRoleDataScope, UpdateUserInput, UserDetail, UserItem, UserProfile } from '../types/api';
+import { AddUserInput, AddUserOutput, AiProviderAddInput, AiProviderPreset, AiProviderUpdateInput, AiProviderView, AiTestResult, AiUsageGroupBy, AiUsageSummary, AiUsageTrendPoint, ChunkInitOutput, ConfigInput, CronPreviewOutput, DashboardSummary, DataScopeType, DictItem, DictItemInput, DictTypeInput, DuplicateStrategy, FileUploadOutput, ImportCommitResult, ImportPreview, ImportRow, JobDashboard, JobHandlersOutput, JobInput, LoginOutput, ModuleInput, ModuleRow, MyModulesOutput, MySessionItem, NoticeMineItem, NoticePublishInput, OnlineSessionItem, OrgInput, PermissionRouteItem, PositionInput, RoleInput, ServerInfoOutput, SysAiUsageLog, SysConfig, SysDictItem, SysDictType, SysExceptionLog, SysFile, SysJob, SysJobLog, SysLoginLog, SysNotice, SysOpLog, SysOrg, SysPosition, SysRole, SysRoleDataScope, UpdateUserInput, UserDetail, UserItem, UserProfile } from '../types/api';
 import { MenuInput, MenuNode, MenuTreeNode } from '../types/menu';
 /** 业务错误(含后端 code / msgKey);视图 catch 后经 translateError 展示。 */
 export declare class ApiError extends Error {
@@ -670,3 +670,54 @@ export declare const recycleApi: {
     restore: (type: string, id: number) => Promise<boolean>;
     purge: (type: string, id: number) => Promise<boolean>;
 };
+export declare const aiProviderApi: {
+    /** 厂商分页(含模型清单);搜索键 keyword/enabled → PascalCase 查询参。 */
+    page: (params: {
+        page: number;
+        pageSize: number;
+        keyword?: string;
+        enabled?: boolean;
+    }) => Promise<{
+        items: AiProviderView[];
+        total: number;
+    }>;
+    get: (id: number) => Promise<AiProviderView>;
+    /** 厂商预置清单(协议/BaseUrl/鉴权方式/起步模型),新增抽屉选预设用。 */
+    presets: () => Promise<AiProviderPreset[]>;
+    add: (body: AiProviderAddInput) => Promise<number>;
+    /** 更新入参没有 preset/protocol 字段——这两项创建后不可改,类型层面就不给改的机会。 */
+    update: (id: number, body: AiProviderUpdateInput) => Promise<boolean>;
+    /** 启用时若未配置 Key 会被后端拒绝(49004),调用方按 StatusSwitch 模式处理失败回弹。 */
+    setEnabled: (id: number, enabled: boolean) => Promise<boolean>;
+    remove: (id: number) => Promise<boolean>;
+    /** 测试连接:用库里当前配置发一条最小对话;失败原因在返回体里,不抛异常。 */
+    test: (id: number) => Promise<AiTestResult>;
+};
+interface AiUsageFilter {
+    from: string;
+    to: string;
+    providerCode?: string;
+    model?: string;
+    scene?: string;
+    userId?: number;
+}
+export declare const aiUsageApi: {
+    /** 区间总计 + 按维度分组聚合(groupBy 切换四个 Tab 共用这一个接口)。 */
+    summary: (params: AiUsageFilter & {
+        groupBy: AiUsageGroupBy;
+    }) => Promise<AiUsageSummary>;
+    /** 按天趋势;区间内无数据的日期后端已补 0,前端直接画连续折线。 */
+    trend: (params: AiUsageFilter) => Promise<AiUsageTrendPoint[]>;
+    /** 明细分页(不聚合);from/to 在这里是可选的(不筛日期就是全量分页)。 */
+    page: (params: Omit<AiUsageFilter, "from" | "to"> & {
+        page: number;
+        pageSize: number;
+        from?: string;
+        to?: string;
+        success?: boolean;
+    }) => Promise<{
+        items: SysAiUsageLog[];
+        total: number;
+    }>;
+};
+export {};