XInbox

01为什么做

我在 X 上收藏了很多内容，想整理、想再用的时候，遇到了三个问题：

1. X 的收藏夹没法整理。只有开通 Premium 会员，才能对收藏夹里的内容分类、筛选；不开会员，收藏只是一条越来越长的列表，想找回某一条很不方便。
2. 「稍后阅读」软件加上 AI 就很贵，也不和 Agent 协作。市面上的这类软件接入 AI 功能后收费昂贵，而且很多没有对 Agent 开放 MCP，资料锁在软件里，没法让 Codex 这类 AI 工具直接读取和整理。
3. 看过的内容沉淀不成自己的想法。这些工具大多没有白板，读完的文章只是一篇篇存着，没办法把几篇放在一起比较、连线，从中提炼观点，形成自己的创意板。

所以 INbox 打开时的第一句话是「让收藏重新有用」：把来自 X、公众号和网页的内容集中保存成自己的资料库，不用会员也能整理和筛选；软件本身免费，AI 功能用你自己的 API Key；资料通过 MCP 开放给 Agent；再在研究白板上把资料变成自己的观点。

02定位与边界

03看看效果

界面是终端风格的黑底绿黄配色，按 Figma 里的六页设计稿还原，另有三套配色可以切换。动图里用的是应用自带的 12 条示例收藏，没有连接任何账号。

04核心设计

1. 把内容完整地存下来

• X 书签：点「连接 X」后在系统浏览器里登录授权，只申请读取书签所需的权限；分页同步、自动去重，断开连接后已导入的收藏仍保留。
• 公众号和网页：粘贴链接导入全文，保留段落、标题、引用、代码和图片顺序，图片下载到本机。遇到要验证的页面不硬闯，可以自己在浏览器里打开后另存为 HTML 再导入。
• 重复导入不丢整理：同一篇再导入或再同步，只更新正文和媒体，批注、标签、分类、阅读队列都保留。

2. AI 整理有规则，手动永远优先

• AI 标签默认每条最多 3 个，整个标签池最多 16 个，每个最多 12 个字，都可以在设置里改；手动标签不限数量，也不占 AI 配额。
• AI 不覆盖手动编辑，整理过程中你改过的也会保护；整轮整理失败时不会只改一半，原标签保持不变。
• 可以接一个专门做判断的分类服务（Jev），从候选标签里选，而不是自由生成新标签；相同内容的结果会缓存，不重复消耗 token。
• 没有配置任何 AI 时，用本地规则分类，界面上明确写着「本地规则」。

3. 读、问、连成观点

• 翻译和总结：长文分段处理，显示实际进度，可以中途停止；停止或失败时保留已完成的部分，并标为「部分结果」。
• 跨收藏提问（Ask Agent）：可以问全库、某个标签或某个合集，读的是所选范围里全部已保存的正文，回答附上来源入口。
• 研究白板：把文章卡片、笔记和 AI 回答放在一起，分组、连线、在线上写关系；AI 笔记能定位回原文。
• 改动先确认：AI 要修改标签、合集、阅读队列或导入链接时，先弹出确认，拒绝就不改。

4. 开放给其他 AI 工具

INbox 自带一个 MCP 服务，提供 11 个工具（搜索、读取全文、加标签、建合集、加入阅读队列、导入链接等），Codex 这类 AI 工具可以直接读取和整理同一个资料库。

5. 用量看得清

每次调用模型的请求数、输入和输出 token 都记下来，可以设本机预算和剩余比例预警；DeepSeek 还能读取账户余额。接口没返回用量的请求单独计数，不按零计算。

05迭代记录

0.2.2 之后的重要功能变化，依据 README 的版本说明和 GitHub Release。

1. v0.2.210.12 之前新增

   补全图片和视频

   • X 收藏里的图片、视频和动图跟着原收藏保存，详情页直接看图、内嵌播放视频，卡片上标出 VIDEO / GIF；再次同步会补全媒体信息，不覆盖手动整理过的标签、批注和阅读状态

2. v0.2.310.12 之前重构 · 舍弃

   长文完整显示，去掉多余的调宽菜单

   • 取消卡片和正文的固定高度，长文、原文的换行和缩进完整保留
   • AI 侧栏去掉三点菜单里的缩小、放大、复位按钮，只保留拖动边缘和键盘调宽

3. v0.2.410.12 之前新增

   图片查看器和「收藏文章」

   • 长图、网页配图和白板里的图片都能点开同一个查看器，支持适应窗口、100% 和缩放
   • 侧栏新增「收藏文章」，和阅读队列分开；取消收藏后原文仍留在全部收藏里

4. v0.2.510.12发布

   首次公开发布

   • 整理出不含个人数据的公开版本：源码和安装包只有程序、示例数据和运行环境，没有账号、令牌、API Key 和真实收藏
   • 从文章返回时，回到进入前的页码、搜索、筛选和滚动位置，不再跳回第一页

5. v0.2.610.15新增

   Ask Agent 显示进度

   • 跨收藏提问时显示处理到哪个阶段、正在读哪篇来源、调用了几次模型；Codex 和 DeepSeek Harness 的执行记录默认展开

6. v0.2.710.22新增

   同步 X Articles 全文

   • 收藏的 X 长文章（Articles）同步完整正文、原标题、封面和配图；之前只同步到短预览的，再同步一次就能补全

06测试与发布

• 自动测试：95 项测试，覆盖搜索、分类、账户隔离、凭据加密、X 授权、分页与限流恢复、AI 协议、标签规则、网页全文与图片导入、翻译和总结、用量与预警等；外部的 X 和 AI 接口用模拟服务。
• 界面还原：六个页面按 Figma 设计稿实现，加入导入 URL 和 AI 入口之前，在 1440px 宽、100% 字号下检查了 48 个关键布局位置与设计稿一致；在 200% 全局缩放和 360px 窄窗口下，AI 侧栏仍然可以正常使用。
• 安全：API Key 和登录令牌用 AES-256-GCM 加密保存；导入网页前校验地址，不允许访问内网；网页里的脚本不执行。
• 公开版不带个人数据：源码和安装包只包含程序、字体、示例数据和运行环境；全新安装时 X 和 AI 都未连接。

07下载与使用

1. 打开下载的 DMG，把 INbox 拖进「应用程序」。安装包还没有经过 Apple 公证，第一次打开如果被拦截，到「系统设置」→「隐私与安全性」里点「仍要打开」。
2. 第一次启动有四步引导，可以跳过。没连接账号时，先用 12 条示例收藏体验。
3. 在「同步中心」点「连接 X」同步书签，或者在首页点「导入 URL」粘贴文章链接。
4. 想用 AI 功能，在「终端设置」里选择服务、填入自己的 API Key，测试连接后再用。

08目前的不足

• 只有 Apple Silicon 的 macOS 安装包，而且还没有经过 Apple 公证。
• X 的图片和视频用的是 X 的网络地址，离线时看不到；还不支持视频下载、图片文字识别和语义检索。
• 分类服务（Jev）的默认判断阈值还没有用真实收藏校准，需要手动纠正。
• AI 问答只依据已保存的文字，不分析配图；引用是否准确仍取决于模型。