归档

沿着登录、选择和使用模型的过程，解释 Ink 怎样分别保存多家大模型提供商的凭据、汇集候选模型、应用切换和适配能力差异，以及怎样保留模型选择。

从继续调查登录测试的任务出发，解释子代理怎样核对启动记录与运行条件、取得单写者租约、修复中断留下的历史，再带着新要求开始下一次运行。

沿一次模型调用的用量报告，解释 Ink 怎样统一并保存计数、汇总主 Agent 与子代理和摘要的消耗，再按产生用量的模型估算会话成本，并说明界面数字的统计范围与限制。

从界面开发中对视觉信息的需求出发，解释 Coding Agent 怎样把本地图片带入模型上下文，再沿着截图的读取、处理、请求转换和历史保存，分析 Ink 的实现与限制。

解释 MCP 是什么，以及统一协议怎样减少外部工具接入中的重复适配；再以查询天气为例，追踪 Ink 中的服务连接、工具发现、调用和失败处理。

以生成 Git 提交信息为例，解释 Ink 怎样准备可用 Skill 清单、将清单提供给模型、按需读取正文与参考资料，以及用户指定 Skill 时怎样将正文加入上下文。

从两个子代理同时调查代码出发，解释并发任务怎样启动、等待并交回结果，以及共享目录、文件锁和 Git worktree 分别解决什么问题。

从调查登录逻辑的任务出发，解释主 Agent 怎样通过 task 工具启动独立的 Agent 循环，准备子代理的上下文与工具，再把结果带回主对话。

从运行结束提醒、网页搜索工具和任务计时器出发，解释扩展怎样被加载、注册并接入 Agent，再以 pi 为例，讨论会话状态、界面和生命周期为何也是扩展机制的一部分。

从项目资源加载和工具操作两类风险出发，解释 Ink 内置的项目信任检查，以及 Guardian 扩展怎样利用执行前钩子和用户确认接口控制工具操作，再讨论当前方案的局限。

从模型文字、工具状态、子代理进展和等待动画出发，解释终端控制序列、显示状态、组件与差异重绘怎样配合，让 Coding Agent 在终端中持续更新界面。

从查看进展、提前安排任务、执行中纠偏和中断四种交互出发，解释 Agent 的事件反馈、输入队列、取消机制，以及中断或失败后的恢复。

从关闭终端后继续修复代码的任务出发，解释 Agent 怎样保存消息、恢复压缩后的历史，以及处理中途退出留下的不完整记录。

用修复求和函数的任务，解释每次模型调用需要哪些信息、上下文预算怎样估算，以及历史太长时怎样压缩并继续工作。

从给 Agent 增加一种能力出发，解释工具怎样定义、注册、校验和执行，怎样统一返回结果，以及取消与并发调度需要约定什么。

从一次读取 README 的工具请求出发，逐步观察流式参数怎样拼接、完整回复何时交回循环，以及中断、截断和参数解析失败怎样处理。

接着读取 README 的任务，看看 Agent 循环里的消息和工具定义，怎样转换成模型服务接收的请求，以及工具结果怎样在下一次调用中传回去。

从“读取 README，告诉我项目怎样启动”开始，结合带注释的源码节选和逐步演示，理解 Agent Loop 怎样调用模型、执行工具、传回结果，以及处理错误和中断。

为什么参考 pi 从零开发 Ink？从一个改代码的任务出发，看看 Coding Agent 需要哪些模块，以及这个系列会怎样介绍它们。

从 AstroPaper 开始，完成中文适配、文章与专题、静态搜索、Cloudflare 自动部署和访问统计，把搭建博客的过程变成第一篇学习笔记。