pzc2004/dsh-frostfin 预览 preview

pzc2004/dsh-frostfin

月芒霜鳍鲸——让Kimi Code本人直接驱动DeepSeek Harness会话的loop插件。DSH的壳,Kimi的脑,ACP直连,无中间层。

Project Overview项目介绍

dsh-frostfin (Moonglow Frostfin Whale) is a native agent loop plugin built exclusively for DeepSeek Harness (DSH). It preserves all of Kimi Code’s original features and regular updates without any modifications, replacing DSH’s default session driver with Kimi Code directly. It connects to Kimi Code via the Agent Client Protocol (ACP) without any intermediate agent rerouting that would alter responses or logic. This lets users combine Kimi Code’s natively tuned planning, tool orchestration, and thinking logic optimized for Kimi coding models with all of DSH’s existing ecosystem features, including its web UI, theme system, session management, trace viewer, and community plugin library.

This plugin adds a dedicated "Moonglow Frostfin Whale" session mode to DSH, leaving DSH’s original default standard mode intact so users can switch between different session drivers whenever they want. It supports attaching to both local and remote Kimi Code sessions hosted on remote servers via SSH and tmux, letting users import existing Kimi conversation history directly into DSH with just one click. It caters to a wide range of different use cases, from daily development, step-by-step code review, planning-only work, and even unattended long-running tasks, with full native DSH support for image inputs, user prompts, and tool approval flows.

To install this plugin, you first need to install Kimi Code on your machine, log into your Kimi account either via OAuth or an API key, and have a working DSH environment running Node.js version 22.19 or newer. It can be installed directly from the prebuilt npm package via DSH’s built-in plugin command line tool, or built manually from source if you want to review the code or make custom modifications. The plugin is fully tested and verified on macOS, expected to work without any issues on Linux, and remains untested on Windows as of the latest release. All project code is released under the open source MIT license, while Genshin Impact related design assets are copyrighted by HoYoverse.

dsh-frostfin(月芒霜鳍鲸)是专为DeepSeek Harness(DSH)开发的原生插件,作用是将DSH的整个会话驱动替换为Kimi Code,通过Agent Client Protocol(ACP)直连Kimi Code,无需中间代理转述。它让用户同时获得Kimi Code原装调优的agent循环、规划与工具编排能力,以及DSH完整的生态能力,包括Web UI、主题皮肤、会话管理和全社区插件生态。

它为DSH新增了专属的「月芒霜鳍鲸」会话模式,支持同时接入本地和远程Kimi Code会话,可一键导入既有Kimi会话历史到DSH中。它适配日常开发、逐步审阅、方案制定、无人值守等多种工作场景,完成了图片输入、用户提问、工具审批等全流程功能适配,开发者可根据需求切换不同的权限审批模式。

安装本插件需要先安装Kimi Code并完成登录,同时需要Node.js ≥ 22.19版本的DSH环境,支持通过DSH插件命令一键安装预构建包,也可从源码编译安装。该插件已在macOS完成完整验证,Linux可正常运行,Windows暂未经过实测。代码以MIT许可证开源,原神相关素材版权归米哈游所有。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

npx @deepseek-ai/dsh plugin --profile web add dsh-frostfin

把 pzc2004/dsh-frostfin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

月芒霜鳍鲸 logo

dsh-frostfin(月芒霜鳍鲸):Kimi Code as DSH Agent Loop

English | 中文

「受月矩力影响而发生变化的奇妙水生动物。」—— 提瓦特生物志

月芒霜鳍鲸(Moonglow Frostfin Whale)

Kimi Code 的大脑,DeepSeek Harness 的躯体。

frostfin 是一个 DSH loop 插件:把 DSH 会话的驱动者整个换成 Kimi Code 本人——通过 ACP(Agent Client Protocol)直连,中间没有第二个 agent 转述。于是你同时拿到两样原本互斥的东西:

  • Kimi 侧:Kimi Code 原装的 agent loop——为 kimi-for-coding 系列模型调优过的规划、工具编排与 thinking 模式,一个组件都不替换,版本照升;
  • DSH 侧:DSH 的全部生态——Web UI、主题皮肤、会话管理、轨迹查看、社区插件,以及"一切皆插件、插件皆可逆"的 Cordis 底座。

两边的长处,一头的项目。

名字的由来

第一层:鲸与月。 DeepSeek 的图腾是鲸;月之暗面(Moonshot AI)的名字来自 Pink Floyd 的专辑《The Dark Side of the Moon》。这个插件做的事情,字面意思就是:让 DeepSeek 的鲸,被月亮的力量改造。

第二层:霜鳍鲸是真实存在的。 霜鳍鲸本种是《原神》挪德卡莱海域的一头鲸,6.0 版本「月之一」进入图鉴[^1][^2],还在当月的主线过场里跃出过水面[^6];2026 年 7 月的 6.7 版本「月之八」新增了它的月芒个体——月芒霜鳍鲸(Moonglow Frostfin Whale)[^3],游戏内生物志标注其出现地点为月球地图「霜月」,图鉴写道:「受月矩力影响而发生变化的奇妙水生动物。」[^4]一头普通的水生动物,被月亮的力量改变——我们翻遍词典,找不到比这更精确的隐喻:鲸还是那头鲸,海还是那片海——但潮汐从此归月亮管。

第三层:彩蛋是闭环的。 月芒霜鳍鲸栖息的「霜月」地图,它的背面正是「月之暗面」区域——两者同属 6.7「月之八」,是同一个版本抵达的[^3][^5]。点亮「月之暗面」的地图时,跳出的成就叫「为你喜爱的色彩」(Any Colour You Like)[^5]——致敬的正是《The Dark Side of the Moon》专辑里的那首曲子。米哈游埋的梗,和月之暗面公司名字的出处,是同一张 1973 年的唱片。三条致敬链,在半个世纪前闭环。

月之暗面(霜月背面的区域)

霜鳍鲸 粉色霜鳍鲸 月芒霜鳍鲸
霜鳍鲸(本种 · 挪德卡莱)| 粉色霜鳍鲸(异色个体)| 月芒霜鳍鲸(受月矩力影响 · 霜月)
形象来自《原神》游戏内生物志,版权属米哈游,仅作命名由来示意

图鉴里还有一句挪德卡莱的民话:「凡是见到粉色霜鳍鲸的人,想要实现的愿望就能成真。」[^4]愿每个装上这个插件的人,愿望成真。

关于名字的精确性:「受月矩力影响而变化」描述的是月芒个体而非本种——所以品牌全称定为月芒霜鳍鲸,也就是图鉴那句话真正的主人;包名 dsh-frostfin 沿用本种的家族名,短、可检索、生态位靠前。

落选的名字(都有各自的道理)

月荡海(Moontide Sea)

  • dsh-moontide(月潮)——月引潮汐、潮载鲸;后来才知道,6.7 的月球地图上真有一片海叫月荡海(Moontide Sea)[^5]
  • dsh-moonwhale(月鲸)——两个吉祥物直接合体,最直白
  • dsh-moonsea(月海)——月球暗面的真实天文学术语,最大气

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-balance 下一个 Next chicheng-gate →