 |
 |
 |
 |
 |
 |
 |
 |
 |
一卷素缃，落于代码之上，如旧书颜色，浸入行间。
缣缃满篋，未忍轻开。
——《颜氏家训 · 勉学》
素缃，是一对从东方古籍美学中生长出来的 VSCode 颜色主题。
「素」者，未经染色之生绢也。
《礼记》云：「大夫素带辟垂。」素，是底色，是留白，是一切浓墨重彩尚未落下之前的安宁。
「缃」者，浅黄色之帛也。
《说文解字》释：「缃，帛浅黄色也。」它是古卷扉页的颜色，是岁月与光阴的落款——书卷经年，纸页泛黄，那层温润的缃色，便是时间写下的第一行注脚。
此主题无刺目之荧白，亦无深渊之漆墨。唯余岁月浸润后的温润纸色，沉淀经年的褪淡墨迹，郑重钤下的朱砂印红，以及如青碧玉般温润的翠色标题。仿佛在午后斜阳中，或烛灯摇影下，徐徐摊开一卷旧籍——所有的代码，都变得安静而有温度。
晨起推窗，素缃初展。
朝霞映纸，墨香盈室。
朱砂落印如关键字点睛，青碧入纹似函数名提纲。
暮色四合，烛影摇红。
古卷泛黄处，诗意暗流淌。
一行代码一行诗，意境悠然入夜长。
天地有大美而不言，四象有明法而不议。——化自《庄子 · 知北游》
此主题循中国传统「四象」之哲学，以四种古典意象构建色彩体系。素绢为底，墨迹为文，朱砂断句，青碧提纲——此乃书法之精神，亦是代码之美学。
| 四象 | 朝霞色值 | 暮色色值 | 意象解读 | 在主题中的角色 |
|---|---|---|---|---|
| 素绢 （宣纸底色） |
#F3EAD8#E6DCC4 |
#261F16#1F1912 |
如素绢铺展，似古卷泛黄 | 编辑器与侧边栏背景 |
| 墨迹 （文字前景） |
#423729#7A6D5E |
#D0C3AE#938A7A |
经年墨香，字迹如诗 | 前景文字与注释 |
| 朱砂 （关键字） |
#C54131#D96C4A |
#D95B4A#E3947C |
印章落款，郑重其事 | 关键字、数字、状态栏 |
| 青碧 （函数类型） |
#1F987C#439D88 |
#7DA494#9DBFAD |
青碧如玉，温润沉静 | 标题栏、函数、类型名 |
开卷有益，展素缃以养目。 安之若素，点朱砂而会心。
- 开启 VSCode，如展卷而读
- 点击侧栏 扩展 图标（
Ctrl+Shift+X） - 搜索 Su Xiang 或 素缃
- 点击 安装，静待墨干
- 按下
Ctrl+K Ctrl+T（Mac:Cmd+K Cmd+T），择 素缃 · 朝霞 或 素缃 · 暮色
或径往 VSCode Marketplace 寻得此卷，一索即得。
工欲善其事，必先利其器。 ——《论语 · 卫灵公》
为得最佳古典体验，建议于 settings.json 中添此数行：
{
"editor.fontFamily": "'LXGW WenKai Mono', 'Maple Mono NF CN'",
"editor.fontSize": 15,
"editor.lineHeight": 1.6,
"editor.renderWhitespace": "selection",
"editor.bracketPairColorization.enabled": true,
"editor.guides.bracketPairs": true,
}✨ 特别推荐：霞鹜文楷 (LXGW WenKai) - 一款基于 Klee One 的开源中文字体，融合楷体与仿宋之美，温润优雅，与素缃主题意境相得益彰。可从 GitHub 发布页 下载安装。
素缃一卷，兼容万言。 无论何种语言，皆可入诗入画。。
此主题基于标准 TextMate 语义着色，万语千言皆能诗意呈现。特别适配之语言包括：
前端三绝：JavaScript · TypeScript · HTML/CSS 后端雅言：Python · Java · C# · Go · Rust 数据之语：SQL · JSON · Markdown 系统之音：C/C++ · Shell
🎨 无论何种编程语言，披素缃之衣，皆能如诗如画，意境悠远。
独学而无友，则孤陋而寡闻。——《礼记 · 学记》
若欲深究此卷、细品墨色，可本地研习：
# 克隆此卷
git clone https://github.com/mosaulse/suxiang-theme.git
cd suxiang-theme
# 安装文房四宝（依赖工具）
npm install
# 开启 VSCode，按 F5 启动研习窗口
code .
# 打包成卷，以待流传
npx vsce package奇文共欣赏，疑义相与析。——陶渊明《移居二首》
此「素缃」主题，源于对「泛黄纸张与朱砂印章」的诗意想象。若觉某段语法高亮可更贴切，或欲增语言之精细支持，欢迎：
- 提交 Issue，述君之思
- 直接 Fork 此卷，提交 Pull Request，在
tokenColors中添新作用域
🎨 颜色亦是文字，期待君为此卷素缃，染上新彩。
素缃卷末，记其微变与新章。以下为近卷要事。
青碧入卷 · 四象焕新
- 四象之「青花」易为「青碧」，靛蓝转翠，如青玉温润沉静
- 浅色主题青花瓷蓝由
#2E5F88/#43769C焕为碧玉翠绿#1F987C/#439D88 - 深色主题靛蓝由
#143252/#6FA6C9易为翠青#7DA494/#9DBFAD - 全面更新函数、类型、标题栏等青系配色，意境由清冷转温润
- README 四象配色表同步焕新，青碧一章重书
墨韵微调 · 语义高亮与活动栏
- 调整语义高亮风格：class、interface、type、keyword 改为斜体，comment 恢复正体，各归其位
- 活动栏底色与侧边栏统一，深浅两卷浑然一体
- 新增
git.blame.editorDecorationForeground，溯源批注如朱砂小印
主题微调与结构增强
- 同步并新增
themes/base.json，将公共配色抽出以便复用，如立范本而后临帖 - 优化并微调
themes/suxiang-light.json与themes/suxiang-dark.json的若干配色与 UI 元素 - 更新
.vscodeignore，并添加本地脚本以简化打包、测试流程
意境精进
- 新增 semanticTokenColors 完整配置，支持现代编程语言之语义高亮
- 优化 namespace、class、interface、enum 等类型之高亮显示，层次井然
- 添加 function、method、macro 之独立配色，方法调用愈加醒目
- 完善 variable、parameter、property 之颜色区分，代码结构更分明
- 优化正则表达式、Markdown、CSS 等语法高亮，细节入微
意境升华
- 重新审视四象配色哲学，素绢、墨迹、朱砂、青花更加和谐统一
- 优化浅色主题素绢底色，温润如初雪宣纸
- 调整深色主题墨色层次，营造更深沉之古卷氛围
- 精进语法高亮，字符串、注释、变量等语义区分更加清晰
- 打磨 UI 细节，活动栏、侧边栏等视觉表现更完善
意境优化
- 优化编辑器选中背景色与高亮颜色，视觉效果更佳
- 调整标题栏配色方案，添加边框区分层次
- 新增调试状态栏配色，调试状态更清晰
- 新增无文件夹状态栏配色，界面状态分明
- 统一深浅主题配色体系，视觉体验更和谐
详见 CHANGELOG.md
MIT License © Mosaulse
素缃一卷，墨香千年。
代码如诗，意境悠然。
愿君于代码天地间，常有一纸素缃相伴。
诗词典故引用：
- 《诗经》「素衣朱襮」——素之为美，质朴无华
- 《楚辞》「缃绮为下裙」——缃之为色，温润如帛
- 《说文解字》「缃，帛浅黄色也」——字源考据，色正其名
- 《颜氏家训》「缣缃满篋」——书卷之美，古已有之
- 《庄子》「天地有大美而不言」——四象无言，自成章法
- 《论语》「工欲善其事，必先利其器」——善其器者，方成其事
- 《礼记》「独学而无友，则孤陋而寡闻」——同好共赏，不亦乐乎
- 陶渊明「奇文共欣赏，疑义相与析」——以文会友，其乐融融
- 中国古典美学意象与书法精神