石头的知识库

欢迎来到石头的知识库

Mon, 03 Aug 2026 00:00:00 GMT

石头的知识库是一个公开的内容站，主要收录 AI 工具、API 接入、数字服务与安全实践相关资料。本站不提供账号注册，不保存 API Key，也不在博客页面内处理订单或支付。

内容范围#

AI 与 API 接入：兼容接口的基本配置、常见错误与排查方法。
安全实践：密钥保存、额度控制、设备迁移和异常处理。
数字服务指南：购买前检查、交付确认和售后信息留存。
部署实践：Cloudflare、静态网站和服务拆分等技术方案。

站点与服务#

站点	用途	是否在博客内处理
石头的知识库	阅读文章、搜索教程	是
STapi 中转站	创建和管理接口相关信息	否，跳转至独立站点
MonetLabs API 主站	访问模型、密钥与服务管理	否，跳转至独立站点

各站点独立运行，博客仅承担内容展示和服务导航功能。

安全提醒#

Important

API Key、管理员密码、付款凭证及包含个人信息的截图不应发布在公开页面。文章中的密钥均为示例占位符。

服务能力、模型名称和页面入口可能随版本调整，实际信息以对应服务页面为准。

Claude for Teachers 上线：美国 K-12 教师可免费使用一年

Wed, 05 Aug 2026 00:00:00 GMT

Anthropic 于 2026 年 7 月 14 日发布 Claude for Teachers，向通过身份验证的美国 K-12 教育工作者免费开放 Claude 的高级功能。按照官方目前公布的规则，在 2027 年 6 月 30 日之前完成注册和验证，可以获得一整年的免费使用期。

Important

这不是面向所有地区、所有教师或学生的通用免费套餐。当前资格限定为通过验证的美国 K-12 教育工作者，并且 Claude 的个人使用年龄要求仍为 18 岁以上。

免费计划包含什么#

Claude for Teachers 并不只是一个普通聊天账号。官方介绍的重点包括：

使用 Claude 的高级能力完成备课、课程设计、评估材料和日常行政工作；
通过 Learning Commons 连接美国 50 个州的教学标准与课程资源；
接入教师常用的内容和教学工具；
使用 Claude Code 和 Cowork 处理更完整的项目或自动化工作流；
获取面向课堂实践的培训和教学案例。

Anthropic 表示，学校或学区级方案仍在准备中。目前开放的是教育工作者个人申请，不能把个人免费资格直接当作全校统一部署许可。

申请前要确认的条件#

申请人需要进入官方页面并完成教育工作者身份验证。由于验证方式可能调整，建议直接按照页面提示提交，不要购买所谓“教师认证账号”或借用他人身份材料。

还需要注意两点：

注册截止时间不等于服务结束时间。 在 2027 年 6 月 30 日前完成验证，可获得自资格生效起的一整年免费访问。
免费资格有明确人群限制。 中国用户、非 K-12 教育工作者以及学生目前不在这项官方福利的适用范围内，除非 Anthropic 后续扩大资格。

学校数据能否直接上传#

免费并不代表可以忽略学校的数据管理规则。Anthropic 表示，Claude for Teachers 中的数据不会被用于训练模型，并提供面向 FERPA 要求的 K-12 数据保护协议。不过，教师仍应先遵守所在学校、学区和州的政策。

实际使用时，建议先做到：

不上传学生姓名、联系方式、健康信息或完整成绩记录；
使用匿名化案例测试备课和评估流程；
在学校正式批准前，不把 Claude 当作学生信息系统；
人工复核生成的课程内容、事实和评分建议。

是否值得申请#

如果你符合美国 K-12 教育工作者资格，并且愿意把 AI 用于备课、材料整理或教学工作流，这项计划具有实际价值：官方免费期较长，也包含针对教师场景设计的资源。若不符合资格，不建议绕过验证；可以等待地区扩展、学校方案或使用 Claude 的常规套餐。

参考资料#

Anthropic：Introducing Claude for Teachers

本文依据 Anthropic 官方公告独立整理，不包含代认证、账号交易或推广链接。封面图片来自同一官方公告，版权归 Anthropic 所有，仅用于报道和说明该计划。

Codex 邀请好友与同事指南：入口、奖励条件与常见误区

Wed, 05 Aug 2026 00:00:00 GMT

Codex 的邀请活动不是一个长期固定的“注册送额度”入口。它更像按账号、套餐、工作空间和地区开放的阶段性优惠：有资格时，邀请按钮和当期规则会直接出现在产品内；看不到入口，通常就代表当前账号没有可用活动。

Important

2026 年 6 月 11 日至 6 月 24 日面向部分 Plus、Pro 用户的好友邀请活动已经结束。该期活动允许符合条件的用户邀请最多三位好友，成功后双方获得一次可存入的 Codex 速率限制重置。本文更新于 2026 年 8 月，不把这项历史活动当作当前仍可领取的固定福利。

先看懂三种不同的奖励#

邀请页面可能出现的福利并不总是同一种东西。

名称	实际含义	能否作为 API 余额使用
Codex 使用额度	用于优惠中注明的 Codex 或 ChatGPT 体验	通常不能，除非活动明确说明
速率限制重置	在达到使用上限后，恢复一次相应使用窗口	不能，它不是可转让的余额
临时额外用量	在指定期限或场景内增加可用量	不能，适用范围以活动页面为准

