$ cat ~/map/mina.md
Mina
包在 pi 外层的研究与工程 harness：目标直到检查通过才算完成，上下文后台压缩并交接，每条命令跑在沙箱里。
tools✓ 10月30日
事实速查
- GitHub Stars
- ★ 0
- Forks
- 0
- 许可证
- MIT
- npm / 月
- —
- 最后推送
- 2026年11月5日
安装
git clone https://github.com/mratan/mina.git && cd mina && npm ci，随后 npm run literature:install，并把 bin/mina.mjs 软链到 PATH；需要带 systemd 用户会话与 cgroup v2 的 Linux、bubblewrap 以及 Node.js 22 或更新版本。## 速览
一个跑在 Linux 上的长时间工作 harness：目标直到 agent 自己的检查通过才算完成，上下文在后台压缩并交接给全新会话，每条命令都在隐藏凭据的 bubblewrap 沙箱里执行，研究工具可检索网页与学术文献。自带固定版本的 pi；无遥测。
## 要点
- $/goal 启动一个目标，检查由 Mina 自己运行；agent 会一直做到每项检查通过为止，--check 或 --protect-checks 可冻结经你批准的检查。
- $检查点在后台总结较旧的回合，完整会话文件始终留在磁盘上；context_recall 检索当前会话，mina_recall 检索整条交接链。
- $上下文接近写满时，agent 写一份交接笔记，工作在新会话中继续并链接回旧会话；交接期间你输入的消息会进入新会话。
- $每条命令都在新建的空 bubblewrap 沙箱里运行，沙箱只加回你的项目目录、用 --sandbox-read 或 --sandbox-write 传入的文件夹、只读的系统软件，以及一个私有 home。
- $SSH 密钥、云凭据、登录态与研究密钥保持隐藏；出站流量经由拒绝本地网络的代理，还可用 --sandbox-net packages 或 --sandbox-net offline 进一步收紧。
- $研究工具可检索 PubMed、arXiv、bioRxiv、OpenAlex 与 Semantic Scholar，阅读开放获取论文并追踪引用；mina-research 协议把标题和摘要视为非证据，并标记撤稿论文。
- $无遥测：pi 的安装上报、模型目录下载与版本检查都被关闭，因此需要手动用 mina update --models 从 pi.dev 刷新模型列表。
- $最多四个 subagent 同时运行在沙箱内，其工具调用会被记录；Mina 自带固定版本的 pi，复用 ~/.pi/agent 中的登录与设置。
## 常见问题
Q Mina 会取代 pi 吗？
不会。Mina 自带固定版本的 pi，并复用 ~/.pi/agent 中相同的登录与设置；pi 能用的模型——例如 Claude、OpenAI Codex 与本地模型——在 Mina 里都能用。
Q 沙箱把什么挡在外面？
你的 SSH 密钥、云凭据、登录态与研究密钥即使在你添加的文件夹里也保持隐藏，agent 的命令只能经由拒绝本地网络的代理访问公网。
Q agent 能直接 push 到 git 吗？
不能。push 要经过一道拒绝强推与泄露密钥的闸门；可选的主机操作经由 mina-hostd 代理执行，它只做你按项目注册的动作，并逐条记录。
Q 能在 macOS 或 Windows 上跑吗？
README 列明的要求是带 systemd 用户会话与 cgroup v2 的 Linux、bubblewrap，以及 Node.js 22 或更新版本；未提及 macOS 或 Windows 支持。
Q 为什么新发布的模型不会自己出现？
会话从不下载 pi 的模型目录。运行 mina update --models，从 pi.dev 拉取你已登录供应商的当前模型列表，之后的会话即可看到新模型。
## 参考链接
## 相关条目
## 教程
最后更新: 2026年11月5日