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