Repository files navigation

Lantern AI:一盏灯,陪你打磨漫画故事

持续开发中Open source under the MIT LicensemacOS and WindowsNode.js 22.13 or newer

下载 · 快速开始 · 当前能力 · 文档 · MCP + Skill

Lantern AI 是面向个人漫画创作者的开源漫画工作台。它把故事与资产管理、页面与画格编排、单格精修、预览与导出放在一个持续可编辑的创作空间中,并通过 MCP + Skill 接入外部 AI Agent,让创作者始终掌握关键创作决定。

产品设计

Lantern 以 LCD 作品协议为基础,在统一的漫画画布和受控编辑边界内支持创作者与 Agent 协作:

  • LCD 作品协议:LCD 统一表达页面、画格、图层、格内内容和固定资产版本,工作台、候选预览、阅读与导出共享同一份作品事实。

  • 漫画画布:页面或滚动段位于工作台中央,资产、分镜、参考图片和 Agent 对话围绕作品展开;参考图片只有明确放入画格或纸面后才进入成稿。

  • 受控编辑:工作台与通过 MCP 接入的外部 Agent 共用语义能力和作品边界;工作台编辑进入可撤销工作稿,Agent 的一话任务进入隔离草稿并在完成后形成可整体审查的方案。

工作台 / 外部 Agent(MCP + Skill)/ 内置 Agent(尚未完善)
↓
受控语义能力
↓
工作稿 / Candidate / 隔离 Agent 草稿
↓
用户审查并保存正式版本
↓
LCD 预览与导出

Lantern AI 漫画工作台主界面

漫画编排与 Agent 协作工作台

当前能力状态

已接入 🟡 部分接入  未接入  不涉及

能力UI 编辑器MCP内置 Agent
漫画、一话与故事设定管理
资产卡、漫画封面、视觉风格与多图片管理
页漫正文、封面、过场与直接新建真正双页
条漫滚动段与跨段编排
画格创建、边框、层级、出血、阅读顺序与跨页格
外部图片上传与固定版本登记
格内、纸面与跨页图片放置、裁切与有限破格🟡
同源透明前景绑定真出格🟡
单格分镜条目创建与编辑
对白、气泡、旁白与基础文字编排
固定原图、当前工作稿与最近保存页面的只读观察🟡
单页构图与人物/场景/风格一致性检查
相邻分镜连续性与创作表达检查
格内图片、角色与场景资产生成
Candidate 查看、应用与冲突保护🟡
Agent 隔离草稿、方案链接与整体审查
批注处理、图片附件、精确定位与 Agent 方案关联
正式版本列表、对比与指定版本回退
阅读预览、图片下载与 LCD 导入导出
画内效果与表现型气泡🟡
选区、遮罩、局部重画与扩图
页面布局、多页与多对象生成
漫画解析与可复用模板制作

具体拆分和差异见漫画能力矩阵

快速开始

需要带 npm 的 Node.js 22.13 或更高版本。当前发行验收覆盖 macOS 和 Windows。

推荐从 GitHub Releases 下载 lantern-<version>-source.zip 和同版本的 SHA256SUMS。也可以直接获取源码:

git clone https://github.com/lanseqingling/lantern.git
cd lantern

在解压或克隆后的目录中启动:

./lantern start

Windows 使用 lantern.cmd start

首次启动会准备锁定依赖、初始化本地数据并生成生产界面。之后源码或共享包发生变化时,start 会在启动前自动更新过期的生产构建。工作台默认打开 http://localhost:18788

校验下载的 Release 包

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

$archive=Get-ChildItem .\lantern-*-source.zip |Select-Object-First 1$expected= (Get-Content .\SHA256SUMS).Split()[0].ToLower()
$actual= (Get-FileHash$archive-Algorithm SHA256).Hash.ToLower()
$actual-eq$expected

校验通过后再解压源码包。

使用 MCP + Skill 与外部 Agent 创作

内置 Agent 尚未完善。Lantern 现阶段以工作台和 MCP + Skill 为主要创作方式。

需要从兼容的本地 Agent 使用 Lantern 时,先启动 Lantern,再让该 Agent 在 Lantern 目录中运行:

./lantern agent:install

Windows 使用 lantern.cmd agent:install。命令会识别当前 Agent,安装 Lantern 应用级 Skill 并登记本地 MCP。Agent 只能使用 Lantern 当前显式开放的受控能力;Lantern 升级、端口或凭证变化后,重复运行同一命令即可同步。详细边界见 Agent

第一次使用可以从 外部 Agent 创作快速上手 开始,直接复制几个简单 Prompt,体验创建作品、编排页面、继续修改和视觉检查。外部 Agent 完成一话内容任务后会返回本地审查链接;你也可以从工作台右上角的历史入口查看方案,决定应用并保存、保留或丢弃。

运行与数据

在源码或发行目录中,macOS 使用 ./lantern <command>,Windows 使用 lantern.cmd <command>

如果希望在任意目录直接使用 lantern,先在 Lantern 目录运行一次:

npm link

之后可以在任意目录执行 lantern startlantern agent:install 等命令。

命令用途
./lantern start启动 Lantern
./lantern status查看当前运行状态
./lantern stop停止 Lantern 管理的本地服务
./lantern doctor检查环境、配置、数据库、对象文件和服务状态
./lantern agent:install安装或同步 MCP 与 Skill
./lantern backup:create创建一致备份
./lantern backup:restore <backup-file>恢复一致备份
系统默认数据目录
macOS~/Library/Application Support/Lantern
Windows%APPDATA%\Lantern

lantern.db 保存作品与任务状态,objects/ 保存图片和导出文件,config/ 保存运行配置与模型密钥,logs/ 保存日志。删除安装目录或更换源码包不会删除这些作品数据。

备份与恢复

备份包含作品、工作稿、Agent 草稿与方案、消息、任务、候选、快照和本地对象文件,不包含模型 Key、安装令牌、日志或临时文件。备份和恢复前需要停止 Lantern:

./lantern stop
./lantern backup:create
./lantern backup:restore "/path/to/lantern-backup-<time>.zip"

恢复前会验证 manifest、SHA-256 和 SQLite 完整性;验证失败不会替换当前作品。

一次性覆盖运行设置
变量用途
LANTERN_DATA_DIR指定数据目录
WEB_PORT指定 Web 端口
API_PORT指定本地 API 端口
LANTERN_NO_OPEN=1启动后不自动打开浏览器

macOS 示例:

LANTERN_DATA_DIR="$HOME/LanternData" WEB_PORT=3100 npm start

诊断与支持范围

遇到启动或数据问题时,先运行:

./lantern doctor

doctor 检查 Node.js 版本、数据目录写入权限、Provider 配置权限、SQLite 完整性、已引用对象文件和运行服务健康状态,不显示模型 Key 或安装令牌。

进一步排查
  1. 确认 config/runtime.json 中的 Web 与 API 端口未被占用。
  2. 查看数据目录中的 logs/api.loglogs/web.log
  3. 修正问题后重新运行 ./lantern start

当前发行单位是可运行源码包,尚未提供独立图形安装器。正式发行以 GitHub Actions 的实际验收结果为准;当前验收覆盖 macOS 14 和 Windows Server 2022,Linux 未列入支持范围。

开发与构建

开发模式使用与正式启动相同的本地数据和服务边界:

./lantern dev

常用验证命令:

./lantern typecheck
./lantern test
./lantern test:integration
./lantern lint
./lantern build

Windows 将 ./lantern 换成 lantern.cmd

创建可分发的源码 ZIP 和 SHA-256 校验文件:

./lantern package:release

产物写入 release/lantern-<version>-source.ziprelease/SHA256SUMS。推送与 package.json 一致的 v<version> 标签后,GitHub Actions 会验证、打包并创建 GitHub Release。

架构与文档

Web (React / Vinext)
→ Fastify API
→ Domain Service / Capability
→ SQLite / Prisma
→ Local Task Runner → Model Provider
→ Local Object Storage
  • apps/web 是浏览器工作台,apps/api 是只监听 loopback 的本地 API 服务。

  • packages/shared 提供 LCD、工作区命令和共享契约,packages/editor-corepackages/layout-engine 提供确定性编辑和页面布局能力。

  • packages/server 负责本地持久化与对象存储,packages/agent-runtime 保留 Agent 上下文、任务和模型适配基础。当前工作台与通过 MCP 接入的外部 Agent 共享领域服务、Editor Capability 和作品写入规则;内置 Agent 尚未完善。

文档内容
文档入口产品、编辑器、LCD 与 Agent 正式文档的阅读顺序
LCD作品结构、坐标、分层、资源引用和写入不变量
AgentAgent 能力、上下文、任务、Candidate 和扩展边界
开发边界仓库导航、稳定架构边界和交付要求

许可证与反馈

Lantern 使用 MIT License 开源。

如果遇到问题或希望提交功能建议,请使用 GitHub Issues。提交前请勿公开模型 Key、安装令牌、本地路径或未公开作品内容。

About

面向个人漫画创作者的开源漫画工作台,支持故事与资产管理、页面与画格编排、预览与导出,并通过 MCP + Skill 接入外部 AI Agent。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Repository files navigation

