写中文长文时的
阅读指标

主题真正值钱的不是皮肤，是这些硬约束

做主题最费时间的不是写 CSS，是一类不报错的失败——改了没变化、字体没上屏、配色凭直觉对不上参照。下面六条是我踩完坑以后钉死的产品决策。

真机截图，不是营销假图

验收样张开着，浅深各盯三分钟——headless 全绿不算数，最终要在 Typora 里肉眼看。

三项指标，决定你能不能盯几个小时

我调主题时几乎不先碰颜色——先把字号、行高、行宽钉死。颜色再漂亮，行距不对，中文长文也会像在扫弹幕。

中英混排：三级降级，不打包中文

Anthropic Sans 有 581 字符、CJK 0 个（连中文标点都没有）。正确做法是西文 + 系统中文配对。

和 Gallery「Claude Theme」差在哪

目标相近，但是独立实现，不是 fork。我对照过公开数字——最刺眼的是 !important 数量和字体包体积。

主题工程 Skill：clone 就能用

Skill 真源就在本仓库 skills/hekouwang-typora-theme/，不是另开 skill 仓。clone / 打开项目后，Claude Code / Cursor 能加载项目 skill 的 Agent 可直接用——无需再单独安装。

什么时候叫它：

最常用的三条命令（Agent 或你自己在仓库根跑）：

# 公开仓 → 仅免费 V2（hekouwang.css + dark）
$ python3 scripts/build.py
# 断言：零 !important · 除根字号外零 px · 纸感在位
# 付费肤需本机色板 + craft，或不走 build、直接 unlock.zip

$ ./scripts/install.sh
# 可选：--use-local-anthropic（默认关，仅个人本机）

$ python3 scripts/verify_render.py --css theme/hekouwang.css \
  --fonts "Hekouwang Sans,Hekouwang Sans Fb" \
  --vars bg-color,text-color
# 宽度 ≈ 不存在字体 → 说明你要的字体没上屏

六条铁律——全是静默失败

这些坑不报错，页面照常渲染。Skill 把它们写成工具约束；你自己改主题时也别跳过。

从参照截图采真实色值

做浅色时我笃定底色是品牌米色，采样后发现对话区才是纸色。深色更极端——靠「把浅色取反」一定会做错。

$ python3 scripts/sample_colors.py 参照截图.png
$ python3 scripts/sample_colors.py 图.png --box 700,640,1700,700 --label 正文背景
$ python3 scripts/sample_colors.py 图.png --text-box 690,300,1500,345 --label 正文文字

$ python3 scripts/sample_colors.py --solve-alpha 1f1f1e 272725 ffffff,d97757
✓ 白叠加 0.036/0.036/0.031 一致 · 品牌橙通道不一致 ❌

按需展开的四份说明书

Agent 读 Skill 后按任务打开对应 reference；你也可以自己点开。

skills/hekouwang-typora-theme/   ← Skill 真源（SKILL.md + references/）
.claude/skills/… · .cursor/skills/…  ← 软链，供工具发现
scripts/tokens.json      单一真相源
scripts/build.py         生成 CSS + 构建自检
scripts/install.sh       装进 Typora
scripts/sample_colors.py 截图采样
scripts/verify_render.py 字体 / 渲染探针
theme/                   成品 CSS + Inter
demo/                    验收样张

自己改：只动 tokens，再 build + install

# 编辑 scripts/tokens.json 后：
$ python3 scripts/build.py
$ ./scripts/install.sh
# 然后 Cmd+Q 完全退出 Typora 再重开

dark 段只覆盖 color / alpha；边框与浅底由 border_base / shadow_base 派生。别直接改 theme/*.css。

免费默认：Hekouwang / Dark（V2）

公开仓只装 Hekouwang 与 Hekouwang Dark（skill V2 编辑）。装完请 Cmd+Q 完全退出 再开。六套付费皮肤走下面 购买区，用 unlock.sh 装，不混进这条命令。

# clone & install · macOS
$ git clone https://github.com/huiyonghkw/hekouwang-typora-theme.git
$ cd hekouwang-typora-theme && ./scripts/install.sh
✓ Cmd+Q 退出再开 · 主题菜单选 Hekouwang / Hekouwang Dark

也可只拷 theme/hekouwang.css、theme/hekouwang-dark.css 和 theme/hekouwang/ 到 Typora 主题文件夹（Preferences → Open Theme Folder）。

怎么买六套皮肤

three steps · WeChat Pay or Alipay · 一年更新

免费＝一套写得久的阅读指标（V2，公开仓 MIT）。付费＝同一指标上的 skill 皮肤（科技 / 财经 / 玻璃 / 紫×青 / 焰彩紫橙粉等，各含 Dark；V2 与免费同文件），并多一层阅读工艺。色板与工艺源码不进公开仓，只随 zip 私发——clone 公开仓跑 build.py 只会出免费 V2。

01付款 · 二选一

微信支付 · ¥9.9

支付宝 · ¥9.9

02然后加我

扫码加我

或者直接搜微信号

hekouwang

把付款截图发我，备注「Typora主题」。我发 zip；装法见 本页「装付费包」。

付费包安装手册

收到 zip 后来这里 · 不用记命令

付费包只追加 Hekouwang V1 / V3–V6（各含 Dark，共 10 个 CSS）。免费的 Hekouwang / Hekouwang Dark（V2）仍走公开仓 Install。色板与工艺源码只在 zip 里，不会出现在公开 GitHub 树。

$ git clone https://github.com/huiyonghkw/hekouwang-typora-theme.git
$ cd hekouwang-typora-theme && ./scripts/install.sh