白小纯修仙工具：DSH 插件

前言¶

DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在开发智能体时，我们常需要一些轻量级的本地工具来辅助调试、监控或提供趣味交互。现有的方案要么依赖外部 API，要么需要额外的进程通信。如果能在 DSH 内部直接调用本地能力，会简化架构、降低延迟。

baixiaochun 插件正是为此提供的一套本地工具集：把灵溪宗修士「白小纯」封装为 DSH 可用工具，提供今日灵签、灵气检测、修为汇报以及桌宠显示控制能力。

这是什么¶

@sunwindy/dsh-tool-baixiaochun 是一个将白小纯（修仙角色）封装为 DSH 可用工具的插件，由维护者 sunwindy91 发布。它不依赖外部 API，纯本地运行，使用 Node 标准库实现，零运行时依赖。

插件解决的问题是：在 DSH 会话中快速获取本地状态（灵气、修为）以及控制本地桌宠显示，无需手动启动额外进程或编写 Shell 脚本。

核心功能¶

工具	说明	数据来源
`baixiaochun fortune`	今日灵签（上上签→下签，含动作）	内置箴言（脱敏）
`baixiaochun lingqi`	灵气检测（DSH 是否在运行；返回 `alive` + `status`）	本地 HTTP 探测
`baixiaochun xiuwei`	修为汇报（当前会话轮次/步数/token/缓存）	本地会话统计
`baixiaochun show`	调出白小纯桌宠	本地控制端口（桌宠壳）
`baixiaochun hide`	关闭白小纯桌宠	本地控制端口（桌宠壳）
`baixiaochun toggle`	切换桌宠显示	本地控制端口（桌宠壳）
`baixiaochun pet-status`	查询桌宠显示状态	本地控制端口（桌宠壳）

语义说明（0.2.1）¶

lingqi：任何 HTTP 响应都说明监听者活着，返回 alive:true，status 给出状态码。DSH Web 根路径对匿名请求返回 401，这是认证态而不是死亡；旧版”仅 200 算活”会误报。

xiuwei：只按 DSH_SESSION_ID 取当前会话，返回 sessionId；当前会话尚未写入投影缓存时返回 { ok:false, reason:"current-session-not-projected" }，不会拿另一个项目的历史会话冒充。

安装与启用¶

从 GitHub 安装（推荐）：

dsh plugin --profile web add github:sunwindy91/dsh-tool-baixiaochun

或固定版本：

dsh plugin --profile web add git+https://github.com/sunwindy91/dsh-tool-baixiaochun.git#v0.2.1

本地链接：

dsh plugin --profile web add link:<本目录绝对路径>

安装后，plugin_manager 的 install_bundle 会自动在 profile 的 dsh.profile.bundles 中启用 @sunwindy/dsh-tool-baixiaochun，无需手动修改配置文件。

典型用法¶

在 DSH 会话中直接通过自然语言调用：

"帮我抽个今日灵签" → 调用 baixiaochun { cmd: 'fortune' }
"检测下灵气"       → 调用 baixiaochun { cmd: 'lingqi' }
"汇报下修为"       → 调用 baixiaochun { cmd: 'xiuwei' }
"把白小纯叫出来"   → 调用 baixiaochun { cmd: 'show' }
"把白小纯收起来"   → 调用 baixiaochun { cmd: 'hide' }
"白小纯在吗"       → 调用 baixiaochun { cmd: 'pet-status' }

桌宠显示控制¶

show / hide / toggle / pet-status 通过本地控制端口指挥 Electron 桌宠壳显示/隐藏白小纯窗口。默认端口为 127.0.0.1:3090，可用环境变量 DSH_PET_CTL_PORT 修改。

控制流程：
- 需要桌面壳（Electron 应用）正在运行——桌宠窗口由壳创建；
- 若直接用浏览器打开 DSH（未启动桌面壳），返回 shell-not-running 提示，不会报错；
- 其他操作方式：托盘菜单「白小纯桌宠」、全局快捷键 Ctrl+Alt+B、右键菜单。

安全与脱敏¶

灵签箴言为通用内容；灵气/修为数据只读本地统计，不收集、不发送；
除 DSH 自身服务与本地桌宠控制端口外，无网络请求；
不包含 API key、token、个人路径；
npm test 会扫描 C:\Users、23017 与 sk- 模式；
可安全开源、可被任何人部署使用。

开发与测试¶

node --check lib/index.js
npm test        # 4 项契约测试：清单 / patch / 脱敏 / 工具面

插件基于 @deepseek-ai/dsh-tools 的 defineTool 模式（参照 dsh-tool-todo），使用纯 Node 标准库（http/fs/os/path），零运行时依赖。许可证为 MIT。

适用场景与注意¶

适合需要本地调试、监控会话状态以及提供趣味交互的 DSH 开发者。

插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。除 DSH 自身服务与本地桌宠控制端口外，无网络请求，数据仅存储于本地。

总结¶

baixiaochun 插件提供了今日灵签、灵气检测、修为汇报和桌宠显示控制等本地能力，适合在 DSH 开发与调试中使用。它不依赖外部 API，纯本地运行，零运行时依赖，可安全开源。

仓库：https://github.com/sunwindy91/dsh-tool-baixiaochun
目录页：https://www.skillhub.cn/plugins/sunwindy91/dsh-tool-baixiaochun