● NON-RUN CONTRACT · 31 TESTS PASSING

把 Agent 做成
可进入的工作空间。

这是 DevKit 原型的网页版教程。当前版本以 docs 中的产品契约为准,重点完成第三章、第四章(Run 模块除外)的交互、资源模型与发布流程。

01 / SCOPE第三章 · 设计 Agent

项目配置、Node、Workflow、Skill、Tool、Knowledge 与 MCP 的组织方式。

02 / COMMANDS第四章 · 命令面

项目页、资源页、Workspace、Session、IDE 与 Test 的可执行命令。

03 / INTERACTION统一交互区

面板拥有输入;选项用文本确认,取消会真正退出 pending,不污染命令历史。

04 / DELIVERYValidate → Build → Submit

从源码校验、构建 manifest/zip 到提交前检查,形成可追溯链路。

第三章 · 设计 Agent

Agent 是项目资源的组合,不再依赖旧的顶层 metadata 形态。项目根目录由可编辑源码组成,生成目录只由 build 产生。

最小项目结构

trismind/config.yaml prompts/system.md nodes/<node_id>/node.yaml workflows/<workflow_id>.yaml skills/<skill_id>/SKILL.md tools/<tool_id>/tool.py knowledge/<name>/ test/

编辑 config 的示例

进入项目后,可以先打开配置页,再设置字段:

config set metadata.description "旅行规划助手"

也可以用一条命令直接修改:

config set metadata.description "旅行规划助手"
Node 页面不再提供 prompt、requirements、dod 三个编辑命令;这些仍是 Node schema 字段,源文件通过 ide [path] 打开。

第四章 · 命令面

入口用途示例
tool → mcp从 Tool 进入 MCP;MCP 的 exit 回到 Tooltool / mcp
workspace创建、快照、版本树、回滚与 diffworkspace revert ws_001
test创建并运行测试样例test new case
node选择并管理 Nodenode → validate

交互区规则

✓面板出现时普通输入区和命令历史不会参与。
✓选项使用上下箭头选择,Enter 确认;不支持 jk,也不会触发命令历史。
✓带 Cancel 的面板支持 Esc,Esc 会真正清除 pending 状态。
✓test new case 只生成 YAML 样例,不打开 Editor。

Workspace · 版本树

Workspace 列表展示 versioned workspace 的 Git 风格快照链;进入 revert <id> 后,从该 workspace 自己的版本树选择回滚目标。

workspace list ws_001 versioned local ./workspace/demo git tree snap_001 → snap_002 → snap_003 workspace revert ws_001

direct 与 readonly workspace 不允许回滚,并会给出明确提示。删除 workspace 只删除注册记录,不删除目录文件。

安装成 trismind 命令

把仓库发给对方,或上传到 Git 服务器后,对方执行安装脚本即可得到全局 trismind 命令。安装器会创建独立虚拟环境,不污染系统 Python。

cd agentstore-ui bash install.sh trismind --version trismind demo # 打开自带旅游攻略 Demo

从远程仓库安装:

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

卸载:bash uninstall.sh。完整说明见 docs/INSTALL-PACKAGE.md。

部署与访问

原型服务监听所有网卡,固定端口为 3000;教程站固定端口为 3001。

cd 原型 ./serve.sh start ./serve.sh status ./serve.sh update

局域网访问使用本机 IP:http://<本机IP>:3000(终端原型),http://<本机IP>:3001(教程站)。源码更新只执行 update,链接不变。

公网终端演示:https://demo.amstroy.com.co/,Basic Auth 口令见 deploy/state/credentials.env。

跨局域网公网访问需要路由器端口转发,或配置 Cloudflare Named Tunnel token。Quick Tunnel 只能临时访问,不能作为稳定链接。