1Shell v4.0.0

1Shell v4.0.0

这是一次大版本更新：1Shell 从原来的后端 + 传统静态页面，升级为 Vue 3 SPA 主控台，并围绕 1Shell AI、探针 Agent、Skill / Program、MCP 仓库与多页面工作流重构了核心链路。

主要更新

全新 Vue 3 前端

• 新增 Vue 3 + Vite + TypeScript + Tailwind 前端工程。
• 主入口迁移到 /app/，页面路由、状态管理、Socket 通信和组件结构全面重做。
• 重构主控台、首页、探针、脚本库、Skill Studio、MCP 仓库、审计、CLI 设置等核心页面。
• 旧版 public/*.html/js/css 静态页面体系下线，前端能力统一收敛到 frontend/。
• 新增跨页面 1Shell AI FAB、统一侧栏、主题背景、Toast、确认弹窗和移动端适配。

主页与主机视图升级

• 新增世界地图 / 地球首页，用于展示主机地理位置和整体状态。
• 新增主机 HUD、侧边信息面板、Tooltip、未解析位置弹窗、手动位置配置弹窗。
• 支持 GeoIP 数据提示、缺失位置提示和主机状态预取。
• 首页视觉与主控台入口统一，登录后可直接从全局视图进入主机管理。

主控台重构

• 主控台布局重构为主机列表、终端区、右侧 AI / IDE / Agent 面板的组合工作区。
• 右侧面板支持 AI Chat、IDE、Agent Panel Tab 切换。
• 文件浏览器、主机列表、终端区域、命令建议、脚本注入、Playbook 注入等能力组件化。
• 增强终端选区分析、命令建议、Ghost Text、上下文菜单和审批条。
• SSH Shell 池、终端 Socket、文件服务和主机服务链路增强。

1Shell AI 链路升级

• 全局 1Shell AI、主控台 AI、Agent Panel、IDE 面板共用更完整的底层 AI / Tool 链路。
• 增强内置工具调用能力，覆盖主机、文件、脚本、程序、MCP、探针等更多 1Shell 能力。
• 优化流式输出、工具执行状态、审批交互和上下文注入。
• Agent Panel 支持 Claude Code / OpenCode / Codex 接入，并通过 1Shell 内部代理与 MCP 能力协作。
• 新增 CLI sandbox、Claude 配置同步和 Agent 面板独立会话相关能力。

探针系统 4.0

• 新增 Go 版 probe-agent，支持安装到远程 Linux 主机进行常驻采集。
• 新增 probe-relay-agent，支持中继场景下的探针上报与主控拉取。
• 新增 Agent 安装、卸载、重启、升级和状态管理接口。
• 新增探针趋势、样本、流量、告警、诊断接口。
• 新增 Ping / DNS / HTTP 诊断能力。
• 新增探针趋势图、告警视图、诊断弹窗和流量统计 UI。
• 保留 Agentless 探针，同时新增 Agent 模式，适配不同部署场景。

Skill / Program 架构升级

• Skill 从单文件说明升级为目录化、分层化体系：SKILL.md 路由，rules / workflows / references 分离。
• Program 三层架构强化：L1 确定性执行、L2 受约束修复、L3 Guardian 介入边界更清晰。
• 新增 Program 维护 Skill，用于升级、修复和维护已生成的 Program。
• Program schema、结果导向、失败解释、Guardian 升级策略和运行事件链路重构。
• Skill Studio 支持更完整的生成、编辑、漂移检查、bundle、playbook、program 工作流。
• Playbook / Script 执行输出和前端展示增强。

MCP 仓库与本地 MCP

• 增强 1Shell MCP Server 能力，扩展远程文件、结构化结果、主机执行和探针相关工具。
• 新增本地 MCP 部署链路，支持从仓库安装、配置和管理本地 MCP Server。
• MCP Server 注册、编辑、删除、密钥字段、健康状态和预加载逻辑增强。
• MCP 仓库页面、部署弹窗、本地 MCP 卡片和详情弹窗重构。

脚本库与自动化

• 脚本列表、详情、运行弹窗和历史面板重构。
• 脚本运行状态、参数、输出和历史记录展示增强。
• Program、Skill、Playbook、Script 的前端 API 工具统一整理。
• 自动化运行中的事件流、L2 修复、Guardian 介入和结果界面更清晰。

安全与运维

• 发布包清理运行时数据库、主机配置、Bridge Token、MCP 私有配置、日志、缓存和本地调试文件。
• .env.example 中的示例密钥改为安全占位，避免被误判为真实密钥。
• GitHub Release 包不包含 .git、.env、运行时数据库、主机凭据、日志和本地缓存。
• 登录、会话、CSRF、IP 过滤、审计、Bridge Token 和凭据加密相关提示继续保留。

文档与版本

• README 更新到 v4.0.0，突出 1Shell AI、三层 AI 运维、探针 Agent、MCP 与 Vue 主控台。
• 使用指南、AI 功能、Skill / Playbook / Script、MCP 仓库等章节同步更新。
• 移除旧版内部设计稿、运行期截图和不适合公开发布的调试文档。

下载

• Windows x64：1Shell-v4.0.0-windows-x64.zip
  • SHA256：1d430ad45a66b5e5543f0d09e42c4d7f7fba877d0fa7728d89ed32abdb2b8203
• Linux x64：1Shell-v4.0.0-linux-x64.tar.gz
  • SHA256：47bc7d475573e348ecb276c77c2f61c04879a195e308f78494a6259b0670f4b7

升级提示

• v4.0.0 是大版本更新，建议新目录解压部署，再迁移必要的 .env 和运行时数据。
• 旧版静态页面体系已下线，新前端入口为 /app/。
• 如果使用探针 Agent / Relay Agent，请优先使用本版本 Release 中附带的二进制。

v3.5.0 — Claude Code 协作 + Agent Panel 独立会话

v3.5.0 更新日志

新功能：Claude Code 协作模式

1Shell AI 新增 ✦ CC 协作 开关（主控界面 + 创作界面均支持）。开启后，1Shell AI 可在遇到复杂创作任务时自动委托给 Claude Code 执行。

• 1Shell AI 是大脑，Claude Code 是外脑
• 用户始终和 1Shell AI 对话，不需要手动切换
• Claude Code 通过 MCP 访问所有主机，完成任务后返回结果
• 子进程可中断（停止按钮生效）

Agent Panel 重构：独立会话模式

• 会话不再绑定主机，每个会话是独立的对话窗口
• Tab 显示 Claude Code #1, #2... 而非主机名
• "新会话" 按钮始终可用
• 移除"当前目标"显示和主机隔离限制

修复

• 主控界面新增 ∞ 不限轮次 开关（历史遗留）
• 终端 × 关闭按钮始终可见，关闭后正确清理状态
• 停止按钮现在可以终止正在运行的 Claude Code 子进程
• CC / 不限轮次开关状态随 message 同步，修复首次对话前开启无效的时序问题

v3.4.0 — Agent Panel 直连 MCP

v3.4.0 更新日志

核心改动：Agent Panel 直连 1Shell MCP

内嵌的 Claude Code 现在直接通过 1Shell MCP Server 操控 VPS，与外部 Claude Code 体验完全一致。

改进：

• 内嵌 Claude Code 直连 1Shell MCP（4 个工具：execute_ssh_command / list_hosts / list_mcp_tools / call_mcp_tool）
• 新增 stdio 桥接脚本 bin/1shell-mcp-stdio.js，Codex / OpenCode 可通过 stdio 传输连接 1Shell MCP
• agent-pty.service.js 精简 362 行（645→283），移除全部 V2 遗留代码

移除：

• V2 时期的 prompt 注入（检测 ❯ 提示符 → 注入主机信息）
• Skill 工作空间构建（CLAUDE.md + 目录复制）
• ANSI 解析 / 交互菜单检测
• idle 超时完成检测
• ensureClaudeProjectTrusted 预信任机制

修复：

• Windows start.bat 编码兼容性问题（Unicode 方框字符 → ASCII）

架构理念

Claude Code（内嵌 / 外部均可）→ 1Shell MCP → SSH → VPS（零侵入）
1Shell AI → 23 个内置工具 → 平台级全功能操控

两条路径，各司其职：Claude Code 发挥 CLI 的强大推理能力，1Shell AI 掌控平台全局。

1Shell v3.3.0

1Shell v3.3.0 - 基于 Web 的零侵入多服务器管理平台，内置三层渐进式 AI 运维引擎。详见 README 与 docs/usage-guide.md。