前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者根据具体工作流扩展功能。在会话开发中，若需集成诗词查询功能，通常需要调用外部 API 或在对话中手动输入指令。这款插件在会话页头注册了「诗词」标签页，提供了一套免 token 的查询方案，与「对话」和「轨迹」标签页并列。
核心定位¶
由 runcat-tommy 维护的联网工具插件。它通过在会话页头新增「诗词」标签页，解决在 DSH 环境中直接检索中文诗词的需求，同时不消耗模型配额。
安装与启用¶
安装前需确保已安装 pnpm。执行以下命令安装插件：
dsh plugin --profile web add dsh-chinese-poetry
安装完成后重启 dsh web，在任意会话的页头标签栏即可看到新增的「诗词」标签页。
核心功能¶
该插件在公共数据源之上做了面向查询使用的封装与优化：
- 免 token 的会话页视图：在会话页头注册「诗词」标签页，无需任何模型 Key，纯前端调用公共接口。
- 健壮的数据层：内置令牌桶限速（搜索 6 次/分、其它 15 次/分）、本地缓存、429 指数退避、连续失败降级为缓存 / 离线兜底，避免被限流打挂。
- 朝代纠偏表：公共接口对部分诗人（尤其宋代）的朝代标注有误，本插件内置常见诗人朝代校正表，展示时自动纠正。
- 离线兜底表：内置约 90 首常备诗词，断网或接口不可用时仍能演示；2 字内短查询走本地精选，3 字以上才检索全库。
- 交互功能：支持搜索框输入词/句并按作者/朝代/体裁筛选、飞花令（输入单字随机换诗）、节日专题（春节/中秋等）、收藏与历史记录、简繁切换。
- 输出与集成：提供分享卡片图（生成可下载的 PNG）；AI 解读功能将提示词写入 dsh 会话输入框，由用户手动确认发送，复用现有模型配额。
典型用法¶
- 打开一个会话，点击页头「诗词」标签进入界面。
- 在搜索框输入关键词，或使用下拉菜单筛选作者、朝代、体裁。
- 使用「飞花令」输入单字，点击切换查看含该字的诗词。
- 点击卡片图生成并下载分享图片。
- 点击「AI 解读」，将解读提示词填入输入框，按回车发送给模型。
注意事项¶
- 版本要求：要求 dsh web 0.1.0-rc.6 或更新版本。
- 数据源：依赖诗泉 (poetry.palemoky.com)，该服务免费、无需注册、CORS 全开。若查询较慢，多为服务端响应所致。
- 配额消耗：AI 解读功能透传给 dsh 会话，消耗用户已有的模型配额。
- 存储方式：收藏、历史记录与缓存纯本地存储，不建立后端服务。
- 依赖环境：安装前需确保已安装 pnpm。
