Never Overstay

本地智能体能力

让你的智能体接入 SCHNGN

安装本地运行时，通过 MCP 连接，并添加技能，以可靠规划申根 90/180 天规则。

设置 MCP 比较接口
  • 在本地进程中计算
  • 无 SCHNGN 遥测
  • 严格且有版本的 JSON
  • 普通 90/180 天规则

SCHNGN 不会发出出站请求。不过，你的智能体主机仍可能把工具输入和结果发送给其模型提供商。

02

智能体技能

该技能会教智能体何时调用 SCHNGN、如何构造明确的停留区间，以及何时拒绝法律身份问题。

该技能提供的行为

  • 优先使用 MCP 工具，不重新实现日期计算。
  • 输入仅包含连续申根停留的入境和出境日期。
  • 只处理普通短期停留规划，并将特殊情况引导至官方主管机关。
03

接口

CLI

在脚本和智能体 shell 中使用 JSON CLI。它从 stdin 或文件读取严格 JSON，并返回一个 JSON 结果。

命令：schngn usage、schngn check-stay 和 schngn latest-exit。

schngn usage --input request.json
04

接口

REST + OpenAPI

为使用 REST 的工具启动仅限回环地址的 HTTP 服务。它提供实时 OpenAPI 文档，并拒绝非本地绑定地址。

OpenAPI：http://127.0.0.1:37491/openapi.json

schngn-api
05

接口

TypeScript

导入纯 engine 进行底层日期计算，或导入 capability 包使用严格的智能体契约。

软件包：@schngn/engine 和 @schngn/capability

npm install @schngn/capability 
import { calculateUsage } from '@schngn/capability';

const result = calculateUsage({
  stays: [{ entryDate: '2026-01-01', exitDate: '2026-01-12' }],
  referenceDate: '2026-02-01'
});
06

工具参考

每种接口都提供相同的版本化计算契约。日期使用 YYYY-MM-DD，停留区间同时包含入境日和出境日。

01

calculate_schengen_usage

输入
{ stays, referenceDate, includeCountedDays? }
用途
计算明确参考日期上的已用天数和剩余天数。
02

check_schengen_stay

输入
{ existingStays, candidateStay }
用途
逐日检查拟议的连续停留。
03

latest_safe_schengen_exit

输入
{ existingStays, entryDate }
用途
为已知入境日期的停留找出最晚安全出境日。
07

隐私边界

计算边界位于本地，但完整的智能体链路可能包含云服务。

LOCAL

SCHNGN 运行时

运行时不持久化数据、不发送遥测、不记录提交的日期，也不发出出站网络请求。

HOST

智能体主机和模型提供商

你的 MCP 客户端或智能体主机可能把提示、工具参数和结果发送给模型提供商。使用真实旅行日期前，请查看该提供商的隐私和保留政策。

要求

需要 Node.js 24 或更高版本。计算无需 SCHNGN 账户、API 密钥、托管端点或网络连接。

范围和限制

此能力按照普通申根 90/180 天规则对明确的连续停留进行建模。它不判断国家归属、不决定签证或居留权、不应用双边协议，也不提供法律建议。

仅供规划参考。获准停留期限由主管机关决定。