dsh-plugin-guide 0.3.42 → 0.4.0

package/scripts/download-community-repos.ps1

@@ -1,232 +0,0 @@
-# 社区插件开发相关仓库全量下载(tarball)脚本
-# 输出: dsh-plugin-guide/downloads/community-repos/<repo>/
-# 刷新策略: codeload HEAD 请求的 ETag 对比（内容变更即重新下载）；记录在 downloads/community-repos/_heads.tsv。
-# 传输: 纯 curl + codeload（main -> master -> HEAD 分支回退），不消耗 GitHub API 配额，也不依赖 git 进程。
-# 参数: -Force 忽略 ETag 对比,强制全部重下; -Slice <n> -Slices <m> 只处理第 n/m 段(1-based),
-#       此时日志与 heads 写入 _download.s<n>.log / _heads.s<n>.tsv,由调用方自行合并。
-param([switch]$Force, [int]$Slice = 0, [int]$Slices = 1, [switch]$OnlyMissing)
-$ErrorActionPreference = 'Continue'
-$ProgressPreference = 'SilentlyContinue'
-
-$kb = Split-Path $PSScriptRoot -Parent
-$dl = Join-Path $kb 'downloads\community-repos'
-New-Item -ItemType Directory -Force -Path $dl | Out-Null
-
-# 后台/受限环境 PATH 可能缺失 curl/tar：逐一下落
-$curl = Get-Command curl.exe -ErrorAction SilentlyContinue
-if (-not $curl) { if (Test-Path "$env:SystemRoot\System32\curl.exe") { $curl = "$env:SystemRoot\System32\curl.exe" } else { $curl = 'curl.exe' } }
-$tar = Get-Command tar.exe -ErrorAction SilentlyContinue
-if (-not $tar) { if (Test-Path "$env:SystemRoot\System32\tar.exe") { $tar = "$env:SystemRoot\System32\tar.exe" } else { $tar = 'tar.exe' } }
-
-$repos = @(
-  # 第一批：08-13/14 首批深读的 15 个插件开发仓库
-  'omdsh-dev/plugin-template',
-  'omdsh-dev/dsh-plugin-skills',
-  'omdsh-dev/dsh-plugin-dev',
-  'vlln/plugin-registry',
-  'omdsh-dev/fabric',
-  'whyihaveyou/dsh-suite',
-  'omdsh-dev/dsh-plugin-check',
-  'Opr4Mp3r/deepseek-harness-plugin-from-scratch',
-  'randerous/dsh-turn-meta',
-  'bobleer/deepseek-harness-plugin-mcp',
-  'Nagi-ovo/dsh-find-plugins',
-  'omdsh-dev/dsh-hub-workshop',
-  'AdamPlatin123/awesome-dsh-plugins',
-  'bruc3van/awesome-dsh-plugin',
-  'Alex-Yanggg/awesome-DSH-plugin',
-  # 第二批：08-14 上午清单（awesome/市场/候选，此前未归档）
-  'walkinglabs/awesome-deepseek-harness-plugins',
-  'vvlife/awesome-deepseek-harness-plugins',
-  'cccakeee/awesome-dsh-plugins',
-  'bradeGithub/DSH-Plugins-Marketplace',
-  'Toukaiteio/dsh-plugin-installer',
-  'Scorp1o117/dsh-plugin-marketplace',
-  'NanmiCoder/dsh-agent-teams',
-  'vibeinging/dsh-tool-search',
-  'zhu1090093659/dsh-web-ui',
-  'ccch1mneyyy/dsh-cc-tui',
-  'dataelement/dsh-desktop',
-  'hust-open-atom-club/oh-dsh-desktop',
-  'lhh010/dsh-bash-encoding',
-  'Nagi-ovo/dsh-visualize',
-  # 第三批：08-14 晚间 GitHub 生态扫描（高优先级 26 个文档型仓库）
-  'flaqai/deepeseek-harness-guide',
-  'Electricitysheep/dsh-handbook',
-  'JingHao-Leon/deepseek-harness-guide',
-  'flysheep-ai/learn_deepseek_harness',
-  'pingfanfan/hello-dsh',
-  'LaplaceYoung/dsh-book-deepseek-harness',
-  'yanhua1010/dsh-harness-tutorial',
-  'hoco-scy/deepseek-harness-deep-dive',
-  'libukai/awesome-deepseek-harness',
-  'sandbaseai/deepseek-harness-handbook',
-  'openma-ai/deepseek-harness-typescript-sdk',
-  'h565656445/dsh-llm-agent-harness-guide',
-  'h565656445/dsh-agent-os-worker-protocol',
-  'cyanseek/dsh-native-playbook',
-  'whyihaveyou/dsh-plugin-tutorial',
-  'DumplingHuman/dsh-plugin-tutorial',
-  'anweat/dsh-plugin-dev-guide',
-  'Hubert-hwk/dsh-for-humans',
-  'yangl326-Dylan/learning-dsh',
-  'curtiseng/cordis-course',
-  'THU-MAIC/dsh-openmaic',
-  'qomob/DSHwiki',
-  'calderbuild/awesome-deepseek-harness',
-  'njdldkl666699/dsh-learning',
-  'Loner1024/deepseek-harness-sdk-rs',
-  'dshworks/howto-dsh',
-  # 第四批：skill 集合/契约规范/含实质开发知识（中优先级 19 个）
-  'dhicoc/dsh-reverse-skill',
-  'phoenixlucky/zerotoken-skill',
-  'unknowbug/anchorlaw',
-  'w2112515/dsh-plugin-development',
-  'OneZero-Y/dsh-plugin-kit',
-  'akira399/dsh-plugin-publisher',
-  'LeslieWylie/dsh-plugin-release',
-  'LeslieWylie/dsh-benchmark-evidence',
-  'LeslieWylie/dsh-agent-orchestration',
-  'dongsheng123132/task-passport',
-  'Tostoevsky/TsienHsueShen',
-  'Whning0513/awesome-deepseek-skills',
-  'Jesse-njx/dsh-skillport',
-  'green-dalii/dsh-plugin-dev-skill',
-  'RayYeung1989/dsh-plugin-development',
-  'SmileTao/dsh-plugin-dev-skill',
-  'Leeaoyin/dr-agent-skills',
-  'KhalilYamber/hana-dsh-bridge',
-  'ieookm/agent-to-dsh-migration',
-  # 第五批：目录/市场/awesome 索引（低优先级 20 个，README 即文档）
-  'kejixiaoliang/awesome-dsh-plugins',
-  'like-study1/Oh-My-DSH',
-  'zp-home/dsh-recommend',
-  'white0dew/awesome-dsh-plugins',
-  'wangshunnn/oh-my-dsh',
-  'billLiao/awesome-dsh-plugin',
-  'YYTbit/awesome-dsh-bridges',
-  'HackSing/dsh-plugins',
-  'xiaohai-78/Top',
-  '2BingLing/dsh-market',
-  'lwmxiaobei/dsh-plugins',
-  'dshworks/awesome-dsh-themes',
-  'dshworks/awesome-dsh-plugins',
-  'dsh-pub/dsh-pub',
-  'cooljser/dsh-plugin-portal',
-  'WatchaAI/awesome-deepseek-harness-plugins',
-  'imsai-sh/awesome-deepseek-harness-plugins',
-  'xianyu110/awesome-deepseek-harness',
-  'openguardrails/openguardrails',
-  'Bandersnatch0x/amber-protocol',
-  # 第六批：中英文社区扫描补充（教程仓库/Tauri 壳）
-  'onychen/learn-dsh',
-  'alchaincyf/deepseek-harness-orange-book',
-  'bobleer/deepseek-harness-gui',
-  # 第七批：08-15 上午增量扫描（web_search 新线索：桌面端/QAT 桥接/安全 PoC/awesome/Python 移植/Termux）
-  'anywhere-labs/deepseek-harness-desktop',
-  'cc1252/deepseek-harness-desktop',
-  'LisiChen0/DeepSeek-Harness-Desktop',
-  'Skyearn/deepseek-harness-app',
-  'salathleizhang/deepseek-harness-desktop',
-  'ChisaAlter/Deepseek-Harness-Desktop',
-  'hairyf/deepseek-harness-desktop',
-  'banana770/dsh-qq-bridge',
-  'mishibeikejie/zat-dsh-engine',
-  'beancookie/awesome-dsh-plugin',
-  'Vengisk/deepseek-harness-termux',
-  'zzszmyf/dsh-security-pocs',
-  'HenryZ838978/deepseek-harness',
-  'Lyowisee/deepseek-harness',
-  # 第八批：08-15 午间补充（主题注册表/WhaleHub 市场/dsh-market 组织）
-  'orxz/deepseek-harness-themes',
-  'vvlife/whalehub-dsh',
-  'dsh-market/dsh-market'
-)
-
-$headsFile = Join-Path $dl '_heads.tsv'
-$logFile = Join-Path $dl '_download.log'
-
-# 同名仓库消歧: 清单中多个 owner 有同名仓库(如 4 个 awesome-dsh-plugins、7 个 deepseek-harness-desktop),
-# 且 Windows 文件系统大小写不敏感——裸 repo 名互相覆盖会丢数据。规则: 首个出现者保留裸名
-# (兼容既有文档引用), 后续同名者用 "<owner>-<repo>" 目录名。
-# 必须在切片之前对全量清单计算: 切片后每片只见子集, 跨片的同名会误判(08-15 真实踩坑)。
-$seenNames = @{}
-$dirNames = @{}
-foreach ($r in $repos) {
-  $owner, $repoName = $r -split '/'
-  $repoKey = $repoName.ToLowerInvariant()
-  if ($seenNames.ContainsKey($repoKey)) { $dirNames[$r] = "$owner-$repoName" } else { $seenNames[$repoKey] = $true; $dirNames[$r] = $repoName }
-}
-
-if ($Slice -gt 0 -and $Slices -gt 1) {
-  $headsFile = Join-Path $dl ("_heads.s{0}.tsv" -f $Slice)
-  $logFile = Join-Path $dl ("_download.s{0}.log" -f $Slice)
-  # 注意: 切片数学必须先算进变量再传给 Select-Object——PS 5.1 会把裸的 [Math]::Ceiling(...)
-  # 当成字符串参数导致绑定失败(切片失效, 多进程重跑全量互相踩踏, 08-15 真实踩坑)。
-  $sliceSize = [Math]::Ceiling($repos.Count / $Slices)
-  $sliceStart = ($Slice - 1) * $sliceSize
-  $repos = @($repos | Select-Object -Skip $sliceStart -First $sliceSize)
-}
-$heads = @{}
-if ((Test-Path $headsFile) -and -not $Force) {
-  Get-Content $headsFile -Encoding UTF8 | ForEach-Object {
-    if ($_ -match '^(.+)\t(.+)$') { $heads[$matches[1]] = $matches[2] }
-  }
-}
-
-$log = New-Object System.Collections.Generic.List[string]
-foreach ($r in $repos) {
-  $owner, $repo = $r -split '/'
-  $repoDir = Join-Path $dl $dirNames[$r]
-  # -OnlyMissing: 只补清单中本地缺失的仓库（已有目录跳过下载；仍会探测 ETag 写入 heads，便于后续增量刷新）。
-  $exists = (Test-Path $repoDir) -and (Get-ChildItem $repoDir -File -ErrorAction SilentlyContinue)
-  if ($OnlyMissing -and $exists -and -not $Force) {
-    $hdr2 = & $curl -sI --connect-timeout 10 --max-time 30 "https://codeload.github.com/$r/tar.gz/HEAD" 2>&1 | Out-String
-    if ($hdr2 -match '(?i)etag:\s*"?((?:W/)?[0-9a-fA-F]+)"?') { $heads[$r] = $matches[1]; $log.Add("KEEP`t$r`tlocal-exists") }
-    else { $log.Add("KEEP`t$r`tlocal-exists(etag-probe-miss)") }
-    continue
-  }
-  # 全部走 curl + codeload（后台沙箱对 git 进程的对外连接不稳定，curl 带 connect/max 超时最可靠）。
-  # 刷新标记用 codeload 的 ETag（内容变更即变化）：分支探测 main -> master -> HEAD 三级回退。
-  $branch = ''
-  $etag = ''
-  foreach ($cand in @('refs/heads/main','refs/heads/master','HEAD')) {
-    $hdr = & $curl -sI --connect-timeout 10 --max-time 40 "https://codeload.github.com/$r/tar.gz/$cand" 2>&1 | Out-String
-    if ($hdr -match 'HTTP/\S+\s+200') {
-      $branch = $cand
-      # ETag 形如 ETag: "abc..."（弱 ETag 为 W/"abc..."）：正则可选跳过 W/ 前缀，完整捕获引号内十六进制值。
-      # 修复历史: 旧正则带 ^ 锚点（-match 非多行，永远匹配不到中间行的 etag）且 W/ 前缀为必选，导致 etag 恒为空、Substring(0,12) 越界、heads 记录损坏——08-15 修复。
-      if ($hdr -match '(?i)etag:\s*"?((?:W/)?[0-9a-fA-F]+)"?') { $etag = $matches[1] }
-      break
-    }
-  }
-  if (-not $branch) { $log.Add("FAIL`t$r`thead-request-failed(404?)"); continue }
-  $etagShort = $etag
-  if ($etagShort.Length -gt 12) { $etagShort = $etagShort.Substring(0, 12) }
-  $downloaded = (Test-Path $repoDir) -and (Get-ChildItem $repoDir -File -ErrorAction SilentlyContinue)
-  if (-not $Force -and $downloaded -and $heads.ContainsKey($r) -and $etag -and $heads[$r] -eq $etag) {
-    $log.Add("SKIP`t$r`tup-to-date@$etagShort"); continue
-  }
-  $tgz = Join-Path $dl ($dirNames[$r] + '.tar.gz')
-  $code = & $curl -sS -L --retry 1 --retry-delay 2 --connect-timeout 10 --max-time 120 -o $tgz -w '%{http_code}' "https://codeload.github.com/$r/tar.gz/$branch" 2>&1
-  if ($code -match '^2' -and (Test-Path $tgz) -and (Get-Item $tgz).Length -gt 1024) {
-    $tmp = Join-Path $dl ("_" + $dirNames[$r])
-    if (Test-Path $tmp) { Remove-Item $tmp -Recurse -Force }
-    New-Item -ItemType Directory -Force -Path $tmp | Out-Null
-    & $tar -xzf $tgz -C $tmp 2>&1 | Out-Null
-    $extracted = Get-ChildItem $tmp -Directory | Select-Object -First 1
-    if ($extracted) {
-      if (Test-Path $repoDir) { Remove-Item $repoDir -Recurse -Force }
-      Move-Item $extracted.FullName $repoDir
-      Remove-Item $tmp -Recurse -Force -ErrorAction SilentlyContinue
-      $n = (Get-ChildItem $repoDir -Recurse -File | Measure-Object).Count
-      $heads[$r] = $etag
-      $log.Add("OK`t$r`tbranch=$branch`tfiles=$n`tetag=$etagShort")
-    } else { $log.Add("FAIL`t$r`textract-empty") }
-  } else { $log.Add("FAIL`t$r`thttp=$code") }
-  if (Test-Path $tgz) { Remove-Item $tgz -Force }
-}
-$heads.GetEnumerator() | Sort-Object Key | ForEach-Object { "{0}`t{1}" -f $_.Key, $_.Value } | Set-Content $headsFile -Encoding UTF8
-$log | Set-Content $logFile -Encoding UTF8
-Write-Output ('DONE: ' + $log.Count + ' repos -> ' + $logFile)
-$log | Write-Output

package/scripts/download-sources.ps1

@@ -1,195 +0,0 @@
-# DeepSeek Harness 插件开发资料全量下载脚本
-# 输出: dsh-plugin-guide/downloads/{web,github,community} + manifest.tsv
-# 参数: -DocRoot <路径> 官方 checkout 的 docs 目录(Phase D 站点路由来源),默认本机 checkout。
-param([string]$DocRoot = 'D:\deepseek-harness\docs')
-$ErrorActionPreference = 'Continue'
-$ProgressPreference = 'SilentlyContinue'
-
-$kit  = Split-Path $PSScriptRoot -Parent
-$dl   = Join-Path $kit 'downloads'
-New-Item -ItemType Directory -Force -Path $dl | Out-Null
-$manifest = New-Object System.Collections.Generic.List[string]
-$manifest.Add("status`thttpcode`tbytes`turl`tfile")
-
-function Log([string]$line) { $script:manifest.Add($line) }
-
-function Do-Curl([string]$url, [string]$outFile, [string]$extra) {
-  $dir = Split-Path $outFile -Parent
-  if ($dir -and -not (Test-Path $dir)) { New-Item -ItemType Directory -Force -Path $dir | Out-Null }
-  $args1 = @('-sS','-L','--max-time','90','-o',$outFile)
-  if ($extra) { $args1 += $extra }
-  $args1 += @('-w','%{http_code}', $url)
-  $code = & curl.exe @args1 2>$null
-  if (($code -match '^2') -and (Test-Path $outFile)) {
-    $sz = (Get-Item $outFile).Length
-    if ($sz -eq 0) { Remove-Item $outFile -Force; Log "FAIL`t$code`t0`t$url"; return $false }
-    Log "OK`t$code`t$sz`t$url`t$outFile"
-    return $true
-  }
-  if (Test-Path $outFile) { Remove-Item $outFile -Force -ErrorAction SilentlyContinue }
-  Log "FAIL`t$code`t0`t$url"
-  return $false
-}
-
-function Download([string[]]$urls, [string]$outFile, [string]$extra) {
-  foreach ($u in $urls) { if (Do-Curl $u $outFile $extra) { return $true } }
-  return $false
-}
-
-function Get-DefaultBranch([string]$metaFile, [string]$fallback) {
-  if (!(Test-Path $metaFile)) { return $fallback }
-  try {
-    $m = Get-Content $metaFile -Raw | ConvertFrom-Json
-    if ($m.default_branch) { return $m.default_branch }
-  } catch { }
-  return $fallback
-}
-
-$ua = @('-H','User-Agent: dsh-plugin-guide-research')
-
-# ---------- Phase A: 固定 URL ----------
-Download @('https://raw.githubusercontent.com/cordiverse/cordis/HEAD/README.md',
-          'https://raw.githubusercontent.com/cordiverse/cordis/master/README.md',
-          'https://raw.githubusercontent.com/cordiverse/cordis/main/README.md') `
-  (Join-Path $dl 'github\cordis\README.md')
-Download @('https://raw.githubusercontent.com/cordiverse/cordis/HEAD/package.json') `
-  (Join-Path $dl 'github\cordis\package.json')
-Download @('https://api.github.com/repos/cordiverse/cordis') `
-  (Join-Path $dl 'github\cordis\repo.json') $ua
-
-Download @('https://raw.githubusercontent.com/cordiverse/paper/HEAD/README.md',
-          'https://raw.githubusercontent.com/cordiverse/paper/master/README.md',
-          'https://raw.githubusercontent.com/cordiverse/paper/main/README.md') `
-  (Join-Path $dl 'github\paper\README.md')
-Download @('https://api.github.com/repos/cordiverse/paper') `
-  (Join-Path $dl 'github\paper\repo.json') $ua
-
-Download @('https://raw.githubusercontent.com/deepseek-ai/deepseek-harness/HEAD/README.md',
-          'https://raw.githubusercontent.com/deepseek-ai/deepseek-harness/master/README.md',
-          'https://raw.githubusercontent.com/deepseek-ai/deepseek-harness/main/README.md') `
-  (Join-Path $dl 'github\harness\README.md')
-Download @('https://api.github.com/repos/deepseek-ai/deepseek-harness') `
-  (Join-Path $dl 'github\harness\repo.json') $ua
-
-# 官网与文档站入口页
-Download @('https://www.deepseek.com/harness/','https://www.deepseek.com/harness','https://deepseek.com/harness/') `
-  (Join-Path $dl 'web\deepseek-com-harness.html')
-Download @('https://deepseek-harness.github.io/deepseek-harness/sitemap.xml') `
-  (Join-Path $dl 'web\sitemap.xml')
-Download @('https://deepseek-harness.github.io/deepseek-harness/develop/basic/') `
-  (Join-Path $dl 'web\develop-basic.html')
-
-# ---------- Phase B: cordis 仓库全量 md 文档 ----------
-$cordisBranch = Get-DefaultBranch (Join-Path $dl 'github\cordis\repo.json') 'master'
-$treeFile = Join-Path $dl 'github\cordis\tree.json'
-Download @("https://api.github.com/repos/cordiverse/cordis/git/trees/$cordisBranch`?recursive=1") $treeFile $ua
-if (Test-Path $treeFile) {
-  try {
-    $t = Get-Content $treeFile -Raw | ConvertFrom-Json
-    $i = 0
-    foreach ($item in $t.tree) {
-      if ($item.type -ne 'blob') { continue }
-      if ($item.path -notmatch '\.(md|mdx)$') { continue }
-      $i++
-      if ($i -gt 120) { break }
-      $out = Join-Path $dl ("github\cordis\repo\" + ($item.path -replace '/','\'))
-      Download @("https://raw.githubusercontent.com/cordiverse/cordis/$cordisBranch/$($item.path)") $out
-    }
-  } catch { Log "FAIL`tparse-tree`t0`tcordis tree.json 解析失败" }
-}
-
-# ---------- Phase C: paper 仓库 md/tex ----------
-$paperBranch = Get-DefaultBranch (Join-Path $dl 'github\paper\repo.json') 'master'
-$ptreeFile = Join-Path $dl 'github\paper\tree.json'
-Download @("https://api.github.com/repos/cordiverse/paper/git/trees/$paperBranch`?recursive=1") $ptreeFile $ua
-if (Test-Path $ptreeFile) {
-  try {
-    $t = Get-Content $ptreeFile -Raw | ConvertFrom-Json
-    $i = 0
-    foreach ($item in $t.tree) {
-      if ($item.type -ne 'blob') { continue }
-      if ($item.path -notmatch '\.(md|tex|bib|typ|pdf)$') { continue }
-      $i++
-      if ($i -gt 60) { break }
-      $out = Join-Path $dl ("github\paper\repo\" + ($item.path -replace '/','\'))
-      Download @("https://raw.githubusercontent.com/cordiverse/paper/$paperBranch/$($item.path)") $out
-    }
-  } catch { Log "FAIL`tparse-tree`t0`tpaper tree.json 解析失败" }
-}
-
-# ---------- Phase D: GitHub Pages 全站爬取 ----------
-$siteBase = 'https://deepseek-harness.github.io/deepseek-harness/'
-$docRoot = $DocRoot
-$routes = New-Object System.Collections.Generic.HashSet[string]
-
-function SitePath([string]$rel) {
-  $p = $rel -replace '\.zh\.md$','' -replace '\.md$',''
-  $p = $p -replace '\\','/'
-  if ($p -match '/index$') { $p = $p -replace '/index$','' }
-  return $p
-}
-
-Get-ChildItem (Join-Path $docRoot 'user') -Recurse -Filter *.md | ForEach-Object {
-  $rel = $_.FullName.Substring((Join-Path $docRoot 'user').Length + 1)
-  [void]$routes.Add((SitePath $rel))
-}
-Get-ChildItem (Join-Path $docRoot 'cordis-tutorial') -Filter *.md | ForEach-Object {
-  [void]$routes.Add('develop/cordis-tutorial/' + (SitePath $_.Name))
-}
-Get-ChildItem (Join-Path $docRoot 'subsystems') -Filter *.md | ForEach-Object {
-  $n = SitePath $_.Name
-  [void]$routes.Add($(if ($_.BaseName -eq 'README') { 'reference/subsystems' } else { "reference/subsystems/$n" }))
-}
-@('architecture','cordis-primer','capability-seams','agent-lifecycle','tool-execution-pipeline','config-catalog','tool-catalog','persistence-catalog') | ForEach-Object {
-  [void]$routes.Add("reference/$_")
-}
-Get-ChildItem (Join-Path $docRoot 'cordis-api') -Filter *.md | ForEach-Object {
-  [void]$routes.Add('reference/cordis-api/' + (SitePath $_.Name))
-}
-@('adding-a-package','adding-a-tool','adding-an-llm-adapter','extension-cookbook') | ForEach-Object {
-  [void]$routes.Add("reference/cookbook/$_")
-}
-
-$siteCount = 0
-foreach ($r in $routes) {
-  foreach ($loc in @('','en/')) {
-    $rel = $loc + $r
-    $url = $siteBase + $rel
-    $fname = $rel -replace '/','\'
-    if ($fname -eq '') { $fname = 'index' }
-    $out = Join-Path $dl ("web\site\$fname.html")
-    Do-Curl $url $out | Out-Null
-    $siteCount++
-  }
-}
-Log "INFO`t-`t$siteCount`tpages attempted`tghpages crawl"
-
-# ---------- Phase E: 社区仓库 README ----------
-$community = @(
-  @('AdamPlatin123','awesome-dsh-plugins'),
-  @('omdsh-dev','dsh-plugin-dev'),
-  @('omdsh-dev','plugin-template'),
-  @('omdsh-dev','dsh-plugin-skills'),
-  @('vlln','plugin-registry'),
-  @('0xsline','awesome-deepseek-harness'),
-  @('awesome-dsh-plugin','awesome-dsh-plugin'),
-  @('Alex-Yanggg','awesome-DSH-plugin'),
-  @('bruc3van','awesome-dsh-plugin'),
-  @('Dominic789654','awesome-deepseek-harness'),
-  @('hikariming','dshfind'),
-  @('dsh-external','hub'),
-  @('titanwings','colleague-skill')
-)
-foreach ($pair in $community) {
-  $owner = $pair[0]; $repo = $pair[1]
-  Download @("https://raw.githubusercontent.com/$owner/$repo/HEAD/README.md",
-            "https://raw.githubusercontent.com/$owner/$repo/master/README.md",
-            "https://raw.githubusercontent.com/$owner/$repo/main/README.md") `
-    (Join-Path $dl "community\$repo.md")
-  Download @("https://api.github.com/repos/$owner/$repo") `
-    (Join-Path $dl "community\$repo.json") $ua
-}
-
-# ---------- Phase F: manifest ----------
-Set-Content -Path (Join-Path $dl 'manifest.tsv') -Value $manifest -Encoding UTF8
-Write-Output ("DONE: " + $manifest.Count + " 条记录 -> " + (Join-Path $dl 'manifest.tsv'))

package/scripts/gen-topic-snapshot.ps1

@@ -1,91 +0,0 @@
-# dsh-plugin-guide 话题快照生成脚本
-# 用途: 抓取 GitHub topic:dsh-plugin 全量仓库清单,产出与 sources.md §D.2 记录一致的快照目录
-#   <OutDir>/raw-github-api-page-<n>.json + repos.tsv + README.md(全量表)
-# 用法: pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <路径> [-PerPage 100] [-MaxPages 10] [-DelaySeconds 6]
-# 说明: 走 GitHub Search API(未认证 10 次/分钟、分页上限 1000 条),分页抓取、按 full_name 去重、按 star 降序;
-#       提供 $env:GH_TOKEN / -Token 后限速提到 30 次/分钟且更稳定。
-#       传输用 Invoke-WebRequest(PS 5.1 下 curl 数组参数的引号拆分会把 -H 头打碎——已规避)。
-#       与 08-13/08-14 各期快照同构,便于续期对比(新增/消失仓库用 repos.tsv diff)。
-param(
-  [Parameter(Mandatory=$true)][string]$OutDir,
-  [int]$PerPage = 100,
-  [int]$MaxPages = 10,
-  [int]$DelaySeconds = 6,
-  [string]$Token = $env:GH_TOKEN
-)
-$ErrorActionPreference = 'Stop'
-$ProgressPreference = 'SilentlyContinue'
-New-Item -ItemType Directory -Force -Path $OutDir | Out-Null
-
-$headers = @{ 'User-Agent' = 'dsh-plugin-guide-research'; 'Accept' = 'application/vnd.github+json' }
-if ($Token) { $headers['Authorization'] = "Bearer $Token" }
-
-$all = @()
-$total = -1
-for ($p = 1; $p -le $MaxPages; $p++) {
-  $r = $null
-  for ($a = 0; $a -lt 3 -and $null -eq $r; $a++) {
-    try {
-      $resp = Invoke-WebRequest -Uri "https://api.github.com/search/repositories?q=topic:dsh-plugin&per_page=$PerPage&page=$p" -Headers $headers -TimeoutSec 45 -UseBasicParsing
-      $r = $resp.Content | ConvertFrom-Json
-    } catch { Start-Sleep -Seconds 3 }
-  }
-  if ($null -eq $r) { Write-Output "page ${p} FAILED (after retries)"; break }
-  if ($r.PSObject.Properties.Name -contains 'message') { Write-Output "page ${p}: API message $($r.message)"; break }
-  if (@($r.items).Count -eq 0) { Write-Output "page ${p}: no items (end)"; break }
-  $total = $r.total_count
-  $all += @($r.items)
-  $raw = Join-Path $OutDir "raw-github-api-page-$p.json"
-  $r | ConvertTo-Json -Depth 6 | Set-Content $raw -Encoding UTF8
-  Write-Output "page ${p}: total=$($r.total_count) items=$(@($r.items).Count)"
-  Start-Sleep -Seconds $DelaySeconds
-  if ($all.Count -ge $total -or @($r.items).Count -lt $PerPage) { break }
-}
-
-$uniq = @{}
-foreach ($i in $all) { if (-not $uniq.ContainsKey($i.full_name)) { $uniq[$i.full_name] = $i } }
-$rows = @($uniq.Values | Sort-Object -Property stargazers_count -Descending)
-
-$tsv = @("full_name`tstars`tlanguage`tlicense`tarchived`tpushed_at`tdescription")
-foreach ($i in $rows) {
-  $desc = ($i.description -replace "[\r\n\t]", ' ')
-  $tsv += "{0}`t{1}`t{2}`t{3}`t{4}`t{5}`t{6}" -f $i.full_name, $i.stargazers_count, $i.language, $i.license.spdx_id, $i.archived, $i.pushed_at, $desc
-}
-Set-Content -Path (Join-Path $OutDir 'repos.tsv') -Value ($tsv -join "`r`n") -Encoding UTF8
-
-$utc = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mmZ')
-$L = @()
-$L += '# DeepSeek Harness `dsh-plugin` 话题全量清单'
-$L += ''
-$L += '> 数据来源：GitHub Search API `q=topic:dsh-plugin`（公开话题页 <https://github.com/topics/dsh-plugin>）。'
-$L += "> 抓取时间：$utc（UTC）。API total_count $total；本清单去重收录 $($rows.Count) 个。"
-$L += '> 注意：Search API 分页上限 1000 条，去重数与 total_count 都要记录（见 sources.md §D.2 惯例）。'
-$L += ''
-$L += '## 元信息'
-$L += ''
-$L += '| 项目 | 值 |'
-$L += '|---|---|'
-$L += '| 话题 | [dsh-plugin](https://github.com/topics/dsh-plugin) |'
-$L += "| 仓库总数 | $($rows.Count)（API total_count $total） |"
-$L += "| 抓取时间 (UTC) | $utc |"
-$L += '| 排序 | star 数降序 |'
-$L += ''
-$L += '## 全量清单（按 star 排序）'
-$L += ''
-$L += '| # | 仓库 | ⭐ | 语言 | 许可 | 归档 | 功能 / 效果（官方描述） | 最近推送 (UTC) | 话题标签 |'
-$L += '|---|------|----|------|------|------|----------------|----------------|----------|'
-$n = 0
-foreach ($i in $rows) {
-  $n++
-  $name = $i.full_name
-  $stars = $i.stargazers_count
-  $lang = $i.language
-  $lic = if ($i.license) { $i.license.spdx_id } else { '-' }
-  $arch = if ($i.archived) { '是' } else { '否' }
-  $desc = ($i.description -replace '\|','\|' -replace "[\r\n]", ' ')
-  $push = $i.pushed_at
-  $topics = if ($i.topics) { ($i.topics -join ', ') } else { '' }
-  $L += "| $n | [$name](https://github.com/$name) | $stars | $lang | $lic | $arch | $desc | $push | $topics |"
-}
-Set-Content -Path (Join-Path $OutDir 'README.md') -Value ($L -join "`r`n") -Encoding UTF8
-Write-Output "DONE: $($rows.Count) unique repos -> $OutDir (README/repos.tsv/raw pages)"

package/scripts/install-skill.ps1

@@ -1,63 +0,0 @@
-# dsh-plugin-guide skill installer.
-# Purpose: copy the KB (excluding generated/local-only parts) into an agent skill directory and verify byte parity.
-# Usage:   pwsh -File scripts/install-skill.ps1 -Target <skill-dir> [-Source <kb-root>]
-# Scope:   SKILL.md, guide/, references/ (incl. official-docs), scripts/, README*.md, LICENSE, NOTICE.md, CONTRIBUTING.md, SECURITY.md.
-# Excluded: downloads/ (generated by scripts), .github/ (CI), .gitignore.
-# Target must be the skill directory itself (e.g. ~/.deepseek/skills/dsh-plugin-guide or <project>/.agents/skills/dsh-plugin-guide).
-param(
-  [Parameter(Mandatory=$true)][string]$Target,
-  [string]$Source = ''
-)
-$ErrorActionPreference = 'Stop'
-if (-not $Source) { $Source = Split-Path $PSScriptRoot -Parent }
-$src = (Resolve-Path $Source).Path
-$top = @('SKILL.md','LICENSE','NOTICE.md','CONTRIBUTING.md','SECURITY.md') + @(Get-ChildItem $src -Filter 'README*.md' -File | ForEach-Object { $_.Name })
-$dirs = @('guide','references','scripts')
-
-New-Item -ItemType Directory -Force -Path $Target | Out-Null
-
-foreach ($f in $top) { Copy-Item (Join-Path $src $f) (Join-Path $Target $f) -Force }
-foreach ($d in $dirs) {
-  # Copy-Item -Recurse into an existing directory would nest the source inside it; replace the owned dir instead.
-  $td = Join-Path $Target $d
-  if (Test-Path $td) { Remove-Item $td -Recurse -Force }
-  Copy-Item (Join-Path $src $d) $td -Recurse -Force
-}
-
-# Prune target files under the owned scope that no longer exist in the source (keeps reinstalls clean).
-foreach ($d in $dirs) {
-  $td = Join-Path $Target $d
-  if (Test-Path $td) {
-    $sd = Join-Path $src $d
-    $sRoot = (Resolve-Path $sd).Path
-    $tRoot = (Resolve-Path $td).Path
-    Get-ChildItem -Recurse -File $td | ForEach-Object {
-      $rel = $_.FullName.Substring($tRoot.Length + 1)
-      if (-not (Test-Path (Join-Path $sRoot $rel))) { Remove-Item $_.FullName -Force }
-    }
-  }
-}
-Get-ChildItem $Target -File -ErrorAction SilentlyContinue | ForEach-Object {
-  if (($_.Name -like 'README*.md' -or $top -contains $_.Name) -and -not (Test-Path (Join-Path $src $_.Name))) { Remove-Item $_.FullName -Force }
-}
-
-# Parity report: every scoped source file must exist in the target byte-for-byte.
-$checked = 0; $mismatch = 0
-foreach ($f in $top) {
-  $s = Join-Path $src $f; $t = Join-Path $Target $f
-  if (Test-Path $t) { $checked++; if ((Get-FileHash $s -Algorithm MD5).Hash -ne (Get-FileHash $t -Algorithm MD5).Hash) { $mismatch++; Write-Output "MISMATCH: $f" } }
-  else { $mismatch++; Write-Output "MISSING-TARGET: $f" }
-}
-foreach ($d in $dirs) {
-  $sd = Join-Path $src $d
-  $sRoot = (Resolve-Path $sd).Path
-  Get-ChildItem -Recurse -File $sd | ForEach-Object {
-    $rel = $_.FullName.Substring($sRoot.Length + 1)
-    $t = Join-Path (Join-Path $Target $d) $rel
-    if (Test-Path $t) { $checked++; if ((Get-FileHash $_.FullName -Algorithm MD5).Hash -ne (Get-FileHash $t -Algorithm MD5).Hash) { $mismatch++; Write-Output "MISMATCH: $d\$rel" } }
-    else { $mismatch++; Write-Output "MISSING-TARGET: $d\$rel" }
-  }
-}
-Write-Output "DONE: $checked scoped files verified, $mismatch mismatches -> $Target"
-if ($mismatch -gt 0) { exit 1 }
-exit 0