@hangox/mg-cli 1.0.0 → 1.0.1

package/src/cli/commands/export-image.ts

@@ -1,193 +0,0 @@
-/**
- * export_image 命令
- * 导出 MasterGo 节点为图片文件
- */
-
-import { Command } from 'commander'
-import { writeFileSync } from 'node:fs'
-import { resolve, dirname, extname } from 'node:path'
-import { mkdirSync } from 'node:fs'
-import { tmpdir } from 'node:os'
-import { MessageType } from '../../shared/constants.js'
-import { MGClient, parseMgpLink } from '../client.js'
-import { MGError } from '../../shared/errors.js'
-import type { ExportImageParams } from '../../shared/types.js'
-
-type ImageFormat = 'PNG' | 'JPG' | 'SVG' | 'PDF' | 'WEBP'
-
-interface ExportImageOptions {
-  output?: string
-  link?: string
-  format?: string
-  scale?: string
-  width?: string
-  height?: string
-  useAbsoluteBounds?: boolean
-  useRenderBounds?: boolean
-  noAutoStart?: boolean
-  noRetry?: boolean
-}
-
-/** 导出响应 */
-interface ExportResponse {
-  /** Base64 编码的图片数据 */
-  data: string
-  /** MIME 类型 */
-  mimeType: string
-  /** 文件名建议 */
-  filename?: string
-}
-
-/**
- * 创建 export_image 命令
- */
-export function createExportImageCommand(): Command {
-  return new Command('export_image')
-    .description('导出 MasterGo 节点为图片文件。强烈建议指定 --output，否则保存到临时目录可能被系统清理')
-    .option('--output <path>', '输出文件路径。强烈建议指定，否则保存到系统临时目录可能被清理')
-    .option('--link <mgp-link>', 'mgp:// 协议链接。不指定则导出当前选中节点')
-    .option('--format <type>', '导出格式：PNG（无损透明）、JPG（有损）、SVG（矢量）、PDF、WEBP', 'PNG')
-    .option('--scale <number>', '缩放倍率（如 1、2、3）。与 width/height 互斥')
-    .option('--width <number>', '固定宽度（像素）。与 scale/height 互斥')
-    .option('--height <number>', '固定高度（像素）。与 scale/width 互斥')
-    .option('--useAbsoluteBounds', '使用完整尺寸。true: 包含被裁剪部分，false: 只导出可见区域', false)
-    .option('--no-use-render-bounds', '不包含特效和外描边。默认包含阴影、外描边等')
-    .option('--no-auto-start', '禁用自动启动 Server')
-    .option('--no-retry', '禁用自动重试')
-    .action(async (options: ExportImageOptions) => {
-      await handleExportImage(options)
-    })
-}
-
-/**
- * 处理 export_image 命令
- */
-async function handleExportImage(options: ExportImageOptions): Promise<void> {
-  // 验证格式
-  const format = (options.format?.toUpperCase() || 'PNG') as ImageFormat
-  const validFormats: ImageFormat[] = ['PNG', 'JPG', 'SVG', 'PDF', 'WEBP']
-  if (!validFormats.includes(format)) {
-    console.error(`错误: 不支持的格式 "${options.format}"`)
-    console.error(`支持的格式: ${validFormats.join(', ')}`)
-    process.exit(1)
-  }
-
-  // 验证参数互斥
-  const sizeParams = [options.scale, options.width, options.height].filter(Boolean)
-  if (sizeParams.length > 1) {
-    console.error('错误: scale、width、height 三者互斥，只能指定其中一个')
-    process.exit(1)
-  }
-
-  // 解析 link 参数
-  let pageUrl: string | undefined
-  let nodeId: string | undefined
-
-  if (options.link) {
-    const linkInfo = parseMgpLink(options.link)
-    if (!linkInfo) {
-      console.error(`错误: 无效的 mgp:// 链接格式: ${options.link}`)
-      process.exit(1)
-    }
-    pageUrl = linkInfo.pageUrl
-    nodeId = linkInfo.nodeId
-  }
-
-  const client = new MGClient({
-    noAutoStart: options.noAutoStart,
-    noRetry: options.noRetry,
-  })
-
-  try {
-    // 连接 Server
-    await client.connect()
-
-    // 构建请求参数
-    const params: ExportImageParams = {
-      format,
-      useAbsoluteBounds: options.useAbsoluteBounds || false,
-      useRenderBounds: options.useRenderBounds !== false,
-    }
-
-    if (nodeId) {
-      params.nodeId = nodeId
-    }
-    if (options.scale) {
-      params.scale = parseFloat(options.scale)
-    }
-    if (options.width) {
-      params.width = parseInt(options.width, 10)
-    }
-    if (options.height) {
-      params.height = parseInt(options.height, 10)
-    }
-
-    // 发送请求（传入 pageUrl 以指定目标页面）
-    const response = await client.requestWithRetry<ExportResponse>(
-      MessageType.EXPORT_IMAGE,
-      params as Record<string, unknown>,
-      pageUrl
-    )
-
-    // 确定输出路径
-    const ext = getExtension(format)
-    let outputPath: string
-    if (options.output) {
-      outputPath = resolve(options.output)
-      // 如果没有扩展名，添加扩展名
-      if (!extname(outputPath)) {
-        outputPath = `${outputPath}${ext}`
-      }
-    } else {
-      // 使用临时目录
-      const filename = response.filename || `export_${Date.now()}${ext}`
-      outputPath = resolve(tmpdir(), filename)
-      console.log('警告: 未指定 --output，文件将保存到临时目录，可能会被系统清理')
-    }
-
-    // 确保目录存在
-    const outputDir = dirname(outputPath)
-    mkdirSync(outputDir, { recursive: true })
-
-    // 解码 Base64 并保存
-    const buffer = Buffer.from(response.data, 'base64')
-    writeFileSync(outputPath, buffer)
-
-    // 输出结果
-    const sizeKB = (buffer.length / 1024).toFixed(2)
-    console.log(`文件路径: ${outputPath}`)
-    if (options.link) {
-      console.log(`Link: ${options.link}`)
-    }
-    if (nodeId) {
-      console.log(`节点 ID: ${nodeId}`)
-    } else {
-      console.log('节点 ID: (选中的节点)')
-    }
-    console.log(`导出格式: ${format}`)
-    console.log(`文件大小: ${buffer.length.toLocaleString()} 字节 (约 ${sizeKB} KB)`)
-  } catch (error) {
-    if (error instanceof MGError) {
-      console.error(`错误 [${error.code}]: ${error.message}`)
-    } else {
-      console.error(`错误: ${error instanceof Error ? error.message : error}`)
-    }
-    process.exit(1)
-  } finally {
-    client.close()
-  }
-}
-
-/**
- * 获取格式对应的文件扩展名
- */
-function getExtension(format: ImageFormat): string {
-  const extensions: Record<ImageFormat, string> = {
-    PNG: '.png',
-    JPG: '.jpg',
-    SVG: '.svg',
-    PDF: '.pdf',
-    WEBP: '.webp',
-  }
-  return extensions[format]
-}

package/src/cli/commands/get-all-nodes.ts

@@ -1,81 +0,0 @@
-/**
- * get_all_nodes 命令
- * 获取当前页面的所有节点树
- */
-
-import { Command } from 'commander'
-import { writeFileSync } from 'node:fs'
-import { resolve, dirname } from 'node:path'
-import { mkdirSync } from 'node:fs'
-import { MessageType } from '../../shared/constants.js'
-import { MGClient } from '../client.js'
-import type { GetAllNodesParams, NodeInfo } from '../../shared/types.js'
-
-interface GetAllNodesOptions {
-  output: string
-  maxDepth?: string
-  includeInvisible?: boolean
-  noAutoStart?: boolean
-  noRetry?: boolean
-}
-
-/**
- * 创建 get_all_nodes 命令
- */
-export function createGetAllNodesCommand(): Command {
-  return new Command('get_all_nodes')
-    .description('获取当前页面的所有节点树。警告：深度每增加 1，数据量可能呈指数级增长。建议从 maxDepth=1 开始')
-    .requiredOption('--output <path>', '输出 JSON 文件路径。支持绝对路径或相对路径')
-    .option('--maxDepth <number>', '最大深度，默认 1。深度 2 可能产生 100KB-500KB，深度 3 可能超过 1MB', '1')
-    .option('--includeInvisible', '包含不可见节点（visible: false），默认不包含', false)
-    .option('--no-auto-start', '禁用自动启动 Server')
-    .option('--no-retry', '禁用自动重试')
-    .action(async (options: GetAllNodesOptions) => {
-      await handleGetAllNodes(options)
-    })
-}
-
-/**
- * 处理 get_all_nodes 命令
- */
-async function handleGetAllNodes(options: GetAllNodesOptions): Promise<void> {
-  const client = new MGClient({
-    noAutoStart: options.noAutoStart,
-    noRetry: options.noRetry,
-  })
-
-  try {
-    // 连接 Server
-    await client.connect()
-
-    // 发送请求
-    const params: GetAllNodesParams = {
-      maxDepth: parseInt(options.maxDepth || '1', 10),
-      includeInvisible: options.includeInvisible || false,
-    }
-
-    const data = await client.requestWithRetry<NodeInfo[]>(MessageType.GET_ALL_NODES, params)
-
-    // 保存到文件
-    const outputPath = resolve(options.output)
-    const outputDir = dirname(outputPath)
-    mkdirSync(outputDir, { recursive: true })
-
-    const jsonContent = JSON.stringify(data, null, 2)
-    writeFileSync(outputPath, jsonContent, 'utf-8')
-
-    // 输出结果
-    const size = jsonContent.length
-    const sizeKB = (size / 1024).toFixed(2)
-    const nodeCount = Array.isArray(data) ? data.length : 1
-    console.log(`文件路径: ${outputPath}`)
-    console.log(`节点数量: ${nodeCount}`)
-    console.log(`数据大小: ${size.toLocaleString()} 字符 (约 ${sizeKB} KB)`)
-    console.log(`节点深度: ${params.maxDepth}`)
-  } catch (error) {
-    console.error(`错误: ${error instanceof Error ? error.message : error}`)
-    process.exit(1)
-  } finally {
-    client.close()
-  }
-}