Lantern AI:一盏灯,陪你打磨漫画故事

持续开发中Open source under the MIT LicensemacOS and WindowsNode.js 22.13 or newer

下载 · 快速开始 · 当前能力 · 文档 · MCP + Skill

Lantern AI 是面向个人漫画创作者的开源漫画工作台。它把故事与资产管理、页面与画格编排、单格精修、预览与导出放在一个持续可编辑的创作空间中,并通过 MCP + Skill 接入外部 AI Agent,让创作者始终掌握关键创作决定。

产品设计

Lantern 以 LCD 作品协议为基础,在统一的漫画画布和受控编辑边界内支持创作者与 Agent 协作:

  • LCD 作品协议:LCD 统一表达页面、画格、图层、格内内容和固定资产版本,工作台、候选预览、阅读与导出共享同一份作品事实。

  • 漫画画布:页面或滚动段位于工作台中央,资产、分镜、参考图片和 Agent 对话围绕作品展开;参考图片只有明确放入画格或纸面后才进入成稿。

  • 受控编辑:工作台与通过 MCP 接入的外部 Agent 共用语义能力和作品边界;工作台编辑进入可撤销工作稿,Agent 的一话任务进入隔离草稿并在完成后形成可整体审查的方案。

工作台 / 外部 Agent(MCP + Skill)/ 内置 Agent(尚未完善)
↓
受控语义能力
↓
工作稿 / Candidate / 隔离 Agent 草稿
↓
用户审查并保存正式版本
↓
LCD 预览与导出

Lantern AI 漫画工作台主界面

漫画编排与 Agent 协作工作台

当前能力状态

已接入 🟡 部分接入  未接入  不涉及

能力UI 编辑器MCP内置 Agent
漫画、一话与故事设定管理
资产卡、漫画封面、视觉风格与多图片管理
页漫正文、封面、过场与直接新建真正双页
条漫滚动段与跨段编排
画格创建、边框、层级、出血、阅读顺序与跨页格
外部图片上传与固定版本登记
格内、纸面与跨页图片放置、裁切与有限破格🟡
同源透明前景绑定真出格🟡
单格分镜条目创建与编辑
对白、气泡、旁白与基础文字编排
固定原图、当前工作稿与最近保存页面的只读观察🟡
单页构图与人物/场景/风格一致性检查
相邻分镜连续性与创作表达检查
格内图片、角色与场景资产生成
Candidate 查看、应用与冲突保护🟡
Agent 隔离草稿、方案链接与整体审查
批注处理、图片附件、精确定位与 Agent 方案关联
正式版本列表、对比与指定版本回退
阅读预览、图片下载与 LCD 导入导出
画内效果与表现型气泡🟡
选区、遮罩、局部重画与扩图
页面布局、多页与多对象生成
漫画解析与可复用模板制作

具体拆分和差异见漫画能力矩阵

快速开始

需要带 npm 的 Node.js 22.13 或更高版本。当前发行验收覆盖 macOS 和 Windows。

推荐从 GitHub Releases 下载 lantern-<version>-source.zip 和同版本的 SHA256SUMS。也可以直接获取源码:

git clone https://github.com/lanseqingling/lantern.git
cd lantern

在解压或克隆后的目录中启动:

./lantern start

Windows 使用 lantern.cmd start

首次启动会准备锁定依赖、初始化本地数据并生成生产界面。之后源码或共享包发生变化时,start 会在启动前自动更新过期的生产构建。工作台默认打开 http://localhost:18788

校验下载的 Release 包

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

$archive=Get-ChildItem .\lantern-*-source.zip |Select-Object-First 1$expected= (Get-Content .\SHA256SUMS).Split()[0].ToLower()
$actual= (Get-FileHash$archive-Algorithm SHA256).Hash.ToLower()
$actual-eq$expected

校验通过后再解压源码包。

使用 MCP + Skill 与外部 Agent 创作

内置 Agent 尚未完善。Lantern 现阶段以工作台和 MCP + Skill 为主要创作方式。

需要从兼容的本地 Agent 使用 Lantern 时,先启动 Lantern,再让该 Agent 在 Lantern 目录中运行:

./lantern agent:install

Windows 使用 lantern.cmd agent:install。命令会识别当前 Agent,安装 Lantern 应用级 Skill 并登记本地 MCP。Agent 只能使用 Lantern 当前显式开放的受控能力;Lantern 升级、端口或凭证变化后,重复运行同一命令即可同步。详细边界见 Agent

第一次使用可以从 外部 Agent 创作快速上手 开始,直接复制几个简单 Prompt,体验创建作品、编排页面、继续修改和视觉检查。外部 Agent 完成一话内容任务后会返回本地审查链接;你也可以从工作台右上角的历史入口查看方案,决定应用并保存、保留或丢弃。

运行与数据

在源码或发行目录中,macOS 使用 ./lantern <command>,Windows 使用 lantern.cmd <command>

如果希望在任意目录直接使用 lantern,先在 Lantern 目录运行一次:

npm link

之后可以在任意目录执行 lantern startlantern agent:install 等命令。

命令用途
./lantern start启动 Lantern
./lantern status查看当前运行状态
./lantern stop停止 Lantern 管理的本地服务
./lantern doctor检查环境、配置、数据库、对象文件和服务状态
./lantern agent:install安装或同步 MCP 与 Skill
./lantern backup:create创建一致备份
./lantern backup:restore <backup-file>恢复一致备份
系统默认数据目录
macOS~/Library/Application Support/Lantern
Windows%APPDATA%\Lantern

lantern.db 保存作品与任务状态,objects/ 保存图片和导出文件,config/ 保存运行配置与模型密钥,logs/ 保存日志。删除安装目录或更换源码包不会删除这些作品数据。

备份与恢复

备份包含作品、工作稿、Agent 草稿与方案、消息、任务、候选、快照和本地对象文件,不包含模型 Key、安装令牌、日志或临时文件。备份和恢复前需要停止 Lantern:

./lantern stop
./lantern backup:create
./lantern backup:restore "/path/to/lantern-backup-<time>.zip"

恢复前会验证 manifest、SHA-256 和 SQLite 完整性;验证失败不会替换当前作品。

一次性覆盖运行设置
变量用途
LANTERN_DATA_DIR指定数据目录
WEB_PORT指定 Web 端口
API_PORT指定本地 API 端口
LANTERN_NO_OPEN=1启动后不自动打开浏览器

macOS 示例:

LANTERN_DATA_DIR="$HOME/LanternData" WEB_PORT=3100 npm start

诊断与支持范围

遇到启动或数据问题时,先运行:

./lantern doctor

doctor 检查 Node.js 版本、数据目录写入权限、Provider 配置权限、SQLite 完整性、已引用对象文件和运行服务健康状态,不显示模型 Key 或安装令牌。

进一步排查
  1. 确认 config/runtime.json 中的 Web 与 API 端口未被占用。
  2. 查看数据目录中的 logs/api.loglogs/web.log
  3. 修正问题后重新运行 ./lantern start

当前发行单位是可运行源码包,尚未提供独立图形安装器。正式发行以 GitHub Actions 的实际验收结果为准;当前验收覆盖 macOS 14 和 Windows Server 2022,Linux 未列入支持范围。

开发与构建

开发模式使用与正式启动相同的本地数据和服务边界:

./lantern dev

常用验证命令:

./lantern typecheck
./lantern test
./lantern test:integration
./lantern lint
./lantern build

Windows 将 ./lantern 换成 lantern.cmd

创建可分发的源码 ZIP 和 SHA-256 校验文件:

./lantern package:release

产物写入 release/lantern-<version>-source.ziprelease/SHA256SUMS。推送与 package.json 一致的 v<version> 标签后,GitHub Actions 会验证、打包并创建 GitHub Release。

架构与文档

Web (React / Vinext)
→ Fastify API
→ Domain Service / Capability
→ SQLite / Prisma
→ Local Task Runner → Model Provider
→ Local Object Storage
  • apps/web 是浏览器工作台,apps/api 是只监听 loopback 的本地 API 服务。

  • packages/shared 提供 LCD、工作区命令和共享契约,packages/editor-corepackages/layout-engine 提供确定性编辑和页面布局能力。

  • packages/server 负责本地持久化与对象存储,packages/agent-runtime 保留 Agent 上下文、任务和模型适配基础。当前工作台与通过 MCP 接入的外部 Agent 共享领域服务、Editor Capability 和作品写入规则;内置 Agent 尚未完善。

文档内容
文档入口产品、编辑器、LCD 与 Agent 正式文档的阅读顺序
LCD作品结构、坐标、分层、资源引用和写入不变量
AgentAgent 能力、上下文、任务、Candidate 和扩展边界
开发边界仓库导航、稳定架构边界和交付要求

许可证与反馈

Lantern 使用 MIT License 开源。

如果遇到问题或希望提交功能建议,请使用 GitHub Issues。提交前请勿公开模型 Key、安装令牌、本地路径或未公开作品内容。

About

面向个人漫画创作者的开源漫画工作台,支持故事与资产管理、页面与画格编排、预览与导出,并通过 MCP + Skill 接入外部 AI Agent。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

