DeepSeek Harness 插件指南

Cordis 是内核：负责挂载、卸载与依赖编织。Agent 行为在插件里，通过服务与事件协作。因此你可以在配置里换模型适配或工具面，而不必 fork deepseek-harness。

常见家族：

• 模型提供方 — DeepSeek 及其它 OpenAI 兼容端点
• 工具与技能 — Shell、文件、搜索、文档解析、设备桥
• 会话与存储 — 日志、凭证、工作区根
• UI / 皮肤 / 管理器 — 外观、应用内目录、技能开关

若 README 承诺「一键市场」，把它理解成 GitHub/npm 之上的社区 UI，权限仍要审。

1. 先按 安装 拿到可用 CLI（npx @deepseek-ai/dsh web 或源码 pnpm dsh）。
2. Node.js 需符合上游：^22.19.0 或 >=24.0.0。
3. 使用如下形式：

dsh plugin add github:owner/repo

若 README 写明 npm scope，也可用 dsh plugin add @scope/name。

4. 重启或重载该插件所补丁的 profile。
5. 在可丢弃工作区发一条低风险提示，并打开 Trajectory / 会话日志。

插件管理常会调用 pnpm。报找不到 pnpm 时先全局安装。镜像超时则改用官方 npm registry。

卡片级命令见 社区插件。发现→安装叙事见 发现并添加 DSH 插件。

作者给仓库打 GitHub 话题 dsh-plugin，便于人和目录发现。本站只做精选，保证摘要改写、命令可复制。我们不会镜像上千张薄卡片。

超出精选时：

• github.com/topics/dsh-plugin
• 其它全量同步社区目录（核对其日期与是否声称「在 rc.x 实测」）

星标 ≠ 安全评审。权限心态见 插件安全清单。

官方开发者文档与 Cordis 入门才是事实源。实用闭环：

1. 克隆模板或跟随仓库内插件教程（预览版布局会变，读当前文档）。
2. 在 Cordis 上下文注册工具或服务；返回 disposer，卸载才干净。
3. 写清配置项、所需密钥、文件系统范围与网络调用。
4. 仅在打算被公开发现时添加话题 dsh-plugin。
5. 先在 Minimal 或 Creative 测试，再升到 Standard。
6. 示例里不要放真实 API Key。

评估别人的插件时把清单反过来用：缺权限说明就跳过。

能跑 Shell 或写文件的插件，等于在装软件。最小权限工作区、关掉不用的工具、用 Trajectory 审计异常调用。本站不会在你的浏览器里执行插件，也不发放「已验证」徽章。

下一步：精选列表、运行模式、排错。