tencentads-cli 1.1.0 → 1.1.2

package/README.md

@@ -2,244 +2,49 @@
 
 通用腾讯广告 API CLI 工具 — 封装鉴权与 API 调用。
 
-零运行时依赖，同时提供 **CLI 命令行** 和 **Node.js SDK** 两种使用方式。
-
 ## 安装
 
 ```bash
-# 全局安装（CLI 工具）
-npm install -g tencentads-cli@1.0.0
-
-# 项目依赖（SDK）
-npm install tencentads-cli@1.0.0
+npm install -g tencentads-cli
 ```
 
-## 配置鉴权
-
-在使用之前，需要保存 API Key 到本地凭证文件 `~/.tencent-ads/credentials.json`：
-
-```bash
-# 方式一：手动创建
-mkdir -p ~/.tencent-ads
-echo '{"apiKey":"YOUR_API_KEY"}' > ~/.tencent-ads/credentials.json
+npm 会根据当前操作系统自动安装对应平台的子包（`optionalDependencies`）：
 
-# 方式二：通过环境变量自定义存储路径
-export TENCENT_ADS_CONFIG_DIR=/your/custom/path
-```
-
-查看当前鉴权状态：
-
-```bash
-tencentads-cli auth status
-```
+| 子包 | 平台 |
+|------|------|
+| `tencentads-darwin-x64` | macOS Intel |
+| `tencentads-darwin-arm64` | macOS Apple Silicon |
+| `tencentads-linux-x64` | Linux x64 |
+| `tencentads-linux-arm64` | Linux ARM64 |
+| `tencentads-windows-amd64` | Windows x64 |
+| `tencentads-windows-arm64` | Windows ARM64 |
 
 ## CLI 使用
 
-> 全局安装后可用的命令为 `tencentads-cli`（对应 `package.json` 的 `bin` 字段）。
-
-### JSON 模式
+### `tencentads`（当前版本，Go 二进制）
 
 ```bash
-# GET 请求
-tencentads-cli api '{"method":"GET","path":"/v3.0/adgroups/get","account_id":"123456"}'
-
-# POST 请求
-tencentads-cli api '{"method":"POST","path":"/v3.0/adgroups/add","account_id":"123456","body":{"campaign_id":100}}'
-
-# 带查询参数
-tencentads-cli api '{"method":"GET","path":"/v3.0/campaigns/get","account_id":"123456","params":{"page":1,"page_size":10}}'
-```
-
-### Flag 模式
-
-```bash
-# GET 请求
-tencentads-cli api --method GET --path /v3.0/adgroups/get --account-id 123456
-
-# POST 请求
-tencentads-cli api --method POST --path /v3.0/adgroups/add --account-id 123456 --body '{"campaign_id":100}'
-
-# 带查询参数
-tencentads-cli api --method GET --path /v3.0/campaigns/get --account-id 123456 --params '{"page":1,"page_size":10}'
-```
-
-### 查看帮助
-
-```bash
-tencentads-cli help
-```
-
-## SDK 使用
-
-### callApi — 高级调用函数
-
-自动加载本地凭证，返回结构化结果：
-
-```typescript
-import { callApi } from 'tencentads-cli';
-
-const result = await callApi({
-  method: 'GET',
-  path: '/v3.0/adgroups/get',
-  accountId: '123456',
-  params: { page: 1, page_size: 10 },
-});
-
-if (result.success) {
-  console.log(result.data);
-} else {
-  console.error(result.error.message);
-}
-```
-
-### TencentAdsClient — HTTP 客户端
+# 登录鉴权
+tencentads auth login
 
-支持自定义鉴权、超时和重试策略：
+# 查看鉴权状态
+tencentads auth status
 
-```typescript
-import { TencentAdsClient, ENDPOINTS } from 'tencentads-cli';
+# 退出登录
+tencentads auth logout
 
-const client = new TencentAdsClient({
-  auth: {
-    applyAuth(headers) {
-      headers.set('X-MKT-API-Key', 'YOUR_API_KEY');
-      headers.set('Host', 'api.e.qq.com');
-    },
-  },
-  baseUrl: ENDPOINTS.MARKETING_API,
-  timeout: 30000,
-  retry: { maxRetries: 3, baseDelay: 1000 },
-});
-
-// GET
-const data = await client.get('/v3.0/campaigns/get', { account_id: '123456' });
-
-// POST
-const resp = await client.post('/v3.0/adgroups/add', { campaign_id: 100 });
-```
-
-### TencentAdsAuth — 凭证管理
-
-```typescript
-import { TencentAdsAuth } from 'tencentads-cli';
-
-const auth = new TencentAdsAuth();
-
-// 保存 API Key
-auth.saveApiKey('your-api-key');
-
-// 读取凭证
-const cred = auth.read();
-// => { apiKey: 'your-api-key', updatedAt: '2025-01-01T00:00:00.000Z' }
-
-// 查看鉴权状态
-const status = auth.getStatus(); // 'active' | 'not_configured'
-const info = auth.getInfo();
-```
-
-### 枚举工具
-
-内置腾讯广告 API 常用枚举及转换工具：
-
-```typescript
-import {
-  resolveEnum,
-  resolveEnumKey,
-  deriveProductType,
-  resolveTargetingFields,
-  MARKETING_GOAL,
-  MARKETING_CARRIER_TYPE,
-} from 'tencentads-cli';
-
-// 枚举名 → 数值
-resolveEnum('MARKETING_GOAL', 'MARKETING_GOAL_PRODUCT_SALES'); // => 2
-
-// 数值 → 枚举名
-resolveEnumKey('MARKETING_GOAL', 2); // => 'MARKETING_GOAL_PRODUCT_SALES'
-
-// 自动推导 product_type
-deriveProductType('MARKETING_CARRIER_TYPE_WECHAT_OFFICIAL_ACCOUNT');
-
-// 智能展开定向字段（支持中文简写）
-resolveTargetingFields({
-  os: 'ANDROID_10+',
-  device_price: '2500以上',
-  education: '本科',
-});
+# 查看帮助
+tencentads help
 ```
 