Lantern AI:一盏灯,陪你打磨漫画故事

持续开发中Open source under the MIT LicensemacOS and WindowsNode.js 22.13 or newer

下载 · 快速开始 · 当前能力 · 文档 · MCP + Skill

Lantern AI 是面向个人漫画创作者的开源漫画工作台。它把故事与资产管理、页面与画格编排、单格精修、预览与导出放在一个持续可编辑的创作空间中,并通过 MCP + Skill 接入外部 AI Agent,让创作者始终掌握关键创作决定。

产品设计

Lantern 以 LCD 作品协议为基础,在统一的漫画画布和受控编辑边界内支持创作者与 Agent 协作:

  • LCD 作品协议:LCD 统一表达页面、画格、图层、格内内容和固定资产版本,工作台、候选预览、阅读与导出共享同一份作品事实。

  • 漫画画布:页面或滚动段位于工作台中央,资产、分镜、参考图片和 Agent 对话围绕作品展开;参考图片只有明确放入画格或纸面后才进入成稿。

  • 受控编辑:工作台与通过 MCP 接入的外部 Agent 共用语义能力和作品边界;工作台编辑进入可撤销工作稿,Agent 的一话任务进入隔离草稿并在完成后形成可整体审查的方案。

工作台 / 外部 Agent(MCP + Skill)/ 内置 Agent(尚未完善)
↓
受控语义能力
↓
工作稿 / Candidate / 隔离 Agent 草稿
↓
用户审查并保存正式版本
↓
LCD 预览与导出

Lantern AI 漫画工作台主界面

漫画编排与 Agent 协作工作台

当前能力状态

已接入 🟡 部分接入  未接入  不涉及

能力UI 编辑器MCP内置 Agent
漫画、一话与故事设定管理
资产卡、漫画封面、视觉风格与多图片管理
页漫正文、封面、过场与直接新建真正双页
条漫滚动段与跨段编排
画格创建、边框、层级、出血、阅读顺序与跨页格
外部图片上传与固定版本登记
格内、纸面与跨页图片放置、裁切与有限破格🟡
同源透明前景绑定真出格🟡
单格分镜条目创建与编辑
对白、气泡、旁白与基础文字编排
固定原图、当前工作稿与最近保存页面的只读观察🟡
单页构图与人物/场景/风格一致性检查
相邻分镜连续性与创作表达检查
格内图片、角色与场景资产生成
Candidate 查看、应用与冲突保护🟡
Agent 隔离草稿、方案链接与整体审查
批注处理、图片附件、精确定位与 Agent 方案关联
正式版本列表、对比与指定版本回退
阅读预览、图片下载与 LCD 导入导出
画内效果与表现型气泡🟡
选区、遮罩、局部重画与扩图
页面布局、多页与多对象生成
漫画解析与可复用模板制作

具体拆分和差异见漫画能力矩阵

快速开始

需要带 npm 的 Node.js 22.13 或更高版本。当前发行验收覆盖 macOS 和 Windows。

推荐从 GitHub Releases 下载 lantern-<version>-source.zip 和同版本的 SHA256SUMS。也可以直接获取源码:

git clone https://github.com/lanseqingling/lantern.git
cd lantern

在解压或克隆后的目录中启动:

./lantern start

Windows 使用 lantern.cmd start

首次启动会准备锁定依赖、初始化本地数据并生成生产界面。之后源码或共享包发生变化时,start 会在启动前自动更新过期的生产构建。工作台默认打开 http://localhost:18788

校验下载的 Release 包

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

$archive=Get-ChildItem .\lantern-*-source.zip |Select-Object-First 1$expected= (Get-Content .\SHA256SUMS).Split()[0].ToLower()
$actual= (Get-FileHash$archive-Algorithm SHA256).Hash.ToLower()
$actual-eq$expected

校验通过后再解压源码包。

使用 MCP + Skill 与外部 Agent 创作

内置 Agent 尚未完善。Lantern 现阶段以工作台和 MCP + Skill 为主要创作方式。

需要从兼容的本地 Agent 使用 Lantern 时,先启动 Lantern,再让该 Agent 在 Lantern 目录中运行:

./lantern agent:install

Windows 使用 lantern.cmd agent:install。命令会识别当前 Agent,安装 Lantern 应用级 Skill 并登记本地 MCP。Agent 只能使用 Lantern 当前显式开放的受控能力;Lantern 升级、端口或凭证变化后,重复运行同一命令即可同步。详细边界见 Agent

第一次使用可以从 外部 Agent 创作快速上手 开始,直接复制几个简单 Prompt,体验创建作品、编排页面、继续修改和视觉检查。外部 Agent 完成一话内容任务后会返回本地审查链接;你也可以从工作台右上角的历史入口查看方案,决定应用并保存、保留或丢弃。

运行与数据

在源码或发行目录中,macOS 使用 ./lantern <command>,Windows 使用 lantern.cmd <command>

如果希望在任意目录直接使用 lantern,先在 Lantern 目录运行一次:

npm link

之后可以在任意目录执行 lantern startlantern agent:install 等命令。

命令用途
./lantern start启动 Lantern
./lantern status查看当前运行状态
./lantern stop停止 Lantern 管理的本地服务
./lantern doctor检查环境、配置、数据库、对象文件和服务状态
./lantern agent:install安装或同步 MCP 与 Skill
./lantern backup:create创建一致备份
./lantern backup:restore <backup-file>恢复一致备份
系统默认数据目录
macOS~/Library/Application Support/Lantern
Windows%APPDATA%\Lantern

lantern.db 保存作品与任务状态,objects/ 保存图片和导出文件,config/ 保存运行配置与模型密钥,logs/ 保存日志。删除安装目录或更换源码包不会删除这些作品数据。

备份与恢复

备份包含作品、工作稿、Agent 草稿与方案、消息、任务、候选、快照和本地对象文件,不包含模型 Key、安装令牌、日志或临时文件。备份和恢复前需要停止 Lantern:

./lantern stop
./lantern backup:create
./lantern backup:restore "/path/to/lantern-backup-<time>.zip"

恢复前会验证 manifest、SHA-256 和 SQLite 完整性;验证失败不会替换当前作品。

一次性覆盖运行设置
变量用途
LANTERN_DATA_DIR指定数据目录
WEB_PORT指定 Web 端口
API_PORT指定本地 API 端口
LANTERN_NO_OPEN=1启动后不自动打开浏览器

macOS 示例:

LANTERN_DATA_DIR="$HOME/LanternData" WEB_PORT=3100 npm start

诊断与支持范围

遇到启动或数据问题时,先运行:

./lantern doctor

doctor 检查 Node.js 版本、数据目录写入权限、Provider 配置权限、SQLite 完整性、已引用对象文件和运行服务健康状态,不显示模型 Key 或安装令牌。

进一步排查
  1. 确认 config/runtime.json 中的 Web 与 API 端口未被占用。
  2. 查看数据目录中的 logs/api.loglogs/web.log
  3. 修正问题后重新运行 ./lantern start

当前发行单位是可运行源码包,尚未提供独立图形安装器。正式发行以 GitHub Actions 的实际验收结果为准;当前验收覆盖 macOS 14 和 Windows Server 2022,Linux 未列入支持范围。

开发与构建

开发模式使用与正式启动相同的本地数据和服务边界:

./lantern dev

常用验证命令:

./lantern typecheck
./lantern test
./lantern test:integration
./lantern lint
./lantern build

Windows 将 ./lantern 换成 lantern.cmd

创建可分发的源码 ZIP 和 SHA-256 校验文件:

./lantern package:release

产物写入 release/lantern-<version>-source.ziprelease/SHA256SUMS。推送与 package.json 一致的 v<version> 标签后,GitHub Actions 会验证、打包并创建 GitHub Release。

架构与文档

Web (React / Vinext)
→ Fastify API
→ Domain Service / Capability
→ SQLite / Prisma
→ Local Task Runner → Model Provider
→ Local Object Storage
  • apps/web 是浏览器工作台,apps/api 是只监听 loopback 的本地 API 服务。

  • packages/shared 提供 LCD、工作区命令和共享契约,packages/editor-corepackages/layout-engine 提供确定性编辑和页面布局能力。

  • packages/server 负责本地持久化与对象存储,packages/agent-runtime 保留 Agent 上下文、任务和模型适配基础。当前工作台与通过 MCP 接入的外部 Agent 共享领域服务、Editor Capability 和作品写入规则;内置 Agent 尚未完善。

文档内容
文档入口产品、编辑器、LCD 与 Agent 正式文档的阅读顺序
LCD作品结构、坐标、分层、资源引用和写入不变量
AgentAgent 能力、上下文、任务、Candidate 和扩展边界
开发边界仓库导航、稳定架构边界和交付要求

许可证与反馈

Lantern 使用 MIT License 开源。

如果遇到问题或希望提交功能建议,请使用 GitHub Issues。提交前请勿公开模型 Key、安装令牌、本地路径或未公开作品内容。

About

面向个人漫画创作者的开源漫画工作台,支持故事与资产管理、页面与画格编排、预览与导出,并通过 MCP + Skill 接入外部 AI Agent。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

