dsh-pi-markdown

DeepSeek Harness (DSH) Web 端的终端风格 Markdown 渲染样式插件。

将高对比度、低疲劳度的经典终端 TUI 配色与等宽排版体验带入 DSH 网页端，彻底告别浏览器端大字号、刺眼白字与稀疏行距。

---

视觉设计与特性

1. 终端等宽阅读体验：
   • 全文采用紧凑舒适的行距与等宽字体排版，段落行距压缩至 1.5，标题外边距紧凑贴合，极大提升代码、配置与工程文档的扫读效率。
2. 层次分明的双模配色：
   • 深色模式：柔和炭黑背景搭配琥珀金标题（#f0c674）、薄荷青行内代码（#8abeb7）与软白正文（#c5c8c6），无刺眼反差。
   • 浅色模式：雅致暖白背景搭配深茶金标题（#9a7326）、墨绿行内代码（#2c635e）与炭灰正文（#1f2328），清晰护眼。
3. 第三方主题与暗色皮肤无缝自适应：
   • 内置智能亮度探测器（Luma Detector），自动监听并计算全局 --dsw-alias-label-primary 变量计算值。
   • 即使 DSH 官方外观处于 Light 模式，只要切换了第三方固定黑底皮肤（如 dsh-theme-center 的“深夜黑” skin-midnight、skin-forest 等），插件也能实时识别深底并强制切换至高对比度明亮文本，绝不出现黑底黑字的不可读情况。

---

字体需求与推荐（重要）

为获得最佳的排版与字符对齐效果，本插件配置了专属的字体族回退链。

1. 首选推荐字体

• 字体名称：Maple Mono NF CN（枫叶等宽字体 · 简体中文带 Nerd Font 符号版）
• 推荐理由：
  • 优秀的英文字符间距与圆体中文字符完美贴合，终端与代码视觉极为柔和；
  • 完整内嵌 Nerd Font 开发者符号与常用连字（Ligatures）；
  • 中英文宽度严格遵循等宽比例，表格与 ASCII 缩进排版绝不产生位移。

2. 字体族降级链

若系统中未安装 Maple Mono NF CN，插件将按照以下顺序依次自动降级使用系统中的高质量等宽字体：

font-family: "Maple Mono NF CN", "JetBrains Mono", "SF Mono", "Fira Code", Menlo, Monaco, Consolas, monospace !important;

3. 字体安装方式

• macOS (通过 Homebrew 快速安装)：

  brew tap subframe7536/maple-font
  brew install --cask font-maple-mono-nf-cn
  

• 手动下载安装 (GitHub Releases)： 前往 Maple Font 官方发布页 下载 MapleMono-NF-CN.zip，解压后双击安装所有 .ttf 文件即可。

---

安装与使用

步骤 1：部署插件

将本仓库克隆或复制至 DSH Web Profile 插件目录下：

# 拷贝至 DSH 插件目录
cp -r dsh-pi-markdown ~/.dsh/profiles/web/node_modules/

步骤 2：配置挂载 (cordis.patch.yml)

在 ~/.dsh/profiles/web/cordis.patch.yml 中追加本插件声明：

- insert:
    - id: pi-markdown
      name: 'dsh-pi-markdown'

步骤 3：重启服务

重启 DSH Web 进程（如使用 PM2 管理）：

pm2 restart dsh-web

刷新浏览器页面，即可享受纯粹优雅的终端级 Markdown 阅读体验！

---

开源协议

本项目采用 MIT License 协议。