Repository navigation
Releases
Releases · yukisova/obsidian-novel-view
v0.12.1
这个版本算是进一步扩充了设定集的展示,并为设定记录提供了类似时间轴、关系图谱、分支树的辅助用工具;然后加入了沉浸模式,下一个版本会重点优化使用体验
写作与查找
- 新增沉浸模式:当前编辑行固定在视口中央,其他内容淡出。
- 查找结果支持正文高亮、当前匹配定位、章节摘要和跨章节导航。
- 查找卡片与沉浸模式互斥;关闭查找后清理高亮。
- 文字标记组移入右栏,支持标记实例聚合、跳转正文、标签间拖拽和区间冲突提示。
- 修复拖动时界面重建、滚动位置丢失、有效标记被误删等问题。
设定集与特殊文件
- 新增左栏设定集列表,展示设定组、特殊文件和文字标记入口。
- 支持四类特殊文件:图谱、时间轴、分支树、详细文件。
- 特殊文件支持显示/源码双视图和自动保存。
- 源码视图增加模式按钮、格式提示、保存状态、行号、当前行高亮和快捷键。
- 设定组和特殊文件支持右键重命名、删除。
- 返回按钮改为“小说组”。
图谱
- 支持节点拖动、拉线、Shift 双向线、删除节点/关系、曲线调整和布局持久化。
- 新增圆角矩形容器节点:
- 空容器为 64×64 正方形圆角矩形;
- 有成员时自动扩展;
- 悬停边框可拉线,内部拖动移动容器及成员。
- 支持
F在普通节点与容器节点之间双向切换。 - 容器按名称匹配设定记录:有记录实线,无记录虚线。
- 空白双击按坐标新建节点;无记录节点单击内联重命名,重名失败。
- 新增统一关系索引,跨图谱同步新增、改名、删除关系。
- 设定记录详情卡按旧版关系属性卡片展示关系名、方向、目标记录。
时间轴
- 仅支持横向轴,不显示时间刻度和轨道编号。
- 滚轮左右滚动,Shift+滚轮调整时间间距,中键拖拽禁用。
- 时间条分为三类:
- 设定记录:紫底白字,点击打开详情;
- 文字标记:粗实线边框,点击跳转正文;
- 未绑定文本:虚线边框,点击显示信息卡。
- 支持设定记录、文字标记按落点拖入。
- 空白双击按鼠标所在刻度创建时间项。
- 轴画布固定宽高并垂直居中,不再随新增项自动伸缩。
- 右键支持调整开始位置、查看时间信息和删除轴项;调整开始位置保留持续时间。
分支树
- 多顶级节点按森林显示,无虚拟根。
- 单击聚焦、双击跳转文字标记、右击删除子树、空白双击在聚焦项下新建子项。
- 绑定文字标记与未绑定文本使用不同边框样式。
- 连接线改为 SVG 三次贝塞尔曲线,移除旧伪元素折线。
其他
- 修复特殊文件标签页标题显示。
- 移除多余时间/轨道文字。
- 持续保留正文标记数据,避免视图副作用误删。
v0.11.0
这个版本更多是优化,优化各个模块的使用体验,自己实际上手发现哇塞一堆问题,赶紧修修修
编辑器体验
- 优化长文输入、方向键和长按退格性能。
- 修复空行、分隔线、缩放后的点击错位和方向键跳行。
- 关键词仅在每章首次出现时链接,并支持悬浮查看设定摘要。
- 完善待修改区块、图片、分隔线和段落排版。
设定集
- 记录改为固定尺寸卡片,支持图标、字段、关系、标记和详情面板。
- 支持跨标签拖动、同标签排序,并修复拖动闪烁。
工作台与文章管理
- 完善文章列表、卷、文章组、章节状态、简介与封面工作流。
- 支持拖拽、批量操作、自然排序和配置持久化。
- 修复历史记录与设定索引的并发读取问题。
查找、导入与素材
- 完善 NovelFinder、高级查找替换和多文件匹配。
- 改进 TXT 导入导出、素材库、图片插入和封面选择。
界面与稳定性
- 移除 Obsidian 插件设置页,格式设置由编辑器内面板承担。
- 优化侧栏、工作台、预览和主题样式。
v0.10.3
这个版本进一步扩充了设定系统,并以设定组为单位整合所有的设定,另外还优化了所有卡片显示的效果;另外,还加入了文字标记的功能。
我并不想要这个插件成为一个一站式的码字平台,所以很多在其他插件里常见的功能(番茄钟,沉浸模式,改名,ai等等)都不会考虑加入,这个插件仅仅只是给我这样的以码字为爱好的,想要用来设计OC世界观与故事线的作者提供一个轻量小说编辑平台。
设定系统
- 设定组改为小说组下直接的
-文件夹,隐藏索引文件;文件列表隐藏卷、src和普通根文件,仅显示无前缀的设定组名称。 - 点击设定组切换右侧设定页面;小说组保留原生展开/折叠。
- 设定记录支持自定义属性、关系、关系图谱和详细文件。
- 新增可拖动、非模态的详情悬浮卡:可切换记录、跨组跳转编辑;属性可排序,并按篇幅自动并排、单行或标题加正文展示。
- 关系两端同步同一份数据,左右单向箭头互为镜像,图谱使用单/双箭头并去重。
工作台与文件
- 工作台简介下列出根目录
-开头的 Markdown 文件,省略前缀和后缀;点击以普通 MarkdownView 打开,可重命名或删除。 - 这些文件不再计入分散卷或文章列表。
- 新增并完善演示小说组。
NovelEditor
- 章节标题可直接编辑,禁止
-前缀。 - 修复正文空白、上下方向键和鼠标定位异常。
- 关键词悬浮卡支持一对多分页,点击关键词打开对应设定详情。
- 正文文字标记改为通用功能,支持右键添加/删除,并增大标记样式。
- 移除工具栏文字标记按钮。
NovelFinder
- 高级查找替换更名为 NovelFinder,结果显示在右侧结果栏。
- 新增文字标记、待修改部分、关键词范围;替换框独立成行。
- 修复查找卡片拖动闪烁、文章列表点击后滚动跳顶等问题。
v0.9.12
新版本引入了一个全新的系统,用来替代原本的联动库——设定集
设定集
- 用户可以在文件列表右击小说组,来构建小说组对应的设定集,设定集本身是以-号作为前缀的文件夹,其下使用index.json来管理设定资料。
- 数据结构为:设定分组 → 标签 → 设定记录(关键词、简介)。
- 设定集文件夹下的设定组会与 index.json 自动同步:
- 缺文件夹自动创建;
- 外部文件夹自动清理;
- index 缺失自动重建;
- 文件列表重命名分组时自动更新 index,并补回
-前缀。
- 设定集界面支持分组、标签、记录的新建、编辑、删除、拖拽排序和三级悬停展开。
- 记录支持详细文件:
关键词-标题.md,可新建、打开,并在记录或标签移动时跟随。 - 支持从外部文件夹导入设定:一级子文件夹作为新设定分组,内容递归导入。
关键词体系迁移
- 关键词高亮、悬停和点击跳转不再来自联动库,改为读取设定记录。
- 高亮颜色取标签颜色。
- 悬停卡片展示关键词、标签、设定分组、简介和两列详细文件按钮。
- 点击关键词定位到设定集对应记录。
NovelEditor 收尾
- YAML 属性完全隐藏并阻止编辑。
- 增加待修改代码块、选区转待修改、颜色分类和 TOC 待修改分区。
- 完善分栏保存同步,避免旧视图覆盖新正文。
- TOC 改为悬停展开的缩略卡片,按
---分隔章节。
TXT 格式定稿
- 导入按“第x卷 卷名 / 章名 / 两全角空格正文”解析。
- 导出统一为卷标题加
第n卷,每行正文包括空行都加两个全角空格。
清理与稳定性
- 历史记录明确只保留最近 7 天。
- 联动库视图、
links.json读写、编辑/导入面板和相关测试全部删除。
v0.8.5
主要更新
本阶段最大变化是小说模式从 MarkdownView 样式扩展重构为独立 Novel Editor:
- 小说章节不再经过原生 MarkdownView,普通 Markdown 文件保持原生渲染。新编辑器按纯文本原样显示 Markdown 字符。
- 新NovelEditor支持自动保存、文章标题、字号/行高/段距/首行缩进、实时插入并显示块级图片、选区与光标增强、左下角浮动工具栏。
- 右上角提供TOC,按 --- 分隔章节;可在TOC点击跳转。
其他更新
- 文章列表支持按 ID 排序、卷顺序、多选、拖拽排序、撤销与快捷键;
- 文章组可连续归组、编辑、移出和拖拽。
- 卷重命名不再清空文章组。
- 修复编辑时列表滚动闪烁、刷新循环及文章拖拽冲突。
- 工作台增加小说详情与 4 小时字数历史。
- 章节状态提供颜色标记;
- 小说组配置迁移到 novel.json。
- 联动库使用 links.json。
- 支持标签、别名、唯一关键词、悬停卡片和撤销。
- 查找替换支持多范围与正则。
- 自动排版、TXT 导入导出和素材库同步完善。
NovelView我打算做成一个轻量的“非专业”写作工具,集中在随时随地写作这种事上。
面向的是将写小说当做爱好,会喜欢给自己的小说世界观写各种设定的作者。
因此呢,之后的开发重点会集中在设定集的完善上,会完全重构联动组这个概念。
v0.7.21
这一阶段,主要加入了文章组的概念,用于划分小说剧情;可以根据自己的需要在每一卷加入卷海报,海报什么未来还可以在工作台里轮播展示……毕竟这个项目的最主要面向群体是我这种拿写小说当爱好的人。
1. 配置体系迁移
- 小说组配置由
NovelSetting.md迁移为根目录novel.json。 - 小说简介、封面、卷顺序、卷描述/海报、文章组信息统一存入 JSON。
- 旧
NovelSetting.md自动迁移,原文件保留可见。 - 废弃笔记属性识别逻辑,运行期只读取新配置结构。
2. 文章列表重构
- 文章排序改为仅依据
novelview-id,不再受文件名影响。 - 新建文章自动分配递增 ID;ID 不在列表中显示。
- 卷顺序使用
volume-order,不再按名称排序,并支持拖动调整。 - 支持多选、框选实时同步、批量拖拽、正序/倒序切换。
- 支持
Cmd/Ctrl+Z撤销移动、删除、重命名。 - 支持
Cmd/Ctrl+N在当前组或卷内新建章节。 - 支持 TXT 导入、全组合并稿导出、单章/单卷导出。
- 修复删除闪烁、滚动跳顶、卷无法展开、拖拽抖动等问题。
3. 文章组
- 连续章节可归入文章组,列表以整体圆角边框展示。
- 强制约束:
- 必须同卷且连续;
- 单篇不能成组;
- 少于两篇自动移除;
- 中断的组自动拆分。
- 重命名、删除、移动、排序后自动修复组成员路径与连续性。
- 支持拖拽加入、按“以上/以下”移出、编辑组信息、悬停查看描述。
4. 联动库与关键词
- 联动组、标签、标签颜色、文件别名完整支持。
- 同一关键词只能指向一个联动文件:
- 有别名时别名替代文件名;
- 导入、改别名、重命名均检查冲突并强制唯一别名。
- 联动文件支持单击聚焦、双击打开、拖拽分组/分配标签、撤销。
- 移除联动组字体样式功能。
- 关键词高亮只显示每章第一次出现。
- 关键词悬停卡片显示文件名、标签、联动组,并定位在关键词下方。
5. 小说模式与查找
- 自动排版支持块级空行规则,并清理段首/段尾空格与 Tab。
- TOC 默认缩略,聚焦展开。
- 移除左上角字数与状态卡片。
- 高级查找改为可拖动的全局单例浮窗,支持全章、本卷、全书、联动库范围,结果按文件分组。
6. 工作台与资源
- 工作台重做为小说详情卡:封面、标题、简介、字数/卷数/章节统计。
- 点击标题、简介、封面即可直接编辑。
- 封面与卷海报统一保存至
src,已被引用的图片从素材库隐藏。
7. 拖拽隔离与稳定性
- 文章列表拖拽到 MainArea 支持三种目标:
- 内容区:第二栏打开;
- 标签页栏:追加标签页;
- 标签页标题:替换并追加。
- 原生文件浏览器拖拽与文章列表拖拽彻底隔离,避免互相拦截。
- 多轮修复文章组连续性、重命名脱组、框选、菜单定位、列表滚动与工作台布局问题。
v0.6.22
这一阶段主要解决了文章列表与侧边栏的显示异常,并逐步完善文章排序、联动库交互、查找窗口和小说工作台。
界面与显示
- 修复了文章列表与文件列表切换时的重影、黑背景覆盖毛玻璃以及左侧 Ribbon 间歇性变黑的问题。原因是自定义视图叠加了额外的合成层,并与 Obsidian 的毛玻璃效果冲突。后续移除了
contain、isolation、额外z-index和自定义backdrop-filter,让文章列表只保留单一不透明背景。 - 素材库、联动库和文章列表的标题字体统一为界面字体,素材库与联动库的标题、副标题和分隔线样式也统一。
文章列表
- 文章排序最终改为只依据递增的
novelview-id,不再受文件名影响。新建文章分配下一个递增 ID;拖到卷名视为移入该卷并重新分配 ID;拖到文章之间视为插入,并按插入位置重排。ID 不在树状列表中显示。
同时支持:
- 多选文章批量拖拽,包括跨卷移动。
- 卷顺序写入
NovelSetting,分散卷始终显示。 - 拖拽时卷区域虚线高亮、文章之间显示插入线。
- Cmd/Ctrl+Z 撤销移动、删除、重命名。
- Cmd/Ctrl+N 在当前小说组新建章节。
- 工具栏“导入与导出”:导入系统 TXT 文件,或合并全组文章导出到指定文件夹。
- 移动期间合并刷新、取消待执行渲染,减少因 ID 重排造成的列表抖动。
联动库与素材库
- 联动库的“默认联动组”改为“分散组”,始终置顶并常驻显示。新建联动组直接创建;组和标签支持就地重命名,标签可右键修改颜色或解绑。
- 联动文件支持多选拖拽到其他组、标签或文件之间,并提供组/标签区域高亮和插入线预览。带标签文件显示文件名与路径,不再重复标签名。联动库支持 Cmd/Ctrl+Z 撤销移动、删除、重命名、标签颜色和解绑操作。
- 导入联动文件窗口支持双击文件或 Enter 导入;未选中文件时别名输入框不可编辑。
- 素材库和联动库打开时会优先复用右侧已有 Tab,不重复开窗;标题下显示当前小说组。
高级查找替换
- 查找窗口改为全局浮动卡片,不再受 MainArea 范围限制;窗口可拖动,标题下显示当前小说组。查找窗口保持单例,在其他章节打开时复用并更新查找范围。
- 同时修复了工具栏“查找替换”按钮无法弹出窗口的问题。
小说模式
- 自动排版在原有空行规则基础上,增加对段首、段尾空格及 Tab 的清理。
- 右上角的文章字数与章节状态 UI 移到正文之前、标题之后的固定位置,不再随正文滚动。
工作台
- 小说详情区域扩大,封面占比提升;删除“编辑小说信息”按钮及对应弹窗逻辑。现在点击小说标题、简介或封面即可直接编辑对应内容。
- 整体上,这一阶段将文章排序从文件名驱动改为 ID 驱动,完善了拖拽反馈和撤销能力,并集中修复了侧边栏合成层导致的显示问题。
v0.6.11
联动库
- 联动组支持字体样式:粗体、斜体、粗斜体、下划线。
- 文件支持可选标签与高亮颜色,空标签自动清理。
- 树状结构优化,修复标签文件不显示问题。
- 多选仅针对文件,支持框选、Shift、Ctrl/Cmd。
- 多选右键可批量添加标签或删除。
- 移除顶部工具栏,新增/导入改由右键菜单完成。
文章列表与导出
- 支持单章、单卷、多选章节导出 TXT。
- “导出合并稿”改为合并全组文章,并通过系统文件夹选择器保存。
- 删除导出文件夹相关忽略逻辑。
小说模式
- 自动隐藏 H1-H6 标记。
- 分隔线、列表、引用块恢复原生显示,不应用首行缩进。
- 自动排版仅在分隔线、表格、列表、引用块前后保留空行,其余空行删除。
- 左上角 TOC 默认缩略,聚焦时展开。
高级查找替换
- 入口移至小说模式浮动工具栏。
- 支持全章、本卷、全书、联动库文件范围。
- 实时查找,结果按文件分组展开。
- 面板仅显示在当前文章视图,随 MainArea 自适应并居中。
格式设置
- “小说模式设置”更名为“格式设置”。
- 字体大小、行距、段距、首行缩进支持实时生效。
v0.6.0
精简了项目规模
文章管理
- 文章列表支持行内重命名、聚焦状态和虚拟“分散卷”。
- 新增框选、Shift 连续选择、Ctrl/Cmd 间断选择和多选批量删除。
- 多选状态下禁止重命名。
- 新建文章默认“无标题”,不再重复写入 H1。
- 新建卷直接生成“无名卷”,重名自动编号。
- 文章列表替换左侧文件列表,并提供“返回”按钮和标题栏返回图标。
- 标题区域精简为小说名和正文数量。
- 章节行显示字数和章节状态。
工作台与小说组
- 工作台卡片逐步精简,最终只保留小说概览。
- 删除人物、设定、灵感、大纲等卡片及相关逻辑。
- 工作台小说组由文章列表当前选中组决定。
- 点击小说组时,若主区域已有工作台,只更新聚焦组,不自动跳转。
- 新增“取消小说组构建”,并清理
NovelSetting及旧特殊文件。 - 根目录始终不能作为小说组。
内容组织与清理
- 删除灵感便签、灵感页面及相关工具栏入口。
- 删除大纲特殊页面、幻灯片和旧大纲文件逻辑。
- 删除人物、设定、时间线、伏笔等特殊页面。
- 删除章节描述、卷描述及相关浮动面板和数据。
- 清理旧
novelview-type分类属性和旧描述属性。 - 章节状态改用
novelview-state属性。 - 删除小说级状态
novelstate及相关 UI。
联动库
- 新增联动库及
links.json配置。 - JSON 从
link/文件夹移至小说组根目录。 - 支持联动组、颜色、文件名/别名关键词。
- 支持任意 Obsidian 可识别文件类型导入。
- 导入使用悬浮树窗口,可设置别名并回车确认。
- 新增顶部工具栏:新增联动组、导入联动文件、多选/批量删除。
- 联动组支持展开/折叠、拖拽和聚焦。
- 编辑组/文件使用无对话框浮动面板;重命名改为右键后原位编辑。
- 加载时自动清理已丢失文件的联动记录。
- 关键词支持
~/仓库路径、当前卷回退和组颜色高亮。
素材库
- 素材库移至右侧边栏。
- 移除复制链接,增加打开和删除。
- 空状态增加半透明水印,支持双击空白区域导入图片。
- 素材支持原位重命名。
- 移除素材卡右键菜单。
- 素材选择窗口放大并显示名称。
小说模式
- 小说组内普通 Markdown 自动进入小说模式。
- 修复多级列表缩进、续行行距和表格/图片居中。
- 工具栏精简为自动排版、插入图片。
- 插入图片支持“从文件 / 从素材库”。
- 自动排版改为删除所有空行。
- 右上角状态卡改为章节字数与章节状态,可点击切换状态。
最终移除的功能
- 灵感便签与灵感页面
- 大纲特殊页面与幻灯片
- 人物/设定/时间线/伏笔特殊页面
- 工作台内容卡片
- 章节描述与卷描述
- 小说状态
- 旧分类关键词系统
v0.3.6
已经实现预期功能的预览版本
功能
- 小说组:文件夹即小说组;根目录文章自动归入“分散卷”
- 文章列表:卷展开/收起、拖拽、聚焦、行内重命名、新建“无标题”文章
- 小说模式:小说组普通 Markdown 自动开启,无需按钮或命令
- 工作台:大纲/灵感卡片,平铺可调大小,关联文章列表当前组
- 灵感:最多 8 个浮动便签,标题唯一,保存为卡片并可恢复编辑
- 大纲 | 卷纲/章纲,幻灯片分页,支持 --- 分隔
- 查找替换 | 当前目录、正则/全词/大小写、右侧结果面板
安装
- 下载下方 main.js 和 manifest.json
- 放入 Obsidian 库的 .obsidian/plugins/novel-view/ 目录
- 重启 Obsidian,在设置中启用插件