Lantern AI:一盏灯,陪你打磨漫画故事

持续开发中Open source under the MIT LicensemacOS and WindowsNode.js 22.13 or newer

下载 · 快速开始 · 当前能力 · 文档 · MCP + Skill

Lantern AI 是面向个人漫画创作者的开源漫画工作台。它把故事与资产管理、页面与画格编排、单格精修、预览与导出放在一个持续可编辑的创作空间中,并通过 MCP + Skill 接入外部 AI Agent,让创作者始终掌握关键创作决定。

产品设计

Lantern 以 LCD 作品协议为基础,在统一的漫画画布和受控编辑边界内支持创作者与 Agent 协作:

  • LCD 作品协议:LCD 统一表达页面、画格、图层、格内内容和固定资产版本,工作台、候选预览、阅读与导出共享同一份作品事实。

  • 漫画画布:页面或滚动段位于工作台中央,资产、分镜、参考图片和 Agent 对话围绕作品展开;参考图片只有明确放入画格或纸面后才进入成稿。

  • 受控编辑:工作台与通过 MCP 接入的外部 Agent 共用语义能力和作品边界;工作台编辑进入可撤销工作稿,Agent 的一话任务进入隔离草稿并在完成后形成可整体审查的方案。

工作台 / 外部 Agent(MCP + Skill)/ 内置 Agent(尚未完善)
↓
受控语义能力
↓
工作稿 / Candidate / 隔离 Agent 草稿
↓
用户审查并保存正式版本
↓
LCD 预览与导出

Lantern AI 漫画工作台主界面

漫画编排与 Agent 协作工作台

当前能力状态

已接入 🟡 部分接入  未接入  不涉及

能力UI 编辑器MCP内置 Agent
漫画、一话与故事设定管理
资产卡、漫画封面、视觉风格与多图片管理
页漫正文、封面、过场与直接新建真正双页
条漫滚动段与跨段编排
画格创建、边框、层级、出血、阅读顺序与跨页格
外部图片上传与固定版本登记
格内、纸面与跨页图片放置、裁切与有限破格🟡
同源透明前景绑定真出格🟡
单格分镜条目创建与编辑
对白、气泡、旁白与基础文字编排
固定原图、当前工作稿与最近保存页面的只读观察🟡
单页构图与人物/场景/风格一致性检查
相邻分镜连续性与创作表达检查
格内图片、角色与场景资产生成
Candidate 查看、应用与冲突保护🟡
Agent 隔离草稿、方案链接与整体审查
批注处理、图片附件、精确定位与 Agent 方案关联
正式版本列表、对比与指定版本回退
阅读预览、图片下载与 LCD 导入导出
画内效果与表现型气泡🟡
选区、遮罩、局部重画与扩图
页面布局、多页与多对象生成
漫画解析与可复用模板制作

具体拆分和差异见漫画能力矩阵

快速开始

需要带 npm 的 Node.js 22.13 或更高版本。当前发行验收覆盖 macOS 和 Windows。

推荐从 GitHub Releases 下载 lantern-<version>-source.zip 和同版本的 SHA256SUMS。也可以直接获取源码:

git clone https://github.com/lanseqingling/lantern.git
cd lantern

在解压或克隆后的目录中启动:

./lantern start

Windows 使用 lantern.cmd start

首次启动会准备锁定依赖、初始化本地数据并生成生产界面。之后源码或共享包发生变化时,start 会在启动前自动更新过期的生产构建。工作台默认打开 http://localhost:18788

校验下载的 Release 包

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

$archive=Get-ChildItem .\lantern-*-source.zip |Select-Object-First 1$expected= (Get-Content .\SHA256SUMS).Split()[0].ToLower()
$actual= (Get-FileHash$archive-Algorithm SHA256).Hash.ToLower()
$actual-eq$expected

校验通过后再解压源码包。

使用 MCP + Skill 与外部 Agent 创作

内置 Agent 尚未完善。Lantern 现阶段以工作台和 MCP + Skill 为主要创作方式。

需要从兼容的本地 Agent 使用 Lantern 时,先启动 Lantern,再让该 Agent 在 Lantern 目录中运行:

./lantern agent:install

Windows 使用 lantern.cmd agent:install。命令会识别当前 Agent,安装 Lantern 应用级 Skill 并登记本地 MCP。Agent 只能使用 Lantern 当前显式开放的受控能力;Lantern 升级、端口或凭证变化后,重复运行同一命令即可同步。详细边界见 Agent

第一次使用可以从 外部 Agent 创作快速上手 开始,直接复制几个简单 Prompt,体验创建作品、编排页面、继续修改和视觉检查。外部 Agent 完成一话内容任务后会返回本地审查链接;你也可以从工作台右上角的历史入口查看方案,决定应用并保存、保留或丢弃。

运行与数据

在源码或发行目录中,macOS 使用 ./lantern <command>,Windows 使用 lantern.cmd <command>

如果希望在任意目录直接使用 lantern,先在 Lantern 目录运行一次:

npm link

之后可以在任意目录执行 lantern startlantern agent:install 等命令。

命令用途
./lantern start启动 Lantern
./lantern status查看当前运行状态
./lantern stop停止 Lantern 管理的本地服务
./lantern doctor检查环境、配置、数据库、对象文件和服务状态
./lantern agent:install安装或同步 MCP 与 Skill
./lantern backup:create创建一致备份
./lantern backup:restore <backup-file>恢复一致备份
系统默认数据目录
macOS~/Library/Application Support/Lantern
Windows%APPDATA%\Lantern

lantern.db 保存作品与任务状态,objects/ 保存图片和导出文件,config/ 保存运行配置与模型密钥,logs/ 保存日志。删除安装目录或更换源码包不会删除这些作品数据。

备份与恢复

备份包含作品、工作稿、Agent 草稿与方案、消息、任务、候选、快照和本地对象文件,不包含模型 Key、安装令牌、日志或临时文件。备份和恢复前需要停止 Lantern:

./lantern stop
./lantern backup:create
./lantern backup:restore "/path/to/lantern-backup-<time>.zip"

恢复前会验证 manifest、SHA-256 和 SQLite 完整性;验证失败不会替换当前作品。

一次性覆盖运行设置
变量用途
LANTERN_DATA_DIR指定数据目录
WEB_PORT指定 Web 端口
API_PORT指定本地 API 端口
LANTERN_NO_OPEN=1启动后不自动打开浏览器

macOS 示例:

LANTERN_DATA_DIR="$HOME/LanternData" WEB_PORT=3100 npm start

诊断与支持范围

遇到启动或数据问题时,先运行:

./lantern doctor

doctor 检查 Node.js 版本、数据目录写入权限、Provider 配置权限、SQLite 完整性、已引用对象文件和运行服务健康状态,不显示模型 Key 或安装令牌。

进一步排查
  1. 确认 config/runtime.json 中的 Web 与 API 端口未被占用。
  2. 查看数据目录中的 logs/api.loglogs/web.log
  3. 修正问题后重新运行 ./lantern start

当前发行单位是可运行源码包,尚未提供独立图形安装器。正式发行以 GitHub Actions 的实际验收结果为准;当前验收覆盖 macOS 14 和 Windows Server 2022,Linux 未列入支持范围。

开发与构建

开发模式使用与正式启动相同的本地数据和服务边界:

./lantern dev

常用验证命令:

./lantern typecheck
./lantern test
./lantern test:integration
./lantern lint
./lantern build

Windows 将 ./lantern 换成 lantern.cmd

创建可分发的源码 ZIP 和 SHA-256 校验文件:

./lantern package:release

产物写入 release/lantern-<version>-source.ziprelease/SHA256SUMS。推送与 package.json 一致的 v<version> 标签后,GitHub Actions 会验证、打包并创建 GitHub Release。

架构与文档

Web (React / Vinext)
→ Fastify API
→ Domain Service / Capability
→ SQLite / Prisma
→ Local Task Runner → Model Provider
→ Local Object Storage
  • apps/web 是浏览器工作台,apps/api 是只监听 loopback 的本地 API 服务。

  • packages/shared 提供 LCD、工作区命令和共享契约,packages/editor-corepackages/layout-engine 提供确定性编辑和页面布局能力。

  • packages/server 负责本地持久化与对象存储,packages/agent-runtime 保留 Agent 上下文、任务和模型适配基础。当前工作台与通过 MCP 接入的外部 Agent 共享领域服务、Editor Capability 和作品写入规则;内置 Agent 尚未完善。

文档内容
文档入口产品、编辑器、LCD 与 Agent 正式文档的阅读顺序
LCD作品结构、坐标、分层、资源引用和写入不变量
AgentAgent 能力、上下文、任务、Candidate 和扩展边界
开发边界仓库导航、稳定架构边界和交付要求

许可证与反馈

Lantern 使用 MIT License 开源。

如果遇到问题或希望提交功能建议,请使用 GitHub Issues。提交前请勿公开模型 Key、安装令牌、本地路径或未公开作品内容。

About

面向个人漫画创作者的开源漫画工作台,支持故事与资产管理、页面与画格编排、预览与导出,并通过 MCP + Skill 接入外部 AI Agent。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Repository files navigation

