https://txtmix.com/tags/maka/Recent content in Maka on Text MatrixHugozh-cnTue, 21 Jul 2026 20:06:14 +0800https://txtmix.com/posts/tech/maka-agent-local-first-ai-workbench-2026/Tue, 23 Jun 2026 18:32:23 +0800https://txtmix.com/posts/tech/maka-agent-local-first-ai-workbench-2026/<h1 id="maka把-ai-agent-的执行记忆和凭据真正留在本地">Maka：把 AI Agent 的执行、记忆和凭据真正留在本地</h1> <h2 id="学习目标">学习目标</h2> <p>读完本文后，你应当能够：</p> <ul> <li>画出 Maka 的 monorepo 拓扑（5 个 packages + 1 个 desktop app），说出 <code>core</code> / <code>storage</code> / <code>runtime</code> / <code>headless</code> / <code>ui</code> 各自管什么</li> <li>解释 Runtime Kernel 拆分的设计动机——为什么要把 <code>SessionManager</code> 和 <code>AiSdkBackend</code> 拆成 6 个组件，以及&quot;用户面 0 改动&quot;是怎么做到的</li> <li>列出 9 个 Memory Privacy Gates 的具体规则，并能用它对自己项目的 memory 设计做一次对照检查</li> <li>说明凭据保护的三层：safeStorage 加密 → preload 只暴露操作接口 → renderer 不持明文密钥</li> <li>复述 &ldquo;1 canonical + N 投影&rdquo; 的架构思路，以及它为什么比 &ldquo;N 个并列真相&rdquo; 更容易演化</li> </ul> <h2 id="本文目录">本文目录</h2> <ul> <li><a href="#1-%e5%85%88%e7%bb%99%e5%88%a4%e6%96%ad" rel="">先给判断</a></li> <li><a href="#2-%e9%a1%b9%e7%9b%ae%e5%ae%9a%e4%bd%8d%e4%b8%8e%e7%b3%bb%e7%bb%9f%e8%be%b9%e7%95%8c" rel="">项目定位与系统边界</a></li> <li><a href="#3-%e4%b8%80%e5%bc%a0%e6%80%bb%e8%a7%88%e5%9b%bemaka-%e7%9a%84%e4%b8%9c%e8%a5%bf%e6%80%8e%e4%b9%88%e5%88%86" rel="">总览图：Maka 的东西怎么分</a></li> <li><a href="#4-runtime-kernel-extraction%e6%8a%8a%e5%a4%a7%e5%9d%97%e6%8b%86%e6%88%90-6-%e4%b8%aa%e7%bb%84%e4%bb%b6" rel="">Runtime Kernel 拆分：6 个组件</a></li> <li><a href="#5-runtime-v2%e4%b8%8b%e4%b8%80%e9%98%b6%e6%ae%b5%e7%9a%84%e4%b8%ad%e5%bf%83%e6%98%af-invocation--runtimeevent--agentflow" rel="">Runtime v2：Invocation + RuntimeEvent + AgentFlow</a></li> <li><a href="#6-9-%e4%b8%aa-memory-privacy-gates%e6%9c%ac%e5%9c%b0%e8%ae%b0%e5%bf%86%e7%9a%84%e9%9a%90%e7%a7%81%e8%ae%be%e8%ae%a1" rel="">9 个 Memory Privacy Gates</a></li> <li><a href="#7-%e5%87%ad%e6%8d%ae%e4%bf%9d%e6%8a%a44-%e7%b1%bb%e5%af%86%e9%92%a5%e8%b5%b0-electron-safestorage" rel="">凭据保护：safeStorage</a></li> <li><a href="#8-%e5%a4%9a%e6%a8%a1%e5%9e%8b%e6%8e%a5%e5%85%a513-%e4%b8%aa%e5%85%a5%e5%8f%a3%e7%9a%84-provider-%e6%8a%bd%e8%b1%a1" rel="">多模型接入：13 个入口的 provider 抽象</a></li> <li><a href="#9-opengateway--%e5%a4%9a%e6%9c%ba%e5%99%a8%e4%ba%ba%e5%85%a5%e5%8f%a3%e8%ae%a9-ai-%e5%b7%a5%e4%bd%9c%e5%8f%b0%e6%8e%a5%e5%85%a5%e6%97%a2%e6%9c%89%e6%b6%88%e6%81%af%e6%b5%81" rel="">OpenGateway + 多机器人入口</a></li> <li><a href="#10-%e5%90%af%e7%a4%ba%e7%bb%99%e7%8b%ac%e7%ab%8b-ai-agent-%e9%a1%b9%e7%9b%ae%e4%bd%9c%e8%80%85%e7%9a%84-5-%e6%9d%a1%e5%b7%a5%e7%a8%8b%e7%bb%8f%e9%aa%8c" rel="">5 条可复用的工程经验</a></li> <li><a href="#11-%e8%b0%81%e8%af%a5%e5%85%88%e7%94%a8-maka%e8%b0%81%e5%8f%af%e4%bb%a5%e7%ad%89%e7%ad%89" rel="">采用建议</a></li> <li><a href="#12-%e5%b8%b8%e8%a7%81%e9%97%ae%e9%a2%98-faq" rel="">常见问题 FAQ</a></li> <li><a href="#13-%e8%87%aa%e6%b5%8b%e9%a2%98" rel="">自测题</a></li> <li><a href="#14-%e7%bb%83%e4%b9%a0" rel="">练习</a></li> </ul> <h2 id="1-先给判断">§1 先给判断</h2> <p>Maka 解决的一个具体问题是：当你在本地跑一个 AI coding agent 时，你的代码、会话历史、记忆条目和 API 凭据分别存在哪里、谁有权读、中断后能不能恢复。</p>