三步跑通NorthCinder订单管理自动解析邮件、追踪物流、退货提醒一个不少【免费下载链接】northcinderOpen-source MCP server for comparing products and asking the buyer before purchase.项目地址: https://gitcode.com/gh_mirrors/no/northcinderNorthCinder 是一款开源的 MCP 服务器它的订单管理模块能把订单确认、物流和退货截止邮件自动读懂变成一份保存在你电脑上的结构化订单台账物流状态全程追踪退货截止前主动推提醒。整个流程不碰大模型邮件内容也不上传任何云端。你有没有过这种时刻一个月前网购的东西想退货打开邮箱往前翻确认单、发货通知、物流短信混在一起最后根本想不起来最晚哪天能退。NorthCinder 把这件事翻过来——不是你去翻邮箱找订单而是订单自己排好队等你查。不靠大模型一封邮件怎么被读懂订单邮件解析parser.ts全程确定性执行没有任何 LLM 参与靠两样东西一个手写的 RFC 5322/MIME 阅读器负责头行展开、quoted-printable/base64 解码、多部件遍历图片附件之类非文本内容绝不会被当成正文一张固定顺序的插件表按优先级逐个交棒像接力赛一样哪一棒先举手认领就归它解析。顺序插件负责识别1return-window退货窗口邮件2delivery配送完成邮件3shipping-upsUPS 物流邮件4shipping-uspsUSPS 物流邮件5shopifyShopify 订单确认6amazonAmazon 订单确认7generic-fallback通用兜底顺序是刻意的退货窗口和物流措辞排在商家确认单之前否则同一域名比如 Amazon发来的发货邮件会被误读成又下了一单。兜底插件是整张表的安全网——它永远匹配但只返回unparsed标记绝不编造订单字段。这意味着没有哪封邮件会被悄悄丢弃读不懂的邮件会带着原始主题写进unparsed-emails.jsonl等你人工过目。连插件自身抛错也只会降级为unparsed而不是让程序崩溃。数据入口有三条.eml 投放、IMAP、手动补录邮件怎么进来取决于你想要多省事最省事.eml 投放目录把订单确认邮件另存为.eml文件丢进指定目录即可。特性按 Message-ID 自动去重同一目录反复扫描不会出重复订单目录路径用NORTHCINDER_ORDERS_MAIL_DROP_DIR指定该通道默认关闭需显式设置NORTHCINDER_ORDERS_ALLOW_LOCAL_UNAUTHENTICATED1才开启启动时会打出LOCAL UNAUTHENTICATED BYPASS ENABLED标记。最省心IMAP 只读轮询配置NORTHCINDER_ORDERS_IMAP_HOST、NORTHCINDER_ORDERS_IMAP_USER、NORTHCINDER_ORDERS_IMAP_PASSWORD或TOKEN后调度器会定时检查收件箱。抓取用的是UID FETCH … (BODY.PEEK[]).PEEK永远不会把邮件标记为已读——这不只是礼貌更是崩溃安全就算进程在取到邮件、还没落盘之间挂掉下一轮照样找得到它。同时有硬限制单次最多 100 个 UID、单封原始邮件 1 MiB、原始邮件总量 10 MiB、socket 累计响应 12 MiB超限直接拒收整批。未配置凭据时轮询会如实报告结构化的not_configured跳过状态绝不伪造成功。手动补录邮件实在读不出来的用 MCP 工具import_order手工录入订单照样进台账。三步跑起来northcinder-orders 调度器关键点先说在前面IMAP 轮询和退货提醒只有在调度器运行时才会生效。northcinder-orders随northcinder/client一起发布两种模式任选模式命令适用场景单次执行后退出northcinder-orders --once配 cron / 计划任务常驻循环northcinder-orders --interval 900长期后台运行间隔默认 900 秒每个周期按固定顺序做三件事导入投放目录如已开启→ 轮询 IMAP如已配置→ 跑退货提醒。退出码的约定对 cron 很友好只有实际尝试过的检查全部失败比如 IMAP 配了但连不上、提醒发送失败时--once才返回 1什么都没配置的安静周期视为健康返回 0。用 cron 每 15 分钟跑一次一行配置搞定*/15 * * * * /usr/local/bin/northcinder-orders --once ~/.config/northcinder/orders-cron.log 21macOS 用户可改用 launchd把 plist 放到~/Library/LaunchAgents/com.northcinder.orders.plistStartInterval设为 900再用launchctl load加载即可完整示例见仓库的 packages/orders README。 退货提醒发过一次就不再重复提醒引擎reminders.ts的逻辑简单而可靠距退货截止还剩NORTHCINDER_ORDERS_RETURN_REMINDER_DAYS默认 3天以内时触发推送通道二选一设置了NORTHCINDER_NTFY_TOPIC就走 ntfy与价格监控共用同一个推送通道否则输出到终端去重标记reminderSentAt直接持久化在订单的退货窗口记录上——发送成功后才打标重启电脑不会二次轰炸两次完整运行只发一次提醒只是告知NorthCinder 不会替你真的提交退货截止日同时会导出成 RFC 5545 的.ics日历文件丢进日历应用到点自动弹。订单状态从下单到送达的全景同一笔订单会随着新邮件不断被刷新物流状态取更靠后的一档不会倒退状态含义label_created运单已创建in_transit运输途中out_for_delivery派送中delivered已送达exception运输异常所有数据集中在一个本地文件order-graph.json权限 0600只有你本人可读它与你自己用 NorthCinder 结账的记录做只读合并——结账日志保持追加式、不可变邮件侧的订单则作为可更新的合并视图存在。直接问 AI三个 MCP 订单工具订单能力以 MCP 工具暴露注册在 client/src/server.ts接入后可以直接用自然语言问工具干什么list_orders列出全部订单每次调用会先扫一遍投放目录get_order查单笔订单的商品、全部关联运单、退货截止import_order手工补录邮件解析不出的订单于是我最近的订单有哪些这单什么时候能退这类问题AI 调一次工具就有答案不需要你开邮箱。安全默认失败关闭不装成功订单数据敏感这套设计处处默认失败关闭原始邮件包括Authentication-Results头是攻击者可控输入永远不用于认证 IMAP 消息。内置传输若拿不到权威认证元数据就在任何订单入库前拒绝整批而不是悄悄吞掉本地投放目录是独立的手动旁路默认关闭且开启它不会连带提升 IMAP 的信任级别商家名称、订单号、商品标题入库前会清除控制字符一封恶意邮件没法借此往 ICS 文本或工具输出里注入伪行全部数据只留在本地不与任何远端通信。邮箱里躺着你的订单但台账该由你自己掌握。NorthCinder 用确定性规则替代模型猜测、用只读通道替代邮箱改动、用本地文件替代云端同步——当翻邮箱找订单变成一句话的事剩下的精力就可以留给真正的决策退还是留。【免费下载链接】northcinderOpen-source MCP server for comparing products and asking the buyer before purchase.项目地址: https://gitcode.com/gh_mirrors/no/northcinder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
