SuperAPI AI 工具集

axhub-commentary-client

前端与建站

查看项目

更新于 10-16 00:00

技能介绍

用途:专注 Axhub Commentary 的页面侧接入,使页面能被 Axhub Chrome 扩展或 Make 预览环境中的编辑器识别、定位、读取可调整属性并回写。不负责安装编辑器 runtime,默认编辑器由扩展注入或 Make 预览环境提供;页面侧只补必要的上下文声明与 tweak 协议。若项目已可用 @axhub/commentary-react,可作为 React helper 使用,但安装 NPM 包不是前置条件。

主要能力与分流:属性编辑、页面级属性聚合参考 references/property-editing.md;多方案设计比稿与 card 方案切换参考 references/design-bid.md;页面环境信息、调试定位、宿主资源上下文参考 references/environment-context.md。

实施原则:tweak/schema/values/adapter/update/card 方案切换优先接入 window.AXHUB_COMMENTARY_TWEAK_PROTOCOL;React 宿主可用 @axhub/commentary-react 的 store/adapter/hook 简化注册,否则直接实现同一套全局 tweak protocol;页面资源上下文/filePath/targetPath/projectPath 优先走 window.COMMENTARY_HOST,若项目本就手动初始化 Commentary runtime,再走 createCommentary(...).host.getResourceContext()。页面级属性聚合基于元素级 tweak 注册结果聚合展示,而非另造全局静态配置;宿主负责业务字段、默认值与回写语义。

适用场景:用户要暴露可编辑项、按页面统一整理可编辑项、先出多版方向再比较、把多方向做成页面内可切换方案、补页面定位信息,或使用扩展/Make 预览打开页面但缺少可识别上下文或调整项。

交付要求:最终回复至少包含命中的子流程、修改的文件、暴露的属性或方案字段、所做的验证。参考 Axhub Runtime 的 packages/axhub-commentary/PUBLIC-API.md 与 packages/axhub-commentary-react/README.md。限制:不负责安装编辑器 runtime;具体平台、收费与效果资料暂未提供。