本站创建于2006年，博主为Delphi老码农，暗黑忠实粉丝，主要用于学习经验分享
AI摘要 面向 Typecho 的个人品牌主题，融合产品、新闻、博客与摄影。支持 Markdown 增强、Mermaid 图表、评论与 SEO，含后台主题设置。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); Samool Future面向 Typecho 1.3 的个人品牌主题，将软件产品、行业技术新闻、博客日志和摄影作品融合在一套统一的阅读系统里。页面结构index.php：个人品牌首页、双产品卡片、最新文章（最多 4 篇）、技术新闻、摄影入口和回到顶部按钮；首页顺序为产品在上、文章在下。archive.php：分类、标签、搜索结果和分页共用的内容列表页。post.php / page.php：Markdown 长文阅读页、Reading Map、Mermaid 三标签视图、代码复制、图片预览、回到顶部按钮和 AI Assist 入口。comments.php：标准 Typecho 评论列表和评论表单，并以主题卡片样式呈现评论、空状态和评论关闭状态。评论提交仍遵循 Typecho 的全局讨论设置：需要在 Typecho 后台允许评论，并在本主题设置中将“文章评论”设为“显示”；若某篇文章单独关闭评论，页面会显示关闭状态而不会伪造输入框。首页 Hero 右侧由三层线框组成，分别以 20s / 10s / 5s 的不同速度和方向旋转；中心菱形保持方向不变，仅做缩放与光晕呼吸。检测到用户偏好减少动画时会自动停用动效。下载SanctuaryArchive-v1.0.11.zip安装将 SamoolFuture 文件夹复制到 Typecho 的 usr/themes/ 目录。在后台“控制台 → 外观”中启用 Samool Future。进入主题设置，填写首页宣言、宣言链接和两个软件产品的信息。heroLink 会作为首页宣言区 “Explore the journal” 按钮的跳转地址；留空时回退到最新文章区。第一、第二个产品分别对应 software* 与 softwareTwo* 设置项，未填写时会使用内置默认值。首页底部四张图片会从已发布文章的图片附件中随机选择，卡片文字显示所属文章标题并链接到该文章；附件不足四张时，剩余位置显示无链接占位卡片。侧栏会通过 Typecho 分类组件自动读取全部分类，并使用分类自身的永久链接（因此会跟随站点的 .html 伪静态设置）。分类标题直接显示 slug，也就是 /category/<slug>.html 中的 <slug>；分类右侧显示文章数，首页不显示数量。Typecho 独立页会继续按相同导航样式列出，但不显示数量。主题设置中的“友情链接”支持每行一条 名称|https://example.com|简短说明，说明可省略，也可以直接粘贴单独 URL 或富文本链接；保存后显示在侧栏 Link 栏目。解析器兼容全角分隔符、旧的 friendLink/links 字段和 JSON 链接导入，并只输出 HTTP/HTTPS 地址。“建站日期”会显示在侧栏“博客统计”中。统计栏目按文章、评论、分类、独立页、建站日期逐行以卡片选项卡排列。分类和独立页导航使用 20 个主题相关的 SVG 小图标，按名称做稳定的伪随机分配；同一次渲染中会尽量避免重复，刷新页面不会无故跳变。Markdown 增强代码块支持 language-* class，页面会自动在右上角添加 Copy 按钮。Markdown 表格会自动显示外框、表头背景、单元格分隔线和隔行底色；宽表格在手机端保留独立横向滚动区域。language-mermaid / lang-mermaid 代码块会按需从 jsDelivr 加载 Mermaid 11，并提供“图形 / 代码 / 全屏”三个标签：普通页面只显示图形，代码只显示 Mermaid 源码（含复制按钮）；进入全屏后只保留“退出”按钮，并启用缩放按钮、滚轮缩放和拖拽平移；CDN 不可用时仍保留原始代码。文章图片支持点击打开大图；多图可用上一张/下一张或键盘方向键翻页，并提供缩放、旋转和全屏预览。首页、文章页和独立页面提供滚动后出现的“回到顶部”按钮，点击后平滑返回页面顶部。浏览器页面滚动条会跟随夜间/日间主题切换；文章右侧 Reading Map 使用更窄的线条滚动条，避免目录滚动条抢占阅读空间。兼容 Handsome 风格的 .aisummary AI 摘要标记：自动复用主题的夜间/日间颜色和打字机效果；摘要正文需由插件、自定义字段或服务端逻辑提供，主题本身不调用模型 API。主题 CSS/JS 地址自动追加文件时间戳参数，部署覆盖后可避免继续使用旧缓存资源。页面头部自动输出描述、robots、canonical、Open Graph、Twitter Card 和 WebSite/WebPage/Article JSON-LD；搜索结果页与 404 页面使用 noindex,follow，文章页优先使用正文摘要。头部同时提供 /llms.txt 的纯文本站点指南入口，便于 AI 检索器从静态 HTML、canonical 和结构化数据中建立内容索引。H2-H4 自动生成右侧 Reading Map，没有标题时自动显示空目录提示；桌面端目录贴近正文右侧并在滚动时距视口顶部 24px 粘性固定，窄屏则改为正文前的静态目录以保持阅读空间。首页和归档优先使用 Typecho 标准分类、文章字段和分页能力，不依赖 Handsome 专属函数。分类归档页会按当前分类（含子分类）内已发布文章的标签使用次数，显示最多 10 个热门标签；点击标签进入 Typecho 对应标签归档，普通总归档页仍保留分类筛选。可选文章字段如果在 Typecho 文章自定义字段中加入 cover，归档列表会优先使用该图片作为封面；没有字段时显示抽象科技占位图。SEO 与站点根目录文件主题设置中的“ICP备案号”会在页脚显示备案号，并链接到工信部备案管理系统 https://beian.miit.gov.cn/；留空时不显示。deploy/robots.txt 和 deploy/llms.txt 需要复制到 Typecho 文档根目录（不是 usr/themes/SamoolFuture/），详细步骤见 deploy/README.md。如使用 sitemap 插件，请把真实 sitemap 地址追加到根目录 robots.txt。
AI摘要 Azeroth Nexus 是面向 Typecho 1.3.0 的艾泽拉斯奇幻风格个人博客主题，采用浮空群岛、传送门等视觉元素，支持沉浸式封面、原创图标、文章置顶、快捷入口、数据面板，内置完整 Markdown 渲染与 SEO，无外部依赖，设置灵活，适配桌面与手机。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); Azeroth NexusAzeroth Nexus 是面向 Typecho 1.3.0 的原创艾泽拉斯奇幻个人博客主题。它以浮空群岛、古老传送门、石刻边框、奥术青光和遗物金为视觉语言，并以轻量粒子背景、视差氛围和动态标签星图增强沉浸感。核心能力首页首篇文章自动升级为沉浸式传送门封面，其余文章沿纵向远征轨道排列。列表卡片前置图标使用 20 个 64×64 原创艾泽拉斯卡通符号，按文章 ID 稳定伪随机分配。支持首页文章 ID 置顶，并保持配置顺序、跨页独立查询与重复抑制。首页、文章和独立页面共用五个固定快捷入口，每项图标、文字和链接均可在主题设置中修改。统一夜空模式；桌面文章与独立页面使用蓝曜石阅读面，手机保持同一套艾泽拉斯色彩。右侧新增基于 Typecho 原生统计组件的文章、评论、分类和页面数据面板。阅读与提交按钮采用石刻边线、遗物金描边和奥术青悬停光效。完整 Markdown、Mermaid 本地渲染、代码复制、表格横向滚动、图片懒加载。Typecho 1.3 原生评论、分页、分类、标签、搜索、RSS、独立页面和 404 模板。WebSite、Blog、Person、BlogPosting JSON-LD，配套 canonical、Open Graph 和 robots 信号。无 jQuery、无前端框架、无外部字体、无第三方 CDN。安装将整个 AzerothNexus 目录上传到 Typecho /usr/themes/。登录后台，在“控制台 → 外观”启用 Azeroth Nexus。在“设置外观”填写品牌、旅者资料、五个快捷入口、首页置顶文章、侧栏模块和页脚内容。窄栏入口使用 图标|文字|链接 格式；站内 / 路径会自动相对当前 Typecho 安装地址解析。清理站点/CDN 缓存，在桌面和手机检查首页、文章、独立页面、左侧档案轨道、目录、评论和搜索。下载AzerothNexus-v1.1.4.zip主题设置品牌文字、旅者姓名/标语/简介、头像、GitHub、邮箱SEO 作者主页、默认分享图、Google Search Console 验证码奥术强调色、五个固定快捷入口、文章目录、动态标签星图、列表卡通图标首页置顶文章 ID、分类/最新文章/RSS、最新评论、友情链接页脚文字、备案号兼容与发布边界目标版本：Typecho 1.3.0；当前主题版本：1.1.4。主题不会修改文章、分类、标签、评论或数据库结构；动态星图只是标签云的可视化。当前仓库可以完成静态预览、Node 回归和真实浏览器视觉测试；若本机缺少 PHP/Typecho 运行环境，动态模板集成仍需上传测试站验证。生成的视觉素材为原创奇幻资产，不包含游戏官方 Logo、角色或界面素材；主题与 Blizzard Entertainment 无关联。许可证主题代码采用 MIT License。主题内生成式视觉资产仅用于本主题展示与发行；使用者应自行核对目标站点和发行渠道的素材许可要求。主题不依赖区块链、钱包或外部 Web3 服务。
AI摘要 Sanctuary Archive 是面向 Typecho 1.3.0 的暗黑奇幻个人博客主题，采用哥特档案馆、石刻边框与余烬红设计，支持文章置顶、Markdown/Mermaid、SEO 优化等功能，仅黑夜模式，无外部依赖，代码开源。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); Sanctuary ArchiveSanctuary Archive 是面向 Typecho 1.3.0 的暗黑奇幻个人博客主题。它以原创哥特档案馆、石刻边框、暗金符文和余烬红交互为视觉语言，并以文章指纹和节点网络增强“可验证档案”的技术感。核心能力首页首篇文章自动升级为沉浸式档案封面，其余文章沿纵向证据轨道排列。支持首页文章 ID 置顶，并保持配置顺序、跨页独立查询与重复抑制。首页、文章和独立页面共用五个固定左侧窄栏入口，每项图标、文字和链接均可在主题设置中修改。仅提供黑夜模式；桌面文章与独立页面继续使用羊皮卷阅读面，手机使用暗色阅读态。右侧新增基于 Typecho 原生统计组件的文章、评论、分类和页面数据面板。阅读与提交按钮采用圆弧倒角、暗金边线和淡符文底纹。完整 Markdown、Mermaid 本地渲染、代码复制、表格横向滚动、图片懒加载。Typecho 1.3 原生评论、分页、分类、标签、搜索、RSS、独立页面和 404 模板。WebSite、Blog、Person、BlogPosting JSON-LD，配套 canonical、Open Graph 和 robots 信号。无 jQuery、无前端框架、无外部字体、无第三方 CDN。下载地址SanctuaryArchive-v1.0.11.zip安装将整个 SanctuaryArchive 目录上传到 Typecho /usr/themes/。登录后台，在“控制台 → 外观”启用 Sanctuary Archive。在“设置外观”填写品牌、守望者资料、五个左侧窄栏入口、首页置顶文章、侧栏模块和页脚内容。窄栏入口使用 图标|文字|链接 格式；站内 / 路径会自动相对当前 Typecho 安装地址解析。清理站点/CDN 缓存，在桌面和手机检查首页、文章、独立页面、左侧档案轨道、目录、评论和搜索。主题设置品牌文字、守望者姓名/标语/简介、头像、GitHub、邮箱SEO 作者主页、默认分享图、Google Search Console 验证码余烬强调色、五个固定窄栏入口、文章目录首页置顶文章 ID、分类/最新文章/RSS、最新评论、友情链接页脚文字、备案号兼容与发布边界目标版本：Typecho 1.3.0。主题不会修改文章、分类、标签、评论或数据库结构。当前仓库可以完成静态预览、Node 回归和真实浏览器视觉测试；若本机缺少 PHP/Typecho 运行环境，动态模板集成仍需上传测试站验证。生成的视觉素材为原创暗黑奇幻资产，不包含游戏官方 Logo、角色或界面素材；主题与 Blizzard Entertainment 无关联。许可证主题代码采用 MIT License。主题内生成式视觉资产仅用于本主题展示与发行；使用者应自行核对目标站点和发行渠道的素材许可要求。
AI摘要 SaMDeditor V2.0是一个针对Windows 11 x64系统的Markdown编辑器，重点提升了长文档阅读定位、双栏编辑体验、阅读记忆和启动稳定性。新版本包括源码编辑、双栏显示、大纲目录、本地阅读数据库与文件记忆、启动与运行稳定性提升、安装与发布优化以及验证结果。支持多种语言，并提供详细的发布信息和下载链接。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); SaMDeditor V2.0 更新内容发布信息正式版本：2.0.0Windows 文件版本：2.0.0.0安装器版本：2.0升级基线：1.8.0发布日期：2026-08-29支持系统：Windows 11 x64下载地址：https://pan.baidu.com/s/1UEknLZ3eNCbybHYxLeCDqA 提取码: 7u89SHA-256：77DF9D00B33BACD85AE7105FE83179E0DC5314F8E567C4C0A2A6FDE476F87491V2.0 重点提升长文档阅读定位、Markdown 双栏编辑体验、阅读记忆和首次启动稳定性。一、Markdown 编辑与预览源码模式支持 Markdown 源码编辑、软换行、语法高亮、保存、撤销和重做。支持源码与预览双栏显示，左侧源码为主，右侧预览实时跟随。源码点击位置、光标位置和大纲节点可以同步定位到预览区域。双栏预览左右节点保持水平对齐，右侧预览屏蔽右键菜单，避免弹出菜单位置偏移。保留 GFM、代码高亮、Mermaid 全屏、拖拽平移、缩放和 Markdown 导出 PDF。二、大纲目录大纲栏支持抽屉式收缩和展开：<< 收缩，>> 展开。大纲宽度和展开状态可以记忆，下次启动继续使用。Markdown、PDF、EPUB 仅在存在有效标题、书签或目录时显示大纲。TXT 文件默认不显示大纲栏。点击大纲节点可快速定位，避免长距离滚动等待。三、本地阅读数据库与文件记忆新增本机 SQLite 阅读统计数据库，位置为应用支持目录下的 reading_statistics.sqlite3。Markdown、PDF、EPUB 使用完整文件内容 SHA-256 作为文件身份，不以文件路径作为唯一标识。文件改名、移动目录或更换磁盘后，只要文件内容未变化，仍可恢复之前的阅读记录。Markdown 记忆阅读位置、源码位置、双栏比例、缩放和累计阅读时间。PDF 记忆当前页码、阅读进度、缩放和累计阅读时间。EPUB 记忆 CFI 阅读位置、阅读进度、累计时间、字体、字号、行距、字间距、文字颜色、背景色和字体样式。EPUB 阅读探照灯的位置和状态按文件独立保存，切换标签页或重启后可恢复。不同 EPUB 文件可以使用不同阅读参数；新 EPUB 可继承最近使用的外观参数，但不会继承阅读进度。数据库只保存哈希、路径元数据和阅读状态，不保存文档正文；数据库异常时自动降级到普通会话恢复。四、启动与运行稳定性修复新安装后首次启动偶发白屏问题，首帧完成后再显示主窗口。启动过程提供主题一致的加载背景，避免出现空白窗口。增加启动日志，记录原生窗口、Flutter、WebView2 和首帧初始化阶段。改善 WebView2 消息异常容错，减少预览初始化失败和闪退。关闭窗口采用快速隐藏和异步清理，减少退出卡顿。五、安装与发布全局版本统一为 2.0.0 / 2.0 / 2.0.0.0。安装器支持安装路径选择、软件基本信息查看和自动语言检测。支持简体中文、繁體中文、English、日本語、한국어、Español、Deutsch、Français 八种安装语言。桌面快捷方式以及 Markdown、PDF、EPUB 文件关联默认勾选。安装器使用独立安装图标，Markdown、PDF、EPUB 文件关联使用各自浅色文档图标。8 份本地化《软件介绍》同步升级到 V2.0。覆盖安装保留语言、主题、标签页、窗口状态、阅读数据库、恢复稿和文件关联设置。六、验证结果Flutter 自动化测试：125 项通过EPUB/Markdown Web 测试：21 项通过Flutter 静态分析：0 问题npm 生产依赖审计：0 漏洞Windows Release、VC++ Runtime 门禁和 Inno Setup 6.7.3 编译：通过启动日志 QA：通过窗口关闭：61ms；进程退出：109ms七、发布产物安装包：dist\SaMDeditor-2.0-windows-x64-setup.exe安装包大小：16,140,183 字节SHA-256：77DF9D00B33BACD85AE7105FE83179E0DC5314F8E567C4C0A2A6FDE476F87491构建时间戳：2026-08-29 14:49:33主程序 EXE SHA-256：1AF1863BC6A9AF038F81E7B7917E3656D8825A692B26F52F660FC17656F274D4独立校验文件：dist\SaMDeditor-2.0-windows-x64-setup.exe.sha256.txt发布副本：dist\publish\SaMDeditor-2.0-windows-x64-setup.exe当前免费版本不使用 Authenticode 数字签名。
AI摘要 SaMDeditor V1.8.0是一款专为Windows 11设计的免费本地文档阅读与编辑工具，支持Markdown、TXT、PDF和EPUB文件格式。该软件以阅读优先、图形友好和离线可靠为设计理念，提供多种阅读和编辑功能，包括Mermaid图形的全屏、拖拽和缩放，EPUB的连续滚动、目录导航、阅读风格与进度恢复等。新版本重点提升了EPUB阅读体验，优化了Markdown与Mermaid功能，并增强了TXT、PDF和桌面体验。软件界面支持八种语言，并提供官方博客和下载地址。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); SaMDeditor 1.8 软件介绍软件简介SaMDeditor 是一款面向 Windows 11 的免费本地文档阅读与编辑工具，支持 Markdown、TXT、PDF 和 EPUB。软件以“阅读优先、图形友好、离线可靠”为设计目标：Markdown 默认进入阅读模式，Mermaid 图形可以全屏、拖拽和缩放；EPUB 提供连续滚动、目录导航、阅读风格与进度恢复。完整版本：1.8.0支持系统：Windows 11 x64工作方式：本地处理、离线优先界面字体：Microsoft YaHei UI作者：Samool官方博客：www.samool.com下载地址：https://pan.baidu.com/s/1lvSslkdj7egYMwoZa4x85A?pwd=jbbh 提取码: jbbhSHA-256：D22DE238A0FDE67BEF715CA7DE3AC4A64989B333E923CF2AE82F8CDFA5EB669B支持的文件格式格式阅读编辑大纲保存与导出Markdown（.md、.markdown）GFM、代码高亮、MermaidMarkdown 源码有标题时自动显示保留编码、导出 PDFTXT（.txt）纯文本纯文本默认隐藏保留编码PDF（.pdf）本地只读不支持有书签时自动显示不修改原文件EPUB（.epub）纵向连续滚动不支持有目录时自动显示恢复阅读位置，不修改原文件V1.8 重点功能品牌标题与统一版本左上标题栏固定显示“《SaMDeditor V1.8 》 一个为体验而生的阅读器 by Samool.com”，当前文档名继续显示在文件标签中。软件界面、关于窗口、首次启动标记、Windows EXE 与安装器统一读取全局版本配置，为后续自动升级预留版本通道与更新清单地址。EPUB 阅读EPUB.js 随软件离线分发，电子书内容不会上传。正文自动占阅读区约 90%，左右各保留约 5% 留白；窗口尺寸变化时自动重排。支持 EPUB2/EPUB3 目录、CFI 阅读位置恢复和目录快速跳转。底部显示当前页/总页数、阅读百分比、已读字数和累计阅读时间。阅读设置集中在一个窗口：字号、行距和字间距滑杆，背景色、字体色、字体家族及粗体、斜体、下划线。可选择 Windows 本机字体和字体自带的 Light、Regular、Bold、Italic 等真实字形。内置经典、纸张、护眼、柔灰、夜间和高对比阅读风格；背景色与字体色各提供 9 个预置色，也支持系统调色板。底部“阅读探照灯”可将单击位置设为高亮区，并按当前背景色柔化周围文字；光带会跟随所选文字一起滚动，移出阅读工作区后只隐藏亮区，周围压暗背景保持不变，单击新的正文位置即可重新定位，亮度与聚焦范围可以调节和保存。阅读参数、窗口状态和每本书的阅读位置都会自动保存。Markdown 与 Mermaid支持 GFM 标题、表格、任务列表、引用、链接、删除线和代码块。代码块提供一键复制；源码编辑器支持语法高亮、行号、软换行、查找替换、撤销重做和自动缩进。大尺寸 Markdown 工具栏按保存、撤销/重做、格式、实时预览四组居左排列；开启预览后，源码与渲染结果按左右双栏实时同步。Mermaid 使用 SVG 离线渲染。点击全屏按钮或双击图形进入系统全屏，支持鼠标拖拽平移、滚轮焦点缩放、适应屏幕、1:1 和居中。Markdown 标题大纲默认展开并支持逐级折叠；点击节点会瞬时定位，不播放长距离滚动动画。可将 Markdown 预览导出为 A4 PDF，并保留中文、表格、代码、Mermaid 和标题书签。TXT、PDF 与桌面体验TXT 支持 UTF-8、UTF-8 BOM 和 Windows ANSI（GBK/CP936），保存时保留原编码。PDF 使用离线 PDF.js 只读查看，翻页、页码、缩放和适合宽度工具栏位于底部。支持多标签页、文件拖拽、单实例、标签右键批量关闭、手动保存、可选自动保存、会话恢复和异常恢复稿。Markdown、PDF、EPUB 使用独立浅色文件图标；安装器默认勾选三类关联，也可在设置中管理。正常退出时保存窗口尺寸、位置和最大化状态；更换显示器或混合 DPI 环境下会将窗口恢复到安全可见区域。支持简体中文、繁體中文、English、日本語、한국어、Español、Deutsch、Français八种界面语言。亮点功能流程图下面的图形由 SaMDeditor 内置 Mermaid 引擎离线渲染。双击图形即可进入全屏，直接体验拖拽与缩放。flowchart LR A[打开本地文档] --> B{文件格式} B -- Markdown --> C[GFM 预览与大纲] C --> D[Mermaid 离线 SVG] D --> E[双击进入系统全屏] E --> F[按住鼠标拖拽平移] F --> G[滚轮焦点缩放] C --> H[源码编辑 / 导出 PDF] B -- EPUB --> I[连续滚动与目录导航] I --> J[字体 / 风格 / 阅读进度] B -- PDF --> K[只读阅读与书签] B -- TXT --> L[纯文本阅读与编辑] classDef normal fill:#f4f7f5,stroke:#9eb4aa,color:#33423b classDef accent fill:#dff3e8,stroke:#65a984,color:#244235 class A,B,C,H,I,J,K,L normal class D,E,F,G accent本地处理时序图sequenceDiagram actor U as 使用者 participant A as SaMDeditor participant W as 本地 WebView2 participant R as 离线渲染引擎 participant S as Windows 窗口 U->>A: 打开 Markdown / EPUB / PDF A->>A: 检查格式与安全边界 A->>W: 通过本机通道传入文档 W->>R: 离线渲染内容 R-->>W: 返回正文、图形或页面 W-->>U: 显示阅读区与大纲 U->>W: 全屏 / 拖拽 / 缩放 / 跳转 W->>S: 更新可见窗口 S-->>U: 即时显示结果安装与升级运行 SaMDeditor-1.8-windows-x64-setup.exe。选择安装语言和安装目录，并查看对应语言的软件介绍。桌面快捷方式以及 Markdown、PDF、EPUB 文件关联默认勾选，可按需取消。首次启动会自动打开当前语言的介绍文档一次。可从 V1.7 直接覆盖升级；语言、主题、会话、恢复稿、阅读设置和 EPUB 阅读位置都会保留。安装程序会注册 SaMDeditor 为可用打开方式。Windows 11 中受保护的默认应用仍需由用户在“设置 → 应用 → 默认应用”中最终确认。隐私、安全与版本边界Markdown、TXT、PDF、EPUB、会话和恢复稿仅在本机处理。Markdown、Mermaid、PDF 和 EPUB 渲染资源随安装包离线提供，不依赖公共 CDN。EPUB 打开前执行归档结构、路径、体积、文件数和压缩比例检查，并限制脚本和外部活动内容。本地资源通道只绑定 127.0.0.1 并使用随机令牌；启动日志不记录文档正文。当前免费版本未使用商业 Authenticode 数字签名，请从 www.samool.com 官方渠道下载并核对发布 SHA-256。暂不支持数学公式和图片编辑。PDF 仅支持阅读，不支持修改、批注或表单编辑。EPUB 仅支持阅读，不支持编辑、批注、DRM 或跨设备同步。ANSI 当前按 GBK/CP936 处理。发布信息软件名称：SaMDeditor完整版本：1.8.0安装包：SaMDeditor-1.8-windows-x64-setup.exeSHA-256：以发布目录中同名 .sha256.txt 文件为准作者：Samool官方博客：www.samool.com
AI摘要 SaMDeditor V1.7.0发布，新增EPUB电子书阅读功能，包括直接打开、拖拽打开、多标签页阅读、自动重新排版、目录大纲、快速定位章节、阅读位置恢复等功能。同时，提供丰富的EPUB阅读设置，包括字号、行距、字间距、字体选择、样式、背景色和字体色等。此外，还增加了文件图标与关联管理、稳定性与兼容性改进、本地阅读与安全保护等功能，并保留了V1.6版本的功能。安装包大小为15,240,619字节，SHA-256为20B0C6E1F2F3F37698FDF91CAE1932938154BD1DBE6BA321F0192D76A86E91FB。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); SaMDeditor V1.7 更新内容SaMDeditor V1.7.0 现已发布。本次版本在原有 Markdown、Mermaid、TXT 和 PDF 能力基础上，重点增加 EPUB 电子书阅读，并完善阅读排版、文件关联、多屏窗口恢复和兼容性体验。软件版本：1.7.0发布日期：2026-08-28支持系统：Windows 11 x64软件性质：免费、本地、离线优先下载地址：https://pan.baidu.com/s/1zIL5leD2lXTCe-jshVnTAA?pwd=p97cSHA-256：F318454E2EACF1F6F50A71867964444C54074C94F4164EFE79D53E9653BB8F0A一、新增 EPUB 电子书阅读支持直接打开、拖拽打开和多标签页阅读 .epub 文件。采用纵向连续滚动阅读方式，窗口尺寸变化时内容自动重新排版。阅读正文占内容区约 90%，左右各保留约 5% 的呼吸空间，滚动条位于阅读区最右侧。支持 EPUB 目录大纲，一级目录加粗，二级及更深目录使用常规字重。点击目录可快速定位到对应章节，并支持恢复每本电子书上次阅读位置。底部状态栏显示当前页/总页数、阅读百分比、已读字数和累计阅读时间。EPUB 仅提供阅读功能，不会修改原电子书文件。二、丰富的 EPUB 阅读设置支持调整字号、行距和字间距，三个参数均采用滑动条操作。支持选择 Windows 本机已安装字体；中文界面会优先显示实际包含中文字形的字体。支持选择字体自带的 Light、Regular、Bold、Italic 等真实字形。支持粗体、斜体和下划线样式，可自由组合。背景色和字体色各提供 9 种预置颜色，也可使用系统调色板自定义。内置经典、纸张、护眼、柔灰、夜间、高对比等阅读风格，一键切换并自动保存。阅读设置集中在同一个窗口中，支持即时预览、应用保存、恢复默认和右上角 X 关闭。所有阅读参数会持久化保存，新打开的 EPUB 和下次启动软件时继续使用。三、文件图标与关联管理为 Markdown、PDF、EPUB 分别设计独立的浅色文件图标，不再复用主程序图标。安装程序提供 Markdown、PDF、EPUB 三种文件关联选项，并默认勾选。设置窗口新增文件关联管理，可查看和调整 .md、.pdf、.epub 的注册状态。遵循 Windows 11 默认应用规则：SaMDeditor 注册可用打开方式，最终默认程序仍由用户确认。四、稳定性与兼容性改进修复部分 EPUB 打开时提示 [object ArrayBuffer]、正文无法加载的问题。修复部分 EPUB 点击目录提示 No Section Found 的共性问题；目录路径现在依据 EPUB 内部 OPF、Navigation/NCX 和 spine 的真实位置解析，不依赖固定目录结构。修复窗口缩放时偶发 Cannot read properties of undefined (reading 'resize') 警告的问题。修复高 DPI 主屏与低 DPI 扩展屏混用时，在副屏关闭软件后重新启动看不到主窗口的问题。软件退出时保存正常窗口位置、尺寸和最大化状态；显示器断开或布局变化时自动回到安全可见区域。Flutter 原生文本右键菜单统一使用 Microsoft YaHei UI，覆盖源码编辑、TXT、查找替换、密码输入和错误信息等入口。EPUB 阅读设置窗口新增明确的关闭按钮，未点击“应用”的临时调整会被取消。五、本地阅读与安全保护EPUB.js、Markdown、Mermaid 和 PDF 阅读组件全部随软件离线分发，不依赖公共 CDN。文档内容默认只在本机处理，不会主动上传到外部服务器。打开 EPUB 前执行安全预检，限制异常压缩比例、文件数量、解压体积和目录深度。拒绝路径穿越、危险归档结构和不安全资源，并通过内容清洗与安全策略限制 EPUB 主动脚本和外部请求。继续保留 Markdown/TXT 手动保存、可选自动保存、未保存标记、会话恢复和异常恢复稿。六、V1.6 功能继续保留GFM Markdown 阅读与源码编辑。Mermaid 全屏查看、鼠标拖拽平移、滚轮缩放、适应屏幕、1:1 和居中。Markdown 常用格式工具栏、源码自动软换行和代码段一键复制。TXT 查看与编辑，支持 UTF-8、UTF-8 BOM 和 Windows ANSI（GBK/CP936）。PDF 只读阅读、书签大纲和底部阅读工具栏。Markdown 导出 PDF。多标签页、单实例、文件拖拽、标签右键批量关闭和会话恢复。简体中文、繁體中文、English、日本語、한국어、Español、Deutsch、Français八种界面语言。浅色/深色软件主题和全局 Microsoft YaHei UI 界面字体。七、安装与升级可从 V1.6 直接覆盖升级到 V1.7。升级过程保留用户语言、主题、文件关联设置、文档会话、阅读排版和 EPUB 阅读位置。安装包继续携带应用本地 VC++ 运行库，降低新装 Windows 11 缺少运行库而无法启动的概率。当前免费版本未加入商业 Authenticode 数字签名，请从 samool.com 官方渠道下载并核对 SHA-256。八、V1.7 发布文件安装包：SaMDeditor-1.7-windows-x64-setup.exe文件大小：15,240,619 字节构建时间：2026-08-28 10:33:30SHA-256：20B0C6E1F2F3F37698FDF91CAE1932938154BD1DBE6BA321F0192D76A86E91FB校验文件：SaMDeditor-1.7-windows-x64-setup.exe.sha256.txt九、发布验证Flutter 静态分析：0 问题。Flutter 自动化测试：101 项全部通过。EPUB.js 自动化测试：12 项全部通过。npm 生产依赖安全审计：0 漏洞。Windows Release、应用本地 VC++ 运行库检查和 Inno Setup 6.7.3 安装包构建全部通过。主程序 ProductVersion/FileVersion 均为 1.7.0，安装器产品版本为 1.7、文件版本为 1.7.0.0。感谢使用 SaMDeditor。作者：Samool官方博客：www.samool.com
AI摘要 SaBlog2026是一款轻量级、双栏个人博客主题，专为Typecho 1.3.0设计，以Markdown长文阅读为核心。它适用于技术博客、个人知识库等场景，具有响应式布局、多种主题模式，并支持Mermaid图表。主题注重内容优先，提供清晰的信息层级和有效的侧栏导航，同时优化了移动端体验。此外，SaBlog2026还关注SEO，提供服务端语义HTML和页面级SEO优化，帮助搜索引擎和AI爬虫更好地理解内容。主题代码采用MIT License，内置Mermaid也遵循相同许可证。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); SaBlog2026 主题介绍一款面向 Typecho 1.3.0、以 Markdown 长文阅读为核心的轻量双栏个人博客主题。基本信息项目说明主题名称SaBlog2026当前版本1.0.17适用程序Typecho 1.3.0主要场景技术博客、个人知识库、Markdown 长文、项目记录、经验分享布局方式PC 端响应式双栏，平板和手机端自动切换单栏主题模式浅色、深色、跟随系统，并记忆访客的手动选择前端依赖无 jQuery、无前端框架、无外部字体、无第三方 CDN开源协议主题代码采用 MIT License；内置 Mermaid 采用 MIT License下载SaBlog2026-v1.0.17.zip主题定位SaBlog2026 的核心目标不是堆叠复杂组件，而是让文章成为页面真正的主角。主题主要面向长期写作、技术资料整理和知识沉淀场景，在保证视觉品质的同时，重点解决以下问题：长文章在桌面、2K、4K 和手机屏幕上都应保持舒适的阅读宽度。Markdown 标题、代码、表格和流程图需要具备清晰、稳定的展示能力。侧栏应提供有效导航，不能在长文章中留下大片空白或抢占正文空间。页面 HTML 应具有清楚的语义结构，方便搜索引擎和 AI 爬虫理解内容。主题功能尽量本地化、轻量化，减少不必要的网络请求和第三方依赖。设计思路1. 内容优先首页文章列表采用纯文字卡片，不读取或展示文章封面。卡片只保留分类、标题、摘要、发布日期、阅读时间和“阅读全文”入口，使访客可以快速判断文章价值，也避免大图影响加载速度和信息密度。文章页使用独立阅读卡片承载标题、元数据、正文、标签、上一篇/下一篇和评论。正文排版针对 Markdown 的标题、段落、列表、引用、代码、表格、任务列表、图片、脚注和详情块进行了统一设计。2. 清晰的信息层级主题以深蓝文字、浅灰背景、白色卡片和可配置强调色构成主要视觉体系。圆角、细边框、轻阴影和适度留白用于区分内容层级，但不让装饰压过文章本身。分类采用两列图标卡片，作者信息使用深色身份卡片，最新文章、最新评论、友情链接和订阅入口保持相同的组件语言，使整个侧栏既有辨识度又保持一致。3. 为长文章设计的侧栏首页侧栏用于内容发现，可显示作者信息、分类、友情链接、最新文章、最新评论和 RSS 订阅。文章页和独立页面不显示分类与友情链接，侧栏按“作者信息 → 最新文章 → 订阅更新 → 文章目录”的顺序组织。文章目录放在最后，随页面正常滚动；到达页头下方后自动固定。目录或长侧栏超过视口时，侧栏内部出现独立细滚动条，正文仍保持自然滚动。如果文章没有有效目录，桌面端固定作者信息和最新文章组合，避免长文章右侧出现大面积无内容区域。4. 面向多种桌面分辨率主题不使用单一固定宽度，而是根据 CSS 视口分档调整页面容器、主栏、侧栏和栏间距。普通笔记本保持紧凑，2K/4K 显示器则扩大有效阅读区域，减少两侧无效留白。视口宽度页面容器侧栏宽度布局961–1439px默认容器约 300px双栏≥ 1440px1320px310px双栏≥ 1680px1520px320px双栏≥ 1920px1720px330px双栏≥ 2560px2200px360px双栏≥ 3200px2600px380px双栏≤ 960px最大 820px自动单栏5. 移动端独立适配960px 及以下自动转换为单栏，文章目录进入正文标题下方的折叠面板。760px 及以下启用移动导航，搜索面板、菜单、文章卡片、表格、代码块、评论表单和相邻文章导航都会重新排布。移动菜单使用独立覆盖层，避免菜单文字与页面正文重叠。6. 本地优先与渐进增强主题不依赖前端框架。即使 JavaScript 没有执行，服务端仍会输出标题、正文、分类、链接、评论和 SEO 语义数据。代码复制、目录高亮、深浅色切换、移动菜单、返回顶部和 Mermaid 图表属于渐进增强能力。Mermaid 11.17.2 直接放在主题目录中，只在正文检测到 Mermaid 代码块时按需加载，不访问外部 CDN。普通首页和不含图表的文章不会产生 Mermaid 运行时请求。亮点功能Markdown 长文排版支持 H1–H6、段落、列表、引用、链接、图片和分隔线。支持行内代码、代码块、一键复制和长代码横向滚动。支持表格窄屏滚动、任务列表、脚注和 details/summary 详情块。正文图片自适应容器宽度并启用懒加载。自动估算文章阅读时间。H1/H2/H3 三级文章目录自动读取正文中的 H1、H2、H3。分别映射为一级、二级、三级嵌套目录。自动为标题生成稳定锚点，并随滚动高亮当前章节。图片型标题、空标题以及 H4–H6 不进入目录。没有有效目录时自动隐藏目录模块。PC 端使用侧栏目录，移动端使用可折叠目录。Mermaid 图表主题支持以下常用 Mermaid 图表：flowchart：流程图sequenceDiagram：时序图classDiagram：类图stateDiagram / stateDiagram-v2：状态图erDiagram：ER 图每个图表都支持：图形与原始代码自由切换。一键复制 Mermaid 源码。原生全屏或页面内全屏预览。Esc 退出全屏。根据浅色/深色主题重新渲染。渲染失败时保留源码，不影响文章其他内容。使用 securityLevel: strict 的严格安全模式。Markdown 写法示例：```mermaid flowchart LR A[开始] --> B{条件成立？} B -->|是| C[继续执行] B -->|否| D[结束] ```首页内容发现纯文字文章卡片，不展示列表封面图。两列彩色分类卡片及文章数量。可配置友情链接，支持名称、URL 和简短说明。最近 5 篇文章。最近 5 条已审核评论，直接链接到文章内对应评论。RSS 订阅入口。评论体验使用 Typecho 1.3.0 原生评论数据和回复结构。支持多条评论、长评论和嵌套回复。评论作者、时间、内容和回复入口具有清楚层级。评论表单支持登录用户和访客模式。手机端自动调整头像、字段和嵌套间距。深浅色模式可设置跟随系统、默认浅色或默认深色。访客可通过页头按钮随时切换。手动选择保存在浏览器本地，下次访问继续使用。代码、表格、评论、侧栏和 Mermaid 图表同步适配主题颜色。搜索与导航页头内置站内搜索面板。PC 端居中主导航，手机端折叠菜单。提供“跳到正文”无障碍链接。长页面显示返回顶部按钮。文章页提供上一篇和下一篇导航。首页与文章页的侧栏差异模块首页文章页/独立页面作者信息显示显示分类可配置显示不显示友情链接有配置时显示不显示最新文章可配置显示可配置显示最新评论可配置显示不显示RSS 订阅可配置显示可配置显示文章目录不显示有有效 H1–H3 时显示在最后SEO、Google 与 AI 爬虫适配服务端语义 HTML主题直接由 PHP 输出文章标题、正文、时间、作者、分类、标签、导航、侧栏和评论，不依赖 JavaScript 再生成核心内容。页面使用 header、nav、main、article、aside、footer 等语义元素，方便搜索引擎、阅读器和 AI 爬虫提取正文结构。页面级 SEO自动生成非空且与页面内容对应的 。输出页面描述、作者和 robots 策略。首页及归档页输出 canonical；文章永久链接继续由 Typecho 管理。输出 Open Graph 与 Twitter Card 元数据。文章页输出发布时间、修改时间、分类和标签信号。文章存在正文图片时，优先把第一张图片用于分享元数据，但不会在文章列表重新展示该图片。搜索页使用 noindex,follow，404 页使用 noindex,nofollow。JSON-LD 结构化数据首页：WebSite + Blog + Person。普通文章：BlogPosting + Person。独立页面：Article + Person。包含标题、摘要、永久链接、作者、分类、标签、发布时间和修改时间等字段。Google 与 AI 入口支持 Google Search Console HTML 验证码配置。保留 Typecho RSS 2.0 与 Atom 自动发现。项目另附网站根目录使用的 robots.txt 和 llms.txt。robots.txt 与 llms.txt 必须部署到网站文档根目录，放在主题目录中不会自动生效。SEO 和结构化数据可以帮助爬虫发现与理解内容，但不保证搜索排名、富结果展示或 AI 引用。主题配置参数进入 Typecho 后台的“控制台 → 外观 → 设置外观”即可配置以下 18 项参数。配置项类型默认值作用与填写说明页头品牌文字文本空显示在页面左上角；留空时自动使用 Typecho 站点名称。侧栏名称文本SAMOOL作者身份卡片中的名称；留空会回退到默认值。侧栏标语文本独立思考 · 持续成长作者名称下方的短标语，建议不超过 24 个汉字。侧栏简介多行文本技术探索者、内容创作者，记录工作、生活与持续成长。作者卡片简介，只按纯文本输出，不解析 HTML。头像地址URL空可填写完整图片 URL；留空使用主题内置头像。GitHub 地址URLhttps://github.com/cnsamool作者卡片 GitHub 按钮；保存为空时不显示。联系邮箱邮箱空作者卡片“联系”按钮；留空时不显示。SEO 作者主页URL空用于 JSON-LD 的作者地址；建议填写站内“关于我”页面，留空使用网站首页。SEO 默认分享图片URL空首页和归档页的 Open Graph/Twitter 图片；文章页优先使用正文第一张图片。Google Search Console 验证码文本空只填写 google-site-verification 的 content 值，不要粘贴完整 meta 标签。主题强调色文本#2563eb必须是六位十六进制颜色；非法值自动回退为默认蓝色。默认颜色模式单选跟随系统可选“跟随系统”“默认浅色”“默认深色”；访客的手动选择优先。文章目录单选启用启用后读取正文 H1–H3；关闭后 PC 和手机均不生成目录。侧栏模块多选分类、最新文章、订阅入口全部显示分别控制分类、最新文章和 RSS；分类仍只在首页出现。首页最新评论单选显示在首页“最新文章”下方显示最近 5 条已审核评论。友情链接多行文本空每行一条，格式为 名称https://example.com简短说明；说明可省略，仅接受 HTTP/HTTPS。页脚文字文本保持独立思考，持续记录与成长。显示在版权文字后面；允许保存为空，空值时不显示额外文字。备案号文本空例如 蜀ICP备14011608号；显示在版权和页脚文字后，并链接到工信部备案网站。友情链接示例：aijun's blog|https://aijun.org/|夏爱军 Typecho|https://typecho.org/|轻量博客程序推荐配置流程在 Typecho 基本设置中填写站点名称、站点地址和站点描述。在主题设置中填写品牌文字、作者名称、标语、简介和头像。配置 GitHub、联系邮箱、友情链接和备案号。选择主题强调色和默认颜色模式。根据内容类型决定是否启用文章目录、最新评论和各侧栏模块。填写 SEO 作者主页、默认分享图片和 Google Search Console 验证码。把项目 site-root/robots.txt 与 site-root/llms.txt 部署到站点根目录。清理 Typecho、反向代理和 CDN 缓存，然后分别检查首页、文章页、独立页面、评论页和手机端。安装方法安装或升级到 Typecho 1.3.0。备份数据库、/usr 目录和现有主题配置。将完整的 SaBlog2026 文件夹上传到 /usr/themes/。登录 Typecho 后台，在“控制台 → 外观”中启用 SaBlog2026。进入“设置外观”完成主题参数配置。清理缓存并验证首页、文章、独立页面、评论、搜索和 404 页面。主题切换不会主动修改文章、分类、标签或评论数据，但正式切换前仍建议完成备份。内容编写建议文章标题由 Typecho 管理，正文目录标题从 H1 开始组织，并保持 H1 → H2 → H3 的自然层级。不要只用加粗段落模拟章节标题，否则不会进入文章目录。Mermaid 图表必须使用带 mermaid 语言标识的围栏代码块。大表格应尽量控制列数；主题支持横向滚动，但手机端仍应避免单元格内容过长。SEO 摘要优先来自 Typecho 页面描述或文章摘要，应避免只有代码而没有文字说明。需要社交分享大图的文章，可在正文前部放置一张与文章直接相关的图片。兼容范围与功能边界目标环境为 Typecho 1.3.0。主题没有独立后端、数据库迁移、依赖管理器或构建系统。不依赖 Handsome 主题函数，也不会自动迁移 Handsome 的主题设置。Handsome 专用短代码能否继续显示，取决于短代码由插件、文章 HTML 还是原主题实现，切换前应抽样检查历史文章。AI 摘要、点赞、豆瓣卡片、音乐播放器、访问统计和评论增强不属于当前主题核心能力，可通过独立插件扩展。Mermaid 只负责渲染合法语法，图表内容和结构仍由文章作者维护。网站根目录中的 robots、sitemap 与服务器缓存策略不由主题安装包自动修改。目录结构SaBlog2026/ ├─ assets/ │ ├─ css/style.css │ ├─ img/default-avatar.png │ ├─ js/theme.js │ └─ vendor/mermaid/ ├─ components/post-card.php ├─ 404.php ├─ archive.php ├─ comments.php ├─ footer.php ├─ functions.php ├─ header.php ├─ index.php ├─ page.php ├─ post.php ├─ sidebar.php ├─ screenshot.png └─ style.css许可说明SaBlog2026 主题代码采用 MIT License。内置 Mermaid 11.17.2 使用 MIT License，许可证原文位于 assets/vendor/mermaid/LICENSE。主题内置头像由站点所有者提供，其图像著作权和使用权限独立于主题代码许可证。SaBlog2026 希望在视觉表现、长文阅读、技术内容展示、搜索可理解性和维护成本之间取得平衡：保持页面足够精致，同时让写作者可以把主要精力放回内容本身。
AI摘要 SaMDeditor是一款适用于Windows 11的轻量级多格式阅读与Markdown编辑工具，支持Markdown、TXT、PDF和EPUB文件。软件提供多标签页、文档大纲、源码编辑、自动保存与恢复等功能，支持Mermaid图表全屏查看、拖拽平移和缩放，代码段一键复制。EPUB阅读支持字体、字号、颜色、行距、字间距及阅读风格设置。软件内置多种语言界面，文件在本地处理，注重阅读体验、操作效率与数据安全。软件版本为1.7，支持系统为Windows 11 x64。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); SaMDeditor 软件介绍一、软件简介SaMDeditor 是一款面向 Windows 11 的轻量级多格式阅读与 Markdown 编辑工具，支持 Markdown、TXT、PDF 和 EPUB 文件。软件提供多标签页、文档大纲、源码编辑、自动保存与恢复等功能；Mermaid 图表支持全屏查看、拖拽平移和缩放，代码段可一键复制。EPUB 阅读支持字体、字号、颜色、行距、字间距及阅读风格设置。软件内置简体中文、繁体中文、英语、日语、韩语、西班牙语、德语和法语界面，文件在本地处理，注重阅读体验、操作效率与数据安全。软件版本：1.8支持系统：Windows 11 x64工作方式：本地、离线优先作者：Samool官方博客：www.samool.com二、格式能力一览格式阅读编辑大纲保存与导出Markdown（.md、.markdown）GFM、代码高亮、MermaidMarkdown 源码有标题时自动显示保留编码、导出 PDFTXT（.txt）纯文本纯文本默认隐藏保留编码PDF（.pdf）本地只读不支持有书签时自动显示不修改原文件EPUB（.epub）纵向连续滚动不支持有目录时自动显示恢复阅读位置，不修改原文件三、核心功能1. Markdown 阅读与编辑打开文档后默认进入阅读模式，底部可随时切换“阅读”和“编辑”。支持 GFM 常用语法，包括标题、表格、任务列表、引用、链接、删除线和代码块。代码块提供一键复制按钮，并显示复制结果。源码编辑器支持 Markdown 高亮、行号、查找替换、撤销重做、自动缩进和常用括号配对；剪切、复制、粘贴、全选右键菜单与正文统一使用 Microsoft YaHei UI。长段落按照编辑区宽度自动软换行，不会向文件写入额外换行；折行后的行号仍对应原始逻辑行。Markdown 格式工具栏固定居左、紧凑排列；支持 H1-H3、粗体、斜体、删除线、链接、引用、行内代码、代码块、无序列表、有序列表、任务列表、表格和分隔线。选中文字后点击工具按钮可直接包裹格式；再次点击粗体、斜体等行内格式可取消标记。工具栏空间不足时可以横向滚动，TXT 编辑时不会显示 Markdown 工具栏。支持 UTF-8、UTF-8 BOM 和 ANSI（GBK/CP936）编码，保存时默认保留原编码。2. Mermaid 图形增强阅读Mermaid、GFM 和代码高亮资源随软件离线提供，运行时不依赖在线 CDN。点击全屏按钮或双击图形即可进入 Windows 真正全屏模式。全屏画布支持鼠标左键按住拖拽平移，以及滚轮焦点缩放。提供放大、缩小、适应屏幕、1:1 和居中操作。使用 SVG 矢量渲染，放大后仍保持清晰。按 Esc 可快速退出全屏。全屏退出、窗口最小化或隐藏时，WebView2 输入层会与主窗口同步显隐，不会在桌面残留不可见的点击遮挡区域。亮点功能流程图下面的图形由 SaMDeditor 内置 Mermaid 引擎离线渲染。双击图形即可进入全屏，然后按住鼠标拖拽、滚轮缩放，直接体验 SaMDeditor 的图形阅读方式。flowchart LR A[打开 Markdown] --> B[本地 GFM 预览] B --> C{存在文档标题?} C -- 是 --> D[自动显示大纲] C -- 否 --> E[正文占满可用空间] B --> F{包含 Mermaid?} F -- 是 --> G[离线渲染 SVG] G --> H[双击进入系统全屏] H --> I[按住鼠标拖拽平移] I --> J[滚轮焦点缩放] J --> K[适应屏幕 / 1:1 / 居中] B --> L[导出 A4 PDF] classDef normal fill:#f4f7f5,stroke:#9eb4aa,color:#33423b classDef accent fill:#dff3e8,stroke:#65a984,color:#244235 class A,B,C,D,E,F,L normal class G,H,I,J,K accentMermaid 全屏交互时序图预览与 Mermaid 渲染均在本机完成，不上传文档正文。进入全屏后，鼠标操作会直接转换为 SVG 画布的平移和缩放。sequenceDiagram actor U as 使用者 participant A as SaMDeditor participant W as 本地 WebView2 participant M as Mermaid 引擎 participant S as Windows 窗口 U->>A: 打开 .md 文件 A->>W: 传入 Markdown 内容 W->>M: 离线渲染 Mermaid M-->>W: 返回矢量 SVG W-->>U: 显示预览和文档大纲 U->>W: 双击 Mermaid 图形 W->>A: 请求进入全屏 A->>S: 切换系统全屏窗口 loop 查看复杂图形 U->>W: 按住拖拽 / 滚轮缩放 W-->>U: 实时平移 / 焦点缩放 end U->>W: 按 Esc W->>A: 请求退出全屏 A->>S: 恢复编辑器界面3. 智能文档大纲Markdown 存在 H1-H6 标题时，自动显示当前文档大纲。PDF 存在内嵌书签时，自动显示书签大纲。TXT、无标题的 Markdown 和无书签的 PDF 不显示大纲栏，不占用正文空间。大纲层级默认全部展开；一级标题可折叠其二级及更深目录，二级标题也可继续折叠三级及更深目录，切换文档标签后保留本次运行期内的操作状态。点击大纲节点会瞬时定位到目标章节或 PDF 页面，不播放耗时的长距离滚动动画。大纲栏支持调整宽度和字体大小，也可以手动隐藏。4. 多标签页与文件操作同一窗口可同时打开多个 Markdown、TXT 和 PDF 文档。顶部文件标签栏采用 36px 紧凑高度，减少对正文空间的占用。标签右键菜单支持关闭当前、关闭其它、关闭左侧所有和关闭右侧所有。支持文件选择器、Windows 文件关联、命令行参数和拖拽文件到窗口。软件采用单实例模式，再次打开文件会自动转发到已有窗口。默认恢复上次打开的标签页和活动文档。5. TXT 查看与编辑TXT 使用纯文本语义，不把 #、代码围栏等字符解释为 Markdown。支持纯文本预览、源码编辑、软换行、编码识别、保存、自动保存和异常恢复稿。TXT 默认不显示大纲栏，也不显示 Markdown 格式工具栏。6. PDF 阅读PDF 使用随软件分发的 PDF.js 离线只读查看，不上传文件。支持上一页、下一页、页码跳转、缩放和适合宽度。支持读取 PDF 内嵌书签并生成左侧大纲。PDF 只提供阅读能力，不会修改原文件。7. Markdown 导出 PDF可将当前 Markdown 预览一键导出为 A4 PDF。保留中文、GFM 表格、代码高亮、Mermaid 图形和标题书签。自动移除预览工具按钮，并避免生成无效尾部空白页。8. 保存、恢复与文件安全默认使用手动保存，未保存文档会在标签和窗口标题中显示标记。可在设置中启用自动保存并选择保存间隔。软件定期保存会话检查点，异常退出后可恢复最近的临时稿。检测到文件被外部程序修改时，会询问是否重新加载。关闭程序时先隐藏窗口再写入会话，减少可见等待和退出卡顿。四、界面、语言与性能1. 紧凑桌面界面启动窗口占主屏幕宽度的 50%、高度的 80%，自动居中，左右各保留 25%、上下各保留 10% 空间；需要更大阅读区域时仍可最大化或进入 Mermaid 全屏。文件菜单、文档标题、主题切换和窗口控制按钮共用一行标题栏。顶部菜单与弹出列表紧密衔接，菜单项采用适合鼠标操作的紧凑高度。设置窗口按“外观与字体、渲染与性能、文件与会话”三个标签分类，最大约 620×400px，并适配低分辨率和高显示缩放环境。软件全部可控文字统一固定使用 Microsoft YaHei UI，包括菜单、标题栏、文件标签、设置、大纲、Markdown 正文与代码块、源码编辑及其右键选择菜单、TXT 预览、Mermaid 图形文字和 PDF 阅读器工具栏；PDF 页面自身仍按原文件嵌入字体忠实呈现，避免破坏版式。支持浅色、深色和跟随 Windows 三种主题模式，标题栏右侧可快速切换日间/夜间效果。2. 七种界面语言SaMDeditor 支持以下界面语言：简体中文繁體中文English日本語한국어EspañolDeutschFrançais安装器提供八种语言选择，并将安装语言写入软件配置；首次启动默认使用该语言，也可以在“设置 → 外观与字体 → 语言”中切换。未通过安装器写入语言时跟随 Windows，系统语言不在支持范围则回退到 English。多语言覆盖原生菜单、设置、文件与保存提示、恢复状态、Markdown 代码复制、Mermaid 全屏画布和 PDF 阅读器。3. 启动与渲染体验Markdown 正文初始化期间显示跟随主题的加载提示和动画，避免 WebView2 尚未完成首屏绘制时出现黑色正文区域。大纲跨章节导航采用瞬时定位，长文档滚动过程减少重复布局。WebView2 默认进行 GPU 合成能力检测，只在检测结果明确可用时启用硬件加速。遇到 GPU 被禁用、软件适配器、驱动回退或检测异常时，自动使用兼容性更高的软件渲染。用户可在“设置 → 渲染与性能”关闭自动硬件加速；修改后重启生效。WebView2 原生输入窗口受主窗口生命周期统一管理；最小化或隐藏 SaMDeditor 后，桌面图标与其它应用仍可正常点击。五、Windows 集成与兼容性安装程序根据 Windows 界面语言预选，并允许用户在 8 种安装语言中手动切换。“创建桌面快捷方式”和“注册 SaMDeditor 为 Markdown (.md) 打开程序”默认勾选。应用图标与浅色 Markdown 文件关联图标分别设计，便于在资源管理器中识别。Release 随包携带 Flutter 所需的 Microsoft VC++ 应用本地运行库，干净系统无需另行安装 Visual C++ Redistributable。安装器先在程序目录创建 log.txt，Windows Runner 从进入程序入口开始继续记录启动阶段。安装目录不可写时，日志自动回退到 %LOCALAPPDATA%\SaMDeditor\Logs\log.txt，再次失败时回退到 %TEMP%\SaMDeditor\log.txt。日志超过 2MB 时轮换为 log.txt.previous，不会记录 Markdown、TXT 或 PDF 的正文。六、安装与基本使用安装运行安装包 SaMDeditor-1.6-windows-x64-setup.exe。选择安装界面及软件首次使用的语言。查看对应语言的软件介绍并选择安装目录。按需保留默认勾选的桌面快捷方式和 Markdown 文件关联。安装完成后，可双击 .md 文件或在 Windows“打开方式”中选择 SaMDeditor。如果 Windows 已保存其它受保护的默认应用，请进入“设置 → 应用 → 默认应用”，手动将 .md 设置为 SaMDeditor。八种语言的《软件介绍》都会随程序一同安装。1.6 版本首次成功启动时会按当前软件语言自动打开对应版本一次，后续启动不重复打扰；从旧版本升级的用户也能查看本版最新介绍。打开与编辑文档点击“文件 → 打开”，或把 .md、.markdown、.txt、.pdf 文件拖入窗口。Markdown 和 TXT 可通过底部按钮切换预览与源码编辑。使用 Ctrl+S 保存，使用 Ctrl+Shift+S 另存为。查看 Mermaid 图形在 Markdown 预览中找到 Mermaid 图形。点击全屏按钮或双击图形进入全屏。按住鼠标左键拖动图形，滚动鼠标滚轮缩放。按 Esc 退出全屏。导出 PDF打开 Markdown 文档并进入预览模式。选择“文件 → 导出 PDF”。选择保存位置后等待导出完成。七、隐私与安全Markdown、TXT、PDF、会话和恢复稿仅在本机处理，不上传文档内容。Markdown、Mermaid 和 PDF 渲染资源随安装包离线分发，运行时不依赖 CDN。HTML 预览经过白名单清洗，限制脚本、iframe、表单和活动媒体。Mermaid 使用严格安全模式。PDF 通过仅绑定 127.0.0.1、带随机令牌的只读资源通道传入阅读器，局域网无法访问。WebView 弹窗和权限请求默认拒绝，外部链接交给系统默认程序处理。八、更新日志V1.7 内容包括：Markdown 源码工具栏升级源码与预览实时双栏固定品牌标题全局版本配置8 种语言介绍更新升级兼容性说明自动化测试结果V1.7 更新内容：EPUB 阅读与个性化设置本机字体及真实字形阅读风格、进度与统计文件图标及关联管理EPUB 兼容性修复混合 DPI 多屏窗口修复本地安全与离线能力V1.6 功能延续安装升级及发布验证V1.6 更新内容：修复 CP936/GBK 编码的 Markdown、TXT 文件无法打开或保存的问题。ANSI 读取、保存和回读校验统一使用 Windows 代码页 936。“关于”窗口显示完整版本号和安装包构建时间。应用、Windows EXE、安装器及首次启动标记统一升级到 V1.6。8 份多语言软件介绍全部升级并加入 V1.6 更新说明。支持从 V1.5 直接覆盖升级，保留设置、语言、会话和恢复稿。V1.5 更新内容：1.5 在保留 1.3 全部 Markdown、Mermaid、TXT、PDF 与恢复能力的基础上，重点完成以下升级：新增七种界面语言，支持跟随 Windows 自动选择或在设置中固定语言。新增 Markdown 常用格式工具栏，按钮居左紧凑排列，帮助新用户快速完成排版。源码编辑器新增真实软换行和折行行号对齐，长段落不再需要横向滚动。文件标签栏进一步收紧为 36px，提高正文可用高度。Markdown 首屏加入主题化加载提示和动画，避免启动阶段出现黑色正文区域。多语言覆盖 Markdown、Mermaid 和 PDF 内嵌页面，避免界面语言不一致。完整变更请查看程序源码根目录中的《更新日志.md》。九、当前版本边界暂不支持数学公式渲染。暂不提供图片编辑能力。PDF 仅支持查看，不支持修改、批注或表单编辑。ANSI 当前按 GBK/CP936 处理。PDF 只有在文件自身包含书签时才显示大纲栏。第一版发布目标仍为 Windows 11 x64。十、系统要求与发布信息操作系统：Windows 11 x64必需组件：Microsoft Edge WebView2 Runtime（Windows 11 通常已预装）软件名称：SaMDeditor安装包：SaMDeditor-1.5-windows-x64-setup.exe安装包 SHA-256：以发布目录中与安装包同名的 .sha256.txt 文件为准作者：Samool博客：www.samool.com十一、下载地址通过网盘分享的文件：SaMDeditor-1.8-windows-x64-setup.exe下载地址：https://pan.baidu.com/s/1lvSslkdj7egYMwoZa4x85A?pwd=jbbh 提取码: jbbh SHA-256：D22DE238A0FDE67BEF715CA7DE3AC4A64989B333E923CF2AE82F8CDFA5EB669B通过网盘分享的文件：SaMDeditor-1.7-windows-x64-setup.exe链接: https://pan.baidu.com/s/1zIL5leD2lXTCe-jshVnTAA?pwd=p97c 提取码: p97c SHA-256：F318454E2EACF1F6F50A71867964444C54074C94F4164EFE79D53E9653BB8F0A通过网盘分享的文件：SaMDeditor-1.6-windows-x64-setup.exe链接: https://pan.baidu.com/s/1crFBu3ykLLuR7pqESVZF7g?pwd=tby3 提取码: tby3 版本：1.6.0大小：14,978,706 字节构建时间：2026-08-27 17:39:43SHA-256：A52377B658F0B6A505E6376222103D61A15D5881626B63A51173FAC824BA3437通过网盘分享的文件：SaMDeditor-1.5-windows-x64-setup.exe链接: https://pan.baidu.com/s/1e4Rc0JbIhqBtNYzOmnK46w?pwd=ctyu 提取码: ctyu SHA-256：E9EAC9818E75896C75B8ABE6B62AA54CE61EF78FF92285E6E14731DB2E735911
AI摘要 本文旨在测试SaBlog2026主题对Mermaid图表的渲染效果，包括流程图、时序图、类图、状态图和ER图。测试内容包括图表的SVG图形生成、图形与代码的切换、复制源码、全屏预览、主题色切换以及响应式布局。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); Mermaid 主题效果测试本文用于测试 SaBlog2026 主题对 Mermaid 图表的渲染、图形/代码切换、深浅色模式和全屏预览功能。1. Flowchart 流程图下面的流程图模拟一篇 Markdown 文章从编写到发布的过程。flowchart TD A([开始写作]) --> B[编写 Markdown 内容] B --> C{是否包含 Mermaid 图表} C -->|是| D[添加 mermaid 代码块] C -->|否| E[继续完善正文] D --> F[本地预览文章] E --> F F --> G{检查是否通过} G -->|通过| H[发布到 Typecho] G -->|未通过| I[修改文章或图表代码] I --> F H --> J([完成])2. SequenceDiagram 时序图下面的时序图模拟读者打开文章后，浏览器加载并渲染 Mermaid 图表的过程。sequenceDiagram autonumber actor Reader as 读者 participant Browser as 浏览器 participant Typecho as Typecho participant Theme as SaBlog2026主题 participant Mermaid as Mermaid运行时 Reader->>Browser: 打开文章页面 Browser->>Typecho: 请求文章内容 Typecho->>Theme: 输出文章与主题模板 Theme-->>Browser: 返回HTML、CSS和主题脚本 Browser->>Theme: 检测mermaid代码块 alt 正文包含Mermaid图表 Theme->>Mermaid: 按需加载本地运行时 Mermaid-->>Browser: 生成SVG图形 Browser-->>Reader: 显示可交互图表 else 正文不包含Mermaid图表 Theme-->>Browser: 不加载Mermaid运行时 Browser-->>Reader: 直接显示普通文章 end3. ClassDiagram 类图下面的类图描述文章、图表查看器和主题之间的关系。classDiagram class Article { +String title +String markdown +Date createdAt +render() } class MermaidBlock { +String type +String source +validate() +renderSvg() } class DiagramViewer { +String currentView +Boolean fullscreen +showDiagram() +showSource() +toggleFullscreen() } class SaBlogTheme { +String colorScheme +detectMermaid() +loadRuntime() +refreshTheme() } Article "1" *-- "0..*" MermaidBlock : 包含 MermaidBlock "1" --> "1" DiagramViewer : 创建 SaBlogTheme --> Article : 展示 SaBlogTheme --> DiagramViewer : 控制4. StateDiagram 状态图下面的状态图用于检查图表查看器在图形、代码和全屏状态之间的切换。stateDiagram-v2 [*] --> 加载中 加载中 --> 图形模式: 渲染成功 加载中 --> 代码模式: 渲染失败 图形模式 --> 代码模式: 点击代码 代码模式 --> 图形模式: 点击图形 图形模式 --> 全屏预览: 点击全屏 全屏预览 --> 图形模式: 点击退出全屏 全屏预览 --> 图形模式: 按下Esc 图形模式 --> 深色图形: 切换深色模式 深色图形 --> 图形模式: 切换浅色模式 图形模式 --> [*]: 离开文章 代码模式 --> [*]: 离开文章5. ERDiagram 实体关系图下面的 ER 图模拟博客文章、分类、标签、评论和 Mermaid 图表之间的数据关系。erDiagram AUTHOR ||--o{ ARTICLE : writes CATEGORY ||--o{ ARTICLE : contains ARTICLE ||--o{ COMMENT : receives ARTICLE ||--o{ DIAGRAM : includes ARTICLE }o--o{ TAG : uses AUTHOR { int id PK string name string email } ARTICLE { int id PK int author_id FK int category_id FK string title text content datetime created_at } CATEGORY { int id PK string name string slug } TAG { int id PK string name } COMMENT { int id PK int article_id FK string author text content datetime created_at } DIAGRAM { int id PK int article_id FK string diagram_type text source_code }测试检查项发布或预览本文后，可以依次检查：五种图表是否都能正常生成 SVG 图形。每个图表的“图形”和“代码”按钮是否能够自由切换。代码模式下是否能够正常复制 Mermaid 源码。图形模式下点击“全屏”是否能放大预览，Esc 是否能退出。切换主题深浅色后，图表颜色是否同步更新。PC、平板和手机端是否存在裁切、重叠或横向溢出。
Apache Maka：一个面向真实工作的、本地优先的 AI Agent 工作空间
AI摘要 Apache Maka是一个本地优先的AI Agent工作空间，提供多Agent调度和可恢复执行记录。它的核心是Runtime Host，所有执行都需经过它，强调Event Log作为执行事实的Source of Truth。Maka的架构具有Event Sourcing特征，将历史与上下文解耦，适合作为企业Agent Runtime或软件工程Agent。Maka还内置了多种工具，支持MCP，并与Codex模型协议/登录/Context行为深度适配。Maka的Memory是透明的，用户可控，与ai-memory项目不同，后者服务于多个外部Agent。Maka的技术栈包括TypeScript、Node.js、Electron、React等，目前主要支持macOS Apple Silicon，Windows和Linux支持正在开发中。Maka适合个人AI工作台、企业Agent Runtime、软件工程Agent和Agent评测平台等场景。 document.addEventListener('DOMContentLoaded', function() { const urlDisplay = document.getElementById('urlDisplay'); urlDisplay.textContent = "此内容根据文章生成，更内容请访问：" + window.location.href; }); 这个项目很有意思，而且从架构层面看，Apache Maka 和你前面看的 ai-memory 完全不是同一类产品。我把当前 apache/maka 的 README、架构文档、Agent Graph、本地 Memory、MCP 以及 Codex 相关实现都看了一遍。我的定位是：Apache Maka = Local-first AI Agent Workspace + Agent Runtime + 多 Agent 调度 + 可恢复执行记录。它更接近一个开源版的 Codex / Claude Code Desktop + Agent Runtime 平台，而不是一个单纯的 Agent SDK。截至当前，仓库约 3,062 Stars、312 Forks，主语言 TypeScript，Apache-2.0 License，目前处于 Apache Incubator 孵化阶段。仓库在 2026 年 5 月创建，仍然处于高频开发期。一、Apache Maka 是什么？官方给自己的定义是：A local-first Agent workspace built for real work.即：一个面向真实工作的、本地优先的 AI Agent 工作空间。它不是让你写：agent = Agent(...) agent.run(...)这种 SDK。而是直接给你一套： Apache Maka │ ┌──────────────┼──────────────┐ │ │ │ Desktop TUI CLI │ │ │ └──────────────┼──────────────┘ │ Runtime Host │ SessionManager │ AgentRun │ ┌──────────┼──────────┐ │ │ │ Model Tools MCP │ │ │ └──────────┼──────────┘ │ Runtime Event Log │ ┌───────────┼────────────┐ │ │ │ Context Session Recovery这就是 Maka 的核心。官方架构规定：整个系统只有一个执行权威：Runtime Host。Desktop、TUI、CLI、Bot、Eval 都不能自己再搞一套 Runtime，而必须经过 Runtime Host。这是它很重要的设计原则。二、我认为 Maka 最重要的概念：Runtime Event Log很多 Agent 系统的基本模型是：Prompt ↓ LLM ↓ Tool ↓ AnswerMaka 的模型不是这样。它更像： Agent 执行 │ ▼ Runtime Event Log │ ┌────────────┼────────────┐ │ │ │ Model Tool Call Tool Result Message │ │ │ ├─权限决定 ├─失败 ├─终止 ├─Usage └─Artifacts │ ▼ 所有事实永久记录也就是说：Event Log 是执行事实的 Source of Truth。官方明确规定，模型消息、工具调用、工具结果以及终止事实都写入 Runtime Event Log；Context pruning 和 compaction 只是改变“下一次给模型看的上下文”，不会删除历史事实。这个架构非常重要。三、Context 和 History 被彻底分开了普通 Agent：History ≈ Context历史越来越长：10K ↓ 50K ↓ 100K ↓ 200K Tokens最后开始：截断 压缩 丢历史Maka 的设计是： Runtime Event Log 完整历史事实 │ │ Projection ▼ Model Context │ ┌───────┴───────┐ │ │ 当前需要 Compact 的信息 Summary所以：历史 ≠ 当前 Context。这其实和数据库领域：Event Store ↓ Projection ↓ Read Model是一个思想。严格来说 Maka 有明显的：Event Sourcing架构特征。仓库 Topics 里也明确标了 event-sourcing。四、为什么这个设计特别适合 Agent？假设 Agent 做了：1. 查看 billing.ts 2. 修改代码 3. npm test 4. 测试失败 5. 修改方案 6. 再测试 7. 成功 8. 用户拒绝一个 Bash 权限请求传统 Chat 可能最终只保留：User: 修改 billing Assistant: 已经完成。而 Maka 会有：Runtime Event Log ├── model_message ├── tool_call: Read ├── tool_result ├── tool_call: Edit ├── tool_result ├── tool_call: Bash ├── permission_request ├── permission_decision ├── tool_result ├── model_message ├── tool_call ├── tool_result └── completed于是：UI 崩了可以恢复。Context 被压缩了，历史还在。Agent 中断了，可以 Resume。工具失败了，可以审计。权限批准过什么，可以查询。这实际上是在构建：Agent Execution Ledger也就是 Agent 执行账本。五、它已经不是单 Agent 系统Maka 最近非常值得关注的一部分叫：Agent Graph但它的设计思想非常克制。官方甚至直接把设计文档标题写成：Graph Is a Schedule, Not a Second Runtime即：Graph 是调度器，不是第二套 Agent Runtime。这点我非常认同。六、Maka 的多 Agent 模型例如： Main Agent Supervisor │ ┌─────────────┼─────────────┐ │ │ │ ▼ ▼ ▼ Agent A Agent B Agent C Runtime分析 数据库分析 UI分析 │ │ │ └──────┬──────┴──────┬──────┘ │ │ ▼ ▼ Agent D Agent E 综合分析 Review但它并不会建立：Graph Runtime Agent Runtime Workflow Runtime三套执行体系。而是全部：Agent Graph │ 调度任务 │ ▼ Child Session │ ▼ AgentRun │ ▼ Runtime Event Log七、Maka 对 Operator 的定义也很漂亮Maka 把：Child Session定义为：Operator Container而：AgentRun定义为：Activation所以：Operator A │ └── Child Session │ ├── AgentRun #1 │ ├── AgentRun #2 │ └── AgentRun #3这样 Agent A 可以：第一次：分析 Billing后来 Supervisor 再告诉它：结合 Agent B 的发现继续分析它不需要创建一个完全陌生的新 Agent。而是：同一个 Child Session + 新的 AgentRun继续执行。这是非常符合工程实际的。八、Maka 内置了哪些工具？当前 README 明确列出的基础工具包括：Read Write Edit Bash Glob Grep另外还有可选：Computer Use Catalog Skills Web Search MCP Tools所以从使用体验上看，它已经比较像：Codex Claude Code Cursor Agent这一类 Coding Agent。九、MCP 支持值得特别关注Maka 有独立：packages/mcp并且 Runtime 可以把 MCP Server 暴露的工具转换成：MakaTool例如：企业 CRM MCP │ ▼ Maka │ ▼ mcp__crm__getCustomer然后 Agent 就能调用。但 Maka 做了一件很重要的事：MCP annotation 不能成为安全边界。即便某个 MCP 自己声称工具安全，Maka 仍然有自己的：Permission Sandbox Network Boundary例如网络型 MCP Tool，如果当前 Sandbox 不允许网络访问，会先要求批准，而不是直接调用。这个设计对于企业 Agent 非常正确。十、它和 Codex 的关系，比我最初预期还深我进一步看代码时发现：Maka 并不是只有：OpenAI API这种简单支持。代码中已经存在：openai-codexProvider，并实现了：Codex Device Authorization流程。甚至代码注释明确说明：这个 Device Auth 流程参考并对齐官方 codex-rs CLI 的登录实现。流程大致：Maka │ ▼ OpenAI Device Auth │ ▼ auth.openai.com/codex/device │ ▼ 用户授权 │ ▼ OAuth Token │ ▼ openai-codex connection这点对你尤其值得关注。但需要准确区分：Maka 并不是启动一个 Codex CLI 当 Agent。而是：Maka 自己是 Agent Runtime，只是可以使用 OpenAI Codex 的 OAuth/模型连接通道。仓库里还有：codex-model-compatibility.ts codex-v4a-patch.ts openai-codex-history-compactor.ts codex-session-adapter.ts等针对 Codex 的兼容代码。所以它不是“顺便支持 OpenAI”。而是对：Codex 模型协议 / 登录 / Context 行为做了专门适配。十一、它还有自己的 Local Memory这就正好可以和我们上一轮讨论的 ai-memory 对比。Maka 当前 Local Memory 核心是：MEMORY.md而且强调：Transparent Local Memory也就是：用户看得见、能编辑、能控制。当前代码设定：最大 MEMORY.md：128 KB 注入 Prompt： 最多约 12,000 字符并支持：manual extracted imported active archived review_required rejected workspace scope session scope同时：agentReadEnabled = false默认情况下 Agent 不能直接读取 Memory，需要用户显式开启。这体现了 Maka 一个很明显的设计理念：Memory 应该是透明和用户可控的。十二、但 Maka Memory 和 ai-memory 差别很大这两个项目正好可以这样理解： Apache Makaai-memory核心定位Agent 工作平台Agent 长期记忆基础设施Agent Runtime✅ 自己有❌Desktop✅❌CLI/TUI✅✅ CLISession✅接入外部 SessionTools✅❌Sandbox✅❌MCPMCP Client/Tool 集成MCP Memory ServerEvent Log✅ 核心ObservationMemoryMEMORY.mdMarkdown WikiVector SearchMemory 当前不是核心可选Codex模型/认证深度适配Codex Agent 记忆外挂多 AgentAgent GraphCross-Agent Handoff所以：ai-memory更像：Codex ─┐ Claude ├── ai-memory Cursor ┘它服务多个外部 Agent。Maka则是： Maka │ Agent Runtime │ ┌────────┼────────┐ │ │ │ Model Tools Memory │ │ │ └────────┼────────┘ │ Event Log自己就是整个 Agent 容器。十三、和 Eino 又完全不同如果把你最近关注的三套东西放在一起：项目本质EinoAgent 开发框架ai-memoryAgent Memory 基础设施Apache MakaAgent Runtime + Workspace换一种说法：Eino = 给程序员造 Agent 的 SDK ai-memory = 给 Agent 安装长期大脑 Apache Maka = 直接造了一台 Agent 电脑这是最容易理解的区别。十四、Maka 的 Eval 系统也很专业Maka 不是只有聊天界面。它还把：Agent Evaluation做成第一等公民。模型大概是：Experiment │ ├── Task ├── Subject ├── Repetition │ ▼ Cell │ ▼ Attempt │ ▼ Result例如你要比较：GPT-5.6 vs Claude Opus vs DeepSeek可以：同一个任务 同一个预算 相同重复次数 相同 verifier然后比较：Score Token Usage Cost Duration Failure Artifacts而 Maka 自己作为 Subject 时，也必须经过 Runtime Host，不能偷偷走另一套执行路径。这个设计对企业做模型选型非常有价值。十五、技术栈目前主技术栈比较清晰：TypeScript Node.js >= 22.19 npm Workspaces Electron React SQLite MCP SDK AI SDKMonorepo 结构：apps/desktop packages/ ├── core ├── storage ├── mcp ├── runtime ├── runtime-host ├── eval ├── computer-use ├── cli └── ui根 package.json 当前标记版本为 0.2.0。不过这里有一个重要区别：0.2.0 ≠ Apache 官方 Release。README 明确说明：Maka 目前还没有完成一次正式 ASF Release。当前代码/预构建物仍属于孵化阶段产物。十六、当前平台成熟度现在平台支持大致是：平台状态macOS Apple Silicon✅ 主要支持Windows🟡 PreviewLinux❌ 尚未正式支持Desktop✅CLI✅TUI✅README 目前建议：git clone https://github.com/apache/maka.git cd maka npm ci npm run dev而不是推荐直接下载正式 Apache Binary，因为正式 ASF Release 尚未产生。十七、我认为 Maka 最有价值的四个地方如果只让我挑核心，我不会挑 UI，也不会挑模型支持，而会挑这四个：① Runtime Host │ └── 单一执行权威 ② Runtime Event Log │ └── Agent Execution Ledger ③ Context Projection │ └── 历史与上下文解耦 ④ Agent Graph │ └── 调度多个 Child Sessions 而不是再造第二套 Runtime把它们放在一起： Maka │ Runtime Host │ SessionManager │ ┌──────────┴──────────┐ │ │ Main Agent Agent Graph │ │ │ ┌───────┼───────┐ │ │ │ │ │ Child A Child B Child C │ │ │ │ └─────────────┼───────┼───────┘ │ AgentRun │ Model + Tool Runtime │ ▼ Runtime Event Log │ ┌────────────────┼────────────────┐ │ │ │ Context Recovery UI Projection Projection我认为这是 Maka 真正值得研究的架构。十八、它适合什么场景？它尤其适合下面这一类：个人 AI 工作台：Codex Desktop + Claude Code + Cursor这一类工具的开源替代探索。企业 Agent Runtime：企业模型 + 企业 MCP + 权限 + Sandbox + Agent + Audit软件工程 Agent：读取代码 → 修改代码 → Bash → 测试 → Review → 多 Agent 协作Agent 评测平台：GPT Claude DeepSeek Qwen Local Model统一跑 Benchmark。十九、它目前还不是什么这一点同样重要。Maka 不是：企业知识库平台也不是：RAG 平台更不是：Flowable 那样的 BPM 工作流引擎它的 Agent Graph 目前也明确不是：任意循环 Workflow、分布式执行系统、图形化 BPM 编排器。所以不要把它理解成：Dify n8n Flowable那一类产品。它真正解决的是：Agent 如何可靠地执行工作。二十、我对 Maka 的评价从你最近研究的方向来看，我认为 Maka 的研究价值甚至比很多 Agent Framework 更高。我的评分：维度评价Agent Runtime 架构★★★★★Event Sourcing 思想★★★★★Session/Recovery★★★★★多 Agent 架构★★★★★Codex 适配★★★★☆MCP★★★★☆Memory★★★企业权限体系★★★跨平台成熟度★★★当前生产成熟度★★★综合我会给：8.7 / 10现在还偏早期，但架构思想明显高于它当前产品成熟度。特别是这三个设计，我认为值得吸收到企业 Agent 底座里：Agent 的执行过程应该 Event Sourcing。Context 是历史的 Projection，而不是历史本身。多 Agent Graph 应该是调度层，而不是再造一套 Runtime。如果把我们前面看的 ai-memory 加进来，实际上已经可以组成一套非常有意思的架构： Enterprise AI Platform │ Agent Runtime │ Apache Maka 思路 │ ┌────────────────┼────────────────┐ │ │ │ Runtime Log Agent Graph Sandbox │ │ │ └────────────────┼────────────────┘ │ MCP Layer │ ┌───────────────────┼───────────────────┐ │ │ │ Knowledge Business Memory RAG SQL/API ai-memory │ │ │ └───────────────────┼───────────────────┘ │ Enterprise Context如果目标是自研一个“企业版 Codex / AI 办公 Agent 平台”，Maka 我认为属于应该认真拆源码的项目，而不只是安装体验一下。它里面的 Runtime Host、Runtime Event Log、Agent Graph、Recovery、Permission/Sandbox 这几块尤其值得借鉴。