FAQ ZH

FAQ

🌍 English · Polski · Français · Deutsch · 中文

关于 ECLI 的常见问题。

一般问题

ECLI 是什么?

ECLI(Editor CLI)是用 Python 构建的终端原生 IDE。它将基于 curses 的编辑器与 AI、Git、LSP、Tree-sitter 语法高亮和插件系统相结合。专为完全在终端中工作的开发者打造。

为什么又一个终端编辑器?

ECLI 的定位:

• Vim/Neovim — 极其强大但学习曲线陡峭。
• Emacs — 基于 Lisp,极致灵活但开销大。
• nano — 极简,缺乏 IDE 功能。
• Helix — 现代、模态,但没有 AI 面板。
• ECLI — IDE 风格的人体工程学(熟悉的 Ctrl+S/Ctrl+O 快捷键)、内置 AI、Python 插件、单一 TOML 配置。

ECLI 是免费的吗?

是的 — Apache 2.0 许可证。任何用途免费,包括商业。

通过 SSH 工作吗?

是的。在慢速链接上性能优秀。

会损坏我的文件吗?

不会。ECLI:

• 原子保存
• 未保存更改时退出会提示
• Git 集成默认只读

---

安装

应该选择哪种安装方法?

• 原生包 如果您想要独立的二进制文件。
• PyPI 如果您已有 Python 3.11+。
• 从源码 如果您想贡献。

需要安装 Python 吗?

• 原生包:不需要,通过 PyInstaller 打包了 Python。
• PyPI:需要,3.11+。

为什么二进制这么大(~50 MB)?

PyInstaller 将 Python + 依赖项打包到单个文件中。

ECLI 在 Apple Silicon 上工作吗?

是的。macOS DMG 是 Universal2(arm64 + x86_64)。

Windows ARM 上呢?

还没有。在路线图上。

32 位系统上呢?

不支持。现代 Python 需要 64 位。

---

功能

如何配置 AI 面板?

参见 AI 配置。

可以不使用 AI 吗?

可以。default_provider = "none"。

语法高亮支持哪些语言?

Tree-sitter 语法支持 70+ 种语言:Python、JavaScript、TypeScript、Go、Rust、C、C++、Java、Ruby、PHP、HTML、CSS、JSON、YAML、TOML、Markdown、SQL、Bash 等。

LSP 工作吗?

是的。按语言安装 language server:

pip install python-lsp-server         # Python
rustup component add rust-analyzer    # Rust
go install golang.org/x/tools/gopls@latest  # Go
npm install -g typescript-language-server   # TypeScript

Git 集成需要安装 git 吗?

需要。

tmux 中的 ECLI?

支持:

set -g default-terminal "tmux-256color"
set -as terminal-features ",xterm-256color:RGB"

鼠标支持?

支持:选择、滚动、面板调整大小。

多光标?

0.1.x 中没有。计划在 v0.2 中。

---

性能

ECLI 可以打开多大的文件?

测试到 ~50 MB 都很舒服。

为什么 AI 面板感觉慢?

取决于提供商 — 参见 故障排查 › AI。

---

配置

配置文件在哪里?

平台	路径
Linux / FreeBSD	~/.config/ecli/config.toml
macOS	~/Library/Application Support/ecli/config.toml
Windows	%APPDATA%\ecli\config.toml

如何重置为默认值?

删除配置文件。

每项目配置?

可以,项目根目录中的 .ecli.toml。

我可以写插件吗?

可以,用 Python。参见 主题和自定义 › 插件。

---

故障排查

最常见问题

• "ecli: command not found" → 故障排查
• macOS Gatekeeper → 安装 › macOS
• Windows SmartScreen → 安装 › Windows
• 颜色不正确 → 主题 › 调色板

如何获取帮助?

1. 搜索 GitHub Discussions
2. 搜索 GitHub Issues
3. 提交新 issue,附上 editor.log 和您的配置(隐去 API 密钥)

---

项目

如何贡献?

参见 Contributing。

有路线图吗?

有:路线图。

为什么叫 "ECLI"?

"Editor CLI" — 发音为 "echo lee"。

谁维护 ECLI?

Siergej Sobolewski。

版本号?

语义化版本:MAJOR.MINOR.PATCH。目前在 0.x。