花花日记助手 (HuahuaDaily)

1. 描述

花花日记助手让 AI 直接读取用户在花花日记 App 中的基金持仓数据，提供持仓收益查询、市场行情查看、基金搜索等功能。所有工具均需 Agent Token（花花日记 PRO 会员专属），数据来自云端同步。

交易操作（买入/卖出）不直接执行，AI 通过 request_transaction 发送信号，由用户在 App 中一键确认后生效。

2. 使用场景

• - 用户说：我今天收益多少？、帮我看一下我的持仓、我的总资产是多少？
• 用户说：易方达蓝筹现在涨了多少？、帮我查一下 110022 的净值
• 用户说：今天大盘怎么样？、沪深300涨跌如何？
• 用户说：帮我搜一下华夏基金、查一下这只基金的费率
• 用户说：帮我看看这只基金近一年排名、今天走势怎么样？
• 用户说：我想买 1000 元易方达消费、帮我发一个卖出请求
• 用户说：我的基金跑赢大盘了吗？、帮我对比一下沪深300
• 用户说：今天下午买入，什么时候确认份额？、T+2 是哪天？
• 用户说：中秋节后第一个交易日是哪天？、这个日期能买基金吗？

3. 使用方法

1. 1. 首次使用：确认 BAIYEAGENTTOKEN 已通过环境变量配置；若未配置，引导用户前往 https://huahuadaily.preview.aliyun-zeabur.cn/ 注册账号并开通 PRO 会员，在「设置 → Agent Token」生成后配置到环境变量；

1. 2. 查询总览：优先调用 getsummary，返回总资产、今日收益、累计收益；如需明细再调用 getrecords；返回结果中须将 dataUpdatedAt 同步时间告知用户（如数据同步于 XX 时间），让用户判断数据是否最新；

1. 3. 查询单只基金行情：

- 用户已提供代码（如查 110022）：直接调用 getitemestimate，无需先搜索； - 用户只给名称：先调用 searchitem 找到 code，再调 getitem_estimate； - 用户需要深度分析（历史、胜率、排名等）：调用 getitemdetail（较慢，仅需深度信息时使用）；

1. 4. 查询市场整体：调用 getoverview 或 getindices；

1. 5. 基准对比：

- 调用 getbenchmarkhistory(sh000300) 获取沪深300历史走势； - 结合 getitemhistory(code) 的持仓基金历史，对比两者涨跌幅； - 常用指数代码：sh000300（沪深300）、sh000001（上证）、sz399001（深证成指）；

1. 6. 买卖日期规划：

- 调用 getnexttrading_day(date) 确认某日是否为交易日及下一交易日； - 调用 calculatetradingdates(date, timemode, confirmdays) 推算净值日/确认日； - timemode：PREMARKET（收盘前买入）或 POST_MARKET（收盘后买入）； - confirm_days：T+1（货币/债基），T+2（股票/混合），T+3（QDII）；

1. 7. 发送交易信号：

- 若 code 来自搜索结果，须先向用户确认：「是【基金名 code:XXXXXX】吗？确认后我来发送请求。」 - 用户确认后再调用 request_transaction； - 调用完成后明确告知：「信号已发送，请打开 App 确认后才会生效，AI 不会直接执行交易。」

1. 6. 数据过时处理：若用户提到刚刚刷新或数据明显滞后，提示其在 App「设置 → 立即同步」手动上传后再查询；

1. 7. 结果复用：同一次对话中，一次查询结果可回答多个相关问题，不必重复调用同一工具。

4. 可用工具

认证

• - set_token — 运行时设置 Agent Token（推荐用环境变量，通常无需调用）

数据查询

• - searchitem(query) — 按编号/名称搜索，返回最多 20 条（仅 code 未知时使用）
• getitemestimate(codes) — 批量获取今日实时估算净值（最多 50 个）；日常查行情首选，轻量快速
• getitemdetail(code) — 基金深度信息（历史收益率、胜率分析、净值序列、费率）；仅需深度分析时使用
• getitemhistory(code) — 历史净值走势
• getitemdividends(code) — 历史派息记录
• getfundtimeline(code) — 今日分时估值走势（非交易日返回空）
• getfundfees(code) — 申购/赎回/管理/托管费率
• getfundperiodrank(code) — 近 1/3/6 月、1 年业绩及同类排名百分位
• getdailyrank() — 今日涨跌幅排行榜

概览数据

• - getstatus() — 今日是否交易日
• getoverview() — 市场整体概览（指数 + 板块 + 涨跌榜）
• getindices() — 主要指数实时数据（沪深、创业板、纳斯达克等）
• getbenchmarkhistory(code?) — 指数/ETF 历史走势，默认沪深300（sh000300），用于基准对比
• calculatetradingdates(date, timemode?, confirmdays?) — 推算 T+N 净值日/确认到账日
• getnexttradingday(date) — 获取指定日期起的下一个交易日（跳过周末和节假日）

记录管理（需 PRO 会员 + Agent Token）

• - getcurrentuser() — 当前账号信息
• getsummary() — 持仓总览摘要（总市值/今日收益/累计收益/收益率），含 dataUpdatedAt
• getrecords() — 完整持仓明细（holdings 持仓 + watchlist 观察列），含实时收益计算和 dataUpdatedAt
• requesttransaction(itemcode, itemname, recordtype, amount, date?, note?, group_name?) — 向 App 发送买入/卖出请求信号

5. 边界情况

• - 未配置 Token：工具返回错误提示，引导用户前往 https://huahuadaily.preview.aliyun-zeabur.cn/ 注册/登录，开通 PRO 会员后在「设置 → Agent Token」生成并配置到环境变量 BAIYEAGENTTOKEN；
• Token 无效/过期：收到 401 错误，引导用户前往 https://huahuadaily.preview.aliyun-zeabur.cn/ 在「设置 → Agent Token」重新生成，并更新环境变量；
• 数据过时（用户刚在 App 刷新）：提醒用户在 App「设置 → 立即同步」手动上传最新数据，否则 MCP 仍读取旧的云同步数据；
• 非交易日查询今日收益：todayProfit 为 0，属正常现象，说明今日未开市，显示的是官方净值下的持仓状态；
• 基金估算为空（盘前/节假日）：estimatedNav 为 null，todayProfit 为 0，属正常，无需报错；
• 搜索无结果：引导用户确认基金编号或名称是否正确；
• request_transaction 后：明确告知用户信号已发送，请打开 App 确认后才会记录交易，不要误导用户认为已成功执行。