62 lines
1.4 KiB
Markdown
62 lines
1.4 KiB
Markdown
# QQdock.nvim
|
||
|
||
Persistent adaptive terminal dock for Neovim.
|
||
|
||
每次按 `<c-t>` 打开 shell，聊完 Reasonix 按 `<C-i>` 隐藏，再按回来——对话还在。横屏自动右侧分屏，竖屏自动下方分屏。
|
||
|
||
## 安装
|
||
|
||
```lua
|
||
-- lazy.nvim
|
||
{
|
||
'newbie/QQdock.nvim',
|
||
url = 'https://git.qyhhh.top/newbie/QQdock.nvim',
|
||
dependencies = { 'akinsho/toggleterm.nvim' },
|
||
config = function()
|
||
local Q = require('QQdock')
|
||
vim.keymap.set({ 'n', 'i' }, '<c-t>', Q.shell, { noremap = true })
|
||
vim.keymap.set('n', '<C-i>', function() Q.open('reasonix') end)
|
||
vim.keymap.set('n', '<leader>gg', function() Q.open('lazygit') end)
|
||
end,
|
||
}
|
||
```
|
||
|
||
## 用法
|
||
|
||
```lua
|
||
local Q = require('QQdock')
|
||
|
||
Q.shell() -- 普通 shell
|
||
Q.open('reasonix') -- Reasonix AI agent
|
||
Q.open('lazygit') -- lazygit
|
||
Q.open('btm') -- 系统监控
|
||
Q.open('yazi') -- 文件管理器
|
||
```
|
||
|
||
## API
|
||
|
||
| 函数 | 参数 | 作用 |
|
||
|------|------|------|
|
||
| `Q.shell()` | — | 打开/关闭持久 shell |
|
||
| `Q.open(cmd)` | cmd | 打开/关闭指定命令的持久终端 |
|
||
|
||
## 特性
|
||
|
||
- **持久化** — toggle 显隐，终端状态保留
|
||
- **自适应** — 横屏右侧 45%，竖屏下方 40%
|
||
- **轻量** — 仅依赖 toggleterm.nvim
|
||
|
||
## Development
|
||
|
||
### Run tests
|
||
|
||
```bash
|
||
luarocks test --local
|
||
# or
|
||
busted
|
||
```
|
||
|
||
## License
|
||
|
||
MIT
|