dsh-crypto-analyst · 加密货币深度调研智能体

DeepSeek Harness（DSH）插件：输入一个币种/符号/合约地址，自动按 5 步思维链调取真实链上/行情/融资/新闻数据，产出机构级中文研报；网页工作台查看、收藏、导出 PDF/MD。

---

它能做什么

• 机构级中文研报：按「赛道叙事 → 通俗类比 → 硬核数据验证 → 代币经济学 → 风险结论」五步思维链，产出约 4000 字、带综合评级和多空逻辑的深度报告。
• 数字绝不编造：所有数据只来自数据源工具，附来源链接与快照时间戳；工具无数据/降级时如实标注「数据缺失」。
• 报告工作台：侧边栏「🔍 加密研报」入口 → 历史中心（搜索/筛选/收藏）、报告阅读器、指标卡片、7D/30D 价格趋势图。
• 一键导出：MD 下载 + PDF（浏览器打印）。
• 可配置：API Key、网络代理都在工作台「⚙ 设置」页签里自助填写。

快速开始

前置要求

• 已安装 DeepSeek Harness（dsh 命令可用）
• Node.js ≥ 22、pnpm

安装

# 方式 A：从 GitHub 安装（拉取源码并构建）
dsh plugin --profile web add github:hnlisf/dsh-crypto-analyst

# 方式 B：本地开发安装（已在本机验证）
git clone https://github.com/hnlisf/dsh-crypto-analyst.git
cd dsh-crypto-analyst
pnpm install && pnpm build
dsh plugin --profile web add link:$(pwd)/packages/dsh-crypto-analyst

安装后重启 dsh web，侧边栏出现「🔍 加密研报」入口。

使用

1. 新建会话，预设选择器选 「加密研报」（分析大脑：persona + 5 步思维链 + 报告模板）。
2. 输入：分析 $ETH、调研 Render、分析 0x合约地址 等。
3. Agent 自动调用 crypto_* 工具取真实数据，按模板生成报告，并调用 crypto_save_report 入库。
4. （可选）研报配图：Agent 用 crypto_report_image 工具（MiniMax image-01，可带 style 固定风格：deep-finance / academic / neon / flat / retro）生成封面/配图；并自动用 crypto_report_outline 生成报告结构图（SVG 精确版，章节卡片流程图，5 种风格可选）。图片进报告图片库、工作台直接渲染；提示词模板可参考已安装的 gpt-image-2 skill（~/.dsh/skills/gpt-image-2，18 类 80+ 模板）。
5. 点侧边栏「🔍 加密研报」→ 查看历史报告、收藏、导出。

⚙️ 配置

打开工作台 →「⚙ 设置」页签：

配置项	说明
coingeckoDemo / coingeckoPro	CoinGecko key（demo 免费，提升限频；pro 更高）
cmc	CoinMarketCap key（行情兜底）
moralis	Moralis key（持币地址分布）
cryptocompare / tavily	新闻源 key（三级降级：CryptoCompare → Tavily → DuckDuckGo）
dune	Dune key（预留，需先在 Dune 建查询）
imageGen	MiniMax 图像生成 key（platform.minimaxi.com 获取，研报配图用）
imageBaseUrl	MiniMax 端点（默认 https://api.minimaxi.com/v1，国内直连）
imageModel	MiniMax 模型（默认 image-01）
openaiImageKey	OpenAI 兼容图像 key（gpt-image-2，画质更佳；可填第三方网关/中转站 key）
openaiImageBaseUrl	OpenAI 兼容端点：填前缀（默认 https://api.openai.com/v1）或完整端点（如 https://apidock.ai/v1/images/generations）均可
openaiImageModel	OpenAI 兼容模型（默认 gpt-image-2）
proxy	HTTP 代理（如 http://127.0.0.1:10809）；留空自动探测系统代理/环境变量

全部 key 存本机私有文件（0600），不写报告、不写日志、导出不含 key。

数据源

