@lotaber_wang/openclaw-dc-plugin 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# TapTap DC OpenClaw Plugin
+
+OpenClaw plugin that exposes raw TapTap DC tools and bundles a TapTap DC ops-brief skill.
+
+## What It Does
+
+- installs as a native OpenClaw plugin
+- internally boots the published `@mikoto_zero/minigame-open-mcp` runtime
+- exposes raw JSON-oriented TapTap tools for:
+  - authorization
+  - app selection
+  - store/review/community overview
+  - store snapshot
+  - forum contents
+  - reviews
+  - like/reply review actions
+- bundles a `taptap-dc-ops-brief` skill that turns those raw responses into a concise ops brief
+
+## Install
+
+```bash
+openclaw plugins install @lotaber_wang/openclaw-dc-plugin
+```
+
+## Typical Flow
+
+1. Call `taptap_dc_check_environment`
+2. If not authorized, call `taptap_dc_start_authorization`
+3. Ask the user to open `auth_url` or scan `qrcode_url`
+4. Call `taptap_dc_complete_authorization`
+5. Call `taptap_dc_list_apps`
+6. Call `taptap_dc_select_app`
+7. Call overview tools and let the bundled skill produce the brief
+
+## Configuration
+
+Optional plugin config:
+
+- `environment`: `production` or `rnd`
+- `workspaceRoot`
+- `cacheDir`
+- `tempDir`
+- `logRoot`
+- `verbose`
+
+Production use should not need `client_id` / `client_secret` overrides when the embedded TapTap package already contains them.

package/index.js

@@ -0,0 +1,374 @@
+import { readFileSync } from 'node:fs';
+import { TapTapMcpBridge } from './lib/mcp-bridge.js';
+
+function toolResult(text, details = {}) {
+  return {
+    content: [{ type: 'text', text }],
+    details,
+  };
+}
+
+function tryParseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+function normalizeJsonText(text) {
+  const parsed = tryParseJson(text);
+  if (parsed !== null) {
+    return JSON.stringify(parsed, null, 2);
+  }
+
+  const fencedJson = text.match(/```json\s*([\s\S]*?)```/i);
+  if (fencedJson?.[1]) {
+    const parsedFence = tryParseJson(fencedJson[1].trim());
+    if (parsedFence !== null) {
+      return JSON.stringify(parsedFence, null, 2);
+    }
+  }
+
+  return JSON.stringify(
+    {
+      ok: false,
+      error: 'UNPARSEABLE_RESPONSE',
+      raw: text,
+    },
+    null,
+    2
+  );
+}
+
+function createSchema(properties = {}, required = []) {
+  return {
+    type: 'object',
+    properties,
+    ...(required.length > 0 ? { required } : {}),
+    additionalProperties: false,
+  };
+}
+
+function registerProxyTool(api, bridge, definition) {
+  api.registerTool(
+    () => ({
+      name: definition.name,
+      label: definition.label,
+      description: definition.description,
+      parameters: definition.parameters,
+      async execute(_id, params) {
+        try {
+          const text = await bridge.callTool(definition.mcpToolName, params || {});
+          const normalized = normalizeJsonText(text);
+          return toolResult(normalized, {
+            mcpToolName: definition.mcpToolName,
+            parsed: tryParseJson(normalized),
+          });
+        } catch (error) {
+          return toolResult(
+            JSON.stringify(
+              {
+                ok: false,
+                error: 'PLUGIN_PROXY_ERROR',
+                message: error instanceof Error ? error.message : String(error),
+              },
+              null,
+              2
+            )
+          );
+        }
+      },
+    }),
+    { name: definition.name }
+  );
+}
+
+const toolDefinitions = [
+  {
+    name: 'taptap_dc_check_environment',
+    label: 'TapTap Env',
+    description: 'Check embedded TapTap runtime, signer, auth status, and directories as raw JSON.',
+    mcpToolName: 'check_environment_raw',
+    parameters: createSchema(),
+  },
+  {
+    name: 'taptap_dc_start_authorization',
+    label: 'TapTap Auth Start',
+    description:
+      'Start TapTap OAuth device flow and return auth_url/qrcode_url/device_code as raw JSON.',
+    mcpToolName: 'start_oauth_authorization_raw',
+    parameters: createSchema(),
+  },
+  {
+    name: 'taptap_dc_complete_authorization',
+    label: 'TapTap Auth Complete',
+    description: 'Complete TapTap OAuth device flow after the user scans and approves the QR code.',
+    mcpToolName: 'complete_oauth_authorization_raw',
+    parameters: createSchema(),
+  },
+  {
+    name: 'taptap_dc_clear_auth',
+    label: 'TapTap Clear Auth',
+    description: 'Clear TapTap cached token and/or selected app cache.',
+    mcpToolName: 'clear_auth_data_raw',
+    parameters: createSchema({
+      clear_token: {
+        type: 'boolean',
+        description: 'Clear OAuth token cache. Defaults to true.',
+      },
+      clear_cache: {
+        type: 'boolean',
+        description: 'Clear selected app cache. Defaults to true.',
+      },
+    }),
+  },
+  {
+    name: 'taptap_dc_list_apps',
+    label: 'TapTap Apps',
+    description: 'List all accessible developers and apps as raw JSON.',
+    mcpToolName: 'list_developers_and_apps_raw',
+    parameters: createSchema(),
+  },
+  {
+    name: 'taptap_dc_select_app',
+    label: 'TapTap Select App',
+    description: 'Select a developer/app pair for subsequent TapTap DC calls.',
+    mcpToolName: 'select_app_raw',
+    parameters: createSchema(
+      {
+        developer_id: {
+          type: 'number',
+          description: 'Developer ID to select.',
+        },
+        app_id: {
+          type: 'number',
+          description: 'App ID to select.',
+        },
+      },
+      ['developer_id', 'app_id']
+    ),
+  },
+  {
+    name: 'taptap_dc_get_current_app',
+    label: 'TapTap Current App',
+    description: 'Get the currently selected app/cache payload as raw JSON.',
+    mcpToolName: 'get_current_app_info_raw',
+    parameters: createSchema({
+      ignore_cache: {
+        type: 'boolean',
+        description: 'Force refresh from server when true.',
+      },
+    }),
+  },
+  {
+    name: 'taptap_dc_get_store_overview',
+    label: 'TapTap Store Overview',
+    description: 'Get current-app store overview raw JSON.',
+    mcpToolName: 'get_current_app_store_overview_raw',
+    parameters: createSchema({
+      start_date: {
+        type: 'string',
+        description: 'Optional start date in YYYY-MM-DD format.',
+      },
+      end_date: {
+        type: 'string',
+        description: 'Optional end date in YYYY-MM-DD format.',
+      },
+    }),
+  },
+  {
+    name: 'taptap_dc_get_review_overview',
+    label: 'TapTap Review Overview',
+    description: 'Get current-app review overview raw JSON.',
+    mcpToolName: 'get_current_app_review_overview_raw',
+    parameters: createSchema({
+      start_date: {
+        type: 'string',
+        description: 'Optional start date in YYYY-MM-DD format.',
+      },
+      end_date: {
+        type: 'string',
+        description: 'Optional end date in YYYY-MM-DD format.',
+      },
+    }),
+  },
+  {
+    name: 'taptap_dc_get_community_overview',
+    label: 'TapTap Community Overview',
+    description: 'Get current-app community overview raw JSON.',
+    mcpToolName: 'get_current_app_community_overview_raw',
+    parameters: createSchema({
+      start_date: {
+        type: 'string',
+        description: 'Optional start date in YYYY-MM-DD format.',
+      },
+      end_date: {
+        type: 'string',
+        description: 'Optional end date in YYYY-MM-DD format.',
+      },
+    }),
+  },
+  {
+    name: 'taptap_dc_get_store_snapshot',
+    label: 'TapTap Store Snapshot',
+    description: 'Get current-app store snapshot raw JSON.',
+    mcpToolName: 'get_current_app_store_snapshot_raw',
+    parameters: createSchema(),
+  },
+  {
+    name: 'taptap_dc_get_forum_contents',
+    label: 'TapTap Forum Contents',
+    description: 'Get current-app forum contents raw JSON.',
+    mcpToolName: 'get_current_app_forum_contents_raw',
+    parameters: createSchema({
+      type: {
+        type: 'string',
+        description: 'Forum flow type. Default: feed.',
+      },
+      sort: {
+        type: 'string',
+        description: 'Sort mode. Default: default.',
+      },
+      from: {
+        type: 'number',
+        description: 'Pagination start offset.',
+      },
+      limit: {
+        type: 'number',
+        description: 'Page size. Default 10, max 20.',
+      },
+      group_label_id: {
+        type: 'number',
+        description: 'Optional sub-group label ID.',
+      },
+    }),
+  },
+  {
+    name: 'taptap_dc_get_reviews',
+    label: 'TapTap Reviews',
+    description: 'Get current-app reviews raw JSON.',
+    mcpToolName: 'get_current_app_reviews_raw',
+    parameters: createSchema({
+      sort: {
+        type: 'string',
+        description: 'new / hot / spent',
+      },
+      from: {
+        type: 'number',
+        description: 'Pagination start offset.',
+      },
+      limit: {
+        type: 'number',
+        description: 'Page size. Default 10, max 10.',
+      },
+      is_collapsed: {
+        type: 'boolean',
+        description: 'Whether to query collapsed reviews.',
+      },
+      filter_platform: {
+        type: 'string',
+        description: 'mobile / pc / web',
+      },
+    }),
+  },
+  {
+    name: 'taptap_dc_like_review',
+    label: 'TapTap Like Review',
+    description: 'Like a current-app review and return the raw upstream response.',
+    mcpToolName: 'like_current_app_review_raw',
+    parameters: createSchema(
+      {
+        review_id: {
+          type: 'number',
+          description: 'Target review ID to like.',
+        },
+      },
+      ['review_id']
+    ),
+  },
+  {
+    name: 'taptap_dc_reply_review',
+    label: 'TapTap Reply Review',
+    description: 'Reply to a current-app review and return the raw upstream response.',
+    mcpToolName: 'reply_current_app_review_raw',
+    parameters: createSchema(
+      {
+        review_id: {
+          type: 'number',
+          description: 'Target review ID to reply to.',
+        },
+        contents: {
+          type: 'string',
+          description: 'Reply content to send.',
+        },
+        reply_comment_id: {
+          type: 'number',
+          description: 'Optional comment ID when replying to a child comment.',
+        },
+        confirm_high_risk: {
+          type: 'boolean',
+          description: 'Only set after explicit human approval.',
+        },
+      },
+      ['review_id', 'contents']
+    ),
+  },
+];
+
+let pluginVersion = 'unknown';
+try {
+  const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
+  pluginVersion = pkg.version || 'unknown';
+} catch {
+  // Best-effort version only
+}
+
+const plugin = {
+  id: 'taptap-dc-plugin',
+  name: 'TapTap DC',
+  description: 'Raw TapTap DC tools for OpenClaw, bundled with an ops brief skill.',
+  configSchema: {
+    type: 'object',
+    properties: {
+      environment: {
+        type: 'string',
+        enum: ['production', 'rnd'],
+        default: 'production',
+      },
+      workspaceRoot: {
+        type: 'string',
+      },
+      cacheDir: {
+        type: 'string',
+      },
+      tempDir: {
+        type: 'string',
+      },
+      logRoot: {
+        type: 'string',
+      },
+      verbose: {
+        type: 'boolean',
+        default: false,
+      },
+    },
+    additionalProperties: false,
+  },
+  register(api) {
+    const bridge = new TapTapMcpBridge({
+      logger: api.logger,
+      config: api.pluginConfig || {},
+    });
+
+    for (const definition of toolDefinitions) {
+      registerProxyTool(api, bridge, definition);
+    }
+
+    api.logger.info?.(
+      `[TapTap DC] OpenClaw plugin v${pluginVersion} initialised with ${toolDefinitions.length} tools`
+    );
+  },
+};
+
+export default plugin;

