Stock Data Assistant（股票数据统一助手）是一个整合历史数据查询、实时行情搜索和微信联动三大能力的统一 Skill。
一、用途 该 Skill 面向需要在微信中便捷获取股票数据的用户，将历史数据查询、实时行情推送与微信交互整合为一体，支持 A 股、港股、ETF 和指数等市场。
二、主要能力
- 历史数据查询：通过 MCP（streamable-http）协议，端口 8001，可查询 K 线、财务数据、指数、ETF 等。
- 实时行情推送：通过 WebSocket，端口 8765，支持 A 股、港股、ETF 逐笔行情，每 3~5 秒更新，支持涨停跌停、大幅波动、量能异动、价格突破等告警策略。
- 微信交互：通过 picoclaw WeChat Channel，将自然语言转换为 MCP 工具调用，用户可在微信中直接操作股票数据。
三、使用方式 一键启动：运行 bash skills/stock-data-assistant/start_wechat_bridge.sh，该命令会依次检查/下载 picoclaw、从 .env 读取 LLM 配置生成 picoclaw.yaml、启动 picoclaw（Gateway 端口 18790 与微信 Channel）、启动实时订阅（WebSocket 端口 8765）。 微信登录：运行 .local/bin/picoclaw auth weixin 显示二维码，扫码后即绑定，之后在微信中直接发消息即可操作股票数据。 手动分步操作： Step 1 安装 picoclaw：bash skills/stock-data-assistant/setup_picoclaw.sh（或指定版本，如 v0.2.5）。 Step 2 生成配置：python3 skills/stock-data-assistant/generate_picoclaw_config.py，可自定义参数如 --mcp-token、--output。 Step 3 启动 picoclaw：export PATH=".local/bin:$PATH" 后运行 picoclaw run --config .local/picoclaw.yaml。 Step 4 登录微信：picoclaw auth weixin。 管理命令：--status 查看状态、--stop 停止所有服务、--no-rt 仅启动不启用实时订阅、--symbols 指定订阅股票。
四、配置说明 LLM 配置自动从 .env 复用，读取 OPENAI_API_KEY（必填）、OPENAI_BASE_URL（默认 https://api.openai.com/v1）、OPENAI_MODEL（默认 gpt-4）。MCP Server 配置包括 STOCK_MCP_SERVER_URL（默认 http://localhost:8001/messages）和 STOCK_MCP_TOKEN。生成的配置文件结构见 references/picoclaw_config_example.yaml。
五、MCP 工具一览（通过微信可用） K 线数据：tushare_daily_get_daily_data（日 K 线 OHLCV）、tushare_daily_get_latest_daily（最新交易日数据）、akshare_hk_（港股日线数据）。 基本面：tushare_daily_basic_get_daily_basic（PE/PB/市值等指标）、tushare_balancesheet_（资产负债表）、tushare_income_（利润表）、tushare_cashflow_（现金流量表）。 指数与 ETF：tushare_index_（指数数据）、tushare_fund_（ETF 数据）。 市场：tushare_trade_cal_get_cal（交易日历）。 完整工具列表可通过 MCP tools/list 接口动态获取（约 76+ 个工具）。
六、适用场景 用户可在微信中通过自然语言查询股票数据，例如查询贵州茅台最近的日 K 线、查询腾讯控股当前价格、监控 00700.HK 涨跌超过 2% 就通知、列出今天涨幅最大的 10 只 A 股等。
七、限制与依赖 依赖 Python >= 3.9（用于配置生成和实时数据订阅）、picoclaw >= v0.2.5（由 setup_picoclaw.sh 自动安装）、stock_datasource MCP 服务（端口 8001，需先启动）、stock_datasource Backend（端口 6666，需先启动）。实时数据通过 skills/stock-rt-subscribe 提供，详细文档见 ../stock-rt-subscribe/SKILL.md。
八、故障排查 picoclaw 下载失败：检查网络/代理，或手动从 GitHub 下载放入 .local/bin/。 OPENAI_API_KEY not set：确保 .env 文件中有 OPENAI_API_KEY 字段。 API key required (MCP)：设置 STOCK_MCP_TOKEN 环境变量或编辑配置文件。 微信二维码过期：重新运行 picoclaw auth weixin。 实时数据无推送：检查 subscribe_client.py 是否正常运行，端口 8765 是否可达。 picoclaw 无法调用 MCP 工具：确认 MCP 服务 (8001) 正常运行且 token 有效。
九、目录结构 skills/stock-data-assistant/ 包含 SKILL.md、setup_picoclaw.sh、generate_picoclaw_config.py、start_wechat_bridge.sh 以及 references/picoclaw_config_example.yaml。