NorthCinder 订单管理完整指南:从邮件自动解析到退货提醒 NorthCinder 订单管理完整指南从邮件自动解析到退货提醒【免费下载链接】northcinderOpen-source MCP server for comparing products and asking the buyer before purchase.项目地址: https://gitcode.com/gh_mirrors/no/northcinderNorthCinder 是一个完全运行在你电脑上的开源订单管理工具它把订单确认、发货、配送邮件自动解析成结构化数据并在退货截止日前主动提醒你让你不用再翻邮箱找订单。 先跑起来前置条件只有两个Node.js 20 或更高版本以及一个支持 MCP 的 AI 应用MCP 即让 AI 应用调用你电脑上本地工具的标准协议。装好后一条命令完成初始化NorthCinder 会打印要添加到 AI 应用里的配置npx northcinder init订单模块随northcinder/client一起发布核心是一个叫northcinder-orders的调度器——提醒和邮箱轮询只有在它运行时才生效这一点后面会反复出现。它解决什么问题订单确认、发货、配送邮件散在收件箱各处同一笔订单的状态没有集中入口可查这单什么时候退不了了要自己翻商家政策错过截止日期就损失退款不想把邮件内容交给任何第三方云服务又不想每天手动整理怕用 AI 解析邮件会编造订单号凭空生成假数据。背后的核心机制解析遵循确定性法则全程不用大模型。一封邮件先经过手写的 MIME 阅读器相当于把邮件拆成头部和正文的翻译器再依次交给一张固定优先级的插件表谁先匹配谁接管规则定义在 parser.ts检查顺序插件匹配内容1退货窗口退货截止相关措辞2配送完成已送达通知3–4UPS / USPS两条物流线的运输通知5–6Shopify / Amazon对应商家的订单确认7通用兜底永远匹配只返回无法解析标记顺序是关键设计退货与配送措辞先于商家专属插件检查否则 Amazon 发来的发货邮件会被误读成新订单。兜底插件保底匹配保证任何邮件都不会被静默丢弃——解析不了的进unparsed-emails.jsonl清单供你人工查看绝不编造。功能详解本地 .eml 投放目录最轻量是什么把订单邮件另存为.eml文件放进指定目录即自动导入按 Message-ID 去重重复扫描不会生成重复订单。怎么开启设置环境变量NORTHCINDER_ORDERS_ALLOW_LOCAL_UNAUTHENTICATED1可用NORTHCINDER_ORDERS_MAIL_DROP_DIR指定路径。默认行为默认关闭显式开启后会明确标记为本地未认证旁路。IMAP 邮箱轮询最省心是什么定时连接你的邮箱自动拉取新订单邮件。怎么开启配置NORTHCINDER_ORDERS_IMAP_HOST、USER、PASSWORD或TOKEN三项凭据。默认行为用只读的 BODY.PEEK 方式抓取绝不把邮件标记为已读也绝不改动邮箱任何内容每轮上限 100 封未配置时如实报告未配置绝不假装成功。退货截止提醒最贴心是什么解析出退货窗口即记录截止日期临近时推送提醒。怎么开启设置NORTHCINDER_NTFY_TOPIC走 ntfy 推送与价格盯梢共用同一通道不设置则输出到终端。默认行为提前 3 天提醒可用NORTHCINDER_ORDERS_RETURN_REMINDER_DAYS调整截止日同时导出.ics日历文件提醒发送成功后持久化记录重启也不会重复轰炸。核心逻辑在 reminders.ts。用 cron 配好调度器一行配置是什么让上面三个功能按时运转的定时器。怎么开启在系统任务计划里加一行每 15 分钟跑一个周期*/15 * * * * /usr/local/bin/northcinder-orders --once ~/.config/northcinder/orders-cron.log 21默认行为--once跑一轮即退出--interval 900则常驻循环默认 900 秒一轮。macOS 的 launchd 写法见 packages/orders/README.md。MCP 工具查询最直接是什么三个工具注册进你的 AI 应用——list_orders列出全部订单先自动扫一遍投放目录、get_order查单笔订单的物流状态和退货截止、import_order手动补录邮件解析不出的订单。默认行为直接问 AI我最近的订单有哪些它会调工具回答物流状态从 label_created运单已创建一路更新到 delivered已送达。一次完整流程调度器每轮按固定顺序走五步启动--once单周期或--interval常驻进入一个调度周期导入若投放目录已开启扫描.eml文件并按 Message-ID 幂等去重轮询若配置了 IMAP只读抓取新订单邮件未配置则标记 not_configured 跳过提醒检查全部退货窗口处于提前 3 天窗口内且未发过的推送到 ntfy 或终端汇报无事发生属健康正常退出只有真正执行过的操作失败时--once才返回非零退出码方便 cron 发现异常。 数据、安全与隐私边界它做的它不做的全部数据存本地订单图order-graph.json权限 0600仅你本人可读不向仓库运营方发送任何订单数据、搜索记录商家名、订单号等字段入库前清除控制字符防恶意邮件注入不把邮件标记已读、不移动或删除收件箱内容IMAP 拿不到认证元数据时整批拒绝绝不全量吞单不用 LLM 解析邮件不产生幻觉订单号提醒只是通知你绝不替你发起退货收尾NorthCinder 把翻邮箱找订单变成一条 cron 任务确定性规则解析杜绝幻觉双通道导入覆盖手动与自动提醒按日去重可靠送达。你的每一笔订单都由你自己掌控——现在就装好它把第一封订单确认邮件扔进投放目录试试。【免费下载链接】northcinderOpen-source MCP server for comparing products and asking the buyer before purchase.项目地址: https://gitcode.com/gh_mirrors/no/northcinder创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考