懂AI
no-neck-pain.nvim

no-neck-pain.nvim

Neovim 智能居中缓冲区插件缓解颈部疲劳

no-neck-pain.nvim 是一个 Neovim 插件，通过智能居中焦点缓冲区来缓解颈部疲劳。它在窗口两侧创建均匀的空缓冲区作为填充，支持多标签页和自定义设置，兼容分屏及多种流行插件。该插件即插即用，无缝融入工作流程，提供便签功能和主题侧边缓冲区。适用于 Neovim 0.6 及以上版本，旨在提供非侵入式的缓冲区居中体验。

Neovim插件代码编辑器缓冲区居中工作流优化no-neck-pain.nvimGithub开源项目
访问官网GitHub论文文档
<p align="center"> <h1 align="center">☕ no-neck-pain.nvim</h2> </p> <p align="center"> 一个简单的插件，用于将当前聚焦的缓冲区居中显示在屏幕中间。 </p> <div align="center"> <video src="https://user-images.githubusercontent.com/20689156/215357783-b69f4339-a681-410f-982a-44655986f0ce.mp4"/> </div> <div align="center">

移动设备用户可查看替代的GIF展示视频

</div>

⚡️ 特性

在聚焦缓冲区的两侧创建大小相等的空缓冲区，作为窗口的填充。

想要看看实际效果？请查看展示部分

📋 安装

<div align="center"> <table> <thead> <tr> <th>包管理器</th> <th>代码片段</th> </tr> </thead> <tbody> <tr> <td>

wbthomason/packer.nvim

</td> <td> 
-- 稳定版
use {"shortcuts/no-neck-pain.nvim", tag = "*" }
-- 开发版
use {"shortcuts/no-neck-pain.nvim"}
</td> </tr> <tr> <td>

junegunn/vim-plug

</td> <td> 
-- 稳定版
Plug 'shortcuts/no-neck-pain.nvim', { 'tag': '*' }
-- 开发版
Plug 'shortcuts/no-neck-pain.nvim'
</td> </tr> <tr> <td>

folke/lazy.nvim

</td> <td> 
-- 稳定版
require("lazy").setup({{"shortcuts/no-neck-pain.nvim", version = "*"}})
-- 开发版
require("lazy").setup({"shortcuts/no-neck-pain.nvim"})
</td> </tr> </tbody> </table> </div>

🏗 v1.0.0 重大变更

查看发布说明了解完整的重大变更列表。

☄ 快速开始

无需配置/设置步骤！放松下来，直接调用:NoNeckPain即可。

⚙ 配置

注意: 需要一些定制体验的灵感吗？看看展示部分

<details> <summary>点击展开完整的选项列表及其默认值</summary>

注意: 在Neovim中也可以通过以下方式查看这些选项：

  • :h NoNeckPain.options 查看全局插件选项。
  • :h NoNeckPain.bufferOptions 查看侧边缓冲区选项。