package/lib/mcp-bridge.js

@@ -0,0 +1,251 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const HEADER_SEPARATOR = '\r\n\r\n';
+
+function resolveLocalServerPath() {
+  const currentDir = path.dirname(fileURLToPath(import.meta.url));
+  return path.resolve(currentDir, '../../../dist/server.js');
+}
+
+function resolveEmbeddedServerPath() {
+  try {
+    const packageJsonPath = require.resolve('@mikoto_zero/minigame-open-mcp/package.json');
+    const packageRoot = path.dirname(packageJsonPath);
+    const serverPath = path.join(packageRoot, 'dist', 'server.js');
+    if (existsSync(serverPath)) {
+      return serverPath;
+    }
+  } catch {
+    // Fall through to local dev path
+  }
+
+  const localServerPath = resolveLocalServerPath();
+  if (existsSync(localServerPath)) {
+    return localServerPath;
+  }
+
+  throw new Error(
+    'Unable to resolve the embedded TapTap MCP server. Make sure @mikoto_zero/minigame-open-mcp is installed.'
+  );
+}
+
+function parseMessageBuffer(buffer, onMessage) {
+  let offset = 0;
+
+  while (offset < buffer.length) {
+    const headerEnd = buffer.indexOf(HEADER_SEPARATOR, offset, 'utf8');
+    if (headerEnd === -1) {
+      break;
+    }
+
+    const headerText = buffer.subarray(offset, headerEnd).toString('utf8');
+    const contentLengthMatch = headerText.match(/content-length:\s*(\d+)/i);
+    if (!contentLengthMatch) {
+      throw new Error(`Missing Content-Length header in MCP frame: ${headerText}`);
+    }
+
+    const contentLength = Number(contentLengthMatch[1]);
+    const bodyStart = headerEnd + HEADER_SEPARATOR.length;
+    const bodyEnd = bodyStart + contentLength;
+    if (buffer.length < bodyEnd) {
+      break;
+    }
+
+    const bodyText = buffer.subarray(bodyStart, bodyEnd).toString('utf8');
+    onMessage(JSON.parse(bodyText));
+    offset = bodyEnd;
+  }
+
+  return buffer.subarray(offset);
+}
+
+function extractTextFromToolResult(result) {
+  if (!result || !Array.isArray(result.content)) {
+    return JSON.stringify(result, null, 2);
+  }
+
+  const parts = result.content
+    .filter((item) => item && item.type === 'text' && typeof item.text === 'string')
+    .map((item) => item.text);
+
+  if (parts.length === 0) {
+    return JSON.stringify(result, null, 2);
+  }
+
+  return parts.join('\n\n');
+}
+
+export class TapTapMcpBridge {
+  constructor(options = {}) {
+    this.logger = options.logger;
+    this.config = options.config || {};
+    this.child = null;
+    this.readyPromise = null;
+    this.pending = new Map();
+    this.nextId = 1;
+    this.stdoutBuffer = Buffer.alloc(0);
+  }
+
+  buildEnv() {
+    const env = {
+      ...process.env,
+      TAPTAP_MCP_TRANSPORT: 'stdio',
+      TAPTAP_MCP_ENV: this.config.environment || 'production',
+      TAPTAP_MCP_ENABLE_RAW_TOOLS: 'true',
+    };
+
+    if (this.config.workspaceRoot) {
+      env.TAPTAP_MCP_WORKSPACE_ROOT = this.config.workspaceRoot;
+    }
+    if (this.config.cacheDir) {
+      env.TAPTAP_MCP_CACHE_DIR = this.config.cacheDir;
+    }
+    if (this.config.tempDir) {
+      env.TAPTAP_MCP_TEMP_DIR = this.config.tempDir;
+    }
+    if (this.config.logRoot) {
+      env.TAPTAP_MCP_LOG_ROOT = this.config.logRoot;
+    }
+    if (this.config.verbose) {
+      env.TAPTAP_MCP_VERBOSE = 'true';
+    }
+
+    return env;
+  }
+
+  async ensureReady() {
+    if (this.readyPromise) {
+      return this.readyPromise;
+    }
+
+    this.readyPromise = this.start();
+    return this.readyPromise;
+  }
+
+  async start() {
+    const serverPath = resolveEmbeddedServerPath();
+    this.child = spawn(process.execPath, [serverPath], {
+      env: this.buildEnv(),
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    this.child.stdout.on('data', (chunk) => {
+      try {
+        this.stdoutBuffer = Buffer.concat([this.stdoutBuffer, chunk]);
+        this.stdoutBuffer = parseMessageBuffer(this.stdoutBuffer, (message) =>
+          this.handleMessage(message)
+        );
+      } catch (error) {
+        this.logger?.error?.(
+          `[TapTap DC] Failed to parse MCP stdout: ${
+            error instanceof Error ? error.message : String(error)
+          }`
+        );
+      }
+    });
+
+    this.child.stderr.on('data', (chunk) => {
+      const text = chunk.toString('utf8').trim();
+      if (text) {
+        this.logger?.info?.(`[TapTap MCP] ${text}`);
+      }
+    });
+
+    this.child.on('exit', (code, signal) => {
+      const error = new Error(
+        `Embedded TapTap MCP server exited unexpectedly (code=${code ?? 'null'}, signal=${signal ?? 'null'}).`
+      );
+      for (const pending of this.pending.values()) {
+        pending.reject(error);
+      }
+      this.pending.clear();
+      this.child = null;
+      this.readyPromise = null;
+    });
+
+    await this.request('initialize', {
+      protocolVersion: '2025-11-25',
+      capabilities: {
+        tools: {},
+        resources: {},
+        logging: {},
+      },
+      clientInfo: {
+        name: 'taptap-openclaw-dc-plugin',
+        version: '0.1.0',
+      },
+    });
+
+    this.notify('notifications/initialized', {});
+  }
+
+  handleMessage(message) {
+    if (message.id !== undefined && this.pending.has(message.id)) {
+      const pending = this.pending.get(message.id);
+      this.pending.delete(message.id);
+
+      if (message.error) {
+        pending.reject(new Error(message.error.message || JSON.stringify(message.error)));
+        return;
+      }
+
+      pending.resolve(message.result);
+      return;
+    }
+  }
+
+  send(message) {
+    if (!this.child?.stdin) {
+      throw new Error('Embedded TapTap MCP server is not running.');
+    }
+
+    const body = JSON.stringify(message);
+    const frame = `Content-Length: ${Buffer.byteLength(body, 'utf8')}\r\n\r\n${body}`;
+    this.child.stdin.write(frame, 'utf8');
+  }
+
+  request(method, params) {
+    const id = this.nextId++;
+
+    return new Promise((resolve, reject) => {
+      this.pending.set(id, { resolve, reject });
+      this.send({
+        jsonrpc: '2.0',
+        id,
+        method,
+        params,
+      });
+    });
+  }
+
+  notify(method, params) {
+    this.send({
+      jsonrpc: '2.0',
+      method,
+      params,
+    });
+  }
+
+  async callTool(name, args = {}) {
+    await this.ensureReady();
+    const result = await this.request('tools/call', {
+      name,
+      arguments: args,
+    });
+    return extractTextFromToolResult(result);
+  }
+
+  async close() {
+    if (this.child) {
+      this.child.kill();
+      this.child = null;
+      this.readyPromise = null;
+    }
+  }
+}

package/openclaw.plugin.json

@@ -0,0 +1,40 @@
+{
+  "id": "taptap-dc-plugin",
+  "name": "TapTap DC",
+  "description": "Raw TapTap DC tools for OpenClaw, bundled with an ops brief skill.",
+  "version": "0.1.0",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "environment": {
+        "type": "string",
+        "description": "TapTap environment to use.",
+        "enum": ["production", "rnd"],
+        "default": "production"
+      },
+      "workspaceRoot": {
+        "type": "string",
+        "description": "Optional workspace root passed to the embedded TapTap runtime."
+      },
+      "cacheDir": {
+        "type": "string",
+        "description": "Optional cache directory override for the embedded TapTap runtime."
+      },
+      "tempDir": {
+        "type": "string",
+        "description": "Optional temp directory override for the embedded TapTap runtime."
+      },
+      "logRoot": {
+        "type": "string",
+        "description": "Optional log directory override for the embedded TapTap runtime."
+      },
+      "verbose": {
+        "type": "boolean",
+        "description": "Enable verbose logging for the embedded TapTap runtime.",
+        "default": false
+      }
+    },
+    "additionalProperties": false
+  }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@lotaber_wang/openclaw-dc-plugin",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "OpenClaw plugin for TapTap DC raw data tools with a bundled ops-brief skill.",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.js",
+    "lib/",
+    "openclaw.plugin.json",
+    "skills/",
+    "README.md"
+  ],
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "taptap",
+    "dc",
+    "skill"
+  ],
+  "engines": {
+    "node": ">=18.14.1"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "openclaw": ">=2026.1.29"
+  },
+  "dependencies": {
+    "@mikoto_zero/minigame-open-mcp": "^1.19.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/taptap/taptap_minigame_open_mcp.git",
+    "directory": "packages/openclaw-dc-plugin"
+  },
+  "homepage": "https://github.com/taptap/taptap_minigame_open_mcp/tree/main/packages/openclaw-dc-plugin",
+  "bugs": {
+    "url": "https://github.com/taptap/taptap_minigame_open_mcp/issues"
+  }
+}