因此，看到“额度”“积分”或“reset”时，不要直接换算成美元，也不要认为它会进入 OpenAI API 账户。最可靠的信息是邀请弹窗中显示的奖励名称、有效期和适用产品。

如何确认自己是否有邀请资格#

打开当前使用的 Codex 客户端并登录 ChatGPT 账号。
点击左下角的个人资料菜单。
个人套餐可能显示 Invite a friend，符合条件的 Business 工作空间成员可能显示 Invite a coworker。
打开邀请弹窗，逐项确认奖励内容、邀请上限、受邀者要求和到期时间。

个人套餐与 Business 工作空间使用不同的资格和奖励规则。ChatGPT Enterprise 目前不提供这类推荐邀请。如果菜单里没有入口，更新客户端、退出后重新登录可以排除本地显示问题；仍然没有入口时，不建议通过第三方链接或切换地区强行参与。

一次有效邀请怎样完成#

正常流程并不复杂：邀请人从产品内输入对方的电子邮箱并发送邀请；受邀者通过官方流程接受邀请，使用符合条件的账号登录或加入指定工作空间，然后完成弹窗要求的 Codex 操作。

这里最容易误解的一点是：发出邀请并不会立刻产生奖励。奖励通常需要同时满足以下条件：

受邀者已经接受邀请；
受邀者的账号、邮箱和所在地区符合当期规则；
如果是工作空间活动，受邀者已按要求加入对应的 ChatGPT Business 工作空间；
受邀者完成了当期指定的 Codex 操作，例如发送第一条符合条件的 Codex 消息；
账号通过必要的资格与反滥用检查。

规则可能要求受邀者此前没有使用过 Codex，或在指定回溯期内没有近期使用记录。已经在用 ChatGPT 不一定会被排除，但是否符合条件仍取决于弹窗中的当期说明。

奖励到账后在哪里看#

如果当期奖励是可存入的速率限制重置，可打开左下角个人资料菜单，进入用量摘要，查找类似 1 reset available 的提示。需要使用时再从这里应用。

这类重置一般应在发放后的 30 天内使用，但具体期限仍以活动页面为准。其他形式的 Codex 额度或临时用量，可能显示在用量页面、工作空间余额或活动指定位置。

为什么没有入口或奖励没有到账#

可以按下面的顺序检查：

确认活动仍有效。 旧教程的发布日期不等于活动有效期，先看自己产品内的邀请弹窗。
核对套餐和工作空间。 个人邀请与 Business 邀请不是同一套规则，管理员也可能关闭工作空间推荐活动。
确认受邀者已完成要求。 只打开邮件、注册 ChatGPT 或安装客户端，未必算完成了符合条件的 Codex 操作。
检查受邀者资格。 已经参加过其他邀请、近期使用过 Codex、邮箱不符合要求或未加入指定工作空间，都可能导致邀请无效。
留出审核时间。 完成操作后仍可能需要经过资格检查；若活动页没有给出处理时间，可保留邀请邮件和页面截图后联系 OpenAI 支持。

如果一个人收到多个邀请，通常只有第一个符合条件的邀请可能计入奖励，重复发送不会叠加收益。

不要用“小号”自邀#

自我邀请、使用邮箱别名绕过资格、在关联设备上做自我推荐、重复兑换或买卖奖励，都可能被判定为滥用。邀请福利也不能转让、出售或兑换现金。

因此，本文不提供批量注册、浏览器环境隔离、设备伪装或自动化领取方法。它们不仅会让奖励失效，也可能影响账号和工作空间的正常使用。

最简判断方法#

把是否能参加活动归纳成三句话即可：

有没有活动： 看 Codex 左下角个人资料菜单是否出现邀请入口。
能拿到什么： 看邀请弹窗，不按第三方文章中的金额或次数推算。
何时到账： 受邀者接受邀请、满足资格并完成指定 Codex 操作之后，才进入发奖和检查流程。

参考资料#

本文依据公开资料重新核验和独立整理，不包含邀请码、返利链接、广告内容或第三方页面图片。活动会随时间调整，实际资格和奖励始终以账号内显示的最新条款为准。

封面图片截取自 OpenAI 官方 Codex App 介绍视频。

Windows 使用 Codex：桌面应用、IDE 扩展与 CLI 安装指南

Wed, 05 Aug 2026 00:00:00 GMT

Windows 上使用 Codex 不只有一种入口。对大多数用户来说，桌面应用最直观；习惯在 VS Code 中写代码，可以使用 IDE 扩展；需要终端操作或脚本自动化时，再选择 Codex CLI。

Note

旧教程中的“Codex 独立桌面应用”已经进入整合阶段。当前新的 ChatGPT 桌面应用在 Windows 和 macOS 上同时包含 Chat、Work 与 Codex；原 Codex 应用更新后也会迁移到新应用。安装前先确认教程发布日期，避免在已经变化的界面中寻找旧入口。

三种方式怎么选#

方式	更适合谁	主要特点
ChatGPT 桌面应用中的 Codex	初次使用、同时管理多个项目的人	图形界面完整，可查看任务、文件修改和终端过程
Codex IDE 扩展	日常在 VS Code、Cursor 或 Windsurf 中编码的人	直接使用已打开的文件和选中代码，便于就地审查修改
Codex CLI	熟悉 PowerShell、需要终端或自动化的人	从项目目录运行，适合命令行工作流和可重复脚本

三种入口可以使用同一个 ChatGPT 账号，但本地记录、当前打开的项目和部分界面功能不一定完全相同。不要把“能用同一账号登录”理解成所有本地聊天都会自动同步。

