dsh-aigc-radar

English | 简体中文

面向 DeepSeek Harness（dsh）的 AIGC Radar 项目搜索插件。

别再重复造轮子。 在你规划与实现的过程中，agent 会主动检索 AIGC Radar 精选项目库，在你写下第一行代码之前，找出已经解决同类问题的成熟、经实战验证的项目。检索结果以 dsh Web UI 原生搜索卡片 呈现——不是原始 markdown——并且在会话回放中完整保留。

功能一览

工具	作用
search_ai_projects	检索 AIGC Radar 精选项目库：500 星以上准入的 GitHub 项目，附带分类、中英双语标签与描述、每日星增指标
get_project_categories	列出分类体系（一级分类 + 二级分类计数），用于筛选条件发现

两层路由让发现成为自动行为，而非需要主动点用：

• 显式发现——直接问「找个能做 deep research 的开源框架」，agent 即返回带星标、带分类的结果，无需说「用一下这个工具」
• 主动复用检查——在 agent 动手实现大型模块或子系统之前（认证、支付、工作流引擎、搜索/索引、协议实现、端到端 RAG/Agent 管线……），它会自发先查一次库，让成熟方案在任何人重造之前浮出水面。细粒度工作（修 bug、改名、调样式、CRUD）被刻意排除在外

为什么是原生插件而不是 MCP server？

AIGC Radar 本身也提供 MCP server——而本插件现在就跑在同一个 MCP 端点之上（POST /api/mcp），每次调用都计入同一套限速与配额。插件在此之上额外提供：

• 原生 web 搜索卡片——结构化结果在 Web UI 中渲染为卡片，并在会话回放时忠实重建（presentationMeta），这是 MCP 传输无法表达的
• 带类型的规范化输出——结果是一个经过校验的 JSON 值，Code Mode 可以直接编程组合（await tools.search_ai_projects({ q: 'mcp' })），带完整类型推断
• 第一方提示词路由——发现路由指引写在系统提示词装配层，而不是可能被客户端截断的 MCP instructions 里

实测性能

搜索工具就是一次到 AIGC Radar 公共边缘的 HTTPS 调用——下面的数字测量的是完整链路，2026-08-18 测自中国家庭宽带（GeoDNS → 国内边缘），使用 scripts/benchmark-search.sh（10 条代表性中英查询 × 3 轮，打向 https://aigcnews.cn/api/mcp）：

指标	数值
搜索延迟 p50	355 ms
搜索延迟 p95	810 ms
在库精选项目	18,426 个——全部高于 500 星准入线
分类体系	11 个一级分类，中英双语标签与描述

基于 MCP 接口测量的索引质量基准——端到端比 WebSearch 快 3.5×（中位 7.4 s vs 25.8 s）、首工具路由准确率 98.3%（59/60 次试验）——见主仓 benchmark 章节；本插件用同一套 API 服务同一份数据集，这些数字同样成立。

安装

需要 dsh（npx @deepseek-ai/dsh web）。

推荐——从 npm 安装预构建包：

dsh plugin --profile web add dsh-aigc-radar

需要可复现安装时，可固定已发布版本：

dsh plugin --profile web add [email protected]

源码兜底——从 GitHub 安装：

dsh plugin --profile web add github:Kaixxrua/dsh-aigc-radar

从 Git 安装会运行包内的 prepare 构建，pnpm ≥10 默认拒绝，需要先放行：把 pnpm 打印出来的包名写进 profile 的 pnpm-workspace.yaml：

allowBuilds:
  dsh-aigc-radar: true

然后重跑 GitHub add。想让源码安装保持不可变，可以固定提交（github:Kaixxrua/dsh-aigc-radar#<sha>）。

不启动即可验证：

dsh --profile web --dump-config   # 能看到 "# == dsh-aigc-radar" 配置层

更新

在声明的 semver 范围内更新 npm 安装：

dsh plugin --profile web update dsh-aigc-radar

