From 7a1e6d96e415f3abfcf8d0d984e817206bb9e211 Mon Sep 17 00:00:00 2001
From: Da Shen <da@liii.pro>
Date: Tue, 1 Sep 2026 21:55:46 +0800
Subject: [PATCH 1/2] =?UTF-8?q?[1253]=20=E4=BB=BB=E5=8A=A1=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3=E4=B8=8E=E5=BC=80=E5=8F=91=E8=A7=84=E8=8C=83=E6=9B=B4?=
 =?UTF-8?q?=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CLAUDE.md     |  2 ++
 devel/1253.md | 52 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+)
 create mode 100644 devel/1253.md

diff --git a/CLAUDE.md b/CLAUDE.md
index 43e5d39a35..a8835b6070 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -293,6 +293,8 @@ xmake test lolly_tests/hashmap_test   # 单个测试
 
 如果构建失败（例如配置缓存陈旧、依赖路径错乱），执行 `xmake f -c --yes` 清理配置缓存后重新构建。
 
+如果只是修改 Scheme 文件（`.scm`），不需要使用 xmake 重新编译，但在 Windows 下需要执行一下 `xmake i stem`（同步资源文件到运行目录）。
+
 ### Scheme Glue（C++ ↔ scheme 绑定）
 
 - **glue 声明在 `.lua` 不在 `.scm`**：mogan 的 glue 由 xmake 规则 `xmake/rules/glue.lua`
diff --git a/devel/1253.md b/devel/1253.md
new file mode 100644
index 0000000000..399ec78917
--- /dev/null
+++ b/devel/1253.md
@@ -0,0 +1,52 @@
+# [1253] 修复 Ghostscript 输出路径包含空格时图片加载失败的问题
+
+## 1 相关文档
+- [dddd.md](dddd.md) - 任务文档模板
+- Issue: [#3978 Embedded EPS is not loaded if the user name contains a space (Linux)](https://github.com/MoganLab/mogan/issues/3978)
+- PR: [#2859 [212_2703] Fix gs path quoting for paths with spaces on macOS](https://github.com/MoganLab/mogan/pull/2859)
+
+## 2 任务相关的代码文件
+- `TeXmacs/plugins/binary/progs/binary/gs.scm`
+- `CLAUDE.md`
+
+## 3 如何测试
+
+### 3.1 资源同步
+修改 Scheme 代码后，在 Windows 下需执行资源同步安装命令：
+```bash
+xmake i stem
+```
+
+### 3.2 验证命令行拼接与路径引号处理
+使用 Mogan 执行 Scheme 表达式或通过 headless 模式验证 `string-quote` 正确处理带空格的路径：
+```scheme
+(import (binary gs))
+;; 模拟带空格的目标文件路径
+(define to-url (string->url "file:///tmp/User Name/output.png"))
+(string-append " -sOutputFile=" (string-quote (url->system to-url)) " ")
+;; 预期结果: " -sOutputFile=\"/tmp/User Name/output.png\" "
+```
+
+### 3.3 实际功能验证（EPS / PDF 图片加载渲染）
+1. 启动 Mogan STEM：
+   ```bash
+   xmake r stem
+   ```
+2. 打开一个包含嵌入式 EPS 图像的 `.tm` 文档（或者在包含空格的用户名/路径环境下插入 EPS/PDF 图像）。
+3. 检查控制台无 Ghostscript 参数解析截断错误（如 `Unrecoverable error` 或找不到文件），EPS/PDF 图像能正常转换为图片并清晰显示。
+
+## 4 如何提交
+
+```bash
+gf fmt --changed-since=main
+```
+
+## 5 What
+1. 在 `TeXmacs/plugins/binary/progs/binary/gs.scm` 中的 `gs-eps-to-pdf`、`gs-eps-to-png`、`gs-pdf-to-png` 三处函数中，将 `-sOutputFile=` 的参数由 `(url->system to)` 改为 `(string-quote (url->system to))`。
+2. 更新 `CLAUDE.md` 开发规范文档，补充「仅修改 Scheme 代码时无需重新编译，在 Windows 下执行 `xmake i stem` 同步资源」的说明。
+
+## 6 Why
+当系统用户名或临时文件目录包含空格字符（例如 Linux/macOS 下 `/tmp/Kovács Zoltán/...`）时，未加引号的 `-sOutputFile=/tmp/Kovács Zoltán/...` 参数会被 Ghostscript 在空格处截断，导致 Ghostscript 将路径后半部分误识别为其他参数而报错退出，最终导致嵌入的 EPS/PDF 图片无法正常加载和显示。
+
+## 7 How
+通过 `string-quote` 对 `(url->system to)` 进行转义并包裹双引号，生成 `-sOutputFile="/path with space/output.png"` 的命令行参数，确保 Ghostscript 可以将包含空格的完整路径识别为单个参数。

From bc1e4116279bc8791944d031d67270a5f9ea1fce Mon Sep 17 00:00:00 2001
From: Da Shen <da@liii.pro>
Date: Tue, 1 Sep 2026 21:55:47 +0800
Subject: [PATCH 2/2] =?UTF-8?q?[1253]=20=E4=BF=AE=E5=A4=8D=20Ghostscript?=
 =?UTF-8?q?=20=E8=BE=93=E5=87=BA=E8=B7=AF=E5=BE=84=E5=8C=85=E5=90=AB?=
 =?UTF-8?q?=E7=A9=BA=E6=A0=BC=E6=97=B6=E5=9B=BE=E7=89=87=E5=8A=A0=E8=BD=BD?=
 =?UTF-8?q?=E5=A4=B1=E8=B4=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 TeXmacs/plugins/binary/progs/binary/gs.scm | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/TeXmacs/plugins/binary/progs/binary/gs.scm b/TeXmacs/plugins/binary/progs/binary/gs.scm
index 31193b42cd..83f9711891 100644
--- a/TeXmacs/plugins/binary/progs/binary/gs.scm
+++ b/TeXmacs/plugins/binary/progs/binary/gs.scm
@@ -113,7 +113,7 @@
                 " -sDEVICE=pdfwrite "
                 " -dAutoRotatePages=/None "
                 " -dCompatibilityLevel=1.4 "
-                (string-append " -sOutputFile=" (url->system to) " ")
+                (string-append " -sOutputFile=" (string-quote (url->system to)) " ")
                 (string-append " -c " (string-quote gs-inline))
                 (string-append " -f " (url-sys-concretize from) " ")
                 (string-append " -c " (string-quote " grestore "))
@@ -159,7 +159,7 @@
                                " -dGraphicsAlphaBits=4 "
                                " -dTextAlphaBits=4 "
                                page_size_in_px
-                               (string-append " -sOutputFile=" (url->system to) " ")
+                               (string-append " -sOutputFile=" (string-quote (url->system to)) " ")
                                resolution_in_px
                                (string-append " -c " (string-quote gs-inline))
                                (string-append " -f " (url-sys-concretize from) " ")
@@ -200,7 +200,7 @@
                                " -dGraphicsAlphaBits=4 "
                                " -dTextAlphaBits=4 "
                                " -dUseCropBox "
-                               (string-append " -sOutputFile=" (url->system to) " ")
+                               (string-append " -sOutputFile=" (string-quote (url->system to)) " ")
                                page_size_in_px
                                resolution_in_px
                                (url-sys-concretize from)