一、使命宣言
在数据洪流与人工智能爆发式增长的当下，传统文档格式正面临着前所未有的挑战。Logos 项目应运而生，旨在重新定义数字文档的存储与交互范式。我们的愿景是构建一个"零冗余、全语义、AI 友好"的文档生态系统。通过将排版逻辑与文本内容在物理存储层面上进行彻底的剥离，我们致力于解决传统富文本编辑器在版本控制（Git Diff 噪音）、协作冲突以及机器可读性方面的根本性缺陷。Logos 不仅仅是一个编辑器，它是一座桥梁，旨在为开发者提供代码级别的掌控力与调试便利，同时为创作者保留所见即所得的流畅视觉体验，消除技术实现与创作灵感之间的隔阂。
二、架构蓝图
存储介质：纯文本（.logos）
Logos 的文件本质是一个高度结构化的纯文本文件。在逻辑架构上，它由"元数据头"与"纯净流"两个独立且互不干扰的区域构成，两者通过特殊的不可见锚点进行逻辑分隔。
- 样式元数据头：位于文件的起始位置，是整个文档的"视觉中枢"。该区域仅包含 JSON 或类 INI 格式的键值对配置，用于定义所有语义标签（如 Heading, Quote）所对应的视觉映射规则，包括但不限于字体族、行高、字重、色彩变量以及间距参数。此区域严格遵循"无内容"原则，绝不渲染为任何可见字符，确保样式定义的纯粹性。
- 内容纯净流 ：占据文件的主体部分，是文档的"信息载体"。该区域严格剔除任何形式的内联样式代码（例如冗长的
<span style="...">或复杂的类名），仅由语义指令符（如::Heading1）与原始字符流交织组成。文本的最终呈现效果完全依赖于头部样式映射表的驱动，实现了内容与形式的完全解耦。
处理核心：双态同步引擎
Logos 的核心处理逻辑基于"双态内存模型"，确保数据在解析、编辑与持久化过程中的高效与一致性。
- 数据模型 ：系统在运行时于内存中维护两个完全独立的状态树。
StyleRegistry（样式注册表）作为单一事实来源，负责管理所有视觉主题与样式规则；SemanticTree（语义树）则专注于管理文档的层级结构、节点类型与文本内容。 - 渲染管线 ：渲染过程分为两个阶段。首先，解析器读取并构建
StyleRegistry，动态生成高效的 CSS-in-JS 或 Shadow DOM 样式作用域；随后，引擎遍历SemanticTree，根据每个节点的语义类型（如::Subtitle）精准查找StyleRegistry中对应的规则，并动态注入样式类名或内联样式，最终生成高性能的渲染视图。 - 持久化策略：在保存文件时，序列化过程将两个状态树分别反向解析为符合规范的纯文本片段，并按既定格式进行拼接写入磁盘。这种机制不仅确保了文件在外部环境下的可读性，更使得版本控制系统能够清晰地分辨出"内容变更"与"样式调整"，极大地提升了协作开发的效率。
三、交互设计与开发者体验
界面范式：极简画布与智能侧边栏
Logos 的用户界面采用"沉浸式画布 + 上下文侧边栏"的设计理念，旨在降低认知负荷，提升创作专注度。
- 沉浸式画布：中间的编辑区域完全隐藏底层的标记语法，提供类似 Figma 或现代排版软件的视觉编辑体验。用户所见即所得，无需关注背后的代码实现。
- 动态属性面板：右侧的侧边栏具备高度的上下文感知能力，能够根据用户的选区智能切换为"样式管理器"或"元素属性"面板，支持全局样式的实时覆盖与语义标签的精细化管理。
- 结构导航器：左侧的树状图实时反映文档的语义层级结构，支持通过拖拽进行快速跳转与大纲重组，帮助用户在长文档中保持清晰的逻辑脉络。
核心交互闭环
- 样式应用 ：当用户在工具栏点击"引用块"时，选中的段落会瞬间获得预设的视觉样式（如左侧边框与背景色）。然而，在底层，系统仅修改了文本前缀的语义标签（例如插入
::Quote），并未植入任何具体的像素值或颜色代码，确保了内容的纯净。 - 主题重构 ：用户可以在"样式中心"修改"正文"字体或全局色彩变量。这一操作会实时更新内存中的
StyleRegistry，并触发视图层的全量重绘，毫秒级完成整个文档的全局换肤，无需手动逐个修改段落。 - 版本控制友好：由于内容与样式的物理分离，Git Diff 变得异常清晰。内容的修改仅显示为文本流的增删，样式的调整仅显示为头部配置块的变更，彻底告别了传统 XML 或复杂 HTML 格式化带来的海量无意义噪音冲突。
四、演进路线
- Phase 1：核心原型：完成解析器与序列化器的双向编解码验证，搭建基于 ProseMirror 或 Lexical 的编辑器内核实例，实现基本的语义标签渲染与简单的样式映射功能，验证架构的可行性。
- Phase 2：样式解耦：开发功能完备的可视化样式管理器，实现动态样式注入与热更新机制，完善文件读写流程与错误恢复策略，确保数据的安全性。
- Phase 3：生态扩展：集成复杂对象的支持，如嵌入式表格、图表与多媒体元素；开发标准化的 PDF/HTML 导出管道；引入虚拟滚动技术以优化超长文档的性能表现。
- Phase 4：AI 融合：构建强大的命令行接口（CLI）工具链，开发 VS Code 插件以融入开发者工作流；为 AI 模型提供结构化的数据输入/输出接口，探索智能排版建议、自动生成摘要以及语义级内容校验等前沿功能。
五、技术选型
- 运行时：采用 Tauri 框架（Rust 后端 + 前端 WebView），在保证跨平台能力的同时，追求极致的性能表现与极低的资源占用率。
- 前端栈：选用 SvelteKit 框架，利用其响应式声明式语法提升开发效率，并利用其编译时优化能力生成高效的前端代码。
- 编辑内核：评估并选用 Lexical 或 ProseMirror 作为底层编辑内核，利用其成熟的插件化架构与深度可定制性来实现复杂的语义化节点管理。
- 样式方案：采用 UnoCSS 原子化 CSS 引擎，通过按需生成原子类名的方式，实现极致的样式生成效率与极小的 CSS 包体积。
六、价值主张
- 架构革新：通过物理层面分离样式与内容，Logos 实现了文档格式的"降维打击"，从根本上解决了困扰开发者多年的富文本 Diff 难题，让文档回归数据的本质。
- 开发者至上：纯文本的存储方式赋予了文档在版本控制系统中的一等公民地位，使得分支合并、历史回溯变得轻而易举，极大提升了团队协作的效率与愉悦度。
- 未来就绪：Logos 生成的结构化语义流是大语言模型（LLM）的理想输入格式。这种清晰的层级结构与语义标签为智能写作、自动摘要、语义分析以及知识图谱构建提供了坚实的数据基础。Logos 不仅是一款编辑器，它更是通向智能文档时代不可或缺的基础设施，是连接人类创作与机器理解的纽带。