dsh-compliancehub

dsh-compliancehub

跨境合规技能专家组 —— 装这个插件，得到一套可核验的跨境合规技能。

Remote skill provider for DeepSeek Harness: install skills from a JSON catalog through the standard ctx.skills registry — no manual folder copying.

本插件只提供跨境合规线（9 个技能）：CCPA/GDPR/HIPAA/COPPA 的 check/guard 与 ccpa-compliance。 股票、数据分析、插件工具等其他技能线不属于本插件（详见 wwumit 技能生态）。 默认目录为线级 catalog-compliance.json，主目录 catalog.json 仍为全量登记层（开放数据层），保持不变。

• list() — fetch + validate a curated catalog, expose its skills to the registry
• get() — fetch the SKILL.md body on demand from the owning repo
• Fail-soft semantics: a catalog outage yields an incomplete observation (consumers keep their last-good catalog), never an authoritative empty list

Install

npm install @wwumit/dsh-compliancehub
# peer deps: @deepseek-ai/cordis, @deepseek-ai/dsh-skill

Usage (composition)

import { Context } from '@deepseek-ai/cordis'
import * as skillHub from '@wwumit/dsh-compliancehub'

export function apply(ctx: Context) {
  ctx.plugin(skillHub, {
    catalogUrl: 'https://wwumit.github.io/skills-catalog/catalog-compliance.json', // 默认即此（跨境合规线）
    // providerName: 'hub'     // unique name on ctx.skills
    // rank: 250               // duplicate-name resolution (lower wins)
    // requestTimeoutMs: 10000
    // baseUrl: 'https://raw.githubusercontent.com'
    // branch: 'main'
  })
}

Once loaded, DSH's model session catalog includes the provider's skills and the model can invoke them via the built-in skill tool.

Catalog format

{
  "schemaVersion": 1,
  "disclosureSchemaVersion": "0.2",
  "updatedAt": "2026-08-16T00:00:00Z",
  "skills": [
    {
      "name": "ccpa-check",
      "fullName": "wwumit/skills-compliance-intl",
      "skillFullName": "wwumit/skills-compliance-intl/skills/ccpa-check",
      "description": "CCPA/CPRA compliance check …",
      "repo": "wwumit/skills-compliance-intl",
      "version": "2.2.4",
      "disclosure": { "cloud": true, "network": ["https://compliancehub.cn"], "offlineMode": true },
      "files": ["SKILL.md", "scripts/ccpa-check.py"]
    }
  ],
  "repos": [
    { "fullName": "wwumit/skills-compliance-intl", "skillCount": 9,
      "cloudSkills": ["ccpa-check", "coppa-check", "gdpr-check", "hipaa-check"] }
  ]
}

Generate a catalog from a skill workspace with the included catalog/build-catalog.mjs script (curated via catalog/curated.json).

Verified (DSH 实机验证)

verify-dsh.ts 在真实 DSH 运行时验证通过（SkillRegistry + provider 注册）：

✅ ctx.skills.list() → 9 个跨境合规技能（线级 catalog-compliance.json）
✅ ctx.skills.get('ccpa-check') → 正文 {n} 字节

• 验证方式：注册 ctx.skills.registerProvider → 真实 list()/get() 调用线上 catalog
• 结果随版本演进记录在 CHANGELOG.md；目录收录方可用此作为"含实测结果"证据

Listed on dshbase

已收录于 dshbase 插件目录（分类：Developer）。 安装：dsh plugin add @wwumit/dsh-compliancehub（兼容 dsh 0.1.0-rc.6）。

Disclosure (DISCLOSURE v0.2 开放数据层)

catalog 提供双颗粒度披露（市场/目录构建期单请求抓取消费）：

{
  "disclosureSchemaVersion": "0.2",
  "skills": [
    { "name": "ccpa-check", "fullName": "wwumit/skills-compliance-intl",
      "skillFullName": "wwumit/skills-compliance-intl/skills/ccpa-check",
      "disclosure": { "cloud": true, "network": ["https://compliancehub.cn"],
        "offlineMode": true, "apiKeys": [{"env": "COMPLIANCEHUB_API_KEY", "storage": "file-0600"}],
        "jurisdiction": ["US-CA"], "retention": "session" } }
  ],
  "repos": [
    { "fullName": "wwumit/skills-compliance-intl", "skillCount": 9,
      "cloudSkills": ["ccpa-check", "coppa-check", "gdpr-check", "hipaa-check"] }
  ]
}

• 线级目录 9 个跨境合规技能全部披露：4 个云端评分（compliancehub.cn）+ 5 个纯本地（cloud:false）
• 声明源 = SKILL.md frontmatter（snake_case）；聚合源 = catalog.json（camelCase）；构建脚本 build-catalog.mjs 可复现
• 披露检查由 skill-compliance v1.4.0 自动执行（D1/D3/D4 完整性 + 声明-代码一致性 + 宿主依赖）

Development

pnpm install
pnpm test       # vitest (mocked fetch)
pnpm build      # tsc → lib/

Model Experience

Request context and condition

What the model sees

No system-prompt prose is added by this package. Skills served by the provider appear in the standard model session catalog (<available_skills>) exactly like locally installed skills, with name and description from the catalog.

Token effect

Zero direct token contribution: the provider only feeds the shared skills catalog, whose rendering cost is owned by the DSH skill consumer (@deepseek-ai/dsh-tool-skill).

KV Cache effect

Independent of model requests; no prompt-prefix contribution, so cache reuse is unaffected by provider activity.

Known Limitations and Deferred Work

• Body-only fetch — get() currently fetches SKILL.md only; script/resource files listed in the catalog manifest are not yet downloaded into a local cache (resourceBase resolution is future work).
• Catalog caching — list() refetches on every call; a TTL cache keyed by the resolved catalog URL is planned.
• Auth — no support yet for private catalogs or signed URLs.