dsh-plugin-windows-guard

DeepSeek Harness (dsh) 的 Windows 环境防坑守则插件（纯数据，零代码逻辑）。

把本机 255 个会话归档里反复出现的 Windows 高频坑，沉淀成「一次写对」的 预防性守则，以两个 skill 形式自动加载给 agent——不是修复工具，是行为规则： 让模型在写 PowerShell、读文件、处理编码/路径/进程/端口问题前先看到防坑清单。

纯技能载体（对标 dsh-plugin-dev-kb）：lib/index.js 只有约 40 行注册代码， 全部内容在 skills/ 目录。零运行时依赖、零构建。

功能

按触发场景拆成两个自包含技能（<available_skills> 按 description 匹配自动加载正文）：

windows-enc —— 编码与 PowerShell 解析（命令/文件内容出错类）

章节	内容	来源问题（历史实录）
1 环境事实卡	pwsh 5.1/7 差异、-Command 单 argv 无 shell 转义层、OutputEncoding 已钉、退出码权威	stderr 误判（git 红色进度、NativeCommandError）
2 编码三铁律	读必带 -Encoding UTF8；写结构化文件用 WriteAllText(UTF8Encoding($false))；查 BOM/转码命令模板	GBK 误解码（鎻掍欢/鈥?）、BOM 写坏 package.json（启动事故二）、UTF-16 写坏
3 引号转义速查	PS '' 转义（反斜杠无效）、双引号插值、node -e/python -c 引号地狱 → 写临时文件	SyntaxError: unterminated string literal、实测引号嵌套失败
4 乱码三不原则	乱码特征表（鈥?/??OK??/\uFFFD）+ 不猜/不引用/先重读	??OK??、??? skill ???? 乱码当答案

windows-sys —— 系统环境（排查类）

章节	内容	来源问题
1 路径与文件系统	MAX_PATH/长路径、空格路径、EACCES/EBUSY 文件占用、junction 与 link: realpath、路径格式	EACCES: realpath '...sock'、npm-cache 深层路径
2 进程与端口	netstat 查端口、Stop-Process/taskkill、先查后杀	3080/39090 端口占用、孤儿进程
3 跨平台杂项	CRLF 陷阱、.cmd 脚本宿主/ExecutionPolicy、时区、大小写	小说文件 CRLF 检查、run.bat chcp 65001

安装

# 本地 link 开发（本仓库）：
git clone https://github.com/Pasumao/dsh-plugin-windows-guard.git D:\dsh\plugins\dsh-plugin-windows-guard
#   1. profile package.json dependencies 加
#      "dsh-plugin-windows-guard": "link:D:/dsh/plugins/dsh-plugin-windows-guard"
#   2. 加入 dsh.profile.bundles（或 cordis.patch.yml 手动 insert）
cd C:\Users\18303\.dsh\profiles\web
pnpm install
node D:\dsh\scripts\check-profile.mjs          # 自检 [PASS] 再重启
powershell -NoProfile -ExecutionPolicy Bypass -File D:\dsh\scripts\restart-dsh.ps1

# npm 分发安装（发布后）：
npm install dsh-plugin-windows-guard --prefix C:\Users\18303\.dsh\profiles\web
# 并在 profile 包/补丁中挂载，其余同上

使用

安装后无需任何配置。模型遇到 Windows 命令/编码/乱码/路径/进程/端口任务时， skill({ name: "windows-enc" | "windows-sys" }) 自动加载对应守则；也可手动让模型 加载查看全文。

用户：读一下 D:\dsh\config\comfy_prompt.json 看看配置
模型：读取前先按守则用 Get-Content -Encoding UTF8……

配置/示例

无需任何配置：挂载后即生效，无 API key、无 token、无配置文件。示例：

用户：读一下 D:\dsh\config\comfy_prompt.json 看看配置
模型：读取前先按守则用 Get-Content -Encoding UTF8……

更完整的使用说明见上方「使用」节。

为何拆成两个（设计说明）

• 常驻目录成本：两条 description（~300 token）几乎不涨；
• 触发精度：windows-enc 管「命令/文件内容出错」（编码/转义/乱码）， windows-sys 管「系统环境排查」（路径/进程/端口/跨平台），边界清晰、互不牵连；
• 正文按需减半：Windows「内容出错」类任务不再加载「系统环境」整章；
• 预留给未来主题（WSL/winget/容器…）归入 windows-sys 扩展。

实现说明

• 注册走 ctx.skills.register（官方 skill 子系统），content 为 SKILL.md 正文；
• 无工具、无命令、无服务端逻辑、无文件写入——纯预防性指令；
• skill 正文改动需重启 dsh（host 插件 apply 时读取 skills/ 目录）。

相关插件

已发布插件互相引用（更多 DSH 插件生态）：

• dsh-plugin-workbench — VS Code 风格工作区文件浏览器 + 可编辑预览
• dsh-notify — agent 停止/出错的 Windows 原生通知 + 托盘图标
• dsh-plugin-image-tools — 图片选择卡 / 回复内嵌图片 / 聊天图片放大
• dsh-plugin-dev-kb — dsh 官方文档完整 Markdown 镜像（插件开发知识库）
• dsh-plugin-choice-refresh — 选择卡「重新生成选项」/「更多选项」
• dsh-plugin-table-zoom — 聊天表格浮窗查看 + 一键复制 Markdown