npmapps 1.1.6 → 1.3.1

package/README.md

@@ -0,0 +1,41 @@
+# npmapps 数据包
+
+本版本 `1.3.1` 是 **第 1 批：夸克网盘1789827579179.apk** 的第 2/2 片。
+
+说明：测试
+
+## 取回这一批文件
+
+在想保存文件的目录下执行（只需要能访问淘宝源）：
+
+```bash
+npx -y --registry=https://registry.npmmirror.com npmapps@1.3.0
+```
+
+脚本会下载这一批的全部分片，逐片校验 SHA-256，拼接后还原成原文件名。
+
+<details><summary>不用 npx，手动下载合并</summary>
+
+逐个下载下面的 tgz，解压后按顺序拼接 `package/files/part-NNN`：
+
+- 第 1 片：https://registry.npmmirror.com/npmapps/-/npmapps-1.3.0.tgz（SHA-256 `fbaa807fd248f3c326793cecbe3d6cabde4ac4e1213050dad055b0a8e5d1a4ce`）
+- 第 2 片：https://registry.npmmirror.com/npmapps/-/npmapps-1.3.1.tgz（SHA-256 `ae9158de39da693d1ca3ff8778cd8b7b333908f186448f23de19f259d59ac69c`）
+
+macOS / Linux：`cat part-001 part-002 … > 原文件名`；Windows：`copy /b part-001+part-002 原文件名`。
+
+整个文件的 SHA-256：`49aa2b536a45c70492286d9098a57acc7eed15b418469fe11a9c8ca277696ff7`
+
+</details>
+
+## 全部批次目录
+
+> 每次发布都会更新这份目录。需要哪一批，复制对应的下载命令即可。
+
+### 第 1 批：夸克网盘1789827579179.apk
+
+- 说明：测试
+- 大小：110.0 MB，2 片，版本 `1.3.0 ~ 1.3.1`
+- 发布时间：—
+- SHA-256：`49aa2b536a45c70492286d9098a57acc7eed15b418469fe11a9c8ca277696ff7`
+- 下载：`npx -y --registry=https://registry.npmmirror.com npmapps@1.3.0`
+

package/files/part-002

@@ -0,0 +1,4 @@
+[diffend] Oversized file quarantined before diffing.
+name: package/files/part-002
+size: 36725964 bytes
+sha256: ae9158de39da693d1ca3ff8778cd8b7b333908f186448f23de19f259d59ac69c