方案一：安装 ChatGPT 桌面应用#

这是普通 Windows 用户最省事的选择。

从 OpenAI 官方下载页获取 Windows 版本，不使用网盘重打包安装器。
完成安装后打开 ChatGPT，使用自己的 ChatGPT 账号登录。
在左上角的产品切换区域选择 Codex。
添加本机项目文件夹，先让 Codex说明项目结构，再决定是否授权修改和运行命令。

如果电脑里已经安装旧 Codex 应用，优先通过应用自身更新。官方说明显示，更新后原有 Codex 项目和聊天应当保留；重要项目仍建议先提交 Git 或保留独立备份。

安装器跳转商店但无法下载#

Windows 安装过程可能依赖 Microsoft Store 的分发服务。可以依次检查：

Windows Update 与 Microsoft Store Install Service 是否被禁用；
系统时间、时区和 Microsoft Store 登录状态是否正常；
在 Microsoft Store 的“库”页面执行更新后重新尝试；
公司或学校设备是否由管理员限制应用安装。

不建议为绕过商店而下载来源不明的 MSIX、破解包或所谓绿色版。它们既无法确认更新来源，也可能接触本机代码和登录凭据。

方案二：安装 IDE 扩展#

如果主要工作都在编辑器里完成，扩展通常更顺手。

打开 VS Code 或兼容编辑器的扩展市场。
搜索 Codex，核对扩展发布者和官方文档链接后安装。
打开一个真实的项目文件夹，而不是只打开单个代码文件。
点击侧边栏中的 Codex 图标并完成登录。

如果侧边栏没有图标，在命令面板中运行 Codex: Open Codex Sidebar。开始任务前先建立 Git 提交点；完成后查看 diff，再决定保留哪些修改。

扩展适合解释当前文件、修改选中代码和快速审查。如果任务涉及多个仓库、长时间运行或频繁查看终端过程，桌面应用通常更容易管理。

方案三：安装 Codex CLI#

CLI 适合已经熟悉 PowerShell 和 Node.js 工具链的用户。安装 Node.js 的受支持版本后，在 PowerShell 中运行：

Terminal window

1
npm install -g @openai/codex
2
codex --version

然后进入项目目录并启动：

Terminal window

1
cd D:\Projects\your-project
2
codex

首次运行时按提示选择使用 ChatGPT 登录或其他可用的认证方式。使用 ChatGPT 登录会使用对应套餐或工作空间的 Codex 权益；使用 API Key 则属于单独的 API 计费路径，不能因为已经订阅 ChatGPT 就默认免费。

如果输入 codex 提示找不到命令，关闭并重新打开 PowerShell，然后检查 Node.js 与 npm 的全局命令目录是否已经加入 PATH。不必反复卸载项目或删除个人配置。

登录失败时怎样排查#

先记录完整错误信息，再按下面的顺序处理：

确认账号可以正常登录 ChatGPT 官网。 网页端也无法登录时，先处理账号或服务状态问题。
使用原来的登录方式。 通过 Google、Microsoft、Apple 或邮箱创建的账号，登录时应选择对应方式，避免身份提供方不一致。
更新客户端或扩展。 旧版本可能无法正确完成浏览器回调。
检查系统时间和默认浏览器。 时间偏差、浏览器阻止回调或企业安全软件拦截，都可能让授权状态失效。
核对官方支持地区。 遇到地区限制时，应以 OpenAI 支持范围为准，不采用来路不明的代理、共享账号或接码服务规避规则。
查看服务状态。 多台设备同时失败时，先检查 OpenAI Status，避免把服务故障误判为本机问题。

第一次使用前的安全设置#

从一个已经使用 Git 管理、且不含生产密钥的测试项目开始。
先让 Codex只读分析，再逐步开放写入或命令执行权限。
.env、私钥、管理员密码和客户数据不要直接粘贴进聊天。
对安装依赖、删除文件、发布网站等操作保留人工确认。
修改结束后检查 diff，并运行项目原有的测试和构建命令。

工具能打开并不代表环境已经配置完成。一次可靠的首次使用，至少应该包括：成功读取项目、完成一项小修改、检查变更、运行验证，以及确认可以用 Git 回退。

参考资料#

本文根据当前官方资料重新组织和独立撰写，不包含充值广告、账号交易、接码服务、推广链接或第三方教程图片。软件入口和界面仍会变化，下载与登录步骤应以 OpenAI 官方页面为准。

封面图片：Jantine Doornbos / Unsplash。

GPT-5.6 正式发布：Sol、Terra、Luna 应该怎么选

Wed, 05 Aug 2026 00:00:00 GMT

OpenAI 于 2026 年 7 月 9 日发布 GPT-5.6。与只推出一个通用模型不同，这次更新同时给出了 Sol、Terra 和 Luna 三种定位，覆盖 ChatGPT、Codex 与 OpenAI API。三者的主要差别不是“新旧版本”，而是能力、速度、成本和任务复杂度之间的取舍。

三个模型分别适合什么#

模型	官方定位	更适合的任务
GPT-5.6 Sol	系列中能力最高的旗舰模型	复杂研究、开放式问题、长流程编程、需要高完成度的专业交付
GPT-5.6 Terra	日常工作的平衡选择	常规推理、文档处理、工具调用、软件开发与多数知识工作
GPT-5.6 Luna	更快、更经济的轻量选择	指令明确、重复性强、调用量大、便于自动校验的任务