package/src/cli/commands/get-all-pages.ts

@@ -1,118 +0,0 @@
-/**
- * get_all_pages 命令
- * 获取 MasterGo 文档的所有页面信息
- */
-
-import { Command } from 'commander'
-import { writeFileSync } from 'node:fs'
-import { resolve, dirname } from 'node:path'
-import { mkdirSync } from 'node:fs'
-import { tmpdir } from 'node:os'
-import { MessageType } from '../../shared/constants.js'
-import { MGClient } from '../client.js'
-import { extractFileId } from '../../shared/utils.js'
-import type { AllPagesInfo } from '../../shared/types.js'
-
-interface GetAllPagesOptions {
-  link?: string
-  fileId?: string
-  output?: string
-  noAutoStart?: boolean
-  noRetry?: boolean
-}
-
-/**
- * 创建 get_all_pages 命令
- */
-export function createGetAllPagesCommand(): Command {
-  return new Command('get_all_pages')
-    .description('获取 MasterGo 文档的所有页面信息。不指定 --output 时保存到系统临时目录')
-    .option('--link <url>', '页面链接。支持完整 URL 或 mgp:// 协议')
-    .option('--fileId <id>', '文件 ID（纯数字）。从 URL 中 /file/ 后面的数字')
-    .option('--output <path>', '输出 JSON 文件路径。不指定则保存到系统临时目录')
-    .option('--no-auto-start', '禁用自动启动 Server')
-    .option('--no-retry', '禁用自动重试')
-    .action(async (options: GetAllPagesOptions) => {
-      await handleGetAllPages(options)
-    })
-}
-
-/**
- * 处理 get_all_pages 命令
- */
-async function handleGetAllPages(options: GetAllPagesOptions): Promise<void> {
-  // 提取 fileId
-  let fileId: string | null = null
-  
-  if (options.fileId) {
-    fileId = options.fileId
-  } else if (options.link) {
-    fileId = extractFileId(options.link)
-    if (!fileId) {
-      console.error('错误: 无法从链接中提取 fileId')
-      console.error('支持的格式:')
-      console.error('  - 完整 URL: https://mastergo.netease.com/file/174875497054651')
-      console.error('  - mgp 协议: mgp://mastergo.netease.com/file/174875497054651')
-      console.error('  - 纯 fileId: 174875497054651')
-      process.exit(1)
-    }
-  } else {
-    // 没有提供参数，获取当前连接页面的所有页面
-    console.log('未提供 --link 或 --fileId，将获取当前连接页面的所有页面信息')
-  }
-
-  const client = new MGClient({
-    noAutoStart: options.noAutoStart,
-    noRetry: options.noRetry,
-  })
-
-  try {
-    // 连接 Server
-    await client.connect()
-
-    // 构建 pageUrl（如果有 fileId）
-    let pageUrl: string | undefined
-    if (fileId) {
-      // 构建标准化的 pageUrl
-      pageUrl = `mastergo.netease.com/file/${fileId}`
-    }
-
-    // 发送请求
-    const data = await client.requestWithRetry<AllPagesInfo>(
-      MessageType.GET_ALL_PAGES,
-      {},
-      pageUrl
-    )
-
-    // 确定输出路径
-    let outputPath: string
-    if (options.output) {
-      outputPath = resolve(options.output)
-    } else {
-      // 使用系统临时目录
-      const filename = `pages_${fileId || 'current'}_${Date.now()}.json`
-      outputPath = resolve(tmpdir(), filename)
-    }
-
-    // 确保目录存在
-    const outputDir = dirname(outputPath)
-    mkdirSync(outputDir, { recursive: true })
-
-    // 保存到文件
-    const jsonContent = JSON.stringify(data, null, 2)
-    writeFileSync(outputPath, jsonContent, 'utf-8')
-
-    // 输出结果
-    const size = jsonContent.length
-    const sizeKB = (size / 1024).toFixed(2)
-    console.log(`文件路径: ${outputPath}`)
-    console.log(`文档名称: ${data.documentName}`)
-    console.log(`页面数量: ${data.totalCount}`)
-    console.log(`数据大小: ${size.toLocaleString()} 字符 (约 ${sizeKB} KB)`)
-  } catch (error) {
-    console.error(`错误: ${error instanceof Error ? error.message : error}`)
-    process.exit(1)
-  } finally {
-    client.close()
-  }
-}

