trina-app/trina-ax
AI 工程把 Claude Code 和 Codex 部署在公司服务器上,统一使用公司文件、团队技能和按人划分的文件夹权限。
项目介绍
Trina AX 把 Claude Code 和 Codex 智能体放到公司服务器上,而不是让每个人在自己的电脑里各装一套。公司文件放在 shared/、groups/、projects/ 和个人目录中,技能是普通的 SKILL.md 文件,员工通过浏览器、桌面端或手机端的聊天界面使用。它面向希望共享一套 AI 上下文的团队,省去逐个安装配置编程智能体的麻烦。
核心设计是让 AI 的权限与人保持一致。每次文件访问都按提问者本人校验,因此用户看不到的文件夹对 AI 也不可见,覆盖文件列表、回答、搜索、预览、版本历史和回收站。智能体自身的 shell 与文件工具被关闭,只能通过 Trina 的文件工具访问公司数据,引擎拿到的是每轮替换的临时令牌。Linux 和角色账户 Mac 安装会使用独立系统账户做隔离,办公 Mac 和本地演示没有这层隔离(安全与权限)。
支持从 PDF、Office 和 HWP/HWPX 提取文本。管理员无法浏览私人对话,但服务器运维方可以读取已存储的数据。仓库提供了周报、销售跟进、品牌简报、费用审核、入职问答和会议纪要等示例技能,展示 SKILL.md 的写法(示例)。
快速使用
10 分钟本地演示需要 Git、Bun 1.3.12 和 Go 1.27+。演示使用虚构数据并关闭了 AI,不需要 Claude 或 OpenAI 账号:
git clone https://github.com/trina-app/trina-ax.git && cd trina-ax
bun install --frozen-lockfile
bun run demo # → http://127.0.0.1:19760
用用户名 alice、密码 teamax-demo-1 登录,再在隐私窗口用 bob 登录,可以看到不同的组文件夹。该演示明确不是生产安装,完整步骤见快速入门。
生产部署可在 Trina 托管、Linux 自托管或办公 Mac 安装中选择。Linux 指南要求 Debian 12/13 或 Ubuntu 24.04、带 cgroup v2 的 systemd、amd64/arm64 架构,建议 4 GB 内存,磁盘至少 20 GB。
使用约束
- 自托管并非离线运行。请求所需的上下文会发送给配置的 AI 服务商,每次 Codex 网页搜索会把当前对话发给 OpenAI 的搜索服务;服务器每 30 分钟向
updates.trina.app查询自身公网地址,可用MYCEL_EXIT_ADDRESS_CHECK=off关闭。 - Linux 服务器没有 OCR,扫描版 PDF 和照片无法做文本搜索。HWP/HWPX 可以提取文本,但可视化预览需要可选插件,要求 macOS 或 glibc 2.39 以上的 Linux,因此 Debian 12 不支持。
- 视频和音频读取仅限 Linux,语音转文字需要管理员开启,并走团队配置的语音服务商。
- 移除文件夹权限不会删除此前的 AI 回答;应用管理员看不到聊天,但服务器运维方可以读取已存储的文件和聊天。
- Trina 提供的是工作区而非 AI 订阅,Claude 和 OpenAI 账号须为团队使用获得授权,软件里的连接设置不代表符合两家服务商的条款。
- 应用采用 AGPL-3.0-only,云协议单独使用 MIT。已发布的安装包可能落后于源码改动。
HotRepo 点评
该项目于 2026-11-02 出现在 HotRepo 的 TypeScript 新项目记录中,当时共 106 星,在一个约两小时的窗口内新增 4 星。当天下午的星数采样从 102 升到 106,样本很小,只能说明当日有活动,不足以判断趋势。材料本身值得关注的是具体的权限模型——按请求人逐次校验、关闭智能体自身的 shell 工具——以及配套的可运行、关闭 AI 的演示,让读者不必先准备 AI 账号就能查看工作区。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。