Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>Noveler - 中文小说写作助手New to Visual Studio Code? Get it now.
Noveler - 中文小说写作助手

Noveler - 中文小说写作助手

chang

|
1,144 installs
| (1) | Free
专为中文小说写作设计的 VS Code 插件,提供语法高亮、格式化、字数统计等功能
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Noveler - 中文小说写作助手

专为中文小说写作设计的 VS Code 插件,让创作更专注、更高效。

📑 目录

  • ✨ 核心特性
  • 🎛️ 侧边栏视图
  • 🚀 核心功能
    • 📝 语法高亮
    • 📊 字数统计
    • 🎨 智能格式化
    • 🛡️ 敏感词检测
    • 📚 分卷管理
    • ✍️ 随机起名
  • 📌 写作待办
    • 📂 项目管理
    • 🖋️ 写作辅助
  • ⚡ 快速开始
  • 📄 文件格式
  • 小说导出
  • ⚙️ 配置
  • 🎮 常用命令
  • ❓ 常见问题
  • 🎉 版本亮点
  • 🤝 贡献
  • 📜 开源协议
  • 📞 联系方式

✨ 核心特性

  • 📝 语法高亮 - 对话、人物名称自动高亮,内容一目了然
  • 📊 精准字数 - 符合网文标准的实时字数统计
  • 🛡️ 敏感词检测 - 三级词库自动检测,规避审核风险
  • 📚 分卷管理 - 支持多卷结构,适合长篇创作
  • ✍️ 随机起名 - 7 种风格,数千种组合,一键生成角色名
  • 🎨 智能格式化 - 标点、引号、空格自动规范
  • 👁 护眼模式 - 低饱和度暖灰绿主题,保护视力
  • 📱 手机预览 - 仿真 iPhone 阅读效果,实时同步编辑内容
  • 📌 写作待办 - 随手标记疑问和待处理内容,侧边栏统一收束管理
  • 小说导出 - 全书合并 TXT,自选保存位置和文件夹名称,保护原稿

Noveler 主界面预览


🎛️ 侧边栏视图

点击左侧活动栏的 📖 图标打开 Noveler 侧边栏,这是插件的主要操作界面。

侧边栏完整视图

项目概览

  • 显示小说名称、总字数、章节数
  • 一键访问配置文件
  • 快速更新 README

章节管理

  • 查看所有章节及状态(📝草稿 | ✏️初稿 | 🔧修改中 | ✅已完成)
  • 右键章节:复制正文、重命名、标记状态、删除
  • 鼠标悬停显示详细字数统计
  • 分卷支持:创建卷、在卷内创建章节、移动章节

人物设定

  • 创建人物、设置定位和管理别名,均可通过鼠标操作。
  • 列表只显示姓名,按定位排序;使用说明见人物管理。
  • 随机起名:生成多种风格的角色名。

快捷操作

  • 刷新视图(README 更新受配置开关控制)
  • 章节和人物标题上方可点击“格式化”;Markdown 编辑器右上角及右键菜单也提供入口
  • 专注设置位于“项目设置 → 快速设置”

工具与设置

  • 写作工具:导出小说、使用指南、统计仪表板、手机预览、随机起名
  • 更新后首次打开小说项目会提醒一次;点击“查看更新”了解改动,也可在使用指南中点击“查看版本更新”随时查看。
  • 项目设置:快速设置、敏感词库配置、重新加载敏感词库、打开配置文件
  • 护眼、专注和章节编号等选项可在快速设置中调整
  • 结构迁移:点击「项目概览」中的「项目模式」,或使用命令面板中的迁移和回滚命令

🚀 核心功能

📝 语法高亮

自动高亮对话和人物名称,让小说内容层次分明。

  • 支持常见成对引号:「」、『』、直双引号、直单引号、弯双引号和弯单引号;支持嵌套,忽略英文单词中的撇号
  • 自动读取 characters/ 目录和配置文件中的人物名称
  • 可自定义高亮颜色和样式

