dsh-lighthouse

dsh-lighthouse（灯塔）

一屏看清你发出去的每个作品现在怎么样了 —— 而且能点开看。

界面观察区（v0.2 新增）

DSH 侧栏多一个灯塔图标，点开就是一块观察面板 —— 每个作品一张卡：

右上角一个「刷新」，打开面板时自动拉一次；数据来自 host 那条只读接口 /dsh-lighthouse/status —— 同一个数字在面板、工具、卡片里必然一致（走的是同一条采集路径）。

本地拿的是什么版本、GitHub 有没有动静、市场收没收录、被下载多少次、给收录 PR 等了多久（对比上游中位数）—— 全部来自 API，一个数字都不经模型生成，读不到就写"读不到"。

名字的来由：船下水之后就看不见了。灯塔是岸上那盏灯 —— 专门盯着"我的作品现在在哪一步、有没有人上船"。

---

它回答什么问题

• 我发出去的东西，市场收了吗？（"未收录" vs "已收录"）
• 有没有人用？下载多少、在同类里排第几？
• 收录 PR 等了多久？——和上游的中位数比，算不算久？
• 本地那份和线上那份，是同一条船吗？（版本、最后推送时间）
• npm 上有没有？（默认查，可关）

作品多了怎么办（v0.2.5）

≤ 12 个作品时是一作品一张卡（信息最全）。超过 12 个自动切紧凑视图：

• 文本回执：一行一个作品（名字｜v版本｜star｜市场｜PR 等待），不再每个占两行；
• HTML 卡片：换成一张排序表格（作品 / 分类 / 版本 / GitHub / 市场 / 收录 PR），汇总条与表头滚动吸顶， 不用滑到底再回来对表头；
• 排序按"要不要人管"：①需要处理（仓库读不到 / 没有 PR / 市场读不到）②等收录（等得久的在前）③已收录。 50 个作品时，你第一眼看到的就是那几个有问题的，而不是按名册顺序从上翻。

表格是纯静态 HTML（内联样式，无脚本），所以不能搜索/过滤 —— 需要筛选就走名册（lighthouse_fleet）把范围缩到一组。

中文名与直达链接（v0.3.0）

每个作品显示为 dsh-lighthouse（灯塔） —— 英文名 + 中文名，名字本身就是超链接，点开直达仓库； 卡片里另有一行「直达」，把 GitHub / npm / 市场条目页分别列出来（哪个地址能确定才给，绝不编）。

中文名从哪来：名册的 nameZh 优先，其次本地 package.json 的 dsh.displayName。 滑道发过布（尤其改名）之后跑一次 lighthouse_fleet action="sync"： 它会读每个作品本地的 package.json，把空着的中文名与链接回填进名册， 并列出「名册包名与仓库对不上」的情况（只报告，不擅自改名）。这样滑道更新了，灯塔也就跟上了。

多来源状态

适用范围（一句话）：数据源只有 GitHub（API）+ 市场登记表 + npm。 如果作品只放在 Gitee / GitLab，灯塔读不到那边的 star 与推送时间 —— 名册里只能给它写一条 mirrors 链接（点了能跳过去），不会假装有数据。

每个作品都按来源分开报：本地（版本/文件数/有没有自测）、GitHub（仓库在不在、star、最后推送）、 npm（有没有包）、市场（收录/下载/同类排名）、收录 PR（等待时长 vs 上游中位数）。 某一源读不到就写"读不到"，不会拿另一源的数凑。

只读承诺

• 全部是 GET 请求：不动仓库、不开 PR、不写任何远端。
• 不编数字：任何一个数据源读不到，就标 读不到（原因），不会用估算值糊过去。
• 名册显式：灯塔照着名册看，不自动发现作品 —— 从目录名或包名前缀去猜"哪些是你的作品"， 猜错了会把别人的仓库报进你的看板。

名册（fleet）

默认路径 ~/.dsh/lighthouse-fleet.json：

{
  "version": 1,
  "owner": "7gzgn",
  "upstream": { "owner": "awesome-dsh-plugin", "repo": "awesome-dsh-plugin", "branch": "main" },
  "works": [
    {
      "name": "dsh-slipway",
      "repo": "dsh-slipway",
      "category": "tools",
      "localDir": "D:\\dsh\\projects\\dsh-slipway"
    }
  ]
}

• owner 与 works 必填（缺了直接报错，不猜）。
• localDir 可省：省了就只看线上那一半。
• 用工具或命令写它：

lighthouse_fleet action=init owner=7gzgn works='[{"name":"dsh-slipway","repo":"dsh-slipway","category":"tools","localDir":"D:\\dsh\\projects\\dsh-slipway"}]'
dsh-lighthouse init --owner 7gzgn --works '[…]'

安装

市场收录后在 DSH 里搜 dsh-lighthouse 安装。手动安装：

New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-lighthouse" -Target "D:\dsh\projects\dsh-lighthouse"
# profile 的 package.json：dependencies 加 "dsh-lighthouse": "link:D:/dsh/projects/dsh-lighthouse"
# 并把 "dsh-lighthouse" 加进 dsh.profile.bundles（漏了不加载）→ 重启 DSH

用法

工具

lighthouse_report  [fleetFile] [html] [includeNpm] [marketUrl] [reportDir]
lighthouse_fleet   action=show|init …

lighthouse_report 返回一段汇总文本，并把一张单文件 HTML 卡片落到 ~/.dsh/lighthouse-reports/lighthouse-<时间戳>.html —— 无外链、无脚本依赖，可直接打开或截图。

命令

dsh-lighthouse report [--fleet <路径>] [--dir <卡片目录>] [--no-npm] [--no-html] [--json]
dsh-lighthouse fleet  [--fleet <路径>]

数据从哪来

市场地址为什么不能再写死端口：登记表路由挂在宿主自己的 web 服务上，端口每次启动都可能变； 写死 19387 的后果不是报错，而是报告里一片 0 收录 / 0 下载 —— 看起来像"没人用"， 其实是"没读到"。v0.2.4 起：默认向 webServer.getOrigin() 要地址；读不到时整行不报数， 并明确写"市场数据读不到（不显示 0，免得被当成没人用）"。

PAT 依次找：tokenFile → 环境变量 DSH_SLIPWAY_TOKEN_FILE → ~/.dsh/.gh-token → D:\dsh\.gh-token。

它还会替你盯一件事

哪些收录 PR 已经等了超过上游中位数。报告里单独一行点名（#编号（等了多久））， 没有超的也明说"都还在正常等待区间" —— 这样"要不要去催"不用自己算。

兼容性

• 运行时：DSH 0.2.1-rc.2（实测使用的版本）。
• peerDependencies 用显式范围；拿不到 @deepseek-ai/dsh-tools 时 defineTool 退化成恒等（CLI/测试照常）。
• 插件只注册工具与一段提示词，不挂任何前台服务、不轮询、不占资源（只在被调用时跑一次）。

自测

node test/smoke.mjs    # 全假网络（GitHub/市场/npm 都是假的），不碰真宿主、不碰外网

License

MIT