本地安装与运行¶

想把它安装成全局 trismind 命令、不再手动找虚拟环境和入口文件，请看 INSTALL-PACKAGE.md。

1. 环境要求¶

macOS / Linux / WSL
Python 3.10+，推荐 3.11 / 3.12
一个真实终端：macOS Terminal、iTerm2，或 WSL 终端

Windows 原生 CMD/PowerShell 不是主要验证环境，建议使用 WSL。

仓库位置以 ~/Downloads/agentstore-ui 为例。下面的命令默认从仓库根目录执行：

cd ~/Downloads/agentstore-ui

2. 安装依赖¶

原型/ 已包含 pyproject.toml，但本地开发仍然推荐用 requirements.txt 安装依赖；只有需要打包/全局安装时才使用 pyproject.toml。

方案 A：uv（推荐）¶

如果还没有 uv：

# macOS，任选一种
brew install uv
# 或
curl -LsSf https://astral.sh/uv/install.sh | sh

安装后如果提示 uv: command not found，重新打开终端，或确认 ~/.local/bin 在 PATH 中。

进入原型目录并安装：

cd 原型

# 如果当前目录里的 .venv 是别的机器复制来的、已经坏了，先删掉再建：
# rm -rf .venv

uv venv .venv --python 3.12
source .venv/bin/activate

uv pip install -r requirements.txt

Windows PowerShell / WSL 的激活命令：

.venv\Scripts\activate
uv pip install -r requirements.txt

方案 B：Python venv + pip¶

cd 原型

python3 -m venv .venv
source .venv/bin/activate

python -m pip install --upgrade pip
pip install -r requirements.txt

两种方案装完后，可以用下面的命令确认依赖：

python -c "import yaml, rich, readchar; print('dependencies ok')"

3. 启动¶

trismind 的行为由当前目录决定（docs/cli/4-2-shell-commands.md）：

当前目录	行为
存在 `trismind/config.yaml`	作为已有项目打开，进入 `project ▸`
完全为空	原子生成最小可运行项目，然后进入 `project ▸`
非空但没有 marker	打印错误并退出，不写入任何文件

本地源码运行：

cd 原型
python -m devkit.cli

安装成全局命令后：

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

两个版本信息：

trismind --version
# TrisMind DevKit 0.6.1
# Agent Core 0.6.1

4. 最小项目结构¶

空目录启动后会生成：

trismind/config.yaml
trismind/policy.yaml
abilities/general/ability.yaml
abilities/general/ability.md
abilities/general/nodes/respond/node.yaml
abilities/general/nodes/respond/prompt.md
abilities/general/nodes/respond/description.md
skills/
tools/local/
tools/mcp/
knowledge/
prompts/system.md
test/basic.test.yaml
workspace/

5. 常用命令¶

非 Run 层命令直接输入裸词，不加 /：

help
ability            # 选择或新建 Ability，之后 node 选择 Node
validate
build
submit --note "first release"
workspace          # 新建/快照/对比/回滚/删除工作区
session            # 新建/列出/删除会话
skill / tool / knowledge / prompt / policy / config / test
run "帮我规划一次京都旅行"

进入某个页面后用 help 查看该页命令，exit 返回上一层。? 等同于 help。

旧项目迁移¶

如果目录里存在旧的 nodes/<id>/ 或 tools/<name>/ 布局，启动时会提示迁移：

旧的 Node 会移动到 abilities/main/nodes/<id>/（或已有 Ability 下的新 Ability 目录）；
旧的本地 Tool 会移动到 tools/local/<name>/；
workflows/ 不属于当前 4.1–4.5 资源模型，会保留在原位并在提示中列出；
迁移在确认后执行，失败会回滚。