dsh-code-pill

[!NOTE] 本页为 0.3.0 版本文档。 设置页、六套预设、字体 Tab 和自定义选项见 0.3.0 更新记录。main 与 npm 已发布包不自动等同；实际发布状态以 npm 与 GitHub Releases 为准。推送 main 只构建验证包，不会自动发布 npm。

不必把对话变成编辑器

短标识符需要的是清楚的引用感，文件名需要的是定位线索，真正的表达式才需要语法颜色。Code Pill 把这三件事分开：

阅读动作	Code Pill 如何处理
扫过一段回复	轻薄底色、无边框胶囊，让代码区别于正文，又不过度抢眼
找到某个文件	语言缩写或单色小图标；不为普通表达式贴文件标记
细读一段代码	关键字、字符串、数字与注释分色；路径和术语保持统一颜色
调整阅读习惯	深浅独立色板、字号和间距；先预览，满意后再保存

六套色板，两种主题

不是给同一张图加滤镜。每套都有独立的浅色与深色配色；预设只是起点，每个颜色都能继续调整。

_{展示图由当前客户端 bundle 在隔离 Chromium 页面中真实渲染，并读取源码中的预设；不是生产 DSH 整页截图。}

文件标记，想留多少就留多少

关闭、语言文字、小图标、图标＋文字。图标继承当前文字颜色，不加载外部资源；文件标记不会扩散到普通表达式。

调到舒服，再应用

在 设置 → Code Pill 中使用两个 Tab：代码外观 与 字体。

代码外观：

• 颜色：分别调整深浅主题的六个文字角色、胶囊底色和徽章颜色。
• 排版：字号比例、圆角、水平内边距、底色强度。
• 显示：行内语法着色、文件标记，以及保留宿主／使用当前色板的代码块配色。
• 管理：保存并应用、取消草稿、恢复默认、JSON 导入导出。

代码外观草稿不改变聊天。 字体 Tab 保留 Font Lab 的即时应用模式，支持全局／等宽字体、界面缩放、会话字号、逐部位覆盖、自定义选择器和 CSS 导出。首次读取原 Font Lab 的本浏览器配置，之后独立保存，不修改原插件配置。

设置仅保存到当前浏览器、当前网站地址，不上传、不跨设备自动同步；同源窗口会同步已保存的设置。字体只引用本机字体，不下载或分发字体文件；「本机字体…」需用户主动点击并授权。合并版本启用前建议停用原 Font Lab，避免两个插件同时覆盖字体；本次源码合并不自动停用或卸载原插件。自定义低对比度配色会提醒，但不禁止保存。

详细操作、默认值和存储范围见 设置指南。

开始使用

安装已发布版本

在 DSH 插件页填写 dsh-code-pill，或使用实际 Profile 名称执行：

dsh plugin --profile <profile> add dsh-code-pill

更新已安装版本：

dsh plugin --profile <profile> update dsh-code-pill@latest

按部署方式重新打开／重载 DSH，让新客户端模块被加载。这些命令安装 npm 已发布包；本文功能从 0.3.0 起提供，请核对安装版本。

试用当前 main

在 CI 构建记录 中选择成功的 main 构建，下载 verified-package artifact 并解压。使用其中的 dsh-code-pill.tgz，不要把 GitHub 源码 ZIP 当作插件包。

首次安装与已有插件更新分别使用：

dsh plugin --profile <profile> add <tarball 的绝对路径>
dsh plugin --profile <profile> update dsh-code-pill@file:<tarball 的绝对路径>

路径含空格时整体加引号。构建包仍可能保留当前版本字段；它不等于对应版本已经正式发布。

克制，也包括权限

不接外部服务，不读账户凭据，不访问主机文件系统，不替换 React 管理的消息子节点。 插件装饰合格的行内代码、注册 CSS Highlight、注入用户选择的字体／字号／缩放 CSS，并读写浏览器配置；可按需通过浏览器授权读取本机字体族名称，不读取字体文件内容。

默认保留宿主代码块配色。内置预设按白色与 #1e1e1e 背景、合成胶囊背景和徽章背景审计，文字对比度达到 4.5:1；这不是对所有宿主主题和自定义颜色的保证。

真实 Chrome 渲染、React 设置交互、Cordis 加载与卸载已有测试证据。验证分层：行内渲染在 Core 0.2.1-alpha.1 有历史集成验证；当前 Core 0.2.1-alpha.2 已在桌面 Profile 以本地未发布包、经独立 Chrome 连接真实宿主，完成设置入口、草稿隔离、保存与刷新恢复、文件图标和 41 个真实聊天 code 子节点身份保持的现场验证；生产 Electron 窗口本身尚未直接操作，其他 Core 与浏览器保持未知。本地验收和 main 源码推送均不等于正式发布，不代表 npm 0.2.0 已包含这些功能。宿主需提供设置 slot、React 和 UI primitives；能力不足时保留聊天渲染、按能力降级。完整范围见 兼容性与权限边界。

进一步了解

文档	内容
设置指南	预设、颜色、开关、导入导出与常见问题
设计说明	零子节点侵入、增量 Highlight、色板与草稿隔离
开发与验证	模块结构、测试、构建、打包与发布边界
兼容性	实测证据、降级、浏览器存储与未覆盖场景
更新记录	已发布版本与 Unreleased 改动

首页插图可通过 node scripts/render-doc-assets.mjs 从当前 bundle 重建，详见 展示资源说明。

---

MIT License · 报告问题 · GitHub Releases