AgentsDock
首页 文档 常见问题 Discord
  • English
  • 简体中文

入门

搭建指南 客户端安装 连接 agents 开始第一个会话

指南

功能指南 会话 Agent 之间通话 Share Chat Side chat Fork 会话 恢复会话 工作区 终端访问 查看与编辑代码 自动化 斜杠命令 定时任务 键盘快捷键 更新 语言 管理服务器

帮助

反馈问题

服务器参考

高级安装 多服务器 可用性 实例如何工作 创建实例 列出并连接 更新实例 每个实例的位置 每个实例的终端 移除实例 规则与限制 备份与卸载

服务器参考

一台机器上的多个服务器

一台机器、一个用户账号、多个完全独立的 AgentsServer——各自拥有自己的端口、服务、token、会话历史和终端。适合分开工作与个人用途、在稳定版旁边跑一个测试版,或给每个项目一个专属服务器。

可用性

AgentsServer 1.0.9 及之后版本已支持。先安装默认服务器,再使用 agentsdock new 创建额外的命名服务。初始 npm 安装只创建默认服务。

实例如何工作

你的第一个服务器是默认实例——它保留你现有的路径、服务名和端口。每个额外的服务器都是一个命名实例(work、beta……),拥有自己的服务、端口、配置、状态目录、日志和 tmux 服务,以默认实例的同级身份安装。它们之间不共享任何东西,移除默认实例也绝不会移除命名实例。

实例是为方便而设的独立服务——它们之间不是安全边界,因为都以你的用户账号运行。

创建实例

在服务器机器上运行:

# automatic name and the next free port (7851 upwards)
agentsdock new

# or choose the name and port
agentsdock new work --port 7851

# optional bind address (default 0.0.0.0)
agentsdock new lab --port 7852 --bind 0.0.0.0

新实例从空的会话列表开始,并拥有自己新生成的 token。名称须为小写:一个字母开头,后接最多 31 个字母、数字或连字符。

创建命名实例时,输出大概会像这样:

$ agentsdock new work --port 7851
Create: work:7851
[7/7] AgentsServer 1.0.10 is ready

  Server URL    http://100.100.100.12:7851

AGENTSDOCK_SETUP_RESULT={"server_url":"http://100.100.100.12:7851","access_token":"ad_tok_...","service":"launchd","tailscale_ip":"100.100.100.12","server_version":"1.0.10"}

列出并连接

agentsdock list        # name, status, port
agentsdock info work   # details for one instance

列表输出示例:

NAME                 STATUS     PORT
default              running    7850
  Tailscale / other networks: http://100.100.100.12:7850 (recommended)
  Same Wi-Fi / LAN:          http://192.168.1.23:7850
  This machine only:         http://127.0.0.1:7850

work                 running    7851
  Tailscale / other networks: http://100.100.100.12:7851 (recommended)
  Same Wi-Fi / LAN:          http://192.168.1.23:7851
  This machine only:         http://127.0.0.1:7851

把应用连接到实例的方式和连接任何服务器完全一样——URL 是主机地址加该实例的端口,token 用这条命令获取:

agentsdock token work

在应用里添加多个实例,在服务器切换器中随时切换。

更新实例

每个实例独立更新。请在应用里对要更新的服务器连接使用托管更新。初始 npm 安装不创建也不更新命名实例。

每个实例的位置

把 NAME 替换为实例名。

  • 服务:agents-server-NAME(Linux,systemctl --user)· com.agentsdock.server.NAME(macOS LaunchAgent)
  • 状态(会话、任务、文件、token):~/.agentsdock-instances/NAME
  • 配置:~/.config/agents-server-instances/NAME
  • 运行时发布:~/.local/share/agents-server-instances/NAME
  • 日志:~/Library/Logs/AgentsServer-instances/NAME/(macOS)· journalctl --user -u agents-server-NAME(Linux)
  • 所有实例的注册表:~/.config/agents-server-manager/instances.json(只含名称、状态、端口——不含任何机密)

默认实例保留文件位置中列出的标准路径。

每个实例的终端

每个命名实例的会话终端都运行在它自己的 tmux 服务上,因此绝不会与默认服务器的会话或你在 tmux 里跑的其他东西混在一起:

tmux ls                             # default server's chat terminals (zd_*)
tmux -L agents-server-work ls       # the 'work' instance's terminals (zdi_work_*)

移除实例

agentsdock remove work                    # one instance
agentsdock remove --all                   # every instance, including default
agentsdock remove --all --exclude default # every named instance, keep default

移除会停止服务并删除运行时和配置(包括该实例的 token);其会话历史默认保留。当一个名称被释放时,它的状态目录会被移到私有备份,而不是抹除——见名称释放备份。--purge-state 是唯一的破坏性选项,且总是要求输入完整路径。

规则与限制

  • 默认实例不能被释放;只有命名实例可以。
  • 移除默认服务器绝不会影响命名实例(它们是同级根目录,不是子目录)。
  • 端口必须空闲且未被预留;管理器绝不会为了占用端口而停止已有的监听进程。
  • 导入的提供方历史在实例之间互斥,同一个 Claude/Codex 会话不会被采纳两次。
  • 实例共享你的用户账号,彼此之间不是沙箱。
AgentsDock

为 agentic AI 研究而设计的 IDE。© 2026 AgentsDock

文档 支持 反馈问题 隐私 Discord ↗