lvexplore

lvexplore 使用说明

两种使用方式: 在浏览器中查看你的 VI，或让 AI agent 进行读取。两种方式均需账号（邀请制）。

申请使用 登录

从这里开始

  1. 提交申请。批准后你会收到一次性链接: 用它设置密码，然后登录。
  2. 在浏览器中: 前往文件页面上传 VI（或打开示例项目），点击即可查看前面板与程序框图。
  3. 使用 agent: 前往账号页面创建 key，将服务加入你的 agent（见下方），即可开始提问你的 VI 相关内容。

在浏览器中

  • 文件页面接收单个文件（.vi、.ctl、.vim、.llb …）。包含文件夹结构的项目请由 agent 以 .zip 上传，上传后也会显示在文件页面。
  • 点击文件即可打开: 根据文件内容渲染程序框图与前面板，支持逐个分支（Case）查看；项目将在左侧显示项目结构树。
  • 每次上传对应一个工作区，保留至主动删除；再次上传相同项目或 VI 将生成下一版本。其 ID 即为 agent 读取同一组文件所需的标识。

版本比较

  • 修改后再次上传项目: 相同名称即为下一版本。在文件页面点击“与 v1 比较”，即可列出逻辑变更、新增或删除的每一个 VI。
  • 每个有变更的 VI 均提供文本报告（节点、连线、常量、Case 以及匹配置信度）和双图并排对比视图（差异处均以圆圈标示）。
  • 你的 agent 可通过 vi_diff_tree、vi_diff 和 vi_diff_view 完成相同操作，以较新的上传作为 workspace_b。

连接你的 agent

MCP 地址 https://lvexplore.tailc2cd24.ts.net/mcp，附带请求头 Authorization: Bearer KEY（KEY 为你在账号页面创建的密钥）。同一个 key 可用于 MCP 与 REST；建议每个 agent 或每台机器各创建一个。

大多数 agent 会拒绝未被显式允许的工具，表现就如同服务故障一般: 请允许这些只读工具 —— service_guide, workspace_list, workspace_files, kept_list, vi_summary, vi_content, vi_layout, vi_neighborhood, vi_structure, vi_types, project_overview, llb_members, vi_diff, vi_diff_view, vi_diff_tree, vi_callers, vi_picture.

Claude Code (已实测 2026-10-01 (claude -p))
claude mcp add --transport http lvexplore https://lvexplore.tailc2cd24.ts.net/mcp --header "Authorization: Bearer KEY"
  • 添加后请重启会话；`claude mcp list` 应显示 Connected。
  • 每个工具首次调用前会发起确认提示。无头模式（`claude -p`）无法进行交互提示，因此所有调用都会被拒绝（"you haven't granted it yet"），除非你传入 --allowedTools "mcp__lvexplore__service_guide mcp__lvexplore__workspace_list mcp__lvexplore__workspace_files mcp__lvexplore__kept_list mcp__lvexplore__vi_summary mcp__lvexplore__vi_content mcp__lvexplore__vi_layout mcp__lvexplore__vi_neighborhood mcp__lvexplore__vi_structure mcp__lvexplore__vi_types mcp__lvexplore__project_overview mcp__lvexplore__llb_members mcp__lvexplore__vi_diff mcp__lvexplore__vi_diff_view mcp__lvexplore__vi_diff_tree mcp__lvexplore__vi_callers mcp__lvexplore__vi_picture"
Codex CLI (已实测 2026-10-01 (0.159.2))
export LVEXPLORE_KEY=KEY
codex mcp add lvexplore --url https://lvexplore.tailc2cd24.ts.net/mcp --bearer-token-env-var LVEXPLORE_KEY
  • 只读工具无需审批即可运行（已标记为只读）。workspace_upload / workspace_delete 需要你的确认；在 `codex exec -c approval_policy="never"` 策略下将被拒绝。
