dsh-happy-reader 0.2.6 → 0.3.0

package/README.md

@@ -6,9 +6,18 @@
 把对话界面调成适合长时间阅读的样子。**与官方设置协同，不冲突**——所有调整都与官方
 机制同键同步或主动避让，不修改任何官方文件，卸载后应用完全回到原样。
 
-入口：窗口内一枚可拖动的 **Aa** 圆钮，点开面板即可调；点面板外任意处或 × 收起面板。
+入口：窗口内一枚可拖动的 **Aa** 圆钮，点开面板即可调；点面板外任意处、按 Esc 或 × 收起面板。
 所有开关与选择自动保存，下次打开应用保持原样。面板本身也可随意摆放：**任意空白处
 拖动位置、拉上缘或下缘调整高度**，位置和高度都会记住——**双击标题栏**一键复位。
+字体设置收在三个可折叠卡片（**正文字体 / 代码字体 / 终端字体**）里，组头显示
+当前字号与字体摘要。打开面板先看到这三行，默认全部收起；点哪行展开哪行，展开状态会记住。
+
+**实现形态遵循官方插件规范（v0.3.0 起）**：界面通过官方 `shell.overlay` 槽位以 React
+组件挂载、不直接改写页面结构；取色只用官方主题变量（自动跟随明暗与品牌色）；文案走
+官方语言服务（随界面语言切换中/英）；开关采用官方无障碍规范（`role="switch"`，
+键盘与读屏可用）；正文字体的中/西两行也注册进官方「通用设置」页（`settings.general.item`），
+两处入口共用同一份设置；不修改任何官方文件。与官方叠加层共存：右键菜单、提示条
+始终显示在插件之上；Esc 在官方对话框/菜单里让位，在插件自己的输入框里只取消输入。
 
 ## 功能详解
 
@@ -25,22 +34,35 @@
   嵌入页（顶部唯一的"返回"按钮）、弹出对话框——这些页面的头部一律不受影响
 
 ### 3. 字号 10–40px
-面板里 −／＋ 步进调节，突破官方 22px 的调整上限：
+在「正文字体」组里展开调，−／＋ 步进，突破官方 22px 的调整上限：
 - **10–22px 段：与官方设置双向直连**——在插件里调，官方设置跟着变；
   在官方设置里调，插件显示也跟着变，两边永远一致
 - **23–40px 段：由缩放层补足**——超出官方上限的部分照样能放大，
   此时官方设置保持原样不动
-- 随时调回 22px 以内即交还官方
-
-### 4. 字体选择（只列出本机已装字体）
-三个下拉：**正文·中文 / 正文·西文 / 代码字体**。
-- 下拉里只出现你电脑上真实安装了的字体（逐字体实测检测）；没装的不会出现，
-  换电脑后以新电脑上有的字体为准
-- **中英分设**：中文字体只作用于汉字与中文标点，西文字体只作用于字母、数字与
-  西文标点——两者同时生效、互不干扰（例：中文用宋体、西文用 Times New Roman）
-- 有真粗体面的字体自动以真粗体排版
-- 代码字体作用于消息里的行内代码与代码块
-- 三处都选"默认（官方）"时插件完全退出，与官方原样一致
+- **代码字号（10–16px）**：在「代码字体」组里，DSH 0.2.2+ 官方角色字号，
+  与官方设置**双向同步**（代码块、行内码与工具输出一起变）
+- **终端字号（10–20px）**：在「终端字体」组里，官方角色字号，作用于侧栏终端
+- 启动时以官方值为准，不会用插件上次的旧值覆盖官方设置
+- 随时调回官方范围内即交还官方
+
+### 4. 字体选择（正文字体 / 代码字体 / 终端字体）
+面板把字体设置收成三个可折叠卡片，组头显示当前字号与字体摘要，点击展开/收起；
+默认三行收起，点哪行展开哪行；展开状态自动记住。所有条目都是官方角色设置的镜像，可写自定义字体列表。
+- **正文字体（组）**：
+  - 官方正文字体：官方「正文字体」的基础字族，可直接编辑（逗号分隔多个，
+    或从下拉里挑本机已装字体）；中英分设优先，未覆盖的字符回落到这里
+  - 中英分设：中文只作用于汉字与中文标点，西文只作用于字母、数字与西文标点——
+    两者同时生效、互不干扰（例：中文用宋体、西文用 Times New Roman）；有真粗体面的
+    字体自动以真粗体排版
+  - 该组的两行也出现在 **设置 → 通用设置 → 字号大小** 下方（v0.3.0 起），两处入口
+    操作同一份设置、双向同步
+- **代码字体（组）**：字体 + 字号，写入官方「代码字体 / 代码字号」角色设置；
+  下拉只列本机已装字体，选「自定义…」可填官方同款的逗号列表
+- **终端字体（组）**：字体 + 字号，写入官方「终端字体 / 终端字号」角色设置，
+  作用于侧栏终端；同样支持自定义列表
+- 下拉里只出现你电脑上真实安装了的字体（逐字体实测检测）；没装的不会出现
+- 官方值为多字体列表或不在候选表时，显示「当前：…」，不会被误报成"默认"
+- 全部选"默认（官方）"时插件完全退出，与官方原样一致
 
 ### 5. 内容宽度
 一条滑块 + "自动"按钮，官方范围内外都能调：
