AstrLink最新版

AstrLink 是一款开源的跨平台桌面应用（支持 macOS、Windows 和 Linux），专为 AI Agent 设计，充当本地隐私网关。在请求发往上游模型之前，它能在本地按策略识别密钥、邮箱、手机号等敏感内容，并进行提醒、拦截或脱敏处理。模型返回的脱敏内容也可在本地还原，确保 Agent 的后续工作流不受影响。

本地隐私保护与数据脱敏机制

启用安全策略后，AstrLink 会在本机完成敏感内容检测、请求脱敏和响应还原，确保数据不出本地设备。

• 本地检测：支持使用内置规则、自定义规则或本地隐私模型来识别敏感内容。其中，规则检测无需下载额外模型，降低了资源占用。
• 策略处理：用户可按需配置处理动作为提醒、拦截或脱敏。脱敏模式会将检测到的敏感内容替换为占位符，并支持配置检测类型与白名单。建议先通过试运行检查效果，再应用于生产环境。
• 按需还原：启用响应还原功能后，系统会将模型返回文本中的占位符自动恢复为原始内容，便于 Agent 继续处理完整结果。

需要明确的是，网关转发、隐私检测和脱敏操作均在本地运行。推理请求仅在完成本地处理后，才会发送到你配置的上游 API 提供商。

统一接入与多协议模型路由

该工具旨在集中管理分散的账号与密钥，降低多模型调用的维护成本。

• 统一接入：支持连接 Codex、Claude、Grok 等订阅服务，以及 OpenAI、Anthropic、Gemini、DeepSeek、千问、Kimi、GLM、MiniMax、豆包、xAI 等主流厂商的按量付费 API，同时兼容 New API 和 Coding Plan 等网关。
• 模型路由：支持将客户端请求的模型名重定向到实际的目标模型。用户可配置提供商优先级、失败重试机制以及提供商自动切换逻辑。
• 多协议支持：提供 OpenAI Responses、Chat Completions、Anthropic Messages 和 Gemini 接口，并可根据上游 API 的实际能力配置协议转换。

部署与配置步骤

AstrLink 的配置流程分为四个主要阶段，旨在实现平滑的本地化接入。

1. 接入订阅或 API：在“API 提供商”页面添加已有订阅（如 Grok 使用 Device Code 登录）或填写兼容网关地址与 API Key。保存后需拉取或手动添加可用模型，未配置模型的提供商不会处理推理请求。
2. 创建访问令牌：在“访问令牌”模块为不同的 Agent 创建独立令牌。这有助于隔离用量统计，并在必要时单独撤销特定 Agent 的访问权限。
3. 连接 AI Agent：复制本地网关地址（默认 http://127.0.0.1:8317，端口被占用时会自动变化）。在 Agent 配置中填入 Base URL（如 /v1/chat/completions）、刚创建的访问令牌及模型 ID。
4. 设置路由与隐私策略：在路由中调整提供商优先级，并可开启同一会话优先复用 API 提供商；在安全策略中选择检测方式，建议先通过试运行验证效果。

调用记录与常见问题排查

系统提供详细的请求、会话轨迹、上游尝试和错误原因记录。用户可按提供商、模型和访问令牌维度统计用量，并获取估算费用（实际计费以提供商账单为准）。

在日常使用中，可参考以下指南进行问题排查：

• 认证失败：首先确认填写的 AstrLink 访问令牌是否有效。若请求记录显示上游返回 401 或 403，需检查对应提供商的密钥或订阅登录状态。
• 找不到模型：检查提供商是否已启用、模型列表是否包含该模型，以及入口协议是否匹配。若使用模型重定向，需确认规则已启用且目标模型受支持。
• 端口连接异常：默认端口被占用时，AstrLink 会自动切换至空闲端口。若手动修改了设置中的端口，需重启网关方可生效。
• 隐私模型拦截请求：检查本地隐私模型是否安装完成、策略配置是否正确。在模型不可用时，请求不会跳过检测直接发送。
• 窗口关闭后的状态：隐藏到系统托盘时网关会继续运行；完全退出应用则会停止网关服务。