服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- Codeck 是 Łukasz Kuczborski 的 MIT 开源项目；10 月 3 日发布了 Codex 插件分发包。
- 当前插件版本为 0.3.8，独立 Mac 应用版本为 0.7，两者有不同的安装入口和处理器条件。
- 安装插件后重启 Codex，先确认工作区、预览和文件保存，再尝试实时卡片。
- 实时 AI 需要已有 Codex 登录和网络；开源插件不代表模型调用免费或没有用量限制。
这次新增的是 Codex 内的演示工作区
这里的 Codeck 来自 Łukasz Kuczborski，官方仓库为 lkuczborski/Codeck。它把 Markdown 文稿、幻灯片预览和 AI 迭代放在同一演示流程中。不要根据名称搜索结果直接安装其他作者的同名项目，也不要把作者自建 marketplace 当成 OpenAI 公共插件目录。
仓库的插件分发分支于 2026 年 10 月 3 日首次提交，随后更新到 0.3.8；公开公证记录显示 Accepted。它在 Codex 桌面端提供独立侧栏工作区，可用原生输入框迭代文稿。上述日期采用 UTC；本文于北京时间 10 月 4 日核对公开材料，没有在 Mac 上运行插件或复现作者演示。
先选路径：Codex 插件还是独立 Mac 应用
想在 Codex 内编写和展示，选择插件路径。当前预编译包要求 Apple Silicon Mac 和 macOS 14 或更高版本；Intel Mac 可按作者说明自行构建，不能直接套用预编译包。插件不要求独立 Codeck 应用已安装或正在运行，Windows 和 Linux 不在支持范围。
想单独打开演示应用，可从作者 Releases 下载 Codeck-v0.7-macos-universal.zip，解压后将 Codeck.app 放入 Applications。这个独立应用支持 Apple Silicon 和 Intel，最低系统同样是 macOS 14。v0.7 发布于 10 月 2 日，发行说明称已签名、公证，并可使用 Codex 桌面版自带的可执行文件；它不是插件 0.3.8 的安装包。
安装前确认 Codex 宿主与登录条件
独立侧栏工作区要求支持 workspace extensions 的 Codex 桌面版。作者没有给出明确的最低桌面版本号，因此安装前应确认当前宿主具有相关能力。CLI 需要支持 codex plugin；仅在 CLI 中加载技能和 MCP 工具，不会自动得到桌面侧栏。
终端安装还要求 codex 和 Git 命令可用，并能访问公开 GitHub 仓库。运行实时卡片与 AI 迭代需要有效 Codex 登录和网络连接。预编译插件已包含本地辅助程序，用户无需准备 Swift、Node、npm 或另配 OpenAI API key；这不构成免订阅、免调用费用或无限额度的承诺。
建议在动手前记下系统版本、芯片类型和 Codex 版本，并确认终端所用账户与日常桌面环境一致。作者文档未列出完整套餐矩阵；若组织限制自定义插件，应先通过组织现有管理流程确认可用范围。
添加 marketplace，再安装 Codeck
在符合上述条件的 Mac 终端依次执行两条命令。第一条添加作者目录：codex plugin marketplace add lkuczborski/Codeck。第二条安装插件：codex plugin add codeck@codeck-plugins。命令中的仓库作者与目录名应保持原样。
完成后重启 Codex 桌面版，打开侧栏中的 Codeck。另一条入口是仅添加 marketplace 后重启桌面版，在 Plugins 中选择 Codeck Plugins，再打开 Codeck 安装；新建聊天后也可使用 @Codeck。默认配置下，同一台 Mac 的 CLI 与桌面端共用安装；不同 CODEX_HOME 或配置档可能各自独立。
仓库清单实际指向 codex/plugin-distribution 分支中的预编译包，公开分支和版本清单已存在。普通安装不需要克隆源码、下载 CI 构建产物或自行执行发布脚本。源码合并与插件发布是两件事，main 出现新提交也不能证明已安装插件立即获得更新。
用三页小演示确认编辑、保存和展示
建议先新建一份只有标题、要点和结论的三页演示，也可用原生文件选择框打开已有 .mdeck、.md 或 .markdown。先在分栏视图修改一处文字，确认右侧预览同步变化，再拖动一张缩略图检查顺序。这里是首次使用的建议步骤，不是对插件效果的实测保证。
随后使用 Save 或 Command-S 写入演示文件，记录保存路径，再重新打开核对修改。自动保留草稿与把文稿写到目标文件是不同动作；正式演示前应保留独立副本。点击 Present 可从当前页开始全屏展示，检查标题、正文和图片是否合适，按 Esc 退出后再修改。
首次让 Codex 协助时，建议只要求调整某一页的措辞，确认它改动的内容和原意。数字、引用和结论仍由使用者核对。图片优先使用本地素材；插件文档说明不会自动获取外部图片 URL，页面能显示文字不代表所有图片也已就绪。
实时卡片能运行，但结果需要另行保留
Codeck 的 codex 代码围栏可作为实时卡片，在预览或全屏模式中通过 Run、Stop 控制。它调用已安装的 Codex 可执行文件及现有登录；独立应用和插件共用相关运行逻辑。建议先用不含敏感材料的短提示确认连接，再用于正式演示。
实时结果会流入幻灯片，但不会直接改写 Markdown，且仅在当前会话保留，插件辅助程序重启后会重置。需要交付的内容应在核对后整理进保存的文稿。演示前也应准备已确认的静态文字，避免把现场必须展示的结论完全依赖于一次实时请求。
没有侧栏、卡片不运行或无法保存时怎么查
找不到目录时，运行 codex plugin marketplace list，确认 codeck-plugins 已注册，再重启桌面版。安装后仍无工作区，应确认插件已启用、宿主能力符合要求，并查看 codeck-workspace 的 MCP 启动错误；只有技能已加载不能证明本地辅助程序已经启动。作者还提供了无 workspace extension 宿主的入口：在新聊天请求 Open the Codeck presentation workspace，尝试打开编辑器；这与保证出现独立侧栏不同。保留错误原文再定位，避免同时反复更换多项配置。
卡片不运行时，依次检查 Codex 可执行文件、登录状态、网络和所选模型是否对账号可用。建议先确认普通 Codex 请求能完成，再测试一张卡片；不要把认证、用量或模型权限报错一概当成网络故障，也不要为排错立即反复触发同一生成任务。
保存遇到文件授权或磁盘冲突时，先保护当前草稿。通过原生 Open 面板重新选择文件可续接文件访问授权；如果磁盘上已有外部修改，先比较两个版本，再选择重新载入或另存副本。不要为了消除提示直接删除草稿目录，或把整个磁盘开放给插件。
更新插件后重启，并保留自己的演示文件
作者给出的显式更新顺序是先执行 codex plugin marketplace upgrade codeck-plugins，再执行 codex plugin add codeck@codeck-plugins，最后重启桌面版或开启新的 CLI 会话。个人仓库安装没有文档承诺的插件级自动更新保证，不能只刷新网页就认为本机版本已改变。
不再使用时，可执行 codex plugin remove codeck@codeck-plugins。演示文件和持久草稿存放在插件包之外，卸载不会按该流程一并清理。建议保留重要文稿的独立副本，并在每次升级后用小演示重新确认预览、保存和卡片行为，再继续正式工作。
资料来源
常见问题
Codeck 插件能在 Windows 版 Codex 中使用吗？
作者目前说明插件不支持 Windows 和 Linux。预编译包面向 Apple Silicon、macOS 14 或更高版本；不能因为 Codex 有 Windows 版就推断这个插件也兼容。
Intel Mac 应该下载哪个版本？
独立 Codeck 应用的 v0.7 universal ZIP 包含 Intel 支持；Codex 插件的预编译分发包面向 Apple Silicon。Intel 用户若需要插件，要按作者文档自行构建，不能把独立应用 ZIP 当作插件包。
安装插件后，还需要安装 Codeck.app 吗？
不需要。预编译插件已带本地辅助程序，独立 Codeck 应用不必安装或运行；实时 AI 仍需已安装的 Codex 可执行文件、登录与网络。
MIT 开源是否意味着实时 AI 免费？
不是。MIT 是项目代码的许可，不能据此推断 Codex 订阅、模型调用或用量规则。使用前仍需核对自己的账户权限与额度。
保存 .mdeck 会自动保存实时卡片的所有回答吗？
作者说明卡片结果不会改写 Markdown，且辅助程序重启后会重置。重要内容应先核对，再整理到文稿中并确认已写入文件。