字数统计


📊 字数统计

符合网文标准的实时统计,状态栏显示 总计 | 正文 | 标点。

特点:

  • ✅ 实时更新,选中文本单独统计
  • ✅ 全文统计排除 Front Matter、整行标题和 HTML 注释;选中统计保留标题
  • ✅ 侧边栏悬停查看详细统计
  • ✅ 保存时更新已有的 wordCount 字段
  • ✅ 分卷模式下显示所属卷信息

统计规则:

  • 总计 = 正文 + 标点(不含空格)
  • 正文 = 中文汉字 + 英文字母和数字
  • 标点 = 中文标点 + 英文标点

🎨 智能格式化

一键规范标点、引号、空格,让文稿更专业。

  • 引号统一:自动转换中英文引号为配置的样式
  • 标点规范:统一中文标点符号(双向转换)
  • 空格处理:删除中文之间多余的空格
  • 特殊符号:统一省略号(…)和破折号(——)

入口:章节和人物档案标题上方的“格式化”,或 Markdown 编辑器右上角的格式化图标、编辑器右键菜单。草稿、参考资料以及没有标题的文档也可以使用后两种入口。

💡 Front Matter 和 HTML 注释内容不会被格式化


🛡️ 敏感词检测

三级词库系统,自动检测敏感词汇,帮助规避审核风险。

三级词库:

  • 高危:政治、严重暴力、严重违法(推荐启用)
  • 中危:色情、一般违法、宗教敏感(推荐启用)
  • 低危:广告、争议词汇、不文明用语(可选启用)

检测方式:

  • ⚡ 输入时自动检测(防抖 500ms)
  • 💾 保存时再次检查
  • 📊 状态栏显示敏感词数量

可视化标注:

  • 黄色波浪线标记敏感词
  • 问题面板显示详细信息
  • 悬停查看词汇等级和建议

敏感词检测

快速修复:

  • 添加到白名单(如人物名、专有名词)
  • 删除敏感词
  • 替换为星号(***)
  • 忽略本文件中的该词(当前会话)

自定义词库:支持项目级黑名单和白名单配置


📚 分卷管理

支持多卷结构,适合长篇小说创作。

功能:

  • 📖 创建卷:在侧边栏点击创建,支持正文/前传/后传/番外
  • 📝 章节管理:在卷内创建章节,移动/复制章节到其他卷
  • 🔄 结构迁移:一键从扁平结构迁移到分卷,支持回滚
  • 📊 统计显示:状态栏显示当前章节所属卷及统计信息

卷类型:

  • 正文:主线剧情
  • 前传:故事发生前的剧情
  • 后传:主线之后的延续
  • 番外:独立的特别篇章

章节编号模式:

  • 全局连续:所有章节连续编号(第 1 章、第 2 章...)
  • 按卷重置:每卷独立编号
  • 混合模式:正文卷全局编号,前传、后传和番外独立编号

这些设置控制新章节编号,切换模式不会自动重排已有章节。

迁移保护:

  • 迁移前检查同名章节冲突,自动保存相关文档并创建临时备份;校验成功后清理备份。
  • 操作失败会尝试恢复,恢复不完整时保留备份并提示路径。
  • 回到扁平结构仅将章节移到 chapters/ 根目录,卷大纲、元数据和附属文件保留在原卷目录。
  • 再次分卷可复用原卷目录,按本次选择重新分配章节;已有卷资料不覆盖。

✍️ 随机起名

一键生成角色名,7 种风格任选。

风格选择:

  • 🇨🇳 中文现代:常见姓氏 + 现代名字
  • 🏮 中文古典:单字名、双字名、雅致字
  • ⚔️ 中文玄幻:仙侠、玄幻命名规则
  • 🇬🇧 英文名:First Name + Last Name
  • 🇯🇵 日文名:日式姓氏 + 名字
  • 🏰 西幻名:奇幻风格命名
  • 🌀 虚构名:完全虚构的独特名字

