核心功能
tvscreener 是一款面向股票市场的技术数据查询工具，基于 TradingView 的筛选器接口开发，主要服务于港股（HK）、A股（CHINA）、A股ETF及美股（AMERICA）市场。该工具提供两大核心能力：一是单只股票的技术指标快照查询，二是基于字段和过滤条件的自定义市场筛选。
显著优点
1. 覆盖主流市场：原生支持港股、A股、美股三大市场，特别针对中国投资者常用的标的进行了优化
2. 技术指标全面：内置20+核心技术指标，包括价格、涨跌幅、成交量、RSI、MACD三重线、多周期均线（SMA/EMA 20/50/200）、布林带、随机指标（KDJ）、ATR及综合均线评级
3. 灵活的时间周期：支持通过 FIELD|60、FIELD|240 语法获取不同周期的指标值（1小时、4小时等）
4. 脚本化工作流：提供开箱即用的 Bash 和 Python 脚本，降低使用门槛
5. 字段自发现：内置字段搜索工具，便于探索可用的技术指标
潜在局限与风险
1. 版本兼容性问题：带周期语法的字段（FIELD|60）在某些 tvscreener 版本中可能触发 FieldWithInterval 属性错误，需降级到无周期查询或换用单股查询脚本
2. 环境依赖严格：要求 Python 3.10+，多 Python 环境易导致 ImportError 导入错误
3. Shell 转义陷阱：| 字符在 Bash/Zsh 中易被解析为管道符号，必须严格使用单引号包裹参数
4. 数据源限制：底层依赖 TradingView 的公开接口，未明确服务等级协议（SLA），存在稳定性风险
5. 非官方集成：由社区开发者 deepentropy 维护，非 TradingView 官方出品
适合人群
- 量化研究员和个人投资者，需要程序化获取多市场技术数据
- 已有 Python 基础、熟悉命令行操作的技术型用户
- 需要批量筛选股票、构建自定义监控列表的策略开发者
常规风险提示
该工具涉及金融数据查询，建议仅用于研究分析，不直接作为交易决策依据。由于数据源为第三方非官方接口，存在接口变更或限流风险，生产环境使用时应做好容错和降级方案。