dsh-whale-trail

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.1。本版已核对 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 年，日期与地区定义见年度日历来源。未获得的隐藏徽章不会在界面中显示真实图案或解锁条件。

9 段航程，36 件海洋收藏

在「航海收藏册」中，累计有效使用天数与完整对话轮次同时达标，对应章节即自动完成。每章获得 4 件海洋生物或景物，共 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 消耗、节日或隐藏徽章。以后新增徽章目录也不会重置现有航程。

v1.0.1 更新了全套 36 件收藏插画：沿用徽章的海军蓝描边、平涂色块与贴纸留白，按真实海洋生物的头型、鳍形、触手和壳体特征分别设计。海带、珊瑚与海底景物也使用同一套画风。已解锁和未解锁状态、章节进度及装饰选择保持一致。

收藏册与装饰选择页展示新静态插画；动态水族馆仍使用当前动画表现，后续独立迭代。插画使用内置 Image Gen 制作并随插件离线打包，设计说明与物料清单见 collection-art。

把水族馆留在 Harness 里

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

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

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

五枚珍藏，一张航海名片

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

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

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

安装与升级

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

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

dsh plugin --profile desktop add 'file:/绝对路径/dsh-whale-trail-1.0.1.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.1.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 压力当作实际消耗。
• 完整对话：你发起一次有效输入，Agent 给出可见文本回复，且对应回合正常完成，计 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，尚未授予开源许可证。第三方材料保留各自许可，本项目的声明不改变其条款。