require("no-neck-pain").setup({
    -- 打印有用的日志，包括触发的事件和执行操作的原因。
    --- @type boolean
    debug = false,
    -- 居中显示的聚焦窗口的宽度。当终端宽度小于`width`选项时，不会创建侧边缓冲区。
    --- @type integer|"textwidth"|"colorcolumn"
    width = 100,
    -- 表示侧边缓冲区的最小宽度值。
    -- 当经常切换窗口大小时，此选项可能会很有用，例如：
    -- 在全屏模式下，宽度为210，你定义的NNP `width`为100，这会创建宽度为50的侧边缓冲区。如果你将终端调整为半屏大小，每个侧边缓冲区的宽度将变为5，因此可能不再有用，反而会给你的工作流程带来"噪音"。
    --- @type integer
    minSideBufferWidth = 10,
    -- 如果列表中最后一个有效缓冲区被关闭，则禁用插件。
    --- @type boolean
    disableOnLastBuffer = false,
    -- 当为`true`时，禁用插件会关闭除最初聚焦的窗口之外的所有其他窗口。
    --- @type boolean
    killAllBuffersOnDisable = false,
    -- 添加自动命令（@see `:h autocmd`），旨在自动启用插件。
    --- @type table
    autocmds = {
        -- 当为`true`时，在你启动Neovim时启用插件。
        -- 如果主窗口是侧边树（例如NvimTree）或仪表板，命令会延迟执行，直到找到有效窗口。
        -- 一旦成功运行，该命令就会被清除。
        --- @type boolean
        enableOnVimEnter = false,
        -- 当为`true`时，在你进入新标签页时启用插件。
        -- 注意：如果你回到现有标签页，它不会触发，以防止与用户的决定产生不必要的干扰。
        --- @type boolean
        enableOnTabEnter = false,
        -- 当为`true`时，在颜色方案改变后重新加载插件配置。
        --- @type boolean
        reloadOnColorSchemeChange = false,
        -- 当为`true`时，进入no-neck-pain侧边缓冲区将自动跳过并进入下一个可用的缓冲区。
        --- @type boolean
        skipEnteringNoNeckPainBuffer = false,
    },
    -- 创建映射，方便你与暴露的命令交互。
    --- @type table
    mappings = {
        -- 当为`true`时，创建所有未设置为`false`的映射。
        --- @type boolean
        enabled = false,
        -- 设置Neovim的全局映射，允许你切换插件。
        -- 当为`false`时，不创建映射。
        --- @type string
        toggle = "<Leader>np",
        -- 设置Neovim的全局映射，允许你切换左侧缓冲区。
        -- 当为`false`时，不创建映射。
        --- @type string
        toggleLeftSide = "<Leader>nql",
        -- 设置Neovim的全局映射，允许你切换右侧缓冲区。
        -- 当为`false`时，不创建映射。
        --- @type string
        toggleRightSide = "<Leader>nqr",
        -- 设置Neovim的全局映射，允许你增加主窗口的宽度（+5）。
        -- 当为`false`时，不创建映射。
        --- @type string | { mapping: string, value: number }
        widthUp = "<Leader>n=",
        -- 设置Neovim的全局映射，允许你减少主窗口的宽度（-5）。
        -- 当为`false`时，不创建映射。
        --- @type string | { mapping: string, value: number }
        widthDown = "<Leader>n-",
        -- 设置Neovim的全局映射，允许你切换草稿板功能。
        -- 当为`false`时，不创建映射。
        --- @type string
        scratchPad = "<Leader>ns",
    },
    --- 适用于两侧缓冲区的通用选项。
    --- 查看 |NoNeckPain.bufferOptions| 了解`左侧`和/或`右侧`缓冲区的特定选项。
    --- @type table
    buffers = {
        -- 当为`true`时，侧边缓冲区将分别命名为`no-neck-pain-left`和`no-neck-pain-right`。
        --- @type boolean
        setNames = false,
        -- 将侧边缓冲区用作记事本，它们像任何Neovim缓冲区一样工作，并自动在给定的`位置`保存其内容。
        -- 注意：退出未保存的草稿板缓冲区不会阻塞，内容仍会被保存。
        --- 参见 |NoNeckPain.bufferOptionsScratchPad|
        scratchPad = NoNeckPain.bufferOptionsScratchPad,
        -- 应用于两侧缓冲区的颜色，对于缓冲区特定的选项，请参见 |NoNeckPain.bufferOptions|
        --- 参见 |NoNeckPain.bufferOptionsColors|
        colors = NoNeckPain.bufferOptionsColors,
        -- Vim缓冲区作用域选项：这里接受任何`vim.bo`选项。
        --- @see NoNeckPain.bufferOptionsBo `:h NoNeckPain.bufferOptionsBo`
        bo = NoNeckPain.bufferOptionsBo,
        -- Vim窗口作用域选项：这里接受任何`vim.wo`选项。
        --- @see NoNeckPain.bufferOptionsWo `:h NoNeckPain.bufferOptionsWo`
        wo = NoNeckPain.bufferOptionsWo,
        --- 应用于`左侧`缓冲区的选项，这里定义的选项会覆盖`buffers`中的选项。
        --- @see NoNeckPain.bufferOptions `:h NoNeckPain.bufferOptions`
        left = NoNeckPain.bufferOptions,
        --- 应用于`右侧`缓冲区的选项，这里定义的选项会覆盖`buffers`中的选项。
        --- @see NoNeckPain.bufferOptions `:h NoNeckPain.bufferOptions`
        right = NoNeckPain.bufferOptions,
    },
    -- 支持的集成，可能与`no-neck-pain.nvim`的行为冲突。
    --- @type table
    integrations = {
        -- 默认情况下，如果NvimTree是打开的，我们会在启用插件时关闭它并重新打开，
        -- 这可以防止侧边缓冲区位置错误。
        -- @link https://github.com/nvim-tree/nvim-tree.lua
        --- @type table
        NvimTree = {
            -- 树的位置。
            --- @type "left"|"right"
            position = "left",
            -- 当为`true`时，如果在启用插件之前树是打开的，我们会重新打开它。
            --- @type boolean
            reopen = true,
        },
        -- 默认情况下，如果NeoTree是打开的，我们会在启用插件时关闭它并重新打开，
        -- 这可以防止侧边缓冲区位置错误。
        -- @link https://github.com/nvim-neo-tree/neo-tree.nvim
        NeoTree = {
            -- 树的位置。
            --- @type "left"|"right"
            position = "left",
            -- 当为`true`时，如果在启用插件之前树是打开的，我们会重新打开它。
            reopen = true,
        },
        -- @link https://github.com/mbbill/undotree
        undotree = {
            -- 树的位置。
            --- @type "left"|"right"
            position = "left",
        },
        -- @link https://github.com/nvim-neotest/neotest
        neotest = {
            -- 树的位置。
            --- @type "right"
            position = "right",
            -- 当为`true`时，如果在启用插件之前树是打开的，我们会重新打开它。
            reopen = true,
        },
        -- @link https://github.com/nvim-treesitter/playground
        TSPlayground = {
            -- 树的位置。
            --- @type "right"|"left"
            position = "right",
            -- 当为`true`时，如果在启用插件之前树是打开的，我们会重新打开它。
            reopen = true,
        },
        -- @link https://github.com/rcarriga/nvim-dap-ui
        NvimDAPUI = {
            -- 树的位置。
            --- @type "none"
            position = "none",
            -- 当为`true`时，如果在启用插件之前树是打开的，我们会重新打开它。
            reopen = true,
        },
        -- @link https://github.com/hedyhli/outline.nvim
        outline = {
            -- 树的位置。
            --- @type "left"|"right"
            position = "right",
            -- 当为`true`时，如果在启用插件之前树是打开的，我们会重新打开它。
            reopen = true,
        },
    },
})
NoNeckPain.bufferOptions = {
    -- 当为`false`时，不会创建缓冲区。
    --- @type boolean
    enabled = true,
    --- @see NoNeckPain.bufferOptionsColors `:h NoNeckPain.bufferOptionsColors`
    colors = NoNeckPain.bufferOptionsColors,
    --- @see NoNeckPain.bufferOptionsBo `:h NoNeckPain.bufferOptionsBo`
    bo = NoNeckPain.bufferOptionsBo,
    --- @see NoNeckPain.bufferOptionsWo `:h NoNeckPain.bufferOptionsWo`
    wo = NoNeckPain.bufferOptionsWo,
    --- @see NoNeckPain.bufferOptionsScratchPad `:h NoNeckPain.bufferOptionsScratchPad`
    scratchPad = NoNeckPain.bufferOptionsScratchPad,
}

