kimi-bridge
English: README.en_US.md
在即时通讯对话中控制本地的 Kimi Code 智能体。
kimi-bridge 负责控制 Kimi Code 的本地服务器，在重启后保持聊天与会话的绑定关系，以可编辑消息的形式流式输出回复，并把审批、提问、引导、文件、思考过程和会话控制带进你的聊天客户端。
支持情况
| 平台/能力 | 状态 |
|---|---|
| 飞书单聊 | 已支持 |
| 微信机器人 | 暂不支持 |
| Telegram 私聊 | 实验性 |
| QQ C2C（私聊） | 已支持 |
| Linux，Python ≥3.11 | 已支持 |
| macOS 和 Windows | 实验性 |
| 语音消息 | 飞书和 QQ 已支持 |
每个 bridge 进程只运行一个平台适配器。飞书使用官方 lark-oapi WebSocket 客户端；Telegram 和 QQ 使用手写的轻量 httpx/websockets 传输层，不依赖平台 SDK。
功能特性
- 持久的 Kimi 会话管理：创建、列表、切换、重命名、查看、压缩和撤销。
- 原地编辑的答案流式输出、路由侧分块，以及可选的独立思考过程输出。
- 交互式审批与提问，带超时处理和过期操作防护。
- 繁忙回合中的提示引导、取消、权限模式、模型/推理强度/计划控制、目标、任务、技能，以及 MCP 查看。
- 接收图片、文件和飞书/QQ 语音消息，以及
/send文件外发。 - 私聊白名单、仅监听回环地址的 Kimi 服务器监管，以及 doctor 诊断命令。
快速开始
最简单的方式：打开任意 CLI 智能体，对它说：
阅读 https://github.com/Mtrya/kimi-bridge/blob/main/INSTALL_AI.md 并帮我配置 kimi-bridge。
智能体会通过问答了解你的需求，并端到端完成全部配置。
手动安装概要——需要先安装并配置 Kimi Code ，然后安装 uv：
uv tool install 'kimi-bridge' # 安装
# 为某个平台适配器创建 ~/.kimi-bridge/config.toml，并 chmod 600
kimi-bridge doctor # 不启动任何组件，直接校验配置
kimi-bridge # 运行
完整步骤见 INSTALL.md；各适配器的完整示例见配置参考。
命令
命令涵盖：
- 会话：
/new、/sessions、/switch、/status、/title、/usage、/compact、/undo； - 控制：
/mode、/model、/effort、/plan、/goal、/stop、/restart-server； - 任务与工具：
/tasks、/skills、/mcp； - 输出：
/send、/render-thinking。
在聊天中输入 /help，或阅读命令参考了解确切语法、行为以及不同平台的功能特性。发送 /<command> ? 可查看详细的聊天内用法。
架构与安全
飞书、QQ 或 Telegram (实验性)
│
▼
聊天路由器
│
▼
本地 `kimi web`
受监管的 Kimi 服务器使用随机生成的 bearer token 并仅绑定回环地址，聊天访问由适配器的白名单限制。kimi-bridge 为单一可信操作者设计：获得许可的 Kimi 智能体可以以宿主机账户的权限读写文件、执行命令，因此请妥善保护宿主机和聊天凭据。组件边界与 Kimi Code 兼容性策略（kimi-bridge compat）见架构文档。
文档
开发
uv sync --dev
uv run pytest -q
uv run ruff check .
单元测试不使用真实的 Kimi、飞书、Telegram、QQ、WebSocket、状态和进程边界；CI 检查不使用任何凭据或模型推理。
许可证
MIT © 2026 Mtrya
1 maintainer
Metadata
1 maintainer
Release files for kimi-bridge 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kimi_bridge-0.6.0.tar.gz | 288.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kimi_bridge-0.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 424.8 kB
Release files / kimi_bridge-0.6.0.tar.gz
| Download URL | kimi_bridge-0.6.0.tar.gz |
|---|---|
| Size | 288.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6f557941eb97067b0095d316cc4969a0fbe61dcecbf7d3543bb54e1143c7e67c
|
|
BLAKE2b-256 checksum How to use checksums |
cf7d1e2b90e6bd71b8ef6edddbaae85d7bc7f7e6cce1e349e4a105d25ce978eb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 7, 2026.
Transparency logRelease files / kimi_bridge-0.6.0-py3-none-any.whl
| Download URL | kimi_bridge-0.6.0-py3-none-any.whl |
|---|---|
| Size | 136.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
183fa06e57c67758bc2c73037d4ca16fb28da49e33a18c43b7902d919d0ab11b
|
|
BLAKE2b-256 checksum How to use checksums |
87bf16f26f680feb5ba0a24d9bf1e5593512734b133b7184d8ca7c50fb437728
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 7, 2026.
Transparency log
