-
在手机上安装 Termux + chat.nvim + Nova：打造移动端 AI 编程助手
- 前言
- 什么是 chat.nvim 和 Nova？
- 第一步：安装 Termux
- 第二步：安装 Neovim
- 第三步：配置 chat.nvim
- 第四步：使用 chat.nvim
- 第五步：安装 Nova Android 应用
- 进阶配置
- 常见问题
- 项目结构
- 总结
- 相关资源
前言
作为开发者，你是否希望随时随地都能使用 AI 辅助编程？今天我们来搭建一套完整的移动端 AI 编程环境：Termux + Neovim + chat.nvim + Nova。这套组合让你在手机上也能享受强大的 AI 编程助手，无缝衔接电脑端的开发体验。
本文目标：在 Android 手机上搭建完整的 AI 辅助编程环境，支持：
- 在 Termux 中使用 Neovim + chat.nvim 进行 AI 对话
- 通过 Nova Android 应用同步访问 chat.nvim 会话
- 实现电脑端和移动端的无缝切换
什么是 chat.nvim 和 Nova？
在开始之前，先了解这两个项目：
chat.nvim
chat.nvim 是一个轻量级、可扩展的 Neovim AI 聊天插件，支持：
- 多 AI 提供商：DeepSeek、GitHub AI、OpenAI、Anthropic、Gemini、Ollama 等
- 三层记忆系统：工作记忆、日常记忆、长期记忆，智能检索
- 工具集成：文件操作、Git 命令、网页搜索、自定义工具
- MCP 支持：Model Context Protocol 扩展能力
- HTTP API：内置服务器，支持外部集成
- 并行会话：同时与不同模型对话
Nova
Nova 是 chat.nvim 的 Android 移动端客户端：
- 在手机上继续你的 Neovim AI 对话
- 通过 HTTP Server 连接 chat.nvim
- Material Design 设计风格
- 支持多账号、会话管理、Markdown 渲染
第一步：安装 Termux
Termux 是 Android 平台上的终端模拟器和 Linux 环境。
下载安装
方式一：F-Droid（推荐）
F-Droid 版本是官方维护版本，功能最完整：
- 访问 F-Droid
- 下载安装 F-Droid 应用
- 在 F-Droid 中搜索 “Termux”
- 安装 Termux、Termux:API、Termux:Styling
方式二：GitHub Releases
直接下载 APK：
# 访问 GitHub Releases 页面 https://github.com/termux/termux-app/releases⚠️ 注意：不要从 Google Play 安装，Play 版本已停止更新且存在兼容性问题。
初始配置
安装完成后，打开 Termux 进行初始配置：
# 更新包管理器 pkg update && pkg upgrade # 安装基础工具 pkg install git curl wget # 获取存储权限（可选） termux-setup-storage
第二步：安装 Neovim
chat.nvim 需要较新版本的 Neovim（建议 0.9+）。
pkg install neovim验证安装：
nvim --version
第三步：配置 chat.nvim
克隆仓库
# 创建 chat 目录 mkdir -p ~/chat && cd ~/chat # 克隆 chat.nvim 及其依赖 git clone https://github.com/wsdjeg/chat.nvim git clone https://github.com/wsdjeg/logger.nvim git clone https://github.com/wsdjeg/job.nvim git clone https://github.com/wsdjeg/notify.nvim创建配置文件
# 创建 init.lua 配置文件 cat > ~/chat/init.lua << 'EOF' -- 添加插件到 runtimepath vim.opt.runtimepath:append(vim.fn.expand("~/chat/logger.nvim")) vim.opt.runtimepath:append(vim.fn.expand("~/chat/job.nvim")) vim.opt.runtimepath:append(vim.fn.expand("~/chat/notify.nvim")) vim.opt.runtimepath:append(vim.fn.expand("~/chat/chat.nvim")) -- 配置 chat.nvim require("chat").setup({ -- 基础设置 width = 0.8, height = 0.8, auto_scroll = true, border = "rounded", -- AI 提供商设置 provider = "deepseek", -- 默认提供商 model = "deepseek-chat", -- 默认模型 -- API Keys（统一配置） api_key = { deepseek = "your-deepseek-api-key-here", -- 替换为你的 DeepSeek API Key -- github = "github_pat_xxxxxxxx", -- 可选：GitHub AI -- openai = "sk-xxxxxxxxxxxx", -- 可选：OpenAI }, -- HTTP Server 配置（用于 Nova 连接） http = { host = "127.0.0.1", -- 监听地址 port = 7777, -- 端口号 api_key = "your-secret-key-here", -- 设置 API Key 启用 HTTP Server }, -- 文件访问控制 allowed_path = { "~/chat" }, -- 允许访问的目录（数组格式） }) EOF💡 提示：
-u init.lua参数指定使用当前目录的配置文件，不影响~/.config/nvim中的主配置。
第四步：使用 chat.nvim
启动 chat.nvim
每次使用时，从
~/chat目录启动 Neovim：cd ~/chat nvim -u init.lua常用命令
在 Neovim 中：
:Chat " 打开聊天窗口 :Chat new " 创建新会话 :Chat prev " 切换到上一个会话 :Chat next " 切换到下一个会话 :Chat delete " 删除当前会话 :Chat clear " 清空当前会话 :Chat cd ~/projects " 切换工作目录 :Chat save ~/chat.md " 保存会话到文件 :Chat load ~/chat.md " 加载会话 :Chat share " 分享会话 :Chat preview " 在浏览器预览 :Chat mcp start " 启动 MCP 服务器 :Chat mcp stop " 停止 MCP 服务器快捷键
在聊天窗口中：
Tab- 切换输入框和聊天窗口Enter- 发送消息Ctrl-C- 停止 AI 响应?- 查看帮助
第五步：安装 Nova Android 应用
Nova 让你在手机上通过图形界面访问 chat.nvim。
下载安装
- 访问 Nova Releases
- 下载最新的
Nova-v{version}.apk - 在 Android 设备上安装
配置 Nova
1. 确保 HTTP Server 已启动
在 Termux 中启动 chat.nvim 后，HTTP Server 会自动运行（因为配置了
http.api_key）。检查服务器是否运行：
# 在 Termux 中测试（需要另开一个会话） curl http://127.0.0.1:7777/sessions -H "X-API-Key: your-secret-key-here"如果返回会话列表（可能是空的
[]），说明服务器正常运行。2. 在 Nova 中添加账号
- 打开 Nova 应用
- 点击右上角菜单 → 「账号管理」
- 点击右下角
+添加账号 - 填写配置：
- 账号名称：自定义名称（如 “Termux Chat”）
- 域名或 IP：
127.0.0.1（本机）或局域网 IP - 端口：
7777 - API Key：与
init.lua中http.api_key相同
- 点击「测试连接」验证
- 保存账号
使用 Nova
- 查看会话：打开应用即可看到所有 chat.nvim 会话
- 新建会话：点击右下角
+按钮 - 发送消息：在聊天界面输入并发送
- 会话设置：点击右上角菜单 → 「会话设置」修改 provider/model/cwd
进阶配置
创建启动脚本
为了方便启动，创建一个脚本：
# 创建启动脚本 cat > ~/chat/start.sh << 'EOF' #!/data/data/com.termux/files/usr/bin/bash cd ~/chat nvim -u init.lua EOF # 添加执行权限 chmod +x ~/chat/start.sh以后只需运行：
~/chat/start.sh设置别名
在
~/.bashrc或~/.zshrc中添加别名：# 编辑配置文件 nano ~/.bashrc添加：
alias chat='cd ~/chat && nvim -u init.lua'然后：
source ~/.bashrc现在只需输入
chat就能快速启动！环境变量存储 API Key（推荐）
为了安全，建议使用环境变量存储 API Key：
# 编辑 Termux 启动脚本 nano ~/.termux/shell添加：
#!/data/data/com.termux/files/usr/bin/bash export DEEPSEEK_API_KEY="sk-your-deepseek-key" export OPENAI_API_KEY="sk-your-openai-key" export CHAT_HTTP_KEY="your-http-secret-key"然后修改
init.lua：require("chat").setup({ provider = "deepseek", model = "deepseek-chat", api_key = { deepseek = vim.env.DEEPSEEK_API_KEY, openai = vim.env.OPENAI_API_KEY, }, http = { host = "127.0.0.1", port = 7777, api_key = vim.env.CHAT_HTTP_KEY, }, allowed_path = { "~/chat" }, })局域网访问（从其他设备连接）
如果你想从电脑或其他设备访问 Termux 中的 chat.nvim：
修改
init.lua：http = { host = "0.0.0.0", -- 监听所有网络接口 port = 7777, api_key = "your-secret-key-here", },查看 Termux 设备 IP：
ifconfig wlan0 # 或 ip addr show wlan0然后在其他设备的 Nova 中连接：
http://192.168.1.xxx:7777⚠️ 安全警告：局域网访问时，确保你的网络环境安全，并使用强 API Key。
常见问题
1. Termux 进程被杀死
Android 可能会在后台杀死 Termux 进程。解决方案：
- 在系统设置中给 Termux 开启「无限制」后台运行权限
- 使用 Termux:Wake Lock 保持唤醒
# 获取 wake lock termux-wake-lock2. Git clone 很慢
配置 Git 代理或使用镜像：
# 使用代理 git config --global http.proxy http://127.0.0.1:7890 # 或使用镜像（如 ghproxy） git clone https://ghproxy.com/github.com/wsdjeg/chat.nvim3. Nova 连接失败
- 确认 chat.nvim 已启动（HTTP Server 需要配置
http.api_key） - 确认地址和端口正确
- 测试连接：
curl http://127.0.0.1:7777/sessions -H "X-API-Key: your-key"
4. Neovim 报错找不到模块
确保
runtimepath配置正确，路径要使用绝对路径：-- 检查路径是否正确 :lua print(vim.fn.expand("~/chat/chat.nvim"))5. 如何更新插件
定期更新仓库获取新功能：
cd ~/chat cd chat.nvim && git pull && cd .. cd logger.nvim && git pull && cd .. cd job.nvim && git pull && cd .. cd notify.nvim && git pull && cd ..
项目结构
完成后的目录结构：
~/chat/ ├── init.lua # 配置文件 ├── start.sh # 启动脚本（可选） ├── chat.nvim/ # chat.nvim 插件 │ ├── lua/ │ ├── plugin/ │ └── ... ├── logger.nvim/ # 日志依赖 ├── job.nvim/ # 任务依赖 └── notify.nvim/ # 通知依赖
总结
通过这套配置，你实现了：
✅ 移动端 AI 编程助手：在 Termux 中使用 Neovim + chat.nvim
✅ 图形化界面：通过 Nova 应用提供友好的聊天界面
✅ 无缝切换：Nova 直接连接 chat.nvim，会话数据实时同步
✅ 多提供商支持：自由选择 DeepSeek、OpenAI、Claude 等 AI 模型
✅ 轻量配置：无需插件管理器，直接使用 runtimepath
这套环境特别适合：
- 随时随地记录灵感和提问
- 在通勤路上继续编程讨论
- 作为电脑端的补充工具
相关资源
Happy Coding on Mobile! 📱✨
-
Nova v1.0.0 正式发布
经过一段时间的开发和测试，Nova 终于迎来了第一个正式版本 v1.0.0！
Nova 是 chat.nvim 的 Android 客户端，通过连接 chat.nvim 的 HTTP Server，让你可以在手机上继续 Neovim 内的 AI 对话。
📦 下载安装
下载地址: Nova v1.0.0 Release
- APK 文件:
Nova-v1.0.apk - 文件大小: 6.5 MB
- 最低系统要求: Android 7.0 (API 24)
✨ v1.0.0 核心功能
👥 多账号管理
支持添加、编辑、删除、设置默认账号：
- 每个账号可独立配置颜色标签
- 账号列表聚合显示所有账号的会话
- 快速切换默认账号
🔄 会话管理
完整的会话生命周期管理：
- 📋 会话列表 - 微信风格的 UI，按最后消息时间排序
- ➕ 新建会话 - 支持设置 cwd、provider、model
- 🔄 切换会话 - 快速切换不同会话
- 🗑️ 删除会话 - 长按删除不需要的会话
- ⚙️ 会话设置 - 实时获取服务器 provider/model 列表
💬 聊天界面
- 📝 消息渲染 - 区分用户和 AI 消息样式，角色图标显示
- 📄 Markdown 支持 - Markwon 渲染，代码高亮、表格、任务列表
- 🔄 增量刷新 - 智能增量刷新机制，自动每 5 秒更新
- ⏳ 分页加载 - 下拉加载更早消息
- ⬇️ 滚动按钮 - 快速滚动到底部
- 📋 长按复制 - 长按消息复制内容
- 🛑 停止/重试 - stop/retry generation 功能
- 💾 消息暂存 - 输入框内容暂存，切换会话不丢失
🎨 界面与主题
- 🌙 深色模式 - 支持系统自动、浅色、深色三种主题
- 🎨 Material Design - 现代化设计风格
- 🔖 颜色标签 - 账号标签颜色自定义（自动分配或手动选择）
- 📱 新图标 - 精致的科技风格 N 字母图标
🔧 其他功能
- 🔗 连接测试 - 支持测试服务器连接状态
- 📂 CWD 设置 - 会话工作目录设置
- 🔍 浏览器预览 - 预览按钮打开会话 URL
- ℹ️ 关于页面 - 应用信息和更新按钮
🛠️ 技术栈
Nova 是一个原生 Android 应用：
技术 版本/说明 语言 Java 最低 SDK Android 7.0 (API 24) 目标 SDK Android 14 (API 34) UI AppCompat + Material Design + ConstraintLayout 列表 RecyclerView 网络 OkHttp 4.12.0 Markdown Markwon 4.6.2 (含代码高亮、表格、任务列表等扩展) JSON org.json 📱 使用流程
1. 配置 HTTP Server
在 chat.nvim 中启动 HTTP Server：
-- chat.nvim 配置 http = { host = '0.0.0.0', -- 允许外部访问 port = 8000, api_key = 'your-secret-key', }2. 添加账号
打开 Nova，进入账号管理：
- 点击右上角菜单 → 「账号管理」
- 点击右下角 FAB 添加新账号
- 填写服务器地址、端口、API Key
- 选择颜色标签（可选）
- 点击「测试连接」验证配置
- 保存账号
3. 开始对话
- 查看所有账号聚合的会话列表
- 点击会话进入聊天界面
- 在聊天界面设置 provider/model
- 创建新会话并设置 cwd
🔄 与电脑端同步
Nova 的核心优势是无缝同步：
┌──────────────┐ ┌──────────────┐ │ Neovim │ ◄──── 同一会话 ────► │ Nova │ │ (电脑端) │ │ (手机端) │ └──────────────┘ └──────────────┘ │ │ │ ┌──────────────┐ │ └───────► │ chat.nvim │ ◄───────┘ │ HTTP Server │ └──────────────┘- 在电脑上创建的会话，手机上可以看到
- 在手机上发送的消息，电脑上也能查看
- 历史记录完整保留，无需重复输入
📸 应用截图
会话列表 聊天界面 设置界面 🔮 后续计划
v1.0.0 是一个里程碑，后续版本计划支持：
- 支持流式响应（SSE）
- 支持图片发送
- 支持语音输入
- 支持消息搜索
📝 相关链接
- Nova 仓库: https://github.com/wsdjeg/Nova
- chat.nvim: https://nvim.chat 或 GitHub
- 问题反馈: GitHub Issues
Nova 是 chat.nvim 生态的重要一环，让你的 AI 助手突破桌面环境的限制。无论是在通勤路上、咖啡馆里，还是任何远离电脑的地方，只要有网络连接，就能随时继续你的 AI 对话。
感谢所有测试用户的反馈！如果你在使用中遇到问题或有新功能建议，欢迎在 GitHub Issues 提交反馈。
- APK 文件:
-
Nova - chat.nvim 的 Android 客户端
如果你已经在电脑上使用了 chat.nvim 这个 Neovim AI 对话插件，那么你一定会想知道：能否在手机上继续这些对话？
答案是可以的，chat.nvim 支持链接多种 IM 工具，包括微信、飞书、Telegram、Discord 等等。
和 IM 不同的是，Nova 是通过 chat.nvim 的 REST API 来链接各个会话，是一个专门为 chat.nvim 设计的 Android 客户端。
Nova 是什么？
Nova 是一个 Android 原生应用，它通过连接 chat.nvim 的 HTTP Server，让你可以在手机上继续你的 AI 对话。
简单来说：
- chat.nvim 运行在你的电脑上（Neovim 插件）
- HTTP Server 由 chat.nvim 提供（中间层）
- Nova 运行在你的手机上（Android 客户端）
核心特性
📱 移动端访问
在手机上继续你的 Neovim AI 对话，无需重新开始，历史记录完整同步。
💬 会话管理
- 查看所有会话列表
- 切换不同会话
- 创建新会话
- 删除不需要的会话
🎨 美观的界面
- Material Design 设计风格
- 区分用户和 AI 消息
- Markdown 渲染（支持代码高亮、表格、任务列表等）
🔒 本地存储
设置信息和会话列表保存在本地，保护你的隐私。
快速开始
前置条件
在手机上使用 Nova 之前，你需要：
- 安装 chat.nvim - 在你的电脑上安装 chat.nvim Neovim 插件
- 启动 HTTP Server - 在 Neovim 中启动 HTTP Server
安装 Nova
- 访问 Nova Releases 页面
- 下载最新的
ChatApp.apk - 在 Android 设备上安装（需要允许安装未知来源应用）
配置连接
首次使用需要配置服务器信息：
- 打开 Nova 应用
- 点击右上角「Settings」图标
- 填写服务器配置：
- 服务器地址: 运行 chat.nvim HTTP Server 的电脑 IP 地址
- 端口: HTTP Server 端口（默认 8000）
- API Key: 如果 chat.nvim 配置了验证，填写你的 API Key
- 点击保存
开始使用
配置完成后：
- 查看会话列表 - 打开应用显示所有会话
- 进入对话 - 点击会话进入聊天界面
- 新建会话 - 点击右下角按钮创建新会话
- 删除会话 - 长按会话项，选择删除
技术架构
技术栈
Nova 是一个原生 Android 应用，使用以下技术：
技术 说明 语言 Java 最低 SDK Android 7.0 (API 24) 目标 SDK Android 14 (API 34) UI 框架 AppCompat + Material Design 网络请求 OkHttp 4.12.0 Markdown Markwon 4.6.2 JSON 解析 org.json 工作原理
┌────────────────────┐ │ Tools / MCP │ │ (Editor) │ └────────────────────┘ ▲ │ Async Job ▼ ┌──────────────┐ HTTP API ┌──────────────┐ AI API ┌────────────┐ │ Nova │ ◄──────────► │ chat.nvim │ ◄────────► │ AI Model │ │ (Android) │ │ HTTP Server │ │ │ └──────────────┘ └──────────────┘ └────────────┘ ▲ │ │ user input / result ▼ ┌──────────────┐ │ Neovim │ │ Floating UI │ └──────────────┘数据流：
- Neovim 启动 chat.nvim HTTP Server（本地端口 8000）
- Nova（Android）配置服务器地址，连接到 HTTP Server
- 用户在 Nova 发送消息 → HTTP Server → AI Model
- AI 响应 → HTTP Server → Nova 显示
- 同时 Neovim 也能访问相同会话
重要: Nova 不直接连接大模型 API，而是通过 chat.nvim HTTP Server 作为中间层。
在家里、办公室、咖啡馆，无论在哪，只要你的电脑开启了 chat.nvim HTTP Server，就能通过手机随时访问。
与其他方案的对比
相比 Termux + Neovim
- ✅ 更轻量: 不需要在手机上安装完整的 Neovim 环境
- ✅ 更简单: 只需一个 APK，无需复杂配置
- ✅ 性能更好: 原生 Android 应用，启动快
- ❌ 依赖电脑: 需要电脑端运行 HTTP Server
相比直接调用 AI API
- ✅ 工具支持: 继承 chat.nvim 的工具调用能力
- ✅ 历史同步: 会话历史与电脑端同步
- ✅ 配置复用: 使用相同的配置和提示词
- ❌ 网络要求: 需要能访问到电脑端 HTTP Server
应用截图
会话列表 聊天界面 设置界面 后续计划
Nova 还在不断进化中，后续计划支持：
- 支持流式响应（SSE）
- 支持图片发送
- 支持语音输入
开发者信息
如果你是开发者，想要参与贡献：
- 项目地址: https://github.com/wsdjeg/Nova
- 技术栈: Java + Android SDK
- 开发环境: Android Studio Hedgehog 或更高版本
总结
Nova 是 chat.nvim 生态的重要补充，它打破了桌面环境的限制，让你可以在移动设备上继续使用 AI 辅助开发。无论你是在通勤路上、咖啡馆里，还是任何远离电脑的地方，只要有网络连接，就能随时访问你的 AI 助手。
相关项目：picker.nvim - Neovim fuzzy finder
如果你在使用过程中遇到问题，欢迎在 GitHub Issues 提交反馈！
-
curl 请求体长度限制问题及解决方案
起因
在开发 chat.nvim 插件时， 遇到了一个奇怪的错误：当使用 curl 发送较大的 JSON 请求体时， 会报错
ENAMETOOLONG: name too long。这个错误提示虽然明确，但背后的原因和解决方案却值得记录一下。问题背景
chat.nvim 是一个 Neovim 插件，用于在 Neovim 内集成 AI 助手功能。 在调用 AI API 时，需要使用 job.nvim 异步调用 curl 发送 POST 请求， 请求体是一个 JSON 对象，包含了模型名称、对话历史、工具定义等信息。
原始的实现方式是这样的：
local cmd = { 'curl', '-s', url, '-H', 'Content-Type: application/json', '-H', 'Authorization: Bearer ' .. api_key, '-X', 'POST', '-d', vim.json.encode({ model = requestObj.model, messages = requestObj.messages, stream = true, stream_options = { include_usage = true }, tools = require('chat.tools').available_tools(), }), } local jobid = job.start(cmd, { on_stdout = requestObj.on_stdout, on_stderr = requestObj.on_stderr, on_exit = requestObj.on_exit, })这种方式将 JSON 数据直接作为 curl 的
-d参数传递，看似没问题，但当对话历史较长或者工具定义较多时，JSON 数据会变得很大，导致命令行参数过长。问题分析
ENAMETOOLONG错误表明命令行参数超过了系统限制。不同操作系统对命令行参数长度有不同的限制：- Linux: 通常为 128KB 到 2MB（取决于
MAX_ARG_STRLEN） - macOS: 约 256KB
- Windows: 约 8KB 到 32KB（更严格的限制）
当 JSON 数据包含大量对话历史或工具定义时，很容易超过这些限制。比如，一个包含 50 条对话记录的请求，JSON 可能就有几十 KB，再加上 URL、Header 等参数，总长度很容易超标。
解决方案
curl 提供了一个非常实用的特性：使用
-d @-从 stdin 读取数据。这样就可以避免命令行参数长度限制，将请求体通过 stdin 传递给 curl。修改后的代码：
local cmd = { 'curl', '-s', url, '-H', 'Content-Type: application/json', '-H', 'Authorization: Bearer ' .. api_key, '-X', 'POST', '-d', '@-', -- 从 stdin 读取数据 } local body = vim.json.encode({ model = requestObj.model, messages = requestObj.messages, thinking = { type = 'enabled', }, stream = true, stream_options = { include_usage = true }, tools = require('chat.tools').available_tools(), }) local jobid = job.start(cmd, { on_stdout = requestObj.on_stdout, on_stderr = requestObj.on_stderr, on_exit = requestObj.on_exit, }) -- 通过 stdin 发送请求体 job.send(jobid, body) job.send(jobid, nil) -- 关闭 stdin，表示数据发送完毕关键变化：
-d参数从 JSON 字符串改为@-，表示从 stdin 读取- 将 JSON 数据单独编码为
body变量 - 启动 job 后，使用
job.send()通过 stdin 发送数据 - 最后发送
nil关闭 stdin，告诉 curl 数据已发送完毕
相关 commit
这个问题的修复记录在 commit
@3f4277：commit 3f427762779ff9ffe645fd6683195da0b234731d Author: Eric Wong <[email protected]> Date: Sun Feb 8 21:41:47 2026 +0800 fix: use stdin to send body use body as curl command argument cause error: `ENAMETOOLONG: name too long`修复涉及了三个 provider 文件：
deepseek.lua、github.lua、moonshot.lua，统一采用了 stdin 方式发送请求体。其他注意事项
在使用 stdin 发送数据时，有几个细节需要注意：
-
及时关闭 stdin：发送完数据后必须关闭 stdin，否则 curl 会一直等待更多数据，导致请求无法完成。使用
job.send(jobid, nil)或job.chanclose(jobid, 'stdin')都可以实现。 -
数据完整性：确保发送的 JSON 数据是完整的，不要分多次发送部分数据，除非你知道如何处理分块传输。
-
编码问题：确保发送的数据是正确的 UTF-8 编码，curl 默认期望 UTF-8。
总结
当使用 curl 发送大量数据时，不要将数据直接作为命令行参数传递，而应该使用 stdin（
-d @-）方式。这样可以：- 避免命令行参数长度限制
- 支持更大数据量的传输
- 更加稳定可靠
这个坑虽然看似简单，但在实际开发中却容易被忽视。记录下来，希望能帮助到遇到类似问题的开发者。
如果你也在开发类似的 HTTP 客户端功能，建议一开始就采用 stdin 方式，避免后续遇到这个问题。
- Linux: 通常为 128KB 到 2MB（取决于
-
阿里云 Coding Plan Bug：流式输出内容截断
问题背景
本文记录在使用 阿里云百炼平台 Coding Plan（GLM-5 模型） 时遇到的另一个严重 bug：流式输出内容截断。
上一篇博文记录了 Tool Call arguments 输出协议异常的问题，这一次遇到了更基础的问题：普通文本回复的内容被截断，直接丢失了最后的几个字符。
阿里云售后人员的回复是：”这是工具问题”。好吧，那就用这篇博文来证明，这根本不是工具问题。
问题现象
请求场景
在 chat.nvim 中使用 GLM-5 模型，发送最简单的问候消息 “你好”。这次请求完全没有触发 Tool Call，就是一次最普通的聊天对话。
完整原始日志（铁证）
以下是 curl stdout 的完整原始日志，逐行打印，未做任何删减：
data: {"choices":[{"delta":{"content":null,"reasoning_content":"用户","role":"assistant"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"说"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"\"你好"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"\"，"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"这是一个简单的"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"问候。"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"根据我的"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"性格设定"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"，我应该"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"：\n1"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"."},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":" 热"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"情"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"友好\n"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"2."},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":" 简"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"洁直接"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"\n3"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"."},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":" 可能使用"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"一些表情"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"符号\n\n"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"我应该回忆"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"一下是否"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"有什么相关的"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"记忆，"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"比如用户的"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"偏好等"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"。不过"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"这是一个新的"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"对话开始"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"，我先"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"友好地"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"回应，"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"看看用户"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"需要什么"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"帮助。\n\n"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"我应该：\n"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"-"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":" 友好"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"地问候"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"\n-"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":" 简单"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"介绍自己"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"可以"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"做什么\n"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"- "},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"询问需要"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"什么帮助"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"\n\n"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"不需要调用"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"任何工具"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"，只是"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"简单的对话"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":null,"reasoning_content":"问候。"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"你好！","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"我是 No","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"va，","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"来自 N","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"eovim 的小","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"星星 :","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":")","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"\n\n","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"我可以","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"帮","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"你：\n- 📝","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":" 编","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"写和修","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"改 ","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"Lu","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"a 插","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"件代码","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"\n- 🔍","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":" 搜","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"索、","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"阅读项目文件\n","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"- 📦","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":" Gi","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"t 操","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"作（提","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"交、","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"分支","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"管","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"理等）\n","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"- 💾","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":" 记","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"住你","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"的偏好和习","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"惯","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"\n- 🌐","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":" 搜索网","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"络、获","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"取网页内","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"容\n\n","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"有什么","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"delta":{"content":"我","reasoning_content":null},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[{"finish_reason":"stop","delta":{"content":"","reasoning_content":null},"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: {"choices":[],"object":"chat.completion.chunk","usage":{"prompt_tokens":16418,"completion_tokens":191,"total_tokens":16609,"completion_tokens_details":{"reasoning_tokens":106},"prompt_tokens_details":{"cached_tokens":16414}},"created":1776597535,"system_fingerprint":null,"model":"glm-5","id":"chatcmpl-f87aa751-9260-9884-8cb6-f33c540cab94"} data: [DONE]问题定位
从完整日志中可以清楚看到：
- 前面的
reasoning_content（思考过程）输出正常，从 “用户” 到 “问候。” 共 55 行 - 后面的
content（正式回复）开始输出，从 “你好！” 到功能介绍 - 关键截断点：最后一个有 content 的 chunk 是
{"content":"我"} - 紧接着就是一个
finish_reason: "stop"的 chunk，content 是空字符串 - 然后是 usage 统计和
[DONE]
按照正常的回复逻辑，AI 应该说 “有什么我可以帮你的吗？”，但实际只输出了 “有什么我”，后面的 7 个字符”可以帮你的吗？”直接丢失了。
这不是工具问题
请求原理
chat.nvim 的请求逻辑非常简单：
function M.request(opt) local cmd = { 'curl', '-s', 'https://coding.dashscope.aliyuncs.com/v1/chat/completions', '-H', 'Content-Type: application/json', '-H', 'Authorization: Bearer ' .. api_key, '-X', 'POST', '-d', '@-', -- 从 stdin 读取请求体 } -- 启动 job，通过 stdin 发送请求体 local jobid = job.start(cmd, { on_stdout = opt.on_stdout, -- 处理 stdout 输出 on_stderr = opt.on_stderr, on_exit = opt.on_exit, }) job.send(jobid, body) end解析逻辑
SSE 解析逻辑也只是简单地：
- 检测
data:前缀 - 解析 JSON
- 提取
content字段
if choice.delta.content and #choice.delta.content > 0 then sessions.on_progress(id, choice.delta.content) end为什么这不是工具问题
论点 证据 curl 只是传输层 curl 不做任何内容处理，只是把 stdout 原样输出 日志是完整原始输出 日志是逐行打印的，不存在截断或遗漏 SSE 格式正常 每个 chunk 都是合法的 data: {...}格式finish_reason 正确返回 服务端明确返回了 finish_reason: "stop"usage 统计显示完成 completion_tokens: 191表明模型认为已完成结论：服务端已经认为回复完成了（
finish_reason: "stop"），但实际输出不完整。这是服务端生成逻辑的 bug，客户端无法检测或修复。
可能的根因分析
推测的原因
根据输出特征，推测可能的原因：
- 提前终止生成：模型在生成过程中被服务端提前终止，但没有返回错误信息
- 缓冲区问题：最后几个 token 在缓冲区中被丢弃，未发送到客户端
- token 计数错误：服务端在某个阈值（如 completion_tokens 达到某个值）时错误地终止生成
- 流式输出同步问题：模型生成结束和服务端发送
finish_reason: stop的时机不同步
为什么 usage 显示 191 tokens
有趣的是，usage 显示
completion_tokens: 191，其中reasoning_tokens: 106。这意味着：- reasoning_content（思考）：约 106 tokens
- content（回复）：约 85 tokens（191 - 106）
但实际输出的 content 远少于 85 tokens（只有几个短句），说明：
- 要么：token 计数有误
- 要么：有大量 content 在服务端被丢弃
与 Tool Call Bug 的关联
上一篇博文记录的 Tool Call bug 是 arguments 输出协议异常。这次遇到的是更基础的 content 截断问题。
两个问题的共同特征：
特征 Tool Call Bug Content 截断 Bug 问题层级 协议层 内容生成层 表现形式 数据格式异常 数据丢失 影响范围 Tool Call 功能 所有回复 客户端可检测 ✅ 可以检测并容错 ❌ 无法检测 Content 截断 bug 更加隐蔽，因为：
- 格式合法：每个 SSE chunk 都是合法的 JSON，不会触发解析错误
- finish_reason 正常：服务端明确返回了
stop，客户端会认为正常完成 - 无错误信息：没有任何错误提示，客户端无法知道内容不完整
对用户的影响
实际影响
影响项 严重程度 回复不完整 高 功能介绍缺失 中 用户体验下降 高 无法自动检测 高 用户感知
用户发送消息后，收到的是不完整的回复。例如：
- 期望：”有什么我可以帮你的吗？”
- 实际：”有什么我”
用户可能会：
- 认为模型回答奇怪
- 再次发送消息询问
- 怀疑客户端有问题
无法修复
客户端无法修复这个问题，因为：
- 没有任何错误信息
finish_reason: "stop"表示正常结束- 客户端无法知道应该还有后续内容
唯一的”修复”方式是：用户自己发现回复不完整，手动再次询问。
给阿里云的建议
问题定性
这是一个 服务端内容生成层 bug，具体表现为：
- 流式输出在模型生成过程中提前终止
- 最后的 token 被丢弃，未发送到客户端
- 服务端错误地认为生成已完成，返回
finish_reason: "stop"
希望的修复
- 确保模型生成的所有 token 都正确发送到客户端
- 在
finish_reason: "stop"之前，确保所有 content 已完整输出 - 检查 token 计数逻辑，确保与实际输出一致
测试建议
建议阿里云增加以下测试：
# 简单测试：检查输出是否完整 curl -N https://coding.dashscope.aliyuncs.com/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_KEY" \ -d '{"model":"glm-5","messages":[{"role":"user","content":"你好"}],"stream":true}' \ > output.txt # 分析：最后一个 content chunk 后是否直接出现 finish_reason: stop grep "content" output.txt | tail -5 grep "finish_reason" output.txt
结论
又一次踩坑阿里云 Coding Plan。上一篇是 Tool Call 协议异常，这次是 Content 截断。
阿里云售后说”这是工具问题”，但本文已经清楚证明：
- curl 只是传输层，不做内容处理
- 日志是完整原始输出
- 服务端明确返回了
finish_reason: "stop" - 客户端无法检测或修复
这是服务端 bug，不是工具问题。
建议使用阿里云 Coding Plan 的开发者：
- 注意检查回复内容是否完整
- 发现截断时手动再次询问
- 向阿里云提交工单，附上原始日志
参考资料
- 前面的
-
Neovim 配置管理最佳实践
在使用 Neovim 的过程中，配置管理是一个非常重要的话题。一个好的配置结构不仅能让你的配置更易于维护，还能让你在不同机器之间轻松同步配置。
为什么需要配置管理？
Neovim 的配置文件通常包含：
- 插件管理
- 快捷键映射
- 主题设置
- LSP 配置
- 代码片段
随着配置的增长，如果没有良好的组织结构，维护会变得非常困难。
推荐的目录结构
~/.config/nvim/ ├── init.lua # 入口文件 ├── lua/ │ ├── config/ │ │ ├── options.lua # 选项设置 │ │ ├── keymaps.lua # 快捷键映射 │ │ └── lazy.lua # 插件管理器配置 │ ├── plugins/ │ │ ├── editor.lua # 编辑器插件 │ │ ├── ui.lua # UI 插件 │ │ └── lsp.lua # LSP 插件 │ └── utils/ │ └── functions.lua # 工具函数 └── README.md核心配置文件
init.lua
-- 加载配置模块 require("config.options") require("config.keymaps") require("config.lazy")options.lua
local opt = vim.opt -- 基本设置 opt.number = true opt.relativenumber = true opt.tabstop = 4 opt.shiftwidth = 4 opt.expandtab = true opt.autoindent = true opt.smartindent = true -- 搜索设置 opt.ignorecase = true opt.smartcase = true opt.hlsearch = true opt.incsearch = true -- 界面设置 opt.termguicolors = true opt.signcolumn = "yes" opt.cursorline = true opt.scrolloff = 8 opt.sidescrolloff = 8使用 lazy.nvim 管理插件
lazy.nvim 是目前最流行的 Neovim 插件管理器。
-- lua/config/lazy.lua local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim" if not vim.loop.fs_stat(lazypath) then vim.fn.system({ "git", "clone", "--filter=blob:none", "https://github.com/folke/lazy.nvim.git", "--branch=stable", lazypath, }) end vim.opt.rtp:prepend(lazypath) require("lazy").setup({ spec = { { import = "plugins" }, }, defaults = { lazy = false, version = false, }, checker = { enabled = true }, performance = { rtp = { disabled_plugins = { "gzip", "tarPlugin", "tohtml", "tutor", "zipPlugin", }, }, }, })快捷键管理
-- lua/config/keymaps.lua local map = vim.keymap.set -- 基础快捷键 map("n", "<leader>w", "<cmd>w<cr>", { desc = "保存文件" }) map("n", "<leader>q", "<cmd>q<cr>", { desc = "退出" }) map("n", "<Esc>", "<cmd>noh<cr>", { desc = "清除搜索高亮" }) -- 窗口导航 map("n", "<C-h>", "<C-w>h", { desc = "左窗口" }) map("n", "<C-j>", "<C-w>j", { desc = "下窗口" }) map("n", "<C-k>", "<C-w>k", { desc = "上窗口" }) map("n", "<C-l>", "<C-w>l", { desc = "右窗口" }) -- 缓冲区操作 map("n", "<S-h>", "<cmd>bprevious<cr>", { desc = "上一个缓冲区" }) map("n", "<S-l>", "<cmd>bnext<cr>", { desc = "下一个缓冲区" })总结
良好的配置管理是 Neovim 使用体验的关键。通过：
- 模块化组织配置文件
- 使用 modern 插件管理器
- 合理的快捷键映射
- 清晰的目录结构
可以让你的配置更容易维护和扩展。
希望这篇文章对你有帮助！如果有任何问题，欢迎在评论区讨论。
最新发布
标签云