对大多数个人用户和小团队，Terra 更适合作为默认模型。它在速度与任务完成度之间更均衡；只有当问题确实复杂、返工成本很高时，再切换到 Sol。批量分类、结构化提取或固定格式生成，则可以优先测试 Luna。

在 ChatGPT 和 Codex 中有什么变化#

GPT-5.6 系列已经进入 ChatGPT、Codex 和 API，但不同套餐能看到的模型、推理强度和使用上限并不完全相同。产品界面会根据套餐显示可用选项，因此不应只按照其他账号的截图判断自己的权限。

在 Codex 中，模型名称之外还要考虑推理强度。官方建议从能够完成任务的最低强度开始：普通修改先用 Terra 的常规强度，复杂架构、模糊需求或高风险改动再提高强度或选择 Sol。推理强度越高，通常等待时间和用量也越高。

开发者如何选择#

把模型选择写进固定规则，比让团队成员凭感觉切换更可靠：

用一组真实任务建立小型评测集，包括正确率、响应时间和单次成本。
先以 Terra 作为基线，确认质量是否达到上线要求。
仅把复杂且价值较高的请求升级到 Sol。
将格式明确、可自动验收的高频请求下放给 Luna。
上线前确认 API 返回的实际模型标识、速率限制和价格，不沿用旧教程中的参数。

这种分层方式的重点不是始终选择最强模型，而是把较高成本留给真正需要它的请求。

对第三方 API 服务意味着什么#

OpenAI 发布新模型，不等于所有第三方 API 服务会在同一天开放。模型是否可用，还取决于上游账号权限、服务端适配、额度和稳定性测试。使用中转服务时，应以该服务实际返回的模型列表和公告为准，并先用测试请求确认参数兼容性。

此外，新模型发布初期的名称、价格和套餐限制仍可能调整。正式接入业务时，最好避免把价格或模型名写死在前端，让服务端配置可以单独更新。

参考资料#

本文根据 OpenAI 官方资料独立整理，未引用发布会宣传稿以外的二手评测。封面标识来自 Wikimedia Commons 的 OpenAI 标识文件；商标及品牌权利归原权利方所有。

网站证书域名不匹配：如何判断是服务器问题还是代理分流问题

Mon, 03 Aug 2026 00:00:00 GMT

浏览器提示“请求的主机与 TLS 证书中的主题备用名称（SAN）不匹配”，通常意味着当前连接收到的证书不适用于正在访问的域名。原因可能在服务器、DNS、CDN 配置或本地代理链路，不能仅凭错误页面判断故障位置。

本文记录一种较容易误判的情况：域名和 Cloudflare Worker 均配置正常，但本地代理将请求送往了另一条 CDN 路径，最终返回了不属于目标域名的证书。

现象与结论#

故障环境中出现了以下差异：

通过系统代理访问时，页面显示 Fastly 路由错误和证书 SAN 不匹配；
绕过代理直接访问时，网站返回 200 OK，响应头中的服务器为 Cloudflare；
直连取得的证书包含目标域名，而代理链路取得的证书指纹不同；
本机代理端口由 Xray 进程监听。

这些证据表明，请求在到达 Cloudflare Worker 之前已经被代理链路改道。Fastly 的文档也将请求主机名与证书 SAN 不一致列为路由错误的一种表现。

第一步：核对 DNS#

先分别查询系统 DNS 和公共 DNS。以下命令适用于 Windows PowerShell：

Terminal window

1
Resolve-DnsName blog.monetlabs.art -Type A
2
Resolve-DnsName blog.monetlabs.art -Server 1.1.1.1 -Type A
3
Resolve-DnsName blog.monetlabs.art -Server 8.8.8.8 -Type A

如果公共 DNS 和权威 DNS 都指向预期平台，而只有本机结果不同，问题更可能位于本机 DNS 缓存、代理 DNS 或网络服务商的解析链路。

对于 Cloudflare Worker 自定义域名，Cloudflare 会创建相应的 DNS 记录并签发证书。自定义域名状态正常时，不宜在缺少其他证据的情况下反复删除证书或重建 Worker。

第二步：对比直连与代理结果#

在设置了 HTTP_PROXY 或 HTTPS_PROXY 的终端中，普通 curl 通常会沿用代理：

Terminal window

1
curl.exe -I https://blog.monetlabs.art/

可以使用 --noproxy 做一次仅用于诊断的直连对比：

Terminal window

1
curl.exe --noproxy "*" -I https://blog.monetlabs.art/

若普通请求失败，而直连请求返回 200，应优先检查代理节点、路由规则和代理 DNS。若两种方式都失败，则仍需继续检查服务端证书、Cloudflare 自定义域名状态和权威 DNS。

第三步：确认代理来源#

环境变量和 Windows 系统代理可以分别检查：

Terminal window

1
Get-ChildItem Env: | Where-Object Name -Match '^(HTTP|HTTPS|ALL|NO)_PROXY$'
2
netsh winhttp show proxy
3
Get-ItemProperty 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' |
4
  Select-Object ProxyEnable, ProxyServer, ProxyOverride

如果代理地址是本机端口，还可以确认监听该端口的进程：

Terminal window

1
$connection = Get-NetTCPConnection -LocalPort 10808 -State Listen
2
Get-Process -Id $connection.OwningProcess

端口号需要替换为实际代理端口。进程信息只能说明流量由哪个客户端接管，最终仍需结合客户端日志和路由规则确认具体出口。

