@pn-data/pn-data-analysis 0.0.1

package/README.md

@@ -0,0 +1,71 @@
+# @pn/pn-data-analysis
+
+Cursor Agent Skill — 通过 pn_mid_v2 中台 API 查询项目的**流水、活跃、留存、来源**数据。
+
+## 安装
+
+```bash
+# 作为项目 Cursor Skill
+npm install @pn/pn-data-analysis
+# 将 node_modules/@pn/pn-data-analysis/pn-data-analysis/ 复制或链接到 .cursor/skills/
+```
+
+## 使用方式
+
+### 在 Cursor 中触发
+
+安装后 Cursor Agent 会自动识别该 Skill，通过自然语言触发：
+
+- 「用pn查 2088 2026-01 留存」
+- 「用中台分析 2023 项目 2026 年 1 月流水」
+- 「用pn查一下 2088 项目来源数据」
+
+### 命令行直接使用
+
+```bash
+python3 pn-data-analysis/pn_query.py <pid> <dataType> <YYYY-MM> [选项]
+```
+
+#### 数据类型
+
+| dataType  | 说明 |
+|-----------|------|
+| pay       | 流水、商店流水、收入 |
+| activity  | 活跃（新增、r1/r7/r30） |
+| retention | 留存（新增、r1~r90） |
+| source    | 来源（新增设备、转化率） |
+
+#### 选项
+
+| 选项 | 说明 | 默认 |
+|------|------|------|
+| `--appPlatform=N` | 0=全平台, 1=iOS, 2=Android | 0 |
+| `--group=N` | 分组：2=日期, 3=系统, 5=地区, 8=账号 | 2（留存为8） |
+| `--json` | 输出原始 JSON | 否 |
+
+#### 示例
+
+```bash
+# 流水
+python3 pn-data-analysis/pn_query.py 2023 pay 2026-01
+
+# 留存
+python3 pn-data-analysis/pn_query.py 2088 retention 2026-01
+
+# iOS 活跃
+python3 pn-data-analysis/pn_query.py 2023 activity 2026-01 --appPlatform=1
+
+# 来源（按地区分组）
+python3 pn-data-analysis/pn_query.py 2023 source 2026-01 --group=5
+
+# 原始 JSON
+python3 pn-data-analysis/pn_query.py 2023 retention 2026-01 --json
+```
+
+## 依赖
+
+- Python 3.6+（仅使用标准库，无第三方依赖）
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@pn-data/pn-data-analysis",
+  "version": "0.0.1",
+  "description": "Cursor Agent Skill for querying pn_mid_v2 project data (pay, activity, retention, source)",
+  "keywords": [
+    "cursor",
+    "cursor-skill",
+    "data-analysis"
+  ],
+  "author": "pn",
+  "license": "MIT",
+  "files": [
+    "pn-data-analysis/SKILL.md",
+    "pn-data-analysis/pn_query.py",
+    "README.md"
+  ],
+  "scripts": {
+    "query": "python3 pn-data-analysis/pn_query.py"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/pn-data-analysis/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: pn-data-analysis
+description: Analyzes project data on the middle platform (pn_mid_v2). Use when querying 收入, 流水, 商店流水, 活跃, 留存, 来源, project revenue, activity, retention, or source data by project and month.
+---
+
+# 中台项目数据分析
+
+通过 `pn_query.py` 远程查询 pn_mid_v2 中台各项目数据，支持**流水、活跃、留存、来源**四类查询。
+
+## 触发方式
+
+- **关键词 + 项目 + 日期 + 数据类型**：如「用pn查2023项目2026年1月流水」「用中台分析项目10的活跃」「用pn查一下XX项目来源数据」
+- **关键词**：用pn、用中台
+- **数据类型词**：收入、流水、商店流水、活跃、留存、来源
+
+## 项目名称解析
+
+- 项目 ID 直接使用（如「2023项目」→ pid=2023）
+- 「项目10」→ pid=2023
+
+---
+
+## 查询命令
+
+脚本位置：`.cursor/skills/pn-data-analysis/pn_query.py`
+
+```bash
+python3 .cursor/skills/pn-data-analysis/pn_query.py <pid> <dataType> <YYYY-MM> [选项]
+```
+
+### 四类数据
+
+| dataType | 说明 | 默认 group |
+|----------|------|-----------|
+| pay | 付费 (流水、商店流水、收入) | 2 (日期) |
+| activity | 活跃 (新增、r1/r7/r30) | 2 (日期) |
+| retention | 留存 (新增、r1/r7/r30) | 8 (账号) |
+| source | 来源 (新增设备、转化、转化率) | 2 (日期) |
+
+### 选项
+
+| 选项 | 说明 | 默认 |
+|------|------|------|
+| `--appPlatform=N` | 0=全平台, 1=iOS, 2=Android | 0 |
+| `--group=N` | 分组类型 | 2(日期)/8(留存) |
+| `--json` | 输出原始 JSON | 否 |
+
+### 分组类型 (group)
+
+| 值 | 说明 |
+|----|------|
+| 2 | 按日期 |
+| 3 | 按系统 |
+| 5 | 按地区 |
+| 8 | 按账号（留存默认） |
+
+---
+
+## 示例
+
+```bash
+# 流水
+python3 .cursor/skills/pn-data-analysis/pn_query.py 2023 pay 2026-01
+
+# 活跃（全平台）
+python3 .cursor/skills/pn-data-analysis/pn_query.py 2023 activity 2026-01
+
+# 留存（全平台）
+python3 .cursor/skills/pn-data-analysis/pn_query.py 2023 retention 2026-01
+
+# 来源
+python3 .cursor/skills/pn-data-analysis/pn_query.py 2023 source 2026-01
+
+# 仅 iOS 活跃
+python3 .cursor/skills/pn-data-analysis/pn_query.py 2023 activity 2026-01 --appPlatform=1
+
+# 原始 JSON
+python3 .cursor/skills/pn-data-analysis/pn_query.py 2023 retention 2026-01 --json
+```
+
+## 默认行为
+
+- **全平台**（appPlatform=0）
+- **按日期分组**（group=2），留存按账号（group=8）
+- **取总计**（key=total 行数据）
+
+## API 信息
+
+- 服务器：`https://pnv2.17995api.net`
+- 接口路径：`/service/pn_data_analysis`
+- 后端方法：`DataManager::pnDataAnalysis`
+- API 编号：3036（`Api::PN_DATA_ANALYSIS`）
+
+### 请求参数
+
+```json
+{
+  "pid": 2023,
+  "dataType": "activity",
+  "timeSpan": [1735689600, 1738367999],
+  "appPlatform": 0,
+  "group": 2,
+  "useCache": true
+}
+```
+
+### 返回结构
+
+- **pay**：`list` 数组，每项含 `method`、`pay_ta_usd`、`pay_store_usd`、`income_ta_usd` 等
+- **activity**：`listData` 数组，key=total 行含 `new`、`r1`~`r30`
+- **retention**：`listData` 数组，key=total 行含 `new`、`r1`~`r90`
+- **source**：`listData` 数组，各行含 `install`/`new`、`login`/`luu`
+
+## 流水核心字段
+
+| 字段 | 说明 |
+|------|------|
+| pay_ta_usd/cny | 流水 |
+| pay_store_usd/cny | 商店流水 |
+| income_ta_usd/cny | 收入 |
+| income_store_usd/cny | 商店收入 |
+| share_ta_usd/cny | 分成 |
+| profit_ta_usd/cny | 利润 |

package/pn-data-analysis/pn_query.py

@@ -0,0 +1,150 @@
+#!/usr/bin/env python3
+"""
+pn_query.py - 远程查询 pn_mid_v2 中台数据
+
+通过 HTTP API 调用 pnDataAnalysis 接口，查询项目的流水、活跃、留存、来源数据。
+
+用法:
+  python3 pn_query.py <pid> <dataType> <YYYY-MM> [选项]
+  python3 pn_query.py 2023 pay 2026-01
+  python3 pn_query.py 2023 activity 2026-01
+  python3 pn_query.py 2023 retention 2026-01
+  python3 pn_query.py 2023 source 2026-01 --group=5
+
+选项:
+  --appPlatform=N    0=全平台(默认) 1=iOS 2=Android
+  --group=N          分组类型，默认2(日期)。留存默认8(账号)
+"""
+
+import argparse
+import json
+import sys
+import urllib.request
+from calendar import monthrange
+from datetime import datetime
+
+API_BASE = "https://pnv2.17995api.net"
+API_PATH = "/service/pn_data_analysis"
+
+
+def query(pid: int, data_type: str, month: str, app_platform: int = 0, group: int = 2) -> dict:
+    st_date = datetime.strptime(f"{month}-01", "%Y-%m-%d")
+    y, m = st_date.year, st_date.month
+    _, last = monthrange(y, m)
+    st = int(datetime(y, m, 1).timestamp())
+    et = int(datetime(y, m, last, 23, 59, 59).timestamp())
+
+    payload = {
+        "pid": pid,
+        "dataType": data_type,
+        "timeSpan": [st, et],
+        "appPlatform": app_platform,
+        "group": group,
+        "useCache": True,
+    }
+    url = f"{API_BASE}{API_PATH}"
+    headers = {"Content-Type": "application/json;charset=UTF-8"}
+    req = urllib.request.Request(
+        url,
+        data=json.dumps(payload).encode("utf-8"),
+        headers=headers,
+        method="POST",
+    )
+    with urllib.request.urlopen(req, timeout=60) as resp:
+        return json.loads(resp.read().decode("utf-8"))
+
+
+def format_pay(data: list) -> str:
+    if not data:
+        return "无流水数据"
+    total = next((d for d in data if d.get("method") == "total"), data[0] if data else {})
+    lines = ["流水数据:"]
+    for k, label in [
+        ("pay_ta_usd", "流水(USD)"),
+        ("pay_ta_cny", "流水(CNY)"),
+        ("pay_store_usd", "商店流水(USD)"),
+        ("pay_store_cny", "商店流水(CNY)"),
+        ("income_ta_usd", "收入(USD)"),
+        ("income_ta_cny", "收入(CNY)"),
+        ("income_store_usd", "商店收入(USD)"),
+        ("income_store_cny", "商店收入(CNY)"),
+    ]:
+        if k in total:
+            lines.append(f"  {label}: {total[k]:,.2f}")
+    return "\n".join(lines)
+
+
+def format_activity(data: list) -> str:
+    if not data:
+        return "无活跃数据"
+    total = next((d for d in data if d.get("key") == "total"), data[0])
+    new = total.get("new", 0)
+    lines = [f"活跃数据:", f"  新增用户 new: {new:,}"]
+    for d in [1, 7, 30]:
+        k = f"r{d}"
+        if k in total:
+            lines.append(f"  +{d}日留存 {k}: {total[k] * 100:.2f}%")
+    return "\n".join(lines)
+
+
+def format_retention(data: list) -> str:
+    if not data:
+        return "无留存数据"
+    total = next((d for d in data if d.get("key") == "total"), data[0])
+    new = total.get("new", 0)
+    lines = [f"留存数据:", f"  新增用户 new: {new:,}"]
+    for d in [1, 7, 30]:
+        k = f"r{d}"
+        if k in total:
+            lines.append(f"  +{d}日留存 {k}: {total[k] * 100:.2f}%")
+    return "\n".join(lines)
+
+
+def format_source(data: list) -> str:
+    if not data:
+        return "无来源数据"
+    total = next((d for d in data if d.get("key") == "total"), None)
+    if total:
+        install = total.get("install", total.get("new", 0))
+        login = total.get("login", total.get("luu", 0))
+        rate = f"{login / install * 100:.2f}%" if install > 0 else "-"
+        return f"来源数据:\n  新增设备: {install:,}\n  转化(login): {login:,}\n  转化率: {rate}"
+    return json.dumps(data, ensure_ascii=False, indent=2)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="pn_mid_v2 远程数据查询")
+    parser.add_argument("pid", type=int, help="项目 ID")
+    parser.add_argument("dataType", choices=["pay", "activity", "retention", "source"], help="数据类型")
+    parser.add_argument("month", help="月份 YYYY-MM")
+    parser.add_argument("--appPlatform", type=int, default=0, help="0=全平台 1=iOS 2=Android (默认0)")
+    parser.add_argument("--group", type=int, default=None, help="分组类型，默认2(日期)，留存默认8(账号)")
+    parser.add_argument("--json", action="store_true", help="输出原始 JSON")
+    args = parser.parse_args()
+
+    if args.group is None:
+        args.group = 8 if args.dataType == "retention" else 2
+
+    try:
+        result = query(args.pid, args.dataType, args.month, args.appPlatform, args.group)
+    except Exception as e:
+        print(f"查询失败: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    if args.json:
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+        return
+
+    data = result if isinstance(result, list) else result.get("listData", result.get("list", []))
+
+    formatters = {
+        "pay": format_pay,
+        "activity": format_activity,
+        "retention": format_retention,
+        "source": format_source,
+    }
+    print(formatters[args.dataType](data))
+
+
+if __name__ == "__main__":
+    main()