四分钟看懂 thoth.ink
从三个常见痛点讲起，用动画把定位、一个任务怎么跑、为什么流程不交给模型、成本怎么记、知识怎么入库和回流逐一推演一遍。
不和 Agent 拼聪明，做 Agent 下面那层底座
CLI 和模型每个月都在变强，比"谁更聪明"没有护城河。thoth.ink 把编排、调度、连接、计量写成确定性代码，智能交给用户自己配置的 CLI 和模型；CLI 升级，thoth 跟着升级。
常见 Agent 工具
- 流程交给模型临场决定，每次走法可能不同
- 成本按月订阅或账单汇总，不知道花在哪一步
- 经验会话结束即散，下次从零开始
- 模型绑定一家，换模型等于换工具
thoth.ink
- 流程路由、派发、权限、校验写在代码里，可复现
- 成本每条回复标 token，会话面板实时显示上下文占用与累计
- 经验产出入库、分级、关联，下一个项目直接调用
- 模型BYOK，多供应商并存，按"习惯"一键切换
引擎
不依赖模型。换便宜模型或本地模型，编排质量不降。
- 任务路由、派发、汇总
- 配额、并发、token 预算
- MCP 工具调用、脚本复现
- 供应商配置与自动连接
- 账本、权限、可观测
模型
只在"认知叶子"上出场，跑在用户自选的 CLI 或 LLM 上。
- 生成内容、对资料推理
- 给方案、做取舍
- 没有现成脚本时写新脚本
- 修复报错的脚本
知识库
一切产物入库，一切用量入账，一切异常入系统层。
- 素材 / 成果 / 经验 / 法规四级
- 独立审核 Agent 负责入库
- 条目按内在属性关联成图谱
- 项目成果回流
三个承诺，拆成可以验收的功能
每个承诺先落到用户的真实痛点，再落到一条具体需求，最后对应到产品里看得见的功能。右列的功能在第 04 章都能看到。
- "习惯"：CLI → thoth 中转 → 供应商/模型，连线编排
- 启动前校验握手，缺依赖给出"去安装 / 重试"
- 权限档位（严格逐步 / 危险授权）+ 权限透明结果
- 计划模式、停止、继续输出（中断于此）
- 回复下方 ↑输入 ↓输出 Σ累计 token
- 会话状态面板：上下文占用 %、进度热力格
- BYOK：火山、agnes-ai、nvidia、deepseek 等并存，逐个模型可测试
- 用量统一写入 LedgerEntry 账本
- 决策目录、会话记录、记忆晋升，挂在每个会话右栏
- 知识图谱（银河 3D）展示条目关联
- 指南：选来源 → 一键生成学习指南 / 简报 / 思维导图 / FAQ / 时间线
- ThoGit：提交记录随项目沉淀
素材
原始输入：网页剪藏、文档、会话、录屏、代码。量最大，噪声也最大。
按项目方向开放成果
项目交付物：方案、报告、代码、设计稿。项目结束后回流入库。
按项目方向开放经验
从成果和复盘里提炼的做法、踩过的坑、当时为什么这样决定。
按项目方向开放法规
标准、规范、合规条款。是答案的依据，不是可以改写的素材。
只做引用，不改写条目之间按内在属性关联（同一工艺、同一客户、同一条法规），而不是按文件夹。AI 能读哪几级，由当前项目方向决定。
专注做某一类项目，案例越攒越多。AI 接上这个库给方案，就像有经验的老员工给的建议。
一个外壳，四个入口，状态始终外显
工作区沿用深色低噪的桌面风格，品牌元素（水母、银河）只出现在首页和知识图谱。所有页面共用同一个外壳：顶栏、左栏导航、主区、右侧会话状态。
会话列表
分组
IM 通道
设备
回复卡片
模型 · ↑↓Σ
输入框
/ 命令 · @ 文件
权限档位 · 模型
上下文 %
进度热力格
决策目录
会话记录
记忆晋升
入口少而固定左侧竖条只有会话、知识库、功能、管家四个入口；功能插件（open-design、infinite-canvas、pi-web 等）在"功能"里以标签页打开。
状态外显，不藏在设置里每条回复标注模型和 token；右栏常驻会话状态。用户不用问"刚才花了多少"。
输入框是控制台/ 唤起命令与技能，@ 选文件，旁边就是权限档位和模型切换，一处完成"让谁、用什么、能做到哪一步"。
设计稿 1:1 还原每个界面先出静态 HTML 设计稿，开发时逐字搬样式，用 pixelmatch 对截图把关。
按三条车道看真机界面
引擎、模型、知识库各看几个关键界面，再看多端与插件。点图放大。
引擎 · 确定性流程
链路、校验、权限都由用户配置，代码执行
模型 · 判断
智能来自用户自选的 CLI 和模型，thoth 负责把它接进来
知识库 · 沉淀
产出不留在聊天记录里
连接 · 多端与插件
同一套会话和终端，在桌面、手机、IM 之间接续
"件齐 + 单测"不算完成，跑起来才算
这条规矩来自 IntelliBoard 时期的教训：很多模块代码齐了、单测也过了，真机一跑就断。thoth.ink 每个改动都要过四道门，界面和功能都要在真机上验证。
| 功能 | 车道 | 操作与观察 | 结果 |
|---|---|---|---|
| BYOK 多供应商 | 引擎 | 配置 nvidia、豆包系列模型，逐个点"测试" | 跑通 |
| 习惯编排与切换 | 引擎 | Claude CLI 经 thoth 中转连 Anthropic / deepseek，校验全绿后"更新习惯"，顶栏切换 | 跑通 |
| 校验握手 | 引擎 | 本机未装 Pi CLI，校验面板标红并给出"去安装 / 重试 / LLM 配置" | 兜底 |
| 权限档位 | 引擎 | 从严格逐步切到危险授权，右栏列出每项能力的放行状态 | 跑通 |
| 浏览器任务 | 模型 | /ul-browser 查询昆明天气，返回"任务结束"；第二轮手动停止，显示"已停止" | 跑通 |
| 会话内嵌浏览器 | 模型 | 会话旁打开 chat.qwen.ai，页面正常加载 | 跑通 |
| 命令面板 / 文件选择 | 模型 | 输入 / 和 @ 分别弹出技能列表和文件、计划模式选项 | 跑通 |
| 划词改写 / 语音听写 | 模型 | "划词改写已就绪"提示出现；听写触发键可选 | 跑通 |
| 会话状态与决策目录 | 知识库 | 每条回复显示 ↑↓Σ token，右栏展开决策目录、会话记录、记忆晋升 | 跑通 |
| 知识图谱 · 银河 3D | 知识库 | 1,100+ 条目渲染，切换视图模式、调节漫游 | 跑通 |
| 笔记 / 白板 / 指南 | 知识库 | 新建笔记和白板并输入内容；打开指南，加工产物入口可见 | 跑通 |
| 功能插件 | 连接 | open-design 正常嵌入；infinite-canvas 本地服务未启动时提示启动命令 | 跑通 兜底 |
| IM 通道 / 设备配对 | 连接 | 微信、Telegram 开关；Wi-Fi 配对码、直连、USB 三种接入 | 跑通 |
| 手机端 | 连接 | 会话列表、终端列表、对话同步正常；一次回复报 Connection refused | 跑通 待修 |
| pi CLI 调用 | 模型 | "thoAI · pi 调用超时（CLI 无响应）" | 待修 |
| 四级分级 · 审核 Agent · 成果回流 | 知识库 | 这条链路尚未演示 | 未覆盖 |