前言¶
在 Windows 上把 NapCat 接到 DeepSeek Harness（DSH）的 OneBot 适配器，通常要自行下载固定版本包、配置 QQ 路径、处理管理员启动，并在 WebUI 里对齐 WebSocket 地址与令牌。文档分散在 NapCat 发布页、DSH 配置界面和本机端口习惯之间，Agent 很难在对话里给出可核对的一步步路径。zhuziddl 维护的 DSH 插件 NapCat 部署助手（包名 dsh-napcat-deploy，仓库 zhuziddl/my）把「可安装的 DSH 插件、部署说明、本机 3001/6099 只读检查」收进同一仓库，并附带 Windows 管理员启动脚本；QQ 登录、DSH 安装、模型与人设仍须自行完成，插件也不代替 OneBot 消息适配器。
这是什么¶
NapCat 部署助手是分类为 tools 的 DSH 插件（displayName：NapCat 部署助手），由 zhuziddl 维护，当前版本 0.1.0，许可证 MIT。它解决两类问题：一是在 DSH 有 tools 服务的作用域里，通过工具 napcat_deploy_check 返回部署指南或检查本机默认端口；二是仓库内提供与官方 NapCat 4.18.41 基线对齐的 Install.ps1、Start.cmd / Start.ps1 与配置模板，便于在固定目录重复部署。仓库不分发 QQ 或 NapCat 二进制，不存储聊天、登录态或完整 DSH profile。
核心功能¶
DSH 工具 napcat_deploy_check¶
重载对应 profile 后，插件在有 tools 服务的作用域注册 napcat_deploy_check：
mode=guide：返回 NapCat 部署指南文本。mode=status：只读检查本机默认 3001（OneBot 正向 WebSocket 示例）与 6099（NapCat WebUI）端口是否在监听；不启动 QQ、不申请提权、不发消息。
若所选 Agent 预设隔离根作用域工具，需要在该预设的 plugins 中挂载 dsh-napcat-deploy 才能看到该工具。本插件没有自动启动、提权或发消息行为。
仓库内的 Windows 部署脚本¶
与 README 中「下次部署」一致的能力包括：
Install.ps1：从自行下载的官方NapCat.Shell.zip校验 SHA256 并解压到runtime/shell，不覆盖已有目录，不修改 QQ 文件。Start.cmd/Start.ps1：读取config.local.json，申请管理员权限并调用官方 BootMain；支持-CheckOnly仅检查路径、文件和端口。config.example.json：不含账号与令牌的模板；本地需填写qqExe、qqNumber等。
已验证兼容基线为 Windows x64、QQ 9.9.33-52230、官方 NapCat 4.18.41；其他版本应重新验证。文档还指向 故障排查 与 交接规则。
安装与启用¶
安装到 DSH¶
在 PowerShell 中执行（命令来自仓库 README）：
dsh plugin --profile desktop add github:zhuziddl/my
安装后重载 desktop（或你使用的）profile。插件要求 Node.js >= 20、dsh ^0.2.1-rc.2（见 package.json 的 engines）。
通过自定义插件市场索引（可选）¶
也可按 DSH 插件市场文档 启用 Custom plugin markets，在「插件 → Discover → 添加索引源」填写：
https://raw.githubusercontent.com/zhuziddl/my/main/index.json
这是本仓库提供的独立索引，版本固定到 Git 提交；不是社区市场已审核收录的声明。包名尚未发布到 npm，无需 npm 发布即可从 GitHub 安装。
典型用法¶
在 Agent 中调用检查工具¶
保持 DSH 运行且插件已挂载后，让 Agent 调用 napcat_deploy_check：需要步骤说明时用 mode=guide；只想确认本机 3001/6099 是否被占用或监听时用 mode=status。端口监听本身不能证明 QQ 已登录或聊天正常；3001 返回 HTTP 426 通常表示需要 WebSocket 而非普通 HTTP。
本机 NapCat 部署（仓库脚本）¶
- 下载本仓库并解压到固定目录。安装腾讯官方 Windows QQ，记录
QQ.exe实际路径，先确认普通 QQ 可打开。 - 在 NapCat 官方 4.18.41 发布页 下载
NapCat.Shell.zip。 - 在本目录打开 PowerShell，执行：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Install.ps1 -ArchivePath "$env:USERPROFILE\Downloads\NapCat.Shell.zip"
上述 ExecutionPolicy Bypass 仅作用于本次 PowerShell 子进程；运行前应检查下载来源和脚本内容。
- 编辑生成的
config.local.json，填写自己的qqExe和qqNumber，不要提交此文件。若本机已有官方 NapCat，可将shellDirectory改为现有 shell 目录绝对路径以跳过安装步骤。 - 双击
Start.cmd，同意 Windows 管理员权限提示；如需登录由本人扫码，并保持启动窗口运行。 - 在 NapCat 本机 WebUI 配置 OneBot 正向 WebSocket 服务端（本机示例
127.0.0.1:3001）；在 DSH 的 OneBot 适配器中配置相同 WebSocket 地址、访问令牌与目标预设（令牌在各本机界面设置，仓库不存储）。 - 用另一个 QQ 账号发消息并确认回复。
仅做启动前校验、不启动 QQ：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Start.ps1 -CheckOnly
有服务占用配置的 OneBot 端口时，启动入口会停止，避免重复启动。
适用场景与注意¶
适合在 Windows x64 上首次或重复部署 NapCat、并希望 DSH Agent 能读到统一部署指南或快速查看 3001/6099 状态的开发者。插件以当前 dsh 进程权限运行；安装前应阅读 GitHub 源码 与 MIT 许可证，自行评估脚本中的管理员提权与 -ExecutionPolicy Bypass 是否符合本机安全策略。自动化测试覆盖插件行为与启动前校验，不等于每台机器都已完成管理员启动、登录和真实消息验收。
DSH 生态采用「一切皆插件」思路；社区目录站点（如 SkillHub 插件页）为独立索引，与 DeepSeek / 幻方无官方从属关系。
结尾¶
NapCat 部署助手把 DSH 可安装插件、NapCat 4.18.41 基线部署步骤与本机端口只读检查放在同一仓库，并明确不替代 QQ 登录与 OneBot 适配器配置。需要索引与脚本细节时，可打开目录页 https://www.skillhub.cn/plugins/zhuziddl/my 与 GitHub https://github.com/zhuziddl/my。
