Hugging Face's logo

Spaces:
BinbomJared
/
DM-Agent
Runtime error

App Files Community
DM-Agent
File size: 4,202 Bytes
c2f8dfe
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
# DM Analysis Agent — 新电脑开发环境搭建指南

## 前提条件

- 已安装 Python 3.12+
- 已安装 Git
- 有 GitHub 账号并能访问 `Binbom-Jared/DM-Agent` 仓库

---

## 第 1 步：克隆代码

```bash
git clone https://github.com/Binbom-Jared/DM-Agent.git
cd DM-Agent
pip install -r requirements.txt
```

---

## 第 2 步：复制密钥文件

从已有的开发电脑上拿到以下两个文件，放到项目根目录：

| 文件 | 作用 | 如何获取 |
|------|------|---------|
| `.env` | 所有 API 密钥、Token、钉钉 Webhook | 从已有电脑的项目根目录复制 |
| `credentials.json` | Google Sheets 服务账号密钥 | 从已有电脑的项目根目录复制 |

> **安全提醒**：这两个文件包含敏感信息，不要上传到 GitHub 或发到公开渠道。通过 U 盘或加密传输方式拷贝。

---

## 第 3 步：启动项目

### Web 界面（推荐）

```bash
python src/main.py --web
```

浏览器打开 `http://localhost:5000` 即可使用。

### 其他启动方式

```bash
# 交互模式
python src/main.py --chat

# 预览报告（不推送）
python src/main.py --dry-run
```

---

## 日常开发流程

### 开始工作前：拉取最新代码

```bash
git pull origin main
```

### 改完代码后：推送到 GitHub

```bash
git add -A
git commit -m "你的改动说明"
git push origin main
```

推送到 GitHub 后会自动触发 Hugging Face 部署。

---

## 项目结构

```text
DM-Analysis-Agent/
├── .github/workflows/deploy-hf.yml   # GitHub Actions → HF 自动部署
├── api/index.py                      # Vercel 入口
├── docs/                             # 架构文档
├── src/
│   ├── web.py                        # Flask Web 服务 + API 路由
│   ├── loader.py                     # 数据加载（Sheets / Excel / CSV）
│   ├── monitor.py                    # 日常监控引擎
│   ├── budget.py                     # 预算追踪
│   ├── analyzer.py                   # 数据分析引擎
│   ├── ai_analyzer.py                # AI 分析（GPT-4o-mini）
│   ├── meta_api.py                   # Meta Ads API
│   ├── google_api.py                 # Google Ads API
│   ├── criteo_api.py                 # Criteo API
│   ├── bing_api.py                   # Bing Ads API
│   ├── dingtalk.py                   # 钉钉推送
│   ├── memory.py                     # AI 记忆系统
│   ├── parser.py                     # 自然语言解析
│   └── formatter.py                  # 报告格式化
├── templates/index.html              # Web 前端
├── tests/                            # 测试
├── config.yaml                       # 配置文件
├── Dockerfile                        # Docker 部署
├── requirements.txt                  # Python 依赖
├── .env                              # 密钥（不入 Git）
└── credentials.json                  # Google 服务账号（不入 Git）
```

---

## 数据源

| 来源 | 说明 | 数据位置 |
|------|------|---------|
| Google Sheets | 主数据源，手动维护 + API 回写 | 云端 |
| Meta Ads API | Campaign 级日度数据 | API 实时拉取 → 本地 CSV 缓存 |
| Google Ads API | Campaign 级日度数据 | API 实时拉取 → 本地 CSV 缓存 |
| Criteo API | Campaign 级日度数据 | API 实时拉取 → 本地 CSV 缓存 |
| Bing API | Campaign 级日度数据 | API 实时拉取 → 本地 CSV 缓存 |

本地 CSV 只是缓存，删掉可以重新拉取，不影响系统运行。

---

## 常见问题

### Q: Google API 报 `invalid_grant`
A: OAuth refresh token 过期了，需要重新授权。参考 Google Ads API 文档刷新 token，更新 `.env` 中的 `GOOGLE_ADS_REFRESH_TOKEN`。

### Q: Bing API 报 `未配置 BING_ACCOUNT_IDS`
A: 在 `.env` 中添加 `BING_ACCOUNT_IDS=account_id:country`（如 `123456:US,789012:CA`）。

### Q: Hugging Face 没有更新
A: 确认 GitHub Actions 是否触发成功。到 GitHub 仓库的 Actions 页面查看。如果 `HF_TOKEN` 过期，需要在 GitHub Settings → Secrets 中更新。