refactor: improve error handling and documentation

- Rename handleError to _handleError for clarity in index.ts
- Update JSDoc comments in inline.ts and decode-strings.ts to enhance parameter descriptions
- Mark saveObjects function as deprecated in save-objects.ts with a note for alternative usage
- Adjust error handling in save-objects.ts and vm.ts to improve clarity and consistency
- Make props in Console.vue optional for better flexibility
- Remove unused computed property in Options.vue for cleaner code
- Simplify props definition in Tooltip.vue

Author: kuizuo

packages/deob/src/ast-utils/inline.ts

@@ -13,6 +13,8 @@ import { findParent } from './matcher'
  * Example with `unsafeAssignments` being `true`:
  * `let a; a = 2; console.log(a);` -> `console.log(2);`
  *
+ * @param binding Binding to inline
+ * @param value Matcher for the initializer expression
  * @param unsafeAssignments Also inline assignments to the variable (not guaranteed to be the final value)
  */
 export function inlineVariable(

packages/deob/src/deobfuscate/my-inline-decoder-wrappers.ts

@@ -55,9 +55,6 @@ export default {
             // 调用传入参数 -57, 1080, 828, 469
             const callFn_args = ref.parentPath.node.arguments
 
-            // 实际用到的参数 _0x13ee81 - -674, _0x3dfa50
-            const realFn_args = realFn.node.arguments
-
             // 要替换的模版
             let templateCode = generate(realFn.node)
 

packages/deob/src/deobfuscate/save-objects.ts

@@ -7,6 +7,7 @@ export type Objects = Record<`${string}_${string}`, t.ObjectExpression>
 
 /**
  * 保存代码中所有对象用于后续替换
+ * @deprecated 该函数已弃用，请使用其他方式处理对象合并与替换
  * @example
  * var r = {
  *   "PzXHf": "0|2|4|3|1",
@@ -39,7 +40,7 @@ export function saveObjects(ast: t.Node) {
 
   traverse(ast, {
     VariableDeclaration: {
-      exit(path, state) {
+      exit(path, _state) {
         path.node.declarations.forEach((declaration) => {
           if (declaration.id.type === 'Identifier') {
             const objectName = declaration.id.name
@@ -133,8 +134,8 @@ export function saveObjects(ast: t.Node) {
             isReplace = true
           }
         }
-        catch (error) {
-          throw new Error('生成表达式失败')
+        catch (_error: any) {
+          throw new Error(`生成表达式失败${_error.message}`)
         }
 
         if (isReplace) {

packages/deob/src/deobfuscate/vm.ts

@@ -71,7 +71,8 @@ export class VMDecoder {
       const result = await this.sandbox(code)
       return result as unknown[]
     }
-    catch (error) {
+    // eslint-disable-next-line unused-imports/no-unused-vars
+    catch (_error) {
       // ignore
     }
 

packages/deob/src/index.ts

@@ -54,7 +54,7 @@ export function parseCode(code: string): ParseResult<t.File> {
 }
 
 // TODO: 错误输出处理 定位代码位置
-function handleError(error: any, rawCode: string) {
+function _handleError(error: any, rawCode: string) {
   if (error instanceof SyntaxError) {
     const codeFrame = codeFrameColumns(rawCode, {
       start: {

packages/deob/src/transforms/decode-strings.ts

@@ -6,7 +6,8 @@ import { evalCode } from '../deobfuscate/vm'
 
 /**
  * 执行解密器 (使用 eval 执行)
- * @param {*} decoder
+ * @param sandbox 执行解密代码的沙箱环境
+ * @param decoders 解密器列表
  * @example
  * _0x4698(_0x13ee81, _0x3dfa50)
  * ⬇️

website/components/Console.vue

@@ -3,9 +3,9 @@ import type { ConsoleLogEntry } from '~/types/logger'
 import { Pane } from 'splitpanes'
 
 const props = withDefaults(defineProps<{
-  logs: ConsoleLogEntry[]
-  size: number
-  collapsed: boolean
+  logs?: ConsoleLogEntry[]
+  size?: number
+  collapsed?: boolean
   canExpand?: boolean
 }>(), {
   logs: () => [],

website/components/Options.vue

@@ -15,9 +15,6 @@ const isEvalCode = computed(
 const isCallCount = computed(
   () => options.value.decoderLocationMethod === 'callCount',
 )
-const isStringArray = computed(
-  () => options.value.decoderLocationMethod === 'stringArray',
-)
 
 const mangleModes = [
   { value: 'off', label: '关闭' },

website/components/Tooltip.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { ref } from 'vue'
 
-const props = defineProps<{
+defineProps<{
   text: string
 }>()