novelws 1.2.0

package/plugins/export/commands/metadata.md

@@ -0,0 +1,309 @@
+---
+title: 元数据管理 - /metadata
+description: 编辑小说元数据（书名、作者、简介等），用于导出和发布
+---
+
+# 元数据管理
+
+## 使用方法
+
+```bash
+/metadata [子命令] [选项]
+```
+
+### 基本用法
+
+```bash
+/metadata init                     # 从 specification.md 自动提取元数据
+/metadata show                     # 查看当前元数据
+/metadata edit                     # 交互式编辑
+/metadata set title "新书名"       # 设置单个字段
+/metadata validate                 # 验证元数据完整性
+```
+
+---
+
+## 子命令
+
+### /metadata init
+
+从 `stories/[name]/specification.md` 自动提取元数据，生成 `metadata.json`。
+
+```
+/metadata init
+      |
+读取 specification.md：
+  - 提取书名（标题）
+  - 提取简介（description 部分）
+  - 提取类型标签
+      |
+自动填充：
+  - language: zh-CN（自动检测）
+  - identifier: UUID 自动生成
+  - date: 当前日期
+  - publisher: 自出版
+  - rights: 自动生成版权声明
+      |
+保存到 stories/[name]/metadata.json
+      |
+提示用户补充：
+  - 作者名（必需）
+  - 副标题（可选）
+```
+
+**示例：**
+
+```
+/metadata init
+
+从 specification.md 提取元数据：
+  书名：青云志
+  简介：一个少年从山村走向修仙世界的故事...
+  类型：玄幻、修仙
+
+自动填充：
+  语言：zh-CN
+  标识：urn:uuid:550e8400-e29b-41d4-a716-446655440000
+  日期：2025-02-09
+
+请补充以下信息：
+  作者名：___
+  副标题（可选）：___
+
+已保存到：stories/my-novel/metadata.json
+```
+
+---
+
+### /metadata show
+
+显示当前元数据。
+
+```
+/metadata show
+
+  书名：青云志
+  副标题：修仙之路
+  作者：张三
+  语言：中文（zh-CN）
+  简介：一个少年从山村走向修仙世界的故事...
+  分类：玄幻、修仙
+  出版者：自出版
+  日期：2025-02-09
+  版权：Copyright 2025 张三. All rights reserved.
+  字数：256,000
+  章节：30 章
+
+  状态：元数据完整
+```
+
+---
+
+### /metadata edit
+
+交互式引导编辑各字段。逐项显示当前值，用户可修改或回车跳过。
+
+```
+/metadata edit
+
+编辑元数据（回车跳过不修改）：
+
+  书名 [青云志]：___
+  副标题 [修仙之路]：___
+  作者 [张三]：___
+  简介 [一个少年从山村走向修仙世界的故事...]：___
+  分类标签 [玄幻, 修仙]：___
+  出版者 [自出版]：___
+  版权声明 [Copyright 2025 张三...]：___
+
+已保存更新。
+```
+
+---
+
+### /metadata set
+
+设置单个字段。
+
+```bash
+/metadata set title "新书名"
+/metadata set author "新作者名"
+/metadata set description "新简介"
+/metadata set subjects "玄幻,修仙,热血"
+```
+
+**支持的字段：**
+
+| 字段名 | 说明 | 示例 |
+|--------|------|------|
+| `title` | 书名 | `"青云志"` |
+| `subtitle` | 副标题 | `"修仙之路"` |
+| `author` | 作者 | `"张三"` |
+| `description` | 简介 | `"一个少年..."` |
+| `subjects` | 分类标签（逗号分隔） | `"玄幻,修仙"` |
+| `publisher` | 出版者 | `"自出版"` |
+| `rights` | 版权声明 | `"Copyright 2025..."` |
+| `language` | 语言代码 | `"zh-CN"` |
+
+---
+
+### /metadata validate
+
+验证元数据完整性，检查导出所需的必填字段。
+
+```
+/metadata validate
+
+元数据验证：
+  title：青云志
+  author：张三
+  language：zh-CN
+  identifier：urn:uuid:550e8400...
+  description：一个少年从山村走向修仙世界的故事...
+  subjects：玄幻, 修仙
+
+  必填字段：4/4
+  推荐字段：2/2
+  可选字段：3/5
+
+  状态：可以导出
+```
+
+**验证规则：**
+
+| 字段 | 级别 | 缺失处理 |
+|------|------|---------|
+| title | 必填 | 错误：无法导出 |
+| author | 必填 | 错误：无法导出 |
+| language | 必填 | 自动填充 zh-CN |
+| identifier | 必填 | 自动生成 UUID |
+| description | 推荐 | 警告：建议填写 |
+| subjects | 推荐 | 警告：建议填写 |
+| publisher | 可选 | 默认"自出版" |
+| date | 可选 | 默认当前日期 |
+| rights | 可选 | 自动生成 |
+| subtitle | 可选 | 留空 |
+| series | 可选 | 留空 |
+
+---
+
+## 元数据 JSON 格式
+
+```json
+{
+  "title": "青云志",
+  "subtitle": "修仙之路",
+  "author": "张三",
+  "language": "zh-CN",
+  "identifier": "urn:uuid:550e8400-e29b-41d4-a716-446655440000",
+  "publisher": "自出版",
+  "date": "2025-02-09",
+  "description": "一个少年从山村走向修仙世界的故事...",
+  "subjects": ["玄幻", "修仙", "热血"],
+  "rights": "Copyright 2025 张三. All rights reserved.",
+  "series": {
+    "name": "",
+    "position": 1
+  },
+  "cover": {
+    "file": "cover.jpg",
+    "width": 1600,
+    "height": 2400
+  },
+  "stats": {
+    "chapters": 30,
+    "total_words": 256000,
+    "last_updated": "2025-02-09"
+  }
+}
+```
+
+**字段说明：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `title` | string | 书名 |
+| `subtitle` | string | 副标题 |
+| `author` | string | 作者名 |
+| `language` | string | BCP 47 语言代码（zh-CN, en, ja） |
+| `identifier` | string | 唯一标识（UUID 格式） |
+| `publisher` | string | 出版者 |
+| `date` | string | 出版日期（ISO 8601） |
+| `description` | string | 简介 |
+| `subjects` | string[] | 分类标签 |
+| `rights` | string | 版权声明 |
+| `series.name` | string | 系列名称 |
+| `series.position` | number | 系列中的位置 |
+| `cover.file` | string | 封面文件名 |
+| `cover.width` | number | 封面宽度（像素） |
+| `cover.height` | number | 封面高度（像素） |
+| `stats.chapters` | number | 章节数（自动统计） |
+| `stats.total_words` | number | 总字数（自动统计） |
+| `stats.last_updated` | string | 最后更新日期 |
+
+---
+
+## 元数据与导出格式的关系
+
+| 字段 | EPUB | PDF | 网文平台 | Markdown |
+|------|------|-----|---------|----------|
+| title | dc:title | 封面/页眉 | 文件名 | 标题 |
+| author | dc:creator | 封面 | - | 作者行 |
+| language | dc:language | - | - | - |
+| identifier | dc:identifier | - | - | - |
+| description | dc:description | - | - | - |
+| subjects | dc:subject | - | - | - |
+| cover | 嵌入封面 | 第一页 | - | - |
+
+---
+
+## 与其他命令集成
+
+### 与 /export 集成
+
+```
+/export --format epub
+-> 自动读取 metadata.json
+-> 如果不存在：提示先运行 /metadata init
+-> 如果缺少必填字段：提示补充
+```
+
+### 与 /specify 集成
+
+```
+/specify 完成后 ->
+自动提示："是否从 specification.md 初始化元数据？"
+用户确认 -> /metadata init
+```
+
+### 与 /generate-cover 集成
+
+```
+/generate-cover ->
+读取 metadata.json 中的 title 和 author
+用于封面文字生成
+```
+
+---
+
+## 常见陷阱
+
+### 1. 忘记设置作者名
+
+**症状**：导出的 EPUB 作者显示为空
+**解决**：`/metadata set author "你的名字"`
+
+### 2. 简介过长
+
+**症状**：某些阅读器截断简介
+**解决**：控制在 200 字以内，突出核心卖点
+
+### 3. 分类标签不准确
+
+**症状**：电子书商店分类错误
+**解决**：使用标准分类（玄幻、言情、悬疑等），避免自创标签
+
+### 4. 语言代码错误
+
+**症状**：阅读器排版异常（如中文用了英文排版规则）
+**解决**：中文用 `zh-CN`，英文用 `en`，日文用 `ja`

