shell 命令¶

shell 命令在系统终端执行，不需要先进入 TrisMind。

命令	描述
`trismind`	打开当前项目；空目录会生成一套简易项目
`trismind demo`	在空目录生成并打开完整 Demo
`trismind --version`	打印版本信息后退出
`trismind upgrade`	检查并安装新版本后退出

进入 TrisMind 后使用的命令见命令体系。

启动 TrisMind¶

先进入项目所在目录，再执行：

cd ~/agents/travel-guide
trismind

TrisMind 始终把当前目录作为项目目录，不会自动打开上次使用的项目。

当前目录	结果
已有 `trismind/config.yaml`	打开现有项目，进入 `project ▸`
目录为空	生成一套可运行的简易项目，再进入 `project ▸`
目录非空，但没有 `trismind/config.yaml`	不写入任何内容，提示进入空目录或已有项目目录

项目识别只看 trismind/config.yaml。目录里有 .git、.DS_Store、node_modules 或任意其它条目，都不算空目录。

空目录生成的简易项目¶

空目录启动时，trismind 直接生成一套能运行的基础结构：

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

general Ability 和 respond Node 提供最小执行链路。其余目录为空，只作为后续添加资源的位置；文件内容也保持简洁，便于直接修改。创建工作区和会话后即可运行。

生成过程是原子的：所有文件都成功写入后才算完成。任何一步失败，TrisMind 会删除本次创建的内容，使目录恢复到启动前的空状态。

生成成功后进入 project ▸。后续使用资源管理命令添加或删除资源，不会再次初始化。

创建 Demo 项目¶

希望先查看一套内容完整的示例时，在空目录执行：

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

trismind demo 生成旅游攻略 Demo，包含可以直接运行的 Ability、多个 Node、Skill、Tool、Knowledge、Prompt 和测试用例，然后进入 project ▸。

主要结构：

trismind/
├── config.yaml
└── policy.yaml
abilities/
└── guide_planning/
    ├── ability.yaml
    ├── ability.md
    └── nodes/
        ├── collect_info/
        │   ├── node.yaml
        │   ├── prompt.md
        │   ├── description.md
        │   └── requirements.md
        └── generate_itinerary/
            ├── node.yaml
            ├── prompt.md
            ├── description.md
            └── dod.md
skills/
└── plan_itinerary/
    └── SKILL.md
tools/
├── local/
│   └── weather_query/
│       ├── tool.py
│       └── README.md
└── mcp/
knowledge/
├── travel_guides/
└── retrieval.yaml
prompts/
└── system.md
test/
└── basic-travel-guide.test.yaml
workspace/

Demo 用来展示资源如何组合，不是另一种项目格式。可以直接修改其中任何文件，也可以删除不需要的示例资源。

trismind demo 只在空目录中执行。目录已有项目或其它文件时，命令拒绝执行，不覆盖现有内容。生成失败时同样恢复为空目录。

查看版本¶

$ trismind --version
TrisMind DevKit   0.6.1
Agent Core        0.6.1

输出	含义
`TrisMind DevKit`	命令行产品版本
`Agent Core`	随产品安装的 Agent 运行时版本

该命令不读取项目文件，在任何目录执行结果都相同。打印完版本后立即退出，退出码为 0。

报告安装或运行问题时，直接附上这两行即可。

升级¶

$ trismind upgrade
current  0.6.1
latest   0.6.2
upgrading...
done     0.6.1 → 0.6.2

trismind upgrade 先读取当前版本，再检查远端最新版本。

有新版本：下载并替换安装文件，打印升级前后的版本。
已是最新版本：打印当前版本和 already up to date，不下载文件。
检查或下载失败：打印失败阶段和原因，返回非零退出码。

升级只修改 TrisMind 的安装程序，不修改项目文件、工作区或会话。升级失败时保留原版本，不留下无法启动的半完成安装。

如果新版本需要转换项目配置，下一次启动项目时会先列出需要修改的文件并要求确认。取消后不修改项目，TrisMind 退出；确认后完成转换，再进入 project ▸。

升级问题见故障排查。

完整示例：从空目录到可运行项目【待完善，勿看】¶

$ mkdir -p ~/agents/my-travel && cd ~/agents/my-travel
$ trismind
Created a minimal TrisMind project in /Users/alice/agents/my-travel
  marker: /Users/alice/agents/my-travel/trismind/config.yaml

进入后先确认项目可校验：

project ▸ validate
✓ validation successful · checks 27  successful 27  error 0  status successful
  ✅ trismind/config.yaml
  ✅ trismind/policy.yaml
  ✅ prompts/system.md
  ✅ Ability(general)  General  nodes=1
      ✅ Node(respond)
  ✅ test/basic

如果目录非空：

$ cd ~/Downloads/some-folder
$ trismind
trismind: /Users/alice/Downloads/some-folder is not empty and has no trismind/config.yaml.
  Nothing was created or modified.
  use an empty directory, or cd into an existing TrisMind project.

如果目录看起来是项目但 marker 丢失：

$ trismind --no-init
trismind: /Users/alice/agents/my-travel looks like a TrisMind project, but trismind/config.yaml is missing.
  Nothing was created or modified.