智能交互:

  • "再来一组"快速生成更多选项
  • 创建人物文件
  • 复制到剪贴板
  • 插入到光标位置

名字库:数百个精选名字,组合可能性达数千至数万


📱 手机阅读预览

模拟手机屏幕预览小说阅读效果,实时同步编辑内容。

仿真外观:

  • iPhone 15/16 Pro 尺寸(393×852)
  • 灵动岛、侧边按钮、状态栏等细节还原
  • 4 种阅读主题:日间、夜间、羊皮纸、护眼绿

阅读设置:

  • 字号调整(14-24px)
  • 行距调整(1.5-2.5)
  • 字体切换(系统、宋体、黑体)
  • 设置自动保存

智能同步:

  • 编辑内容实时更新预览
  • 光标位置自动高亮对应段落
  • 智能滚动跟随(底部编辑时自动跟随,中间阅读时保持位置)
  • 对话内容自动高亮

入口:

  • 侧边栏「工具与设置」→「写作工具」→「手机预览」
  • 命令面板:Noveler: 手机阅读预览

📌 写作待办

写作过程中随手标记疑问和待处理内容,侧边栏统一收束,提醒自己稍后回头解决。

使用方法:

  1. 在任意 Markdown 文件中,将光标移到需要标记的位置
  2. 按 Ctrl+Shift+/,输入待办内容,回车确认
  3. 该行末尾自动插入 <!--? 内容 --> 标记,行内装饰高亮提示

侧边栏:

  • 「写作待办」节点展示所有标记,按文件分组,显示待处理 / 总计数量
  • 点击条目直接跳转到对应文件和行
  • 条目右键:标记为已完成 / 重新打开 / 删除
  • 根节点右键:筛选显示(全部 / 仅待处理)、批量完成、批量删除已完成

编辑器内:

  • 待处理行显示橙色左边框
  • 已完成行半透明置灰
  • 标记行上方显示 CodeLens 快捷操作:$(bookmark) 写作待办 $(check) 标记已完成 $(trash) 删除

标记语法:

状态 语法
待处理 <!--? 内容 -->
已完成 <!--✓ 内容 -->

标记不计入正文统计,普通 Markdown 预览和手机预览均隐藏 HTML 注释。

完成待办默认将 <!--? ... --> 改为 <!--✓ ... -->,可重新打开。 已完成标记会淡化显示,同行正文保持正常显示。 同一行可包含多条待办,侧边栏逐条显示,标题操作栏会带上对应内容;完成、重新打开和删除只处理点击的那一条。 在 novel.jsonc 的 noveler 下设置 "doubtMark": { "deleteOnResolve": true },单项和批量完成时自动删除待办标记,保留同行正文;不填写或设为 false 时保留已完成标记。


📂 项目管理

快速创建和组织你的小说项目。

初始化项目:一键创建标准的小说项目结构

my-novel/
├── chapters/       # 章节目录
├── characters/     # 人物目录
├── drafts/         # 草稿和大纲
├── references/     # 参考资料
├── novel.jsonc     # 小说配置
└── README.md       # 项目说明

删除与恢复:章节和人物的右键删除会先保存未保存内容,再移入系统废纸篓。保存或移入失败时停止;成功提示可点击“定位恢复目录”,将文件从废纸篓拖回后刷新。

创建章节:

  • 自动计算章节序号(支持中文数字:第一章、第十章、第一百章等)
  • 带有完整 Front Matter 的标准章节模板
  • 自动组织到 chapters/ 目录

人物管理:

点击人物分组的加号创建档案;已有档案可从标题附近或侧栏右键菜单设置定位、管理别名。

定位顺序 图标
主角 实心五角星
重要配角 实心方形
次要配角 实心三角形
路人 实心圆形

图标统一使用主题默认颜色。同级按姓名排序,未设置或自定义定位排在最后并使用实心圆形。列表只显示姓名,悬停可看定位、身份和别名;修改定位后立即更新顺序与图标,无需先保存。