NoNeckPain.bufferOptionsWo = {
    --- @type boolean
    cursorline = false,
    --- @type boolean
    cursorcolumn = false,
    --- @type string
    colorcolumn = "0",
    --- @type boolean
    number = false,
    --- @type boolean
    relativenumber = false,
    --- @type boolean
    foldenable = false,
    --- @type boolean
    list = false,
    --- @type boolean
    wrap = true,
    --- @type boolean
    linebreak = true,
}

NoNeckPain.bufferOptionsBo = {
    --- @type string
    filetype = "no-neck-pain",
    --- @type string
    buftype = "nofile",
    --- @type string
    bufhidden = "hide",
    --- @type boolean
    buflisted = false,
    --- @type boolean
    swapfile = false,
}

--- NoNeckPain的便笺缓冲区选项。
---
--- 将侧边缓冲区用作记事本，它们像任何Neovim缓冲区一样工作，并自动在指定的`location`保存其内容。
--- 注意：退出未保存的便笺缓冲区不会阻塞，内容仍会被保存。
---
---@type table
---默认值：
---@eval return MiniDoc.afterlines_to_code(MiniDoc.current.eval_section)
NoNeckPain.bufferOptionsScratchPad = {
    -- 当为`true`时，自动为侧边缓冲区设置以下选项：
    -- - `autowriteall`
    -- - `autoread`
    --- @type boolean
    enabled = false,
    -- 保存便笺内容并加载到缓冲区的文件路径。
    --- @type string?
    --- @example: `~/notes.norg`
    pathToFile = "",
}

