AGENTS.md

Nanobug JavaScript 协作约定

本仓库是 JavaScript 插件的正式业务维护来源，保留插件 ID javascript。默认简体中文沟通；宿主只提供面向所有插件的公开能力。

开始工作

先检查 git status --short、README.md、manifest.json、nanobug-plugin.json 和 host-sdk.json，保留已有改动。市场规格、工单和交付记录统一见 Nanobug Plugin Marketplace；本次迁移依据为工单 03，历史资料不自动授权其他任务。

实现和构建

• 业务策略、资源和说明在本仓库修改；宿主仓库过渡源码冻结，不双份维护。
• 独立构建使用固定宿主版本的公开 --plugin-package / --plugin-cargo 入口。不得添加指向宿主 crates/ 的依赖或复制 SDK 源码；公开参数和权限见导出的源码注释。
• 若生成代码，必须同时生成用途、接口、状态与生命周期注释。使用 apply_patch 编辑；复用公开 API，不添加插件 ID 专属宿主分支。
• 修改交付包时提升清单、声明描述与 Cargo 包版本，保留既有安装 ID、设置和私有数据。权限和能力不能通过配置静默扩大。
• 根 README.md 与 README.zh-CN.md 同步。docs/source-readme.md 及迁入的旧验收是历史来源，不是本版本验收。

验证和发布

先运行受影响插件测试，通过固定宿主生成实际 ZIP，再以 Package / Manager 和原生宿主验证代表行为。源码、SDK、资源或依赖变化重跑受影响验证；完全相同的输入可复用制品，每个运行场景隔离数据和授权。

Release 固定源码 commit、包版本和完整 ZIP SHA-256，不替换同名同版本附件。首次及每版通过市场 PR 和人工审核；构建成功不等于上架。凭据不进入源码、日志或包。用户已授权的普通提交和本工单发布按现有约定执行，不强推、不改历史，不自动批准市场收录 PR。