官网: https://anh.sirrus.cc/ | 文档: https://blog.sirrus.cc > 最新版本: 0.4.35 (2025-11-21) | VS Code Marketplace: Andrea Novel Helper
Andrea Novel Helper - 专为小说创作者打造的 VS Code 写作增强扩展
Andrea Novel Helper（小说助手）是一个围绕"设定集/资料集"组织写作资产的 VS Code 小说写作增强扩展。它将传统的写作工具与现代编辑器技术完美结合，为小说创作者提供了一个功能强大、高度可定制的一站式写作环境。
✒️ 核心写作体验
智能统计与分析
小说助手提供全面的写作统计功能，帮助创作者更好地了解自己的写作状态：
- 实时字数统计：支持 CJK 字符与英文单词统计，提供多种统计标准（含标点/不含标点/词计）
- 写作速度监测：实时显示 CPM (每分钟字符数) 或 CPH (每小时字符数)
- 统计仪表板：可视化展示今日与历史写作时长、字数、平均速度及活跃度趋势
- 状态栏自定义：支持详细、半精简、精简三种显示模式
智能排版与辅助
为了让创作者专注于内容创作，小说助手提供了多项智能排版功能：
- 智慧回车：智能处理段落换行，自动调整格式
- 智慧括号：成对符号自动补全与快速跳出
- 自动空行：自动补充段间空行，保持版面整洁
- 版式设置：自定义段首/段尾标点规则，适应不同写作风格
- 错别字和语法检测：内置错别字和语法错误统计与识别功能
- LLM 智能校对：基于大语言模型的错别字检测、语法修正和文本润色功能，提供专业的写作质量保障
快捷设置面板
通过命令 andrea.quickSettings 或者状态栏按钮，可以快速唤起聚合菜单，无需深入 VS Code 设置即可调整常用写作选项：
- 排版与外观：快速切换自动换行、首行缩进、段间空行、小地图及滚轮缩放
- 字体管理：提供图形化的编辑器字体家族管理工具
- 智能辅助：一键启停智慧回车、智慧括号、智能分组锁
- 统计配置：调整字数统计单位、状态栏模式及里程碑提醒
- 规则管理：图形化管理
.wcignore忽略规则
🌍 设定集与世界观构建
统一对象模型 (Unified Object Model)
小说助手采用创新的统一对象模型来管理所有设定元素。无论是人物、敏感词、专有名词还是正则规则，本质上都是具有不同 type 属性的角色对象。
通用特性
- 全能别名支持：所有对象均支持定义别名 (Aliases)，在补全、高亮、引用查找时会自动识别主名与所有别名，并支持统一替换
- 代码级导航体验：
- 跳转到定义 (Go to Definition)：像查看代码定义一样，一键跳转到角色/词汇的源文件定义处
- 查看引用 (Find All References)：查找该角色在所有章节中的出现位置，支持列表跳转
- 智能补全与高亮：所有类型的对象均支持自动补全与文中高亮显示
- 可视化编辑：提供统一的图形化卡片编辑器
- 引用分析：支持引用索引、热力图与气泡图，分析对象在文档中的分布
多格式资源管理
小说助手通过"包"（Package）概念统一管理四大主资源类型：
| 资源 | 典型文件 | 支持格式 | 说明 |
|---|---|---|---|
| 角色 | character-gallery.json5 / *.md / *.txt | JSON5 / Markdown / TXT | 角色设定、别名、颜色、类型、扩展字段 |
| 敏感词 | sensitive-words.json5 / *.md / *.txt | JSON5 / Markdown / TXT | 内容安全或需要标识的词汇集合 |
| 词汇 | vocabulary.json5 / *.md / *.txt | JSON5 / Markdown / TXT | 世界观专有名词、术语表 |
| 正则规则 | regex-patterns.json5 | JSON5 | 自定义正则高亮/着色规则 |
包结构建议
推荐的组织结构：
novel-helper/
main/ # 主设定包（集中核心/跨包共享设定）
character-gallery.json5 # 主角色集合（结构化）
world_roles.md # 追加角色章节 (Markdown，多角色/字段)
sensitive-words.json5 # 敏感词
vocabulary.json5 # 词汇
regex-patterns.json5 # 正则规则
faction-a/ # 阵营 / 派系 A（局部角色或补充）
character-gallery.json5
faction-b/ # 阵营 / 派系 B
character-gallery.json5📂 项目与文件管理
写作资源管理器
替代原生资源管理器，提供专注的写作视图：
- 专注视图：仅显示写作相关文件，避免干扰
- 灵活排序：支持手动拖拽排序（生成稀疏索引）或自动排序
- 目录聚合：自动聚合计算目录下的总字数
- 文件追踪：基于分片数据库的高性能文件追踪系统
云端同步 (WebDAV)
支持多账户 WebDAV 同步，确保写作进度安全备份：
- 多账户支持：配置多个 WebDAV 账户
- 实时同步：状态栏实时显示同步进度与状态
- 可视化管理：独立的 WebDAV 文件树视图与同步控制面板
- 冲突处理：智能处理本地与云端文件冲突
项目配置
- 初始化向导：一键生成项目结构、配置文件及忽略规则（
.gitignore,.wcignore） - 项目配置文件：通过
anhproject.md管理项目元信息
🤖 自动化与扩展
用户脚本与 MCP 运行时
- 用户脚本系统：内置脚本运行器，允许用户编写自定义脚本扩展功能
- MCP (Model Context Protocol) 支持：
- 集成 MCP 运行时，可调用外部工具与服务
- 自动发布场景：结合浏览器自动化工具，可编写脚本实现章节自动发布到小说网站
- 侧边栏一键运行管理
Typst 排版导出
- 高质量输出：基于 Typst 引擎导出 PDF、图片（PNG/SVG）
- 模板系统：内置多种模板（如论坛体），支持自定义模板开发
- 智能转换：Markdown 语法自动转换为 Typst 格式，支持图片路径自动处理
📊 实时辅助功能
阅读与预览
- 侧边栏预览：支持 Markdown 和 TXT 格式的实时预览
- 个性化阅读：支持自定义预览界面的主题与字体设置
- 大纲视图：支持懒加载大纲生成，提供双重大纲辅助写作
批注系统
- 独立侧边栏：专用的批注管理视图，支持归总、跳转与快速处理
- 伏笔管理：便于记录和追踪剧情伏笔
LLM 智能辅助（润色和生成部分位于 ANH CHAT 附件中 不随小说助手本体提供 或者您可以使用任何 Code Agent 完成这部分工作）
集成大语言模型能力，为创作者提供智能化的写作辅助：
智能校对与润色：
- 错别字检测：基于 LLM 的智能错别字识别，比传统规则检测更准确 （本体集成）
- 语法修正：自动检测语法错误并提供修改建议 （本体集成）
- 文本润色：优化表达方式，提升文字质量和可读性 （附加组件 Anh Chat 提供）
- 风格建议：根据小说类型提供风格化的修改建议 （附加组件 Anh Chat 提供）
多语言翻译：基于大模型的快速翻译工具，支持替换选区或复制结果，帮助创作者进行多语言创作 （本体集成）
内容生成辅助： （附加组件 Anh Chat 提供）
- 情节建议：根据当前内容提供情节发展建议
- 角色对话生成：生成符合角色性格的对话内容
- 场景描写：提供场景描写的参考和建议
🎯 核心优势
1. 统一的工作环境
在熟悉的 VS Code 环境中完成所有写作工作，无需切换多个应用程序。
2. 智能化的辅助功能
从自动补全到错误检测，从统计分析到格式化，特别是集成的 LLM 智能校对和润色功能，全方位提升写作效率和质量。
3. 强大的数据管理
"统一对象模型"让角色、词汇、敏感词等所有设定都能得到统一管理和高效检索。
4. 高度可定制性
支持用户脚本、自定义模板、个性化设置等，满足不同创作者的特殊需求。
5. 现代化的技术栈
基于 VS Code 扩展平台，享受现代化的编辑器技术和生态系统。
🆚 与传统写作软件对比
小说助手坚持"稿件可见宣言"，与传统闭源写作软件相比具有显著优势：
| 特性维度 | Andrea Novel Helper (开源) | 传统闭源写作软件 | 优势说明 |
|---|---|---|---|
| 数据存储 | Markdown/TXT/JSON5 (开放格式) | 私有数据库/封闭格式 | 文件可被记事本直接打开，完全掌控数据 |
| 备份与迁移 | Git/压缩包/U 盘/网盘 (自由选择) | 官方迁移工具 (依赖厂商) 或者根本不提供 | 无需特定工具，备份随心所欲 |
| 版本控制 | 原生支持 Git，完整的版本历史 | 有限版本控制或无 | 专业级的版本管理，支持分支和合并 |
| 协作能力 | Git 协作，透明审阅，可 diff | 专有协作系统 (锁定生态) | 开放的协作流程，不限工具和平台 |
| IDE 级辅助 | 智能补全、语法高亮、跳转定义、引用分析 | 基础编辑功能 | 享受现代 IDE 的强大辅助功能 |
| 定制扩展 | 用户脚本、MCP、VS Code 生态 | 有限插件或无 | 无限扩展可能性，社区驱动 |
| 云同步 | WebDAV/Git (自由选择服务商) | 官方云服务 (锁定) | 可选择任何兼容的云存储服务 |
| 数据安全 | 数据完全本地，可选择在线服务 | 数据存储在厂商服务器 | 完全掌控数据流向和隐私安全 |
| 成本费用 | 完全免费 (开源 MPL-2.0) | 订阅制或一次性购买 | 零成本使用，无功能限制 |
| 技术支持 | 社区支持 + 开源透明 | 官方支持 (依赖厂商响应) | 透明的源码，社区共同维护 |
| 平台锁定 | 跨平台 (VS Code 支持) | 可能限制特定平台 | 任何支持 VS Code 的平台都能使用 |
稿件可见宣言
我们主张：稿件一定要可读、可备份、可协作、可迁移；文件一定要归创作者所有，不做技术人质。
- 稿件一定要能被记事本直接打开与编辑
- 文件一定要用普通格式保存（Markdown / TXT / JSON5）
- 备份一定要随手可做（Git / 压缩包 / U 盘 / 网盘）
- 协作一定要透明（可 diff / 可审阅 / 可回滚）
- 迁移一定要不设门槛（换工具不做"迁移仪式"）
小说助手坚持开放文件与透明模型，拒绝私有封闭格式，让创作真正掌握在创作者手中。
🚀 快速开始
安装扩展
- 在 VS Code 扩展市场中搜索 "Novel Helper"
- 或访问 VS Code Marketplace
- 点击安装，或选择安装合集获得完整功能
创建新项目
- 打开命令面板（Ctrl+Shift+P）
- 搜索并执行 "Andrea Novel Helper: Initialize Project"
- （前两步若您打开新空白工作区 可自动弹出向导）
- 按照向导提示配置项目信息
- 自动生成项目结构和配置文件
基本使用流程
- 创建角色库：在包管理器中创建
character-gallery.json5或.md文件 - 添加角色设定：使用可视化编辑器或直接编写 Markdown/JSON5
- 开始写作：在章节文件中享受智能补全和高亮功能
- 查看统计：通过统计面板监控写作进度
- 导出作品：使用 Typst 或者纯文本渲染器 导出功能生成高质量文档
📈 发展历程
小说助手持续快速发展，近期重要更新包括：
- v0.4.35 (2025-11-21)：支持快捷翻译和并行缓存校验
- 大幅重构异步加载与性能管线：提升整体性能和响应速度
- 独立组件发布：Anh Chat (小说助手聊天组件) 独立发布，提供生成式 AI 功能
💬 社区与支持
- GitHub Issues：提交问题报告和功能请求
- QQ 群：小说助手用户反馈和交流
- Discord：加入社区讨论
- GitHub Discussions：功能建议和经验分享
📄 许可证
本项目采用 MPL-2.0 许可证，允许自由使用、修改和分发。
Andrea Novel Helper 不仅仅是一个写作工具，它是现代技术与创作艺术的完美结合，为每一位小说创作者提供强大的创作支持。无论你是初出茅庐的新人，还是经验丰富的老手，都能在这里找到适合自己的创作方式。
立即体验，开启你的高效创作之旅！ ✨