package/get.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+/**
+ * npmapps 分包下载合并脚本（随每个分片一起发布，纯 Node，无依赖）。
+ *
+ * 用法：在想保存文件的目录下执行（只需要能访问淘宝源）
+ *   npx -y --registry=https://registry.npmmirror.com npmapps@<这一批里任意一个版本号>
+ * 也可以解压某个分片后执行：
+ *   node package/get.js [--registry=源地址] [--out=保存目录]
+ *
+ * 流程：读 manifest.json 拿到这一批全部分片的版本号和 SHA-256
+ *   → 本包自带的分片直接读，其余分片从源下载 tgz 并解出分片文件
+ *   → 逐片校验 SHA-256 → 按顺序拼接 → 校验整个文件的 SHA-256 → 改回原文件名。
+ */
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+const zlib = require('zlib')
+const crypto = require('crypto')
+const https = require('https')
+const http = require('http')
+
+const manifest = require('./manifest.json')
+const self = require('./package.json')
+const PKG = manifest.package || self.name
+const MIRROR = 'https://registry.npmmirror.com'
+
+function argValue(name) {
+  const hit = process.argv.find((a) => a.indexOf('--' + name + '=') === 0)
+  return hit ? hit.slice(name.length + 3) : ''
+}
+
+// 源地址：命令行 --registry 优先；其次是 npx 传进来的 npm_config_registry；
+// 另一台电脑只能访问淘宝源，所以没有显式指定时，官方源一律换成淘宝源。
+function pickRegistry() {
+  let r = argValue('registry')
+  if (!r) {
+    r = process.env.npm_config_registry || MIRROR
+    if (/registry\.npmjs\.org/.test(r)) r = MIRROR
+  }
+  return r.replace(/\/+$/, '')
+}
+
+function sha256(buf) {
+  return crypto.createHash('sha256').update(buf).digest('hex')
+}
+
+function formatSize(n) {
+  const units = ['B', 'KB', 'MB', 'GB', 'TB']
+  let i = 0
+  while (n >= 1024 && i < units.length - 1) {
+    n /= 1024
+    i++
+  }
+  return n.toFixed(i ? 1 : 0) + ' ' + units[i]
+}
+
+// 下载为 Buffer，自动跟随跳转（淘宝源的 tgz 会 302 到 CDN），显示进度。
+function download(url, label, redirects) {
+  redirects = redirects || 0
+  return new Promise((resolve, reject) => {
+    const lib = url.indexOf('https:') === 0 ? https : http
+    const req = lib.get(url, { headers: { 'User-Agent': 'npmapps-get' } }, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        res.resume()
+        if (redirects > 5) return reject(new Error('跳转次数过多'))
+        const next = new URL(res.headers.location, url).toString()
+        return resolve(download(next, label, redirects + 1))
+      }
+      if (res.statusCode !== 200) {
+        res.resume()
+        return reject(new Error('HTTP ' + res.statusCode + '：' + url))
+      }
+      const total = Number(res.headers['content-length'] || 0)
+      const chunks = []
+      let got = 0
+      let last = 0
+      res.on('data', (c) => {
+        chunks.push(c)
+        got += c.length
+        const now = Date.now()
+        if (process.stderr.isTTY && now - last > 300) {
+          last = now
+          const pct = total ? ' ' + Math.floor((got / total) * 100) + '%' : ''
+          process.stderr.write('\r  ' + label + ' 下载中 ' + formatSize(got) + pct + '      ')
+        }
+      })
+      res.on('end', () => {
+        if (process.stderr.isTTY) process.stderr.write('\r' + ' '.repeat(60) + '\r')
+        resolve(Buffer.concat(chunks))
+      })
+      res.on('error', reject)
+    })
+    req.setTimeout(120000, () => req.destroy(new Error('下载超时（120 秒没有数据）')))
+    req.on('error', reject)
+  })
+}
+
+// 从 npm 的 tgz 里取出指定文件。npm 包是标准 ustar 格式，文件都在 package/ 目录下。
+function extractFromTgz(tgz, wanted) {
+  const tar = zlib.gunzipSync(tgz)
+  let off = 0
+  let paxPath = null
+  const field = (h, s, e) => h.toString('utf8', s, e).replace(/\0[\s\S]*$/, '')
+  while (off + 512 <= tar.length) {
+    const h = tar.slice(off, off + 512)
+    if (h.every((b) => b === 0)) break
+    let name = field(h, 0, 100)
+    const prefix = field(h, 345, 500)
+    if (prefix) name = prefix + '/' + name
+    const size = parseInt(field(h, 124, 136).trim() || '0', 8)
+    const type = String.fromCharCode(h[156])
+    const body = tar.slice(off + 512, off + 512 + size)
+    off += 512 + Math.ceil(size / 512) * 512
+    if (type === 'x') {
+      // pax 扩展头：长文件名放在 path= 里，作用于下一个条目
+      const m = /\d+ path=([^\n]*)\n/.exec(body.toString('utf8'))
+      paxPath = m ? m[1] : null
+      continue
+    }
+    if (type === 'g') continue
+    if (paxPath) {
+      name = paxPath
+      paxPath = null
+    }
+    if (name === wanted && (type === '0' || type === '\0')) return Buffer.from(body)
+  }
+  throw new Error('压缩包里没有找到 ' + wanted)
+}
+
+// 输出文件已存在时自动加序号，不覆盖已有文件。
+function uniquePath(dir, name) {
+  const ext = path.extname(name)
+  const base = name.slice(0, name.length - ext.length)
+  let p = path.join(dir, name)
+  for (let i = 1; fs.existsSync(p); i++) p = path.join(dir, base + '(' + i + ')' + ext)
+  return p
+}
+
+async function fetchPart(registry, part) {
+  const own = path.join(__dirname, part.file)
+  if (part.version === self.version && fs.existsSync(own)) return fs.readFileSync(own)
+  const url = registry + '/' + PKG + '/-/' + PKG + '-' + part.version + '.tgz'
+  let lastErr
+  for (let attempt = 1; attempt <= 3; attempt++) {
+    try {
+      const tgz = await download(url, '第 ' + part.index + ' 片')
+      return extractFromTgz(tgz, 'package/' + part.file)
+    } catch (e) {
+      lastErr = e
+      console.error('  第 ' + part.index + ' 片第 ' + attempt + ' 次下载失败：' + e.message)
+    }
+  }
+  throw lastErr
+}
+
+async function main() {
+  const registry = pickRegistry()
+  const outDir = path.resolve(argValue('out') || process.cwd())
+  const parts = manifest.parts
+  console.log('npmapps 第 ' + manifest.batch + ' 批：' + manifest.fileName + '（' + formatSize(manifest.size) + '，共 ' + parts.length + ' 片）')
+  if (manifest.note) console.log('说明：' + manifest.note)
+  console.log('源：' + registry)
+  fs.mkdirSync(outDir, { recursive: true })
+  const target = uniquePath(outDir, manifest.fileName)
+  const temp = target + '.downloading'
+  const fd = fs.openSync(temp, 'w')
+  const whole = crypto.createHash('sha256')
+  try {
+    for (const part of parts) {
+      const data = await fetchPart(registry, part)
+      if (data.length !== part.size || sha256(data) !== part.sha256) {
+        throw new Error('第 ' + part.index + ' 片（' + part.version + '）校验失败，文件可能损坏，请重试')
+      }
+      fs.writeSync(fd, data)
+      whole.update(data)
+      console.log('  ✔ 第 ' + part.index + '/' + parts.length + ' 片 ' + part.version + ' 已校验')
+    }
+  } finally {
+    fs.closeSync(fd)
+  }
+  if (whole.digest('hex') !== manifest.sha256) {
+    fs.unlinkSync(temp)
+    throw new Error('合并后的文件校验失败，请重试')
+  }
+  fs.renameSync(temp, target)
+  console.log('完成：' + target)
+}
+
+main().catch((e) => {
+  console.error('失败：' + e.message)
+  process.exit(1)
+})

