# novel **Repository Path**: li-luoqiang/novel ## Basic Information - **Project Name**: novel - **Description**: Jade Lantern Curio - online novel reading site (based on Youreln/novel), bilingual CN/EN, with curio codex. - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-01 - **Last Updated**: 2026-11-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 东方奇物书馆 · Eastern Curio Library — 在线阅读站 > 基于 [Youreln/novel](https://github.com/Youreln/novel) 方案二次开发的**纯静态**小说阅读站。 > 收录两部东方神秘文化题材长篇与一部现实向家族命运中篇，支持**封面 + 中英双语（中文默认）+ 奇物图鉴（带货）**。 ## 这是什么 | 作品 | 类型 / 基调 | 状态 | |---|---|---| | **《玉灯奇物馆》Jade Lantern Curio** | 都市奇物店 · 现实向轻治愈悬疑 · 安静温柔 | 50 章 / 5 卷，中英双语完稿 | | **《镇物铺》The Ward Shop** | 东方神秘文化爽文 · 情节跌宕 · 轻松愉快 | 卷一–卷五 共 50 章 / 全书完稿，中英双语（Ch46–50 终局已写，感情线 RL-01~18 收束） | | **《平安扣》The Peace Knot** | 现实向家族命运中篇 · 冷静克制 · 跌宕起伏 | 20 章 / 2 卷完稿，中英双语（余华式零度叙述；全书仅 4 件产品） | **《玉灯奇物馆》**：华裔女孩林梅接手祖母留在 Maple Hollow 老城的东方奇物馆， 用**真实在售的东方器物**（水晶、香、玉器）为深夜推门而入的客人解一段心结。 **《镇物铺》**：槐市老街十七号，陆小满本想把奶奶留下的旧铺盘掉还债，却被一张改过日期的欠条、 一只挂反的铜铃、半张被剪脸的照片，卷进一桩桩局中局。她没有金手指，只有从小被逼着练出的 一双眼睛——看灰、看包浆、看补痕，也看人。老街不拆，假货别来，这单我接了。 **《平安扣》**：1983 年，清河县粮站的过磅员赵满仓娶了缝纫组的孙秀莲。奶奶把一枚玉平安扣挂到长孙颈上， 说「祖上传下来的」。四年后秀莲病重，扣子当了两百元，再没赎回来；满仓买了枚像的挂回去，一句「洗过」 说了三十一年。妻子把手术床位让给了同屋孕妇，儿子在南边被报了死讯又自己走回来，他恨错了人二十年。 2019 年拆迁撬开门槛石，底下一张纸条把整本账对上——她早替全家留了后路。 故事里的器物来自跨境电商品牌 **AuraSage（东方神秘文化 / 道家五行）**， 每章末尾的「本集奇物」与「奇物图鉴」页可直接跳转到店铺。 - 语言：中文（默认）/ 英文 双语，顶部一键切换；支持双栏对照阅读 - 合规：不写魔法 / 真实宗教 / 医疗疗效；神秘效果走「文化象征 + 心理暗示 + 仪式感」， 《镇物铺》另把「风水」还原为排水、采光、动线等可验证的空间常识 - **产品植入纪律**： - 《镇物铺》每 10 章至多 1 件产品，全书 50 章共 2 件（Ch10 `p64` 黄铜罗盘、Ch20 `p57` 五帝钱挂饰），其余 48 章 `products: []`。 - 《平安扣》全书 **仅 4 件**，每件卡在一次命运转折上：Ch3 `p63` 玉平安扣（得到）、Ch5 `p57` 五帝钱挂饰（失去）、 Ch12 `p58` 泰山石敢当摆件（埋）、Ch20 `p02` 檀香五行香（放下）；其余 16 章 `products: []`。 四件均复用 `codex.json` 现有条目，无新增图源，无转运 / 疗效 / 改运宣称。 ## 目录结构 ``` novel/ index.html # 阅读站（manifest 驱动，已去掉 GitHub API 依赖，可托管到任意静态平台） books.json # 书目清单：站点品牌 / 三部作品 / 封面 / 双语标题 / 章节路径 / 每章产品 codex/codex.json # 奇物图鉴数据（从 AuraSage 抽取，见下） codex/extract.js # 从 aurasage 仓库抽取植入产品 → codex.json（构建脚本，非运行时依赖） covers/ # 封面图（jade-lantern.png / ward-shop.jpg，另存 ward-shop.svg 作回退） planning/ward-shop/ # 《镇物铺》长篇状态文件 story-dna.md # 定位 / 命名 / 因果链 / 承诺 / 植入纪律 world-building.md # 世界观 / 行业规矩 / 势力 / 时间线 characters.md # 角色档案（有名角色先登记） creative-plan.md # 创作方案 / 卷一节奏 / FS 排期 / 文风执行卡 chapter-directory.md # 全书 50 章 / 5 卷目录 fact-ledger.md # 事实账本（FS 表 / 承诺 / 章末快照） outlines/ # 逐卷细纲（每章三节、可扩写深度） .novel-state.json # 提交进度索引 assets/ marked.min.js # 本地内置的 Markdown 渲染器（无 CDN 依赖） data.js # 由 tools/build-embed.js 生成：内联清单+章节正文，使 file:// 双击也能读 products/ # 植入故事的产品图（从 aurasage 复制） tools/ build-embed.js # 生成 assets/data.js（章节/清单内联，供离线 file:// 打开） verify-file-open.js # 无头浏览器自检：file:// 与 http:// 两种打开方式是否均正常 novel/玉灯奇物馆/ zh/第NN章_xxx.md # 中文章节（阿拉伯数字文件名 + 中文数字标题） en/chNN-xxx.md # 英文章节 novel/镇物铺/ zh/第NN章_xxx.md en/chNN-slug.md novel/平安扣/ # 《平安扣》20 章 / 2 卷，中英双语 zh/第NN章_xxx.md en/chNN-slug.md planning/peace-knot/ # 《平安扣》状态文件：DNA / 世界观 / 角色 / 目录 / 账本 / 两份细纲 ``` ## 本地预览 **方式一 · 直接双击（推荐快速查看）** 直接双击 `index.html` 用浏览器打开即可。站点的清单与全部章节正文已内联进 `assets/data.js` （由 `tools/build-embed.js` 生成），因此 `file://` 协议下也能正常读取，不受浏览器 CORS 限制。 **方式二 · 本地静态服务器（内容最新鲜）** `http(s)` 模式下站点优先 `fetch` 实时读取 `books.json` / 章节 `.md`，适合边写边看： ```bash # 在项目根目录 python -m http.server 8765 # 浏览器访问 http://localhost:8765 ``` > 注意：新增 / 修改章节后，若想让「双击打开」也能看到最新内容，请重跑 > `node tools/build-embed.js` 重新生成 `assets/data.js`（线上部署走方式二则无需此步）。 ## 如何新增 / 修改章节 1. 在对应作品的 `zh/` 与 `en/` 各放一个 `.md` 文件。 - 中文：首行 `# 第N章 · 标题`（**中文数字**），文件名 `第NN章_标题.md`（**阿拉伯数字**） - 英文：首行 `# Chapter N · Title`，文件名 `chNN-slug.md` 2. 在 `books.json` 对应 book 的 `chapters` 数组里加一项： ```json { "id":"ch04", "n":4, "title": { "zh":"第四章 · …", "en":"Chapter 4 · …" }, "zh":"novel/镇物铺/zh/第04章_xxx.md", "en":"novel/镇物铺/en/ch04-xxx.md", "products":[] } ``` `products` 填 AuraSage 产品 id（见 `codex/codex.json`）；**留空数组时章末自动不显示产品卡**。 标题建议用脚本从 md 首行自动提取，保证 `books.json` 与正文一致。 3. 提交即可，无需构建（线上部署走 `http(s)` 实时读取）。 若要让「双击 `index.html`（`file://`）」也包含新章节，额外跑： ```bash node tools/build-embed.js ``` ### 新增一部作品 在 `books.json` 的 `books` 数组追加一个 book 对象（`id` / `author` / `cover` / `langs` / `intro` / `chapters` / `volumes`），阅读站书架、分卷、搜索、双语切换、对照阅读均自动支持多书， **无需改前端代码**。站点品牌文案由顶层 `siteTitle`（`zh · en` 形式）、 `siteSubtitle` / `siteSubtitleEn` 驱动。 长篇连载的状态文件放 `planning//`（写法见《镇物铺》与《平安扣》现有文件）： - 写章前读 `fact-ledger.md` 构造「上章末状态快照」，不靠记忆推断 - 先出 `outlines/outline-0XX-0XX.md` 细纲（单次 ≤10 章、逐章三节可扩写深度），再写正文 - 正文文件**只含标题与小说正文**，工作卡字段一律不写入 - 正文 + 账本全部落盘后，才推进 `.novel-state.json.lastCommittedChapter` ## 《平安扣》文风与合规 - **文风**：取法余华式现实叙事的**技法层面**——零度叙述、短句与重复、时间平推、物件贯穿、 命运反讽、悲喜并置、平视生死。完整执行卡见 `planning/peace-knot/story-dna.md`。 - **只抽象方法，不借文本**：未使用任何具体作品的人物、姓名、情节、桥段、标志性道具、独创体系或原文句子； 人物、地点、事件、器物关系均为原创。参考资料使用记录与版权声明见 `story-dna.md` 末节。 - **现实向**：无金手指、无魔法、无真实宗教仪轨、无医疗或风水功效宣称；时代背景只写普通人生活。 - **产品**：4 件复用图鉴现有条目，正文每章至多标注一次，只作纪念物与仪式动作，不解释寓意。 - **状态文件**：`planning/peace-knot/` 含事实账本（FS-01~06 全部回收、S0/S10/S20 快照）、 `.novel-state.json`（`lastCommittedChapter: 20` / `status: complete`）。 ## 奇物图鉴（带货） `codex/codex.json` 现含 55 条奇物（名称中英、寓意、五行、图片），图片统一放在 `assets/products/pNN.jpg`，来源为本地 `aurasage` 仓库的 `assets/products/`。 `codex/extract.js` 是最早生成前 16 条的一次性脚本（路径写死 `F:/LLM/...`），**现在直接维护 `codex.json`**。 **编号映射（重要）**：`id` 是小说章节里引用的编号（`books.json` 的 `products`、正文里的 `**名称 (pNN)**` 都用它），不一定要等于 AuraSage 的真实商品编号。当两者不一致时，条目用 `sourceId` 记录 AuraSage 真实商品号，例如 `p57 五帝钱挂饰` → `sourceId: "p66"`（aurasage 的五帝钱）。 阅读器的图鉴卡与章末产品卡都会用 `sourceId || id` 拼店铺链接，避免跳错商品； `sourceId: null` 表示 AuraSage 暂无对应商品，链接回退到店铺首页。 `p57`–`p68` 是卷三/卷四的剧情道具，共 12 条，图片按器物语义映射到 AuraSage 现有商品图 （精确：五帝钱 / 泰山石 / 铜葫芦 / 八卦镜；其余为同类器物近似）。AuraSage 本身没有 `p68` 红珊瑚枝摆件，该条借用了枝状摆件图并把 `sourceId` 置为 `null`。 > **店铺链接**：`books.json` 里的 `shopBase` 已设为 AuraSage 实际部署地址 > `https://aurasage-du3.pages.dev/`，产品链接形如 `${shopBase}/#/product/p66`， > 上线时若地址变更，直接改 `books.json` 中的 `shopBase` 字段即可。 改完 `codex.json` 记得重跑 `node tools/build-embed.js` 同步离线内联数据 `assets/data.js`。 ## 部署 纯静态，无后端。推到 Gitee 后由 **Cloudflare Pages** 从仓库构建发布即可 （构建命令空、输出目录即仓库根）。也可直接 GitHub Pages / Vercel / Netlify。 ## 许可 阅读站框架基于 Youreln/novel（开源），二次修改与分发请保留原作者开源标注。 小说正文 © 林默 / Lin Mo，AI-assisted 创作（人工主导 + 精修，保留版权）。 《平安扣》文风为公共叙事技法的抽象取法，不含任何具体作品的原文、人物或桥段。