-**可用枚举：**
-
-| 枚举 | 说明 |
-|------|------|
-| `MARKETING_GOAL` | 营销目标（拉新、促销、品牌等） |
-| `MARKETING_SUB_GOAL` | 营销子目标 |
-| `MARKETING_CARRIER_TYPE` | 推广载体类型（Android/iOS/微信等） |
-| `MARKETING_TARGET_TYPE` | 推广业务类型 |
-| `SITE_SET` | 广告投放版位 |
-| `SMART_DELIVERY_PLATFORM` | 智能投放平台 |
-| `EXPLORATION_STRATEGY` | 探索策略 |
-| `CONFIGURED_STATUS` | 配置状态 |
-
-## 特性
-
-- **零运行时依赖** — 仅使用 Node.js 内置模块
-- **TypeScript** — 完整类型定义，开箱即用
-- **自动重试** — 指数退避策略，默认重试 3 次
-- **鉴权管理** — API Key 凭证自动加载
-- **枚举映射** — 双向转换 + 中文定向字段智能展开
-- **ESM 模块** — 原生 ES Module 支持
-
-## 构建
-
-```bash
-cd tools/tencent-ads-cli
-npm install
-npm run build        # tsc 编译 → dist/
-```
-
-构建产物在 `dist/` 目录，包含 `.js` 和 `.d.ts` 文件。
-
-## 发布到 npm
-
-1. **登录 npm**
-
-   ```bash
-   npm login
-   ```
-
-2. **确认当前已发布版本**
-
-   ```bash
-   npm info tencentads-cli
-   ```
-
-3. **更新版本号**
-
-   ```bash
-   npm version patch   # 修复：0.1.0 → 0.1.1
-   npm version minor   # 新功能：0.1.0 → 0.2.0
-   npm version major   # 破坏性变更：0.1.0 → 1.0.0
-   ```
-
-4. **构建并发布**
-
-   ```bash
-   npm run build
-   npm publish
-   ```
-
-5. **验证发布结果**
+### `tencentads-cli`（旧版，不再升级）
 
-   ```bash
-   npm info tencentads-cli version
-   ```
+`tencentads-cli` 为早期 Node.js 版本，保留以兼容现有集成，不再接受新功能更新。
 
-> **注意**：发布后，使用 `release-skills.sh --cli-version <新版本>` 可以将 skills 仓库中的 `tencentads-cli` 依赖版本锁定到最新发布的版本。
 
 ## 环境要求
 
-- Node.js >= 20.0.0
+- Node.js >= 18.0.0
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentads-cli",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "通用腾讯广告 API CLI 工具 — 封装鉴权与 API 调用",
   "license": "MIT",
   "keywords": [
@@ -11,10 +11,19 @@
     "api",
     "advertising"
   ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
     "tencentads": "./bin/tencentads.js",
     "tencentads-cli": "./dist/bin.js"
   },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "files": [
     "bin/",
     "dist/",
@@ -22,18 +31,29 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "tencentads-darwin-x64": "1.1.0",
-    "tencentads-darwin-arm64": "1.1.0",
-    "tencentads-linux-x64": "1.1.0",
-    "tencentads-linux-arm64": "1.1.0",
-    "tencentads-windows-amd64": "1.1.0",
-    "tencentads-windows-arm64": "1.1.0"
+    "tencentads-darwin-x64": "1.1.2",
+    "tencentads-darwin-arm64": "1.1.2",
+    "tencentads-linux-x64": "1.1.2",
+    "tencentads-linux-arm64": "1.1.2",
+    "tencentads-windows-amd64": "1.1.2",
+    "tencentads-windows-arm64": "1.1.2"
   },
   "scripts": {
-    "publish:npm": "bash ../scripts/publish-cli-go.sh --version 1.1.0 --registry https://registry.npmjs.org",
-    "publish:beta": "bash ../scripts/publish-cli-go.sh --version 1.1.0 --tag beta --registry https://registry.npmjs.org",
-    "publish:npm:token": "bash ../scripts/publish-cli-go.sh --version 1.1.0 --token $NPM_TOKEN --registry https://registry.npmjs.org",
-    "publish:beta:token": "bash ../scripts/publish-cli-go.sh --version 1.1.0 --tag beta --token $NPM_TOKEN --registry https://registry.npmjs.org"
+    "build": "tsc",
+    "build:obfuscate": "tsc && node scripts/obfuscate.mjs",
+    "check": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run clean && npm run build:obfuscate",
+    "publish:npm": "bash ../scripts/publish-cli-go.sh --version 1.1.1 --registry https://registry.npmjs.org",
+    "publish:beta": "bash ../scripts/publish-cli-go.sh --version 1.1.1 --tag beta --registry https://registry.npmjs.org",
+    "publish:npm:token": "bash ../scripts/publish-cli-go.sh --version 1.1.1 --token $NPM_TOKEN --registry https://registry.npmjs.org",
+    "publish:beta:token": "bash ../scripts/publish-cli-go.sh --version 1.1.1 --tag beta --token $NPM_TOKEN --registry https://registry.npmjs.org"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "javascript-obfuscator": "^4.1.1",
+    "typescript": "^5.3.0"
   },
   "engines": {
     "node": ">=18.0.0"