【免费下载链接】agnes-harnessAgnes Harness: A pluggable agent harness for Forward Deployed Engineering (FDE). Built for trust. Made for the real world.项目地址https://gitcode.com/gh_mirrors/ag/agnes-harness点击查看免费下载Agnes Harness 前端插件教程只需一个声明文件加几行 ESM 代码就能在 Agnes Harness 的 Web 工作台里挂上你自己的业务面板替换内置侧栏、读取后端服务数据并支持无刷新版本更新与一键停用回滚。下面用仓库自带的client-panel完整示例带你从零走一遍。一、先搞懂前端面板插件是什么 Agnes Harness 的工作台界面由一组**插槽Slot**组成比如侧栏区域ui:sidebar。前端插件做的事情很简单通过 package.json 里的agnes.clientDescriptors声明一个浏览器模块描述符浏览器加载后调用你的apply(ctx, config)函数你用ctx.slots.register()把组件挂进指定插槽插槽是单例类型时优先级数值越低越优先示例用priority: -1替换内置侧栏。插件被禁用或删除时注册会自动撤销内置界面立即恢复——你不需要写任何卸载清理代码。二、面板插件包的完整目录结构官方教程推荐直接复用示例包 examples/packages/client-panel/v1/它的结构如下client-panel/v1/ ├── package.json # 声明插件行与客户端描述符 ├── index.mjs # 包入口转发 main 导出 └── extensions/main/ ├── agnes.client.json # 浏览器描述符入口、样式、插槽、公开配置 ├── index.mjs # 后端行示例中为空实现 └── client/ ├── index.js # 真正在浏览器里执行的 ESM └── index.css # 面板样式两个关键声明文件package.json 中agnes.plugins声明后端 Cordis 行如ext:examples/client-panel/mainagnes.clientDescriptors用相同的rowId把描述符绑定到这一行agnes.client.json 的client字段{ client: { entry: ./client/index.js, styles: [./client/index.css], slots: [ui:sidebar], publicConfig: { label: Agnes client module demo · v1 } } }⚠️ 注意publicConfig只放随包发布的公开展示元数据不是后端运行时配置更不能放凭据、token 或 secret。client 入口必须是浏览器可直接执行的原生 ESM且不能引用包外的本地模块。三、最小板面代码5 行搞定面板替换浏览器入口 client/index.js 核心只有几行export function apply(ctx, config) { ctx.slots.register( ui:sidebar, () config?.publicConfig?.label ?? Agnes client module demo · v1, { priority: -1 }, ) }再配一段 index.css 控制外观示例用 CSS 变量--agnes-border、--agnes-bg-card等自适应工作台主题。把它替换成你的业务组件即可——返回 React 组件、纯文本或函数都行工作台会处理渲染边界与错误隔离。给生产面板的三点建议选择合适的插槽不要假设未公开区域可被替换也不要依赖工作台私有的 DOM/CSS 结构需要 React 等第三方库时把它打包进独立可加载的产物而不是依赖运行时 import样式尽量复用工作台的 CSS 变量保持与整体皮肤一致。四、安装、信任与启用三步命令从仓库根目录用隔离实例执行详见 安装指南node packages/cli/dist/local/agnes.mjs package inspect file:./examples/packages/client-panel/v1 node packages/cli/dist/local/agnes.mjs install file:./examples/packages/client-panel/v1安装会展示预览并请求确认核对包 ID、版本、来源、内容哈希与能力声明后用预览中的真实哈希执行信任与启用node packages/cli/dist/local/agnes.mjs package trust agnes-examples/client-panel INTEGRITY CAPABILITY_HASH node packages/cli/dist/local/agnes.mjs package enable agnes-examples/client-panel也可以在 Web 里完成同一流程设置 → 插件管理 → 从来源安装 → 检查/安装 → 启用。启用确认会绑定当前的完整性哈希与能力哈希全部通过后才激活。完整流程见 前端插件专题文档插件生命周期管理见 插件安装与更新指南。五、进阶让面板读到后端业务数据 纯展示面板只能算皮肤。要让面板显示真实业务状态需要同一信任行上同时注册后端服务示例见 examples/packages/client-service-panel/v1/后端 index.mjs 用ctx.services.register()注册panel.version查询服务带kind: query、输入/输出 Schema、超时与结果大小上限描述符的services字段显式列出浏览器允许调用的服务名白名单前端 client/index.js 通过ctx.agnes.services.call(panel.version, {})发起受限调用链路是浏览器 → 同源 BFF → 身份与状态校验 → 行服务授权 → 你的 handler。两个实践要点查询调用需要当前会话启用插件前先在 Web 里配置好模型并选中会话services能力默认不在本地开发策略上限里需要按 全栈集成文档 在隔离试验实例的 profile 中显式放行不要为绕过报错而私自修改日常实例。前后端联动、更新回滚与撤销授权的完整细节见 全栈插件教程。六、更新与停用验证无刷新与自动恢复 无刷新更新安装启用 v1 后通过 Web 管理或 TUI 选择同包 ID 的 v2 源码面板标签应更新为v2双端一致性全栈插件更新后前端标签和后端返回值要同时反映新版本只看前端标签不能证明后端已切换停用回滚禁用插件后内置侧栏必须立即恢复。由于面板可能替换管理导航建议保持一个终端就绪随时用 shell 命令禁用兜底回滚package rollback PACKAGE_ID后目标版本处于未信任未启用状态仍需重新核对哈希、信任并启用。需要留意包desiredenabled、后端行就绪、浏览器加载成功是三个独立阶段。浏览器关闭、脚本/CSS 获取失败、插槽未授权或apply抛错都会阻止前端激活请在每行实际状态里确认而不是只看启用开关。七、常见问题速查 ️现象可能原因排查方向启用后面板没出现前端加载失败/插槽未授权检查每行 actual 状态与浏览器控制台面板显示unavailable无当前会话或服务被拒确认会话已选中、services白名单与策略上限更新后仍显示旧版本热更新被拒、触发了整树重建检查操作记录与快照保留状态依赖缺失安装失败未打包为可移植的不可变快照产物需自包含本地深层路径不算官方还准备了自动化校验命令覆盖示例 ESM、Cordis 绑定、插槽清理与更新失败处理见 frontend.md 的 Verification 一节。结语一套package.jsonagnes.client.json 几行 ESM你就拥有了一个可安装、可信任、可无刷新更新、可一键回滚的 Web 工作台业务面板。建议从 client-panel 示例 起步跑通后再对照 client-service-panel 示例 接入业务数据逐步把能看升级为能干活。延伸阅读插件开发总览 · 后端工具教程 · Web 工作台指南 · 皮肤定制赞分享【免费下载链接】agnes-harnessAgnes Harness: A pluggable agent harness for Forward Deployed Engineering (FDE). Built for trust. Made for the real world.项目地址https://gitcode.com/gh_mirrors/ag/agnes-harness点击查看免费下载相关推荐5步实现AmberELEC游戏封面与边框个性化定制5步实现AmberELEC游戏封面与边框个性化定制 AmberELEC是一款专为Anbernic RG351P/M/V/MP、RG552等掌机优化的开源固件它终极SlideSCI插件教程10分钟打造专业科研演示文稿的秘诀终极SlideSCI插件教程10分钟打造专业科研演示文稿的秘诀 SlideSCI是一款强大的PPT插件专为科研人员和学术工作者设计支持一键添加图片标题、复桌面应用科研DeepSeek HarnessdshWeb 演示的客户端插件产物构建demo:web 为何必须先执行完整 buildDeepSeek HarnessdshWeb 演示的客户端插件产物构建demo:web 为何必须先执行完整 build 在 DeepSeek Harnes人工智能AI AgentAgent 框架DeepSeek上一篇用户反馈分析报告2025-Q3下一篇技术揭秘Virtual Display Driver如何突破Windows显示硬件限制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考