package/skills/taptap-dc-ops-brief/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: taptap-dc-ops-brief
+description: 生成 TapTap 当前游戏 DC 运营简报与结论解读（商店/评价/社区）。在 OpenClaw 中使用 bundled raw-data tools 拉原始 JSON，再由 skill 负责解读与行动建议。
+---
+
+# TapTap DC 运营简报（OpenClaw Plugin）
+
+## 适用范围
+
+- 面向人群：运营同学、工作室开发者
+- 输出目标：用最少认知成本，把 TapTap DC 原始数据变成“结论 + 重点解读 + 下一步建议”
+- 数据来源：当前 OpenClaw plugin 提供的 raw tools
+- 重要约束：任何写操作（点赞/官方回复）都必须先征得用户许可
+
+## 默认工作流
+
+1. 自检插件环境
+   - 调用 `taptap_dc_check_environment`
+2. 如果未授权
+   - 调用 `taptap_dc_start_authorization`
+   - 让用户打开 `auth_url` 或扫描 `qrcode_url`
+   - 用户确认后调用 `taptap_dc_complete_authorization`
+3. 选择游戏
+   - 调用 `taptap_dc_list_apps`
+   - 展示列表并让用户指定
+   - 调用 `taptap_dc_select_app`
+4. 拉取只读数据
+   - `taptap_dc_get_store_overview`
+   - `taptap_dc_get_review_overview`
+   - `taptap_dc_get_community_overview`
+   - 需要结果快照时调用 `taptap_dc_get_store_snapshot`
+   - 需要具体内容时调用 `taptap_dc_get_reviews` / `taptap_dc_get_forum_contents`
+5. 输出“30 秒可读”的简报
+6. 若需要动作建议，可给出“是否建议点赞/回复”的候选，但不要直接执行
+
+## 输出要求
+
+输出尽量短，一屏内读完：
+
+1. 结论（3 行内）
+2. 关键指标（仅列 5-8 个最相关）
+3. 变化与解读（最多 3 点）
+4. 建议动作（最多 3 条，且需用户确认后才执行）
+
+## 关键规则
+
+- 这些 plugin tools 返回的是 **raw JSON**，你要自己完成解读，不要把 JSON 原样长篇贴回给用户
+- `page_view_count` 应写成“详情页访问量（PV）”，不要偷换成别的口径
+- `taptap_dc_like_review` / `taptap_dc_reply_review` 只能在用户明确确认后调用
+- 如果回复结果里出现 `need_confirmation=true`，必须先把草稿给用户确认，再决定是否带 `confirm_high_risk=true` 重试
+
+## 口径参考
+
+- 指标口径：见 `references/metrics.md`
+- 动作判断：见 `references/actions_rubric.md`

