运行时打包¶
状态:已由合并的 #136 实现;原生主机证据仍保持独立。 作者:@n3wth。日期:2026-10-24。
相关问题:#121 和 #122。实现:#136。
问题与范围¶
用户需要包含每个主机所需资源的运行时包。完整的仓库归档还包含开发文件和网站资源。
从同一个源树构建 Claude 和 OpenAI 运行时包。保留正常的用户控制权限。不要添加新的主机、服务或自动权限批准。包验证不构成目录批准或运行时支持。
包契约¶
使用 scripts/pack_plugin.py(已在 #136 合并)作为唯一构建器。
--target claude|openai 选择主机。--output 选择一个新的目标位置。
生成一个 egm-TARGET 文件夹和一个 egm-TARGET.zip 归档。
允许名单包含清单、技能、参考资料、角色、原生适配器、必需的文档、许可证和图片资源。包含 docs/assets 下用于 README 图片的 SVG 和 PNG 文件。排除网站内容、测试、工作流、钩子、开发市场元数据以及无关文件。
目标清单是明确的:
- 共享:
plugin.json、LICENSE、README.md、skills/*/SKILL.md、skills/*/agents/openai.yaml、技能资源和参考资料、agents/*.md、resources/*.md和resources/document_standards/*.md。 - 共享指南:
docs/index.md、docs/getting_started.md、docs/harnesses.md、docs/claude.md、docs/codex.md、docs/faq.md和docs/privacy.md。 包含docs/releases.md,由发布准备添加。 - 共享图片:
assets/和docs/assets/下的 SVG 和 PNG 文件。 - Claude:
.claude-plugin/plugin.json、.claude-plugin/icon.png和.claude-plugin/agents/*.md。 - OpenAI:
.codex-plugin/plugin.json。
构建器的 SHARED、HOST 和 REQUIRED_SHARED 常量实现了这一清单。必需的参考资料必须存在;可选文件必须匹配这些路径。
在运行时中保留安装指南、主机说明、角色、技能和审查标准。排除仓库设计文档、TESTING.md、CONTRIBUTING.md、AI_POLICY.md 和 PR 模板。在捆绑的指南中链接到 GitHub 上的那些开发文档。阅读开发文档需要网络访问;执行捆绑的技能则不需要。检查两个生成的运行时中的相对 Markdown 链接。仅面向开发的文档编辑不得要求重新生成运行时内容。
拒绝符号链接、源树之外的路径、缺失的必需文件、未捆绑或非字符串的清单引用、钩子,以及不支持的 MCP 或应用依赖。 拒绝已存在的输出文件夹或归档。失败的构建可能留下部分输出;诊断失败原因,并在下次尝试时使用新的目标位置。
对归档条目排序,并使用固定的时间戳和文件模式。在相同的构建环境下验证字节是否完全一致。不要声称在未经测试的工具链版本之间具有可重现性。
不要将生成的 Claude 运行时提交到 main。Claude 市场目录从仓库根目录安装。目录发布使用生成的分支。参见
Claude 发布分支分发。
权限与主机边界¶
移除自动权限批准钩子。在 Claude 原生适配器上保留受限工具。资源读取使用正常的主机权限。被拒绝的读取必须停止受影响的审查器,且不得产生捏造的结论。
只读 Claude 审查器允许 Read、Grep 和 Glob。合成器还允许 Agent 和 Write 用于委派和报告。Bootstrap 允许 Agent、Bash、Read、Grep、Glob、Write 和 Edit 用于文档编制。这些工具列表并不构成文件系统或网络沙箱。
将父上下文隔离与文件系统访问以及主机添加的指令或记忆分开测试。Claude CLI 探测并不能证明 Cowork 行为。OpenAI 打包并不表示支持每种 ChatGPT 模式。
验证与发布¶
- 测试必需内容、图片包含、排除项、不安全路径、缺失引用、拒绝覆盖和可重现性。
- 对照生成的运行时验证允许和拒绝的资源读取。
- 记录源 SHA、已安装制品的标识、主机/模型版本,以及各自独立的安装、工作流和隔离结果。
- 在 Cowork #105 和 ChatGPT Work #106 中保留云端工作流和隔离差距。
- 设计与实现 #136 已合并;保留精确制品主机检查。
- 通过 发布设计 协调带标签的制品。
121 和 #122 中的目录发布仍保持独立。提交前确认所属账户、政策链接、发布者权限和提供商调查结果。只有在核实已发布的列表后才能关闭这些问题。¶
备选方案与待定决策¶
各自手工维护的包会逐渐漂移。完整的仓库 ZIP 会包含不必要的开发内容。共享的允许名单使包边界明确且可审查。
打包实现 #136 已合并。#121/#122 中的目录批准和精确制品主机验证仍与该项实现分开。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model