package/src/cli/commands/get-node-by-id.ts

@@ -1,83 +0,0 @@
-/**
- * get_node_by_id 命令
- * 根据节点 ID 获取节点详细信息
- */
-
-import { Command } from 'commander'
-import { writeFileSync } from 'node:fs'
-import { resolve, dirname } from 'node:path'
-import { mkdirSync } from 'node:fs'
-import { MessageType } from '../../shared/constants.js'
-import { MGClient } from '../client.js'
-import type { GetNodeParams, NodeInfo } from '../../shared/types.js'
-
-interface GetNodeByIdOptions {
-  nodeId: string
-  output: string
-  maxDepth?: string
-  includeInvisible?: boolean
-  noAutoStart?: boolean
-  noRetry?: boolean
-}
-
-/**
- * 创建 get_node_by_id 命令
- */
-export function createGetNodeByIdCommand(): Command {
-  return new Command('get_node_by_id')
-    .description('根据节点 ID 获取节点详细信息。数据保存到指定 JSON 文件，返回文件路径和大小信息')
-    .requiredOption('--nodeId <id>', '节点 ID，格式如 123:456。可从 MasterGo 浮窗链接中获取')
-    .requiredOption('--output <path>', '输出 JSON 文件路径。支持绝对路径或相对路径')
-    .option('--maxDepth <number>', '遍历深度，默认 1。增加深度会显著增加数据量', '1')
-    .option('--includeInvisible', '包含不可见节点（visible: false），默认不包含', false)
-    .option('--no-auto-start', '禁用自动启动 Server')
-    .option('--no-retry', '禁用自动重试')
-    .action(async (options: GetNodeByIdOptions) => {
-      await handleGetNodeById(options)
-    })
-}
-
-/**
- * 处理 get_node_by_id 命令
- */
-async function handleGetNodeById(options: GetNodeByIdOptions): Promise<void> {
-  const client = new MGClient({
-    noAutoStart: options.noAutoStart,
-    noRetry: options.noRetry,
-  })
-
-  try {
-    // 连接 Server
-    await client.connect()
-
-    // 发送请求
-    const params: GetNodeParams = {
-      nodeId: options.nodeId,
-      maxDepth: parseInt(options.maxDepth || '1', 10),
-      includeInvisible: options.includeInvisible || false,
-    }
-
-    const data = await client.requestWithRetry<NodeInfo>(MessageType.GET_NODE_BY_ID, params)
-
-    // 保存到文件
-    const outputPath = resolve(options.output)
-    const outputDir = dirname(outputPath)
-    mkdirSync(outputDir, { recursive: true })
-
-    const jsonContent = JSON.stringify(data, null, 2)
-    writeFileSync(outputPath, jsonContent, 'utf-8')
-
-    // 输出结果
-    const size = jsonContent.length
-    const sizeKB = (size / 1024).toFixed(2)
-    console.log(`文件路径: ${outputPath}`)
-    console.log(`节点 ID: ${options.nodeId}`)
-    console.log(`数据大小: ${size.toLocaleString()} 字符 (约 ${sizeKB} KB)`)
-    console.log(`节点深度: ${params.maxDepth}`)
-  } catch (error) {
-    console.error(`错误: ${error instanceof Error ? error.message : error}`)
-    process.exit(1)
-  } finally {
-    client.close()
-  }
-}

