SuperAPI AI 工具集

cordis-plugin-development

智能体与模型

查看项目

更新于 10-15 20:35

技能介绍

用途:面向 DeepSeek Harness(DSH)的 Cordis 插件开发技能,覆盖插件的设计、审查、添加、启用、禁用、安装、配置与调试,以及 bundle、功能、页面、面板、工具和 MCP 相关场景。

实现持久化插件:用普通工作区文件编写 bundle,再以 plugin_manager(action: install_bundle)并指定绝对包目录安装到当前 profile。改动影响该 profile 的所有会话并在重启后保留。不要手写 profile 的 package.json 或 cordis.patch.yml,不要在 $DSH_HOME 下创建包,也不要在 profile 目录运行 pnpm;install_bundle 会完成这些步骤。除全权限外,每个 plugin_manager 操作(包括 list_plugins、list_bundles)都需审批,仅当其结果决定下一步时才调用。

设计或审查:对照当前 API 检查拟建或已有插件,并报告设计选择或发现,不执行安装流程、不写文件、不改 profile 状态,除非用户要求实现。

启用已发布插件:已发布 bundle 可能解析出插件行但保持禁用,行 id 与原因在已发布 patch(源码 checkout 中为 packages/bundle/*/cordis.patch.yml)。编写工作区 bundle,用 patch 覆盖该行设为 disabled: false 并插入依赖的 Host 行;源码 checkout 的 apps/cli/config/examples/<feature>/cordis.yml 列出可选功能所需行。随 dsh 发布的包从 dsh 安装解析,故 bundle 无需声明其依赖。用 install_bundle 安装。

先交付可用插件:明确目标结果与位置,未指定可视化位置时默认为当前 Harness Web UI;独立图片或 HTML 文件不算完成。选定合理视觉细节并实现最小首版,安装后再做视觉优化。仅发现该版本所需 API:先 cordis_inspect_list,再有针对性地 cordis_inspect_query。UI 场景查询 Client Slots.listSubTree 及所选 slot 的注册选项与 props。超出静态装饰(工具策略、代理上下文、会话派生状态、Chat 行)前阅读 references/practices.md;插件 UI 中的用户操作还需 references/user-actions.md。读取 templates/ 下匹配模板并用文件读取工具,将其复制到同一工作区目录,或自行编写可安装包、patch 及所需 Host/Client 文件。检查 JavaScript 语法与清单后安装。首次安装前不要创建预览 HTML、mock shell、设计变体、截图脚本或光栅化工具,以已安装插件本身作为首个预览。

读取安装结果:application 与 warnings 字段决定改动是否生效,而非服务器日志或终端输出。用 cordis_inspect_query 确认新行。application: applied 后验证能力或检查实时 Client 注册;有浏览器控制时用连接页面做视觉验证。页面或面板还需检查设计一致性:样式仅用主题 token、不导入 Harness Client 包(如 @deepseek-ai/dsh-client-ui-primitives)、控制台无 slot 崩溃、明暗主题下与同类宿主页面并排读取正常。用户操作按 references/user-actions.md 检查。按风险缩放验证,无浏览器控制时参照 references/verification.md。恢复测试中改动的用户设置或状态,明确说明验证局限;仅安装与 slot 注册不足以证明用户所见。

知识来源顺序:检查(cordis_inspect_query 查 Service 方法与 Event 模式、Config JSON Schema、可用 Tool、实时 Client Slots 与主题 token);包文档(Config.listConfigs 按 name 查条目,读取 <packageDir>/README.md,不要从 $DSH_PROFILE_DIR 猜路径);源码(已安装包含构建产物 lib/index.js 与 lib/types/**/*.d.ts,源码 checkout 为 packages/<group>/<name>/src)。DSH_PROFILE 与 DSH_PROFILE_DIR 在 profile 启动的 Harness 每次 shell 调用中设置,Bash 读 $DSH_PROFILE,PowerShell 读 $env:DSH_PROFILE;dsh 在 PATH 时可用 dsh --profile "$DSH_PROFILE" --dump-config 打印合成 profile。

引用文件(位于技能基础目录,须用文件读取工具读取并复制到工作区,Desktop 中目录在 app.asar 内,shell、glob、search、node、pnpm 均不可访问):references/host-plugin.md、references/ui-plugin.md、references/mcp-bundle.md、references/verification.md、templates/decoration 四个文件、templates/mcp 两个文件、cordis-composition-reference 技能、references/practices.md、references/user-actions.md。

限制:资料未提供具体收费、价格与平台支持信息;实际可用性取决于 DSH 环境与权限配置。