dsh-neptune

把尼普顿充电桩接进 DeepSeek Harness：查余额、看插座空不空、起明早六点的续充任务。

插件不连服务器，直接打厂商的接口。openId 只在插件进程的内存里，不进模型上下文，不落盘。

安装

dsh plugin --profile desktop add github:JiepengLab/dsh-neptune

第一次用

在电脑微信里打开一次厂商链接：

https://szlzxn.cn/wechat/wxscan/50959120

末尾那串 8 位数字换成你自己那根桩的编号，编号印在桩上。等它跳完就行。 授权那一步只能在微信里完成，在普通浏览器里打开会回「请在微信客户端打开链接」。 授权之后带 openId 的网址进了微信的浏览历史，插件从那里取凭证。 落地页可能显示不出来。厂商那台机器还在用，只是它只走 http，从 https 页面调它会被浏览器拦掉。

然后在聊天里说「查一下我的充电状态」。

怎么用

你说的话	插件做什么
查一下我的充电状态	余额、当前订单、可充时段、最近一单
那个桩哪些插座空着	逐个插座的占用状态
帮我续上	起一个 DSH 任务，默认早上六点那一单。到点自动续
明早六点帮我续上	同上。不给时刻就定在 06:05
现在就续	当场续没有了。告到点再充，或起一个最近时刻的任务
拍了插座上二维码的照片	neptune_scan 读出桩号与插座号，再定一个 06:05 的任务

工具：

名字	做什么
neptune_pair	取凭证
neptune_status	余额、当前订单、可充时段、最近一单
neptune_sockets	某根桩每个插座的占用状态
neptune_charge	到点执行续充。只在宿主投递那条任务时用
neptune_charge_at	起一个 DSH 任务。唯一的写入口
neptune_scan	从插座二维码的照片里读出桩号与插座号
neptune_recipe	把账号信息或起单网址写进剪贴板

插件不提供命令。你在聊天里说，agent 转成工具调用。

说「明早六点帮我续上」时，插件建的是一条宿主任务。那条任务记录就是批准凭据：它写着续哪个桩哪个插座，到点由宿主投回会话。

到点任务会叫醒 agent 执行续充，会消耗一点 token。批准在签发时发生，不在执行时：任务建好就等于你批准过，到点那次调用不会再问你。

无人值守时只续被午夜断电切掉的那一单。

没有当场续。 续充一律定到点，到点由宿主投回来执行。

给别人的用法：电脑晚上不能开机

这个插件跑在用户的电脑上。宿舍断电或关机，六点的续充就没人执行。

起定时任务前先问一句：这台电脑能开到早上六点吗？

不能的话，两条替代：

路线	怎么做	代价
GitHub Actions	Fork 上游仓库，配三个 secret（NEPTUNE_OPEN_ID、NEPTUNE_AREA_ID、NEPTUNE_EMPLOYEE_ID），每半小时跑一次，从 02:47 到 06:07 北京时间	凭证进 GitHub Secrets。要 GitHub 账号。它按余额封顶，余额多少就充多少，我们的封顶是 2 元
手机自动化	插件把起单网址写进剪贴板。在手机自动化里加一个「打开 URL」的动作，定在 06:05	这条网址没有闸门：不查插座占用、余额与昨晚是否断电单。网址带 openId，别贴进聊天

手机那条只在「车一定停在那个插座」时安全。厂商不拦在别人占用的插座上起单， 会给别人的车计费，账上你付。

把关

起单会预扣余额，所以有两道关。

关	在哪	挡住什么
插件自己的五道闸门	核心里	已经在充 / 不在可充时段 / 余额为 0 / 余额不够预扣 / 目标插座不空闲
无人值守只续午夜断电切掉的那一单	核心里	车已经不在了却白起一单

聊天里说的话就是授权。agent 带着上下文照做，不会再弹确认。

安全边界

项	规则
openId	只存在插件内存里。不进模型上下文，不返回给调用方，不落盘
剪贴板	neptune_recipe 会把值写进剪贴板。值不进模型上下文，也不进聊天。写之前先问用户
剪贴板历史	Windows 的剪贴板历史（Win+V）与剪贴板同步会留副本。值进了剪贴板就等于交给这些机制
凭证来源	环境变量、agent 给的目录、本机微信浏览历史。插件自己读文件
agent 的权限	只列目录名，不得读 History 文件的内容
授权凭据	宿主那条定时任务。它由宿主持久化，在任务页面看得见，也删得掉
写操作	起单与写剪贴板。起单会预扣余额（设备定的一元或两元）
余额不够	起单前就拦下。报「余额不够预扣」，告诉你差多少

厂商有些接口会回显 openId。插件在读应答的那一层就打码，模型看到的都是打码后的串。

这个插件不含任何人的 openId，作者也拿不到任何人的凭证。 每个人第一次用都要自己做一次配对。不要把自己的 openId 写进配置发给别人，那等于账户密码。

排错

现象	处理
「没找到厂商的网址」	按提示在电脑微信里打开链接，或用文件工具找到微信数据目录喂给 dir
「还没到可充电时段」	桩的可充时段是 6:00 到 24:00。窗口外起单会被厂商结束
「目标插座不空闲」	那个插座有人在充。厂商不拦，但结束订单会清掉对方的状态
「系统繁忙，请2分钟后操作！」	厂商限流。等两分钟，不要改字段重试
「认不出这条定时任务批准的是哪个插座」	宿主改了提醒正文的格式。重新说一句「明早六点续上」，再起一个新任务
「没找到 pwsh」	Windows 上要装 PowerShell 7 才能写剪贴板
插件没加载 / agent 说没有这些工具	查 profile 的 patch

能不能删

能删。删了只是没了这套工具。

什么时候过期

厂商接口改了就会失效，表现为工具报「厂商拒绝了请求」。厂商改了计费档位或订单字段，要一起改 core/neptune-core.mjs 与 skills/neptune-resume/SKILL.md。

开发

见 CONTRIBUTING.md：代码在哪、怎么本地加载、跑哪些检查、提交信息规范。

兼容范围：DSH >=0.2.2-rc.1 <0.3.0-0，Node 20 或更高，无构建步骤。