Lantern AI:一盏灯,陪你打磨漫画故事

持续开发中Open source under the MIT LicensemacOS and WindowsNode.js 22.13 or newer

下载 · 快速开始 · 当前能力 · 文档 · MCP + Skill

Lantern AI 是面向个人漫画创作者的开源漫画工作台。它把故事与资产管理、页面与画格编排、单格精修、预览与导出放在一个持续可编辑的创作空间中,并通过 MCP + Skill 接入外部 AI Agent,让创作者始终掌握关键创作决定。

产品设计

Lantern 以 LCD 作品协议为基础,在统一的漫画画布和受控编辑边界内支持创作者与 Agent 协作:

  • LCD 作品协议:LCD 统一表达页面、画格、图层、格内内容和固定资产版本,工作台、候选预览、阅读与导出共享同一份作品事实。

  • 漫画画布:页面或滚动段位于工作台中央,资产、分镜、参考图片和 Agent 对话围绕作品展开;参考图片只有明确放入画格或纸面后才进入成稿。

  • 受控编辑:工作台与通过 MCP 接入的外部 Agent 共用语义能力和作品边界;工作台编辑进入可撤销工作稿,Agent 的一话任务进入隔离草稿并在完成后形成可整体审查的方案。

工作台 / 外部 Agent(MCP + Skill)/ 内置 Agent(尚未完善)
↓
受控语义能力
↓
工作稿 / Candidate / 隔离 Agent 草稿
↓
用户审查并保存正式版本
↓
LCD 预览与导出

Lantern AI 漫画工作台主界面

漫画编排与 Agent 协作工作台

当前能力状态

已接入 🟡 部分接入  未接入  不涉及

能力UI 编辑器MCP内置 Agent
漫画、一话与故事设定管理
资产卡、漫画封面、视觉风格与多图片管理
页漫正文、封面、过场与直接新建真正双页
条漫滚动段与跨段编排
画格创建、边框、层级、出血、阅读顺序与跨页格
外部图片上传与固定版本登记
格内、纸面与跨页图片放置、裁切与有限破格🟡
同源透明前景绑定真出格🟡
单格分镜条目创建与编辑
对白、气泡、旁白与基础文字编排
固定原图、当前工作稿与最近保存页面的只读观察🟡
单页构图与人物/场景/风格一致性检查
相邻分镜连续性与创作表达检查
格内图片、角色与场景资产生成
Candidate 查看、应用与冲突保护🟡
Agent 隔离草稿、方案链接与整体审查
批注处理、图片附件、精确定位与 Agent 方案关联
正式版本列表、对比与指定版本回退
阅读预览、图片下载与 LCD 导入导出
画内效果与表现型气泡🟡
选区、遮罩、局部重画与扩图
页面布局、多页与多对象生成
漫画解析与可复用模板制作

具体拆分和差异见漫画能力矩阵

快速开始

需要带 npm 的 Node.js 22.13 或更高版本。当前发行验收覆盖 macOS 和 Windows。

推荐从 GitHub Releases 下载 lantern-<version>-source.zip 和同版本的 SHA256SUMS。也可以直接获取源码:

git clone https://github.com/lanseqingling/lantern.git
cd lantern

在解压或克隆后的目录中启动:

./lantern start

Windows 使用 lantern.cmd start

首次启动会准备锁定依赖、初始化本地数据并生成生产界面。之后源码或共享包发生变化时,start 会在启动前自动更新过期的生产构建。工作台默认打开 http://localhost:18788

校验下载的 Release 包

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

$archive=Get-ChildItem .\lantern-*-source.zip |Select-Object-First 1$expected= (Get-Content .\SHA256SUMS).Split()[0].ToLower()
$actual= (Get-FileHash$archive-Algorithm SHA256).Hash.ToLower()
$actual-eq$expected

校验通过后再解压源码包。

使用 MCP + Skill 与外部 Agent 创作

内置 Agent 尚未完善。Lantern 现阶段以工作台和 MCP + Skill 为主要创作方式。

需要从兼容的本地 Agent 使用 Lantern 时,先启动 Lantern,再让该 Agent 在 Lantern 目录中运行:

./lantern agent:install

Windows 使用 lantern.cmd agent:install。命令会识别当前 Agent,安装 Lantern 应用级 Skill 并登记本地 MCP。Agent 只能使用 Lantern 当前显式开放的受控能力;Lantern 升级、端口或凭证变化后,重复运行同一命令即可同步。详细边界见 Agent

第一次使用可以从 外部 Agent 创作快速上手 开始,直接复制几个简单 Prompt,体验创建作品、编排页面、继续修改和视觉检查。外部 Agent 完成一话内容任务后会返回本地审查链接;你也可以从工作台右上角的历史入口查看方案,决定应用并保存、保留或丢弃。

运行与数据

在源码或发行目录中,macOS 使用 ./lantern <command>,Windows 使用 lantern.cmd <command>

如果希望在任意目录直接使用 lantern,先在 Lantern 目录运行一次:

npm link

之后可以在任意目录执行 lantern startlantern agent:install 等命令。

命令用途
./lantern start启动 Lantern
./lantern status查看当前运行状态
./lantern stop停止 Lantern 管理的本地服务
./lantern doctor检查环境、配置、数据库、对象文件和服务状态
./lantern agent:install安装或同步 MCP 与 Skill
./lantern backup:create创建一致备份
./lantern backup:restore <backup-file>恢复一致备份
系统默认数据目录
macOS~/Library/Application Support/Lantern
Windows%APPDATA%\Lantern

lantern.db 保存作品与任务状态,objects/ 保存图片和导出文件,config/ 保存运行配置与模型密钥,logs/ 保存日志。删除安装目录或更换源码包不会删除这些作品数据。

备份与恢复

备份包含作品、工作稿、Agent 草稿与方案、消息、任务、候选、快照和本地对象文件,不包含模型 Key、安装令牌、日志或临时文件。备份和恢复前需要停止 Lantern:

./lantern stop
./lantern backup:create
./lantern backup:restore "/path/to/lantern-backup-<time>.zip"

恢复前会验证 manifest、SHA-256 和 SQLite 完整性;验证失败不会替换当前作品。

一次性覆盖运行设置
变量用途
LANTERN_DATA_DIR指定数据目录
WEB_PORT指定 Web 端口
API_PORT指定本地 API 端口
LANTERN_NO_OPEN=1启动后不自动打开浏览器

macOS 示例:

LANTERN_DATA_DIR="$HOME/LanternData" WEB_PORT=3100 npm start

诊断与支持范围

遇到启动或数据问题时,先运行:

./lantern doctor

doctor 检查 Node.js 版本、数据目录写入权限、Provider 配置权限、SQLite 完整性、已引用对象文件和运行服务健康状态,不显示模型 Key 或安装令牌。

进一步排查
  1. 确认 config/runtime.json 中的 Web 与 API 端口未被占用。
  2. 查看数据目录中的 logs/api.loglogs/web.log
  3. 修正问题后重新运行 ./lantern start

当前发行单位是可运行源码包,尚未提供独立图形安装器。正式发行以 GitHub Actions 的实际验收结果为准;当前验收覆盖 macOS 14 和 Windows Server 2022,Linux 未列入支持范围。

开发与构建

开发模式使用与正式启动相同的本地数据和服务边界:

./lantern dev

常用验证命令:

./lantern typecheck
./lantern test
./lantern test:integration
./lantern lint
./lantern build

Windows 将 ./lantern 换成 lantern.cmd

创建可分发的源码 ZIP 和 SHA-256 校验文件:

./lantern package:release

产物写入 release/lantern-<version>-source.ziprelease/SHA256SUMS。推送与 package.json 一致的 v<version> 标签后,GitHub Actions 会验证、打包并创建 GitHub Release。

架构与文档

Web (React / Vinext)
→ Fastify API
→ Domain Service / Capability
→ SQLite / Prisma
→ Local Task Runner → Model Provider
→ Local Object Storage
  • apps/web 是浏览器工作台,apps/api 是只监听 loopback 的本地 API 服务。

  • packages/shared 提供 LCD、工作区命令和共享契约,packages/editor-corepackages/layout-engine 提供确定性编辑和页面布局能力。

  • packages/server 负责本地持久化与对象存储,packages/agent-runtime 保留 Agent 上下文、任务和模型适配基础。当前工作台与通过 MCP 接入的外部 Agent 共享领域服务、Editor Capability 和作品写入规则;内置 Agent 尚未完善。

文档内容
文档入口产品、编辑器、LCD 与 Agent 正式文档的阅读顺序
LCD作品结构、坐标、分层、资源引用和写入不变量
AgentAgent 能力、上下文、任务、Candidate 和扩展边界
开发边界仓库导航、稳定架构边界和交付要求

许可证与反馈

Lantern 使用 MIT License 开源。

如果遇到问题或希望提交功能建议,请使用 GitHub Issues。提交前请勿公开模型 Key、安装令牌、本地路径或未公开作品内容。

About

面向个人漫画创作者的开源漫画工作台,支持故事与资产管理、页面与画格编排、预览与导出,并通过 MCP + Skill 接入外部 AI Agent。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