package/skills/taptap-dc-ops-brief/references/actions_rubric.md

@@ -0,0 +1,37 @@
+# 点赞/回复动作建议 Rubric（简化版）
+
+本文件用于在“只读简报”之外，给出可控的运营动作建议。任何写操作都必须先征得用户许可。
+
+## 点赞（like）建议
+
+优先点赞的评价类型：
+
+- 信息密度高：包含明确问题描述、复现步骤、机型/版本信息
+- 具有代表性：反映当前版本最常见的 1-2 个核心问题
+- 正向长评：能帮其他用户做决策，且语气友好
+
+不建议点赞的情况：
+
+- 明显引战、辱骂、人身攻击
+- 涉及敏感/合规风险
+
+## 官方回复（reply）建议
+
+建议回复的触发条件：
+
+- 负向或中立，且包含可行动点
+- 互动较高或对转化影响大
+- 同类问题集中出现
+
+不建议直接回复的情况：
+
+- 涉及账号/支付隐私，需要引导走客服渠道
+- 需要承诺时间点或赔付
+
+## 执行前确认
+
+调用写操作前，必须向用户展示：
+
+- 目标评价：`review_id` + 内容摘要
+- 拟执行动作：点赞/回复
+- 拟回复文本（如为回复）

package/skills/taptap-dc-ops-brief/references/metrics.md

