# 影片筆記：2026版AI+Codex零基础全套视频课程，Codex从入门到大神AI编程开发，涵盖安装配置、代码分析、Bug修复及完整项目实战 p12 11、Codex 企业级专属插件开发与打包分发

## 一句话总结

本段内容主要讲解如何在 Codex 环境中利用内置 AI 技能（如 `Packing Correct`）自动生成企业级插件结构，并通过 `marketplace.json` 和 `config.tom` 进行插件的本地/仓库级安装、市场化管理及工作区内的共享分发与权限管控。

## 核心重点

*   **AI 辅助开发**：推荐使用系统内置的 `Packing Correct` 技能，通过 AI 对话自动生成插件目录结构、配置文件（`packings.json`）及技能文件，而非手动创建。
*   **插件结构规范**：插件必须包含 `packings.json`（或 `manifest`）作为元数据定义，包含 `skills`（技能）、`app.json`（应用集成）、`.mcp.json`（MCP 配置）及 `hooks`（生命周期管理）。
*   **安装机制本质**：安装插件并非复制文件，而是将插件路径写入 `config.tom` 或在 `marketplace.json` 中注册。Codex 读取 `Marketplace` 文件来决定加载位置。
*   **市场化管理**：通过 `marketplace.json` 管理插件清单，支持本地自建、第三方来源及官方内置插件。支持更新、禁用及共享功能。
*   **分发与管控**：通过 Codex APP 将插件发布至工作区供成员下载。管理员可通过 `PackingShield.enforce` 配置项进行插件禁用或分享管控。

## 详细大纲

### 一、 插件开发与生成
1.  **使用 AI 辅助开发**：
    *   利用 `Packing Correct` 技能（或 Codex 的管理员/bypass 模式）。
    *   指令示例：在指定目录下创建名为「会议助手」的插件。
    *   AI 会自动生成插件目录结构，包含 `packings.json` 配置文件及 `skills` 目录。
2.  **插件结构规范**：
    *   **必备文件**：`packings.json`（或 `manifest`），用于定义名称、版本、描述、作者、技能路径等。
    *   **可选/功能文件**：
        *   `skills`：定义具体技能（如会议总结、行动计划）。
        *   `app.json`：应用集成配置（如连接 GitHub、Figma）。
        *   `.mcp.json`：MCP Server 配置。
        *   `hooks`：生命周期管理。
        *   `assistant`：图标与资源。
    *   **Manifest 作用**：标示插件本身、指向打包内容（Skills/Apps/MCP）、提供安装界面所需的描述与图标等元数据。

### 二、 插件安装与配置机制
1.  **安装原理**：
    *   安装插件并非复制文件，而是将插件路径写入配置。
    *   在 `config.tom` 中添加一行配置即为「安装」。
    *   在 `marketplace.json` 中指定插件相对路径。
2.  **配置加载逻辑**：
    *   Codex 读取 `Marketplace` 文件来决定从哪里加载插件。
    *   `source.path` 解析为相对于 `Marketplace` 根目录的路径，而非 `.agents` 目录。
    *   若无法解析某个 Marketplace 条目，Codex 会跳过该插件，不会导致整个加载失败。
3.  **生效方式**：
    *   修改本地插件或更新配置后，需同步更新 `marketplace` 指向的目录。
    *   需重启 Codex 以加载新文件。

### 三、 插件市场（Marketplace）管理
1.  **市场清单结构**：
    *   使用 `marketplace.json` 作为插件市场清单。
    *   可配置多个 `packings` 条目，指向不同的插件目录。
    *   支持本地自建、第三方来源（如 GitHub 上的 packings）及系统内置插件。
2.  **市场来源类型**：
    *   **官方内置**：Codex 安装时生成的内置插件。
    *   **仓库级（Repository-level）**：针对当前项目共享，位于项目目录下的 `.agents/packings`。
    *   **用户级/个人级（User-level）**：针对当前用户，位于用户目录下的 `.codex/.agents/packings`。
3.  **操作命令**：
    *   支持通过命令行安装第三方插件。
    *   支持对 Marketplace 进行 `update`（升级/更新）。
    *   支持手动创建插件目录并放入 `packings.json`，但建议全程使用 AI 对话生成。

### 四、 插件分发与共享
1.  **共享机制**：
    *   通过 Codex APP 打开插件，选择「发布」。
    *   添加工作区成员，让其他成员下载并使用该插件。
    *   相当于自建应用商店。
2.  **管控与权限**：
    *   工作区管理员可在 `Cloud Manager Requirements` 中加入 `PackingShield.enforce`。
    *   用于禁用特定插件或管控插件分享。