Lantern AI:一盏灯,陪你打磨漫画故事

持续开发中Open source under the MIT LicensemacOS and WindowsNode.js 22.13 or newer

下载 · 快速开始 · 当前能力 · 文档 · MCP + Skill

Lantern AI 是面向个人漫画创作者的开源漫画工作台。它把故事与资产管理、页面与画格编排、单格精修、预览与导出放在一个持续可编辑的创作空间中,并通过 MCP + Skill 接入外部 AI Agent,让创作者始终掌握关键创作决定。

产品设计

Lantern 以 LCD 作品协议为基础,在统一的漫画画布和受控编辑边界内支持创作者与 Agent 协作:

  • LCD 作品协议:LCD 统一表达页面、画格、图层、格内内容和固定资产版本,工作台、候选预览、阅读与导出共享同一份作品事实。

  • 漫画画布:页面或滚动段位于工作台中央,资产、分镜、参考图片和 Agent 对话围绕作品展开;参考图片只有明确放入画格或纸面后才进入成稿。

  • 受控编辑:工作台与通过 MCP 接入的外部 Agent 共用语义能力和作品边界;工作台编辑进入可撤销工作稿,Agent 的一话任务进入隔离草稿并在完成后形成可整体审查的方案。

工作台 / 外部 Agent(MCP + Skill)/ 内置 Agent(尚未完善)
↓
受控语义能力
↓
工作稿 / Candidate / 隔离 Agent 草稿
↓
用户审查并保存正式版本
↓
LCD 预览与导出

Lantern AI 漫画工作台主界面

漫画编排与 Agent 协作工作台

当前能力状态

已接入 🟡 部分接入  未接入  不涉及

能力UI 编辑器MCP内置 Agent
漫画、一话与故事设定管理
资产卡、漫画封面、视觉风格与多图片管理
页漫正文、封面、过场与直接新建真正双页
条漫滚动段与跨段编排
画格创建、边框、层级、出血、阅读顺序与跨页格
外部图片上传与固定版本登记
格内、纸面与跨页图片放置、裁切与有限破格🟡
同源透明前景绑定真出格🟡
单格分镜条目创建与编辑
对白、气泡、旁白与基础文字编排
固定原图、当前工作稿与最近保存页面的只读观察🟡
单页构图与人物/场景/风格一致性检查
相邻分镜连续性与创作表达检查
格内图片、角色与场景资产生成
Candidate 查看、应用与冲突保护🟡
Agent 隔离草稿、方案链接与整体审查
批注处理、图片附件、精确定位与 Agent 方案关联
正式版本列表、对比与指定版本回退
阅读预览、图片下载与 LCD 导入导出
画内效果与表现型气泡🟡
选区、遮罩、局部重画与扩图
页面布局、多页与多对象生成
漫画解析与可复用模板制作

具体拆分和差异见漫画能力矩阵

快速开始

需要带 npm 的 Node.js 22.13 或更高版本。当前发行验收覆盖 macOS 和 Windows。

推荐从 GitHub Releases 下载 lantern-<version>-source.zip 和同版本的 SHA256SUMS。也可以直接获取源码:

git clone https://github.com/lanseqingling/lantern.git
cd lantern

在解压或克隆后的目录中启动:

./lantern start

Windows 使用 lantern.cmd start

首次启动会准备锁定依赖、初始化本地数据并生成生产界面。之后源码或共享包发生变化时,start 会在启动前自动更新过期的生产构建。工作台默认打开 http://localhost:18788

校验下载的 Release 包

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

$archive=Get-ChildItem .\lantern-*-source.zip |Select-Object-First 1$expected= (Get-Content .\SHA256SUMS).Split()[0].ToLower()
$actual= (Get-FileHash$archive-Algorithm SHA256).Hash.ToLower()
$actual-eq$expected

校验通过后再解压源码包。

使用 MCP + Skill 与外部 Agent 创作

内置 Agent 尚未完善。Lantern 现阶段以工作台和 MCP + Skill 为主要创作方式。

需要从兼容的本地 Agent 使用 Lantern 时,先启动 Lantern,再让该 Agent 在 Lantern 目录中运行:

./lantern agent:install

Windows 使用 lantern.cmd agent:install。命令会识别当前 Agent,安装 Lantern 应用级 Skill 并登记本地 MCP。Agent 只能使用 Lantern 当前显式开放的受控能力;Lantern 升级、端口或凭证变化后,重复运行同一命令即可同步。详细边界见 Agent

第一次使用可以从 外部 Agent 创作快速上手 开始,直接复制几个简单 Prompt,体验创建作品、编排页面、继续修改和视觉检查。外部 Agent 完成一话内容任务后会返回本地审查链接;你也可以从工作台右上角的历史入口查看方案,决定应用并保存、保留或丢弃。

运行与数据

在源码或发行目录中,macOS 使用 ./lantern <command>,Windows 使用 lantern.cmd <command>

如果希望在任意目录直接使用 lantern,先在 Lantern 目录运行一次:

npm link

之后可以在任意目录执行 lantern startlantern agent:install 等命令。

命令用途
./lantern start启动 Lantern
./lantern status查看当前运行状态
./lantern stop停止 Lantern 管理的本地服务
./lantern doctor检查环境、配置、数据库、对象文件和服务状态
./lantern agent:install安装或同步 MCP 与 Skill
./lantern backup:create创建一致备份
./lantern backup:restore <backup-file>恢复一致备份
系统默认数据目录
macOS~/Library/Application Support/Lantern
Windows%APPDATA%\Lantern

lantern.db 保存作品与任务状态,objects/ 保存图片和导出文件,config/ 保存运行配置与模型密钥,logs/ 保存日志。删除安装目录或更换源码包不会删除这些作品数据。

备份与恢复

备份包含作品、工作稿、Agent 草稿与方案、消息、任务、候选、快照和本地对象文件,不包含模型 Key、安装令牌、日志或临时文件。备份和恢复前需要停止 Lantern:

./lantern stop
./lantern backup:create
./lantern backup:restore "/path/to/lantern-backup-<time>.zip"

恢复前会验证 manifest、SHA-256 和 SQLite 完整性;验证失败不会替换当前作品。

一次性覆盖运行设置
变量用途
LANTERN_DATA_DIR指定数据目录
WEB_PORT指定 Web 端口
API_PORT指定本地 API 端口
LANTERN_NO_OPEN=1启动后不自动打开浏览器

macOS 示例:

LANTERN_DATA_DIR="$HOME/LanternData" WEB_PORT=3100 npm start

诊断与支持范围

遇到启动或数据问题时,先运行:

./lantern doctor

doctor 检查 Node.js 版本、数据目录写入权限、Provider 配置权限、SQLite 完整性、已引用对象文件和运行服务健康状态,不显示模型 Key 或安装令牌。

进一步排查
  1. 确认 config/runtime.json 中的 Web 与 API 端口未被占用。
  2. 查看数据目录中的 logs/api.loglogs/web.log
  3. 修正问题后重新运行 ./lantern start

当前发行单位是可运行源码包,尚未提供独立图形安装器。正式发行以 GitHub Actions 的实际验收结果为准;当前验收覆盖 macOS 14 和 Windows Server 2022,Linux 未列入支持范围。

开发与构建

开发模式使用与正式启动相同的本地数据和服务边界:

./lantern dev

常用验证命令:

./lantern typecheck
./lantern test
./lantern test:integration
./lantern lint
./lantern build

Windows 将 ./lantern 换成 lantern.cmd

创建可分发的源码 ZIP 和 SHA-256 校验文件:

./lantern package:release

产物写入 release/lantern-<version>-source.ziprelease/SHA256SUMS。推送与 package.json 一致的 v<version> 标签后,GitHub Actions 会验证、打包并创建 GitHub Release。

架构与文档

Web (React / Vinext)
→ Fastify API
→ Domain Service / Capability
→ SQLite / Prisma
→ Local Task Runner → Model Provider
→ Local Object Storage
  • apps/web 是浏览器工作台,apps/api 是只监听 loopback 的本地 API 服务。

  • packages/shared 提供 LCD、工作区命令和共享契约,packages/editor-corepackages/layout-engine 提供确定性编辑和页面布局能力。

  • packages/server 负责本地持久化与对象存储,packages/agent-runtime 保留 Agent 上下文、任务和模型适配基础。当前工作台与通过 MCP 接入的外部 Agent 共享领域服务、Editor Capability 和作品写入规则;内置 Agent 尚未完善。

文档内容
文档入口产品、编辑器、LCD 与 Agent 正式文档的阅读顺序
LCD作品结构、坐标、分层、资源引用和写入不变量
AgentAgent 能力、上下文、任务、Candidate 和扩展边界
开发边界仓库导航、稳定架构边界和交付要求

许可证与反馈

Lantern 使用 MIT License 开源。

如果遇到问题或希望提交功能建议,请使用 GitHub Issues。提交前请勿公开模型 Key、安装令牌、本地路径或未公开作品内容。

About

面向个人漫画创作者的开源漫画工作台,支持故事与资产管理、页面与画格编排、预览与导出,并通过 MCP + Skill 接入外部 AI Agent。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