package/manifest.json

@@ -0,0 +1,28 @@
+{
+  "tool": "npmapps",
+  "schema": 1,
+  "package": "npmapps",
+  "batch": 1,
+  "fileName": "夸克网盘1789827579179.apk",
+  "size": 115369164,
+  "sha256": "49aa2b536a45c70492286d9098a57acc7eed15b418469fe11a9c8ca277696ff7",
+  "note": "测试",
+  "createdAt": "2026-11-09T22:51:59+08:00",
+  "partSize": 78643200,
+  "parts": [
+    {
+      "index": 1,
+      "version": "1.3.0",
+      "file": "files/part-001",
+      "size": 78643200,
+      "sha256": "fbaa807fd248f3c326793cecbe3d6cabde4ac4e1213050dad055b0a8e5d1a4ce"
+    },
+    {
+      "index": 2,
+      "version": "1.3.1",
+      "file": "files/part-002",
+      "size": 36725964,
+      "sha256": "ae9158de39da693d1ca3ff8778cd8b7b333908f186448f23de19f259d59ac69c"
+    }
+  ]
+}

package/package.json

@@ -1,13 +1,20 @@
 {
-  "name": "npmapps",
-  "version": "1.1.6",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "bin": {
+    "npmapps": "get.js"
   },
-  "keywords": [],
-  "author": "",
+  "description": "npmapps 数据包 第1批：夸克网盘1789827579179.apk（第 2/2 片）",
+  "files": [
+    "files/",
+    "get.js",
+    "manifest.json"
+  ],
   "license": "ISC",
-  "type": "commonjs"
-}
+  "name": "npmapps",
+  "npmapps": {
+    "batch": 1,
+    "part": 2,
+    "parts": 2,
+    "sha256": "ae9158de39da693d1ca3ff8778cd8b7b333908f186448f23de19f259d59ac69c"
+  },
+  "version": "1.3.1"
+}

package/PUBLISH.md

