dsh-my-homepage

dsh-my-homepage

把多个信息源聚合成一个小组件式个人主页，每个源有自己的卡片形态。
A widget-style personal homepage for DeepSeek Harness.

简体中文 · English

---

在 DSH 的侧栏多一个「工作台」，点开就是你的主页：顶部一条问候与状态，下面一整块 bento 网格，每张卡是一个信息源。

特性

• 一个源 = 一个组件。 源自己声明卡片形态（kind）与标题，客户端照着渲染 —— 加一个源就多一张卡，客户端一行都不用改。
• 一种数据一种卡片，不是一种通用列表。 feed 是图片主导的新闻卡、papers 用论文真实封面、media 是 16:9 封面加播放角标、products 是字母徽标加一句话、rank 是编号列表。
• 缺图就去那个页面取封面。 AIHOT 和 Product Hunt 的接口本身不带图片，所以宿主半会去条目链接的页面读 og:image（也吃 twitter:image 和 JSON-LD），每个页面只读一次、只读前 160KB 就断开、结果永久缓存；读不到图的页面也会被记下来，不会反复请求。
• 零依赖、零构建。 纯 JavaScript，package.json 里没有 dependencies，没有打包步骤 —— 装完即用。
• 自带出网层。 每源独立节奏、条件请求（ETag/304）、全局并发上限、失败按 1/2/4… 分钟递增重试，一个源坏掉不影响别人。
• 内容只当资料。 抓到的第三方文本一律不执行其中的指令；每条都带来源与原文链接。
• 也能喂给模型。 注册了 workbench_brief / workbench_refresh / workbench_sources 三个工具，配合 DSH 自带的定时任务就能做每日早报。

内置信息源

安装

前置：DeepSeek Harness >=0.2.0-rc.1、Node.js >=20。

从 GitHub 直接装（Web profile）：

dsh plugin --profile web add github:CaiZongyuan/dsh-my-homepage

桌面端可以在「设置 → 插件」里安装；本地开发时也可以用插件管理器指向本目录。

装好之后重启一次 DSH（宿主插件是按 specifier 缓存的，改动要新进程才生效），刷新页面，侧栏就会出现「工作台」。

配置

cordis.patch.yml 的 config 目前只有一项：

想关掉某个源，编辑本包的 SOURCES 注册表把对应项注掉即可 —— 这就是唯一的扩展点。

加一个源

{
  id: 'my-source',
  label: '我的源',
  cadenceMinutes: 180,
  widget: { layout: 2, kind: 'list', colSpan: 2, rowSpan: 2, title: '我的源', hint: '说明' },
  async load(signal, previous) {
    // 返回 { items: [{ nativeId, title, url, publishedAt, summary, score, category, origin }], etag }
  },
}

kind 决定用哪个渲染器与默认尺寸（feed / papers / media / products / rank）。

开发

npm run check         # 三个文件的语法检查
npm run test          # 完整自测（会联网实拉 5 个源）
npm run test:offline  # 只跑离线 fixture 与结构断言（CI 用这个）

dev/selftest.mjs 用假 ctx（假的 storageDomain.open / webServer.register / tools.register / effect）直接跑真的 apply()，并用假 req/res 打自己注册的路由。宿主的改动要重启才生效，所以先在本地把逻辑跑一遍比反复重启快得多。

架构与取舍记录在 docs/design.md。

数据来源与合规

• 抓到的内容版权归各原始来源。本插件只做个人非商业聚合与展示。
• AIHOT 明确允许个人非商业使用，并保留 attribution 与原文链接；其服务条款见 https://aihot.news/terms。
• 抓到的第三方文本一律视为资料，不作为指令执行。
• 请遵守各站点的 robots 与使用条款；默认节奏已经按各站公开的缓存与限流建议设置。

许可

MIT