切换手册章节
同一套 Harness,桌面与 Web 为何表现不同?
用桌面端装过一个插件,打开 npx 启动的 Web 界面却没有看见。先确认两个界面连接的运行环境和配置形态。模型名称相同,也可能装载了完全不同的一组能力。
本篇目录 4 节
01
把三个名词放回具体问题
| 名称 | 它回答的问题 | 课程里的例子 |
|---|---|---|
| Profile(运行形态) | 这次启动哪棵插件树,使用哪组配置 | Web 界面、一次执行后退出的 headless、供程序调用的 SDK |
| Bundle(组件包) | 哪些配置项与相应插件一起分发 | 共用模型、文件、权限等基础能力,Web 形态再加浏览器应用 |
| Patch(配置覆盖) | 给哪一条配置作替换、插入或局部树调整 | 用稳定的配置行 ID 定位要修改的目标 |
02
一个容易漏掉的覆盖规则
RC5 的配置层按顺序叠加。针对某条配置行替换 config 时,会用新对象整体替换该行的 config。假设教学插件原先显式写了 language=zh 和 maxItems=5,只在新 config 里写 maxItems=8,覆盖结果里便不再保留原来那项 language。插件是否另有默认语言,要查插件自己的定义。
先用这组虚构键值在纸上预测结果,再对照官方架构页。对于真实配置,先保存副本,核对插件版本、行 ID 和必要字段。与密钥有关的值只检查引用方式,演示画面不展开真实凭据。
03
分清运行形态与会话预设
Profile 选定宿主及其组件。Agent 预设在宿主暴露的范围内,给一个会话安排可用能力。模型选择、思考强度和文件权限各有自己的职责。换了模型不会把 Web 的插件安装到桌面,换预设也不会自动给予操作系统权限。
04
从旧截图走到自己的版本
- 碰到教程提到标准、PTC、极简、创造四种入口,先读取教程日期。2026 年 8 月的早期界面曾出现这组名称。
- 在自己的客户端记录版本、所在形态与实际显示的预设和插件。RC5 的 npm 启动器和桌面自带命令对 Desktop profile 的管理有分工。
- 只在一次性练习项目检查目标能力。完成一个能区分“可见”和“可执行”的小动作,把结果记入本次实测记录。
来源与延伸阅读
配套资料
知识库与演示素材
知识库附录含录屏分镜。练习包里的 INDEX.md 可按题目查找会议简报、只读目录核对、Cordis 报销回执,以及门店销售和团队练习。