@@ -1,268 +0,0 @@
-# npmapps 发布流程
-
-> 本机作为「内网文件分发 / 跨设备搬运」工具的 npm 发布会话。包名 `npmapps`,基于公网 npmjs.org。每次发布照本流程做,5-10 分钟跑完。
-
----
-
-## 0. 前置检查(30 秒)
-
-```bash
-cd /Users/wk/Documents/npmapps
-cat package.json | grep -E '"(name|version)"'
-npm config get registry
-```
-
-期望:
-- `name: "npmapps"`
-- `version: "1.0.<上次版本号>"`
-- `registry: https://registry.npmjs.org/`
-
-如果 `registry` 是内网,后面所有命令一致,只是发布目标不同。
-
----
-
-## 1. 阶段 1:搬运源文件到 `app/`(2-5 分钟)
-
-### 1.1 搬整个文件夹(过滤 `node_modules`)
-
-```bash
-# 源
-SRC=/Users/wk/Documents/wk/web/wujie-wk/wujie-vue2-child
-
-# 目标
-DST=/Users/wk/Documents/npmapps/app
-
-# 同步(过滤 node_modules)
-rsync -a --exclude='node_modules' "$SRC/" "$DST/"
-
-# 删除原目录(完成"移动"语义)
-rm -rf "$SRC"
-
-# 验证:确认没漏
-du -sh "$DST"
-find "$DST" -type d -name node_modules   # 应该无输出
-```
-
-### 1.2 搬单个文件(zip / 压缩包 / 二进制)
-
-```bash
-mv /path/to/some.zip /Users/wk/Documents/npmapps/app/
-
-# 验证
-ls -la /Users/wk/Documents/npmapps/app/some.zip
-```
-
-### 1.3 验证 `app/` 状态
-
-```bash
-ls -la /Users/wk/Documents/npmapps/app
-```
-
-确认:
-- ✅ `wujie-vue2-child/` 子目录在(整个 Vue2 子应用)
-- ✅ `*.zip` 文件在
-- ✅ 没有 `node_modules`
-
----
-
-## 2. 阶段 2:更新版本号(10 秒)
-
-```bash
-# 推荐用 npm 内置命令(自动修改 package.json)
-npm version patch   # 1.0.25 → 1.0.26
-# 其它选项:minor → 1.1.0,major → 2.0.0,具体版本号 → 1.0.27
-
-# 或者手动改 package.json
-#   "version": "1.0.25" → "1.0.26"
-
-# 验证
-grep '"version"' package.json
-```
-
-> ⚠️ 注意:`npm version` 默认会 `git commit` + `git tag`。这个项目不是 git 仓库所以没事。如果以后初始化了 git,加 `--no-git-tag-version` 防止自动 commit。
-
----
-
-## 3. 阶段 3:预览(20 秒,发布前最后一道检查)
-
-```bash
-npm pack --dry-run
-```
-
-期望输出:
-```
-npm notice name: npmapps
-npm notice version: 1.0.26
-npm notice total files: 109 (大概)
-```
-
-**重点检查**:
-- ⚠️ 警告 `No .npmignore file found, using .gitignore` —— 这个项目外层没 `.gitignore`,npm 会读 `app/wujie-vue2-child/.gitignore`(嵌套目录的 gitignore npm 不读),所以 .codegraph、.DS_Store 之类的不会被自动排除
-- ⚠️ 出现 `app/.codegraph/daemon.pid` —— 这是本地 codegraph 索引 daemon 运行时残留文件,会进包。按需决定:
-  - 想干净:加 `.npmignore`(见附录 A)
-  - 无所谓:照发,166B 不影响
-
----
-
-## 4. 阶段 4:处理 2FA / token(最容易卡住的环节)
-
-### 4.1 现状诊断
-
-```bash
-npm whoami            # 应该返回 npm 用户名
-npm profile get | grep "two-factor"
-```
-
-- `npm whoami` 返回用户名 ✅ token 有效
-- `two-factor auth: auth-and-writes` ❌ publish 会被 2FA 拦
-
-### 4.2 如果 `npm whoami` 401(token 失效)
-
-在终端跑(交互式):
-
-```
-! npm login
-```
-
-走 web flow:浏览器打开,登录授权,完成后 npm 自动把 token 写到 `~/.npmrc`。
-
-### 4.3 如果 publish 报 EOTP(2FA 拦下)
-
-**最快路径 —— 生成 bypass 2FA 的 token**:
-
-1. 浏览器打开 https://www.npmjs.com/settings/<用户名>/tokens
-2. **Generate New Token** → 名字随便(例如 `local-publish`)
-3. 类型选 **"Publish"**
-4. **关键:勾上 "Bypass two-factor authentication"** ⚠️ 这步必须勾,否则 publish 仍要 OTP
-5. 复制 token(`npm_xxxxxx...`)
-6. 替换 `~/.npmrc`:
-
-```bash
-# 备份 + 替换
-cp ~/.npmrc ~/.npmrc.bak
-# 编辑 ~/.npmrc,把 _authToken 那行的 token 换成新复制的
-```
-
-或者直接跑(把新 token 替换成你拿到的):
-
-```bash
-TOKEN=npm_xxxxxxxx
-sed -i '' "s|//registry.npmjs.org/:_authToken=.*|//registry.npmjs.org/:_authToken=$TOKEN|" ~/.npmrc
-
-# 验证
-npm whoami
-```
-
-### 4.4 替代方案:从账号层改 2FA 模式
-
-如果不想用 bypass token:
-1. 浏览器打开 https://www.npmjs.com/settings/<用户名>/security
-2. Two-Factor Authentication 改成 **"Authorization only"** 或 **Disabled**
-3. 保存(可能需要再输一次 OTP 或点邮件 magic link)
-4. 回来重试 publish
-
----
-
-## 5. 阶段 5:真正发布(10 秒)
-
-```bash
-cd /Users/wk/Documents/npmapps
-npm publish
-```
-
-成功标志:
-
-```
-+ npmapps@1.0.26
-```
-
-失败标志:
-- `EOTP`:回到阶段 4.3 换 bypass token
-- `E404: PUT ... npmapps`:token 失效,回到阶段 4.2
-- `ENEEDAUTH`:同上
-- `You do not have permission`:包名在公网被占,需要换名
-
----
-
-## 6. 阶段 6:验证(10 秒)
-
-```bash
-# 1. 查公网版本列表
-npm view npmapps versions --json | tail -5
-# 期望看到刚发的版本
-
-# 2. 查发布时间戳
-npm view npmapps time --json | grep "<新版本号>"
-# 期望: "<新版本号>": "2026-..."
-
-# 3. 查 tarball 信息
-npm view npmapps dist
-# 期望:tarball URL 指向新版本
-```
-
----
-
-## 7. 收尾(可选,2 分钟)
-
-```bash
-# 1. 清理 .npmrc 备份
-rm -f ~/.npmrc.bak
-
-# 2. 在 npm 网站 revoke 失效/过期的 token
-#    https://www.npmjs.com/settings/<用户名>/tokens
-#    只保留当前 .npmrc 里的那个,其余全 revoke
-
-# 3. 检查发布的 tarball 内容
-npm pack
-tar -tzf npmapps-<新版本号>.tgz | head -20
-# 看到不应该出现的文件就清理后再发新版本
-```
-
----
-
-## 附录 A:加 `.npmignore` 让发布更干净(可选)
-
-如果想排除 `.codegraph`、`.DS_Store`、`package-lock.json`、`dist/` 等:
-
-```bash
-cat > /Users/wk/Documents/npmapps/.npmignore <<'EOF'
-.DS_Store
-.codegraph
-*.pid
-node_modules
-package-lock.json
-dist
-EOF
-```
-
-之后 `npm pack --dry-run` 会用这个文件,不再读 `.gitignore`。
-
----
-
-## 附录 B:常用命令速查
-
-| 目的 | 命令 |
-|---|---|
-| 查包是否被占 | `npm view <name> name version` |
-| 查包全部元信息 | `npm view <name> --json` |
-| 查自己是谁 | `npm whoami` |
-| 查账号 2FA 模式 | `npm profile get` |
-| 生成 tarball(不发布) | `npm pack` |
-| 预览 tarball 内容 | `npm pack --dry-run` |
-| 登录 | `npm login`(交互) |
-| 登出 | `npm logout` |
-| 撤销发布(24 小时内) | `npm unpublish <pkg>@<version>` ⚠️ 慎用 |
-| deprecate 版本 | `npm deprecate <pkg>@<version> "msg"` |
-
----
-
-## 附录 C:本次踩过的坑(避坑指南)
-
-| 坑 | 原因 | 解法 |
-|---|---|---|
-| `npm whoami` 401 | `~/.npmrc` 里 token 失效 | `npm login` 重新登录 |
-| publish E404 | 包名被占,token 无权覆盖 | 确认包归属 / 换名 / 用有 publish 权限的 token |
-| publish EOTP | 账号 `auth-and-writes` 2FA 模式 | 生成 **bypass 2FA** 的 token,或网站改 2FA 模式 |
-| tarball 里有 `.codegraph/` | 外层没 `.gitignore`/`.npmignore` | 加 `.npmignore`(附录 A),或接受 166B 的 daemon.pid 跟着发 |
-| `npm version` 自动 commit | 项目变成 git 仓库后 | 加 `--no-git-tag-version` 标志 |
-| `npmrc` 改了没生效 | 缓存 / 文件权限 | `cat ~/.npmrc` 确认;`chmod 600 ~/.npmrc` |