package/src/cli/commands/get-node-by-link.ts

@@ -1,105 +0,0 @@
-/**
- * get_node_by_link 命令
- * 解析 mgp:// 协议链接并获取节点信息
- */
-
-import { Command } from 'commander'
-import { writeFileSync } from 'node:fs'
-import { resolve, dirname } from 'node:path'
-import { mkdirSync } from 'node:fs'
-import { MessageType } from '../../shared/constants.js'
-import { MGClient, parseMgpLink } from '../client.js'
-import { ErrorCode, MGError } from '../../shared/errors.js'
-import type { GetNodeParams, NodeInfo } from '../../shared/types.js'
-
-interface GetNodeByLinkOptions {
-  link: string
-  output: string
-  maxDepth?: string
-  includeInvisible?: boolean
-  noAutoStart?: boolean
-  noRetry?: boolean
-}
-
-/**
- * 创建 get_node_by_link 命令
- */
-export function createGetNodeByLinkCommand(): Command {
-  return new Command('get_node_by_link')
-    .description('解析 mgp:// 协议链接并获取节点信息')
-    .requiredOption('--link <url>', 'mgp:// 协议链接')
-    .requiredOption('--output <path>', '输出 JSON 文件路径')
-    .option('--maxDepth <number>', '遍历深度', '1')
-    .option('--includeInvisible', '包含不可见节点', false)
-    .option('--no-auto-start', '禁用自动启动 Server')
-    .option('--no-retry', '禁用自动重试')
-    .action(async (options: GetNodeByLinkOptions) => {
-      await handleGetNodeByLink(options)
-    })
-}
-
-/**
- * 处理 get_node_by_link 命令
- */
-async function handleGetNodeByLink(options: GetNodeByLinkOptions): Promise<void> {
-  // 解析 mgp:// 链接
-  const parsed = parseMgpLink(options.link)
-  if (!parsed) {
-    console.error(`错误 [${ErrorCode.INVALID_LINK}]: 无效的 mgp:// 链接格式`)
-    console.error(`提供的链接: ${options.link}`)
-    console.error(`期望格式: mgp://[mastergo_page_url]/nodeId`)
-    process.exit(1)
-  }
-
-  const { pageUrl, nodeId } = parsed
-
-  const client = new MGClient({
-    noAutoStart: options.noAutoStart,
-    noRetry: options.noRetry,
-  })
-
-  try {
-    // 连接 Server
-    await client.connect()
-
-    // 发送请求
-    const params: GetNodeParams = {
-      nodeId,
-      maxDepth: parseInt(options.maxDepth || '1', 10),
-      includeInvisible: options.includeInvisible || false,
-    }
-
-    const data = await client.requestWithRetry<NodeInfo>(
-      MessageType.GET_NODE_BY_ID,
-      params,
-      pageUrl
-    )
-
-    // 保存到文件
-    const outputPath = resolve(options.output)
-    const outputDir = dirname(outputPath)
-    mkdirSync(outputDir, { recursive: true })
-
-    const jsonContent = JSON.stringify(data, null, 2)
-    writeFileSync(outputPath, jsonContent, 'utf-8')
-
-    // 输出结果
-    const size = jsonContent.length
-    const sizeKB = (size / 1024).toFixed(2)
-    console.log(`文件路径: ${outputPath}`)
-    console.log(`Link: ${options.link}`)
-    console.log(`页面 URL: ${pageUrl}`)
-    console.log(`节点 ID: ${nodeId}`)
-    console.log(`数据大小: ${size.toLocaleString()} 字符 (约 ${sizeKB} KB)`)
-    console.log(`节点深度: ${params.maxDepth}`)
-  } catch (error) {
-    if (error instanceof MGError) {
-      console.error(`错误 [${error.code}]: ${error.message}`)
-    } else {
-      console.error(`错误: ${error instanceof Error ? error.message : error}`)
-    }
-    process.exit(1)
-  } finally {
-    client.close()
-  }
-}