Skip to content

Latest commit

 

History

35 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ReadShift: AI-Powered Knowledge Architecture & Publishing-Grade Engine

用 AI 重塑阅读 · 连接商业智慧与出版级工程的开源二次创作引擎

"It's not just about extracting text; it's about reshaping ourselves through reading. Transform every yellowed, dusty book into a personalized arena for growth."

“重要的不仅是提取文字,而是我们在阅读中重塑自我。把每一本泛黄的旧书,变成只为你量身定制的成长场域。”


⚡ 01 · 核心能力:ReadShift Agent Skill (即插即用 AI 技能插件)

🎯 开发者与创作者第一站 (01 号核心产物 · Position #1)
如果你正在使用任何 AI Coding Agent(如 ZCode / Claude Code / Codex / Cursor / OpenCode / AutoGPT),你可以直接将本项目的 Skill 引入你的 Agent 工作区,一键获得全套出版级做书、双语精排、EPUB 3.0 编译与多模态二创能力!

📦 技能一键安装与触发 (01-核心能力:ReadShift_Agent_Skill/)

# 方式 1:直接在支持 Skill 的 Agent 环境中调用内置指令
/readshift

# 方式 2:在终端使用统一 CLI 指令一键生产
python3 cli/readshift.py init --book-name "我的重制读物"   # 初始化 D0/D1/D2 三层资产结构
python3 cli/readshift.py build --input source/            # 编译为自包含交互 HTML 母版
python3 cli/readshift.py epub --input source/             # 编译为出版级 EPUB 3.0 流式电子书
python3 cli/readshift.py qa --html 私域产物/book.html     # 启动 14 项自动化质量审计门禁
核心技能指令 功能职责与底层调用 产出物标准
/readshift build 调用 workdir/render_html_v9.js 权威渲染引擎 Tschichold 黄金比例、两级悬浮目录、双语章标题卡、零 CDN 单文件 HTML
/readshift epub 调用 workdir/build_epub.py 出版级电子书打包器 OCF 两阶段封装、mimetype 零压缩置顶、两级双语目录树、防撕裂保护
/readshift qa 调用 workdir/qa_gate_v3.py 多维质量门禁 XML 严格语法断言、标签绝对闭合、目录锚点可达性、双语 1:1 结构合规
/readshift check 调用 docs/HEALTHCHECK.sh 脚本 扫描 D1 Markdown 源料中的未闭合标签、占位符、多空行与孤立大标题

🎙️ 重磅二次创作主推 ·《台积电张忠谋 · 传记时间线的平行世界》 (Top Showcase)

🎯 100% 自主版权 · 跨媒介多模态叙事宇宙 · 已设立独立专属开源仓库
原书不是直接搬运的文本,而是激发时代思考的事实骨架。我们通过 ReadShift 的“第三人称平行叙事引擎”,全新创作了独立原创故事文本、中英双轨剧本、广播级神经拟真语音(MP3)以及衍生出版级电子书

🚀 【独立项目主页与全量更新入口】
本项目已正式独立立项,全量 11+ 集完整双轨音频、剧本与多模态演进请访问专属仓库:
👉 https://github.com/Martin-MQtech/morris-chang-tsmc-aigc-parallel

  • 👉 点击进入本地示范目录《二次创作:《台积电张忠谋·传记时间线的平行世界》》
    • 🎧 第 00 期《全册导读》:半导体教父的传奇全景与时代回响
    • 🎧 第 01 期《逃难的孩子》(1937):战火纷飞下的求索之路(中英文字稿 + 双轨 MP3 音频)
    • 🎧 第 02 期《考不进去的南开与作家梦》(1948):少年时代的文学梦与时代抉择(中英文字稿 + 双轨 MP3 音频)
    • 🎧 第 03-10 期《从黄浦江到查尔斯河》至《从台湾到世界》:全套 11 集双轨视听广播剧与中英文剧本
    • 🌌 《00-平行宇宙叙事模型与IP演进构想》:三层引力轨道模型、叙事距离弹性与美剧式衍生宇宙架构
    • 🗺️ 系列剧集地图:1931-1998 晶圆教父时代切片全景规划与多模态二创衍生宇宙

🏛️ 社区多模态再造作品公开展厅 (Community Works Gallery)

🌟 创作者的第一舞台 · 汇聚全球社区提交的优秀多模态再造作品,全面对外展示与宣传推广!


🧭 项目全局导航与主次层级矩阵 (Documentation Architecture)

ReadShift 知识与工程矩阵 (GitHub 官方仓库拓扑)
├── ⚡ skills/readshift/ (【Position #1】ReadShift Agent Skill 技能定义文件)
├── 🛠️ cli/ (统一命令行接口 · init / build / epub / audio / qa / check)
├── ⚙️ workdir/ (4 大通用生产级工具箱 · HTML编译器 / QA门禁 / LLM管线 / EPUB打包器)
├── 🎨 src/ (渲染核心 · 权威模板 template.ejs 与本地离线脚本)
├── 📚 docs/ (深度专题库 · 架构哲学 / 动态语域 PROMPTS / 排版美学 / 排坑总库 / 体检脚本)
├── 📦 archive/ (历史归档 · 早期散落补丁脚本隔离区)
│
├── 🎙️ 二次创作:《台积电张忠谋·传记时间线的平行世界》_Parallel_Universe/ (100%自主版权多模态二创宇宙 · 11集全套双轨视听广播剧/剧本)
├── 🏛️ 典藏排版实录:张忠谋自传双语版_Remastered/ (出版级排版实录与工程证明 · 全书私域锁存)
├── 🏛️ 社区多模态再造作品公开展厅_Community_Works/ (全球社区创作者多模态作品宣传展位)
├── 🛠️ 全源文化共享与内容再造工坊_Community_Studio/ (古籍善本/书法碑帖/口述文献线索池与定制再造提案)
│
├── README.md (本项目总领 · 全景概览 / 广义内容哲学 / 通用管线 / 资产矩阵)
├── 执行手册.md (L1 全局标准作业程序 SOP · 质量门禁 / 内容契约 / 出版级 EPUB 标准)
├── CONTRIBUTING_共创指南.md (顶层共创战略 · 创作者入驻规范 / 投稿流 / 版权契约)
├── project.json (机器事实源 · 章节边界 / 渲染映射 / 状态机)
├── requirements.txt & package.json (核心依赖)
│
└── 🔒 私域产物/ 【本地私有成果库 · 绝不同步公网 · 仅作架构展示】
    ├── Samples/一-六章合成-Chapter-1-6.html (101页双语全书交互式母版 · 仅本地研读)
    ├── 张忠谋自传_双语终极典藏插图版.epub (11.8MB 终极流式 EPUB 电子书 · 仅本地研读)
    ├── 下册项目工作区/ (下册 44 章全量资产本地实战工程 · 仅本地研读)
    └── chapters/ (六大章节独立 D0/D1/D2 本地切片数据)

💡 缘起与发心:科技工具背后的人文底色 (The Origin Story)

这个项目的诞生,源于一份非常具体的、关于个人成长的真实经历。

一切的起点,是一位朋友的馈赠。他把《张忠谋自传》递到我手中,郑重地推荐我读一读。这位半导体巨擘的人生与商业智慧,对任何创业者而言都是弥足珍贵的宝藏。然而,我能找到的只有充满年代感、字迹模糊、段落粘连的繁体版扫描件。当我们试图去触碰那些伟大的灵魂和深邃的商业经验时,却常常被**“糟糕的载体”**拒之门外。

更进一步,我不仅仅想舒服地看完这本中文传记。作为身处全球化浪潮中的创业者,我极度渴望在吸收这些商业智慧的同时,能够学习并掌握地道的现代商业英文表达和协作逻辑。我希望我的阅读是复合的:既是跨越时空的商业对话,也是提升国际化视野的英文精读。

我不是一个传统意义上手写底层代码的黑客。但在如今这个 AI 赋能的时代,你不必非得是算法专家才能创造工具。专业经验和对痛点的敏锐感知,才是创新真正的源泉。 凭借对商业场景的理解与系统化思维,我决定拥抱 AI,把冰冷的 PDF 变成一间属于自己的“私人书房”。

而这一切,最终指向一个最动人的闭环:这本书,是朋友赠予我的知识礼物;当我把它重制为更轻便、更精致的出版级读物,我愿将它作为一份新的礼物,回赠给那位带我认识这本书的人。 知识从一个人流向另一个人,经双手重铸,以更丰盈的形态回归。这是一个有意义的信息循环,也是价值的温暖传递。


🎯 产品定位与哲学:通用工具链与旗舰示范案例 (Core Positioning & Philosophy)

⚠️ 核心定位声明
ReadShift 是一个通用、普适性的开源 AIGC 电子书重塑与二次创作工业级工具链(Bring Your Own Book)。
本项目不分发任何受版权保护的原书内容。我们在仓库中构建的《张忠谋自传》(上/下册)全链路工程与衍生品,是用于在最严苛、最复杂的真实场景中打磨、压测并验证这套通用工具链的“旗舰级参考示范案例(Flagship Showcase & Crucible)”

我们的终极目标,是把这套“做书与二创”的通用能力交付给全球所有终身学习者与创作者——让任何人都能把可读性极差的泛黄旧 PDF/扫描件,重制为顶级的双语典藏应用与出版级电子书。

通用工具链的三大核心赋能支柱 (The 3 Pillars of General Capability)

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                     READSHIFT 通用能力:从任意旧书到无界多模态容器                      │
├──────────────────────────┬──────────────────────────┬──────────────────────────────────┤
│ 1. 结构提纯 (Genesis)     │ 2. 语境重构 (Resonance)   │ 3. 泛化分发 (Infinite Fronts)    │
├──────────────────────────┼──────────────────────────┼──────────────────────────────────┤
│ 任意老旧扫描/泛黄 PDF    │ 动态语域 Prompt 矩阵     │ 双生终极载体 + 多模态延伸        │
│ ➔ OCR 粗洗 + 错别字校正 │ ➔ 艾萨克森/韩寒/海明威   │ ➔ 单文件全离线自包含 HTML 应用   │
│ ➔ 结构化纯净 D1 Markdown │ ➔ 商业 CheatSheet 提纯   │ ➔ 出版级 EPUB 3.0 流式电子书     │
│ ➔ 建立只读原始证据保护   │ ➔ 地道习语与语境自适应   │ ➔ 声音/播客/图谱/多模态二创母矿  │
└──────────────────────────┴──────────────────────────┴──────────────────────────────────┘
  1. 触达万物源头,提纯结构资产 (The Pure Origin)
    一切高级内容形态(有声书、播客、视频解说、交互应用)在底层都源于最基础的文字与逻辑。ReadShift 提供了通用的 D0/D1/D2 三层数据治理标准,能够穿透任意老旧书籍的噪点,提纯出结构纯净、机器可读的 Markdown 核心数字资产。
  2. 语境自适应与动态语域平衡 (Context-Aware Bilingual Resonance)
    内置开箱即用的“基准线 + 风格 DLC”提示词矩阵。无论是科技巨头传记、学术经典、商业案例还是文学作品,系统均能自适应匹配最契合的翻译与二创文风,兼顾严谨专业度与地道口语/俚语表达。
  3. 面向无限容器的出版级分发 (Universal Multi-Platform Publishing)
    工具链输出的不是零碎散落的文件,而是具备极高工程确定性的标准出版物:
    • 单文件自包含 HTML 应用:内置原生两级目录、术语悬浮、全离线可用;
    • 出版级 EPUB 3.0 电子书:严格遵循国际 OCF 规范与 XML 严格解析门禁,双层双语目录索引,防翻页撕裂,完美适配 Apple Books、微信读书与各类墨水屏。

⚖️ 知识产权声明与侵权响应机制 (Copyright Goodwill & Takedown Statement)

“尊重知识产权,坚守学术与非盈利技术探索发心。”

  1. 项目初衷与性质
    • ReadShift 仅作为开源的技术工具链研发、排版艺术探索、双语深度研读与 AI 多模态叙事研究项目,严禁任何个人或组织将本项目用于商业营利、付费分发或商业出版;
  2. 分轨分发边界原则
    • 系列 01(典藏重塑):出于对原著版权的最高尊重,完整封装好的全书电子书成品(HTML 母版 / EPUB 3.0)绝不在 GitHub 等公网线上分发传播,仅存放于本地 私域产物/ 供个人研读。展厅仅展示排版设计截图与 SOP,倡导购买正版图书;
    • 系列 02(平行叙事):以事实时间线为骨架,AI 第三人称全新原创故事与双轨中英文剧本,二创成分极高且版权独立,面向公网全量开源开放传播
  3. 侵权响应机制 (DMCA / Takedown Notice)
    • 我们对知识产权抱有极高敬意。若本项目中引用的任何案例展示、文字片段或二创作品涉及或影响到了您的合法版权权益,请随时通过 GitHub Issue 或维护者联系方式与我们沟通。我们将在核实后第一时间进行诚恳交流,并立即执行相应内容的下架或修改处理。

🏗️ 核心系统架构与端到端管线 (Architecture & Pipeline)

ReadShift 采用**“三层数据模型(Three-Tier Data Model)”“大小模型分层协作机制(Tiered Model Pipeline)”**:

┌──────────────────────────────────────────────────────────────────────────────────┐
│                             READSHIFT 端到端工业化管线                             │
├──────────────────┬──────────────────┬──────────────────┬─────────────────────────┤
│ 1. 证据与提纯层   │ 2. 语义重构与延伸 │ 3. 模板编译与封装 │ 4. 多端质检与出货        │
├──────────────────┼──────────────────┼──────────────────┼─────────────────────────┤
│ • D0 原始扫描/OCR│ • D1 人工编辑主源 │ • D2 交互 HTML   │ • QA Gate v3 自动化门禁 │
│ • 繁简转换与去噪 │ • 艾萨克森双语重塑│ • EPUB 3.0 容器  │ • XML 实体严格断言      │
│ • 结构化分块切片 │ • 商业 CheatSheet│ • 带书签精装 PDF │ • 跨端翻页防撕裂保护    │
└──────────────────┴──────────────────┴──────────────────┴─────────────────────────┘

1. 三层数据规范

  • D0 (raw_source/):只读原始证据层,永不修改。
  • D1 (source/*.md):唯一人工编辑主源,所有翻译、校对、二创卡片均沉淀于此,作为二次创作的公共母矿。
  • D2 (output/):由编译器自动生成的交付物,严禁手工修改 D2。

2. 大小模型协作分工

  • “搬砖”劳模层(Fast / Local Models):负责高并发 OCR 清洗、标点修复、繁简转码等机械劳动。
  • “灵魂”主编层(High-IQ Models):负责传记文风重塑、修辞赏析点睛、商业语汇提炼等产生核心溢价的环节。

📚 衍生生态:出版级 EPUB 3.0 电子书标准 (EPUB Best Practices)

为解决移动端(手机 / 墨水屏)阅读常见的问题,ReadShift 制定了行业级的 EPUB 编译规范:

  1. 双层嵌套双语目录树(Two-Level Bilingual TOC): 在 nav.xhtml(EPUB 3)与 toc.ncx(EPUB 2)中深度索引到二级小节(<h3>),中英双语对照,支持阅读器原生目录一键直达。
  2. 全主题自适应底色: 全局透明背景 + rgba() 轻量边线,完美适配阅读器的夜间模式、护眼绿与羊皮纸风格。
  3. 全链路防撕裂(Anti-Tearing): 为标题注入 page-break-after: avoid,为卡片、插画与表格注入 page-break-inside: avoid,彻底根除分页截断现象。
  4. 标准 OCF 两阶段物理封装mimetype 零压缩置顶(zip -X -0)+ 资源目录递归压缩,彻底解决主流阅读器白屏与丢封面问题。

🛠️ 核心工具链与快速上手 (Quick Start)

核心工具矩阵(位于 workdir/

工具脚本 职责与功能 运行示例
render_html_v9.js 全书 HTML 编译器:聚合多章 D1 资产,生成带双层交互目录的单文件 HTML node workdir/render_html_v9.js --chapters 1,2,3,4,5,6
qa_gate_v3.py 多维自动化质检门禁:检查标签闭合、实体安全、锚点可达性、中英双语结构 python3 workdir/qa_gate_v3.py --chapter 1
pipeline_v6_deepseek.py 大模型双语翻译与知识提纯管线:自动调用网关完成中英重构与卡片生成 python3 workdir/pipeline_v6_deepseek.py --chapter 1
build_epub.py 出版级 EPUB 3.0 打包编译器:按 OCF 规范生成高兼容性流式电子书 python3 workdir/build_epub.py

🌟 仓库目录全貌 (Repository Structure)

20260812 ReadShift/
├── README.md                          # [本项目] 总领概览、哲学发心与全景架构
├── 执行手册.md                        # [核心SOP] L1 标准作业程序、门禁与 EPUB 规范
├── project.json                       # [元数据] 机器可读事实源与章节状态机
├── requirements.txt                   # Python 核心依赖清单
├── package.json                       # Node.js 渲染引擎配置
│
├── docs/                              # 深入专题文档库
│   ├── ARCHITECTURE_AND_METHODOLOGY.md
│   ├── PROMPTS.md
│   ├── DESIGN_PLAN.md
│   └── LESSONS_LEARNED.md
│
├── src/                               # 渲染模板与静态设计资产
│   ├── templates/ (EJS / XHTML 模板)
│   └── assets/ (封面图、字体库、样式表)
│
├── workdir/                           # 核心生产脚本与编译器工作区
│   ├── render_html_v9.js              # HTML 权威渲染引擎
│   ├── qa_gate_v3.py                  # 自动化质量门禁
│   ├── pipeline_v6_deepseek.py        # LLM 翻译与提纯管线
│   ├── build_epub.py                  # EPUB 3.0 规范打包器
│   └── archive_legacy/                # 历史实验脚本归档(隔离维护)
│
├── output/                            # 权威成书交付区
│   ├── chapters/ (各章独立的 D0/D1/D2 工作区)
│   └── Samples/ (一至六章全书合成 HTML 典藏版)
│
├── 下册项目工作区/                    # 下册工程推进区(包含 44 个分章资产)
├── 交付物/                            # 衍生多模态产品研究(有声书/播客/图谱)
├── showcases/                         # 视觉与设计重构成果展示
└── archive/                           # 历史批次与过程脚本归档

🤝 Build in Public · 寻找共鸣

The genesis is text; the potential is infinite.
源起于文本,想象于无限。

如果您也是一位热爱阅读、持续进阶、并深知洞悉商业底层逻辑之魅力的同路人,欢迎来到这里探讨、指正,或者 Fork 本项目,用 AI 重塑那部激荡过您的经典。

About

ReadShift: AI-Powered Reading Redefined ,The genesis is text; the potential is infinite. | 用 AI 重塑阅读体验,连接智慧与成长的二次创作引擎 |源起于文本,想象于无限 | 大白话就是帮你把喜欢的 (PDF等)读物重新排版加工二创-AIGC

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages