一个适用于 O站剧本页面的非官方用户脚本。它将页面中的场景 Markdown 文本转换为格式化内容,支持 GFM、图片、表格、任务列表、代码块、链接和 KaTeX 数学公式。
https://omnimundia.cn/game/*omnimundia-markdown.user.js本脚本只改变安装它的浏览器中的页面显示,不修改 O站服务器、剧本数据或其他用户的页面。它不是 O站官方功能。其他访问者只有安装并启用相同脚本,才能看到相同的渲染效果。
| 功能 | 说明 |
|---|---|
| GFM Markdown | 标题、粗体、斜体、删除线、列表、引用、分隔线等 |
| 任务列表 | 支持 - [x] 和 - [ ],显示为只读复选框 |
| 代码 | 行内代码、fenced code block、语言类名、横向滚动 |
| 表格 | 支持对齐格式,窄屏下可横向滚动 |
| 图片 | 小图保持原始尺寸,大图最多占场景宽度的 50%,支持延迟加载 |
| 链接 | 新标签页打开,并添加 noopener noreferrer nofollow |
| 数学公式 | 使用 KaTeX 渲染行内和块级公式 |
| 响应式排版 | 长文本自动换行,针对窄屏调整代码块、表格和公式的溢出行为 |
| 布局保护 | 渲染容器允许 Flex 收缩,避免长 URL 或连续无空格文本撑宽页面、挤出侧栏 |
| 动态页面适配 | 自动处理新回合、文本更新、节点替换和 SPA 页面切换 |
| 安全清洗 | 原始 HTML 文本化,生成结构经 DOMPurify 清洗 |
| 原页面保护 | 保留 Vue 管理的原始场景节点,不直接改写其文本节点 |
https://cdn.jsdelivr.net。本脚本不依赖油猴 API 请求、后台服务或账号配置。
omnimundia-markdown.user.js 的全部内容复制进去;打开浏览器开发者工具,在 Console 中看到以下信息即表示脚本已启动:
[O站 Markdown] 已启用:GFM、图片和 KaTeX 公式。
如果页面仍显示 Markdown 原文,请先刷新页面,再检查脚本是否匹配当前地址以及依赖是否加载成功。
# 一级标题
## 二级标题
**粗体**
*斜体*
~~删除线~~
`行内代码`
脚本启用了换行支持。普通单行换行会按 <br> 处理;Markdown 传统的“行尾两个空格”换行方式也可使用。
- 无序项目
- 另一个项目
- 嵌套项目
1. 有序项目
2. 另一个有序项目
- [x] 已完成事项
- [ ] 未完成事项
任务列表只用于展示,复选框不会写回剧本数据。
> 这是一段引用。
---
使用三个反引号包裹代码,并可在开头标注语言:
```js
function greet(name) {
return `Hello, ${name}!`;
}
```
语言标识会生成类似 language-js 的 CSS 类名。当前版本提供等宽字体和横向滚动,不默认启用语法高亮。
| 项目 | 状态 | 说明 |
| :--- | :---: | ---: |
| 左侧对齐 | 居中 | 右侧对齐 |
表格容器支持横向滚动,避免窄屏直接撑破场景区域。
[OpenCode 文档](https://opencode.ai/docs/)
https://opencode.ai
链接会在新标签页打开,并自动附加安全的 rel 属性。危险协议地址会被清洗规则移除。

图片使用浏览器原生加载能力,并设置:
loading="lazy";decoding="async";width: auto,小图保持原始尺寸,不主动放大;max-width: 50%,大图最多占场景内容宽度的一半;默认尺寸上限由脚本中的 IMAGE_MAX_WIDTH 常量控制,可按个人需要改为 40%、60% 或 100%。
直接粘贴图片 URL 通常只会形成链接,不会自动嵌入图片;需要嵌入时请使用 。
使用单个美元符号包裹 KaTeX 内容:
质能方程为 $E=mc^2$。
中文正文中的行内公式也可解析。
块级公式的起止 $$ 应分别独占一行:
$$
\int_0^1 x^2\,dx = \frac{1}{3}
$$
支持 KaTeX 已实现的常用 TeX/LaTeX 命令,包括:
当前版本使用 $…$ 和 $$…$$ 作为公式分隔符,不支持 \(...\) 和 \[...\] 作为分隔符。
公式解析失败时,KaTeX 会显示对应错误内容,不会中断整个场景的渲染。
脚本本身没有统计、广告或数据上报逻辑,但以下功能会产生网络请求:
@require 下载或更新固定版本的依赖库;如果正文引用第三方图片,图片服务提供方可能获得 IP 地址、User-Agent、请求时间等常规访问信息。不要仅凭图片地址可见,就假设图片托管服务可信或长期可用。
脚本没有配置远程内容代理,也不会尝试绕过图片来源站的防盗链、鉴权或访问控制。
场景文字在当前浏览器内完成解析和渲染。脚本不包含以下行为:
GM_xmlhttpRequest 转发页面内容。原始 HTML 不作为页面结构执行,而是按文本显示。例如:
<b>这段文字会保留标签形式</b>
脚本只承诺 Markdown 和 KaTeX 渲染,不提供任意 HTML 执行能力。
Markdown 和 KaTeX 生成的 HTML 会经过 DOMPurify。当前配置包括:
script、iframe、object、embed 等高风险元素;脚本关闭了 KaTeX 信任模式,并限制宏展开次数和用户指定尺寸,降低异常公式影响页面的风险。
安全清洗用于降低 XSS 和异常内容风险,不应被理解为对所有浏览器缺陷、第三方依赖缺陷或外部资源内容的绝对保证。
脚本仅匹配:
https://omnimundia.cn/game/*
不会在其他网站或 O站的非剧本页面中修改 .scene。
当前版本依赖以下 DOM 结构:
.scene-content > .scene
如果 O站更新后更改相关类名或组件结构,脚本需要同步调整。
在脚本猫中停用本脚本,然后刷新 O站页面即可。
依次检查:
https://omnimundia.cn/game/...;cdn.jsdelivr.net。依赖加载失败时,脚本会停止执行并保留原页面,不会隐藏原始场景。
$…$;$$ 必须分别独占一行;\(...\) 当作当前版本的公式分隔符。;1.0.2 起,渲染容器使用 min-width: 0、overflow-wrap: anywhere 和 word-break: break-word,长 URL、连续英文或数字等无空格文本会按可用宽度换行。脚本还会给相关的 .scene-content、.story-panel 和 .panels-grid 添加布局保护标记,避免代码块或公式的最小内容宽度通过外层 Grid/Flex 布局撑宽主栏。代码块、宽表格和块级公式保持各自的局部横向滚动,不应撑宽整个页面。
如果旧版本出现此问题,请更新到 1.0.2 或更高版本并刷新页面。若更新后仍能复现,请提供浏览器信息、最小 Markdown 片段以及外层布局截图。
如果 O站修改了 StoryPanel 或 .scene 结构,请根据新 DOM 调整选择器和相邻节点约束。提交问题时,建议附上更新后的外层结构,但应先移除私人正文和账号信息。
| 依赖 | 固定版本 | 浏览器全局对象 | 用途 |
|---|---|---|---|
| KaTeX | 0.16.11 | katex |
将 TeX 公式转换为 HTML/MathML |
| Marked | 12.0.2 | marked |
解析 GFM Markdown |
| marked-katex-extension | 5.1.4 | markedKatex |
在 Markdown 解析阶段识别公式 |
| DOMPurify | 3.2.4 | DOMPurify |
清洗生成的 HTML |
KaTeX CSS 使用与 JS 相同的 0.16.11 版本。
所有依赖都通过精确版本的 @require 地址加载,不使用浮动的 latest。
Vue 原始 .scene
│
│ 读取 textContent
▼
Marked + marked-katex-extension
│
│ Markdown / KaTeX HTML
▼
DOMPurify
│
│ 清洗后的 HTML
▼
.omd-markdown-output
│
├─ 包裹表格容器
└─ 应用响应式样式
原始 HTML 在 Marked 渲染器阶段被文本化,公式则在 Markdown 解析阶段处理,以避免 TeX 反斜杠被普通 Markdown 转义规则吞掉。
.scene.scene 由 Vue 的 StoryPanel 管理。直接替换它的 innerHTML 会删除 Vue 持有的文本节点,可能导致后续回合更新失效。
本脚本采用以下结构:
.scene-content
├── .omd-markdown-output ← 用户脚本创建的渲染结果
├── .scene[data-omd-source] ← 原始节点,保留但隐藏
└── .options-container ← 原页面选项区域
渲染结果插入原节点之前,而不是之后。这样既保留 Vue 原节点,也保持 .scene 与后续选项区域的相邻关系。
二次开发时不要为了简化代码而直接覆盖原 .scene 的子节点。
| 常量 | 当前值 | 作用 |
|---|---|---|
SOURCE_SELECTOR |
.scene-content > .scene |
查找原始场景 |
SOURCE_ATTRIBUTE |
data-omd-source |
标记已接管的原始节点 |
OUTPUT_CLASS |
omd-markdown-output |
标识独立渲染容器 |
LAYOUT_ATTRIBUTE |
data-omd-layout |
标记需要允许收缩的场景及外层布局容器 |
KATEX_CSS |
固定版本的 KaTeX CSS 地址 | 加载公式样式和字体 |
IMAGE_MAX_WIDTH |
50% |
控制大图在场景中的最大显示宽度 |
修改这些值时,需要同时检查 CSS、节点创建、缓存和清理逻辑。调整图片尺寸通常只需修改 IMAGE_MAX_WIDTH,小图的 width: auto 规则应保持不变,避免低分辨率图片被强制放大。
| 函数 | 职责 |
|---|---|
escapeHtml() |
将原始 HTML 标签转换为文本实体 |
sanitize() |
使用 DOMPurify 清洗生成结构 |
wrapTables() |
为表格增加横向滚动容器 |
protectLayout() |
给 .scene-content、.story-panel 和 .panels-grid 添加布局保护标记 |
getOutput() |
查找或创建原节点之前的渲染容器 |
renderScene() |
读取原文、渲染、清洗并处理失败回退 |
scan() |
同步现有场景并清理失去原节点的旧容器 |
scheduleScan() |
使用 requestAnimationFrame 合并重复扫描 |
脚本使用 MutationObserver 监听:
childList;subtree;characterData。每个原始节点使用 WeakMap 保存:
{
raw, // 上一次处理的原始文字
output // 对应的渲染容器
}
当原文和输出节点均未变化时,跳过解析。这样既避免脚本自身修改 DOM 造成重复渲染循环,也能在 Vue 更新原文后重新生成内容。
扫描通过 requestAnimationFrame 合并执行;pageshow 事件用于处理浏览器页面恢复。
.omd-markdown-output 内;omd- 前缀;p、table、img 等元素;.scene[data-omd-source] 的隐藏规则;.story-panel 和 .panels-grid 也要检查最小内容宽度,不能只给正文设置换行;建议遵循以下顺序:
@require 中固定依赖地址;markedLib.use(...) 阶段注册;不要为了方便直接关闭安全清洗,也不要默认开启 KaTeX trust。
升级 KaTeX 时,必须同时更新:
@require 中的 katex.min.js;KATEX_CSS 中的 CSS 地址。升级 Marked、公式扩展或 DOMPurify 时,应核对其浏览器 UMD 导出和 API 是否发生变化。不要只替换版本号而不检查兼容性。
无需构建工具。修改后可直接将源码重新复制到脚本猫并刷新页面。
语法检查可使用:
node --check omnimundia-markdown.user.js
建议至少检查以下行为:
建议提供:
[O站 Markdown] 前缀的日志;请不要提交账号密码、访问令牌、完整隐私对话或其他敏感信息。
@version;@require 地址;IMAGE_MAX_WIDTH 常量,便于统一调整图片尺寸上限。本项目使用 GNU General Public License v3.0(GPL-3.0) 发布,完整许可证文本见项目根目录的 LICENSE 文件,脚本头也已声明 @license GPL-3.0。
在 GPL-3.0 下,安装者可以运行、研究、修改和再分发本项目;再分发原始或修改版本时,需要遵守许可证规定的源代码提供、相同许可证、版权声明和修改说明等义务。这里仅是便于阅读的概要,具体权利与义务以 LICENSE 全文为准。
Marked、KaTeX、marked-katex-extension 和 DOMPurify 分别遵循其各自许可证;再分发或修改相关依赖时,应保留其版权和许可证声明。
本项目为非官方用户脚本,与 O站官方无关。网站结构、浏览器扩展机制、第三方 CDN 或依赖库的变化都可能影响脚本可用性。使用者应自行判断外部图片和链接是否可信。