更新后重启 dsh 才会加载新版本——正在运行的 dsh 进程不会热切换。

从 0.2.2 起，插件自身也会察觉新版本：dsh 启动时每进程做一次只读的 npm registry 检查，发现新版后 agent 会在下一轮对话开始时转达确切的更新命令。插件不会改动自身的安装目录。在插件配置中设 updateCheck: false 可关闭该检查。

如果固定了精确版本（例如 [email protected]），需显式指定目标版本：

dsh plugin --profile web add dsh-aigc-radar@<版本>

Git/Git SHA 或分支、file/link、workspace、tarball 以及本地路径安装仍需手动维护，更新命令不会改动它们。启动时自动更新检查尚未随官方 dsh 发布；在此之前，以上命令就是更新路径。

推荐：去源站注册并领一个免费 token。 插件开箱即可匿名使用，但匿名调用共享 30 次/日/IP 的桶；免费账号为每日 60 次并共享滚动 30 天 1,200 次，会员账号为每日 400 次并共享滚动 30 天 8,000 次。在 aigcnews.cn 注册并在 /mcp 页面创建 MCP token（搜索不需要任何特殊 scope），粘贴为下方配置里的 mcpToken。详见配额与 MCP token。

配置

默认指向公共部署。在你 profile 的 cordis.patch.yml 中覆盖该行（patch 会整体替换该行的 config）：

- replace:
    - id: aigc-radar
      name: dsh-aigc-radar
      config:
        apiBase: 'https://aigcnews.cn'   # 或你自托管的 AIGC_NEWS 源站
        mcpToken: ''                     # 在 {apiBase}/mcp 创建的 MCP token；留空 = 匿名
        timeoutMs: 20000
        maxPageSize: 10                  # MCP 契约上限为 20
        updateCheck: true                # 设为 false 关闭每进程一次的新版本检查

配额与 MCP token

每次调用都落在 MCP 端点的配额域内——匿名调用按 IP 分桶，token 调用按账号分桶：

调用方	配额	窗口
匿名（无 mcpToken）	30 次工具调用	每日，按 IP
免费账号 token	每日 60 次 + 1,200 次工具调用	日 pacing + 30 天滚动
会员 token	每日 400 次 + 8,000 次工具调用	日 pacing + 30 天滚动

要跳出匿名桶，到 aigcnews.cn/mcp 创建 token（搜索不需要特殊 scope）并设为 mcpToken。token 以明文保存在你的 dsh profile 配置里，与你的 LLM key 同级。登录档先检查日 pacing 桶，日限额触发时不会消耗月度配额。配额耗尽时工具会返回可操作的错误信息——哪个桶、限额多少、要等多久或去哪升级——agent 可以把它转述给你，而不是静默失败。

从源码 checkout 开发

以下命令面向从 Git checkout 开始开发的贡献者。test、verify 和 smoke 都使用构建后的 bundle；verify 和 smoke 还会调用真实 MCP 端点。

pnpm install
pnpm build        # tsdown → dist/
pnpm typecheck    # tsc --noEmit
pnpm test         # node --test（针对构建产物的 client 单测）
pnpm verify       # 验证注册、卡片、路由和真实搜索
pnpm smoke        # 通过构建后的 client 打真实 MCP 端点

从 dsh 源码 checkout 直接加载而无需安装：

pnpm dsh --profile web --patch /path/to/dsh-aigc-radar/cordis.dev.yml

其中 cordis.dev.yml 以绝对路径插入该行：

- insert:
    - id: aigc-radar
      name: /absolute/path/to/dsh-aigc-radar/dist/index.mjs

数据与归因

数据由 AIGC Radar 提供——你的 dsh 实例调用的是与 AIGC Radar MCP server 相同的 MCP 端点，配额与限速也完全相同。精选库只覆盖 500 星以上的 GitHub 项目；通用非 AI 的 GitHub 搜索（带直连 GitHub 兜底）按设计仍属 MCP server 的能力。

许可证

MIT