Lantern AI:一盏灯,陪你打磨漫画故事

持续开发中Open source under the MIT LicensemacOS and WindowsNode.js 22.13 or newer

下载 · 快速开始 · 当前能力 · 文档 · MCP + Skill

Lantern AI 是面向个人漫画创作者的开源漫画工作台。它把故事与资产管理、页面与画格编排、单格精修、预览与导出放在一个持续可编辑的创作空间中,并通过 MCP + Skill 接入外部 AI Agent,让创作者始终掌握关键创作决定。

产品设计

Lantern 以 LCD 作品协议为基础,在统一的漫画画布和受控编辑边界内支持创作者与 Agent 协作:

  • LCD 作品协议:LCD 统一表达页面、画格、图层、格内内容和固定资产版本,工作台、候选预览、阅读与导出共享同一份作品事实。

  • 漫画画布:页面或滚动段位于工作台中央,资产、分镜、参考图片和 Agent 对话围绕作品展开;参考图片只有明确放入画格或纸面后才进入成稿。

  • 受控编辑:工作台与通过 MCP 接入的外部 Agent 共用语义能力和作品边界;工作台编辑进入可撤销工作稿,Agent 的一话任务进入隔离草稿并在完成后形成可整体审查的方案。

工作台 / 外部 Agent(MCP + Skill)/ 内置 Agent(尚未完善)
↓
受控语义能力
↓
工作稿 / Candidate / 隔离 Agent 草稿
↓
用户审查并保存正式版本
↓
LCD 预览与导出

Lantern AI 漫画工作台主界面

漫画编排与 Agent 协作工作台

当前能力状态

已接入 🟡 部分接入  未接入  不涉及

能力UI 编辑器MCP内置 Agent
漫画、一话与故事设定管理
资产卡、漫画封面、视觉风格与多图片管理
页漫正文、封面、过场与直接新建真正双页
条漫滚动段与跨段编排
画格创建、边框、层级、出血、阅读顺序与跨页格
外部图片上传与固定版本登记
格内、纸面与跨页图片放置、裁切与有限破格🟡
同源透明前景绑定真出格🟡
单格分镜条目创建与编辑
对白、气泡、旁白与基础文字编排
固定原图、当前工作稿与最近保存页面的只读观察🟡
单页构图与人物/场景/风格一致性检查
相邻分镜连续性与创作表达检查
格内图片、角色与场景资产生成
Candidate 查看、应用与冲突保护🟡
Agent 隔离草稿、方案链接与整体审查
批注处理、图片附件、精确定位与 Agent 方案关联
正式版本列表、对比与指定版本回退
阅读预览、图片下载与 LCD 导入导出
画内效果与表现型气泡🟡
选区、遮罩、局部重画与扩图
页面布局、多页与多对象生成
漫画解析与可复用模板制作

具体拆分和差异见漫画能力矩阵

快速开始

需要带 npm 的 Node.js 22.13 或更高版本。当前发行验收覆盖 macOS 和 Windows。

推荐从 GitHub Releases 下载 lantern-<version>-source.zip 和同版本的 SHA256SUMS。也可以直接获取源码:

git clone https://github.com/lanseqingling/lantern.git
cd lantern

在解压或克隆后的目录中启动:

./lantern start

Windows 使用 lantern.cmd start

首次启动会准备锁定依赖、初始化本地数据并生成生产界面。之后源码或共享包发生变化时,start 会在启动前自动更新过期的生产构建。工作台默认打开 http://localhost:18788

校验下载的 Release 包

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

$archive=Get-ChildItem .\lantern-*-source.zip |Select-Object-First 1$expected= (Get-Content .\SHA256SUMS).Split()[0].ToLower()
$actual= (Get-FileHash$archive-Algorithm SHA256).Hash.ToLower()
$actual-eq$expected

校验通过后再解压源码包。

使用 MCP + Skill 与外部 Agent 创作

内置 Agent 尚未完善。Lantern 现阶段以工作台和 MCP + Skill 为主要创作方式。

需要从兼容的本地 Agent 使用 Lantern 时,先启动 Lantern,再让该 Agent 在 Lantern 目录中运行:

./lantern agent:install

Windows 使用 lantern.cmd agent:install。命令会识别当前 Agent,安装 Lantern 应用级 Skill 并登记本地 MCP。Agent 只能使用 Lantern 当前显式开放的受控能力;Lantern 升级、端口或凭证变化后,重复运行同一命令即可同步。详细边界见 Agent

第一次使用可以从 外部 Agent 创作快速上手 开始,直接复制几个简单 Prompt,体验创建作品、编排页面、继续修改和视觉检查。外部 Agent 完成一话内容任务后会返回本地审查链接;你也可以从工作台右上角的历史入口查看方案,决定应用并保存、保留或丢弃。

运行与数据

在源码或发行目录中,macOS 使用 ./lantern <command>,Windows 使用 lantern.cmd <command>

如果希望在任意目录直接使用 lantern,先在 Lantern 目录运行一次:

npm link

之后可以在任意目录执行 lantern startlantern agent:install 等命令。

命令用途
./lantern start启动 Lantern
./lantern status查看当前运行状态
./lantern stop停止 Lantern 管理的本地服务
./lantern doctor检查环境、配置、数据库、对象文件和服务状态
./lantern agent:install安装或同步 MCP 与 Skill
./lantern backup:create创建一致备份
./lantern backup:restore <backup-file>恢复一致备份
系统默认数据目录
macOS~/Library/Application Support/Lantern
Windows%APPDATA%\Lantern

lantern.db 保存作品与任务状态,objects/ 保存图片和导出文件,config/ 保存运行配置与模型密钥,logs/ 保存日志。删除安装目录或更换源码包不会删除这些作品数据。

备份与恢复

备份包含作品、工作稿、Agent 草稿与方案、消息、任务、候选、快照和本地对象文件,不包含模型 Key、安装令牌、日志或临时文件。备份和恢复前需要停止 Lantern:

./lantern stop
./lantern backup:create
./lantern backup:restore "/path/to/lantern-backup-<time>.zip"

恢复前会验证 manifest、SHA-256 和 SQLite 完整性;验证失败不会替换当前作品。

一次性覆盖运行设置
变量用途
LANTERN_DATA_DIR指定数据目录
WEB_PORT指定 Web 端口
API_PORT指定本地 API 端口
LANTERN_NO_OPEN=1启动后不自动打开浏览器

macOS 示例:

LANTERN_DATA_DIR="$HOME/LanternData" WEB_PORT=3100 npm start

诊断与支持范围

遇到启动或数据问题时,先运行:

./lantern doctor

doctor 检查 Node.js 版本、数据目录写入权限、Provider 配置权限、SQLite 完整性、已引用对象文件和运行服务健康状态,不显示模型 Key 或安装令牌。

进一步排查
  1. 确认 config/runtime.json 中的 Web 与 API 端口未被占用。
  2. 查看数据目录中的 logs/api.loglogs/web.log
  3. 修正问题后重新运行 ./lantern start

当前发行单位是可运行源码包,尚未提供独立图形安装器。正式发行以 GitHub Actions 的实际验收结果为准;当前验收覆盖 macOS 14 和 Windows Server 2022,Linux 未列入支持范围。

开发与构建

开发模式使用与正式启动相同的本地数据和服务边界:

./lantern dev

常用验证命令:

./lantern typecheck
./lantern test
./lantern test:integration
./lantern lint
./lantern build

Windows 将 ./lantern 换成 lantern.cmd

创建可分发的源码 ZIP 和 SHA-256 校验文件:

./lantern package:release

产物写入 release/lantern-<version>-source.ziprelease/SHA256SUMS。推送与 package.json 一致的 v<version> 标签后,GitHub Actions 会验证、打包并创建 GitHub Release。

架构与文档

Web (React / Vinext)
→ Fastify API
→ Domain Service / Capability
→ SQLite / Prisma
→ Local Task Runner → Model Provider
→ Local Object Storage
  • apps/web 是浏览器工作台,apps/api 是只监听 loopback 的本地 API 服务。

  • packages/shared 提供 LCD、工作区命令和共享契约,packages/editor-corepackages/layout-engine 提供确定性编辑和页面布局能力。

  • packages/server 负责本地持久化与对象存储,packages/agent-runtime 保留 Agent 上下文、任务和模型适配基础。当前工作台与通过 MCP 接入的外部 Agent 共享领域服务、Editor Capability 和作品写入规则;内置 Agent 尚未完善。

文档内容
文档入口产品、编辑器、LCD 与 Agent 正式文档的阅读顺序
LCD作品结构、坐标、分层、资源引用和写入不变量
AgentAgent 能力、上下文、任务、Candidate 和扩展边界
开发边界仓库导航、稳定架构边界和交付要求

许可证与反馈

Lantern 使用 MIT License 开源。

如果遇到问题或希望提交功能建议,请使用 GitHub Issues。提交前请勿公开模型 Key、安装令牌、本地路径或未公开作品内容。

About

面向个人漫画创作者的开源漫画工作台,支持故事与资产管理、页面与画格编排、预览与导出,并通过 MCP + Skill 接入外部 AI Agent。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Repository files navigation

