白小纯修仙助手 sunwindy91/dsh-tool-baixiaochun

@sunwindy/dsh-tool-baixiaochun

白小纯修仙工具插件 —— 把灵溪宗修士白小纯封装成 DeepSeek Harness (DSH) 可用的工具。

功能

| 工具 | 说明 | 数据来源 |
| 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:<本目录绝对路径>

安装后，在 profile 的 dsh.profile.bundles 中启用 @sunwindy/dsh-tool-baixiaochun （plugin_manager 的 install_bundle 会完成这一步，无需手改文件）。

使用（在 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 通过本地控制端口（默认 127.0.0.1:3090，可用环境变量 DSH_PET_CTL_PORT 修改）指挥 Electron 桌宠壳显示/隐藏白小纯窗口。

- 需要桌面壳（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 License。

链接

- 仓库：https://github.com/sunwindy91/dsh-tool-baixiaochun
- 问题：https://github.com/sunwindy91/dsh-tool-baixiaochun/issues
- 生态话题：dsh-plugin

@sunwindy/dsh-tool-baixiaochun v0.2.1 · 2026-10-20 · MIT