Gemini (Antigravity CLI, agy) (已实测 2026-10-01 (agy 1.2.14))
agy mcp add -H "Authorization: Bearer KEY" lvexplore https://lvexplore.tailc2cd24.ts.net/mcp
# then in ~/.gemini/antigravity-cli/settings.json, permissions.allow:
"mcp(lvexplore/service_guide)", "mcp(lvexplore/workspace_list)", "mcp(lvexplore/workspace_files)", "mcp(lvexplore/kept_list)", "mcp(lvexplore/vi_summary)", "mcp(lvexplore/vi_content)", "mcp(lvexplore/vi_layout)", "mcp(lvexplore/vi_neighborhood)", "mcp(lvexplore/vi_structure)", "mcp(lvexplore/vi_types)", "mcp(lvexplore/project_overview)", "mcp(lvexplore/llb_members)", "mcp(lvexplore/vi_diff)", "mcp(lvexplore/vi_diff_view)", "mcp(lvexplore/vi_diff_tree)", "mcp(lvexplore/vi_callers)", "mcp(lvexplore/vi_picture)"
  • 无头模式（`agy --print`）会拒绝所有未授权的 MCP 调用，且不输出任何内容、退出码仍为 0 —— 请检查其日志，而非退出码。切勿使用 --dangerously-skip-permissions: 它会同时放行写入工具。
Cursor (根据该客户端的官方文档编写，尚未在此服务上实测)
~/.cursor/mcp.json: {"mcpServers": {"lvexplore": {"url": "https://lvexplore.tailc2cd24.ts.net/mcp", "headers": {"Authorization": "Bearer KEY"}}}}
Gemini CLI (gemini) (根据该客户端的官方文档编写，尚未在此服务上实测)
~/.gemini/settings.json: {"mcpServers": {"lvexplore": {"httpUrl": "https://lvexplore.tailc2cd24.ts.net/mcp", "headers": {"Authorization": "Bearer KEY"}}}}
  • 与 agy 属于不同程序；命令行参数与配置文件均不同。
Claude Desktop (根据该客户端的官方文档编写，尚未在此服务上实测)
claude_desktop_config.json: {"mcpServers": {"lvexplore": {"command": "npx", "args": ["mcp-remote", "https://lvexplore.tailc2cd24.ts.net/mcp", "--header", "Authorization: Bearer KEY"]}}}
  • 其 Connectors 页面要求 OAuth 认证，本服务暂未提供；改由 mcp-remote 桥接转发 key。

可以提问的内容

连接后用自然语言提问即可；agent 会先上传、再读取。例如:

  • 使用 lvexplore: 将我的项目文件夹打包为 zip 上传，然后告诉我主 VI 的功能以及其状态机包含哪些状态。
  • 在工作区 <workspace id> 中读取 Main.vi，列出其调用的所有 subVI 及其输入输出参数。
  • 在工作区 <workspace id> 中，哪些 VI 调用了 Config.vi？展示各调用者调用该 VI 所在的分支（Case）。
  • 我将项目上传了两次（工作区 <workspace id> 与较新的一个）: 对比这两次上传 —— 哪些 VI 在逻辑上有变更（忽略排版差异）？

不使用 MCP（REST 接口）

每个工具都有同参数、同响应的 HTTP 对应接口: 供脚本使用，或在 MCP 客户端无法直连时使用。完整参考请见 agent 读取的说明文档: /api/v1/guide.

curl -H 'Authorization: Bearer KEY' -F files=@project.zip https://lvexplore.tailc2cd24.ts.net/api/v1/workspaces

你的文件

  • 上传的文件将保留至你手动删除。你的账号享有存储配额及 30 天上传额度；删除文件可释放存储空间，但不会恢复已消耗的上传额度。仅当你勾选“保留一份副本”（或在上报问题时请求保留）时，才会保留用于改进解析器的副本 —— 且该副本仅在解析器遇到无法解析的内容时，才会在你删除原文件后继续留存。你随时可以在文件页面撤回同意。
  • 你的读取记录与问题报告将按你在“账号”页指定的保留天数保存（最多 30 天）。在该页面删除账号将立即注销登录并使所有 key 失效；7 天后账号及其名下所有数据将被永久删除。
  • 受密码保护的 VI 仅读取其属性信息 —— 绝不解析前面板或程序框图。
  • 每次读取仅记录解析器未能识别的代码（不含你文件中的文本，也不含文件名），以便我们后续修复。