@vocmarket/voc-skill 0.3.29 → 0.3.30

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "voc-intelligence",
   "description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu and Douyin trend reports, live social VOC collection, Fmode Doubao image analysis, token/recharge checks, evidence-card outputs, prioritized issue pools, single-problem deep dives, competitor maps, 7-day content plans, VOC-backed speaking script co-creation, boss/operator action plans, and multi-turn memory.",
-  "version": "0.3.29",
+  "version": "0.3.30",
   "author": {
     "name": "nkkj-BrainHack"
   }

package/bin/claude-voc.js

@@ -3,6 +3,7 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
+const { ensureActivated } = require('../mcp/src/core/activation');
 
 const SOURCE_ROOT = path.resolve(__dirname, '..');
 const WORKSPACE_ROOT = process.cwd();
@@ -34,6 +35,7 @@ function usage() {
     'Usage:',
     '  claude-voc install',
     '  claude-voc workspace',
+    '  claude-voc workspace --activate',
     '  claude-voc install --workspace --smoke',
     '  claude-voc check',
     '  claude-voc smoke',
@@ -43,6 +45,7 @@ function usage() {
     'npx:',
     '  npx @vocmarket/voc-skill install',
     '  npx @vocmarket/voc-skill workspace --smoke',
+    '  npx @vocmarket/voc-skill workspace --activate   (其他 AI 编程器渠道专用：安装并按状态弹付费)',
     '',
     'Options:',
     '  --workspace      Install into ./.claude/plugins/voc-intelligence',
@@ -50,6 +53,8 @@ function usage() {
     '  --force          Allow overwriting an existing custom target',
     '  --skip-install   Skip npm install after copying files',
     '  --smoke          Run sample/preference/MCP smoke checks after install',
+    '  --activate       安装后按 token 状态激活：无 token 弹付费/登录页，有 token 直接放行（外部 AI IDE 专用，不影响 --smoke）',
+    '  --channel <name> 付费归因渠道名（claude-code/codex/workbuddy）',
     '  --help, -h       Show help'
   ].join('\n');
 }
@@ -65,6 +70,8 @@ function parseArgs(argv) {
     target: DEFAULT_TARGET,
     skipInstall: false,
     smoke: false,
+    activate: false,
+    channel: 'external',
     force: false,
     help: false
   };
@@ -88,6 +95,12 @@ function parseArgs(argv) {
       opts.skipInstall = true;
     } else if (token === '--smoke') {
       opts.smoke = true;
+    } else if (token === '--activate') {
+      opts.activate = true;
+    } else if (token === '--channel') {
+      opts.channel = argv[++i];
+    } else if (token.startsWith('--channel=')) {
+      opts.channel = token.slice('--channel='.length);
     } else if (token === '--help' || token === '-h') {
       opts.help = true;
     }
@@ -716,7 +729,7 @@ function printPath(opts) {
   }
 }
 
