dsh-whale-trail 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-whale-trail 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-whale-trail 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-whale-trail 还在维护吗？

GitHub 4 星。最近一次上游提交在 2026/10/27。

鲸迹徽章 ShawnRen57/dsh-whale-trail

DeepSeek Harness

ShawnRen574 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

Whale Trail · 鲸迹 — 为 DeepSeek Harness 自动生成本地成就徽章，配鲸鱼主题的进化插画。

32.9/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/27 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add ShawnRen57/dsh-whale-trail

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么

dsh 原生插件 · ui

装得上吗

本站尚未做安装检查

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 4 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件

查看扫描证据（共 14 处，展示前 14 条）

读取本地文件
src/engine.ts:10
const catalog = JSON.parse(readFileSync(new URL('../assets/catalog.json', import.meta.url),'utf8')) as Badge[];
读取本地文件
src/engine.ts:55
const legacyCatalog=JSON.parse(readFileSync(new URL('../assets/legacy-catalog-v2.json',import.meta.url),'utf8')) as Badge[];
读取本地文件
src/engine.ts:56
const v3Catalog=JSON.parse(readFileSync(new URL('../assets/legacy-catalog-v3.json',import.meta.url),'utf8')) as Badge[];
读取本地文件
src/engine.ts:59
const calendarFile=JSON.parse(readFileSync(new URL('../assets/calendar-2026.json',import.meta.url),'utf8')) as {version:string;timezone:string;dates:R
写入本地文件
src/engine.ts:102
const existed=existsSync(file);mkdirSync(dirname(file),{recursive:true,mode:0o700});this.db=new DatabaseSync(file);chmodSync(file,0o600);
写入本地文件
src/engine.ts:102
const existed=existsSync(file);mkdirSync(dirname(file),{recursive:true,mode:0o700});this.db=new DatabaseSync(file);chmodSync(file,0o600);
读取本地文件
src/engine.ts:102
const existed=existsSync(file);mkdirSync(dirname(file),{recursive:true,mode:0o700});this.db=new DatabaseSync(file);chmodSync(file,0o600);
写入本地文件
src/engine.ts:112
if(existed){const folder=join(dirname(file),'backups');mkdirSync(folder,{recursive:true,mode:0o700});const backup=join(folder,(version==='4'?'before-c
写入本地文件
src/engine.ts:112
if(existed){const folder=join(dirname(file),'backups');mkdirSync(folder,{recursive:true,mode:0o700});const backup=join(folder,(version==='4'?'before-c
删除本地文件递归
src/engine.ts:242
}finally{stage?.close();rmSync(folder,{recursive:true,force:true});}}
读取本地文件
src/index.ts:33
if(b.asset==='hidden-placeholder.svg')continue;let image=this.art.get(b.id);if(!image){const bytes=readFileSync(new URL('../assets/web/'+b.id+'.webp',
写入本地文件
src/index.ts:38
this.engine.inspect(r.text);const folder=join(dirname(this.engine.file),'backups');mkdirSync(folder,{recursive:true,mode:0o700});const file=join(folde
写入本地文件
src/index.ts:38
this.engine.inspect(r.text);const folder=join(dirname(this.engine.file),'backups');mkdirSync(folder,{recursive:true,mode:0o700});const file=join(folde
写入本地文件
src/index.ts:38
this.engine.inspect(r.text);const folder=join(dirname(this.engine.file),'backups');mkdirSync(folder,{recursive:true,mode:0o700});const file=join(folde

扫描于 2026/10/31（1 天前） · 范围全包扫描（包内未声明入口） · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-typert-protocol@deepseek-ai/schemastery

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

README

由 DeepSeek 最新模型翻译生成

Whale Trail · 鲸迹让每一次探索，都留下一枚值得收藏的徽章。 Whale Trail for DeepSeek Harness 是一款小鲸鱼主题的本地成就插件。正常使用 Harness，就能自动点亮徽章、推进航海章节，解锁自己的 ASCII 水族馆，再把五枚珍藏做成可以带走的航海名片。无需打卡、领取或手动确认完成。 Whale Trail is a local-first achievement collection, ASCII aquarium and shareable voyage card for DeepSeek Harness. 非官方社区项目，由社区成员独立开发与维护，未获 DeepSeek 官方背书。当前版本 1.0.0。本版已核对 Harness 0.2.1-rc.2 / 0.2.1-rc.3 发行 SDK 契约，并在 macOS 0.2.1-rc.3 完成安装与界面验证；不以单一宿主版本号阻止安装，具体兼容范围见兼容性。下载与安装 · 67 枚徽章 · 航海收藏册 · 水族馆 · 航海名片 · 备份与迁移 · 反馈从「我的徽章」出发点击 Harness 左下角用户信息 → 我的徽章，在四个标签页中查看成就、航海收藏册、布置水族馆和制作名片。

展开完整文档（README 剩余 1 节）

Whale Trail · 鲸迹

让每一次探索，都留下一枚值得收藏的徽章。

Whale Trail for DeepSeek Harness 是一款小鲸鱼主题的本地成就插件。正常使用 Harness，就能自动点亮徽章、推进航海章节，解锁自己的 ASCII 水族馆，再把五枚珍藏做成可以带走的航海名片。无需打卡、领取或手动确认完成。

Whale Trail is a local-first achievement collection, ASCII aquarium and shareable voyage card for DeepSeek Harness.

非官方社区项目，由社区成员独立开发与维护，未获 DeepSeek 官方背书。 当前版本 1.0.0。本版已核对 Harness 0.2.1-rc.2 / 0.2.1-rc.3 发行 SDK 契约，并在 macOS 0.2.1-rc.3 完成安装与界面验证；不以单一宿主版本号阻止安装，具体兼容范围见兼容性。

下载与安装 · 67 枚徽章 · 航海收藏册 · 水族馆 · 航海名片 · 备份与迁移 · 反馈

从「我的徽章」出发

点击 Harness 左下角 用户信息 → 我的徽章，在四个标签页中查看成就、航海收藏册、布置水族馆和制作名片。

- 自动记录成长：徽章数、累计使用天数、最长连续、当前连续、Token 与完整对话轮次，一眼看见自己的航迹。
- 收藏自然解锁：满足章节的累计天数与完整对话条件，自动获得装饰，不消耗 Token，也不需要领取。
- 外观由你决定：页面水族馆默认关闭。选好已解锁装饰、密度、速度与颜色后保存，才会出现在 Harness 中。
- 把航程带走：自选五枚已获得徽章，加上签名，导出高清 PNG 或能离线游动的 HTML 名片。
- 本地保存：不新增模型调用、不上传聊天内容；备份同时带走成就记录与外观偏好。

保留原有设置、意见反馈和退出登录入口。点击图片可查看高清原图。

我的徽章：成就统计与印章风徽章收藏

已获得徽章按获得时间倒排；普通未获得徽章以灰色展示，悬浮可查看条件。隐藏徽章只展示名称和问号占位。界面为本机实际运行截图；名片为独立测试档案示例。

67 枚徽章，7 个系列

延续圆形印章与贴纸风格，保留原有 59 枚徽章，新增 8 枚「探索航迹」。

| 系列 | 数量 | 当前内容 |
| 累计使用 | 9 | 1 / 3 / 7 / 14 / 30 / 60 / 100 / 180 / 365 天 |
| 连续使用 | 6 | 3 / 7 / 14 / 30 / 60 / 100 天 |
| Token 回响 | 6 | 100 万 / 1000 万 / 1 亿 / 10 亿 / 100 亿 / 1000 亿 Token |
| 累计对话 | 8 | 1 / 10 / 20 / 50 / 100 / 200 / 500 / 1000 轮完整对话 |
| 探索航迹 | 8 | 不同工具、不同会话、同会话跨日重访、压缩后继续对话 |
| 节日限定 | 24 | 内置 2026 年文化节日日期 |
| 隐藏典藏 | 6 | 4 枚可自动识别；另外 2 枚等待可靠的宿主行为证据适配 |

初次下潜累计使用 · 1 天三日同游连续使用 · 3 天深海回响Token 回响 · 100 万

初声相遇累计对话 · 1 轮初试罗盘探索航迹 · 1 种工具还有未被发现的航迹隐藏典藏 · 等你探索

新增的 8 枚探索航迹

| 徽章 | 自动获得条件 |
| 初试罗盘 / 三向探航 / 八方共鸣 | 在正常完成的顶层人类对话中，累计成功使用 1 / 3 / 8 种不同工具 |
| 三港相逢 / 十港航迹 | 在 3 / 10 个不同会话中，完成由你发起的正常对话 |
| 三日续航 / 七日重访 | 在同一个会话的 3 / 7 个不同自然日，完成正常对话；不要求连续 |
| 轻装再航 | 成功完成一次上下文压缩后，再次由你发起并完成正常对话 |

工具调用必须有可匹配的成功结果；不计鲸迹自身工具、失败结果、子代理、继承记录或后台自动续跑。缺少可靠证据时不猜测授予。

鲸迹进阶徽章：小鲸鱼逐步成长为航海家 2026 年 24 枚节日限定徽章

节日按文化日期当天识别，不按调休或整个假期；目前仅内置 2026 年，日期与地区定义见年度日历来源。未获得的隐藏徽章不会在界面中显示真实图案或解锁条件。

9 段航程，36 件海洋收藏

在「航海收藏册」中，累计有效使用天数与完整对话轮次同时达标，对应章节即自动完成。每章获得 4 件原创 ASCII 生物或景物，共 36 件；可以先完成章节，再按喜好决定放哪些进入水族馆。

| 章节 | 累计有效使用 | 完整对话 | 装饰奖励 |
| 01 · 初见浅湾 | 1 天 | 1 轮 | 4 件 |
| 02 · 珊瑚小径 | 3 天 | 10 轮 | 4 件 |
| 03 · 潮汐花园 | 7 天 | 20 轮 | 4 件 |
| 04 · 月光航道 | 14 天 | 50 轮 | 4 件 |
| 05 · 暖流远航 | 30 天 | 100 轮 | 4 件 |
| 06 · 深蓝回声 | 60 天 | 200 轮 | 4 件 |
| 07 · 鲸落秘境 | 100 天 | 500 轮 | 4 件 |
| 08 · 无垠大洋 | 180 天 | 1000 轮 | 4 件 |
| 09 · 星海归航 | 365 天 | 1000 轮 | 4 件 |

章节只依赖这两项真实进度，不要求 Token 消耗、节日或隐藏徽章。以后新增徽章目录也不会重置现有航程。

航海收藏册：九段递进航程与每章四件海洋奖励

把水族馆留在 Harness 里

打开「水族馆」，选择已解锁装饰，调整生物密度、游动速度、海洋墨色，勾选「在 Harness 页面显示水族馆」，点击「保存水族馆」。偏好会在重新打开界面和重启后保留。

- 新对话：在整块留白区域游动，避开前景标题和输入区域。
- 已有对话：收拢到输入框本体的底部，以渐变轻轻浮现，不延伸到聊天正文。
- 安静工作：装饰不接收点击、不抢焦点；页面隐藏时暂停，支持「静水模式」，并尊重系统减少动态设置。

锁定装饰不能配置；更换外观不会增加成就进度。宿主缺少所需布局锚点时，页面背景会隐藏，其他可用功能继续工作。

水族馆编辑器：动态预览、外观配置与已解锁装饰选择

五枚珍藏，一张航海名片

在「航海名片」中，自选 恰好 5 枚不同的已获得徽章，写下最多 120 字符的签名。名片同时展示获得徽章数、累计使用天数与中文单位的 Token 数字，例如「100 万」「1 亿」。尚不足五枚徽章时，可以继续收藏，达到五枚后再生成名片。

名片沿用你保存的水族馆装饰与外观，并使用官方原始 Powered by dsh 品牌图。该图用于说明运行平台，不代表 DeepSeek 对鲸迹的官方认证、背书或赞助。

- 导出 PNG：生成 1200×800 静态高清图片，保存动画中的一个瞬间，适合发送和贴进文档。
- 导出动态 HTML：徽章图片、名片内容与动画都包含在单个文件中，用浏览器离线打开，水族馆仍可游动；减少动态设置同样生效。
- 分享高清名片：浏览器支持文件分享时唤起系统分享；不支持时下载 PNG。导出和分享前会保存当前名片设置，不会自动上传或发布。

航海名片：五枚精选徽章、个人签名、中文统计与动态水族馆

安装与升级

发布包已预构建，无需自行编译，也不需要额外配置模型或 API Key。

1. 从 v1.0.0 Release 下载 dsh-whale-trail-1.0.0.tgz。
2. 在终端执行以下命令，将文件路径替换为实际下载位置：

dsh plugin --profile desktop add 'file:/绝对路径/dsh-whale-trail-1.0.0.tgz' --ignore-scripts

macOS 上如果没有全局 dsh 命令，可调用应用自带 CLI：

'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' plugin --profile desktop add 'file:/绝对路径/dsh-whale-trail-1.0.0.tgz' --ignore-scripts

3. 重启 Harness，打开左下角 用户信息 → 我的徽章。

升级前建议先导出 .dshbadge。安装新版并重启后，真实使用记录保留，章节和新增徽章由证据自动计算。旧版 10K / 100K Token 徽章仍不展示或计入获得数量，相关使用事实继续保留。

若需禁用，可在 Harness 插件页操作；卸载可执行 dsh plugin --profile desktop remove dsh-whale-trail --ignore-scripts，本地成就账本仍保留。

兼容性

v1.0.0 移除了 engines.dsh 单版本限制，宿主协议 peer 不再精确锁定某一个发行版；实际接入按能力判断。

已核对 0.2.1-rc.2 与 0.2.1-rc.3 发行 SDK 中的事件形态、账户菜单与页面布局契约，并提供相关自动测试。在 macOS 0.2.1-rc.3 实际验证了安装、历史统计、四个功能页、外观保存及名片导出。这不等于承诺所有宿主版本、系统和界面都已实机验证。未来宿主改变接口时，可选页面背景或菜单扩展可能隐藏，需要更新插件；无法使用的能力不会通过猜测接入。详细边界见开发说明。

怎么统计

自动统计，首次安装时同步可读取的历史。 只采用能够核实的事件，重复扫描或重复导入不会叠加进度。

- 使用天数：顶层人类有效输入与实际回复或成功工具结果配对，按固定时区的输入日期累计；一天多次使用只计一天。默认时区为 Asia/Shanghai。
- 连续使用：记录最长连续和当前连续；当前连续允许从昨天接续到今天。
- Token：累计 Harness 正式记录的模型用量，不估算缺失记录，也不把 Token Meter 压力当作实际消耗。
- 完整对话：你发起一次有效输入，智能体给出可见文本回复，且对应回合正常完成，计 1 轮。多条排队输入合并到同一回合时只计 1 轮；失败、中止、重试和后台自动续跑不单独计轮。
- 探索与章节：从可归因的完整对话和成功证据推导，打开页面、修改偏好、导入外观都不能直接授予。

归档会话、手动确认和主动领取不参与计数。更详细的事件规则见开发与实现说明。

备份与迁移

在弹窗底部点击 导出备份，带走生成的 .dshbadge 文件。换设备后安装插件，保持相同档案与时区，点击 导入备份；先预览新增、重复和补全记录，再确认合并。

v1.0.0 导出 schema 4 备份，包含最小成就事实、规则信息、外观偏好、精选五枚徽章与签名，并兼容导入 schema 1 / 2 / 3 的旧备份。

- 旧备份没有外观配置时，不会清空本机偏好。
- 导入 schema 4 时，本机尚未保存偏好才带入备份外观；已有本机偏好会保留。
- 备份中的装饰和精选徽章会按实际解锁结果检查，外观配置不能解锁奖励。
- 损坏文件或档案、时区、规则冲突会拒绝合并，避免部分写入。

账本本地保存；不保存提示词、回复正文、工具参数、附件、API 密钥或登录凭据。签名是你主动保存的展示内容，会包含在备份与导出的名片中。备份为明文元数据文件，校验和不等于加密。当前提供手动迁移，不提供自动云同步；请使用 .dshbadge，不要直接同步运行中的 SQLite 文件。

持续更新与反馈

徽章与海洋收藏会持续更新。 后续将继续增加主题、进阶设计与节日内容，并随 Harness 演进完善事件适配。欢迎在 Issues 提交喜欢的主题、成就点子或问题，附上 Harness 版本、插件版本和复现方式；关注 Releases 获取更新。

构建、配置、迁移和已知边界见开发说明。

来源与许可

36 件 ASCII 生物与景物为原创字符图；场景生成和动画渲染独立实现，不打包下列项目的代码、字体、素材或独立运行时。游动、鱼群与海洋氛围的研究参考：

- Chael-Chael/dsh-ascii-whales
- stackedlol/ascii-sharks
- michikusa404/ascii-kanji-sharks

来源记录、各上游许可及历史快照的许可边界见 THIRD_PARTY_NOTICES.md。官方 Powered by dsh 原图的来源和 MIT 许可另见品牌素材说明。这些引用不表示上游作者对鲸迹的背书。

源代码与原创 AI 辅助生成徽章物料一并公开；鲸迹当前包声明为 UNLICENSED，尚未授予开源许可证。第三方材料保留各自许可，本项目的声明不改变其条款。