Zenzic：确定性文档完整性

用于 Markdown/MDX 图的确定性文档完整性引擎与 SAST。

Zenzic 是一款用于 Markdown/MDX 图的确定性文档完整性引擎与 SAST。 此扩展将您的 CI/CD pipeline 中使用的同款 $O(N)$ SAST 引擎直接引入到您的创作环境中，在您输入时提供低于 50ms 的拓扑反馈。 ## 瘦客户端架构 此扩展是一个严格的**瘦客户端（Thin Client）**。它不包含任何解析逻辑、regex 引擎或验证规则。它通过 Language Server Protocol (LSP) 利用标准 I/O 与您系统上安装的 Zenzic Python 二进制文件直接进行通信。 ## 核心功能 ### 1. 安全扫描（SAST） 使用 RE2 验证引擎规则，可在几毫秒内标记出硬编码的凭据（Z201）和路径遍历序列（Z202/Z203），从而在文件保存之前防止泄露。 ### 2. 图拓扑分析（VSM） 修改某个文件中的标题，Zenzic 的 Virtual Site Map (VSM) 会利用 $O(K)$ 增量图修补技术，立即让您整个工作区中的所有断开链接、孤立页面或失效的导航节点失效。 ### 3. 确定性 CI/CD 强制执行与质量评分 将鼠标悬停在任何诊断信息上，即可查看准确的 Z-Code、Zero-DBT 质量评分扣分以及直接来自 Core 引擎的确定性修复指南，确保与您的 CI/CD 质量门禁保持 1:1 的一致性。 ## 环境要求 此扩展需要 **Zenzic Core v0.23.4 或更高版本**。 我们建议通过 `uv` 进行安装或更新： ``` uv tool install --force zenzic ``` ## 扩展设置 默认情况下，扩展将在您系统的 PATH 中查找 `zenzic` 二进制文件。 如果您使用的是本地虚拟环境或自定义安装路径，请在您的工作区或用户 `settings.json` 中配置可执行文件路径： ``` { "zenzic.executablePath": "${workspaceFolder}/.venv/bin/zenzic" } ``` ## 故障排除 ### Zenzic：Core 版本过旧 - **原因**：扩展解析到的可执行文件版本低于最低要求的 Core 版本（`v0.23.4`）。 - **修复**：升级您的全局二进制文件： uv tool install --force zenzic 或者在 `settings.json` 中将 `zenzic.executablePath` 指向包含 Core `v0.23.4` 或更高版本的虚拟环境。 ### Zenzic：未找到（ENOENT） - **原因**：系统 `$PATH` 中不存在 `zenzic` 可执行文件。这种情况通常发生在 Flatpak 或 Snap 编辑器环境中，因为用户的二进制目录（`~/.local/bin`）与进程环境是隔离的。 - **修复**：在您的工作区或用户 `settings.json` 中指定二进制文件的绝对路径： { "zenzic.executablePath": "/home/user/.local/bin/zenzic" } ## 架构保证 - **零遥测：** Zenzic 完全在本地运行。不会向云端发送任何数据。 - **零 LLM：** 所有分析在数学上都是确定性的。没有概率性的猜测。 - **低于 50ms 延迟：** 增量 $O(K)$ 图修补技术可确保无论工作区大小如何，都能获得实时反馈。 如需了解完整的发现分类和架构文档，请访问 [zenzic.dev](https://zenzic.dev)。

标签：DNS 反向解析, Markdown, SOC Prime, 云安全监控, 代码质量检查, 开发工具, 文档校验, 网络安全审计, 自动化攻击, 逆向工具, 静态分析, 静态应用安全测试