Skip to content

README.zh.md

Latest commit

 

History

History
59 lines (40 loc) · 2.75 KB

README.zh.md

File metadata and controls

59 lines (40 loc) · 2.75 KB
Raw

OMDSH Hub

OMDSH Hub 是面向 DeepSeek Harness 的社区扩展目录与 Profile generation 管理器。它复用 Harness 的 Profile、Bundle、Repository Plugin、Agent Preset、分层 Skill Registry、Cordis 生命周期和配置契约，并补充事务式安装、恢复、目录浏览与设置页。

本发布候选按 2026-08-13 查询到的 npm next 最新包校验：Cordis 4.0.1-rc.4，DSH Client 与 Host 契约 0.0.1-rc.5：

  • Bundle 元数据使用 package.json#dsh.bundle；
  • Client 元数据使用 package.json#dsh.client；
  • Client 接入 settings.section slot；
  • Host 接入 webServer 服务；
  • 所有已启用 Cordis fiber 激活后才确认 Loader 就绪。

包会持续保留 private: true，用于阻止 npm 发布；GitHub 仓库公开不需要移除这项保护。

本地验证

需要 Node.js 22 或更高版本：

npm ci --ignore-scripts
npm run validate
npm run pack:check

@deepseek-ai 包需要 registry 只读权限。请按包提供方说明，通过进程环境提供短期 NPM_TOKEN 与本机 npm 配置；不要把真实令牌写入本仓库。validate 会核对精确 npm 版本与契约声明、检查 JavaScript 语法、校验内置 Registry 并运行完整 Node 测试； pack:check 只检查将生成的包，不会发布，并会拒绝把本机 npm 配置带入产物。

Harness 接入

Host 入口是 dist/index.mjs：提供扩展管理器、Workshop bridge 和 Agent ecosystem 服务，注册仅限 loopback 的管理 API，并安装 official-v2 runtime-ready adapter。official-v2 是 OMDSH 自身的 adapter API 版本，不是快照名称。

预构建 Client 入口是 dist/client.js：通过标准 Client manifest 注入“扩展”设置区，支持“已安装”“发现”、合集、配方、更新和历史页面。

本候选校验时，npm registry 尚未提供 @deepseek-ai/dsh-repository-plugin。因此 Git source 目录项只作为引导式集成展示，OMDSH 不会声称它们能通过 npm 提供的 Repository Plugin 自动安装；本仓库也不会复制私有实现或 Git 快照来填补这个缺口。

管理 endpoint 为 /omdsh/extensions/v1。变更请求只接受 loopback Host，拒绝 cross-site Fetch Metadata；请求带 Origin 时还必须与 HTTP Host 匹配。

安全模型

  • 安装和更新先写入新的物理 Profile generation。
  • 默认禁用 package-manager lifecycle scripts。
  • Registry 文档严格解析；远程替换需要通过已配置的 Ed25519 公钥验签。
  • Candidate 只有在配置校验和运行时就绪确认后才会成为 current。
  • 失败的 candidate 会被丢弃，上一代仍可恢复。

文档

许可证

MIT