数据源	用途	状态
CoinGecko	价格/市值/排名/供应/社交/开发（主源）	✅
CoinMarketCap	行情兜底	✅
DefiLlama	协议 TVL / 费用 / 国库	✅
Moralis	持币地址分布	✅
GeckoTerminal	赛道热点池	✅
CryptoCompare / Tavily / DuckDuckGo	新闻聚合（三级降级）	✅
RootData	融资	⚠️ 无官方 API（页面有验证码），标注数据缺失
Tokenomist	解锁计划	⚠️ 数据在 RSC 流中，标注数据缺失
Dune	日活地址	⏳ 预留（需用户自建查询）

报告结构

# 《{项目名}》深度调研报告
## 0. 执行摘要（Thesis + 综合评级 + 核心结论 + 关键风险）
## 1. 赛道与叙事定位（周期阶段/天花板/热点匹配/竞争格局）
## 2. 通俗化类比（Web2 对标 + 类比边界）
## 3. 项目基本面（简介/团队/融资/代币模型/社区持币）
## 4. 硬核数据验证（核心指标 + 横向对比 + 数据揭示的真相）
## 5. 代币经济学分析（供给解锁/需求价值捕获/价格压力）
## 6. 新闻与社交媒体情绪（每条新闻：标题+摘要+来源+链接）
## 7. 项目风险点（风险→分析→触发信号→应对）
## 8. 结论与操作建议（Bull/Bear + 仓位纪律 + 观察阈值）
## 附录：数据来源清单

工作原理

• 插件形态：遵循官方 Cordis 插件模型，一个插件 = host 半（Node 进程内：数据服务/工具/路由/报告库）+ 浏览器半（Web GUI：报告工作台 UI），经 package.json 的 dsh.bundle.patch + dsh.client 接入。
• 分析大脑：~/.dsh/.agent-presets/crypto-analyst/ 的 agent 预设注入 persona、5 步思维链、报告模板与写作规范（反 AI 味、数据解读、可证伪判断）。
• 数字铁律：agent 只能通过 crypto_* 工具取数，工具返回带 source + fetchedAt；失败即标注「数据缺失」，绝不编造。

开发

pnpm install     # 安装依赖
pnpm typecheck   # 类型检查（tsc --noEmit）
pnpm build       # 编译 lib/（含 client 打包）
pnpm test        # 单元测试（Node 内置 node:test，30 个）

• 里程碑：M0 脚手架 → M1 数据层 → M2 agent 预设/工具 → M3 报告工作台 → M4 导出打磨。
• 工程方法：遵循 harness 工程（仓库即系统记录、一次一个功能、闭环复盘、验证才算完成）。
• 官方文档与 SDK 参考见 PRD §11。

目录结构

dsh-crypto-analyst/
├─ packages/dsh-crypto-analyst/   # 插件包（Cordis 双半区 bundle）
│  ├─ src/
│  │  ├─ index.ts                 #   host 半入口（工具/设置/路由/报告库）
│  │  ├─ tools.ts                 #   crypto_* 工具（defineTool）
│  │  ├─ routes.ts                #   HTTP 路由（报告/设置/指标）
│  │  ├─ report-store.ts          #   报告库
│  │  ├─ core/                    #   数据层（客户端/缓存/解析/设置）
│  │  └─ client/                  #   浏览器半（工作台 UI，零打包器单文件）
│  ├─ presets/crypto-analyst/     #   「加密研报」agent 预设
│  ├─ tests/                      #   单元测试
│  └─ scripts/                    #   client 打包 / 冒烟脚本
├─ PRD.md                         # 产品需求
├─ feature_list.json              # 功能清单（scope 真源）
├─ docs/                          # 计划、复盘、进度、公众号文章
└─ .github/workflows/ci.yml       # CI（typecheck + build + test）

文档

• PRD.md — 产品需求（功能 FR-1~FR-12、报告模板、架构、工程方法、DoD）
• docs/PLAN.md — 分里程碑实施计划
• docs/progress.md — 进度手账
• docs/reviews/ — 里程碑复盘
• feature_list.json — 机器可读功能清单

参与

欢迎提 issue / PR。开发遵循官方 Cordis 插件模型与 harness 工程思想，请先读 AGENTS.md 与 PRD.md。

License

Apache-2.0