{"id":50731379,"url":"https://github.com/beixiyo/vv-hover.nvim","last_synced_at":"2026-06-10T09:01:16.945Z","repository":{"id":354985921,"uuid":"1220667350","full_name":"beixiyo/vv-hover.nvim","owner":"beixiyo","description":"Mouse-hover triggered LSP hover popup. 鼠标悬停自动 LSP Hover","archived":false,"fork":false,"pushed_at":"2026-05-23T08:47:56.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T10:35:12.074Z","etag":null,"topics":["hover","lsp","lua","mouse","neovim","neovim-plugin","nvim","nvim-plugin"],"latest_commit_sha":null,"homepage":null,"language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beixiyo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-25T07:05:56.000Z","updated_at":"2026-05-23T08:47:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/beixiyo/vv-hover.nvim","commit_stats":null,"previous_names":["beixiyo/vv-hover.nvim"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/beixiyo/vv-hover.nvim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beixiyo%2Fvv-hover.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beixiyo%2Fvv-hover.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beixiyo%2Fvv-hover.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beixiyo%2Fvv-hover.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beixiyo","download_url":"https://codeload.github.com/beixiyo/vv-hover.nvim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beixiyo%2Fvv-hover.nvim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34144680,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hover","lsp","lua","mouse","neovim","neovim-plugin","nvim","nvim-plugin"],"created_at":"2026-06-10T09:01:15.288Z","updated_at":"2026-06-10T09:01:16.926Z","avatar_url":"https://github.com/beixiyo.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003evv-hover.nvim\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003e基于鼠标位置的自动 LSP Hover — 悬停即显文档，可扩展 Provider\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Neovim-0.10+-57A143?style=flat-square\u0026logo=neovim\u0026logoColor=white\" alt=\"Requires Neovim 0.10+\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Lua-2C2D72?style=flat-square\u0026logo=lua\u0026logoColor=white\" alt=\"Lua\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/zero_deps-✓-2ea44f?style=flat-square\" alt=\"Zero Dependencies\" /\u003e\n\u003c/p\u003e\n\n---\n\n## 安装\n\n```lua\n{\n  'beixiyo/vv-hover.nvim',\n  event = 'VeryLazy',\n  ---@type HoverConfig\n  opts = {\n    enabled = true,\n\n    timing = {\n      hover_delay = 500,       -- 鼠标停留触发延迟（ms）\n      close_delay = 300,       -- 鼠标移开后延迟关闭（ms）\n    },\n\n    ui = {\n      border = 'rounded',      -- 边框样式\n      max_width = 80,\n      max_height = 20,\n      focusable = true,\n      zindex = 150,\n      relative = 'mouse',     -- 浮窗相对位置：'mouse' | 'cursor' | 'editor'\n    },\n\n    behavior = {\n      close_on_move = true,    -- 鼠标移出符号位置时自动关闭\n      close_on_insert = false, -- 进入插入模式时关闭\n      only_normal_buf = true,  -- 只在普通文件 buffer 中启用\n    },\n  },\n}\n```\n\n## 配置\n\n### 时序\n\n| 选项 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `timing.hover_delay` | `integer` | `500` | 鼠标悬停多久后触发 hover（ms） |\n| `timing.close_delay` | `integer` | `300` | 鼠标移开后延迟多久关闭浮窗（ms） |\n\n### UI\n\n| 选项 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `ui.border` | `string` | `'rounded'` | 浮窗边框样式 |\n| `ui.max_width` | `integer` | `80` | 最大宽度 |\n| `ui.max_height` | `integer` | `20` | 最大高度 |\n| `ui.focusable` | `boolean` | `true` | 浮窗是否可聚焦 |\n| `ui.zindex` | `integer` | `150` | 浮窗层级 |\n| `ui.relative` | `string` | `'mouse'` | 浮窗定位基准：`'mouse'` / `'cursor'` / `'editor'` |\n\n### 行为\n\n| 选项 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `behavior.close_on_move` | `boolean` | `true` | 鼠标移出符号位置时自动关闭 |\n| `behavior.close_on_insert` | `boolean` | `false` | 进入插入模式时关闭 |\n| `behavior.only_normal_buf` | `boolean` | `true` | 只在普通文件 buffer 中启用（跳过 terminal / nofile 等） |\n| `provider` | `HoverProvider?` | `nil` | 自定义内容提供者（`nil` 使用默认 LSP provider），也可通过 `set_provider()` 设置 |\n\n### 自定义 Provider\n\n默认使用 LSP hover。可通过 `set_provider` 替换为自定义内容源：\n\n```lua\nrequire('vv-hover').set_provider(function(ctx, callback)\n  -- ctx: { bufnr, winid, row, col, line_text, mouse_pos, lsp_clients }\n  callback({ lines = { '自定义内容' }, filetype = 'markdown' })\n  return true -- 异步 provider 返回 true\nend)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeixiyo%2Fvv-hover.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeixiyo%2Fvv-hover.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeixiyo%2Fvv-hover.nvim/lists"}