NoNeckPain.bufferOptionsColors = {
    -- 十六进制颜色代码，用于覆盖缓冲区的当前背景色。（例如 #24273A）
    -- 默认支持透明背景。
    --- @type string?
    background = nil,
    -- 增亮（正值）或调暗（负值）侧边缓冲区的背景色。接受的值范围为[-1..1]。
    --- @type integer
    blend = 0,
    -- 十六进制颜色代码，用于覆盖缓冲区的当前文本颜色。（例如 #7480c2）
    --- @type string?
    text = nil,
}

## 🧰 命令

|   命令   |         描述        |
|-------------|----------------------------|
|`:NoNeckPain`| 切换插件状态，在启用和禁用之间切换。 |
|`:NoNeckPainResize INT`| 使用给定的`INT`值更新配置`width`并调整no-neck-pain窗口大小。 |
|`:NoNeckPainToggleLeftSide`| 切换左侧缓冲区（打开/关闭）。 |
|`:NoNeckPainToggleRightSide`| 切换右侧缓冲区（打开/关闭）。 |
|`:NoNeckPainWidthUp`| 将配置`width`增加5并调整no-neck-pain窗口大小。 |
|`:NoNeckPainWidthDown`| 将配置`width`减少5并调整no-neck-pain窗口大小。 |

## ⌨ 贡献

我们随时欢迎PR和问题。提出问题时请务必提供尽可能多的上下文。

查看[Makefile](./Makefile)以了解可用的命令

