bitmosh/lumaweave

# LumaWeave LumaWeave 是一款本地优先的图可视化和架构映射应用程序。它将结构化数据源转化为交互式图表，使用独立的 GWells 物理引擎进行布局，并通过带主题的 Sigma/WebGL 工作区进行渲染。 **状态：** 正在积极开发中 — 处于 1.0 版本之前，尚无正式发布。 ## 为什么选择 LumaWeave LumaWeave 的存在是因为通过文件列表和 grep 来追踪不断增长的代码库结构是无法长期维持的。一个持久存在、在本地渲染且尊重文件系统边界的图表，允许您直接检查和覆盖视觉属性，这比任何总是处于过时状态的“图表即服务”工具都要持久。 Adapters["Source adapters"] Adapters --> Drafts["Normalized node/edge drafts"] Drafts --> Graphology["Graphology model"] Graphology --> GWells["GWells layout + physics"] GWells --> Sigma["Sigma 3 / WebGL renderer"] Theme["Theme + override registries"] --> Sigma Inspector["Radial inspector + workspace controls"] --> Theme Inspector --> GWells Tauri["Tauri filesystem boundary"] --> Adapters ``` 主要的工程边界被刻意分开： - `src/source-adapter/` 负责特定于源的转换和加载器注册。 - `src/graph/` 负责规范化图、Graphology 构建、渲染策略、着色器和覆盖层。 - `src/physics/gwells/` 负责布局和物理，不包含 React、Sigma、浏览器、主题或应用程序导入。 - `src/themes/` 负责创作的 token、运行时 token、目标绑定、覆盖和辅助功能助手。 - `src/control-plane/` 负责命令、设置、检查器界面和区块工作区。 - `src-tauri/` 负责桌面文件系统、IDE、生命周期事件和推理边界。 更多详细信息可在[文档索引](docs/overview/DOCS_INDEX.md)中找到。 ## 工程亮点 ### 渲染器生命周期 `SigmaGraphView` 为每个图数据集创建一个 Sigma 实例。选择、悬停、主题、标签、节点几何、大小调整、固定和物理变化都会与实时的 Graphology 模型进行协调，而不是重建渲染器。 ### 独立物理 GWells 暴露了 `applyDialect()` 和一个控制器，具备手动步进、可注入调度、运行时状态、调试事件、实时配置覆盖和固定应用功能。其验证器强制执行注册表结构、交叉引用、类型导出和独立导入规范。 ### 可检查的视觉系统 径向检查器将可见界面与主题绑定和来源出处连接起来。用户可以应用作用域颜色或节点材质覆盖，检查排版和运动安全数据，在编辑器中打开注册的源位置，将覆盖复制到相关目标，以及重置目标历史记录。 ### 防御性桌面 I/O Tauri 文件系统命令会规范化路径，在适当的地方拒绝符号链接，强制执行遍历深度，将项目作用域内的读取限制在项目根目录内，并将可执行脚本限制在允许列表中。 ## 当前边界和路线图 以下尚未成为已发布的功能： - Three.js / React Three Fiber 渲染层。这些包作为具有前瞻性的依赖项存在，但应用程序在运行时不会导入它们；Sigma 2D 是活动的渲染器。 - 适配器目录的完整源覆盖。Git/代码库、网站、OpenAPI、数据库、云基础设施和问题跟踪器条目仍然是候选，目前没有可用的加载器。 - 计划中的 GWells 配置文件系统、推荐引擎、通用种子布局系列以及完整的宏/原始调整 UI。 - 完整的 3D 物理。GWells 保留 `z` 种子数据作为衔接点，而力学积分和活动渲染器仍然是 2D 的。 - 已保存的工作区配置文件和自动化的端到端 CI 执行。 有关基于证据的详细分解，请参阅[当前状态](docs/CURRENT_STATUS.md)；有关更长远的方向，请参阅[推迟与 Post-v1.0 愿景](docs/canonical/DEFERRED_AND_POST_V1_VISION.md)。 ## 生态系统 LumaWeave 是 Lattica 生态系统的一部分 —— 这是一组本地优先的工具，它们 共享 [fossic](https://github.com/bitmosh/fossic) 事件存储作为其 持久化底层。相关项目： - **[fossic](https://github.com/bitmosh/fossic)** — 内容寻址的事件存储底层 - **[lattica](https://github.com/bitmosh/lattica)** — 可观测性中心 - **[cerebra](https://github.com/bitmosh/cerebra)** — 认知运行时 - **[policy-scout](https://github.com/bitmosh/policy-scout)** — 安全测试套件 LumaWeave 可以独立使用，或者作为基于 fossic 的事件流的可视化界面。 ## 文档 - [当前状态](docs/CURRENT_STATUS.md) — 已实现、部分实现和计划中的边界。 - [更新日志](CHANGELOG.md) — 发布说明和版本历史。 - [路线图](docs/ROADMAP.md) — 发布顺序和未来方向。 - [已知问题](docs/KNOWN_ISSUES.md) — 当前缺陷和隔离的测试。 - [开发历史](docs/DEVELOPMENT_HISTORY.md) — 压缩的工程叙述。 - [文档索引](docs/overview/DOCS_INDEX.md) — 维护的阅读路径。 - [Graph、Sigma 与渲染](docs/canonical/GRAPH_SIGMA_AND_RENDERING.md) - [GWells 物理](docs/canonical/GWELLS_PHYSICS.md) - [源适配器](docs/canonical/SOURCE_ADAPTER.md) - [主题与 Token 系统](docs/canonical/THEME_AND_TOKEN_SYSTEM.md) - [区块与布局工作区](docs/canonical/TILE_AND_LAYOUT_WORKSPACE.md) 原始的工作流提示、原型、取证报告和内部代理流程笔记保留在面向 GitHub 的文档树之外。