修改提示中可点击“撤销”。若档案随后有新修改,旧撤销提示会停止,避免覆盖新内容;也可打开人物档案,使用“编辑 → 撤销”。旧档案首次设置时自动补充定位字段。

“管理别名”中输入后回车添加,条目按钮可修改、删除;本名和别名共同参与正文高亮。取消创建人物时不会生成档案。

README 自动更新:

  • 扫描章节目录,统计总字数和完成章节数;只有状态为“已完成”的章节计入完成数,字数不改变状态,大纲和卷说明不计入章节
  • 自动生成章节列表(带状态图标)
  • 自动扫描并分类展示人物

🖋️ 写作辅助

更多实用功能,提升写作体验。

  • 自动空行:按回车时自动插入空行,保持段落间距
  • 段落缩进:自动添加两个全角空格缩进
  • 智能引号:章节正文输入左引号或书名号后自动补齐,光标留在中间;Tab 跳出当前符号,重新编辑旧对话也可使用。支持 “”、「」、‘’、『』、《》、〈〉、英文单双引号;单词中的撇号保持原样。可在“快速设置 → 智能引号”关闭。
  • 专注模式:打开专注模式设置后,选择“一键专注”或“Zen Mode”
  • 护眼模式:一键切换护眼主题,低饱和度暖灰绿背景,保护视力(仅当前项目生效)
  • 项目级配置:初始化时自动创建 .vscode/settings.json(自动保存、格式化等)
  • 输入验证:创建章节和人物时自动过滤非法字符

⚡ 快速开始

1. 安装插件

在 VS Code 扩展市场搜索 "Noveler" 并安装。

或按 Cmd+Shift+X (Mac) / Ctrl+Shift+X (Windows/Linux) 打开扩展面板。

2. 打开侧边栏

点击左侧活动栏的 📖 图标,打开 Noveler 侧边栏。

3. 新建小说项目

在欢迎页或侧边栏点击“新建小说项目”。未打开文件夹时,先点击“选择小说文件夹”,打开后再次点击“新建小说项目”,输入小说名称并选择按章节或按卷组织。

插件会自动创建标准的小说项目结构,包括:

  • 📁 项目目录(chapters, characters, drafts, references)
  • 📝 配置文件(novel.jsonc)
  • ⚙️ VSCode 项目配置(.vscode/settings.json)
    • ✅ 自动保存(默认 2 秒延迟;已有设置保留原值)
    • ✅ 文件格式化(自动清理行尾空格)
    • ✅ Markdown 预览优化
    • ✅ 仅对当前项目生效,不影响其他项目

4. 创建章节

在侧边栏"章节管理"组点击 ➕ 按钮,输入章节名称(如"陨落的天才")。

章节号会自动计算和添加。

5. 开始写作

打开章节文件,享受语法高亮和实时字数统计!

💡 提示:也可以使用命令面板(Cmd/Ctrl+Shift+P)输入"Noveler"查看所有命令。


📄 文件格式

章节文件示例

---
title: "初入江湖"
chapter: 1
wordCount: 0
status: "draft"  # draft | first-draft | revising | completed;兼容中文状态
---

# 第一章 初入江湖

清晨的阳光透过窗棂洒在青石板上。

「师父,我想下山。」张无忌低声说道。

关键字段:

  • title: 章节标题
  • chapter: 章节号
  • wordCount: 字数(字段存在时,保存自动更新)
  • status: 状态(影响侧边栏图标)

📖 完整字段说明请查看 文件格式文档


人物文件示例

---
name: "张无忌"
gender: "男"
importance: "主角"
---

# 张无忌

## 基本信息
...

## 外貌描写
...

关键字段:

  • name: 人物名称
  • importance: 主角 | 重要配角 | 次要配角 | 路人
  • firstAppearance: 首次登场章节

小说导出

在侧边栏“写作工具 → 导出小说”,选择小说项目之外的保存位置,并确认导出文件夹名称(默认“书名-导出”)。成功后可直接打开 TXT 或所在文件夹。同名目录建议新名称,保留历次结果。