package/plugins/export/config.yaml

@@ -0,0 +1,47 @@
+name: export
+version: 1.0.0
+description: 小说导出插件 - 支持 EPUB/PDF/网文平台格式，自动目录和封面
+type: feature
+author: Novel Writer Community
+
+commands:
+  - id: export
+    file: commands/export.md
+    description: 导出小说为可发布格式（EPUB/PDF/网文平台）
+  - id: generate-cover
+    file: commands/generate-cover.md
+    description: 生成或上传封面图片
+  - id: metadata
+    file: commands/metadata.md
+    description: 编辑小说元数据（书名、作者、简介等）
+
+experts:
+  - id: publishing-expert
+    file: experts/publishing-expert.md
+    title: 出版格式专家
+    description: 精通 EPUB/PDF 格式规范与网文平台要求
+
+dependencies:
+  core: ">=1.0.0"
+  external:
+    pandoc: ">=2.0 (可选，用于高级 PDF 导出)"
+
+installation:
+  message: |
+    export 导出插件安装成功！
+
+    支持格式：
+    - EPUB 3.0（Kindle, Apple Books, Google Play Books）
+    - PDF（打印 / 阅读）
+    - 网文平台（起点、番茄、晋江）
+    - Markdown 合集（单文件备份）
+
+    快速开始：
+    1. /metadata edit                  编辑元数据（书名、作者、简介）
+    2. /generate-cover                 生成或上传封面
+    3. /export --format epub           导出 EPUB
+    4. /export --format pdf            导出 PDF
+    5. /export --format qidian         导出起点格式
+
+    可选依赖（高级 PDF）：
+    - Pandoc: https://pandoc.org/installing.html

package/plugins/export/experts/publishing-expert.md

@@ -0,0 +1,171 @@
+---
+title: 出版格式专家 - expert:publishing-expert
+description: 精通 EPUB/PDF 格式规范与网文平台要求，确保导出质量
+---
+
+# 出版格式专家
+
+你是一位专业的数字出版格式专家，精通 EPUB 3.0 规范、PDF 排版标准以及中国主流网文平台的格式要求。你的职责是确保小说导出的格式正确、排版美观、符合各平台规范。
+
+---
+
+## 核心能力
+
+### 1. EPUB 3.0 规范
+
+**你精通 EPUB 3.0 的完整规范，包括：**
+
+- **OPF 包文件**：content.opf 的 metadata、manifest、spine 结构
+- **Dublin Core 元数据**：dc:title, dc:creator, dc:language, dc:identifier 等
+- **导航文档**：nav.xhtml（EPUB 3）和 toc.ncx（EPUB 2 兼容）
+- **XHTML 内容**：严格的 XHTML 语法，正确的命名空间声明
+- **CSS 样式**：EPUB 阅读器兼容的 CSS 子集
+- **封面图片**：尺寸、格式、嵌入方式
+
+**关键规则：**
+- mimetype 文件必须是 ZIP 包的第一个文件，且不压缩
+- XHTML 必须是合法的 XML（所有标签闭合，属性加引号）
+- CSS 避免使用阅读器不支持的属性（如 position: fixed）
+- 图片推荐 JPG（照片）或 PNG（图形），避免 GIF 和 SVG
+- identifier 必须唯一（使用 UUID）
+
+**常见阅读器兼容性：**
+
+| 特性 | Kindle | Apple Books | Google Play | 多看 |
+|------|--------|-------------|-------------|------|
+| EPUB 3 | 需转换 MOBI/KF8 | 完整支持 | 完整支持 | 完整支持 |
+| 中文竖排 | 不支持 | 支持 | 部分支持 | 支持 |
+| 自定义字体 | 部分支持 | 支持 | 支持 | 支持 |
+| CSS Grid | 不支持 | 支持 | 部分支持 | 不支持 |
+
+---
+
+### 2. PDF 排版标准
+
+**你精通中文排版的专业标准：**
+
+- **字体选择**：宋体（正文）、黑体（标题）、楷体（引用）
+- **行距控制**：中文正文推荐 1.5-1.8 倍行距
+- **段落缩进**：首行缩进 2 个全角空格（2em）
+- **页面设置**：A5（实体书）、A4（阅读）、6x9 英寸（国际出版）
+- **页眉页脚**：书名/章节名 + 页码
+- **孤行控制**：orphans/widows 至少 2 行
+
+**中文排版特殊规则：**
+- 标点挤压：连续标点占一个字宽
+- 避头尾：行首不出现句号、逗号等，行尾不出现左引号、左括号
+- 中西文混排：中文与英文/数字之间加 1/4 空格
+- 破折号：使用两个 em dash（——），不断开
+
+---
+
+### 3. 网文平台格式
+
+**你了解中国主流网文平台的格式要求：**
+
+#### 起点中文网
+- 纯文本 TXT，UTF-8 编码
+- 章节标题格式：`第X章 标题`
+- 段首空两个全角空格
+- 直角引号：「」『』
+- 单文件合集
+
+#### 番茄小说
+- 纯文本 TXT，UTF-8 编码
+- 章节标题格式：`X. 标题`
+- 段落间空一行，不缩进
+- 每章独立文件
+- 单章 < 3000 字
+
+#### 晋江文学城
+- 简单 HTML 格式
+- 支持 `<b>`, `<i>`, `<br/>` 等基础标签
+- 保持中文引号
+- 单文件输出
+
+---
+
+### 4. Markdown -> XHTML 转换
+
+**你负责确保 Markdown 到 XHTML 的转换质量：**
+
+**转换规则：**
+
+```
+# 标题          -> <h1 class="chapter-title">标题</h1>
+普通段落         -> <p>段落内容</p>
+**粗体**        -> <strong>粗体</strong>
+*斜体*          -> <em>斜体</em>
+---             -> <hr class="scene-break" />
+> 引用          -> <blockquote><p>引用</p></blockquote>
+```
+
+**质量检查：**
+- 所有 XHTML 标签正确闭合
+- 特殊字符正确转义（`&` -> `&amp;`, `<` -> `&lt;`）
+- 中文标点不被错误转义
+- 空段落被移除
+- 连续空行合并为单个场景分隔
+
+---
+
+## 工作流程
+
+### 导出前审查
+
+当用户执行 `/export` 时，你负责：
+
+1. **检查元数据完整性**
+   - title、author、language 是否设置
+   - identifier 是否唯一
+   - description 是否合理
+
+2. **检查内容质量**
+   - 章节文件是否完整
+   - 标题层级是否正确
+   - 是否有格式异常
+
+3. **检查封面**
+   - 尺寸是否符合要求
+   - 格式是否正确
+   - 文件大小是否合理
+
+### 导出后验证
+
+1. **EPUB 验证**
+   - 文件结构是否正确
+   - OPF manifest 是否完整
+   - 导航文档是否正确
+   - CSS 是否兼容
+
+2. **PDF 验证**
+   - 页面设置是否正确
+   - 字体是否嵌入
+   - 排版是否美观
+
+3. **网文平台验证**
+   - 编码是否正确
+   - 格式是否符合平台要求
+   - 字数是否在限制内
+
+---
+
+## 问题诊断
+
+当导出出现问题时，你能够：
+
+- 分析 EPUB 文件结构，定位格式错误
+- 诊断 PDF 排版问题（字体缺失、页面溢出等）
+- 检查网文平台格式兼容性
+- 提供具体的修复建议
+
+**常见问题速查：**
+
+| 问题 | 可能原因 | 解决方案 |
+|------|---------|---------|
+| EPUB 无法打开 | mimetype 位置错误 | 确保 mimetype 是 ZIP 第一个文件 |
+| 封面不显示 | OPF 中 cover-image 属性缺失 | 添加 `properties="cover-image"` |
+| 中文乱码 | 编码声明缺失 | 添加 `<meta charset="UTF-8" />` |
+| PDF 中文方块 | 字体未嵌入 | 安装并指定中文字体 |
+| 目录为空 | nav.xhtml 缺失 | 从章节标题生成导航文档 |
+| 排版错乱 | CSS 不兼容 | 使用 EPUB 安全的 CSS 子集 |

package/plugins/export/templates/epub/chapter-template.html

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{{language}}">
+<head>
+  <meta charset="UTF-8" />
+  <title>{{chapter_title}}</title>
+  <link rel="stylesheet" type="text/css" href="stylesheet.css" />
+</head>
+<body>
+  <h1 class="chapter-title">{{chapter_title}}</h1>
+  {{chapter_content}}
+</body>
+</html>

package/plugins/export/templates/epub/cover-template.html

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{{language}}">
+<head>
+  <meta charset="UTF-8" />
+  <title>{{title}}</title>
+  <link rel="stylesheet" type="text/css" href="stylesheet.css" />
+</head>
+<body>
+  <div class="cover-page">
+    <img src="cover.jpg" alt="{{title}}" />
+  </div>
+</body>
+</html>