feat: import tasks

Author: sylingd

docs/docs/zh-CN/guide/custom-function.md

@@ -127,7 +127,9 @@ if (detail.type === "media") {
 
 函数列表如下：
 * 通过 `this._` 调用部分 [lodash](https://lodash.com/docs/4.17.21) 函数：clone, cloneDeep, cloneDeepWith, cloneWith, difference, differenceBy, differenceWith, eq, first, flatten, get, has, head, isEqual, isEqualWith, last, pick, pickBy, random, set, setWith, uniq, uniqBy, uniqWith
+* 通过 `this.nanoid` 生成随机字符串。
 * 通过 `this.task` 获取任务相关内容。请参考[任务](./task.md)
+  * 注意：不建议解构后使用 Task 相关函数，可能影响导入/导出功能。
 * 注意：storage 仅在任务的自定义函数中可用，规则中无 `this.sessionStorage` 及 `this.localStorage`
 
 相关函数定义如下：
@@ -145,6 +147,14 @@ declare const this: {
 }
 ```
 
+例如：
+```ts
+if (detail.type === "media") {
+  const run = this.task.getValidRun("exampleTask");
+	return val.replace("example.com", run ? run.result.url : "example.org");
+}
+```
+
 ## 如何调试自定义函数
 
 所有自定义函数的运行均位于后台页面，因此，要调试自定义函数，请打开后台页面的控制台

docs/docs/zh-CN/guide/task.md

@@ -80,10 +80,12 @@ return res.json();
 
 函数列表如下：
 * 通过 `this._` 调用部分 [lodash](https://lodash.com/docs/4.17.21) 函数：clone, cloneDeep, cloneDeepWith, cloneWith, difference, differenceBy, differenceWith, eq, first, flatten, get, has, head, isEqual, isEqualWith, last, pick, pickBy, random, set, setWith, uniq, uniqBy, uniqWith
+* 通过 `this.nanoid` 生成随机字符串。
 * 通过 `this.task` 获取任务相关内容。
   * `this.task.get`: 获取任务信息。
   * `this.task.getLastRun`: 获取任务上一次运行结果。
   * `this.task.getValidRun`: 获取任务上一次成功运行的结果。
+  * 注意：不建议解构后使用 Task 相关函数，可能影响导入/导出功能。
 * 通过 `this.sessionStorage` 或 `this.localStorage` 进行数据存取。其中，`localStorage` 为持久化存储，`sessionStorage` 为会话级存储（浏览器关闭时清空）。
 
 相关函数定义如下：

package.json

@@ -36,6 +36,7 @@
     "fast-deep-equal": "^2.0.1",
     "json-logic-js": "^2.0.5",
     "lodash-es": "^4.17.21",
+    "nanoid": "^5.1.6",
     "query-string": "^8.1.0",
     "re2js": "^1.1.0",
     "react": "^18.3.1",

pnpm-lock.yaml

@@ -1,9 +1,11 @@
+import { nanoid } from 'nanoid';
 import type { Storage } from 'webextension-polyfill';
 import { getLastTaskRun, getTask, getValidTaskRun } from '../task';
 import { lodash } from './lodash';
 
 export const basicHelper = {
   _: lodash,
+  nanoid,
   task: {
     get: getTask,
     getLastRun: getLastTaskRun,

src/pages/background/core/function-helper/index.ts

@@ -7,7 +7,7 @@ import { prefs } from '@/share/core/prefs';
 import { detectRunner } from '@/share/core/rule-utils';
 import SessionMessage from '@/share/core/session-message';
 import { getSession, readStorage } from '@/share/core/storage';
-import { getRuleUsedTasks } from '@/share/core/tasks';
+import { collectRuleUsedTasks } from '@/share/core/tasks';
 import type { Rule, Task } from '@/share/core/types';
 import {
   getVirtualKey,
@@ -62,7 +62,7 @@ class DNRRequestHandler {
 
   private writeDependency(rule: Rule) {
     const rk = getVirtualKey(rule);
-    const dep = getRuleUsedTasks(rule);
+    const dep = collectRuleUsedTasks(rule);
     let shouldSave = false;
 
     for (const key in this.taskDependencies) {

src/pages/background/request-handler/dnr-handler/index.ts

@@ -1,4 +1,5 @@
 import { Input, Modal, Select } from '@douyinfe/semi-ui';
+import { nanoid } from 'nanoid';
 import * as React from 'react';
 import emitter from '@/share/core/emitter';
 import { t } from '@/share/core/utils';
@@ -14,7 +15,7 @@ export default class GroupSelect extends React.Component<
   any,
   GroupSelectState
 > {
-  private newValue = `_new_${Math.random().toString()}`;
+  private newValue = `_new_${nanoid()}`;
 
   constructor(props: any) {
     super(props);