处理方法#

确认“直连正常、代理异常”后，可以按影响范围选择处理方式：

在代理客户端中为目标域名设置 direct 规则；
将规则放在会匹配该域名的通用代理规则之前；
或在系统代理绕过列表中加入目标域名及其子域名；
重新打开浏览器标签页，避免复用旧的 TLS 连接；
再次核对状态码、响应平台和证书 SAN。

v2rayN 的路由规则按顺序匹配，前面的规则命中后，后续规则不再生效。因此，新增的域名直连规则需要放在更宽泛的代理规则之前。

不建议采用的处理#

不应关闭浏览器的证书校验来绕过错误；
不应因为看到 Fastly 错误页，就直接认定网站部署在 Fastly；
不应在权威 DNS 和直连证书均正常时反复重建 Cloudflare Worker；
不应只清理浏览器缓存，而忽略代理客户端自身的 DNS 和路由缓存。

验证清单#

处理完成后，至少确认以下结果：

系统 DNS 与公共 DNS 的结果一致；
浏览器不再显示证书警告；
证书 SAN 包含正在访问的完整域名；
首页和主要页面返回预期状态码；
开启代理和关闭代理时均能到达预期平台。

参考资料#

封面图片：Kevin Ache / Unsplash。

STapi API 接入快速开始

Sun, 02 Aug 2026 00:00:00 GMT

本文介绍一套不依赖特定客户端的基础接入方法。页面名称和可用模型可能调整，相关信息以 STapi 中转站的实际显示为准。

1. 为当前设备创建独立密钥#

登录中转站后，可按设备、成员或用途分别创建 API Key。独立密钥便于统计用量，也便于在异常情况下单独撤销。

建议按用途命名，例如：

personal-mac
windows-test
team-member-a
automation-readonly

密钥创建后应保存在密码管理器等安全位置。公开文档和截图中可使用 sk-your-key 作为占位符，避免出现真实值。

2. 确认接口地址与模型#

OpenAI 兼容客户端通常需要两个参数：

1
Base URL: https://api.monetlabs.art/v1
2
API Key:  sk-your-key

模型参数需要使用中转站当前提供的模型标识，可从管理页面或模型列表中确认。

Note

有些客户端会自动在地址后追加 /v1。如果客户端文档要求填写“根地址”，应避免最终出现 /v1/v1。

3. 查询可用模型#

可先通过终端环境变量临时提供密钥，减少密钥被写入项目文件的风险。需要注意，直接输入的赋值命令仍可能保存在终端历史中，因此不应在共享设备或录屏环境中操作。

PowerShellmacOS / Linux

Terminal window

1
$env:STAPI_API_KEY = "sk-your-key"

Terminal window

1
export STAPI_API_KEY="sk-your-key"

使用当前密钥查询模型列表：

PowerShellmacOS / Linux

Terminal window

1
Invoke-RestMethod `
2
  -Uri "https://api.monetlabs.art/v1/models" `
3
  -Headers @{ Authorization = "Bearer $env:STAPI_API_KEY" }

Terminal window

1
curl https://api.monetlabs.art/v1/models \
2
  -H "Authorization: Bearer $STAPI_API_KEY"

请求成功时会返回该密钥当前可访问的模型。后续请求中的 model 参数应采用列表中的模型标识，而不是根据展示名称推测。

4. 发送基础请求#

以下请求用于验证聊天补全端点。your-model-id 需要替换为模型列表中实际返回的标识。

PowerShellmacOS / Linux

Terminal window

1
$headers = @{ Authorization = "Bearer $env:STAPI_API_KEY" }
2
$body = @{
3
  model = "your-model-id"
4
  messages = @(
5
    @{ role = "user"; content = "只回复 OK" }
6
  )
7
} | ConvertTo-Json -Depth 4
8

9
Invoke-RestMethod `
10
  -Uri "https://api.monetlabs.art/v1/chat/completions" `
11
  -Method Post `
12
  -Headers $headers `