-function main() {
+async function main() {
   const directCommand = process.argv[2];
   if (directCommand === 'image' || directCommand === 'fmode-image') {
     run(process.execPath, ['mcp/src/tools/fmode-image-analysis.js', ...process.argv.slice(3)], SOURCE_ROOT);
@@ -728,17 +741,23 @@ function main() {
     console.log(usage());
     return;
   }
-  if (opts.command === 'install') return install(opts);
+  if (opts.command === 'install') {
+    install(opts);
+    if (opts.activate) {
+      await ensureActivated({ channel: opts.channel });
+    }
+    return;
+  }
   if (opts.command === 'check') return check(opts);
   if (opts.command === 'smoke') return smoke(opts);
   if (opts.command === 'path') return printPath(opts);
   throw new Error(`Unknown command: ${opts.command}\n\n${usage()}`);
 }
 
-try {
-  main();
-} catch (error) {
+main().catch((error) => {
   console.error('');
   console.error(`claude-voc failed: ${error.message}`);
   process.exit(1);
-}
+});
+
+

package/mcp/src/core/activation.js

@@ -0,0 +1,104 @@
+'use strict';
+
+// 安装收尾激活检查（仅供外部 AI IDE 渠道的 `workspace --activate` 调用）。
+//
+// 设计要点（与 voc-api-catalog 计费链一致，复用同一套凭证解析，绝不另建路径）：
+// - 复用 credentials.js 的 readNewApiToken()（sk- 主链）/ readVocToken()（r: 会话回退）。
+// - 按「是否已有可用 token」这一状态触发，而不是按命令触发：
+//     * 已检测到 token（飞马 UI 已写入，或 Claude Code 已配 sk-）→ 打印「✅ 已激活」，不弹浏览器。
+//     * 完全没有 token（现场新教练）→ 安装收尾立刻打开充值/登录页，避免进入取数流程后才弹、空耗 token。
+// - 不主动发计费请求做探测（探测会真扣费）；余额不足留给真实取数时由 catalog 的 402 分支处理。
+// - VOC_OPEN_PAYMENT=0 可强制关闭弹窗（CI / 冒烟 / 无头环境）。
+// - 始终把 URL 打印到终端兜底；并追加 &channel=&src=install 做渠道归因。
+// - token 绝不回显到终端 / 日志。
+
+const { spawn } = require('child_process');
+const { readNewApiToken, readVocToken } = require('./credentials');
+const { buildVocRechargeInfo } = require('./payment-links');
+
+function appendAttribution(rawUrl, channel, src) {
+  try {
+    const url = new URL(rawUrl);
+    if (channel) url.searchParams.set('channel', String(channel));
+    if (src) url.searchParams.set('src', String(src));
+    return url.toString();
+  } catch {
+    return rawUrl;
+  }
+}
+
+function openBrowser(url) {
+  try {
+    let command;
+    let args;
+    if (process.platform === 'win32') {
+      command = 'cmd';
+      // 空字符串是 start 的窗口标题占位，避免带引号的 URL 被当成标题
+      args = ['/d', '/s', '/c', 'start', '', url];
+    } else if (process.platform === 'darwin') {
+      command = 'open';
+      args = [url];
+    } else {
+      command = 'xdg-open';
+      args = [url];
+    }
+    const child = spawn(command, args, { stdio: 'ignore', detached: true });
+    child.on('error', () => {});
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// channel: 渠道名（claude-code / codex / workbuddy），用于付费归因
+// src: 来源标记，默认 install
+async function ensureActivated({ channel = 'external', src = 'install' } = {}) {
+  if (process.env.VOC_OPEN_PAYMENT === '0') {
+    console.log('');
+    console.log('VOC_OPEN_PAYMENT=0：已跳过激活弹窗（CI/无头环境）。');
+    return { status: 'skipped' };
+  }
+
+  const newApiToken = readNewApiToken();
+  const vocToken = readVocToken();
+
+  if (newApiToken || vocToken) {
+    console.log('');
+    console.log('✅ 已激活：检测到 VOC 计费/会话 token，可直接开始取数，无需充值。');
+    console.log('（若取数时返回 402 余额不足，再按工具提示充值即可。）');
+    return { status: 'activated' };
+  }
+
+  // 完全没有 token：现场新用户。打开充值/登录页，引导先付费再进流程。
+  // 无 token 时 buildVocRechargeInfo 不会发起网络请求（resolveVocUserId 对空 token 直接返回）。
+  let recharge;
+  try {
+    recharge = await buildVocRechargeInfo({ token: '' });
+  } catch {
+    recharge = {};
+  }
+  const primaryUrl = appendAttribution(
+    recharge.recommendedPackageUrl || recharge.paymentUrl || 'https://app.fmode.cn/dev/apig-pay/',
+    channel,
+    src
+  );
+
+  console.log('');
+  console.log('⚠️  尚未检测到 VOC token —— 你还没有激活。');
+  console.log('为避免进入取数流程后才发现需要付费、白白消耗 token，请先在浏览器完成登录并充值/开通：');
+  console.log(`  ${primaryUrl}`);
+  if (recharge.paymentUrl) {
+    console.log(`  （充值入口：${appendAttribution(recharge.paymentUrl, channel, src)}）`);
+  }
+  console.log('完成付费后，再让 AI 进入取数/报告流程。');
+  console.log('如本机无法自动打开浏览器，请手动复制上面的链接到浏览器打开。');
+
+  const opened = openBrowser(primaryUrl);
+  if (!opened) {
+    console.log('（自动打开浏览器失败，请手动打开上面的链接。）');
+  }
+  return { status: 'needs_activation', url: primaryUrl };
+}
+
+module.exports = { ensureActivated, openBrowser, appendAttribution };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocmarket/voc-skill",
-  "version": "0.3.29",
+  "version": "0.3.30",
   "description": "Claude Code VOC intelligence skills for Xiaohongshu and Douyin trend reports, live social VOC collection, Fmode image analysis, single-issue deep dives, boss/operator action plans, and multi-turn memory.",
   "type": "commonjs",
   "bin": {

package/skill-package-manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-voc-intelligence",
-  "version": "0.3.29",
+  "version": "0.3.30",
   "capabilities": {
     "summary": "三类情报源同源接入：①社媒内容 ②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
     "channels": [