llm-with-vim 2.0.20261111__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. llm_engine/__init__.py +29 -0
  2. llm_engine/__main__.py +5 -0
  3. llm_engine/default_config.json +65 -0
  4. llm_engine/editors/micro/README.md +114 -0
  5. llm_engine/editors/micro/llm_micro/help/llm-micro.md +39 -0
  6. llm_engine/editors/micro/llm_micro/llm_micro.lua +673 -0
  7. llm_engine/editors/micro/llm_micro/repo.json +7 -0
  8. llm_engine/editors/micro/llm_micro/syntax/llm-chat.yaml +14 -0
  9. llm_engine/editors/vim/doc/llm.txt +175 -0
  10. llm_engine/editors/vim/ftdetect/llm.vim +2 -0
  11. llm_engine/editors/vim/plugin/llm.vim +592 -0
  12. llm_engine/editors/vscode/LICENSE +21 -0
  13. llm_engine/editors/vscode/README.md +66 -0
  14. llm_engine/editors/vscode/extension.js +511 -0
  15. llm_engine/editors/vscode/package.json +100 -0
  16. llm_engine/editors/vscode/syntaxes/llm-chat.tmLanguage.json +53 -0
  17. llm_engine/engine.py +1774 -0
  18. llm_engine/install_editors.py +577 -0
  19. llm_engine/plugin_loader.py +184 -0
  20. llm_engine/plugins/tools/__init__.py +1 -0
  21. llm_engine/plugins/tools/bash.py +53 -0
  22. llm_engine/plugins/tools/edit.py +63 -0
  23. llm_engine/plugins/tools/list_dir.py +44 -0
  24. llm_engine/plugins/tools/python.py +55 -0
  25. llm_engine/plugins/tools/read.py +38 -0
  26. llm_engine/plugins/tools/search.py +66 -0
  27. llm_engine/plugins/tools/view_image.py +69 -0
  28. llm_engine/plugins/tools/web_fetch.py +53 -0
  29. llm_engine/plugins/tools/write.py +49 -0
  30. llm_engine/provider_spec.py +350 -0
  31. llm_engine/providers/ali.json +64 -0
  32. llm_engine/providers/deepseek.json +64 -0
  33. llm_engine/providers/haijing.json +64 -0
  34. llm_engine/providers/llama.json +68 -0
  35. llm_engine/providers/ollama.json +76 -0
  36. llm_engine/providers/openai_compat.json +67 -0
  37. llm_engine/providers/zhipu.json +64 -0
  38. llm_engine/schemas/provider.schema.json +34 -0
  39. llm_engine/tools.py +115 -0
  40. llm_with_vim-2.0.20261111.dist-info/METADATA +445 -0
  41. llm_with_vim-2.0.20261111.dist-info/RECORD +45 -0
  42. llm_with_vim-2.0.20261111.dist-info/WHEEL +5 -0
  43. llm_with_vim-2.0.20261111.dist-info/entry_points.txt +5 -0
  44. llm_with_vim-2.0.20261111.dist-info/licenses/LICENSE +21 -0
  45. llm_with_vim-2.0.20261111.dist-info/top_level.txt +1 -0