@@ -75,6 +97,9 @@
 - **加粗/斜体/删除线/链接/图片/标题/列表/引用**按 Markdown 语法保留；
   **表格**转为 GFM 表格（`| 列 |` + 分隔行）、**任务列表**转为 `- [x] / - [ ]`
 - 只在消息区域生效；复制界面其它地方（如设置、输入框）保持系统默认行为
+- **与官方「引用文本」不冲突（v0.3.0 核对）**：官方引用是选中文字后出现的按钮，
+  把纯文本插入输入框；本功能只接管消息区内的 `copy` 事件（Ctrl+C）改写剪贴板，
+  不碰选区、不改 DOM、不注册官方选区交互，两者可同时使用
 - **底层全部使用开源标准件**：公式还原 = KaTeX 官方 `copy-tex` 的同源做法（读
   `annotation` 源码出口）；"标签→Markdown"映射 = MIT 许可的
   [turndown](https://github.com/mixmark-io/turndown) + 官方配套
@@ -93,7 +118,7 @@
 
 ## 安装
 
-前提：DeepSeek Harness 桌面端（0.2.0-rc.2 验证通过）。
+前提：DeepSeek Harness 桌面端 0.2.2（官方 slots / theme / locale / sessions 接口验证通过）。
 
 **官方插件页**（设置 → 插件）的安装框里输入：
 
@@ -112,11 +137,17 @@ dsh plugin --profile <profile> add dsh-happy-reader
 插件页里卸载，或命令行 `dsh plugin --profile <profile> remove dsh-happy-reader`。
 卸载后应用完全回到原样。
 
+在插件页**停用**（不卸载）同样即时生效：浮动面板、悬浮按钮以及设置页里新增的两行
+「正文字体 · 中文 / 西文」都会立即移除，聊天界面和官方设置恢复原样；若当时处于插件
+全屏，也会一并退出、恢复窗口态；重新启用即恢复。
+
 ## 兼容性
 
-- Windows + DSH 桌面端 0.2.0-rc.2 开发验证；macOS / Linux 未适配
+- Windows + DSH 桌面端 0.2.2 开发验证（按官方客户端插件接口实现）；macOS / Linux 未适配
   （面板避让的是 Windows 系统按钮条，字体候选为 Windows 常用字体）。
 - 依赖官方客户端界面结构，DSH 版本升级后可能需要跟随更新。
+- 运行时按事件工作：无常驻定时轮询；宽度观察器只在面板打开或扩展宽度生效时挂载，
+  字体 token 晚就绪用有限次退避重试（成功后停止）。
 
 ## 许可
 

package/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Happy Reader"><rect x="4" y="6" width="56" height="52" rx="12" fill="#247bbf"/><path d="M17 20h16a6 6 0 0 1 6 6v20a6 6 0 0 0-6-6H17z" fill="#ffffff" opacity=".92"/><path d="M47 20H31a6 6 0 0 0-6 6v20a6 6 0 0 1 6-6h16z" fill="#ffffff" opacity=".55"/><path d="M22 27h8M22 33h8M36 27h6M36 33h6" stroke="#247bbf" stroke-width="2" stroke-linecap="round"/></svg>