feat: new short code format for operation set

Author: guansss

src/apis/operation.ts

@@ -4,7 +4,7 @@ import useSWRInfinite from 'swr/infinite'
 
 import { toCopilotOperation } from 'models/converter'
 import { OpRatingType, Operation } from 'models/operation'
-import { parseShortCode } from 'models/shortCode'
+import { ShortCodeContent, parseShortCode } from 'models/shortCode'
 import { OperationApi } from 'utils/maa-copilot-client'
 import { useSWRRefresh } from 'utils/swr'
 
@@ -48,16 +48,32 @@ export function useOperations({
         return null // reached the end
       }
 
-      // 用户输入 maa://xxxxxx 时，只传这个 id，其他参数都不传
+      // 用户输入神秘代码时，只传这个 id，其他参数都不传
       if (keyword) {
-        const id = parseShortCode(keyword)
+        let content: ShortCodeContent | null = null
+
+        try {
+          content = parseShortCode(keyword)
+        } catch (e) {
+          console.warn(e)
+        }
+
+        if (content) {
+          let error: string | undefined
+
+          if (content.type === 'operationSet') {
+            error = '该神秘代码属于作业集，无法在此使用⊙﹏⊙∥'
+          }
 
-        if (id) {
           return [
             'operations',
             {
-              copilotIds: [id],
+              copilotIds: [content.id],
             } satisfies QueriesCopilotRequest,
+
+            // 如果直接抛出 error 的话，useSWRInfinite 会把这个 error 吞掉，所以传到 fetcher 里再抛出
+            // https://github.com/vercel/swr/issues/2102
+            error,
           ]
         }
       }
@@ -77,7 +93,11 @@ export function useOperations({
         } satisfies QueriesCopilotRequest,
       ]
     },
-    async ([, req]) => {
+    async ([, req, error]) => {
+      if (error) {
+        throw new Error(error)
+      }
+
       // 如果指定了 id 列表，但是列表为空，就直接返回空数据。不然要是直接传空列表，就相当于没有这个参数，
       // 会导致后端返回所有数据
       if (req.copilotIds?.length === 0) {

src/components/OperationCard.tsx

@@ -2,7 +2,7 @@ import { Button, Card, Elevation, H4, H5, Icon, Tag } from '@blueprintjs/core'
 import { Tooltip2 } from '@blueprintjs/popover2'
 
 import clsx from 'clsx'
-import { handleCopyShortCode, handleDownloadJSON } from 'services/operation'
+import { copyShortCode, handleDownloadJSON } from 'services/operation'
 
 import { ReLink } from 'components/ReLink'
 import { RelativeTime } from 'components/RelativeTime'
@@ -263,7 +263,7 @@ const CardActions = ({
         <Button
           small
           icon="clipboard"
-          onClick={() => handleCopyShortCode(operation)}
+          onClick={() => copyShortCode(operation)}
         />
       </Tooltip2>
       <Tooltip2

src/components/OperationSetCard.tsx

@@ -1,7 +1,7 @@
 import { Button, Card, Elevation, H4, Icon, Tag } from '@blueprintjs/core'
 import { Tooltip2 } from '@blueprintjs/popover2'
 
-import { handleCopyShortCode } from 'services/operation'
+import { copyShortCode } from 'services/operation'
 
 import { ReLink } from 'components/ReLink'
 import { RelativeTime } from 'components/RelativeTime'
@@ -163,7 +163,7 @@ const CardActions = ({
           icon="clipboard"
           onClick={(e) => {
             e.stopPropagation()
-            handleCopyShortCode(operationSet)
+            copyShortCode(operationSet)
           }}
         />
       </Tooltip2>

src/components/editor/source/ShortCodeImporter.tsx

@@ -41,12 +41,18 @@ export const ShortCodeImporter: FC<{
     try {
       setPending(true)
 
-      const id = parseShortCode(code)
+      const shortCodeContent = parseShortCode(code)
 
-      if (!id) {
+      if (!shortCodeContent) {
         throw new Error('无效的神秘代码')
       }
 
+      const { type, id } = shortCodeContent
+
+      if (type === 'operationSet') {
+        throw new Error('该神秘代码属于作业集，无法在此使用⊙﹏⊙∥')
+      }
+
       const operationContent = (await getOperation({ id })).parsedContent
 
       if (operationContent === INVALID_OPERATION_CONTENT) {

src/components/viewer/OperationSetViewer.tsx

@@ -19,7 +19,7 @@ import {
 } from 'apis/operation-set'
 import { useAtom } from 'jotai'
 import { ComponentType, FC, useEffect, useState } from 'react'
-import { handleCopyShortCode } from 'services/operation'
+import { copyShortCode } from 'services/operation'
 
 import { FactItem } from 'components/FactItem'
 import { OperationList } from 'components/OperationList'
@@ -179,7 +179,7 @@ export const OperationSetViewer: ComponentType<{
               icon="clipboard"
               text="复制神秘代码"
               intent="primary"
-              onClick={() => handleCopyShortCode(operationSet)}
+              onClick={() => copyShortCode(operationSet)}
             />
           </>
         }

src/components/viewer/OperationViewer.tsx

@@ -24,7 +24,7 @@ import {
 import { useAtom } from 'jotai'
 import { ComponentType, FC, useEffect, useState } from 'react'
 import { Link } from 'react-router-dom'
-import { handleCopyShortCode, handleDownloadJSON } from 'services/operation'
+import { copyShortCode, handleDownloadJSON } from 'services/operation'
 
 import { FactItem } from 'components/FactItem'
 import { Paragraphs } from 'components/Paragraphs'
@@ -216,7 +216,7 @@ export const OperationViewer: ComponentType<{
               icon="clipboard"
               text="复制神秘代码"
               intent="primary"
-              onClick={() => handleCopyShortCode(operation)}
+              onClick={() => copyShortCode(operation)}
             />
           </>
         }

src/models/shortCode.ts

@@ -1,14 +1,44 @@
-import { Operation } from './operation'
+/*
+ * operation:    maa://123456
+ * operationSet: maa://c123456
+ */
 
-export const shortCodeScheme = 'maa://'
+const shortCodeScheme = 'maa://'
 
-export function toShortCode(id: Operation['id']) {
-  return shortCodeScheme + id
+export interface ShortCodeContent {
+  id: number
+  type: 'operation' | 'operationSet'
 }
 
-export function parseShortCode(code: string): number | null {
+export function toShortCode({ id, type }: ShortCodeContent) {
+  if (type === 'operation') {
+    return shortCodeScheme + id
+  } else if (type === 'operationSet') {
+    return shortCodeScheme + 'c' + id
+  }
+  throw new Error('无效的神秘代码类型')
+}
+
+export function parseShortCode(code: string): ShortCodeContent | null {
   if (code.startsWith(shortCodeScheme)) {
-    return +code.slice(shortCodeScheme.length) || null
+    const idStr = code.slice(shortCodeScheme.length)
+    let content: ShortCodeContent
+
+    if (idStr.startsWith('c')) {
+      content = {
+        id: +idStr.slice(1),
+        type: 'operationSet',
+      }
+    } else {
+      content = {
+        id: +idStr,
+        type: 'operation',
+      }
+    }
+
+    if (!isNaN(content.id)) {
+      return content
+    }
   }
   return null
 }

src/services/operation.ts

@@ -1,7 +1,8 @@
 import { AppToaster } from 'components/Toaster'
 
 import { CopilotDocV1 } from '../models/copilot.schema'
-import { toShortCode } from '../models/shortCode'
+import { ShortCodeContent, toShortCode } from '../models/shortCode'
+import { formatError } from '../utils/error'
 import { snakeCaseKeysUnicode } from '../utils/object'
 
 export const handleDownloadJSON = (operationDoc: CopilotDocV1.Operation) => {
@@ -28,12 +29,30 @@ export const handleDownloadJSON = (operationDoc: CopilotDocV1.Operation) => {
   })
 }
 
-export const handleCopyShortCode = (operation: { id: number }) => {
-  const shortCode = toShortCode(operation.id)
-  navigator.clipboard.writeText(shortCode)
+/**
+ * @param target - Either an operation or an operation set
+ */
+export const copyShortCode = async (target: {
+  id: number
+  copilotIds?: number[]
+}) => {
+  try {
+    const content: ShortCodeContent = {
+      id: target.id,
+      type: target.copilotIds ? 'operationSet' : 'operation',
+    }
 
-  AppToaster.show({
-    message: '已复制神秘代码，前往 MAA 粘贴即可使用~',
-    intent: 'success',
-  })
+    const shortCode = toShortCode(content)
+    navigator.clipboard.writeText(shortCode)
+
+    AppToaster.show({
+      message: '已复制神秘代码，前往 MAA 粘贴即可使用~',
+      intent: 'success',
+    })
+  } catch (e) {
+    AppToaster.show({
+      message: '复制神秘代码失败：' + formatError(e),
+      intent: 'danger',
+    })
+  }
 }