llm_engine/__init__.py ADDED
@@ -0,0 +1,29 @@
1
+ """LLM Engine - 处理.llm文件并发送给LLM服务"""
2
+
3
+ import sys
4
+ import os
5
+
6
+ # 获取文件编码:优先从环境变量获取
7
+ _file_encoding = os.environ.get('LLM_FILE_ENCODING', '')
8
+ if not _file_encoding:
9
+ _file_encoding = 'utf-8'
10
+
11
+ # 确保编码是有效的,否则回退到 utf-8
12
+ try:
13
+ 'test'.encode(_file_encoding)
14
+ except LookupError:
15
+ _file_encoding = 'utf-8'
16
+
17
+ # Windows 下重设置标准流的编码(stdin、stdout、stderr)
18
+ if sys.platform == 'win32':
19
+ import io
20
+ sys.stdin = io.TextIOWrapper(sys.stdin.buffer, encoding=_file_encoding, errors='replace')
21
+ sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding=_file_encoding, errors='replace')
22
+ sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding=_file_encoding, errors='replace')
23
+
24
+ __version__ = "2.0.20261111"
25
+
26
+ from llm_engine.engine import answer
27
+
28
+ def main():
29
+ answer()
llm_engine/__main__.py ADDED
@@ -0,0 +1,5 @@
1
+ """Support running as: python -m llm_engine"""
2
+
3
+ from llm_engine import main
4
+
5
+ main()
@@ -0,0 +1,65 @@
1
+ {
2
+ "config": {
3
+ "engine_type": "ollama",
4
+ "server_addr": "default",
5
+ "model": "default",
6
+ "keep_alive": 3600
7
+ },
8
+
9
+ "config-comment": {
10
+ "comment": "这是config部分的注释",
11
+ "engine_type": "ollama|deepseek|haijing|zhipu|ali|llama|任意名称(OpenAI兼容)",
12
+ "server_addr": "服务器的主机名或地址,OpenAI兼容引擎需指定 host:port",
13
+ "model": "模型名,别名参考ollama_model_alias",
14
+ "keep_alive": "保持服务数据激活的时间(秒为单位)"
15
+ },
16
+
17
+ "ollama_addr_alias": {
18
+ "default": "localhost"
19
+ },
20
+
21
+ "ollama_model_alias": {
22
+ "qwq": "qwq",
23
+ "mistral": "mistraln:story",
24
+ "mistralsm": "mistral-small:24b",
25
+ "deepseek": "deepseek-r1:8b",
26
+ "default": "deepseek-r1:32b"
27
+ },
28
+
29
+ "roles": {
30
+ "system": "System: ",
31
+ "user": "User: ",
32
+ "assistant": "Assistant: ",
33
+ "config": "Configure: "
34
+ },
35
+
36
+ "request_template": {
37
+ "max_tokens": 1024,
38
+ "temperature": 1.2
39
+ },
40
+
41
+ "auth_keys": {
42
+ "haijing": "Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
43
+ "deepseek": "Carrier <sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx>",
44
+ "zhipu": "Bearer <your-zhipu-api-key>"
45
+ },
46
+
47
+ "default_config": {
48
+ "model": "default",
49
+ "connect_timeout": 30,
50
+ "read_timeout": 1800,
51
+ "verbose": false,
52
+ "thinking": false
53
+ },
54
+
55
+ "default-config-comment": {
56
+ "comment": "通用参数及其默认值",
57
+ "connect_timeout": "连接超时时间(秒)",
58
+ "read_timeout": "读取超时时间(秒),ollama首次加载模型可能需要较长时间",
59
+ "verbose": "是否输出详细调试信息(true/false),用于定位请求问题",
60
+ "debug": "调试级别:false关闭;true或'full'打印发送给LLM的原始请求报文,响应则收齐整个流后聚合成完整响应对象一次性输出(图片base64截断、auth脱敏);'request'仅打印请求。也可用环境变量LLM_ENGINE_DEBUG临时开启",
61
+ "thinking": "是否开启Thinking模式。开启后会请求模型返回思考内容,并以@// [Think]注释显示(不会回传到下一轮上下文)",
62
+ "tools": "启用的工具列表,可选: read, write, edit, bash, search, list_dir, python, web_fetch, view_image",
63
+ "max_tool_rounds": "工具调用最大轮数,默认10"
64
+ }
65
+ }
@@ -0,0 +1,114 @@
1
+ # LLM Chat Assistant for Micro
2
+
3
+ 这是一个 Micro 插件,将 llm_with_vim 项目的核心交互能力移植到 Micro 中,让你可以在 `.llm` 文件里进行可编辑的 LLM 对话。
4
+
5
+ ## 功能特性
6
+
7
+ - **交互式对话编辑**: 在 `.llm` 文件中直接编辑上下文,随时重提问、改历史
8
+ - **多引擎支持**: 复用 `llm_engine`,支持 Ollama / DeepSeek / 智谱 / 阿里等
9
+ - **语法高亮**: 自动识别 `User`、`Assistant`、`System`、`Configure` 角色
10
+ - **快速导航**: `F2` 生成 `User/Configure` 大纲,配合 `llmjump` 快速跳转
11
+ - **便捷操作**:
12
+ - `F1`: 提交从文件开头到光标行的上下文
13
+ - `Ctrl+K` 或 `Alt+K`: 中断正在进行的请求
14
+ - `F2`: 显示大纲
15
+ - `F3`: 预览当前行 `$$...$$` 图片引用
16
+
17
+ ## 安装方法
18
+
19
+ ### 方法 1: 安装命令(推荐)
20
+
21
+ ```bash
22
+ pip install llm-with-vim
23
+ llm-with-vim-setup --micro
24
+ ```
25
+
26
+ 或从源码仓库:
27
+
28
+ ```bash
29
+ python install.py --micro
30
+ ```
31
+
32
+ 安装后插件目录为:
33
+
34
+ - Linux/macOS: `~/.config/micro/plug/llm_micro`
35
+ - Windows: `%APPDATA%\\micro\\plug\\llm_micro`
36
+
37
+ ### 方法 2: 手动安装
38
+
39
+ ```bash
40
+ mkdir -p ~/.config/micro/plug
41
+ cp -r /path/to/llm_with_vim/micro/llm_micro ~/.config/micro/plug/llm_micro
42
+ ```
43
+
44
+ 安装后重启 Micro。
45
+
46
+ ## 使用方法
47
+
48
+ ### 快速开始示例
49
+
50
+ 1. 创建并打开测试文件:
51
+
52
+ ```bash
53
+ cat > ~/tmp/test-micro.llm <<'EOF'
54
+ Configure: {'engine_type': 'ollama', 'server_addr': 'localhost', 'model': 'qwen2.5:0.5b'}
55
+ User: 你好,请介绍一下你自己
56
+ EOF
57
+ micro ~/tmp/test-micro.llm
58
+ ```
59
+
60
+ 2. 将光标放在最后一个 `User:` 段落
61
+ 3. 按 `F1` 提交
62
+ 4. 等待响应,输出会自动追加在文件中
63
+
64
+ ### 常用命令
65
+
66
+ - `> llmsubmit`: 提交请求
67
+ - `> llmstop`: 中断请求
68
+ - `> llmoutline`: 显示大纲
69
+ - `> llmjump <编号>`: 跳转到大纲项
70
+ - `> llmimg`: 预览当前行图片
71
+ - `> llmdoctor`: 诊断引擎与环境
72
+
73
+ ## 环境与排障
74
+
75
+ ### 1. 插件是否生效
76
+
77
+ - `> plugin list` 中应看到 `llm_micro`
78
+ - 打开 `.llm` 后执行 `> set filetype` 应显示 `llm-chat`
79
+ - 运行 `> llmoutline` 应看到索引输出
80
+
81
+ ### 2. 找不到 `llm_engine`
82
+
83
+ 先执行:
84
+
85
+ - `> llmdoctor`
86
+
87
+ 如果仍找不到,可显式指定:
88
+
89
+ ```text
90
+ > set llm_micro.enginecmd '/absolute/path/to/llm_engine'
91
+ ```
92
+
93
+ Windows 推荐值(避免 PATH 差异):
94
+
95
+ ```text
96
+ > set llm_micro.enginecmd 'py -3 -m llm_engine'
97
+ ```
98
+
99
+ ### 3. 中断快捷键说明
100
+
101
+ Micro 终端环境下 `Shift+K` 通常只是输入大写 `K`,不能稳定作为独立快捷键。Micro 插件默认使用:
102
+
103
+ - `Ctrl+K`
104
+ - `Alt+K`
105
+
106
+ ## 与 Vim 版本的区别
107
+
108
+ - 快捷键不同:
109
+ - Vim 的 `jj` / `<F1>` -> Micro 的 `F1`
110
+ - Vim 的 `K` -> Micro 的 `Ctrl+K` / `Alt+K`
111
+ - Vim 的 `<F2>` -> Micro 的 `F2`
112
+ - 大纲交互为命令式导航(`llmoutline` + `llmjump`)
113
+ - 不包含 Vim 的 abbreviations 功能
114
+ - 执行时通过 `$SHELL -lc` 解析引擎命令,更贴近 shell 环境
@@ -0,0 +1,39 @@
1
+ # LLM Micro Plugin
2
+
3
+ 在 micro 编辑器中使用 `llm_engine` 处理 `.llm` 对话文件。
4
+
5
+ ## 默认快捷键
6
+
7
+ - `F1`: 提交从文件开头到当前光标行的上下文
8
+ - `Ctrl+K` 或 `Alt+K`: 中断正在进行的 LLM 请求
9
+ - `F3`: 预览当前行中的 `$$path/to/image$$` 图片
10
+
11
+ ## 命令
12
+
13
+ - `> llmsubmit`
14
+ - `> llmstop`
15
+ - `> llmimg`
16
+ - `> llmdoctor`
17
+
18
+ ## 说明
19
+
20
+ - 仅对 `.llm` 文件生效。
21
+ - Linux/macOS 下插件会通过 `sh` 查找并运行引擎(`llm_engine`、`llm-engine`、`python3 -m llm_engine`、`python -m llm_engine`)。
22
+ - Windows 下插件会通过 `cmd.exe /c` 查找并运行引擎(`llm_engine`、`llm-engine`、`py -3 -m llm_engine`、`python -m llm_engine`)。
23
+ - 请求完成后会在结果末尾自动追加 `User: `,方便继续多轮对话。
24
+ - 如 micro 环境变量不包含你的 PATH,可显式指定:
25
+ `> set llm_micro.enginecmd '/absolute/path/to/llm_engine'`
26
+ 兼容写法:`> set plugin.llm_micro.enginecmd '/absolute/path/to/llm_engine'`
27
+
28
+ 注意:如果你在其他终端里切换了 venv,但 micro 进程本身没有更新环境变量,micro 里不会自动同步那个“外部终端会话状态”;此时建议重启 micro,或使用 `llm_micro.enginecmd` 显式指定。
29
+
30
+ Windows 建议优先用以下方式显式指定引擎(可避免 PATH 不一致):
31
+ `> set llm_micro.enginecmd 'py -3 -m llm_engine'`
32
+
33
+ 另:`Shift+K` 在终端中通常只会表现为输入大写 `K`,不能稳定作为独立快捷键,因此 micro 版默认不再使用它做中断。
34
+
35
+ ## 生效检查
36
+
37
+ - `> plugin list` 中应看到 `llm_micro`
38
+ - 打开 `.llm` 文件后运行 `> set filetype` 应显示 `llm-chat`
39
+ - 运行 `> llmdoctor` 可查看当前 PATH 与引擎探测结果