back to home

w0fv1 / vertree

单文件版本管理系统

View on GitHub
101 stars
8 forks
1 issues

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing w0fv1/vertree in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/w0fv1/vertree)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

Vertree Vertree 是一个面向单文件的可视化版本管理工具,适合设计稿、文档、脚本、配置文件这类不适合直接放进 Git 工作流的内容。它用树状结构组织版本,用监控机制做自动备份,并通过系统原生入口尽量不改变你原本的使用习惯。 0.11.0-alpha5 现状 • 支持 Windows 桌面使用,提供安装包、托盘、右键菜单、Windows 11 新菜单适配、监控页、版本树、设置页。 • 支持 macOS 桌面使用,GitHub Release 会生成带架构标识的 / 和符号包,并提供菜单栏/托盘、Finder Services、应用菜单和开机自启。 • 支持 Linux 桌面使用,GitHub Release 会生成便携 、 和 RPM,并提供托盘、GNOME Files 右键菜单、开机自启和设置页集成开关。 • GitHub Actions 会自动构建 Windows、macOS、Linux 三个平台的发布产物。 • 新增本机 HTTP API 和 OpenAPI 文档,可用于本地自动化测试、监控任务检查、版本树与备份验证。 • 新增局域网文件分享能力,可为某个版本文件生成局域网下载链接、二维码和自动选路桥接页。 • 提供本地开发控制脚本 ,可托管 进程并发送 hot reload / hot restart / restart 命令。 核心能力 • 树状版本管理:主线版本、分支版本、备注标签都会直接体现在文件名和界面里。 • 自动监控备份:监控文件变化,按配置频率自动写入 目录,并按数量上限清理旧备份。 • 快速入口:Windows 右键菜单、macOS Finder Services、Linux GNOME Files 右键菜单、托盘菜单、应用菜单都可以直接触发操作。 • 跨平台命令入口: 查看版本树, 、 、 直接执行动作。 • 设置集中管理:语言、主题、监控频率、最大备份数、上下文菜单、自启动、本机 HTTP API 都可以在设置页调整。 • 本机自动化接口:提供 loopback-only HTTP API 与 OpenAPI 文档,便于 AI 和脚本验证功能。 • 局域网临时分享:在版本树节点上可直接生成局域网下载分享链接和二维码,接收端可通过浏览器获取文件。 • 单实例与启动优化:避免重复打开,改善启动显示和托盘恢复体验。 使用方式 Windows • 到 GitHub Releases 下载最新的 、 、 ,或用于 Win11 菜单调试的 • / 适合常规安装; 是真正的便携版,解压后可直接运行 • 如需 unsigned 供本地开发调试或后续签名,可在 Windows 本地构建时设置 • 首次启动完成初始化 • 通过文件右键菜单、托盘或设置页开始使用 macOS 到 GitHub Releases 下载最新的 macOS 或 ,文件名会带上当前构建架构(如 / )。 已支持的 macOS 入口: • Finder Services:备份、快速备份、监控、查看版本树 • 应用菜单:设置、备份、快速备份、监控、查看版本树 • 菜单栏图标:打开设置、执行常用操作 • 开机自启:通过设置页启用 如需本地构建运行: Linux 到 GitHub Releases 下载: • :便携发布包 • :Debian / Ubuntu 安装包 • :RPM 安装包 GNOME 环境下已支持: • 托盘菜单 • GNOME Files 顶层右键菜单 • 设置页中启用/禁用右键菜单 • 开机自启 如需本地构建: 命令行 本机 HTTP API 默认启用的本机 HTTP API 只绑定 ,默认起始端口为 ,若被占用会自动递增。 • :接口索引 • :OpenAPI 文档 • :交互式文档 • :运行状态 • :退出当前 Vertree 应用 • :切换到指定页面 • :切换窗口为还原 / 最大化 / 全屏 • :让文件树适配视口或设置缩放比例 • :导出当前应用窗口 PNG 截图 • :监控任务管理 • :触发单次备份 • :列出备份目录文件 • :列出同一版本族文件 • :生成版本树 • :管理局域网文件分享 用于刷新文档截图时,可以配合本地开发控制器运行: 它会通过 拉起或复用开发中的应用实例,再调用 和 自动更新 下的截图资源。 开发运行 Windows macOS 如果项目位于 iCloud 同步的 或 下,macOS 可能在签名阶段失败,建议移到非 iCloud 目录。 构建 macOS 发布工件: Linux 构建 Linux 发布工件: 开发控制脚本 本地代理或自动化工具可以通过 托管 : 默认控制器地址为 ,支持: • • • • • • • • 配置文件 配置保存在应用支持目录下的 中。常用字段包括: • • • • • • • • • 建议优先通过设置页修改,而不是手动编辑。 文档 • 用户文档:https://vertree.w0fv1.dev/ • 局域网分享桥接页:https://vertree.w0fv1.dev/file_share • 本地文档开发:docs/README.md 已知限制 • Windows 11 新菜单默认支持安装版直接注册;如果菜单没有立即刷新,可能需要重新启动 Explorer 或重新切换一次设置页开关。 • Linux 下 GNOME Files 右键菜单依赖 ,GNOME 托盘常常还依赖额外的 AppIndicator 扩展。 • macOS 发布工件目前未做 Apple notarization,首次打开可能需要手动确认。 • 版本树画线和复杂树布局仍有继续优化空间。 后续方向 • 更稳定的版本树布局与画布体验 • 更细的权限控制与平台集成 • 文件差异展示、搜索和验证能力 许可 MIT. See LICENSE.