most-box 0.0.1 → 0.0.2

package/src/config.js

@@ -1,20 +1,37 @@
 /**
- * Application Configuration
+ * 应用配置
  */
 
-// File size limits
+// 文件大小限制
 export const MAX_FILE_SIZE = 100 * 1024 * 1024 * 1024 // 100 GB
 
-// Network timeouts (ms)
+// 网络超时（毫秒）
 export const CONNECTION_TIMEOUT = 120000
 export const DOWNLOAD_TIMEOUT = 900000
 
-// P2P settings
+// P2P 设置
 export const GLOBAL_SHARED_SEED_STRING = 'most-box-global-shared-seed-v1'
+export const MAX_PEERS = 64
+export const SWARM_KEEP_ALIVE_INTERVAL = 5000
+export const SWARM_RANDOM_PUNCH_INTERVAL = 20000
 
-// DHT Bootstrap nodes for Hyperswarm/HyperDHT
-// Using the same bootstrap nodes as Keet.io/HyperDHT for compatibility
-// Format: [suggested-IP@]<host>:<port> to avoid DNS calls
+// 驱动器超时（毫秒）
+export const DRIVE_ENTRY_TIMEOUT = 10000
+export const DRIVE_SYNC_TIMEOUT = 10000
+export const STREAM_READ_TIMEOUT = 10000
+
+// 下载轮询间隔（毫秒）
+export const DOWNLOAD_POLL_INTERVAL = 1000
+
+// 进度更新节流间隔（毫秒）
+export const PROGRESS_THROTTLE = 500
+
+// 默认读取限制
+export const DEFAULT_READ_LIMIT = 10000
+
+// DHT 引导节点，用于 Hyperswarm/HyperDHT
+// 使用与 Keet.io/HyperDHT 相同的引导节点以保证兼容性
+// 格式：[suggested-IP@]<host>:<port> 以避免 DNS 调用
 export const SWARM_BOOTSTRAP = [
   '88.99.3.86@node1.hyperdht.org:49737',
   '142.93.90.113@node2.hyperdht.org:49737',

package/src/core/cid.js

@@ -1,6 +1,6 @@
 /**
- * CID (Content Identifier) Calculation Module
- * Handles IPFS UnixFS CID computation for files
+ * CID（内容标识符）计算模块
+ * 处理文件的 IPFS UnixFS CID 计算
  */
 
 import fs from 'node:fs'
@@ -8,8 +8,8 @@ import { Readable } from 'node:stream'
 import { importer } from 'ipfs-unixfs-importer'
 
 /**
- * Dummy Blockstore for CID calculation
- * Does not store any data, only used for streaming CID computation
+ * 用于 CID 计算的虚拟 Blockstore
+ * 不存储任何数据，仅用于流式 CID 计算
  */
 function createDummyBlockstore() {
   return {
@@ -20,14 +20,14 @@ function createDummyBlockstore() {
 }
 
 /**
- * Calculate IPFS UnixFS CID v1 for content
- * Uses streaming approach to handle large files efficiently
+ * 计算内容的 IPFS UnixFS CID v1
+ * 使用流式方法高效处理大文件
  * 
- * @param {string|Buffer|AsyncIterable} content - File path (string), Buffer, or async iterable
- * @param {object} options - Calculation options
- * @param {boolean} [options.rawLeaves=true] - Use raw leaves for modern CID
- * @param {number} [options.cidVersion=1] - CID version (0 or 1)
- * @param {number} [options.size] - Total size in bytes (optional, auto-detected for files)
+ * @param {string|Buffer|AsyncIterable} content - 文件路径（字符串）、Buffer 或异步迭代器
+ * @param {object} options - 计算选项
+ * @param {boolean} [options.rawLeaves=true] - 使用原始叶子节点以支持现代 CID
+ * @param {number} [options.cidVersion=1] - CID 版本（0 或 1）
+ * @param {number} [options.size] - 总字节数（可选，自动检测）
  * @returns {Promise<{cid: import('multiformats/cid').CID, size: number}>}
  */
 export async function calculateCid(content, options = {}) {
@@ -50,7 +50,7 @@ export async function calculateCid(content, options = {}) {
       const stat = await fs.promises.stat(filePath)
       totalSize = stat.size
     } catch {
-      // Ignore stat errors, size will be 0
+      // 忽略 stat 错误，大小将为 0
     }
     source = [{
       path: 'file',
@@ -92,8 +92,8 @@ export async function calculateCid(content, options = {}) {
 }
 
 /**
- * Validate a CID string
- * @param {string} cidString - CID string to validate
+ * 验证 CID 字符串
+ * @param {string} cidString - 要验证的 CID 字符串
  * @returns {{ valid: boolean, error?: string }}
  */
 export function validateCidString(cidString) {
@@ -109,8 +109,8 @@ export function validateCidString(cidString) {
 }
 
 /**
- * Parse a most:// link and extract the CID
- * @param {string} link - most://<cid> format link
+ * 解析 most:// 链接并提取 CID
+ * @param {string} link - most://<cid> 格式的链接
  * @returns {{ cid: string, error?: string }}
  */
 export function parseMostLink(link) {
@@ -124,10 +124,15 @@ export function parseMostLink(link) {
     cidString = link.replace('most://', '')
   }
 
-  // Remove any trailing slashes or whitespace
+  // 移除尾部斜杠和空白
   cidString = cidString.trim().replace(/\/+$/, '')
   
-  // Handle URL-like parsing for potential extra paths
+  // 移除 query string
+  if (cidString.includes('?')) {
+    cidString = cidString.split('?')[0]
+  }
+
+  // 处理可能的额外路径的 URL 解析
   if (cidString.includes('/')) {
     cidString = cidString.split('/')[0]
   }