\r \r

同花顺问财数据提取器\r

\r

环境配置\r

\r 使用前确认以下路径（可从用户记忆或直接询问）：\r \r | 配置项 | 默认值 |\r |--------|--------|\r | Python | C:\Users\JacobWu\AppData\Local\Programs\Python\Python312\python.exe |\r | agent-browser | C:\Users\JacobWu\AppData\Roaming\ pm\agent-browser.cmd |\r | Chrome CDP端口 | 9222 |\r | 数据库路径 | D:\workbuddyclaw\iwencai_zt.db |\r | 数据目录 | D:\workbuddyclaw\iwencai_data\ |\r \r 启动 Chrome 调试模式（用户须手动执行一次）：\r

chrome.exe --remote-debugging-port=9222 --user-data-dir=C:\ChromeDebug\r
```\r
然后在 Chrome 中手动导航到 `https://www.iwencai.com/unifiedwh/stockpicker/`（AI选股页面）。\r
\r
## 核心工作流\r
\r
### 单日 / 批量爬取\r
\r
使用 `scripts/crawl.py`，修改顶部配置后运行：\r
\r
```bash\r
# Windows PowerShell/cmd，用 cmd /c 规避编码问题\r
cmd /c python D:\workbuddyclaw\iwencai_data\crawl.py\r
```\r
\r
脚本关键参数（脚本顶部修改）：\r
- `TRADE_DAYS`：要爬取的日期列表（ISO格式 `YYYY-MM-DD`）\r
- `AGENT`：agent-browser 路径\r
- `DB_PATH`：SQLite 数据库路径\r
\r
### 导出 Excel 报告\r
\r
使用 `scripts/export_excel.py`，生成包含5个Sheet的汇总报告：\r
\r
```bash\r
cmd /c python D:\workbuddyclaw\iwencai_data\export_excel.py\r
```\r
\r
## 关键技术细节（必读）\r
\r
### agent-browser 调用规范\r
\r
```python\r
# 正确：不要加 --timeout 参数（子命令不支持，会报 Unknown command）\r
cmd = [AGENT, "--cdp", "9222"] + list(args)\r
\r
# eval 输出是双层 JSON 包裹，需双层解析\r
raw = ab("eval", js)\r
step1 = json.loads(raw)\r
result = json.loads(step1) if isinstance(step1, str) else step1\r
```\r
\r
### 搜索框定位\r
\r
snapshot 中搜索框类型为 `textbox`，带 "筛选条件" 提示文字：\r
```python\r
for line in snap.split('\
'):\r
    if 'textbox' in line.lower() and 'ref=' in line:\r
        if '筛选条件' in line or '请输入您的' in line:\r
            m = re.search(r'ref=(e\d+)', line)\r
            if m:\r
                search_ref = m.group(1)\r
                break\r
```\r
\r
### 分页翻页（Vue.js 兼容）\r
\r
普通 `click()` 无效，必须用 `dispatchEvent` 触发 Vue 响应式事件：\r
\r
```javascript\r
// 分页 class 是 .page-item（不是 .iw-asidetable-page-item）\r
var items = document.querySelectorAll('.page-item');\r
// 找到目标页码元素后：\r
var evt = new MouseEvent('click', {bubbles: true, cancelable: true, view: window});\r
a.dispatchEvent(evt);\r
```\r
\r
### Windows 编码\r
\r
所有 Python 脚本顶部加：\r
```python\r
import sys, io\r
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8', errors='replace')\r
sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8', errors='replace')\r
```\r
运行脚本用 `cmd /c python script.py`（不用 PowerShell 直接调用）。\r
\r
## 数据库结构\r
\r
表名：`zt_stocks`\r
\r
| 字段 | 类型 | 说明 |\r
|------|------|------|\r
| trade_date | TEXT | 交易日期 YYYY-MM-DD |\r
| stock_code | TEXT | 股票代码（6位） |\r
| stock_name | TEXT | 股票名称 |\r
| price | REAL | 收盘价 |\r
| change_pct | REAL | 涨跌幅(%) |\r
| zt_time | TEXT | 涨停时间 |\r
| zt_status | TEXT | 涨停状态 |\r
| volume | TEXT | 成交量 |\r
| amount | TEXT | 成交额 |\r
| first_zt_time | TEXT | 首次涨停时间 |\r
| lb_count | INTEGER | 连板数 |\r
| zt_type | TEXT | 涨停类型（首板/二连板等） |\r
| float_mv | TEXT | 流通市值 |\r
| vol_ratio | TEXT | 量比 |\r
| themes | TEXT | 所属题材（+分隔） |\r
| zt_tags | TEXT | 涨停标签 |\r
| total_mv | TEXT | 总市值 |\r
\r
## 参考文档\r
\r
- **爬取脚本完整实现**：见 `references/crawl_reference.md`\r
- **常见问题排查**：见 `references/troubleshooting.md`\r