首页 / 文档 / 快速开始 / 桌面客户端

桌面客户端

下载并使用 通千算智 桌面客户端(Windows 绿色免安装)

通千算智 提供开箱即用的桌面客户端,内置 Agent 运行环境,无需手动安装 Python 或依赖,解压后即可在本地运行你的 AI 数字员工。

通千算智 桌面客户端

直接操作本地文件、终端与浏览器,具备长期记忆、个人知识库与自主进化能力,全部在你的电脑上运行。

下载安装

⬇️

前往下载页

下载 Windows 绿色免安装版(zip,解压即用)

把 zip 解压到任意目录(建议 D:\通千算智,路径不要带空格)。

双击【通千算智.exe】。首次启动需要展开内置组件,等 10–30 秒属正常。

打开「配置」页面,选择厂商(如 DeepSeek)并填入 API Key 后保存。 发行包不预置任何凭据——Key 属于账号级资产,随包分发会导致用量与账单归属不清。

macOS 用户:当前对外分发的是 Windows 绿色免安装版。 需要 macOS 客户端可基于开源版自行构建,或使用团队工作台(浏览器免安装)。

更新

客户端内置「检查更新」,读取的是通千算智自有更新通道(不会回连上游站点,也不会被官方版覆盖)。 绿色版的升级方式是「下载新包 → 解压替换」,详见桌面客户端更新。

与命令行部署的区别

  • 桌面客户端:适合个人开箱即用,无需安装任何依赖,图形界面,支持自有通道更新。
  • 命令行部署:源码运行,适合开发者在本地或服务器部署,可定制性更强,见一键安装。

通过浏览器访问

桌面客户端启动后会在本机监听 9876 端口,其后端与 Web 控制台完全一致。 因此在打开客户端的同时,也可以直接用浏览器访问 http://localhost:9876,获得一致的完整体验。

如果该端口不可用(例如被 Hyper-V/WSL2 保留),客户端会自动改用其它端口并正常启动。 实际端口可在客户端目录下 run.log 的 Local access 一行查到。

本地数据存储

桌面客户端的所有数据都保存在本机,且与机器上其它 Agent 程序完全隔离:

内容 路径
配置、日志、通道凭据(数据目录) %USERPROFILE%\.tqsz\
对话、记忆、知识库、技能、产出文件(工作空间) %USERPROFILE%\.tqsz\workspace\

删除程序目录不会删除这两个目录,重装后数据依然保留。 如需彻底清理或迁移到其他设备,手动备份或删除对应目录即可。

注意

不要把这个工作空间目录改回 ~/cow:那是本机单独安装的开源版 CowAgent 的默认工作空间, 两个程序共用同一个目录会出现「打开自己的客户端却看到别人会话」的串数据问题。