dsh-aigc-radar
v0.2.5
Published
AIGC Radar for DeepSeek Harness — curated AI project search with native search cards, powered by the AIGC_NEWS library
Maintainers
aaronclemensReadme
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 的能力。