> 你需要安装[Bob](https://github.com/MordechaiHadad/bob)，这是一个有用的nvim版本管理器，以便为每个支持的版本运行测试套件。

## 🗞 Wiki

你可以在[Wiki](https://github.com/shortcuts/no-neck-pain.nvim/wiki)上找到插件的指南和展示

## 🎭 动机

尽管有其他（很棒的！）替代方案提供了禅意、无干扰的中心模式，但它们通常会做一些可能改变你工作流程的假设，或者至少需要一些配置来满足你的需求。

`no-neck-pain.nvim`旨在提供一种无缝、非主观的缓冲区居中体验，同时具有超强的可定制性。

编辑推荐精选

Qwen2.5-VL

Qwen2.5-VL

一款强大的视觉语言模型，支持图像和视频输入

Qwen2.5-VL 是一款强大的视觉语言模型，支持图像和视频输入，可用于多种场景，如商品特点总结、图像文字识别等。项目提供了 OpenAI API 服务、Web UI 示例等部署方式，还包含了视觉处理工具，有助于开发者快速集成和使用，提升工作效率。

HunyuanVideo

HunyuanVideo

HunyuanVideo 是一个可基于文本生成高质量图像和视频的项目。

HunyuanVideo 是一个专注于文本到图像及视频生成的项目。它具备强大的视频生成能力，支持多种分辨率和视频长度选择，能根据用户输入的文本生成逼真的图像和视频。使用先进的技术架构和算法，可灵活调整生成参数，满足不同场景的需求，是文本生成图像视频领域的优质工具。

WebUI for Browser Use

WebUI for Browser Use

一个基于 Gradio 构建的 WebUI，支持与浏览器智能体进行便捷交互。

WebUI for Browser Use 是一个强大的项目，它集成了多种大型语言模型，支持自定义浏览器使用，具备持久化浏览器会话等功能。用户可以通过简洁友好的界面轻松控制浏览器智能体完成各类任务，无论是数据提取、网页导航还是表单填写等操作都能高效实现，有利于提高工作效率和获取信息的便捷性。该项目适合开发者、研究人员以及需要自动化浏览器操作的人群使用，在 SEO 优化方面，其关键词涵盖浏览器使用、WebUI、大型语言模型集成等，有助于提高网页在搜索引擎中的曝光度。

xiaozhi-esp32

xiaozhi-esp32

基于 ESP32 的小智 AI 开发项目，支持多种网络连接与协议，实现语音交互等功能。

xiaozhi-esp32 是一个极具创新性的基于 ESP32 的开发项目，专注于人工智能语音交互领域。项目涵盖了丰富的功能，如网络连接、OTA 升级、设备激活等，同时支持多种语言。无论是开发爱好者还是专业开发者，都能借助该项目快速搭建起高效的 AI 语音交互系统，为智能设备开发提供强大助力。

olmocr

olmocr

一个用于 OCR 的项目，支持多种模型和服务器进行 PDF 到 Markdown 的转换，并提供测试和报告功能。

olmocr 是一个专注于光学字符识别（OCR）的 Python 项目，由 Allen Institute for Artificial Intelligence 开发。它支持多种模型和服务器，如 vllm、sglang、OpenAI 等，可将 PDF 文件的页面转换为 Markdown 格式。项目还提供了测试框架和 HTML 报告生成功能，方便用户对 OCR 结果进行评估和分析。适用于科研、文档处理等领域，有助于提高工作效率和准确性。

飞书多维表格

飞书多维表格

飞书多维表格 ×DeepSeek R1 满血版

飞书多维表格联合 DeepSeek R1 模型，提供 AI 自动化解决方案，支持批量写作、数据分析、跨模态处理等功能，适用于电商、短视频、影视创作等场景，提升企业生产力与创作效率。关键词：飞书多维表格、DeepSeek R1、AI 自动化、批量处理、企业协同工具。

CSM

CSM

高质量语音生成模型

CSM 是一个开源的语音生成项目，它提供了一个基于 Llama-3.2-1B 和 CSM-1B 的语音生成模型。该项目支持多语言，可生成多种声音，适用于研究和教育场景。通过使用 CSM，用户可以方便地进行语音合成，同时项目还提供了水印功能，确保生成音频的可追溯性和透明度。

agents-course

agents-course

Hugging Face 的 AI 智能体课程，涵盖多种智能体框架及相关知识

本项目是 Hugging Face 推出的 AI 智能体课程，深入介绍了 AI 智能体的相关概念，如大语言模型、工具使用等。课程包含多个单元，详细讲解了不同的智能体框架，如 smolagents 和 LlamaIndex，提供了丰富的学习资源和实践案例。适合对 AI 智能体感兴趣的开发者和学习者，有助于提升他们在该领域的知识和技能。

RagaAI-Catalyst

RagaAI-Catalyst

用于 AI 项目管理和 API 交互的工具集，助力 AI 项目高效开发与管理。

RagaAI-Catalyst 是一款专注于 AI 领域的强大工具集，为开发者提供了便捷的项目管理、API 交互、令牌管理等功能。支持多 API 密钥上传，能快速创建、列出和管理 AI 项目，还可获取项目用例和指标信息。适用于各类 AI 开发场景，提升开发效率，推动 AI 项目顺利开展。

smolagents

smolagents

一个包含多种工具和文档处理功能，适用于 LLM 使用的项目。

smolagents 是一个功能丰富的项目，提供了如文件格式转换、网页内容读取、语义搜索等多种工具，支持将常见文件类型或网页转换为 Markdown，方便进行文档处理和信息提取，能满足不同场景下的需求，提升工作效率和数据处理能力。

下拉加载更多