13
  -ContentType "application/json" `
14
  -Body $body

Terminal window

1
curl https://api.monetlabs.art/v1/chat/completions \
2
  -H "Authorization: Bearer $STAPI_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "model": "your-model-id",
6
    "messages": [{"role": "user", "content": "只回复 OK"}]
7
  }'

5. 配置实际客户端#

基础请求通过后，可将相同的 Base URL、API Key 和模型标识填入兼容客户端。分阶段验证有助于区分接口连接问题和客户端配置问题。

常见错误的排查顺序#

401 或 403#

检查密钥前后是否多了空格。
确认请求头是 Authorization: Bearer ...。
确认密钥仍启用，且属于当前账号。
立即撤销任何曾出现在截图、聊天或仓库里的密钥。

404 或模型不存在#

检查 Base URL 是否重复了 /v1。
从站点复制模型标识，避免使用展示名称代替。
确认客户端调用的是兼容端点。

429#

这类响应通常与额度、并发或上游限速有关。可降低并发和重试频率，并检查账户可用额度与站点公告。连续、无间隔的重试可能进一步触发限速。

连接超时#

可分别检查浏览器访问、最小 curl 请求及其他网络环境的结果，再根据差异排查本地代理、DNS、防火墙或跨境链路。

验证结果#

若模型列表、基础请求和实际客户端均能正常返回，且密钥未写入项目文件、控制台中可以识别其用途，则基本接入配置已经生效。

API Key 安全清单：创建、保存、共享与撤销

Sat, 01 Aug 2026 00:00:00 GMT

API Key 是用于调用服务的访问凭证。获得密钥的一方通常可以使用其关联的额度和权限，因此密钥需要按照敏感凭证进行管理。

创建时#

每个成员、设备和自动化任务使用独立密钥。
名称应能反映用途，避免使用“test1”“new-key”等难以追踪的名称。
能限制额度、模型或有效期时，按实际需要设置最小范围。
管理员密钥只用于管理，不放进普通客户端。

保存时#

优先放在系统钥匙串、密码管理器、密钥服务或本机环境变量中。不要直接写入：

Git 仓库和提交记录；
Markdown 文档、截图与录屏；
浏览器收藏夹备注；
团队公共群聊；
前端 JavaScript 或静态网页。

项目需要本地环境文件时，至少确认它已经写进 .gitignore：

1
.env
2
.env.*
3
!.env.example

示例文件只保留变量名：

1
STAPI_BASE_URL=https://api.monetlabs.art/v1
2
STAPI_API_KEY=

共享时#

团队成员宜使用各自独立的密钥，以便将用量统计和撤销操作对应到具体成员。

确需临时传递凭证时，应使用具备访问控制和过期机制的安全通道，并在传递完成后轮换。账号、密码、2FA 恢复码和 API Key 不宜在同一条消息中发送。

日志与截图#

排查问题前，先检查这些位置是否会暴露密钥：

请求头中的 Authorization；
终端历史记录；
应用错误日志；
网络抓包文件；
浏览器开发者工具截图。

展示时只保留前后少量字符，例如 sk-abcd…wxyz，并确认完整值无法通过页面源码或附件恢复。

怀疑泄露时#

按以下顺序处理：

立即撤销原密钥，不要只修改本地配置。
创建新密钥，并只更新确实需要的设备。
检查异常请求、额度消耗和相关日志。
找到泄露渠道，清理公开文件和历史记录。
如果进入过 Git 历史，仅删除当前文件不够，还要轮换密钥。

Important

删除本地保存的密钥不会使其自动失效。阻断后续调用需要在服务端撤销或轮换密钥。

每月一次的小团队检查#

删除不再使用的成员和设备密钥；
核对额度与并发是否符合用途；
抽查仓库、文档和日志是否有明文凭证；
确认管理员账号的 2FA 和恢复方式可用；
记录最后一次轮换日期。

定期检查有助于明确密钥的实际使用者，并缩小单个密钥泄露时的影响范围。

封面图片：Vanna Phon / Unsplash。

Perplexity Education Pro 学生优惠：认证流程、价格与注意事项

Wed, 22 Jul 2026 00:00:00 GMT

Perplexity 的 Education Pro 是面向通过验证的学生和教育工作者的折扣计划。官方帮助中心在 2026 年 7 月 22 日列出的价格为 每月 10 美元，身份验证由 SheerID 完成。

Important

Education Pro 是优惠订阅，不是免费套餐。能否申请取决于所在国家、学校和 SheerID 的验证结果，不能仅凭学生邮箱保证通过。

Education Pro 包含什么#

按照 Perplexity 当前帮助中心的说明，Education Pro 包含普通 Pro 的主要能力，并增加面向学习场景的提示和引导。列出的权益包括：

Perplexity Computer 和 Learn Mode；
Pro Searches、Research 等高级搜索能力；
文件与图片上传；
高级模型和图片生成功能；
面向学生、教师的学习提示与优先支持。

这些权益属于 Perplexity 网页和应用订阅，不包含可供程序调用的 API 额度。开发者使用 Perplexity API 仍需要单独充值和计费。

官方视频中的验证流程#

Perplexity 帮助中心附带了两段由官方支持频道发布的操作视频：一段展示现有账号的升级流程，另一段展示学生进入 Comet 学生页面的流程。综合页面与视频，基本步骤如下：

使用个人邮箱或学校邮箱创建、登录 Perplexity 账号；
点击左下角的升级入口；
切换到 Education 计划并选择“Verify as student”；
在 SheerID 页面选择国家和学校，提交要求的身份信息；
验证通过后，回到 Perplexity 确认套餐和实际价格再付款。

官方说明并不强制使用学校邮箱，但身份材料、学校名单和地区支持仍由 SheerID 判断。

常见问题#

学校不在列表中#

不要选择名称相近的其他学校。可以通过 SheerID 支持页面申请添加所在机构，等待审核后再验证。

提示正在使用 VPN#

帮助中心建议先清理缓存并重新验证；仍然失败时联系 SheerID。验证期间关闭代理或 VPN 通常也有助于避免地区和网络出口不一致。

能否换到另一个账号#

学生优惠不能直接转移到其他邮箱。更换 Perplexity 账号后，需要重新通过 SheerID 验证。

数据是否默认不参与训练#

Education Pro、Pro 和 Max 用户可以在设置中选择退出数据收集；它与企业套餐“默认不用于模型训练”的承诺并不相同。上传论文、未公开研究或个人信息前，仍应检查隐私设置并进行脱敏。

付款前检查#

确认页面最终显示的是 Education Pro 和每月 10 美元，而不是普通 Pro；
查看税费、币种以及是否自动续订；
记录下一次扣费日期；
不向第三方提供 SheerID 材料，也不要购买代认证服务；
如果只是偶尔搜索，先比较免费套餐是否已经够用。

参考资料与视频#

本文依据 Perplexity 官方帮助中心和官方支持视频独立整理，不提供代认证、共享账号或返利链接。封面截取自官方验证视频，版权归原权利方所有，仅用于流程说明。

Gemini API 托管代理更新：后台任务、远程 MCP 与凭证刷新

Tue, 07 Jul 2026 00:00:00 GMT

Google 在 2026 年 7 月 7 日为 Gemini API 的 Managed Agents 增加了一组面向长任务和外部工具的新能力，包括后台执行、远程 MCP 服务器、自定义函数调用以及运行期间的凭证刷新。

Managed Agents 通过 Interactions API 工作。应用提交一项任务后，Google 可以在隔离的远程环境中完成推理、代码执行、软件包安装、文件管理和网络访问，再返回任务过程与最终结果。

四项更新分别解决什么#

后台执行#

长任务不再需要一直维持 HTTP 连接。请求设置为后台运行后，接口会立即返回任务 ID；客户端可以轮询状态、读取进度，或稍后重新连接。这更适合代码分析、资料整理和批量文件处理。

远程 MCP#

托管代理可以连接获得授权的远程 MCP 服务器，在隔离环境中使用企业内部工具。这样可以减少为每个数据源编写专用代理层的工作，但不代表所有 Gemini 模型都已经支持远程 MCP，接入前仍要检查具体模型和代理的兼容表。

自定义函数#

内置的搜索和代码执行工具可以在服务端完成；遇到业务系统的自定义函数时，任务会进入等待状态，由客户端执行本地逻辑，再把结果送回代理。付款、发信、删除数据等高影响操作适合放在这一层保留人工确认。

凭证刷新#

短期访问令牌过期后，可以在保留原有远程环境和文件状态的情况下更新网络凭证。这样不必因为密钥轮换而重新运行整项任务。

数据保存需要单独注意#

当前 Interactions API 默认保存交互，以支持后台任务、服务端上下文和过程追踪。Google 文档列出的默认保留期为：付费层 55 天，免费层 1 天；付费项目可以在 AI Studio 中选择更短的 7、14、28 或 55 天窗口，也可以通过 API 删除记录。

如果设置 store=false，可以改为无状态方式，但后台执行和通过 previous_interaction_id 延续对话将不可用。处理客户数据或内部代码前，需要先根据业务合规要求决定是否允许服务端保存。

上线前的实际检查#

为远程网络访问设置明确的域名白名单；
给每个 MCP 工具分配最小权限和短期凭证；
为任务设置最大运行时间、预算和失败重试次数；
对外部写入操作增加客户端审批；
保存任务 ID和环境 ID，但不要把 API Key 写进日志；
使用一组真实任务测试成本、正确率和中断恢复。

托管环境减少了自建代理执行器的基础设施工作，但权限、数据保留和费用控制仍由应用方负责。它更适合边界清楚、可以追踪和验收的工作流，不适合直接获得无限制的生产权限。

参考资料#

本文依据 Google 官方公告和开发文档独立整理。封面图片来自 Google 官方公告，版权归 Google 所有，仅用于报道和技术说明。

Gemini 个性化图片功能免费扩展：它会怎样使用 Google Photos

Mon, 29 Jun 2026 00:00:00 GMT

Google 在 2026 年 6 月 29 日宣布，将 Gemini 中基于 Personal Intelligence 的个性化图片生成免费开放给更多符合条件的美国用户。启用后，Gemini 可以在获得许可的情况下参考 Google Photos、Gmail、YouTube、搜索记录和过去的对话，生成更贴近个人经历与偏好的图片。

Important

这项免费扩展目前不是全球福利。Personal Intelligence 图片功能仅面向美国境内、年满 18 岁并使用个人 Google 账号的符合条件用户；Google Photos 连接功能在美国部分地区也可能暂不可用。

它和普通图片生成有什么区别#

普通图片生成依靠当前提示词和用户主动上传的参考图。Personal Intelligence 可以在用户授权后，从已连接的 Google 服务中寻找相关背景。例如：

根据 Google Photos 中已经标记的人物与宠物，制作家庭主题插画；
参考过去的对话和兴趣，设计“我理想中的房子”；
结合照片与文字偏好，生成特定画风的个人头像或纪念图。

核心变化是减少重复上传和描述，但同时也意味着更多个人数据可能参与当前生成流程。

如何开启#

在 Gemini 网页版中，可以进入“设置与帮助 → Personal Intelligence → Connected Apps”，再选择是否连接 Google Photos。连接属于主动选择，不开启也可以继续使用普通的 Nano Banana 图片生成功能。

Google 帮助中心目前说明：未订阅 Google AI 计划的用户可以下载 1K 输出，付费计划可下载 2K；Nano Banana Pro 的重新生成功能仍属于付费能力。因此，“个性化图片免费”并不代表所有高级图片功能和更高额度全部免费。

开启前需要考虑什么#

只连接确实需要的 Google 应用，不必一次全部开启；
检查 Google Photos 中的人脸分组、共享相册和敏感照片；
发布生成结果前，确认没有暴露他人的肖像或私人信息；
不把生成结果视为真实照片、身份材料或事实证据；
以后不再使用时，可以在 Connected Apps 中关闭对应连接。

对中国地区用户而言，当前最重要的信息是功能范围仍受地区和账号资格限制。不要因为看到“免费”就购买所谓美国区账号，也不建议借用他人的个人 Google 账号绕过条件。

参考资料#

本文依据 Google 官方公告与帮助中心独立整理。封面图片来自 Google 官方公告，版权归 Google 所有，仅用于报道和功能说明。

Claude Tag 进入 Slack：把 AI 从个人聊天变成团队成员

Tue, 23 Jun 2026 00:00:00 GMT

Anthropic 在 2026 年 6 月 23 日发布 Claude Tag。它不是把普通聊天窗口简单搬进 Slack，而是让同一个频道里的成员共同使用一个 Claude：团队可以通过 @Claude 分配任务，让它读取获得授权的频道上下文、调用连接的工具，并在 Slack 线程中交付结果。

Claude Tag 发布时处于测试阶段，面向 Claude Team 和 Enterprise 客户开放，并取代原有的 Claude in Slack 应用。个人免费账号不能仅靠安装 Slack 应用获得同样的能力。

和个人聊天有什么不同#

官方将它的工作方式概括为四个方向：

多人协作： 频道成员可以看到同一项任务的进度，并从其他人的对话位置继续；
积累上下文： Claude 可以记住被授权频道中的相关信息，减少反复解释项目背景；
主动提醒： 启用 ambient 行为后，它可以提示跨频道的重要变化，或追踪长时间没有解决的事项；
异步执行： 任务可以在后台运行数小时或数天，也可以安排以后执行。

这让 Claude 更接近一个共享的任务执行者，而不是只属于某个人的问答机器人。Anthropic 表示，其内部版本已经被产品团队用于编程、指标分析、客户支持和故障排查；这些数据属于公司自述，不能直接等同于其他团队的实际效果。

管理员需要先处理什么#

这类能力真正的难点不是“能不能回答”，而是“能看到什么、能执行什么”。Claude Tag 为管理员提供了几项关键控制：

指定允许接入的 Slack 频道、工具、数据源和代码库；
按用途建立隔离的 Claude 身份，使销售和工程等团队的记忆互不流通；
设置组织级和频道级的月度用量上限；
查看任务日志以及每项任务的发起人；
先在私有测试频道验证权限，再逐步扩大范围。

官方说明 Claude 不会把私有频道的内容报告到其他频道，但管理员仍应按照最小权限原则配置。涉及客户信息、密钥、财务数据或生产操作时，不能只依赖模型自行判断敏感程度。

小团队是否值得启用#

如果团队的工作本来就集中在 Slack，而且有清晰的数据权限、任务审批和费用预算，Claude Tag 可以减少在聊天工具、工单系统和代码环境之间切换的次数。若团队没有统一的权限管理，或者成员习惯把密码和客户数据直接发进频道，那么先完善流程比接入代理更重要。

比较稳妥的试用范围是：只连接一个测试频道和只读数据源，选择能够人工验收的任务，运行一到两周后再检查调用成本、错误率和节省的时间。

参考资料#

本文根据 Anthropic 官方公告独立整理。封面图片来自官方产品演示素材，版权归 Anthropic 所有，仅用于报道和功能说明。

石头的知识库

欢迎来到石头的知识库

内容范围#

站点与服务#

安全提醒#

推荐阅读#

Claude for Teachers 上线：美国 K-12 教师可免费使用一年

免费计划包含什么#

申请前要确认的条件#

学校数据能否直接上传#

是否值得申请#

参考资料#

Codex 邀请好友与同事指南：入口、奖励条件与常见误区

先看懂三种不同的奖励#

如何确认自己是否有邀请资格#

一次有效邀请怎样完成#

奖励到账后在哪里看#

为什么没有入口或奖励没有到账#

不要用“小号”自邀#

最简判断方法#

参考资料#

Windows 使用 Codex：桌面应用、IDE 扩展与 CLI 安装指南

三种方式怎么选#

方案一：安装 ChatGPT 桌面应用#

安装器跳转商店但无法下载#

方案二：安装 IDE 扩展#

方案三：安装 Codex CLI#

登录失败时怎样排查#

第一次使用前的安全设置#

参考资料#

GPT-5.6 正式发布：Sol、Terra、Luna 应该怎么选

三个模型分别适合什么#

在 ChatGPT 和 Codex 中有什么变化#

开发者如何选择#

对第三方 API 服务意味着什么#

参考资料#

网站证书域名不匹配：如何判断是服务器问题还是代理分流问题

现象与结论#

第一步：核对 DNS#

第二步：对比直连与代理结果#

第三步：确认代理来源#

处理方法#

不建议采用的处理#

验证清单#

参考资料#

STapi API 接入快速开始

1. 为当前设备创建独立密钥#

2. 确认接口地址与模型#

3. 查询可用模型#

4. 发送基础请求#

5. 配置实际客户端#

常见错误的排查顺序#

401 或 403#

404 或模型不存在#

429#

连接超时#

验证结果#

API Key 安全清单：创建、保存、共享与撤销

创建时#

保存时#

共享时#

日志与截图#

怀疑泄露时#

每月一次的小团队检查#

Perplexity Education Pro 学生优惠：认证流程、价格与注意事项

Education Pro 包含什么#

官方视频中的验证流程#

常见问题#

学校不在列表中#

提示正在使用 VPN#

能否换到另一个账号#

数据是否默认不参与训练#

付款前检查#

参考资料与视频#

Gemini API 托管代理更新：后台任务、远程 MCP 与凭证刷新

四项更新分别解决什么#

后台执行#

远程 MCP#

自定义函数#

凭证刷新#