桌面客户端（Windows 绿色免安装）
下载、解压即用；能操作本机文件与命令，数据完全留在你自己的电脑
桌面客户端是「装在自己电脑上的通千算智」：内置运行环境，不需要装 Python、不需要管理员权限，解压就能跑。
下载与安装
前往下载页
获取最新版 Windows 绿色免安装包（约 232 MB）
把 zip 解压到任意目录，建议 D:\通千算智，路径不要带空格或中文标点之外的特殊字符。
双击【通千算智.exe】。首次启动要展开内置组件，等 10–30 秒属正常。
打开「配置」页面 → 选厂商（如 DeepSeek）→ 填 API Key → 保存。 如果公司统一下发了预置版本，这一步可以跳过。
Windows 首次运行可能弹「已保护你的电脑」：点【更多信息】→【仍要运行】。 这是因为我们未购买代码签名证书，不代表软件有问题——可核对下载页提供的 SHA256 校验值。
它能做网页版做不到的事
- 读写你电脑上的文件（整理文档、批量改表格、归档下载目录）
- 在你电脑上执行命令、跑脚本
- 打开本地文件与文件夹
- 系统通知（定时任务到点弹窗提醒）
- 剪贴板读写、托盘常驻（关掉窗口仍在后台运行）
- 语音输入（麦克风）、摄像头拍照作为附件
与网页版的区别
| 桌面客户端 | 团队工作台（网页） | |
|---|---|---|
| 操作本机文件/命令 | ✅ | ❌ |
| 团队共享知识库 | ❌ 本地独立 | ✅ 全员共享 |
| 管理后台审计 | ❌ 看不到 | ✅ 可审计 |
| 模型 Key | 每人自配或预置版 | 平台统一提供 |
| 数据位置 | 你自己的电脑 | 服务器 |
两边可以同时用，各取所长；但请记住两者的对话与记忆不互通。
数据存在哪
| 内容 | 路径 |
|---|---|
| 配置、日志、通道凭据 | %USERPROFILE%\.tqsz\ |
| 对话、记忆、知识库、产出文件（工作空间） | %USERPROFILE%\.tqsz\workspace\ |
- 卸载/删除程序目录不会删除这两个目录，重装后数据仍在。
- 想彻底清理或迁移到新电脑：备份/删除上述目录即可。
- 想换机器：把窗口关掉 → 拷贝目录 → 在新机器上首次启动前先放好目录。
与企业环境里的另一份 CowAgent 共存安全：桌面版在数据目录（.tqsz，不是开源版的 .cow）、
工作空间（.tqsz/workspace，不是 ~/cow）、子进程环境、应用身份四方面做了隔离，
既不会读到别的程序的数据，也不会被宿主环境的环境变量/配置劫持。
发行包不含任何模型凭据：Key 属账号级资产，打进安装包等于分发给每个人（用量、账单、额度都归属不清）。 所以第一次使用需要自己到「配置」页填一个 Key；语音输入默认也是关闭的，配好语音 Key 后再打开。
通过浏览器访问客户端后端
客户端启动后会在本机监听 9876 端口（被占用时自动换端口）。所以你也可以在浏览器打开 http://localhost:9876，
得到与客户端一致的界面。
端口无法使用时可查客户端目录下 run.log 里的 Local access 一行，确认实际端口；
也可以在配置里指定固定端口。
常见问题
杀毒软件报警 / 被拦截
未签名程序的通用现象。加入白名单即可；也可参考下载页给出的 SHA256 自行校验文件完整性。
首次启动很慢
绿色版首次运行需要展开内置运行时（含 Python 环境），10–30 秒属正常，之后启动会快很多。
对话一直转圈 / 报错
多数是模型 Key 未填或无效。到「配置」里检查厂商与 Key，保存后重试；仍不行看日志页面的报错信息。
想让它开机自启
把快捷方式放进「启动」文件夹；或保持托盘常驻，日常不退出即可。