首版仅支持本机项目的全书合并 TXT,UTF-8 编码;包含草稿及未保存修改,去除章节属性和注释、转换常用 Markdown 标记,保留卷章标题、正文与标点,普通正文统一使用两个全角空格缩进;标题、列表、表格和代码块保留各自排版。无需提前格式化章节,导出不保存、不格式化原稿。卷号跟随分卷编号格式配置:阿拉伯数字为“第1卷”,中文数字为“第一卷”,罗马数字为“第I卷”;导出卷号不补零,原目录名称保持不变。

章节必须有正整数字段 chapter,并符合当前全局/卷内/混合编号模式。缺号、重复、归属异常、属性损坏或读取失败时停止,可点击提示打开问题文件;导出期间原稿或目录变化时也会停止。空正文、待办和图片/表格等会提醒,确认后可继续。TXT 不包含图片,表格按文字保留。

复制当前章节正文

点击章节标题上方的“复制正文”,或在章节编辑器、侧边栏章节上右键选择“复制正文”,即可粘贴到小说平台的正文输入框。

包含未保存修改,去掉章节开头的一级标题、属性和注释,正文排版与 TXT 导出一致;保留后续小标题。复制不会保存、格式化或修改原稿。正文为空、属性损坏或注释未闭合时停止,保留原剪贴板;图片只保留说明文字,复制成功后提示。

TXT 是阅读与发布书稿,不是完整项目备份。单章、单卷、其他格式及导入按 开发计划 分阶段实现。


⚙️ 配置

核心配置

在项目根目录的 novel.jsonc 文件中配置(侧边栏可一键打开):

{
  "name": "我的小说",
  "noveler": {
    "targetWords": {
      "default": 2500
    },
    "sensitiveWords": {
      "enabled": true,
      "builtInLibrary": {
        "enabled": true,
        "levels": {
          "high": true,
          "medium": true,
          "low": false
        }
      }
    },
    "autoEmptyLine": {
      "value": true
    },
    "paragraphIndent": {
      "value": true
    },
    "autoUpdateReadmeOnCreate": {
      "value": "always"
    },
    "volumes": {
      "enabled": true,
      "folderStructure": "flat",
      "chapterNumbering": "volume",
      "numberFormat": "arabic"
    },
    "characters": {
      "list": []
    },
    "highlight": {
      "dialogue": {
        "color": "#ce9178"
      },
      "character": {
        "color": "#4ec9b0",
        "fontWeight": "bold"
      }
    },
    "format": {
      "chineseQuoteStyle": "「」",
      "convertQuotes": true,
      "smartQuotes": true
    }
  }
}

📖 完整配置说明请查看 novel.jsonc 配置文档

自动保存和保存时格式化

这两项由项目的 .vscode/settings.json 控制:

{
  "files.autoSave": "afterDelay",
  "files.autoSaveDelay": 2000,
  "[markdown]": {
    "editor.defaultFormatter": "chang.chinese-novel-writer",
    "editor.formatOnSave": true
  }
}

初始化只补充缺失设置,保留已有值。如果原项目配置了 files.autoSave: "off",初始化后仍为关闭。 noveler.autoSave 不生效;noveler.format.autoFormat 当前未接入保存事件。

README 更新范围

插件更新 ## 目录、## 写作进度、## 人物设定 各自的区段,到下一个二级标题或文件末尾为止。区段内的手写内容会被替换,其他区段保留。 代码块和注释内的标题不参与定位;重复的管理标题会停止更新。未保存备注会保留,更新可撤销。 自定义说明请放在这些区域之外,建议放在 ## 备注 下。 noveler.autoUpdateReadmeOnCreate.value 为 never 时,“刷新”也会跳过 README 更新;改回 always 后再刷新。


🎮 常用命令

