v2.3.3

FileTerm 2.3.3

FileTerm 2.3.3 改进 MCP 远程目录访问的路径提示，帮助 Agent 区分 SFTP 用户视图与提权 Shell 视图。

下载地址

平台	类型	下载
macOS	DMG	Apple silicon · Intel
Windows	Installer	x64 · ARM64
Windows	Portable	x64 · ARM64（需要 WebView2 Runtime）
Linux	DEB	x86_64 · ARM64
Linux	RPM	x86_64 · ARM64
Linux	AppImage	x86_64 · ARM64
Linux	Arch	x86_64 · ARM64

安装指南

2.3.3 更新重点

• MCP 远程目录：明确目录路径按当前文件视图解释；SSH 用户模式使用 SFTP 路径，root 模式使用提权 Shell 路径。群晖的两种路径根目录可能不同。
• 目录错误提示：列目录失败时显示请求路径和当时的文件视图模式，帮助 Agent 判断路径是否属于当前命名空间。
• Agent 排查指引：说明 command -v 只检查命令搜索路径，避免仅凭该结果判断服务或数据目录不存在。
• 更新器安全修复：升级更新器依赖，修复下载更新包解压时使用的 ZIP 库安全问题。

本版本包含的主要 PR 和问题修复

• PR #373：说明 MCP 远程目录路径随文件视图模式变化，并在错误中提供路径上下文。

完整变更记录请查看 v2.3.2 与 v2.3.3 的比较。

反馈与支持

• 遇到问题请前往 GitHub Issues 提交反馈，并附上操作系统、FileTerm 版本、连接类型、复现步骤和脱敏日志；不要提交密码、私钥或 token。
• 也可以加入微信群交流：请打开仓库 README 的“社区交流”部分 扫描二维码进微信群，也可加入 QQ 群 534418986。

---

FileTerm 2.3.3

FileTerm 2.3.3 clarifies remote directory paths in MCP so Agents can distinguish the SFTP user view from the privileged shell view.

Downloads

Platform	Type	Downloads
macOS	DMG	Apple silicon · Intel
Windows	Installer	x64 · ARM64
Windows	Portable	x64 · ARM64 (requires WebView2 Runtime)
Linux	DEB	x86_64 · ARM64
Linux	RPM	x86_64 · ARM64
Linux	AppImage	x86_64 · ARM64
Linux	Arch	x86_64 · ARM64

Installation guides

2.3.3 Highlights

• MCP remote directories: Explain that paths follow the active file view. SSH user mode uses SFTP paths, while root mode uses privileged shell paths; these roots may differ on Synology.
• Directory error context: Include the requested path and active file view mode when listing fails, helping Agents determine whether the path belongs to the current namespace.
• Agent troubleshooting guidance: Clarify that command -v only checks the command search path, so its result alone does not establish that a service or data directory is absent.
• Updater security fix: Update the updater dependency to fix a security issue in the ZIP library used to extract downloaded updates.

Main PRs and issues

• PR #373: Clarify MCP remote directory paths by file view mode and add path context to listing errors.

See the comparison between v2.3.2 and v2.3.3 for the complete change set.

Feedback & Support

• For problems, open a GitHub Issue with the operating system, FileTerm version, connection type, reproduction steps, and redacted logs. Do not submit passwords, private keys, or tokens.
• Join the community through the README community section.

What's Changed

• fix: clarify MCP remote file path context by @St0ff3l in #373
• chore: prepare FileTerm 2.3.3 by @St0ff3l in #374

Full Changelog: v2.3.2...v2.3.3