etf-assistant

核心用法

ETF投资助理是一款面向A股及海外市场的指数基金辅助工具，通过命令行交互实现七大核心功能：ETF代码速查、实时行情查询、热门标的推荐、关键词搜索、双标对比分析、定投收益计算，以及主流ETF分类知识库。用户可通过简洁指令如etf-assistant price 510300快速获取沪深300ETF现价，或使用etf-assistant calc模拟长期定投回报，无需登录券商账户即可完成投前研究。

显著优点

数据获取零门槛：直接调用Yahoo Finance公开API，无需API Key或账户注册，降低使用摩擦。功能覆盖投资全周期：从入门代码查询、日常盯盘到策略回测，满足新手到进阶用户的分层需求。本土化适配精准：内置沪深300、创业板、科创50、纳指等10余只主流ETF映射，附带中文投资建议，贴合国内投资者认知习惯。风险提示完善：文档明确标注"投资有风险，入市需谨慎"及免责声明，合规意识到位。

潜在缺点与局限性

数据源单一依赖：行情数据完全依赖Yahoo Finance，若服务中断或延迟将直接影响功能可用性，且无备用数据源切换机制。计算模型简化：定投计算器基于假设收益率推算，未考虑手续费、滑点、分红再投资等真实成本，结果偏向乐观。缺乏深度分析：仅提供价格涨跌等基础行情，无估值分位、波动率、夏普比率等进阶指标，难以支撑复杂决策。交互形态受限：纯命令行界面，无可视化图表输出，对比分析结果以文本呈现，直观性不足。

适合的目标群体

指数基金新手：需要快速建立ETF代码认知、理解宽基与行业主题差异的入门投资者。定投策略执行者：希望测算不同周期、金额下复利效果，制定纪律性投资计划的长期持有者。轻量信息需求者：不愿打开臃肿券商App，仅需快速瞥一眼持仓价格的极简用户。教育场景使用者：财经课程讲师或自媒体，可借助标准化输出演示投资概念。

使用风险

数据时效风险：Yahoo Finance免费接口存在15-20分钟延迟，不适用于高频交易或紧急决策场景。模型误导风险：定投计算器的假设收益率若设置过高，可能夸大长期回报，导致用户预期偏差。功能边界风险：工具仅提供信息聚合，无交易执行能力，用户需自行跳转券商操作，存在决策与执行脱节的可能。维护可持续性：作为个人开发者社区项目，长期更新与Bug修复依赖所有者精力，存在功能停滞隐患。