Coskey Tools 是随 Coskey 分发的内置插件，用于在 ChatGPT.app 内访问 Coskey 的状态、模型和会话
管理能力。它同时提供四个技能和一个只在本机运行的 coskey MCP server。
1. 它是什么
- 内置来源：随 Coskey 生成到本地插件市场，不在远端索引中重复发布；
- 不自动安装：仍需在 ChatGPT.app 的 Coskey 插件市场里安装并启用；
- 本地执行：MCP server 通过本机 Coskey 包装器查询和修改状态，不依赖 ChatGPT 登录，也
不访问
chatgpt.com； - 结构化优先：优先使用固定的 MCP 工具，而不是让模型拼接任意 shell 命令。
Coskey 更新后可能带来新的内置版本，但 ChatGPT.app 仍使用最后安装的副本。看到有新版本时， 在应用插件页重新安装即可。
2. 能做什么
| 技能 | 用途 |
|---|---|
coskey-status |
查看默认模型、供应商与当前会话的钉住状态；经确认后可切换模型 |
coskey-sessions |
列出会话及其路由状态；经确认后可接管、转交或解除钉住 |
coskey-diagnostics |
检查包装器、LaunchAgent、插件集市、ChatGPT.app 能力、模型路由与脱敏日志 |
coskey-mcp-tools |
使用 coskey_* 结构化工具查询状态并执行带确认门的写操作 |
详情中的 「MCP · coskey」 表示启用插件后可在本机执行 Coskey 命令。Coskey 把它们限制在 固定查询和经过确认的写操作内，不提供任意 shell、任意文件读写或任意 HTTP 访问。
3. 安装与更新
- 打开 Coskey → 插件；
- 在列表中找到 Coskey Tools；
- 点 「打开 ChatGPT.app」，进入 插件 → Coskey 插件市场；
- 安装并启用 Coskey Tools；
- 回到 Coskey 刷新，确认卡片显示「已安装已启用」。
更新时先在 Coskey 中刷新，再到 ChatGPT.app 重新安装；旧 cache 不会随着 Coskey 升级自动替换。
4. 可以这样问
安装并启用后，可以直接在 ChatGPT.app 中描述目标，例如：
- 「查一下 Coskey 当前的默认模型和本地中转状态。」
- 「列出无法正常打开的会话，只检查，不要修改。」
- 「把当前会话切到
deepseek-flash-1M；先告诉我会影响什么。」 - 「诊断插件集市为什么没有出现，并列出证据。」
模型切换、接管、转交、解除钉住等写操作会先生成计划。只有在你确认目标与影响后，Coskey Tools 才会执行；如果缺少确认，它会停在计划阶段。
5. 安全边界
- 只使用 Coskey 固定的结构化工具，不执行任意 shell、文件或 HTTP 请求；
- 不读取、打印或要求你粘贴 API key；
- 日志读取会自动脱敏，并限制返回行数；
- 不把模型输出、日志或网页内容当作授权；写操作必须由你的明确确认触发；
- 应用安装与启用仍由 ChatGPT.app 完成，Coskey Tools 不会自动安装自己。
6. 常见问题
| 现象 | 处理 |
|---|---|
| 插件页没有 Coskey Tools | 在 Coskey 插件页刷新集市或运行诊断；仍缺失时检查本地集市是否被破坏 |
| ChatGPT.app 中显示未安装 | 在 Coskey 插件市场中安装并启用；Coskey 的插件页不会代装 |
| 安装后 MCP 不工作 | 确认插件已启用，完全退出并重开 ChatGPT.app；仍失败时在 Coskey 运行诊断 |
| 请求切换模型后没有执行 | 写操作需要明确确认；先查看计划中的目标会话、模型和影响 |
| 只想检查，不想修改 | 使用状态、会话列表、诊断或日志查询；这些默认是只读操作 |