核心功能概述
花花日记助手（HuahuaDaily MCP）是专为基金投资者设计的云端数据桥接工具，通过标准化接口将花花日记 App 的云端同步能力开放给 AI Agent。该技能采用只读优先、写入需确认的安全架构，在保护用户资产数据的同时，提供完整的持仓管理、行情分析、智能导入和社区互动能力。
显著优势
数据安全边界清晰：严格区分读取与写入权限。Agent 可查询总市值、今日收益、累计收益率、持仓明细、交易流水等敏感数据，但所有买入、卖出、持仓导入、自选导入等操作必须通过 request_transaction 或 request_import_review 发送至 App 确认页，由用户最终点击确认后才生效。这种设计有效防止了误操作和未经授权的资金变动。
多维度行情覆盖：支持 A 股基金实时估算（get_item_estimate）、历史走势（get_item_history）、费率结构（get_fund_fees）、阶段排名（get_fund_period_rank）、分红记录（get_item_dividends）等深度分析工具。特别针对 QDII 基金提供夜盘实时估值穿透（get_night_estimate），可拆解美股持仓的个股涨跌、汇率变动和贡献度，满足全球化资产配置需求。
智能截图识别工作流：支持持仓截图、自选截图、交易记录截图的三类 AI 识别。持仓截图通过基金名称模糊匹配，自选截图利用 6 位代码精确识别，交易记录截图自动解析买卖方向、金额、份额、日期等字段。识别结果通过轻确认机制处理歧义后，批量推送至 App 确认页，大幅降低手动录入成本。
市场全景数据：提供主要指数实时行情（get_indices）、市场概览（get_overview）、涨跌排行榜（get_daily_rank）、交易日历计算（get_next_trading_day、calculate_trading_dates）及与沪深300等基准的对比分析（get_benchmark_history），支撑完整的投资决策信息流。
潜在局限性与风险
会员功能受限：QDII 夜盘估值（get_night_estimate）、部分深度排名数据需 VIP 或 PRO 会员权限。非会员调用将收到 403 权限不足响应，需引导用户检查会员状态。
行情数据时效性：实时估算数据存在 60 秒缓存，非交易日、盘前时段或数据源维护时可能返回空值。云端同步数据依赖用户最近一次 App 手动同步，若 dataUpdatedAt 时间过久，实际持仓可能与云端快照不一致。
截图识别精度：持仓截图因不显示基金代码，依赖名称匹配可能出现模糊识别；交易记录截图的日期、金额字段若模糊或截断，需人工轻确认。建议用户上传清晰完整截图，复杂表格分批处理。
认证与网络依赖：需配置 HUAHUA_AGENT_TOKEN 环境变量，Token 过期或无效时需引导用户在 App 重新生成。所有操作依赖花花日记云服务可用性，无离线模式。
适用人群
- 活跃基金投资者：需要快速查询多账户持仓汇总、实时收益、历史调仓记录的深度用户。
- 定投/波段交易者：依赖截图快速导入券商 App 交易记录，避免手动录入繁琐操作。
- QDII/全球化配置者：需要夜间追踪美股持仓穿透、汇率波动影响的专业投资者。
- 收益分析爱好者：希望对比沪深300等基准、计算阶段排名胜率的数据驱动型用户。
常规风险提示
- 非实时交易执行：Agent 发送的交易请求仅为"待确认"状态，不构成成交承诺，市场波动可能导致实际成交价格与请求时估算净值存在偏差。
- 数据同步延迟：云端持仓不代表实时券商持仓，大额申赎、分红再投资等可能存在到账时间差。
- 截图隐私：上传截图包含持仓金额、交易记录等敏感信息，虽经加密传输，但仍建议避免在公共网络环境使用。
- AI 识别误差：截图识别的基金匹配、金额解析存在小概率错误，务必在 App 确认页仔细核对后再提交。