Authoring
创建 Harness 插件
先把插件做成可重复安装的 bundle,再考虑目录展示。目录元数据不能弥补不完整的发布物。
最小结构
当前社区实践中的最小插件通常包含根级 package.json、Bundle 声明、Cordis patch 和导出 apply(ctx) 的 ESM Host 模块。
my-plugin/
├── package.json
├── cordis.patch.yml
├── src/
│ └── host.ts
└── README.md需要讲清楚的内容
- 插件改变 Harness 的哪一部分,以及不改变什么。
- 支持哪些 Harness 版本、操作系统与 Profile。
- 安装、配置、卸载和最小健康检查。
- 网络、文件、令牌和生命周期脚本权限。
面向目录的元数据
README 中建议提供一句简洁定位、3–5 个功能标签、许可证、截图、安装命令以及可追溯的 Release。目录会从原始仓库提取这些事实,再生成展示页。