dogsinatas29/SYNAPSE

GitHub: dogsinatas29/SYNAPSE

SYNAPSE 将源代码转化为可视化的架构地图,帮助工程师直观理解和分析大型软件系统中的依赖关系、执行流程与结构性问题。

Stars: 31 | Forks: 1

# SYNAPSE **不要只阅读代码。去洞察架构。** 软件的复杂性并非源于代码本身。 软件的复杂性源于那些无形的关系。 SYNAPSE 将源代码转化为可探索的架构地图, 让工程师能够直观地可视化大型软件系统中的依赖关系、执行流程、 瓶颈以及系统级的交互。 [![版本](https://img.shields.io/badge/version-v0.3.32-brightgreen.png)](https://github.com/dogsinatas29/SYNAPSE) [![最新发布](https://img.shields.io/badge/latest-v0.3.32%20Collaboration%20Flow%20Visibility-orange.png)](https://github.com/dogsinatas29/SYNAPSE/releases) ![状态](https://img.shields.io/badge/status-Production_Ready-brightgreen.png) [🇨🇳 简体中文版](./README.ko.md) SYNAPSE 帮助您理解系统。 从数百个文件和数千个依赖中, 提炼出真正关键的核心节点。 ## SYNAPSE 如何理解系统架构 | 1. 全局依赖图 | 2. 过滤干扰 | | :---: | :---: | | ![全局依赖图](https://static.pigsec.cn/wp-content/uploads/repos/cas/31/319a2bfafc8173a3fb15f5e2d98e0189758ab40bd781bd0c96bcf2d0607b8355.png) | ![过滤干扰](https://static.pigsec.cn/wp-content/uploads/repos/cas/42/42c28e8e95334eae9310d00be48d27c7b5f9ebf42aa7c06c49b896f3c205ac2e.png) | | *"这就是真实项目的样子"* | *"消除干扰信息"* | | **3. 聚焦核心节点** | **4. 流量热力图** | | ![聚焦核心节点](https://static.pigsec.cn/wp-content/uploads/repos/cas/e5/e5381b2bb45b7fd137c151ab0f18a3fda354e3c00bbd3094e7a17b4aaf8dc7cd.png) | ![流量热力图](https://static.pigsec.cn/wp-content/uploads/repos/cas/98/98b902794846b262203cb9c7814d36547a60b1ce016a8ba91de2559af1b1c345.png) | | *"告诉您该看哪里"* | *"为您展示最重要的部分"* | # 为什么选择 SYNAPSE? 现代软件已经不再是由单个人编写的了。 问题不在于编写代码。 问题在于理解数千个文件、 多名开发人员 以及分布式系统是如何作为一个整体进行交互的。 SYNAPSE 将源代码转化为可视化的架构地图。 它帮助架构师和高级工程师: * 识别架构瓶颈 * 追踪依赖链 * 可视化项目级的逻辑结构 * 通过 Harvest 汇集远程团队的产出 * 审查大型代码库而无需手动遍历文件 SYNAPSE 首先关注的是可见性。 不是同步。 不是问题追踪。 不是版本控制。 而是可见性。 # 适用人群? ### 架构审查 * 技术负责人 (Tech Leads) * 资深工程师 (Staff Engineers) * CTO 适合需要掌握庞大项目结构并追踪依赖关系的人群。 ### 分布式开发团队 * 远程办公团队 * 基于 VM 的开发环境 * 多操作系统环境 适合需要将多人在统一空间中创建的产出进行可视化的团队。 ### 遗留与棕地项目 * 过时的代码库 * 无文档的项目 * 结构难以理解的系统 适合希望在阅读代码之前先查看架构的人群。 ## 📸 演示 ![交互演示](https://static.pigsec.cn/wp-content/uploads/repos/cas/47/4794c7a9da18de83203b67eb34dc3839adc1141e268f17b6a38c1e868349abaf.webp) *缩放、图层可见性和流量热力图演示。* ![缩放细节演示](https://raw.githubusercontent.com/dogsinatas29/SYNAPSE/main/assets/synapse_zoom_detail.webp) *展示图标、徽章和提示框的深度缩放细节。* ![拓扑视图](https://static.pigsec.cn/wp-content/uploads/repos/cas/e8/e877ec799df837ad7708fa6e101d29cb18873a6224d2a10a527fd79e71b17442.png) SYNAPSE 使用丰富的视觉词汇来传达您架构的本质与健康状态。 ### 1. 📄 实体类型(身份图标) 定义节点的物理本质或架构角色。 | 图标 | 类型 | 含义 | 视觉样式 | | :--- | :--- | :--- | :--- | | 📄 | 活跃源码 | 物理源文件(逻辑、配置等)。 | 实线边框,基础颜色 | | ⚡ | 原子逻辑 | 核心逻辑或入口点(包含 Atomic 签名)。 | 紫色光晕 (DTR) | | 📁 | 文件夹 | 目录结构集群。 | 文件夹集群容器 | | ☁️ | 外部 API | 外部库(os, fs)或 API 调用依赖。 | 云状 UI | | 📚 | 文档架 | 里程碑、发布说明、架构文档。 | 画布上默认隐藏 | | 🧪 | 测试用例 | 单元测试和验证脚本(.test.ts)。 | 橙色边框 | | 🧩 | 组件 | 模块化 UI 或逻辑组件单元。 | 蓝绿色边框 | | ⚙️ | 处理器 | 数据转换或计算引擎。 | 紫灰色边框 | | 🤝 | 服务 | 共享逻辑或基础设施服务层。 | 蓝色边框 | | ⛩️ | 门控 | 安全、身份验证或流量控制器。 | 粗黄色边框 | | 📋 | 数据记录 | DB schema、JSON 模型或纯数据定义。 | 粗边框,深色背景 | | 👻 | 幽灵源码 | 被引用但缺少物理文件的内部源码。 | 虚线边框 | ### 2. 🎨 节点状态与光晕 定义节点当前的推理状态及视觉显著性。 | 状态 | 视觉提示 | 颜色 | 含义 | | :--- | :--- | :--- | :--- | | **活跃** | 实线边框 | `#83a598` | 已验证且当前在代码库中处于活跃状态。 | | **高 DTR** | 紫色光晕 | `#8a2be2` | 高推理密度;关键逻辑点。 | | **幽灵** | 虚线边框 | `#928374` | 拟议的架构节点(尚未具象化)。 | | **已删除** | 灰显 | `#282828` | 已安全注释或废弃的节点。 | | **警告** | 红色脉冲 | `#fb4934` | 检测到逻辑错误、循环依赖或死胡同。 | | **坏死** | 💀 | `#1d2021` | 致命的逻辑失败;构建中断或严重的物理缺陷。 | | **墓碑** | 🪦 | `#1d2021` | 不可恢复的确定性失败;建议删除。 | ### 3. ➡️ 逻辑与流程标记 根据缩放级别(LOD)在节点或边上出现的标记。 | 图标 | 类型 | 含义 | | :--- | :--- | :--- | | ↻ | 循环 | 迭代逻辑(for、while、map)。 | | ◈ | 决策 | 分支逻辑(if、switch、验证)。 | | 🖨️ | 输出 | 终端日志、打印或副作用输出。 | | 📡 | 信号 | 网络请求或远程过程调用 (RPC)。 | | 📊 | 负载 | 高带宽数据移动或流。 | | 🕒 | 异步 | 异步处理或等待状态。 | ### 4. ⚠️ 危险与净化标记 系统纯度与架构健康状况的视觉指标。 | 图标 | 类型 | 含义 | 视觉样式 | | :--- | :--- | :--- | :--- | | 💀 | 坏死 | 架构失败(循环依赖等)。 | 深色背景 + 噪点 | | 🪦 | 墓碑 | 持续的确定性违规记录。 | 墓碑标记 | | 💣 | 地雷 | 高风险点(检测到破坏性变更)。 | 红色轮廓警告 | | ⚠️ | 逻辑故障 | 特定的代码级错误或同步失败。 | 红色脉冲 / 警告图标 | | 🔴 | 污点 | 需要同步/推送的本地更改。 | 右上角红点 | ### 5. ✅ 交互与批准徽章 代表同步状态和用户指令状态的智能徽章。 | 徽章 | 状态 | 含义 | | :--- | :--- | :--- | | ✅ | 已确认 | 由 Commander 手动批准。 | | 🤖 | AI 已验证 | 根据代码库自动验证通过。 | | ❓ | 待定 | 等待验证的拟议设计(草稿)。 | | ❌ | 清除 | 标记为进行物理移除或删除。 | | 🔒 | 已锁定 | 不可变状态;受保护免受修改。 | ### 🔗 边与线条约定 SYNAPSE 使用独特的颜色和样式来表示节点之间不同类型的逻辑连接和数据流。 | 边类型 | 颜色 | 样式与粗细 | 含义 | | :--- | :--- | :--- | :--- | | **依赖** | `#ebdbb2` | 实线 2px | 标准模块依赖或导入。 | | **数据流** | `#83a598` | 实线 3px | 海量数据传输或负载移动。 | | **事件** | `#fe8019` | 实线 2px | 事件触发或异步回调。 | | **条件** | `#d3869b` | 实线 1px | 条件分支,如 if/else 或 match。 | | **源** | `#d65d0e` | 实线 1.5px | 用于 AI 逻辑追踪的 prompt 源链接。 | | **API 调用** | `#8ec07c` | 虚线 2px | 外部 API 或跨服务网络调用。 | | **DB 查询** | `#d3869b` | 实线 3px | 数据库查询、变更或事务。 | | **循环/回溯** | `#fe8019` | 点线 2px | 循环回溯(while/for)或逆向逻辑流。 | | **高亮** | `#fabd2f` | 脉冲 5px | 活动执行路径(悬停/选中)。 | ## 🚀 快速开始 在几秒钟内开启您的可视化架构之旅。 ### 1. 安装扩展 从[发布页面](https://github.com/dogsinatas29/SYNAPSE/releases)下载最新的 `.vsix` 文件并运行: ``` code --install-extension synapse-visual-architecture-v0.3.28.vsix ``` ### 2. 启动画布 点击编辑器标题栏或侧边栏中的 **🧠 画布图标**。 ### 3. 即时分析 选择 **"Lite Bootstrap"** 以自动发现您的项目架构。 ## ✨ 核心功能 - **🧠 实时图表可视化**:您项目的实时网络映射。 - **🚫 混合黑名单系统**:通过 O(1) 路径匹配智能排除干扰(node_modules, dist)。 - **🖱️ 资源管理器上下文集成**:右键点击任何文件/文件夹,即可立即将其加入黑名单并刷新图表。 ![资源管理器菜单](https://static.pigsec.cn/wp-content/uploads/repos/cas/03/03bf416d833f497a122ec68b842c44d6e65cf32dae8bb789b2c2d67071cd82dc.png) - **🔍 N-hop 聚焦视图**:自动识别关键核心节点。 - **⚠️ 诊断智能**:实时架构分析(R1-R5)。 - **🧩 AI 扫描集成**:适用于 Python、Rust、C++ 和 TS 的统一扫描引擎。 - **语义缩放(LOD)**:通过性能优化导航数千个节点。 ## 🔍 语义分析与图层可见性 SYNAPSE 提供了强大的语义过滤器,通过控制图层可见性和隔离关键逻辑路径来分析海量图表。 | 1. 默认视图 | 2. 隐藏引导线(降噪) | | :---: | :---: | | ![默认视图](https://static.pigsec.cn/wp-content/uploads/repos/cas/57/578533fa326d982409f928f5e3e5f727d98792e4996fe359e54402919d46bf5d.png) | ![隐藏引导线](https://static.pigsec.cn/wp-content/uploads/repos/cas/f5/f54ada32111e50070895303b5c28f4ad321d945637853b27a95c6f999db00718.png) | | **3. 聚焦顶部节点(N-hop)** | **4. 流量热力图(Beta)** | | ![聚焦顶部](https://static.pigsec.cn/wp-content/uploads/repos/cas/fa/fa3bc94df9ae55d92f7a296a2846d3b6f065cab1e8f2552d61a35464d9845e72.png) | ![流量热力图](https://static.pigsec.cn/wp-content/uploads/repos/cas/a2/a2eb6b5ea00dd6758697fdc2efd5b78acaabd8a1b41597dc2e76becc08596336.png) | ### 示例 **完整图表:** ``` A ─ B ─ C ─ D ─ E │ │ F G ─ H ─ I ``` **聚焦视图(N = 1,中心 = C):** ``` B ─ C ─ D │ G ``` **聚焦视图(N = 2,中心 = C):** ``` A ─ B ─ C ─ D ─ E │ │ F G ─ H ``` ### 为什么这很重要 - **即时缩小范围**:在庞大的图表中缩小调试范围。 - **路径追踪**:快速追踪特定的执行流。 - **局部异常检测**:识别局部区域内的结构缺陷。 ### 🔀 自动生成的流程视图 SYNAPSE 根据底层架构自动生成逻辑流程图。 **生成条件:** - 图表必须包含有效的逻辑或数据流边(例如,`Flow`、`Calls`、`Depends`)。 - 节点必须正确连接;没有连接的独立、零散节点将无法形成有意义的流程图。 - 可通过顶部导航栏的 `View -> Flow View` 菜单访问。 ![流程视图截图](https://static.pigsec.cn/wp-content/uploads/repos/cas/62/62f7ffda0861af96bb952e124015e2a237328f833c77418a076bf2153d2e67fb.png) 流程视图图像 ![流程视图截图 2](https://static.pigsec.cn/wp-content/uploads/repos/cas/79/79021c491fe3884e7bbad73030c0451e7cba09690423ecded989c573f9919ebd.png) 特定节点的信息也可以在流程视图中进行验证 ![网络附加流程视图](https://static.pigsec.cn/wp-content/uploads/repos/cas/11/1190b9f110643fd97065eeb591b6c2a55ec233fedae8c503ba7c2e246c3b2582.png) 连接到网络的客户端逻辑也包含在流程视图中。 ## 📂 集群可见性SYNAPSE 提供了一个**集群可见性面板**,以有效管理庞大的架构。它提供了类似文件资源管理器的分层视图,让您可以一目了然地掌握和控制复杂的文件夹(集群)结构。 ![集群可见性](https://static.pigsec.cn/wp-content/uploads/repos/cas/7f/7f15167369dd7230a4b73bbe90cc0309e518b2a09c493d1fc4477b4ff8214416.png) ### 快捷操作 - **모든 클러스터 - (Collapse All)**:折叠树中的所有集群,仅显示最高级别的分组。 - **루트만 보기 (Roots Only)**:仅展开根集群,同时保持更深层次处于折叠状态。 - **모든 클러스터 + (Expand All)**:展开树中的所有集群,以显示其完整内容。 ### 1. 直观的层级与递归计数 可见性面板反映了您项目的实际文件夹结构。文件夹旁边的数字表示包含在其中及其所有子文件夹内的**所有节点(文件)的累计总数**。只需查看顶级文件夹,您就能立即知道一个模块内有多少组件。 ![集群折叠](https://static.pigsec.cn/wp-content/uploads/repos/cas/3e/3eaaa3994cd766c54da9cc393603571d56924c5a799b75052ed781d5cb56d57d.png) ### 2. 级联可见性切换 您可以使用复选框切换特定文件夹的可见性。当您切换父文件夹时,**可见性状态会自动级联到其所有后代文件夹**。这允许您通过单击隐藏或显示包含数百个节点的大型模块。 ### 3. 实时 REVEAL 导航 点击文件夹旁边的 `→` (REVEAL) 按钮,可将画布相机平滑导航到其节点聚集的位置。即使您手动拖动过节点,它也会**追踪实时的物理坐标**,并使其完美居中于您的屏幕上。 ### 4. 网络附加客户端识别 由连接到网络的客户端创建的集群在可见性面板中会被清晰区分。系统会自动在它们的集群名称前添加客户端的帐户名(例如,`[username]`),从而保持远程命名空间的完美隔离并使其易于识别。 ![网络附加集群](https://static.pigsec.cn/wp-content/uploads/repos/cas/d3/d367fbbab8025104b219f3604188dc4e1563f860fa73ee83a9c9d3e77093a59d.png) ## 🌾 收获 Harvest 是一个基于快照的收集系统,Architect(服务器)可以通过它安全地收集协作者的工作成果。 [![SYNAPSE Harvest 演示](https://img.youtube.com/vi/ctQZHE7ZZ3A/0.jpg)](https://youtu.be/ctQZHE7ZZ3A) Harvest 并不旨在实现通用的双向同步。传统的客户端 ↔ 服务器 ↔ 客户端架构会导致所有权冲突和状态不一致,从而引发未定义的行为。 为了防止这种情况,Harvest 采用了 **以 Architect 为中心的单向收集模型**。 ``` Client → Snapshot → Server → Archive ``` ![网络附加文件](https://static.pigsec.cn/wp-content/uploads/repos/cas/40/4048eeeec2c422f40380c75ae1c5e454ed971656173fd8e3ec04f2f2042dfdbe.png) 来自连接到网络的客户端的文件会直接显示在 Synapse 屏幕上,从而实现逻辑验证。 ![Harvest](https://static.pigsec.cn/wp-content/uploads/repos/cas/b3/b31870568f181f26e5fb0c161668d5600807204874de76909c822cfc55a9334b.png) 在来自已连接客户端的文件中,只有经过验证的文件才能被“收集”并保存到服务器。 Harvest 的目标不是代码集成,而是**安全的收集与保存**。 ### 工作原理 #### 基于可见性的收集 Harvest 不会无差别地收集整个项目。 Architect 仅从画布上具有激活可见性的客户端图层中选择性收集,并可通过 UI 手动选择要复制的文件。 这最大限度地减少了不必要的数据涌入和仓库污染。 #### 客户端隔离 收集到的文件不会被合并到一个单一的共享文件夹中。 每个客户端都被分配了一个独立的用户根目录(User Root),并且他们的收集结果会保存在隔离的特定用户 Harvest 空间中。 ``` .synapse/ └─ clients/ ├─ userA/ │ └─ harvest/ └─ userB/ └─ harvest/ ``` 这种结构保证了: * 可追踪的所有权 * 安全的差异对比 * 独立删除 * 防止覆盖冲突 #### 收集锁定 当 Harvest 进行时,目标客户端会进入 LOCK(锁定)状态。 客户端屏幕上会出现警告覆盖层,提示正在进行 Harvest,从而最大限度地减少收集过程中潜在的状态更改。 收集锁定是一项支持数据完整性的保障措施,旨在在收集过程中保持确定性的状态。 ### 目录结构 ``` .synapse/ └─ clients/ ├─ {username}/ │ ├─ harvest/ │ ├─ metadata.json │ ├─ snapshots/ │ └─ cache/ └─ ... ``` #### harvest/ 在保持其原始结构的同时,存储实际收集到的源代码。 #### metadata.json 存储会话信息、客户端标识符和协作元数据。 #### snapshots/ 旨在用于未来版本的历史记录和备份层。 #### cache/ 用于远程文件查看和临时数据处理的缓冲空间。 ### 安全保障 #### 文件冲突保护 即使文件同名,它们也不会冲突或相互覆盖,因为每个用户的存储空间都是隔离的。 #### 路径遍历保护 诸如父目录访问(`../`)之类的路径转义尝试会在服务器端被拦截。 #### 类型安全的结果处理 Harvest 结果数据通过明确的类型结构进行处理,防止因运行时键值不匹配而导致的数据丢失。 ### Harvest 不是同步 Harvest 是一个用于收集和保存数据的功能。 它不执行自动合并、自动覆盖或冲突解决。 代码集成是通过 Architect 的审查和判断手动执行的;自动化同步超出了 Harvest 的范围。 ## 🔍 Verify(架构逻辑报告) Verify 是 Architect 的实时诊断系统,用于检查架构图的健康状况——包括**当前所有已连接的远程客户端**。 ### Verify 菜单项 #### 🔬 扫描架构 (AI) 对当前架构图运行由 AI 驱动的全面语义分析。扫描所有节点和边,检测 schema 违规、死胡同节点、断开的边以及耦合异常。生成包含详细发现的 `LOGIC_REPORT.md`。 - 将远程客户端节点(通过 SSE 连接)纳入分析范围。 - 报告以操作系统显示语言输出(通过 `vscode.env.language` 自动检测韩文/英文)。 #### 🧪 模拟调试 激活虚拟调试器模式。模拟架构图上的运行时行为,对逻辑验证失败的节点应用诊断状态(坏死、墓碑)。 - 诊断包括所有已连接客户端的架构层,而不仅仅是本地项目。 - 允许 Architect 观察哪些远程节点已失败或失效,而无需进行 Harvest。 #### 💀 模拟坏死 手动将 **坏死** 状态应用于选定节点。用于将节点标记为逻辑死亡——表明它具有损坏的依赖项、缺失的引用,或已被 AI 分析标记。 坏死节点显示为红色边框和深色背景。相连的边被标记为断裂。 #### 🪦 模拟墓碑 手动将 **墓碑** 状态应用于选定节点。墓碑代表一个已完全废弃或从活动架构中移除的节点。在画布上呈现为墓碑视觉标记。 #### 🧹 清除调试 从画布中移除所有调试视觉状态(坏死、墓碑),并将节点重置为默认渲染状态。不影响实际的图表数据。 #### 💎 Det Bootstrap (`v0.2.28: Determinism Bootstrap`) 运行确定性引导序列。重置内部状态校验和,并为当前架构快照重新建立确定性基准。用于消除因重复编辑而累积的非确定性。 #### 🔄 深度重新扫描 从头开始对整个项目目录进行全面重新扫描。所有之前缓存的图表数据都将被丢弃,并重新执行完整的文件到节点流水线。在图表偏离实际文件系统状态时使用。 ### 推理压力 Verify 系统报告 **推理压力** —— 一种用于衡量架构健康状况的标准化指标: | 压力 | 状态 | 含义 | |---|---|---| | 0–10% | 🟢 稳定 | 架构健康 | | 10–30% | 🟡 注意 | 检测到轻微问题 | | 30–60% | 🟠 警告 | 存在严重问题 | | 60%+ | 🔴 危急 | 需要立即采取行动 | 压力 = `criticalIssues / totalAnalyzedNodes × 100`。具有尺度不变性——适用于小型(50 个节点)和大型(5000 个节点)项目。 ## 🏗️ 架构 SYNAPSE 由以下几个层级组成: - **Scanner**:深度语义多语言分析器。 - **Graph Engine**:确定性、不可变状态机。 - **Visualization Layer**:混合 2D Canvas 与 3D WebGL 加速渲染。 - **AI Merge Logic**:智能解析幽灵引用和活跃文件。 ## 🧠 理念 **“您所见即 LLM 的逻辑”** SYNAPSE 的诞生是为了克服以代码为中心的开发模式的局限性。它弥合了大型语言模型 (LLM) 推理与物理代码架构之间的鸿沟,将抽象逻辑转化为交互式的高性能节点-边网络。 ## 📜 修订历史 | 版本 | 发布日期 | 描述 | | :---: | :---: | :--- | | **v0.3.33.1_fix** | 2026-07-16 | **渲染虚拟化与流水线修复**:移除了硬编码的边限制(50k),该限制曾静默中断了像 VSCode-main 这样的大型单仓库的渲染流水线。恢复了 'LINES (No Badges)' 边可见性模式。将精确的遥测探针集成到 WebGL/Canvas2D 流水线中,以追踪剔除和 LOD 瓶颈。通过剔除空目录的填充并将 `collapsed` 状态边界逻辑正确传递给 BottomUp 打包器,解决了集群膨胀问题。 | | **v0.3.33.1** | 2026-07-15 | **美学与 LOD 优化**:修复了“仅限根节点”集群可见性漏洞,以正确识别深度 1 的大陆作为根节点,允许正确展开它们,使其内容可见,而不是折叠成缺失的块。实现了 3 级边 LOD(FULL/CLUSTER/NONE)以消除大型单仓库上过早的边剔除。重构了触控板缩放逻辑,采用非线性 DeltaY 敏感度,修复了过度敏感的“显微镜”滚动。 | | **v0.3.33** | 2026-07-14 | **集群层级与拖拽大修**:彻底重构了集群交互和可见性控制。用统一的集群拖拽模型取代了孤立的节点拖拽,该模型可递归移动所有子集群及其节点。升级了集群可见性面板,新增 3 个快捷操作按钮(`Collapse All`, `Roots Only`, `Expand All`)以进行快速 LOD 管理。实现了基于深度的命中检测(`getClusterHeaderAt`)优先级,即使在深度嵌套的路径中也能确保可靠地选择父集群。 | | **v0.3.32.4** | 2026-07-05 | **UX 与可见性改进**:为集群可见性面板添加了递归节点计数和级联切换。修复了 REVEAL 功能的实时坐标追踪,使用 `👤 [username]` 标签完全隔离了远程客户端命名空间,并修补了状态重置期间的严重内存泄漏。 | | **v0.3.32.1** | 2026-06-27 | **跨网络追踪与语义流程图**:改进了流程图渲染质量(单次 Barycenter 排序,红色虚线回溯边)。实现了 `[SYNAPSE_NETWORK_LINK]` 宏,用于绕过语言语法限制进行跨项目依赖解析。修复了远程客户端节点的 IFF 逻辑,并通过 Harvest 证明了分布式 DAG 合并。 | | **v0.3.32.2** | 2026-06-29 | **文件删除同步与架构物理修复**:修复了手动节点删除同步漏洞,安全处理了绝对路径与相对路径。扩展了 `EXTERNAL_PACKAGES` 以识别 7 种语言的 100 多种标准框架,消除了虚假的幽灵节点。增强了正则表达式以正确解析 `[SYNAPSE_NETWORK_LINK]` 跨工作空间依赖,并将远程幽灵集群到 `cluster_ghost_network_remote`。通过注入动态 `📁 Root` 集群以强制进行全局物理打包,修复了根目录文件无限布局折叠的问题。解决了工作空间状态的 JSON 序列化误报错误。 | | **v0.3.32.1** | 2026-06-27 | **跨项目追踪与语义流程布局**:将 Flow View 升级为具有单次 Barycenter 排序的语义流程布局,大幅减少了边交叉。以红色虚线可视化回溯边。引入了 `[SYNAPSE_NETWORK_LINK]` 以实现通用的、与语言无关的跨网络依赖解析。修复了客户端节点镜像(IFF 逻辑)以区分本地和远程客户端节点。在 Flow View 中通过 Harvest DAG 合并证明了分布式架构协作。 | | **v0.3.32** | 2026-06-26 | **协作流可见性**:修复了导致 Flow View 中 100% 客户端贡献节点不可见的幽灵过滤器冲突。客户端节点现在绕过 `!isGhost` 过滤器,由 `_isClientLayerVisible()` 开关控制。修复了当存在客户端节点时静默导致 `buildFlow()` 崩溃的 `reasons` ReferenceError。统一了跨调试/生存/流逻辑的客户端节点检测过滤器。贡献实体图阶段 0 验证:`(filePath, userId)` 被确认为规范身份。 | | **v0.3.31** | 2026-06-25 | **诊断稳定性与可观测性**:修复了来自 `doc`/`file`/`folder` 节点的误报坏死。将压力计算标准化为 `criticalIssues / totalNodes`。将幽灵集群(`cluster_ghosts`、`doc_shelf`)排除在提示之外。添加了基于 `clientTimestamp` 的失效状态(Active/Stale/Offline)不透明度可视化。提示框现在显示 `"[username] Updated Xm ago"`。软断开连接具有 15 分钟的缓存保留时间,用于崩溃后的调试。 | | **v0.3.30.2** | 2026-06-25 | **安全强化与 Harvest 稳定性**:验证了 6 个关键攻击媒介(路径遍历、身份验证绕过、SSE 污染、锁定绕过、沙箱逃逸、客户端欺骗)。修复了管理 UI 上的端口绑定冲突和 403 身份验证错误。为旧版数组格式的 `accounts.json` 和 `synapse_history.json` 实现了向后兼容性,以防止在 Harvest 期间发生 `unshift` 崩溃。 | | **v0.3.30** | 2026-06-22 | **基于 Harvest 的协作模型**:引入会话管理、安全 SSH 传输和远程投影层的重大架构升级。Harvest 引擎和身份权限的全面集成。 | | **v0.3.29** | 2026-06-06 | **集群重叠解决与外部层修复**:实现了初始传播(通过 FNV-1a 哈希的圆形布局)+ 集群推开引擎(质量加权的 AABB 推开)以解决集群/节点重叠。修复了外部层开启时外部幽灵集群框不显示的问题。将 Align Architecture 集群扩展减少了 50%(roleOffsets 减半)。 | | **v0.3.27** | 2026-05-28 | **数据同步弹性与层主权**:解决了导致幻影边消失(`Edges: 0`)的关键数据同步漏洞。确保 UI 层分离逻辑正确隔离已扫描的文件夹和自定义分组,而不会造成结构损坏。 | | **v0.3.26** | 2026-05-26 | **2D 边验证补丁**:修复了由于 HTML5 Canvas API 上下文不支持的无效 dash array 回退 `[0, 0]`,导致实线边在 2D 模式下静默渲染失败的漏洞。 | | **v0.3.25** | 2026-05-25 | **集群感知局部对齐**:重构了布局对齐物理,使节点能够相对于其特定集群的重心进行整洁对齐,防止在排列架构时发生全局坐标塌陷。 | | **v0.3.24** | 2026-05-24 | **RULES.md 嵌入与引导强化**:将标准 DTR(Dynamic Thought Routing)和强制文件投影规则深度嵌入到 Bootstrap 引擎中,在初始化时默认建立安全和设计约束。 | | **v0.3.23** | 2026-05-02 | **混合黑名单与智能入职引导**:实现了 O(1) 路径匹配黑名单系统。添加了用于即时排除的资源管理器上下文菜单。修复了 webview 布局塌陷问题。 | | **v0.3.22.11** | 2026-04-22 | **交互稳定性与坐标主权**:通过 Timestamp Guards 和 Position Persistence 解决了节点拖拽抖动问题。统一了 SSoT 层之间的绝对坐标系。 |22.11** | 2026-04-22 | **交互稳定性与坐标主权**:通过 Timestamp Guards 和 Position Persistence 解决了节点拖拽抖动问题。统一了 SSoT 层之间的绝对坐标系。 | | **v0.3.22.10** | 2026-04-20 | **渲染一致性与身份绑定 (SSoT)**:完全的 2D/3D 视觉同步,以及基于 SSoT 的工具提示身份绑定,实现 100% 的数据一致性。 | | **v0.3.21** | 2026-04-18 | **视觉一致性与边捆绑**:完全的约定同步,Bezier 流整合,以及用于快照完整性的遗忘防护。 | | **v0.3.20** | 2026-04-17 | **Rust 持久化与引擎强化**:基于路径的 Rust 支持 ID,用于物理稳定性的速度限制。 | | **v0.3.18** | 2026-04-17 | **诊断提示引擎**:实时架构分析(R1-R5),零未知语义标记。 | [查看完整历史](REVISION_HISTORY.md) ## 📅 状态与路线图 - **状态**:v0.3.30.1 – UI/UX 优化与功能清理。 - **下一步**: - 服务器/客户端分离,以实现远程分析。 - 针对 50k+ 节点的高级性能优化。 - 实时协作架构设计。 ## 📜 许可证与作者 基于 [GNU 通用公共许可证 v3.0](LICENSE) 授权。 由 [dogsinatas29](https://github.com/dogsinatas29) 用 🧠 打造
标签:SOC Prime, WebSocket, 代码分析, 依赖分析, 凭证管理, 可视化界面, 开发工具, 架构可视化, 系统架构, 自动化攻击, 逆向工具