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，侧边栏出现「🔍 加密研报」入口。
使用
- 新建会话，预设选择器选 「加密研报」（分析大脑：persona + 5 步思维链 + 报告模板）。
- 输入：
分析 $ETH、调研 Render、分析 0x合约地址等。 - Agent 自动调用
crypto_*工具取真实数据，按模板生成报告，并调用crypto_save_report入库。 - 点侧边栏「🔍 加密研报」→ 查看历史报告、收藏、导出。
⚙️ 配置
打开工作台 →「⚙ 设置」页签：
| 配置项 | 说明 |
|---|---|
coingeckoDemo / coingeckoPro |
CoinGecko key（demo 免费，提升限频；pro 更高） |
cmc |
CoinMarketCap key（行情兜底） |
moralis |
Moralis key（持币地址分布） |
cryptocompare / tavily |
新闻源 key（三级降级：CryptoCompare → Tavily → DuckDuckGo） |
dune |
Dune key（预留，需先在 Dune 建查询） |
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。