English | 中文

一个功能强大的 Obsidian 插件，专为中文网络小说作者打造，提供字数统计、写作目标追踪、伏笔管理、时间线系统、OBS 直播叠加层等丰富功能。

📖 文档

• 用户使用指南 - 完整的功能说明和使用教程
• OBS 叠加层 CSS 指南 - 自定义 OBS 样式
• 更新日志 - 版本更新记录

✨ 核心功能

🌑 沉浸写作模式

• 全屏专注: 隐藏所有干扰元素，提供沉浸式创作环境
• 动态仪表盘: 实时显示小说标题、计时器、字数统计及专注度分析
• 辅助面板: 快速唤出章节列表、伏笔追踪、时间线与多功能悬浮便签
• 卡片式布局: 现代化的辅助面板设计，支持自定义位置与大小

📊 字数统计与目标追踪

• 实时统计字数，适配中文创作平台计算规则
• 章节目标、今日目标、榜单目标，进度可视化
• 写作状态面板显示当前作品信息（目录名、总字数）
• 严格章节模式: 字数统计、进度条及提醒仅在符合规则的章节中生效，写大纲不计入进度
• 字数实时提醒: 在编辑器左侧行号区域实时显示累计字数提醒，支持自定义间隔
• 高稳定性架构: 采用编辑器事件与文件系统双重校验，彻底解决字数统计跳变问题
• 文件浏览器显示文件夹字数（高性能缓存，支持万级文件秒开）

⏱️ 专注时间追踪

• 自动区分专注时间与摸鱼时间
• 写作数据追踪: 365热力图、柱状图+虚线趋势曲线、效率总览卡片、累计字数统计
• 历史统计图表（日/周/月/年），支持横向滚动
• Worker 线程处理，不影响编辑性能

📝 创作辅助工具

• 悬浮便签: 多端同步、自动保存、独立存储、支持 Markdown 渲染
• 选项卡式设置: 模块化设置页面，分类更清晰，操作更便捷
• 伏笔管理: 标注、追踪、多章节回收
• 时间线系统: 事件记录、多章节关联、类型分类
• 榜单追踪: 追踪签约平台的榜单任务，自动计算字数增量，到期自动关闭，起始字数可手动修改
• 智能章节排序：自动识别章节编号排序，支持"大纲"、"番外"等具名章节
• 规则排序优化：设置页面支持通过 ▲/▼ 按钮自由调整排序规则优先级
• 合并章节：一键合并文件夹内所有章节

🎥 直播功能

• OBS 叠加层：实时显示写作数据
• 自定义样式、透明度、显示内容
• 零延迟、零磁盘消耗

📱 移动端与跨平台支持

• 浮动字数统计窗口（移动端）
• 触摸优化，防误触
• 复制本文档: 一键复制当前章节，并在首行自动添加文档标题，完美适配社交媒体与发布平台分享
• 跨设备字数统计同步优化

📥 安装

从 Obsidian 社区插件市场安装（推荐）

1. 打开 设置 → 第三方插件 → 浏览
2. 搜索 "WebNovel Assistant"
3. 点击 安装，然后 启用

使用 BRAT 安装

1. 安装 BRAT 插件
2. 在 BRAT 设置中添加此仓库：HatanoChihiro/obsidian-webnovel-assistant
3. 启用插件

手动安装

1. 从 Releases 下载最新版本
2. 解压到 .obsidian/plugins/web-novel-assistant/
3. 重启 Obsidian 并启用插件

🚀 快速开始

1. 安装插件后，打开任意 Markdown 文件
2. 状态栏会显示当前字数统计
3. 点击状态栏可快速设置目标字数
4. 命令面板（Ctrl/Cmd + P）搜索 "WebNovel" 查看所有功能
5. 插件设置中可自定义各项功能

详细使用方法请查看 用户使用指南

🎯 主要命令

提示：所有命令都可以在 Obsidian 设置 → 快捷键中自定义快捷键

⚙️ 主要设置

更多设置请查看 用户使用指南

🎨 OBS 叠加层快速设置

1. 插件设置 → 启用 OBS 叠加层
2. OBS 中添加 浏览器源
3. URL 填入：http://127.0.0.1:24816/
4. 建议尺寸：宽度 300px，高度 500px

详细自定义方法请查看 OBS 叠加层 CSS 指南

📄 许可证

MIT License

💖 支持项目

如果这个插件对你有帮助，欢迎：

• ⭐ 给项目点个 Star
• 🐛 提交问题
• 💡 功能建议

祝你写作愉快！ ✍️

WebNovel Assistant

English | 中文

A powerful Obsidian plugin designed for Chinese web novel writers. Features accurate word count, writing goal tracking, focus/slack time analysis, foreshadowing management, timeline system, sticky notes, and OBS streaming overlay — all optimized for the Chinese writing workflow.

Features

• Accurate Word Count — Tailored for Chinese web novel platforms, excludes Markdown syntax and punctuation
• Writing Goals — Chapter goal, daily goal, and ranking goal with real-time progress tracking
• Focus Timer — Automatic focus/slack time detection with Web Worker threading
• Immersive Mode — Full-screen distraction-free writing with dashboard and auxiliary panels
• Foreshadowing Manager — Mark, track, and recover story foreshadowing across chapters
• Timeline System — Track story events with multi-chapter associations and custom types
• Sticky Notes — Floating notes with auto-save and Markdown rendering
• OBS Overlay — Real-time writing stats overlay for live streaming (local HTTP server, 127.0.0.1 only)
• Smart Chapter Sorting — Auto-detect chapter numbers (Arabic/Chinese) and sort in file explorer
• Chapter Merge & Export — One-click merge all chapters into a single file
• Mobile Support — Floating word count, touch-optimized controls, cross-device sync

Installation

From Obsidian Community Plugins (Recommended)

1. Open Settings → Community Plugins → Browse
2. Search for "WebNovel Assistant"
3. Click Install, then Enable

Using BRAT

1. Install the BRAT plugin
2. Add this repository: HatanoChihiro/obsidian-webnovel-assistant
3. Enable the plugin

Manual Installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create folder .obsidian/plugins/web-novel-assistant/ in your vault
3. Copy the downloaded files into that folder
4. Restart Obsidian and enable the plugin in Settings → Community Plugins

Quick Start

1. After installation, open any Markdown file
2. The status bar displays real-time word count
3. Use Command Palette (Ctrl/Cmd + P) and search "WebNovel" to access all commands
4. Configure features in Settings → WebNovel Assistant
5. See the full User Guide for detailed instructions

License

MIT License