命令 说明 快捷方式
Noveler: 新建小说项目 在空文件夹中初始化项目结构 侧边栏按钮
创建章节 创建新章节文件 侧边栏 ➕
创建人物 创建人物文件 侧边栏 ➕
Noveler: 随机起名 随机生成角色名 侧边栏按钮
Noveler: 导出小说为 TXT 全书合并 TXT,选择保存位置和文件夹名称 写作工具 → 导出小说
Noveler: 格式化文档 格式化当前文档 标题按钮、编辑器右上角、右键菜单
Noveler: 刷新 刷新侧边栏和统计信息 侧边栏按钮
Noveler: 切换专注模式 打开专注设置菜单 命令面板
Noveler: 添加写作待办 在当前行插入待办标记 Ctrl+Shift+/

💡 提示:按 Cmd/Ctrl+Shift+P 打开命令面板,输入 "Noveler" 查看所有命令


❓ 常见问题

Q: 如何打开侧边栏? A: 点击左侧活动栏的 📖 图标,或使用命令 查看: 打开侧边栏。

Q: 字数统计包含标点吗? A: 包含。总计 = 正文(汉字+字母+数字)+ 标点。符合网文计费标准。

Q: 敏感词检测会影响性能吗? A: 防抖和 Trie 树减少重复检测,但大文件和词库规模仍会影响性能。

Q: 如何切换到分卷结构? A: 点击侧边栏“创建卷”后按提示切换,插件通过迁移向导整理已有章节;空项目可直接切换后创建第一卷。也可使用命令 Noveler: 迁移到分卷结构。支持回滚。

Q: 格式化会修改我的内容吗? A: 不会修改文字,只调整标点符号和空格。Front Matter 和注释不受影响。

Q: 为什么我的人物名称没有高亮? A: 确保人物文件在 characters/ 目录下,或在 novel.jsonc 的 noveler.characters.list 数组中添加名称。

Q: 自动空行和段落缩进冲突吗? A: 不冲突。可以同时启用:自动空行负责段落间隔,段落缩进负责每段开头。

更多问题请访问 FAQ 文档 或 提交 Issue


🎉 版本亮点

当前版本 v1.4.0

  • 复制正文:章节操作行和右键菜单一键复制发布用正文,包含未保存修改,去掉章节标题、属性和注释,原稿保持不变。

v1.3.0

  • 智能引号:章节正文自动补齐引号、书名号,Tab 跳出,快速设置可关闭。
  • 对话高亮:完整识别嵌套引号,英文缩写中的撇号不再误判为对话。
  • 引号样式:正确区分弯、直双引号与直角引号。

v1.2.0

  • 全书 TXT 导出:侧边栏选择位置和文件夹名,包含未保存正文,保留原稿。
  • 导出保护:校验章节号和归属,目录不覆盖,原稿变化或写入失败时停止。
  • 稳定排序:修复异常章节混合时卷内排序不稳定。

v1.1.2

  • 完成度统计:只有手动标为已完成的章节才计入完成数,与字数无关。
  • 分卷切换:创建卷时使用迁移向导整理已有章节,空项目也可切换。
  • 词库刷新:自定义路径和 JSON/JSONC 后备词库保存后自动生效。

v1.1.1

  • 配置保护:保留未保存修改,连续设置按顺序保存。
  • 旧项目升级:修复安装包内升级,保留原设置与注释。
  • 删除恢复:章节和人物移入废纸篓,保存失败时停止。

v1.1.0

  • 人物定位:按重要性排序,图形区分,支持鼠标修改和撤销。
  • 新建引导:空列表直接创建,未打开文件夹时提供选择入口。
  • 配置与识别修复:新建项目准确应用组织方式,同名章节识别实际所属卷。

v1.0.1

  • 敏感词操作安全:正文变化后停止过期的删除、替换操作。
  • 词库编辑保护:保留未保存修改、注释和原有词条,支持撤销。
  • 人物高亮:修复生僻字漏匹配及并发刷新时使用旧别名的问题。

