@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。
链接
@sunwindy/dsh-tool-baixiaochun v0.2.1 · 2026-10-20 · MIT
