安装成 `trismind` 命令¶

本文说明如何把 DevKit 打包成可安装的命令行软件，让其他人装完后直接执行：

trismind

不需要手动建虚拟环境，也不需要记住 devkit_v04.py 的路径。

1. 分发物是什么¶

仓库里新增了：

install.sh          # 安装脚本
uninstall.sh        # 卸载脚本
原型/pyproject.toml # Python 包配置
原型/devkit/cli.py  # 安装后的 trismind 命令入口

安装后的结构：

~/.local/share/trismind/venv/   # 独立的 Python 虚拟环境
~/.local/bin/trismind           # 全局命令软链接
~/.devkit_v04_state.json        # 运行状态（首次启动后生成）

安装器优先使用 uv 创建环境；没有 uv 时回退到 python3 -m venv + pip。

2. 从本地仓库安装¶

把仓库或发布包发给对方，进入仓库根目录：

bash install.sh

脚本会自动：

创建 ~/.local/share/trismind/venv
安装 trismind-devkit
在 ~/.local/bin 创建 trismind 命令
打印版本号

如果 ~/.local/bin 不在 PATH，按脚本提示把下面一行加入 ~/.zshrc 或 ~/.bashrc：

export PATH="$HOME/.local/bin:$PATH"

然后重新打开终端：

trismind --version

3. 安装后的用法¶

打开自带的旅游攻略 Demo¶

mkdir -p ~/agents/travel-demo && cd ~/agents/travel-demo
trismind demo

demo 只会在当前空目录生成完整示例；非空目录会直接报错，不会覆盖任何文件。只准备目录、不启动界面：

trismind demo --setup-only

在空目录创建自己的项目¶

mkdir -p ~/agents/my-travel-agent
cd ~/agents/my-travel-agent
trismind

当前目录为空时，trismind 会自动生成最小可运行项目并直接进入 project ▸，不再需要额外的 init 命令。

打开已有项目¶

cd ~/agents/my-travel-agent   # 该目录下应有 trismind/config.yaml
trismind

升级 / 卸载¶

# 升级（检查版本并调用 uv tool / pipx / pip）
trismind upgrade

# 或使用 uv tool / pipx 安装时
uv tool upgrade trismind-devkit
pipx upgrade trismind-devkit

# 卸载
bash uninstall.sh

卸载脚本只删除命令和虚拟环境，不会删除项目文件或 ~/.devkit_v04_state.json。

4. 从 Wheel 安装¶

在 原型/ 目录构建 wheel：

cd 原型
uv build --wheel

产物在 原型/dist/ 下。安装方式任选：

# 推荐：uv tool
uv tool install dist/trismind_devkit-0.6.1-py3-none-any.whl

# 或 pipx
pipx install dist/trismind_devkit-0.6.1-py3-none-any.whl

安装后同样会得到 trismind 命令。

5. 做成一条命令给其他人¶

如果仓库已经推到 GitHub / GitLab 或公司内网 Git，可以直接把 install.sh 放在可访问的地址：

curl -fsSL https://your-host/install.sh \
  | TRISMIND_REPO_URL=https://your-host/agentstore-ui.git bash

说明：

install.sh 会 git clone 仓库，再安装 原型/。
需要目标机器有 git。
如果使用内网 Git，把 URL 换成内网地址即可。
也可以把仓库打包成 agentstore-ui-0.6.1.tar.gz 放在静态服务器上，让对方下载解压后执行 bash install.sh。

当前仓库没有配置 Git remote，所以还没有可直接发出的公网 URL。
发布时只需把 install.sh 和 TRISMIND_REPO_URL 中的地址替换成实际仓库地址。

6. 构建发布包¶

在仓库根目录执行：

bash scripts/build-release.sh

脚本会生成：

dist/trismind-devkit-0.6.1/
dist/trismind-devkit-0.6.1.tar.gz

把 tar.gz 发给别人，对方执行：

tar xzf trismind-devkit-0.6.1.tar.gz
cd trismind-devkit-0.6.1
bash install.sh

7. 依赖和平台¶

macOS / Linux / WSL
Python 3.10+（安装器默认用 uv 选择 3.12）
首次安装需要能访问 PyPI；发布内网版本时可以配置 uv --index 或提前准备 wheelhouse
安装器不包含 ttyd、Cloudflare Tunnel、部署脚本；这些属于公网演示，不属于本地命令行安装

安装成 trismind 命令¶