@@ -0,0 +1,23 @@
+# TapTap 店铺运营指标口径速查（简化版）
+
+本文件用于把 TapTap raw tools 返回的字段，映射为运营可理解的“指标名 + 口径解释”。
+
+## 使用原则
+
+- 报告正文优先用中文短名，首次出现时解释一次
+- 不确定口径时，标注“口径待确认”，并把字段原名一并展示
+- `page_view_count` 指 **详情页浏览量（PV）**
+- 不要把 `page_view_count` 解读成推荐曝光或其他渠道曝光
+
+## 常用指标
+
+| 简报用名           | 字段名                             | 说明                  |
+| ------------------ | ---------------------------------- | --------------------- |
+| 详情页访问量（PV） | `page_view_count`                  | 商店详情页浏览量      |
+| 下载请求量         | `download_request_count`           | 点击下载/触发下载次数 |
+| 下载完成量         | `download_count`                   | 实际完成下载的次数    |
+| 预约量             | `reserve_count`                    | 预约行为次数          |
+| 广告下载&预约量    | `ad_download_reserve_count`        | 广告带来的下载/预约量 |
+| PC 下载请求量      | `pc_download_request_count`        | PC 端触发下载的请求数 |
+| 社区页面浏览量     | `topic_page_view_count`            | 社区页面 PV           |
+| 评价总数           | `rating_summary.stat.review_count` | 历史累计评价数        |