插件内部机制

插件通过已发布的 Harness 服务扩展运行中的 Cordis 树。安装方式见用户插件,可运行示例见编写插件。

可用扩展入口

能力接口终端行为
斜杠命令dsh-commands 元数据、处理器和补全命令进入 Help、补全和 runner。
工具Harness 工具注册与 ToolDefinition.presentCall / presentResultTUI 按提供方声明展示内容,统一负责内边距、换行和通用回退。
模型与授权ctx.llm 和已注册的 ctx.authorization 流程模型进入选择器,/login 展示授权流程的通知和提问。
设置与凭据ctx.settings 和 ctx.credentialsschema 声明的 live 设置按自动表单策略进入 Advanced,密钥值通过凭据服务保存。
提问与通知ctx.tui.prompt、notice 和 commandOutput本地 provider 负责焦点、取消、可读结果及返回输入框。
会话行为Harness Agent/session 服务与持久事件插件在自己的 Cordis 作用域内观察生命周期并提供行为。
Persona 与技能Agent preset 和 Harness skill registry/agent 在产生模型历史前选择 preset,/<skill-name> 调用技能。

在插件的 inject 中声明所需服务,通过自身 Cordis context 注册 effect,使卸载能够释放资源。以已安装包的 exports 和类型为契约,已发布的 provider、服务定义、运行时和命令入口见 TUI manifest。

终端归属

本地 provider 拥有 raw mode、已解码输入的路由、光标状态、视口布局、鼠标选择与终端写入。runner 是 readInput 的唯一消费者。插件通过 prompt() 和请求的取消信号向用户提问,人工审批优先于普通浏览。

产品拥有输入框、状态页脚、主题配色、转录布局与设置分类。插件通过 presentCall 和 presentResult 提供工具展示意图。Advanced 展示符合策略的 live schema 字段,专用表单通过所属命令和 prompt 服务提供。固定布局的页脚格式化 Harness 投影,宽度不足时按优先级收起指标。

自定义展示注册表仍属于待论证的设计方向。ctx.tui.contributions、自定义组件工厂与主题包注册尚无已发布 API。新增入口需要具有独立所有权的消费者,并证明现有工具和 prompt 契约无法表达其需求。在公共导出前,应明确并验证生命周期、兼容性、取消、焦点恢复和显示宽度约定。实现模块只有被包的 export map 明确列出时才构成公开入口。

持久事件须满足已发布的会话 schema。未知事件只有明确标为 ignorable 且可安全省略时,读取器才可以跳过。展示扩展因此需要先具备持久回放契约,才能增加新的会话事实。权限决定继续经过 Harness 授权与审计。

回复语言与完整 Persona

产品的**回复语言(Response language)**设置通过 system-prompt section 生效。跟随界面在下一回合解析界面语言,Auto 生成空片段。声明 complete: true 的自定义 persona 会抑制普通 section,需要追加 {{omdsh_agent_behavior}} 才能应用该偏好。插件归属及回合快照约定见 Agent 行为设计。

组合与生命周期

apps/omdsh 拥有 Profile 加载、安装与应用组合,TUI 包拥有终端展示与交互。用户 bundle 共用已发布的 Harness 服务,须声明兼容的 peer 来维持服务身份。CLI 包操作后需要重启,运行时插件操作会报告已实时应用或需要重启,已有 Agent 组合保留其版本。

未来展示接口必须保留 display-cell 布局、ANSI 处理、CJK 与 emoji 宽度、输入草稿、附件顺序、取消及终端恢复语义。验证应覆盖异常、卸载、resize 和嵌套人工提问。源码入口与现有测试见架构。

相关