灯塔看板 7gzgn/dsh-lighthouse

dsh-lighthouse（灯塔）

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

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

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

| 看什么 | 怎么显示 |
| 发布了没有 | ✅ 已发布 ／ ❌ 仓库不存在 ／ ❌ 读不到 |
| 市场收录 | ✅ 已收录（带下载量）／ ⏳ 收录中 ／ ❌ 读不到 |
| 收录 PR | ✅ 已合并 ／ ⏳ 等 N 小时（天）／ —— 没有 |
| 星 · 关注 · 留言 | ⭐ / 👁 / 💬 三个数字（GitHub stars / watchers / open issues） |
| 本地与推送 | 本地版本 · 文件数 · 最后推送时间 |

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

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

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

它回答什么问题

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

只读承诺

- 全部是 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 <路径>]

数据从哪来

| 来源 | 取什么 | 备注 |
| 本地工程 | package.json 的版本、文件数、有没有 test/smoke.mjs | 只读文件 |
| GitHub API | 仓库是否存在、star/fork、最后推送、我开的收录 PR 状态 | 需要 PAT（repo scope）时更全 |
| 市场接口 | GET <marketUrl>/dsh-market/registry（要同源头，否则被拒） | 默认 http://127.0.0.1:19387；登记表只拉一次 |
| npm registry | 包在不在 | 默认开，--no-npm / includeNpm:false 可关 |

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

兼容性

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

自测

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

License

MIT