Andrea Novel Helper 用户指南
⚠️ 免责声明
本文档由 GLM4.7 自动生成，内容可能存在错误或不完整之处。 请以人工书写的官方文档为准。
本文档仅作为参考，建议结合源码和官方文档一起使用。
欢迎使用 Andrea Novel Helper（小说助手）！这是一个专为小说作者设计的 VS Code 扩展，提供了从写作辅助到项目管理的全方位支持。
新手入门
如果你是第一次使用，建议按以下顺序阅读：
了解产品
- 产品介绍 - 全面了解 Andrea Novel Helper 的功能与优势
安装配置
功能列表
📁 侧边栏功能
侧边栏位于 VS Code 左侧，提供了项目管理的主要功能。
| 功能 | 说明 | 文档链接 |
|---|---|---|
| 字数统计 | 实时统计章节字数，支持手动排序 | 查看详情 |
| 角色管理 | 管理小说角色，支持卡片视图编辑 | 查看详情 |
| 包管理器 | 管理角色/设定包，支持导入导出 | 查看详情 |
| 大纲视图 | 双重大纲系统，快速导航章节 | 查看详情 |
| WebDAV 同步 | 云端备份与多设备同步 | 查看详情 |
| AutoGit | 自动 Git 提交与版本管理 | 查看详情 |
| 批注管理 | 添加批注和伏笔标记 | 查看详情 |
| 脚本运行器 | 运行自定义脚本 | 查看详情 |
| 设置 | 快速访问扩展设置 | 查看详情 |
📊 状态栏功能
状态栏位于 VS Code 底部，提供了实时状态信息。
| 功能 | 说明 | 文档链接 |
|---|---|---|
| 写作统计 | 显示今日/本周写作字数和速度 | 查看详情 |
| 版式信息 | 显示当前段落的字数统计 | 查看详情 |
| 同步状态 | 显示 WebDAV/Git 同步状态 | 查看详情 |
| 智能标签组锁 | 显示标签组锁定状态 | 查看详情 |
✏️ 编辑器功能
编辑器中的辅助功能，让写作更流畅。
| 功能 | 说明 | 文档链接 |
|---|---|---|
| 智能回车 | 自动处理段落换行和缩进 | 查看详情 |
| 自动配对 | 自动补全引号、括号等符号 | 查看详情 |
| 角色高亮 | 自动高亮文档中的角色名称 | 查看详情 |
| 错别字检测 | 自动检测常见错别字 | 查看详情 |
| 自动补全 | 智能补全角色名称和词汇 | 查看详情 |
| 格式化 | 一键格式化文档排版 | 查看详情 |
🎯 命令面板功能
通过命令面板（Ctrl+Shift+P / Cmd+Shift+P）访问的功能。
| 功能 | 说明 | 文档链接 |
|---|---|---|
| 名字生成器 | 随机生成各种风格的角色名字 | 查看详情 |
| Typst 导出 | 将小说导出为排版精美的 PDF | 查看详情 |
| 数据库管理 | 管理扩展的内部数据库 | 查看详情 |
| 关系管理 | 管理角色之间的关系 | 查看详情 |
🖼️ 独立视图
独立的可视化编辑器和预览窗口。
| 功能 | 说明 | 文档链接 |
|---|---|---|
| 角色卡片编辑器 | 可视化编辑角色信息 | 查看详情 |
| 关系图编辑器 | 可视化编辑角色关系 | 查看详情 |
| 时间线编辑器 | 管理故事时间线 | 查看详情 |
| 预览面板 | 预览 Typst 渲染效果 | 查看详情 |
| 热力图 | 可视化角色引用分布 | 查看详情 |
按使用场景查找
我想...
- 📝 开始写小说 → 基础工作流程
- 👥 管理角色 → 角色管理
- 📊 统计字数 → 字数统计
- ☁️ 备份到云端 → WebDAV 同步
- 📖 查看大纲 → 大纲视图
- 🎨 美化排版 → 格式化
- 📝 生成名字 → 名字生成器
- 📄 导出 PDF → Typst 导出
- ✏️ 添加批注 → 批注管理
- 🔗 管理关系 → 关系图编辑器
功能索引
A-C
D-F
G-L
M-O
P-R
S
T-Z
- 同步状态 - 状态栏功能
- 时间线编辑器 - 独立视图
- Typst 导出 - 命令面板功能
- 版式信息 - 状态栏功能
- 错别字检测 - 编辑器功能
- 字数统计 - 侧边栏功能
- WebDAV 同步 - 侧边栏功能
- 预览面板 - 独立视图
- 热力图 - 独立视图
常见问题
找不到功能？
- 确认扩展已启用（检查扩展图标是否亮起）
- 查看侧边栏是否有相关图标
- 使用命令面板（Ctrl+Shift+P）搜索功能
- 查看设置文档确认功能是否开启
需要帮助？
快捷键参考
| 快捷键 | 功能 |
|---|---|
Ctrl+Shift+P | 打开命令面板 |
Enter | 智能回车（需启用） |
Tab | 接受自动补全建议 |
Esc | 关闭当前打开的面板 |
💡 提示：你可以在 VS Code 的键盘快捷方式设置中自定义这些快捷键。
版本日志
查看历史版本的更新说明：
资源文件
Typst 模板
- Typst 小说模板 - 适用于小说排版的 Typst 模板