Lantern AI:一盏灯,陪你打磨漫画故事

持续开发中Open source under the MIT LicensemacOS and WindowsNode.js 22.13 or newer

下载 · 快速开始 · 当前能力 · 文档 · MCP + Skill

Lantern AI 是面向个人漫画创作者的开源漫画工作台。它把故事与资产管理、页面与画格编排、单格精修、预览与导出放在一个持续可编辑的创作空间中,并通过 MCP + Skill 接入外部 AI Agent,让创作者始终掌握关键创作决定。

产品设计

Lantern 以 LCD 作品协议为基础,在统一的漫画画布和受控编辑边界内支持创作者与 Agent 协作:

  • LCD 作品协议:LCD 统一表达页面、画格、图层、格内内容和固定资产版本,工作台、候选预览、阅读与导出共享同一份作品事实。

  • 漫画画布:页面或滚动段位于工作台中央,资产、分镜、参考图片和 Agent 对话围绕作品展开;参考图片只有明确放入画格或纸面后才进入成稿。

  • 受控编辑:工作台与通过 MCP 接入的外部 Agent 共用语义能力和作品边界;工作台编辑进入可撤销工作稿,Agent 的一话任务进入隔离草稿并在完成后形成可整体审查的方案。

工作台 / 外部 Agent(MCP + Skill)/ 内置 Agent(尚未完善)
↓
受控语义能力
↓
工作稿 / Candidate / 隔离 Agent 草稿
↓
用户审查并保存正式版本
↓
LCD 预览与导出

Lantern AI 漫画工作台主界面

漫画编排与 Agent 协作工作台

当前能力状态

已接入 🟡 部分接入  未接入  不涉及

能力UI 编辑器MCP内置 Agent
漫画、一话与故事设定管理
资产卡、漫画封面、视觉风格与多图片管理
页漫正文、封面、过场与直接新建真正双页
条漫滚动段与跨段编排
画格创建、边框、层级、出血、阅读顺序与跨页格
外部图片上传与固定版本登记
格内、纸面与跨页图片放置、裁切与有限破格🟡
同源透明前景绑定真出格🟡
单格分镜条目创建与编辑
对白、气泡、旁白与基础文字编排
固定原图、当前工作稿与最近保存页面的只读观察🟡
单页构图与人物/场景/风格一致性检查
相邻分镜连续性与创作表达检查
格内图片、角色与场景资产生成
Candidate 查看、应用与冲突保护🟡
Agent 隔离草稿、方案链接与整体审查
批注处理、图片附件、精确定位与 Agent 方案关联
正式版本列表、对比与指定版本回退
阅读预览、图片下载与 LCD 导入导出
画内效果与表现型气泡🟡
选区、遮罩、局部重画与扩图
页面布局、多页与多对象生成
漫画解析与可复用模板制作

具体拆分和差异见漫画能力矩阵

快速开始

需要带 npm 的 Node.js 22.13 或更高版本。当前发行验收覆盖 macOS 和 Windows。

推荐从 GitHub Releases 下载 lantern-<version>-source.zip 和同版本的 SHA256SUMS。也可以直接获取源码:

git clone https://github.com/lanseqingling/lantern.git
cd lantern

在解压或克隆后的目录中启动:

./lantern start

Windows 使用 lantern.cmd start

首次启动会准备锁定依赖、初始化本地数据并生成生产界面。之后源码或共享包发生变化时,start 会在启动前自动更新过期的生产构建。工作台默认打开 http://localhost:18788

校验下载的 Release 包

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

$archive=Get-ChildItem .\lantern-*-source.zip |Select-Object-First 1$expected= (Get-Content .\SHA256SUMS).Split()[0].ToLower()
$actual= (Get-FileHash$archive-Algorithm SHA256).Hash.ToLower()
$actual-eq$expected

校验通过后再解压源码包。

使用 MCP + Skill 与外部 Agent 创作

内置 Agent 尚未完善。Lantern 现阶段以工作台和 MCP + Skill 为主要创作方式。

需要从兼容的本地 Agent 使用 Lantern 时,先启动 Lantern,再让该 Agent 在 Lantern 目录中运行:

./lantern agent:install

Windows 使用 lantern.cmd agent:install。命令会识别当前 Agent,安装 Lantern 应用级 Skill 并登记本地 MCP。Agent 只能使用 Lantern 当前显式开放的受控能力;Lantern 升级、端口或凭证变化后,重复运行同一命令即可同步。详细边界见 Agent

第一次使用可以从 外部 Agent 创作快速上手 开始,直接复制几个简单 Prompt,体验创建作品、编排页面、继续修改和视觉检查。外部 Agent 完成一话内容任务后会返回本地审查链接;你也可以从工作台右上角的历史入口查看方案,决定应用并保存、保留或丢弃。

运行与数据

在源码或发行目录中,macOS 使用 ./lantern <command>,Windows 使用 lantern.cmd <command>

如果希望在任意目录直接使用 lantern,先在 Lantern 目录运行一次:

npm link

之后可以在任意目录执行 lantern startlantern agent:install 等命令。

命令用途
./lantern start启动 Lantern
./lantern status查看当前运行状态
./lantern stop停止 Lantern 管理的本地服务
./lantern doctor检查环境、配置、数据库、对象文件和服务状态
./lantern agent:install安装或同步 MCP 与 Skill
./lantern backup:create创建一致备份
./lantern backup:restore <backup-file>恢复一致备份
系统默认数据目录
macOS~/Library/Application Support/Lantern
Windows%APPDATA%\Lantern

lantern.db 保存作品与任务状态,objects/ 保存图片和导出文件,config/ 保存运行配置与模型密钥,logs/ 保存日志。删除安装目录或更换源码包不会删除这些作品数据。

备份与恢复

备份包含作品、工作稿、Agent 草稿与方案、消息、任务、候选、快照和本地对象文件,不包含模型 Key、安装令牌、日志或临时文件。备份和恢复前需要停止 Lantern:

./lantern stop
./lantern backup:create
./lantern backup:restore "/path/to/lantern-backup-<time>.zip"

恢复前会验证 manifest、SHA-256 和 SQLite 完整性;验证失败不会替换当前作品。

一次性覆盖运行设置
变量用途
LANTERN_DATA_DIR指定数据目录
WEB_PORT指定 Web 端口
API_PORT指定本地 API 端口
LANTERN_NO_OPEN=1启动后不自动打开浏览器

macOS 示例:

LANTERN_DATA_DIR="$HOME/LanternData" WEB_PORT=3100 npm start

诊断与支持范围

遇到启动或数据问题时,先运行:

./lantern doctor

doctor 检查 Node.js 版本、数据目录写入权限、Provider 配置权限、SQLite 完整性、已引用对象文件和运行服务健康状态,不显示模型 Key 或安装令牌。

进一步排查
  1. 确认 config/runtime.json 中的 Web 与 API 端口未被占用。
  2. 查看数据目录中的 logs/api.loglogs/web.log
  3. 修正问题后重新运行 ./lantern start

当前发行单位是可运行源码包,尚未提供独立图形安装器。正式发行以 GitHub Actions 的实际验收结果为准;当前验收覆盖 macOS 14 和 Windows Server 2022,Linux 未列入支持范围。

开发与构建

开发模式使用与正式启动相同的本地数据和服务边界:

./lantern dev

常用验证命令:

./lantern typecheck
./lantern test
./lantern test:integration
./lantern lint
./lantern build

Windows 将 ./lantern 换成 lantern.cmd

创建可分发的源码 ZIP 和 SHA-256 校验文件:

./lantern package:release

产物写入 release/lantern-<version>-source.ziprelease/SHA256SUMS。推送与 package.json 一致的 v<version> 标签后,GitHub Actions 会验证、打包并创建 GitHub Release。

架构与文档

Web (React / Vinext)
→ Fastify API
→ Domain Service / Capability
→ SQLite / Prisma
→ Local Task Runner → Model Provider
→ Local Object Storage
  • apps/web 是浏览器工作台,apps/api 是只监听 loopback 的本地 API 服务。

  • packages/shared 提供 LCD、工作区命令和共享契约,packages/editor-corepackages/layout-engine 提供确定性编辑和页面布局能力。

  • packages/server 负责本地持久化与对象存储,packages/agent-runtime 保留 Agent 上下文、任务和模型适配基础。当前工作台与通过 MCP 接入的外部 Agent 共享领域服务、Editor Capability 和作品写入规则;内置 Agent 尚未完善。

文档内容
文档入口产品、编辑器、LCD 与 Agent 正式文档的阅读顺序
LCD作品结构、坐标、分层、资源引用和写入不变量
AgentAgent 能力、上下文、任务、Candidate 和扩展边界
开发边界仓库导航、稳定架构边界和交付要求

许可证与反馈

Lantern 使用 MIT License 开源。

如果遇到问题或希望提交功能建议,请使用 GitHub Issues。提交前请勿公开模型 Key、安装令牌、本地路径或未公开作品内容。

About

面向个人漫画创作者的开源漫画工作台,支持故事与资产管理、页面与画格编排、预览与导出,并通过 MCP + Skill 接入外部 AI Agent。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages