dsh-plugin-guide 0.1.0

package/scripts/archive-discussions.ps1

@@ -0,0 +1,154 @@
+# dsh-plugin-guide 官方 GitHub Discussions 归档脚本（可复跑，幂等）
+# 输出: downloads/github/harness/discussions/
+#   list.json          全部讨论（title/body/category/answers/labels 等，正文即文档）
+#   comments-<n>.json  精选线程的全部评论（选择规则见下）
+#   _selection.tsv     精选线程清单
+#   README.md          分类统计 + 精选清单
+# 说明: GitHub REST API;未提供 Token 时走匿名配额(60/h,可能不够),建议
+#   $env:GH_TOKEN 或 -Token <token>(经典 PAT,只需 public_repo 读权限)。
+#   选择规则(与 08-14 首版覆盖度一致): Announcements 全部; Q&A/Ideas 评论>=1;
+#   General/Show and tell 评论>=3 且标题不含拉群/招聘/广告词。
+#   传输用 Invoke-WebRequest(而非 curl.exe 数组参数): PS 5.1 下 curl 数组参数
+#   的引号拆分会把 -H 头打碎,导致静默拿到错误对象——本脚本已规避该坑。
+# 参数: -OutDir <dir> 覆盖输出目录; -SkipComments 只刷新 list.json 不拉评论。
+param(
+  [string]$OutDir = '',
+  [string]$Repo = 'deepseek-ai/deepseek-harness',
+  [string]$Token = $env:GH_TOKEN,
+  [switch]$SkipComments
+)
+$ErrorActionPreference = 'Stop'
+$ProgressPreference = 'SilentlyContinue'
+if (-not $OutDir) { $OutDir = Join-Path (Split-Path $PSScriptRoot -Parent) 'downloads\github\harness\discussions' }
+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" }
+
+function Get-Api([string]$url) {
+  # 返回对象数组;失败/限流时抛错(带状态码),由调用方决定重试或中止。
+  try {
+    $resp = Invoke-WebRequest -Uri $url -Headers $headers -TimeoutSec 60 -UseBasicParsing
+  } catch {
+    $code = if ($_.Exception.Response) { [int]$_.Exception.Response.StatusCode } else { 0 }
+    throw "HTTP $code : $url"
+  }
+  $obj = $null
+  try { $obj = $resp.Content | ConvertFrom-Json } catch { throw "JSON parse failed: $url" }
+  if ($obj -is [System.Management.Automation.PSCustomObject] -and $obj.PSObject.Properties.Name -contains 'message') {
+    throw "API message '$($obj.message)' : $url"
+  }
+  return @($obj)
+}
+
+# ---- 1) 全量 list(按创建序分页;REST 的 direction 参数对 discussions 无效,只能从头翻到尾) ----
+$prevCount = 0
+if (Test-Path (Join-Path $OutDir 'list.json')) {
+  try { $prev = @((Get-Content (Join-Path $OutDir 'list.json') -Raw -Encoding UTF8 | ConvertFrom-Json)); $prevCount = $prev.Count } catch { $prevCount = 0 }
+}
+$all = @()
+$page = 1
+while ($page -le 50) {
+  $items = Get-Api "https://api.github.com/repos/$Repo/discussions?per_page=100&page=$page&sort=created"
+  if ($items.Count -eq 0) { Write-Output "page ${page}: 空页,列表结束"; break }
+  $all += $items
+  Write-Output ("page {0}: +{1} (累计 {2})" -f $page, $items.Count, $all.Count)
+  if ($items.Count -lt 100) { break }
+  $page++
+  Start-Sleep -Milliseconds 500
+}
+if ($all.Count -eq 0) { throw 'discussions 列表抓取失败(0 条)' }
+if ($prevCount -gt 0 -and $all.Count -lt [Math]::Floor($prevCount * 0.9)) {
+  throw "列表疑似缩水: 上次 $prevCount 条, 本次仅 $all.Count 条 —— 拒绝覆盖归档,请检查网络/配额后重跑"
+}
+
+# 按 number 去重(分页边界可能重复)
+$uniq = @{}
+foreach ($d in $all) { $uniq[[int]$d.number] = $d }
+$discs = @($uniq.Values | Sort-Object { [int]$_.number })
+$listPath = Join-Path $OutDir 'list.json'
+$discs | ConvertTo-Json -Depth 6 | Set-Content -Path $listPath -Encoding UTF8
+Write-Output "list.json: $($discs.Count) 条 -> $listPath"
+
+# ---- 2) 精选线程 + 评论 ----
+$sel = @()
+foreach ($d in $discs) {
+  $cat = $d.category.name
+  $c = [int]$d.comments
+  $t = [string]$d.title
+  $pick = $false
+  if ($cat -eq 'Announcements') { $pick = $true }
+  elseif ($cat -eq 'Q&A' -and $c -ge 1) { $pick = $true }
+  elseif ($cat -eq 'Ideas' -and $c -ge 1) { $pick = $true }
+  elseif (($cat -eq 'General' -or $cat -eq 'Show and tell') -and $c -ge 3) {
+    # 非社群拉群帖: 标题含拉群/扫码/加群/招聘/广告类词的不收
+    if ($t -notmatch '群|扫码|加群|招聘|内推|广告|投简历|纳新') { $pick = $true }
+  }
+  if ($pick) { $sel += $d }
+}
+$sel = @($sel | Sort-Object { [int]$_.number })
+Write-Output "精选线程: $($sel.Count) 条"
+
+if (-not $SkipComments) {
+  $n = 0
+  foreach ($d in $sel) {
+    $num = [int]$d.number
+    $comments = @()
+    $cp = 1
+    while ($cp -le 20) {
+      $ci = Get-Api "https://api.github.com/repos/$Repo/discussions/$num/comments?per_page=100&page=$cp"
+      if ($ci.Count -eq 0) { break }
+      $comments += $ci
+      if ($ci.Count -lt 100) { break }
+      $cp++
+      Start-Sleep -Milliseconds 300
+    }
+    $comments | ConvertTo-Json -Depth 6 | Set-Content -Path (Join-Path $OutDir "comments-$num.json") -Encoding UTF8
+    $n++
+    if ($n % 20 -eq 0) { Write-Output "comments: $n / $($sel.Count)" }
+    Start-Sleep -Milliseconds 200
+  }
+  Write-Output "comments: 完成 $n 个线程"
+  # 清掉列表里已不存在的旧 comments 文件
+  $keep = New-Object System.Collections.Generic.HashSet[string]
+  foreach ($d in $sel) { [void]$keep.Add("comments-$([int]$d.number).json") }
+  Get-ChildItem $OutDir -Filter 'comments-*.json' | Where-Object { -not $keep.Contains($_.Name) } | Remove-Item -Force
+} else {
+  Write-Output 'comments: 跳过(-SkipComments)'
+}
+
+# ---- 3) _selection.tsv 与 README.md ----
+$selLines = @('number' + "`t" + 'category' + "`t" + 'comments' + "`t" + 'title')
+foreach ($d in $sel) { $selLines += ("{0}`t{1}`t{2}`t{3}" -f $d.number, $d.category.name, $d.comments, ($d.title -replace "`t",' ')) }
+Set-Content -Path (Join-Path $OutDir '_selection.tsv') -Value $selLines -Encoding UTF8
+
+$cats = @{}
+foreach ($d in $discs) { $k = [string]$d.category.name; if (-not $cats.ContainsKey($k)) { $cats[$k] = 0 }; $cats[$k]++ }
+$utc = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
+$L = @()
+$L += '# 官方 GitHub Discussions 归档（自动生成，见抓取时间）'
+$L += ''
+$L += '> 来源：https://github.com/deepseek-ai/deepseek-harness/discussions （官方仓库 Issues 关闭，Discussions 为反馈主渠道）。'
+$L += '> 抓取：GitHub REST API（list 含每条正文；comments-<n>.json 为精选线程的全部评论）。'
+$L += "> 更新：提供 ``GH_TOKEN`` 后可由 ``scripts/archive-discussions.ps1`` 幂等刷新；抓取时间 $utc (UTC)。"
+$L += ''
+$L += '## 文件'
+$L += ''
+$L += "- list.json — 全部 $($discs.Count) 条讨论（含 title/body/category/answers/labels 等字段，正文即模型可读文档）。"
+$L += "- comments-<n>.json — 精选 $($sel.Count) 条线程的评论（选择规则：Announcements/Q&A/Ideas 评论>=1；General/Show and tell 评论>=3 且非社群拉群帖）。"
+$L += '- _selection.tsv — 精选线程清单（编号/分类/评论数/标题）。'
+$L += ''
+$L += '## 分类统计'
+$L += ''
+foreach ($k in @($cats.Keys | Sort-Object)) { $L += "- $k：$($cats[$k]) 条" }
+$L += ''
+$L += '## 有归档评论的精选线程'
+$L += ''
+$L += '| # | 分类 | 评论 | 标题 |'
+$L += '|---|---|---|---|'
+foreach ($d in $sel) {
+  $title = ($d.title -replace '\|','\|' -replace "[\r\n]",' ')
+  $L += "| [#$($d.number)](https://github.com/deepseek-ai/deepseek-harness/discussions/$($d.number)) | $($d.category.name) | $($d.comments) | $title |"
+}
+Set-Content -Path (Join-Path $OutDir 'README.md') -Value ($L -join "`r`n") -Encoding UTF8
+Write-Output "DONE: list=$($discs.Count) selected=$($sel.Count) -> $OutDir"

package/scripts/download-community-articles.ps1

@@ -0,0 +1,188 @@
+# dsh-plugin-guide 社区文章归档脚本（幂等：已存在且非空则跳过）
+# 输出: downloads/web/community-articles/{zh,en,hn}/<slug>.html + _download.log + README.md
+# 来源: downloads/_research/{chinese,english}-community-scan.md 中标 200 的 URL + 08-15 增量扫描线索。
+#   已知反爬站(知乎/InfoQ/venturebeat/thenextweb/twitter/youtube/reddit/腾讯新闻 501 等)不在清单内,记录见两份扫描报告。
+# 注意: PS 5.1 下 curl 的 -A/-o 参数若经变量数组传入会被拆词;本脚本用 Invoke-Expression
+#   拼完整命令行字符串,引号在字符串内显式给出,规避该坑。
+# 参数: -Force 强制全部重下; -Lang zh|en|hn 只处理某语言段。
+param([switch]$Force, [string]$Lang = '')
+$ErrorActionPreference = 'Continue'
+$ProgressPreference = 'SilentlyContinue'
+
+$kb = Split-Path $PSScriptRoot -Parent
+$out = Join-Path $kb 'downloads\web\community-articles'
+$ua = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36'
+$curl = Get-Command curl.exe -ErrorAction SilentlyContinue
+if (-not $curl) { $curl = "$env:SystemRoot\System32\curl.exe" } else { $curl = $curl.Source }
+
+# slug => url(语言段前缀 zh:/en:/hn: 决定落盘目录)
+$list = @(
+  # ---------- zh ----------
+  'zh:cnblogs-pc2005-npm-publish = https://www.cnblogs.com/pc2005/p/22477987',
+  'zh:cnblogs-qq8864-session-export = https://www.cnblogs.com/qq8864/articles/22476471',
+  'zh:cnblogs-qq8864-plugin-vs-tool = https://www.cnblogs.com/qq8864/articles/22478648',
+  'zh:csdn-yuqingteck-hello-tool = https://yuqingteck.blog.csdn.net/article/details/163735126',
+  'zh:cnblogs-sing1ee-agent-loop = https://www.cnblogs.com/sing1ee/p/22479295',
+  'zh:cnblogs-sing1ee-guide = https://www.cnblogs.com/sing1ee/p/22455466',
+  'zh:cnblogs-knqiufan-context = https://www.cnblogs.com/knqiufan/p/22472410',
+  'zh:cnblogs-foxcharon-install = https://www.cnblogs.com/foxcharon/p/22467976',
+  'zh:cnblogs-pc2005-getting-started = https://www.cnblogs.com/pc2005/p/22477984',
+  'zh:cnblogs-adgine-ai-engineering = https://www.cnblogs.com/adgine-ai/articles/22473232',
+  'zh:cnblogs-itech-architecture = https://www.cnblogs.com/itech/p/22460843',
+  'zh:cnblogs-isLinXu-analysis = https://www.cnblogs.com/isLinXu/p/22457058',
+  'zh:csdn-damodev-monorepo = https://damodev.csdn.net/6a7dd787662f9a54cb9c6da0.html',
+  'zh:51cto-v4pro-runtime = https://www.51cto.com/article/852965.html',
+  'zh:51cto-blog-observability = https://blog.51cto.com/u_16175471/14797309',
+  'zh:aliyun-first-tutorial = https://developer.aliyun.com/article/1755786',
+  'zh:aliyun-everything-plugin = https://developer.aliyun.com/article/1755877',
+  'zh:bibigpt-skill-video = https://bibigpt.co/zh/blog/posts/deepseek-harness-skill-ai-video-summary',
+  'zh:aixq-visual-tutorial = https://www.aixq.cc/62178.html',
+  'zh:qbitai-review = https://www.qbitai.com/2026/08/472208.html',
+  'zh:zhidx-review = https://www.zhidx.com/p/584897.html',
+  'zh:pingwest-review = https://www.pingwest.com/a/316436',
+  'zh:dtinsight-review = https://www.dtinsight.com.cn/sys-nd/4072.html',
+  'zh:v2ex-1234341-quickref = https://global.v2ex.co/t/1234341',
+  'zh:v2ex-1234203 = https://global.v2ex.co/t/1234203',
+  'zh:v2ex-1234320-tools-limit = https://global.v2ex.co/t/1234320',
+  'zh:v2ex-1234424-shell = https://global.v2ex.co/t/1234424',
+  'zh:v2ex-1234521-v4flash = https://global.v2ex.co/t/1234521',
+  'zh:v2ex-1231389-pre-release = https://global.v2ex.co/t/1231389',
+  'zh:v2ex-1214141-hiring = https://global.v2ex.co/t/1214141',
+  'zh:36kr-black-whale = https://www.36kr.com/p/3938566998834308',
+  'zh:jiemian-lego = https://www.jiemian.com/article/14922169.html',
+  'zh:80aj-doc-reader = https://www.80aj.com/2026/08/14/agent-doc-reader-plugin/',
+  'zh:80aj-vscode-search = https://www.80aj.com/2026/08/14/deepseek-vscode-plugin-search/',
+  'zh:locdd-80299 = https://locdd.com/t/topic/80299/7',
+  'zh:locdd-80207 = https://locdd.com/t/topic/80207',
+  'zh:53ai-first-test = https://www.53ai.com/news/LargeLanguageModel/2026081423497.html',
+  'zh:53ai-plugin-tutorial-0815 = https://www.53ai.com/news/OpenSourceLLM/2026081561375.html',
+  'zh:csdn-zhuosj-black-whale = https://zhuosj.blog.csdn.net/article/details/163757323',
+  'zh:csdn-aiutools-install = https://aiutools.blog.csdn.net/article/details/163758630',
+  'zh:csdn-qq8864-plugin-tool = https://blog.csdn.net/qq8864/article/details/163760812',
+  'zh:163-architecture = https://www.163.com/dy/article/L4AHS9B70518R7MO.html',
+  'zh:163-install-tutorial = https://www.163.com/dy/article/L4AUJ7A305568W0A.html',
+  'zh:qq-news-hot = https://news.qq.com/rain/a/20260814A048HD00',
+  'zh:csdnnews-28k-star = https://csdnnews.blog.csdn.net/article/details/163747298',
+  'zh:geekpark-50k = https://w.geekpark.net/news/368809',
+  'zh:pedaily-investment = https://news.pedaily.cn/202608/567694.shtml',
+  'zh:weibo-beta-share = https://weibo.com/2/detail/5331613565062839',
+  'zh:csdn-aicoding-roles = https://aicoding.csdn.net/6a23863d662f9a54cb7a4fed.html',
+  'zh:aitop100-v01 = https://www.aitop100.cn/infomation/details/34468.html',
+  'zh:bilibili-BV1WmgF6qEMn = https://www.bilibili.com/video/BV1WmgF6qEMn/',
+  'zh:bilibili-BV1iAgc6xEj7 = https://www.bilibili.com/video/BV1iAgc6xEj7/',
+  'zh:bilibili-BV1KFgF6zEtk = https://www.bilibili.com/video/BV1KFgF6zEtk/',
+  'zh:bilibili-BV1NKgw6VErB = https://www.bilibili.com/video/BV1NKgw6VErB/',
+  'zh:bilibili-BV1o4gP6iEeo = https://www.bilibili.com/video/BV1o4gP6iEeo/',
+  'zh:bilibili-BV1vugA6FERZ = https://www.bilibili.com/video/BV1vugA6FERZ/',
+  'zh:bilibili-BV1VkgK6NEZS = https://www.bilibili.com/video/BV1VkgK6NEZS/',
+  'zh:bilibili-BV1eDgW6QEFx = https://www.bilibili.com/video/BV1eDgW6QEFx/',
+  'zh:bilibili-BV17ygc6tEE1 = https://www.bilibili.com/video/BV17ygc6tEE1/',
+  'zh:21jingji-jiazi = https://www.21jingji.com/article/20260521/herald/d706e7b6130739114b8761d933f7e546.html',
+  'zh:21jingji-wechat = https://m.21jingji.com/article/20260813/b78d3f9cd177ec3974c227ca1e9f7672.html',
+  'zh:ithome-beta-plugins = https://www.ithome.com/0/989/446.htm',
+  'zh:ai-indeed-timeline = https://www.ai-indeed.com/encyclopedia/29653.html',
+  'zh:yijunzhao-guide = https://yijunzhao.cn/archives/deepseek-harness-getting-started-guide-first-agent-framework',
+  'zh:gm7-install = https://www.gm7.org/archives/141339',
+  'zh:zol-v01 = https://ai.zol.com.cn/1231/12318730.html',
+  'zh:thepaper-three = https://www.thepaper.cn/newsDetail_forward_33785032',
+  'zh:donews = https://www.donews.com/news/detail/1/6670751.html',
+  'zh:chinaz-plugin = https://www.chinaz.com/ainews/30334.shtml',
+  'zh:wsisp-80k = https://www.wsisp.com/helps/94702.html',
+  'zh:eastmoney-black-whale = https://finance.eastmoney.com/a/202608123839370860.html',
+  'zh:sina-whale = https://www.sina.cn/news/detail/5331578031178880.html',
+  'zh:sina-wechat-account = https://www.sina.cn/news/detail/5331415036067930.html',
+  'zh:tmtpost-beta = https://www.tmtpost.com/8083615.html',
+  'zh:aihot-community = https://aihot.virxact.com/items/cmst6pn4b06aqro06xbl1wusy',
+  'zh:aihot-openrouter-ori = https://aihot.virxact.com/items/cmstacm1202dzro0xv735yk7c',
+  'zh:chaincatcher-beta = https://www.chaincatcher.com/article/2278625',
+  'zh:baijing-harness = https://jishuzhan.baijing.cn/article/3251',
+  'zh:sohu-28k = https://www.sohu.com/a/1062527577_115128',
+  'zh:locdd-80821-qqbot = https://locdd.com/t/topic/80821',
+  # ---------- en ----------
+  'en:rits-cordis = http://rits.shanghai.nyu.edu/ai/deepseek-harness-cordis-everything-is-a-plugin/',
+  'en:devto-onsen-guide = https://dev.to/onsen/deepseek-harness-developer-preview-full-guide-ocm',
+  'en:devto-reidmarlow-price = https://dev.to/reidmarlow/deepseeks-harness-is-the-price-signal-17bl',
+  'en:agentpedia-v01 = https://agentpedia.codes/blog/deepseek-harness-v0-1-plugin-agent-guide',
+  'en:explainx = https://explainx.ai/blog/deepseek-harness-v0-1-plugin-first-agent-stack-august-2026',
+  'en:agentbreaking = https://agentbreaking.com/blog/deepseek-harness-open-source-agent-framework/',
+  'en:xcmd-install = https://www.x-cmd.com/install/deepseek-harness/',
+  'en:dsh-index = https://dsh-index.xlings.org',
+  'en:xlings-dsh = https://openxlings.github.io/xim-pkgindex/en/packages/dsh/',
+  'en:36kr-en-minecraft = https://eu.36kr.com/en/p/3938774780263814',
+  'en:36kr-en-blackwhale = https://eu.36kr.com/en/p/3938566998834308',
+  'en:36kr-en-selfevolution = https://eu.36kr.com/en/p/3938795963137411',
+  'en:ollama-integration = https://docs.ollama.com/integrations/deepseek-harness',
+  'en:aiengineerguide = https://aiengineerguide.com/til/deepseek-harness/',
+  'en:julian-goldie = https://aisuccesslabjuliangoldie.com/blog/deepseek-harness/',
+  'en:gigazine-en = https://gigazine.net/gsc_news/en/20260814-deepseek-harness-v0-1',
+  'en:aibase-en = https://www.aibase.com/news/30334',
+  'en:pandaily-preview = https://pandaily.com/deepseek-harness-developer-preview-everything-is-a-plugin-black-whale-aug2026',
+  'en:edgen-300plugins = https://www.edgen.tech/en/news/post/deepseek-harness-enters-agent-market-with-300-plugins-challenging-codex',
+  'en:tmtpost-en = https://en.tmtpost.com/news/7995741',
+  'en:pandaily-funding = https://pandaily.com/deepseek-funding-expansion-hiring-harness',
+  'en:essamamdani = https://essamamdani.com/blog/deepseek-harness-plugin-first-agent-stack-2026',
+  'en:openrouter-ori = https://openrouter.ai/docs/guides/ori/harness',
+  'en:digg-webui-x = https://digg.com/tech/7fx4ofvh',
+  'en:digg-devs-beta = https://digg.com/tech/silt5bft',
+  'en:news-eink = https://news.e-ink.me/en/archive/2026-08-13/article/deepseek-harness-developer-preview',
+  'en:tipranks-openrouter = https://fastly.tipranks.com/news/private-companies/openrouter-expands-ai-model-orchestration-with-ori-deepseek-harness-integration',
+  'en:webgate-mit = https://web.gate.it/zh/news/detail/deepseek-open-sources-harness-v01-under-the-mit-license-rivaling-claude-23440280',
+  'en:blockbeats-v4pro = https://en.theblockbeats.news/flash/361500',
+  'en:runtimewire-harness = https://runtimewire.com/article/deepseek-open-sources-agent-harness-v4-pro-api-price-hike',
+  'en:digitalapplied-harness = https://www.digitalapplied.com/blog/deepseek-harness-open-source-agent-framework-2026',
+  'en:digitalapplied-v4pro-ga = https://www.digitalapplied.com/blog/deepseek-v4-pro-ga-official-release-2026',
+  'en:afbytes-venturebeat-mirror = https://afbytes.com/news/article/rss:f2c63a396b39d3537b5fd16ac4f5ca04f9574ad53febab5a97db5852c6/deepseek-harness-launches-as-open-source-rival-to-claude-code-alongside-v4-pro-on-api-with-higher-prices',
+  # ---------- hn ----------
+  'hn:49286003-cordis = https://hn.edgecompute.app/item/49286003',
+  'hn:49287821-xcmd = https://hn.edgecompute.app/item/49287821',
+  'hn:49294357-dshindex = https://hn.edgecompute.app/item/49294357',
+  'hn:49291049-xlings = https://hn.edgecompute.app/item/49291049',
+  'hn:49291893-jellyball = https://hn.edgecompute.app/item/49291893',
+  'hn:49285244-main = https://hn.edgecompute.app/item/49285244',
+  'hn:49285620-twitter-post = https://hn.edgecompute.app/item/49285620'
+)
+
+$log = New-Object System.Collections.Generic.List[string]
+$counts = @{}
+foreach ($entry in $list) {
+  $lang, $rest = $entry -split ':', 2
+  $slug, $url = $rest -split '=', 2
+  $slug = $slug.Trim(); $url = $url.Trim()
+  if ($Lang -and $lang -ne $Lang) { continue }
+  $dir = Join-Path $out $lang
+  New-Item -ItemType Directory -Force -Path $dir | Out-Null
+  $file = Join-Path $dir ($slug + '.html')
+  if (-not $Force -and (Test-Path $file) -and (Get-Item $file).Length -gt 500) {
+    $log.Add("SKIP`t$lang/$slug"); continue
+  }
+  $cmd = "& '$curl' -sSL --connect-timeout 10 --max-time 30 -A `"$ua`" -o `"$file`" `"$url`""
+  try { Invoke-Expression $cmd | Out-Null } catch { $log.Add("FAIL`t$lang/$slug`tinvoke-error"); continue }
+  if (Test-Path $file) {
+    $len = (Get-Item $file).Length
+    if ($len -gt 500) { $log.Add("OK`t$lang/$slug`t$len bytes") }
+    else { Remove-Item $file -Force; $log.Add("FAIL`t$lang/$slug`ttoo-small($len)") }
+  } else { $log.Add("FAIL`t$lang/$slug`tno-file") }
+}
+foreach ($l in @('zh','en','hn')) {
+  $d = Join-Path $out $l
+  if (Test-Path $d) { $counts[$l] = (Get-ChildItem $d -Filter *.html -File).Count }
+}
+$log | Set-Content (Join-Path $out '_download.log') -Encoding UTF8
+
+$utc = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mmZ')
+$L = @()
+$L += '# 社区文章归档（HTML 快照）'
+$L += ''
+$L += "> 抓取: $utc (UTC) via scripts/download-community-articles.ps1（幂等，-Force 全量重下）。"
+$L += '> 反爬/需浏览器站点(知乎/InfoQ/venturebeat/TNW/Twitter/YouTube/Reddit 等)不在清单,线索见 downloads/_research/*-community-scan.md。'
+$L += ''
+$L += '| 语言段 | 篇数 |'
+$L += '|---|---|'
+foreach ($l in @('zh','en','hn')) { $L += "| $l/ | $($counts[$l]) |" }
+$L += ''
+$L += '## 归档明细'
+$L += ''
+$L += '见 _download.log（OK/SKIP/FAIL + 字节数）。'
+Set-Content -Path (Join-Path $out 'README.md') -Value ($L -join "`r`n") -Encoding UTF8
+Write-Output ("DONE: zh={0} en={1} hn={2} -> {3}" -f $counts['zh'], $counts['en'], $counts['hn'], $out)
+$log | Write-Output

package/scripts/download-community-repos.ps1

@@ -0,0 +1,232 @@
+# 社区插件开发相关仓库全量下载(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