@optima-chat/tiktok-cli 0.17.0 → 0.18.0

package/README.md

@@ -13,6 +13,7 @@ tiktok <domain> <verb> --shop <shopId> [--flags]
 - `--shop` **必填**（多店显式路由，对应 A 轨「多店必须显式选店」教训；`auth link` 除外）
 - 默认 **JSON 输出**，统一信封 `{ ok, data?, error?, meta? }`
 - `TIKTOK_BACKEND_URL` 解析顺序：显式环境变量 > `OPTIMA_ENV` 映射（`cn-stage` → `https://tiktok-api.stage.optima.chat`；`cn-prod` → `https://tiktok-api.yzsgo.com`）> 本地默认 `http://127.0.0.1:3000`
+- `OPTIMA_TRACE`（可选，COO 会话设为 `coo/<taskId>`）：非空（trim 后）时每个打 backend 的请求都带 `X-Optima-Trace: <值>`，供用量按任务归因（Optima-Chat/optima-coo#645）；没设 / 空白则不带。只发 backend，CLI 本就不直连第三方
 
 ## 命令（v1 只读）
 

package/dist/index.js

@@ -129,6 +129,15 @@ function authHeaders() {
   }
   return {};
 }
+function traceHeaders(env2 = process.env) {
+  const v = env2.OPTIMA_TRACE?.trim();
+  return v ? { "X-Optima-Trace": v } : {};
+}
+function backendFetch(url, init = {}) {
+  const headers = new Headers(init.headers);
+  for (const [k, v] of Object.entries(traceHeaders())) headers.set(k, v);
+  return fetch(url, { ...init, headers });
+}
 function classify(status, body, shop) {
   const meta = { shop, tiktok_request_id: body?.request_id, http_status: status };
   if (status === 0 || body?.code === 0) {
@@ -148,7 +157,7 @@ async function proxy(method, shop, path, opts = {}) {
   const qs = opts.query ? "?" + new URLSearchParams(opts.query) : "";
   const url = `${BACKEND}/proxy/${shop}${path}${qs}`;
   try {
-    const r = await fetch(url, {
+    const r = await backendFetch(url, {
       method,
       headers: {
         "Content-Type": "application/json",
@@ -165,7 +174,7 @@ async function proxy(method, shop, path, opts = {}) {
 }
 async function listShops() {
   try {
-    const r = await fetch(`${BACKEND}/auth/shops`, { headers: authHeaders() });
+    const r = await backendFetch(`${BACKEND}/auth/shops`, { headers: authHeaders() });
     if (r.status === 401) return { ok: false, error: { code: "AUTH_EXPIRED", message: "\u672A\u767B\u5F55\u6216 token \u5931\u6548", retryable: false } };
     const body = await r.json();
     return { ok: true, data: body.shops };
@@ -176,7 +185,7 @@ async function listShops() {
 async function setShopApp(shopId, serviceId, note) {
   const token = process.env.TIKTOK_ADMIN_TOKEN;
   try {
-    const r = await fetch(`${BACKEND}/admin/apps/shop-map`, {
+    const r = await backendFetch(`${BACKEND}/admin/apps/shop-map`, {
       method: "PUT",
       headers: { "Content-Type": "application/json", ...token ? { "x-admin-token": token } : {} },
       body: JSON.stringify({ shopId, serviceId, note })
@@ -190,7 +199,7 @@ async function setShopApp(shopId, serviceId, note) {
 }
 async function availableApps() {
   try {
-    const r = await fetch(`${BACKEND}/auth/apps`, { headers: authHeaders() });
+    const r = await backendFetch(`${BACKEND}/auth/apps`, { headers: authHeaders() });
     if (r.status === 401) return { ok: false, error: { code: "AUTH_EXPIRED", message: "\u672A\u767B\u5F55\u6216 token \u5931\u6548", retryable: false } };
     const body = await r.json().catch(() => ({}));
     if (!r.ok || body?.error) {
@@ -203,7 +212,7 @@ async function availableApps() {
 }
 async function authLink(opts) {
   try {
-    const r = await fetch(`${BACKEND}/auth/link`, {
+    const r = await backendFetch(`${BACKEND}/auth/link`, {
       method: "POST",
       headers: { "Content-Type": "application/json", ...authHeaders() },
       body: JSON.stringify({ shop: opts.shop, app: opts.app })
@@ -222,7 +231,7 @@ async function adminApps(method, opts = {}) {
   const url = `${BACKEND}/admin/apps${opts.id ? `/${opts.id}` : ""}`;
   const token = process.env.TIKTOK_ADMIN_TOKEN;
   try {
-    const r = await fetch(url, {
+    const r = await backendFetch(url, {
       method,
       headers: {
         "Content-Type": "application/json",
@@ -245,7 +254,7 @@ async function adminApps(method, opts = {}) {
 async function fetchEvents(shop, query) {
   try {
     const qs = new URLSearchParams(query).toString();
-    const r = await fetch(`${BACKEND}/events/${shop}${qs ? "?" + qs : ""}`, { headers: authHeaders() });
+    const r = await backendFetch(`${BACKEND}/events/${shop}${qs ? "?" + qs : ""}`, { headers: authHeaders() });
     if (r.status === 401) return { ok: false, error: { code: "AUTH_EXPIRED", message: "\u672A\u767B\u5F55\u6216 token \u5931\u6548", retryable: false } };
     if (r.status === 404) return { ok: false, error: { code: "SHOP_NOT_AUTHORIZED", message: "\u672A\u627E\u5230\u4F60\u540D\u4E0B\u7684\u5DF2\u6388\u6743\u5E97\u94FA", retryable: false }, meta: { shop } };
     const body = await r.json();
@@ -256,7 +265,7 @@ async function fetchEvents(shop, query) {
 }
 async function ackEvents(shop, body) {
   try {
-    const r = await fetch(`${BACKEND}/events/${shop}/ack`, {
+    const r = await backendFetch(`${BACKEND}/events/${shop}/ack`, {
       method: "POST",
       headers: { "Content-Type": "application/json", ...authHeaders() },
       body: JSON.stringify(body)
@@ -275,7 +284,7 @@ async function uploadImage(shop, filePath, useCase) {
     const form = new FormData();
     form.append("data", new Blob([buf]), basename(filePath));
     form.append("use_case", useCase);
-    const r = await fetch(`${BACKEND}/proxy-upload/${shop}/image`, { method: "POST", headers: authHeaders(), body: form });
+    const r = await backendFetch(`${BACKEND}/proxy-upload/${shop}/image`, { method: "POST", headers: authHeaders(), body: form });
     const body = await r.json().catch(() => ({}));
     if (body?.code === 0) return { ok: true, data: { uri: body.data?.uri, url: body.data?.url, use_case: useCase }, meta: { shop } };
     return { ok: false, error: { code: r.status === 401 ? "AUTH_EXPIRED" : "TIKTOK_ERROR", message: body?.message ?? body?.error ?? `HTTP ${r.status}`, retryable: false }, meta: { shop } };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/tiktok-cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "TikTok Shop CLI for Optima agents — 经 tiktok-backend 操作店铺",
   "type": "module",
   "bin": {