v1.0.0

  • 人物别名:输入后回车添加,支持修改、删除和正文高亮。
  • 鼠标操作入口:人物格式化、使用指南等常用功能更容易找到。
  • 更新介绍:按版本展示新增和修复,支持跨版本升级汇总。
  • 写作与资料保护:改善待办、格式化、重命名、章节迁移和 README 更新的安全性。

v0.8.8

  • 📌 写作待办:Ctrl+Shift+/ 随手标记,侧边栏统一收束管理,支持 CodeLens 快捷操作

v0.8.6

  • 优化快速设置 UI,配置项按分组展示,交互更一致
  • 侧边栏「工具与设置」拆分为「写作工具」和「项目设置」两级分组
  • 侧边栏节点图标全面换用 ThemeIcon,随主题明暗自动切换
  • 修复 CodeLens 进度图标损坏(显示为两个问号)

v0.8.5

  • 修复分卷模式下章节创建的多个问题(不打开编辑器、targetWords 不读配置、编号重复)
  • 修复自动空行持续触发导致文件不断增加换行的问题
  • 修复手机预览中单换行不显示段落分隔的问题
  • 提取章节创建公共逻辑,消除重复实现

v0.8.4

  • 🎵 打字音效(7 种内置音效 + 自定义音效文件,默认关闭)

v0.8.0 ~ v0.8.3

  • 📱 手机阅读预览(仿真 iPhone 外观,4 种主题,实时同步光标段落)
  • 👁 护眼模式(低饱和度暖灰绿主题,项目隔离不影响其他工作区)
  • 🚀 性能优化(Trie 树人物高亮、配置加载竞态修复、字数统计缓存)

v0.7.0

  • 🎉 新手欢迎页面
  • ⚙️ 快速设置面板(一键切换常用功能开关)

后续计划

  • 📥 批量导入已有章节文件(txt 批量导入并自动生成 Front Matter)
  • 🤖 AI 写作助手集成
  • 📈 写作目标跟踪
  • 🔄 更丰富的导出格式(EPUB、PDF)

完整更新历史请查看 CHANGELOG.md


🤝 贡献

欢迎提交 Issue 和 Pull Request!

开发和验证命令:

npm ci
npm run compile
npm run lint
npm run test:unit
npm test
npm run package:vsix

test:unit 在 Node 中运行单元测试;npm test 先运行单元测试,再启动真实 VS Code 扩展宿主运行集成测试,需桌面环境,同一用例不会重复执行。 npm run test:coverage 统计 Node 单元测试覆盖率,不代表宿主集成测试或界面覆盖率。 npm run test:package 在临时目录生成并解包 VSIX,启动真实 VS Code 检查打包版本的激活、命令、资源及旧项目升级;不会覆盖 releases 中的交付包。此检查也在 GitHub CI 中运行,需桌面环境和 unzip。 package:vsix 检查插件图标尺寸并生成 releases/Noveler-版本号.vsix,不默认生成 SHA-256 文件。图标的宽、高均不得超过 1024 像素。打包成功后保留最近三个版本,同版本覆盖;失败时保留原包和历史包。日常开发使用编译调试,安装验收或发布时再生成安装包。 可以设置 NOVELER_TEST_VSCODE_EXECUTABLE 指向本机 VS Code 可执行文件;未设置时测试工具会下载 VS Code。 macOS 的受限沙箱无法用于启动图形测试宿主,测试脚本会提前报错,避免触发 Electron 崩溃弹窗。此时从桌面终端运行扩展宿主测试;test:unit 可在受限环境中运行。 手动调试可点击“运行 → 启动调试”,运行后可点击“运行 → 重启调试”;启动目录见 .vscode/launch.json。

  1. Fork 本仓库
  2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开一个 Pull Request

📜 开源协议

MIT License


📞 联系方式

  • GitHub: https://github.com/ChangFang911/vscode-plugin-noveler
  • Issues: 提交问题
  • 讨论: GitHub Discussions

Happy Writing! 祝写作愉快! ✍️

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft