企业官网建设流程全解析

定制你的tstock图表：涨跌颜色、图表尺寸与终端自适应选项全解析

【免费下载链接】tstock📈A command line tool to view stock charts in the terminal.项目地址: https://gitcode.com/gh_mirrors/ts/tstock

tstock 是一款在终端里直接生成股票 K 线图表的命令行工具。本文将带你玩转 tstock 图表定制：自由切换涨跌K线颜色、精确调整图表尺寸，并搞懂它如何自适应你的终端窗口。无需浏览器、无需图形界面，一条命令即可拥有一张专业股票图表 📈

tstock 是什么：终端股票图表神器

tstock 的核心功能只有一个，但做得非常纯粹——在终端中画出蜡烛图（Candlestick Chart）。它支持全球主要交易所的股票、主流加密货币和外汇汇率，覆盖从 1 分钟到月线的多种时间区间。

上手只需两步：

pip install tstock # 安装 tstock export ALPHAVANTAGE_API_KEY=<你的密钥> # 设置免费的 AlphaVantage API Key

然后在终端输入tstock aapl，一张三个月的 K 线图立刻出现在屏幕上。项目安装方式与完整参数说明可见 README.md。

30秒上手：生成你的第一张自定义图表

在了解每个选项之前，先记住 tstock 图表由三要素决定：K 线数量（横向）、图表高度（纵向）、K 线颜色（视觉）。下面三节逐一拆解，对应的参数定义都在 tstock/parse.py 中。

自定义涨跌颜色：--upcolor 与 --downcolor 设置方法

tstock 默认使用"涨绿跌红"（美股惯例）：上涨K线为绿色，下跌K线为红色。如果你习惯 A 股的红涨绿跌，或者觉得红绿刺眼，可以直接换色。

红涨绿跌：一键切换 A 股配色

tstock aapl --upcolor red --downcolor green

参数传入后，tstock 会先校验颜色值是否合法，非法值会直接报错退出，校验逻辑位于 tstock/parse.py；绘制时每一根K线所在列会被赋予对应的 ANSI 颜色码，涨/跌判断与上色过程在 tstock/core.py 中完成。

护眼模式：关闭全部颜色

在日志场景、截图分享或不支持 ANSI 转义的终端（如 Windows 默认 cmd）中，加上--nocolor即可输出纯黑白图表，参数定义见 tstock/parse.py。

💡 小技巧：颜色只作用于K线主体与影线，边框和坐标轴始终为默认色，因此换色不会破坏图表结构。

调整图表尺寸：-y、-b 与边距参数详解

tstock 图表的"宽高比"由四个参数控制，全部在命令行即可调整，无需打开任何配置文件。

图表高度与K线数量（-y 与 -b）

tstock aapl -b 24 -t 60min # 最近24根60分钟K线 tstock aapl -y 20 # 图表高度固定为20行

-b决定横向能看到多少根K线，-y决定纵向能展开多少价格刻度。两者组合使用，就能在任何窗口下精确控制图表的"分辨率"。参数定义分别位于 tstock/parse.py 与 tstock/parse.py。

边距微调（--padx 与 --pady）

K线与图表边框之间默认留有一圈空白，方便价格标签和坐标刻度排布：

• --padx COLUMNS：水平边距，默认 5 列
• --pady LINES：垂直边距，默认 4 行

tstock aapl --padx 2 --pady 2 # 压缩边距，小窗口更省空间

当你手动指定了图表尺寸却觉得K线"顶到边框"或"太空旷"时，调整这两个参数即可。边距参与横向尺寸计算（max_x = K线数 + padx*2 + 2），相关绘制逻辑在 tstock/core.py。

终端自适应：tstock 如何自动填充你的终端窗口

tstock 最贴心的设计是：默认情况下你什么都不用调，图表会自动填满当前终端。

它的工作原理在 tstock/parse.py 中：

1. 调用os.get_terminal_size()获取当前终端的列数（columns）与行数（lines）；
2. 若未指定-b，K 线数量 = 终端列数 − 水平边距×2 − 15（为日期标签预留空间）；
3. 若未指定-y，图表高度 = 终端行数 − 6（若开启-w智慧语录模式再减 1 行）；
4. 若在重定向输出等无法获取终端尺寸的场景下失败，则回退到 70 根K线 × 40 行的默认尺寸，保证命令永远可用。

想亲眼看看自适应过程？加一个-v即可，tstock 会打印Automatically resizing x to fit...之类的调试信息，便于新手确认图表确实按你的窗口做了缩放。

实战组合：常用 tstock 图表定制命令清单

以上所有参数的完整说明也可以随时用tstock --help查看，示例片段同样收录在 tstock/settings.py。

常见问题 FAQ

Q：改了颜色没有效果？确认你的终端支持 ANSI 颜色码。Windows 下建议使用 Windows Terminal 等支持转义序列的终端。

Q：图表超出窗口被截断了？说明你手动指定的-b/-y超过了终端容量。去掉这两个参数让它自动填充，或调小数值。

Q：--upcolor 能填 hex 色值吗？不行，tstock 只内置 green / red / blue 三种 ANSI 颜色，输入其他值会报错退出，见校验代码 tstock/parse.py。

总结

• 涨跌颜色：--upcolor/--downcolor三选一换色，--nocolor一键去色；
• 图表尺寸：-b管横向K线数，-y管纵向高度，--padx/--pady微调呼吸感；
• 终端自适应：全部留空时，tstock 自动读取终端尺寸并填满窗口，拿不到尺寸时安全回退。

三个维度组合起来，tstock 就能在任何屏幕、任何配色习惯下输出最顺眼的终端股票图表。快去试试你的第一张红涨绿跌图吧 🚀

【免费下载链接】tstock📈A command line tool to view stock charts in the terminal.项目地址: https://gitcode.com/gh_mirrors/ts/tstock