vermink

零依赖终端美化引擎：把纯文本主题编译成 Zsh / Bash / PowerShell 的提示符与状态栏。

安装

pip install vermink

快速开始

# 生成默认 dark 主题并安装到当前 shell
vermink init

# 预览主题效果（不修改任何文件）
vermink preview dark

# 列出所有主题
vermink list

子命令

主题文件

主题文件使用 INI 格式，包含以下区块：

## vermink theme mytheme

[palette]
user = bright_green
host = bright_cyan
dir = bright_blue
git = bright_magenta
git_state = yellow
venv = bright_green
time = grey
exit_code = red

[prompt]
user
host
dir
git
git_state

[status]
venv
time
exit_code

[format]
user = user
host = host
dir = dir
git = git
git_state = git_state
venv = venv
time = time
exit_code = exit_code

区块说明

• [palette]：定义颜色名称，支持命名色（如 red、bright_green）、256 色（如 208）、HEX 色（如 #ff8800）、修饰符（如 bold、dim）
• [prompt]：左侧提示符显示的片段列表
• [status]：状态栏显示的片段列表（Zsh 为 RPROMPT，Bash/Pwsh 合并到主提示符）
• [format]：将片段映射到配色名，设为 none 表示不着色

可用片段

内置主题

• dark：深色终端主题（默认）
• light：浅色终端主题

自定义主题

# 保存主题到配置目录
vermink init --theme dark --name mytheme --no-install

# 编辑主题
vim ~/.config/vermink/themes/mytheme.conf

# 安装自定义主题
vermink install mytheme --shell zsh

Shell 支持

开发

# 安装开发依赖
pip install -e ".[test]"

# 运行测试
pytest tests/

# 代码检查
ruff check .

许可证

MIT