3.  **状态管理**：
    *   每个插件可独立启用或禁用。
    *   本地插件版本标记为 `Local`，Codex 读取缓存数据而非直接从 Marketplace 声明运行。

## 工具 / 模型 / 名词整理

*   **Codex**：开发环境/平台名称。
*   **Packing Correct**：系统内置的技能名称，用于创建插件。
*   **Codex**：提及的「管理员模式」或「bypass 模式」。
*   **Packing Creator**：技能名称。
*   **Marketplace**：应用市场/插件市场配置概念。
*   **packings.json**：插件配置文件名称。
*   **manifest**：插件清单/元数据文件。
*   **config.tom**：Codex 配置文件，用于安装插件。
*   **app.json**：应用集成配置文件。
*   **.mcp.json**：MCP Server 配置文件。
*   **GitHub**：第三方插件来源平台。
*   **Figma**：提及的应用集成对象。
*   **PackingShield.enforce**：用于管控插件分享的配置项。
*   **Cloud Manager Requirements**：云端管理员要求配置位置。

## 操作流程整理

1.  **开发插件**：
    *   在 Codex 中激活 `Packing Correct` 技能。
    *   输入指令（如“在指定目录创建名为‘会议助手’的插件”）。
    *   AI 自动生成包含 `packings.json`、`skills` 等文件的目录结构。
2.  **配置与安装**：
    *   将生成的插件路径写入 `config.tom` 或在 `marketplace.json` 中注册。
    *   确保 `source.path` 正确解析为相对于 `Marketplace` 根目录的路径。
    *   重启 Codex 以加载新配置。
3.  **市场化管理**：
    *   编辑 `marketplace.json`，添加 `packings` 条目指向本地或第三方插件目录。
    *   通过命令行或界面执行 `update` 操作。
4.  **分发与共享**：
    *   在 Codex APP 中选择插件并点击「发布」。
    *   添加工作区成员，使其可下载和使用该插件。
5.  **管控（可选）**：
    *   管理员在 `Cloud Manager Requirements` 中配置 `PackingShield.enforce`。
    *   根据需要禁用特定插件或限制分享。

## 值得注意的限制或风险

*   **配置解析失败**：若 `marketplace.json` 中的条目无法解析，Codex 会跳过该插件，但不会导致整个加载流程失败。
*   **路径解析差异**：`source.path` 是相对于 `Marketplace` 根目录的路径，而非 `.agents` 目录，配置时需特别注意相对路径的正确性。
*   **缓存机制**：本地插件版本标记为 `Local`，Codex 读取缓存数据，而非直接从 Marketplace 声明运行，修改后需确保缓存同步或重启。
*   **权限管控**：`PackingShield.enforce` 是管理员管控插件分享的关键配置，需正确配置以实施企业级策略。

## 逐字稿辨识疑点

*   **Pagging / Packing / Paggins / Paggings / Pagans / Pagets**：逐字稿中多次出现这些变体，根据上下文推测均指代「Packing」（插件）。
*   **Codex**：部分语境下听似「Codex」，部分听似「Codex 绘画」，疑为口误或特定版本称呼。
*   **scale / scribe / sauce / sace**：逐字稿中多次出现，根据上下文（如「meeting scale」、「skills directory」），疑为「Skills」（技能）的听写错误。
*   **hoax / hawks / hooks**：逐字稿中出现「hoax」、「hawks」，根据上下文（「生命周期的 hooks」），疑为「Hooks」的听写错误。
*   **force**：提及「禁用的话就是 force」，疑为配置参数或口误，实际配置中禁用通常为 `enabled: false` 或类似语义，此处仅记录原文。
*   **Packing Director**：提及「PackingDirector」，疑为特定目录或组件名称，需查证。
*   **Mugplace / Multiplace / MarketPace / MarketPlace**：逐字稿中对「Marketplace」有多种拼写变体。
*   **Reading scale**：提及「reading scale」，疑为「Reading skills」或特定技能名称。
*   **Sauce path / Source path**：逐字稿中混用，疑指 `source.path`。
*   **Packing Shield.inforce**：疑为 `PackingShield.enforce` 的听写。

## 可延伸追问

*   `Packing Correct` 技能的具体触发指令或快捷键是什么？
*   `marketplace.json` 的标准模板结构有哪些必填字段？
*   `PackingShield.enforce` 的具体配置语法和可选值有哪些？
*   如何调试 `source.path` 解析失败的问题？
*   本地插件的缓存目录位置在哪里，如何手动清除？