echotools
通用基础设施 SDK：配置、日志、事件、调度、插件、调用链，以及 entml LLM 工具调用协议与终端 Console UI。
完全项目无关，兼容 Python 3.8–3.14。当前版本：2.5.0（详见 CHANGELOG）。
安装
# 核心（含 BLAKE3 与 typing-extensions）
pip install echotools
# 完整功能（含 TOML、Web、终端、Console UI 等）
pip install echotools[all]
可选依赖
| Extra | 用途 |
|---|---|
toml |
TOML 配置读写 |
watch |
watchdog 文件监视 |
http |
aiohttp Web 层 |
socks |
SOCKS 代理 |
ssh |
SSH 终端 |
terminal |
Windows ConPTY |
console |
Rich 终端 UI（渐变、表格、交互选择） |
all |
全部可选依赖 |
dev |
pytest、ruff、mypy |
快速开始
基础设施
from echotools import EchoTools
et = EchoTools(service_name="myapp")
et.logger.configure(level="INFO", color=True)
cfg = et.config
cfg.load("config.toml")
with et.tracer.trace("request") as trace:
with et.tracer.span(trace, "db") as span:
span.set_tag("query", "select 1")
await et.shutdown()
entml 工具调用
内置 entml（<entml:*> 熵标记语言）协议，负责 prompt 注入与模型输出解析。
from echotools import FncallStreamParser, get_protocol, inject_fncall
tools = [
{
"name": "Bash",
"description": "Run a shell command",
"input_schema": {
"type": "object",
"properties": {"command": {"type": "string"}},
"required": ["command"],
},
}
]
messages = [{"role": "user", "content": "列出当前目录"}]
proto = get_protocol()
out_messages = inject_fncall(messages, tools, proto, lang="zh")
parser = FncallStreamParser(proto, tools=tools)
for chunk in model_stream:
parser.feed(chunk)
if parser.get_ready_tool_calls():
...
result = parser.finalize()
能力包括：prompt 注入（history / 工具结果 / thinking 模式）、batch parse()、流式
partial_text / input_json_delta、伪 history 剥离、工具循环检测。
终端 Console UI
需要 pip install echotools[console]（或 [all]）：
from echotools.media.console import (
create_themed_ui,
render_gradient_banner,
render_text_lines,
run_select,
)
ui = create_themed_ui(theme_name="ocean") # ocean / forest / sunset / violet / rose / slate / cyan
print(render_gradient_banner(render_text_lines("echotools"), theme_name="ocean"))
choice = run_select(ui, "选择主题", ["ocean", "forest", "sunset"])
能力总览
| 模块 | 说明 |
|---|---|
EchoTools |
门面：配置、日志、事件、调度、插件等统一入口 |
ConfigCenter |
点路径配置 + 热重载 + 类型绑定 |
LoggerManager |
调用链注入 + 颜色 + 轮转 |
EventBus |
同步/异步事件 |
Tracer |
轻量调用链 |
TaskDispatcher |
单发/竞速 + 贝叶斯自适应选择 |
PluginRegistry |
自动发现 + 热重载 |
get_protocol / inject_fncall |
entml 工具协议与 prompt 注入 |
FncallStreamParser |
流式工具调用解析 |
media.console |
Rich 终端 UI、多主题、交互选择与 ANSI 渐变 |
PrintStream |
动态速度打印流 |
ProxyManager |
HTTP/HTTPS/SOCKS |
WebApplication |
aiohttp Web（需 [http]） |
LocalTerminal / SSHTerminal |
终端会话（需 [terminal] / [ssh]） |
AutoUpdater |
git 自动更新 |
FileWatcher |
轮询文件监视 |
plat.capture |
跨平台音频监控/录音/截图（纯 ctypes，零第三方依赖） |
开发
pip install -e ".[dev,all]"
make -C docs lint
make -C docs test
make -C docs cov
模块指南见 docs/modules.md，API 参考见 docs/api.md。
变更记录
许可证
MIT
1 maintainer
Metadata
1 maintainer
Release files for echotools 2.5.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 | |
|---|---|---|---|
| echotools-2.5.0.tar.gz | 402.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| echotools-2.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 925.6 kB
Release files / echotools-2.5.0.tar.gz
| Download URL | echotools-2.5.0.tar.gz |
|---|---|
| Size | 402.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b6987437cb97aef140b975022b2746b6a50ab84654e5c5e524d240ff5004a180
|
|
BLAKE2b-256 checksum How to use checksums |
4520ca13ee074de4f71d8f8aa94a2054d8eeec276b7f65b581ec0fdd1fd15073
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / echotools-2.5.0-py3-none-any.whl
| Download URL | echotools-2.5.0-py3-none-any.whl |
|---|---|
| Size | 523.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3196faeefa9d1e4b4262ce9814b9c4600ef50feac1c6e96b7a7b7351b553f5b9
|
|
BLAKE2b-256 checksum How to use checksums |
8ca1bc795d79fe84955e31320fd1f03d5bfa3a0585942583613dd79d38af3331
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
