trina-app/trina-ax · 上手攻略
- 仓库：trina-app/trina-ax
- 链接：https://github.com/trina-app/trina-ax
- 分类：agent / 企业内部 AI 平台（self-hosted Claude Code & Codex 网关）
- 作者：spark
- 更新：2026-11-04
§0 自检清单
- [x] GitHub URL 已 fetch（README 全文，2026-11-04 抓取）
- [x] 仓库卡核对：TypeScript、115 stars、周增 +28、最近提交 2026-11-04、许可 AGPL-3.0（README 补充：云协议单独 MIT）
- [x] 关键子文档锚点：
docs/for-admins.md/docs/README.md/docs/QUICKSTART.md/docs/security-and-permissions.md/docs/PERMISSIONS.md/docs/for-teams.md/docs/CONFIGURATION.md/docs/FAQ.md/docs/INSTALL-LINUX.en.md/docs/OFFICE.en.md/docs/DEVELOPMENT.md/CHANGELOG.md/SECURITY.md/llms.txt均在 README 中出现并核对 - [x] 版本信息：价格数据 README 自述「checked 2026-11-02」
- ⚠️ 待补：未取 release tag 与 checksum（README 只给了
releases/latest链接） - ⚠️ 待补：README 中安装器版本可能滞后于源码（README 自己提示「Published installers can lag behind source changes」）
- 说明：本文只读公开页面，未 clone、未运行代码
§1 它是什么
Trina AX 是一套企业内部的「Claude Code / Codex 集中化」平台：一台公司服务器上跑真实的 Claude Code 和 Codex 代理，接上公司的文件、团队技能和每个人的文件夹权限；其他同事只需要开浏览器就能用，不用在自己笔记本上装任何东西。
README 的定位句是："Set up Claude Code once. Your whole company gets it."
它解决的核心问题是「Claude Code 很强，但每个人都要自己装、自己配、自己带权限，结果每个人看到的公司上下文都不一样」。Trina 的做法是：
- 公司文件放进
shared/，团队怎么写方案的套路放进skills/proposal/SKILL.md； - 每个人在浏览器、桌面或手机上提问，不碰终端；
- 服务器以「提问者本人」的身份检查每一次文件访问——你看不到的文件夹，对你的 AI 来说也不存在。
§2 解决什么问题
README 用一个具体对比说明差异：
一个 Claude seat 给每个人一个自己的空工作区。Trina 给所有人同一套公司文件夹和团队技能，在一台服务器上，由服务器为每个人检查文件夹权限。你仍然可以连接各自的账号。
核心的四层设计（README 的架构图原文）：
Trina 服务器 ← Claude Code / Codex（自带 shell 与 file 工具已关闭）
│ ↓ 唯一通路：Trina 文件工具
↓ 权限检查（以提问者身份）
公司文件夹（shared · groups · projects · users）
关键一句：「direct disk access denied by the OS」——引擎对磁盘的直接访问被操作系统层面拒绝，只能走 Trina 自己的文件工具。这不是应用层的君子协定，是 OS 隔离。
四个方面的能力：
- 真实的 Claude Code 和 Codex 代理——跑在服务器上，默认每次回答最多 150 轮工具调用，最多 4 个 sub-agent 并行，支持 web search 和 schedules。
- 公司文件夹即知识库——
shared/、groups/、projects/和个人文件夹，带版本历史；能读 PDF、Office 以及 HWP/HWPX（韩文办公格式）里的文本。 - 技能像文件一样被治理——一个技能就是一个
SKILL.md文件；文件夹规则决定谁能用，AI 修改技能前会先问人。 - 每个人的访问权限独立保留——看不到的文件在 Files、AI 回答、搜索、预览、版本历史和回收站里全部不可见。
§3 快速安装
3.1 本地演示（最快，10 分钟）
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——两人看到的是不同的 group 文件夹。
前置条件：Git、Bun 1.3.12、Go 1.27+。
AI 是关闭的，所以不需要任何 AI 账号；数据是虚构的。这不是生产安装。走一遍 docs/QUICKSTART.md。
3.2 生产自托管（Linux）
README 给的 Linux 门槛：Debian 12/13 或 Ubuntu 24.04、systemd 且 cgroup v2、amd64 或 arm64、推荐 4GB 内存、磁盘至少 20GB。安装走 docs/INSTALL-LINUX.en.md，之后是「建 owner 账号 → 权限 → AI 连接 → 邀请团队 → 第一个技能 → 第一次备份」这条路径。
3.3 三种部署形态对比（README 原表）
| Trina 托管（AWS 首尔） | Linux 自托管 | 办公室 Mac | 本地演示 | |
|---|---|---|---|---|
| 适合 | 没有 IT 的团队 | 有 IT 负责人的团队 | 有专属 Mac 的小办公室 | 随便看看 |
| 谁运维 | Trina | 你的 IT | 办公室运维 | 你 |
| AI | 你授权的 Claude 或 OpenAI 连接 | 同左 | Claude（无 Codex） | 关闭 |
| 成本 | 3 人内免费，之后 $39/月起 + AI 用量 | 免费软件 + 你的服务器 | 免费软件 | 免费 |
§4 核心用法
4.1 技能（Skill）就是 SKILL.md
README 给的示例技能表：
| 角色 | 真实任务 | 可复制技能 |
|---|---|---|
| CEO / 团队负责人 | 把周记变成决策、风险和下一步 | examples/skills/weekly-team-report/SKILL.md |
| 销售 | 从会议记录写跟进，不编造承诺 | examples/skills/sales-follow-up/SKILL.md |
| 市场 | 从已批准的品牌资料做活动 brief | examples/skills/brand-brief/SKILL.md |
| 财务 | 标出缺收据和金额存疑项供复核 | examples/skills/expense-review/SKILL.md |
| HR | 依据有权限的政策回答入职问题 | examples/skills/new-hire-guide/SKILL.md |
| 所有人 | 从会议记录提取决策与行动项 | examples/skills/meeting-summary/SKILL.md |
技能 = 一套可复用的指令，不是模型训练，也不是额外权限。 人来审阅结果。团队负责人清单见 docs/for-teams.md。
4.2 AI 连接
- 连接公司的 Claude 或 OpenAI 账号一次，或者让每个人连自己的；
- 每人用量可查、有限额；
- 自托管时 Claude Code 还可以跑 DeepSeek、Kimi、GLM 等模型，走 Anthropic 兼容网关（见
docs/CONFIGURATION.md#anthropic-compatible-gateway）。
托管版连接优先级：合格的个人连接 > 指派给某个人的连接 > 指派给某个组的连接 > 全团队连接。新建 Trina 团队默认一个公司连接可服务全团队；已保存的选择会保留。连接级同意仍然适用，而且 README 明确说：这个软件设置不等于获得 Anthropic 或 OpenAI 条款下的许可。
4.3 密钥处理
Token 在浏览器里就封装好再发送，引擎拿到的是每轮一次性（per-turn）的替身 token，模型代理再加回真实密钥。这是本项目安全设计的核心机制之一。
4.4 语言与入口
应用支持英语、韩语、印尼语、日语、西班牙语。README 有简体中文版（README.zh-CN.md）、韩语版、日语版、西班牙版。入口：桌面和手机浏览器 + Windows 安装器。
机器可读索引：llms.txt。
§5 典型适用场景
- 团队统一 AI 上下文：所有人问同一个问题，得到基于同一套公司文件的回答，而不是各自空工作区里的幻觉
- 权限敏感的组织：销售看不到财务文件，HR 只能读被授权的政策——且这些限制对 AI 生效，不只是对界面生效
- 技能沉淀：把「我们怎么写方案」写成
SKILL.md沉淀成团队资产，且改动需要人确认 - 无终端的团队：给不懂命令行的同事一个浏览器入口
- 韩企/韩语办公环境：HWP/HWPX 文本提取、AI 生成 .hwpx（标题、段落、列表、简单表格）、填充既有 .hwp/.hwpx 表单并原格式保存
§6 坑与注意
- 自托管不等于离线：请求需要的上下文会发给你连接的 AI 供应商。README 明确说「Self-hosting is not offline」。
- 服务器运维者能读你的一切：包括存储的文件和聊天记录；Trina 自己托管时也一样。应用管理员读不到私人对话（聊天只有归属者可见，活动记录只显示 AI 读了哪些文件、不含对话内容），但服务器运维者能。README 专设「What leaves the server」一节说明这点——部署前必须讲清楚。
- 移除文件夹访问权 ≠ 抹掉之前的回答：已给出的答案不会被收回。「扩大共享范围的确认」不是通用的数据丢失防护。
- Linux 服务器不跑 OCR：扫描件和照片在 Linux 上对 AI 是图像，不可做文字搜索（管理员可关闭图片模式，但那样 AI 就读不了内容）。
- Linux 上 AI 还会读视频和音频：均匀间隔的帧会当图片发给 AI 供应商；音频转文本只在管理员允许时发生（选项名「Turn video sound into text」）。若团队选了 OpenRouter，团队文件的声音会发到 OpenRouter 及其供应商；但机密对话不会发声音。办公室 Mac 尚不能读视频。
- OS 隔离有条件：Linux 和「角色账号式 Mac 安装」有专属引擎账号隔离；办公室 Mac 以登录用户身份运行，本地 demo 完全没有 OS 隔离。
- HWP 视觉预览有系统要求：可选的 HWP Preview 插件需要 macOS 或 glibc 2.39 及更新的 Linux——Debian 12 不支持（文本提取不受影响）。
- 没有安全认证，不承诺完美答案或省钱：README 原文——「No security certification, perfect answers, guaranteed savings or automatic legal, financial or HR decisions. Review outputs and deployment boundaries.」
- 每次 Codex web search 会把当前对话历史发给 OpenAI 的搜索服务；服务器每 30 分钟向
updates.trina.app查询自己的公网地址（MYCEL_EXIT_ADDRESS_CHECK=off可关）。 - 发布版安装器可能滞后于源码，README 自己提示要「check their release notes」。
- AGPL-3.0-only 的网络分发条款：如果你基于它提供修改版并通过网络提供服务，须向这些用户提供源码。云协议另按 MIT 授权。Claude Code 和 Codex 各有自己的条款，本项目未获 Anthropic 或 OpenAI 背书，Claude 是 Anthropic 的商标。
- 托管版价格随时可能变：README 的价格数据自述「checked 2026-11-02」——Free（至 3 人，名额有限）、Starter $39/月（至 5 人）、Team $69（15 人）、Business $129（40 人），40 人以上需询价，AI 用量另计。
§7 与同类对比
| 方案 | 团队共享上下文 | 权限粒度 | 入口门槛 | 许可/成本 |
|---|---|---|---|---|
| Trina AX | 公司文件夹 + 团队技能统一 | 每人每文件夹，服务端以提问者身份检查 | 浏览器，零安装 | AGPL-3.0 / 自托管免费，托管 $39 起 + AI 用量 |
| 每人一个 Claude seat | 无，各空工作区 | Anthropic 账号级 | 各自装终端 | 按 seat 订阅 |
| 自建 Claude Code + 文件挂载 | 有 | 靠 OS 文件权限粗放控制 | 懂命令行的人才能用 | 自担工程 |
| GitHub Copilot Enterprise | 仓库/组织级 | 组织 + 仓库级 | 装 IDE 插件 | 企业订阅 |
| 自建内部 RAG 聊天 | 有 | 靠自建检索过滤 | 要开发 | 自担工程 |
| 各家「AI 工作区」SaaS | 有 | 企业级 | 浏览器 | 闭源订阅，数据出境 |
它最独特的组合是：真引擎（Claude Code / Codex，不是套壳）+ 真 OS 隔离（引擎的磁盘访问被拒）+ 细粒度文件夹权限 + 技能治理。多数同类只做到其中一两项。
§8 一句话推荐结论
如果你要在一个十几到几十人的团队里推广 Claude Code 又怕权限失控，Trina AX 是目前少见的「真引擎 + 真隔离 + 人人浏览器可用」三合一方案——它把公司文件变成共享知识、把技能变成可审计的 SKILL.md、把权限变成服务端逐次校验；上手先跑 bun run demo（无需 AI 账号、AI 关闭、数据虚构）看权限模型，但落地前必须把三条讲清楚：服务器运维者能读数据、自托管不等于离线、移除授权不撤回历史回答。
本文只读公开页面（GitHub README，2026-11-04 抓取）。未 clone、未运行代码，命令均转录自 README。⚠️ 标记处为待核项。