Windows 调试经验库 NAGOTOXIMU/dsh-experience

DSH 调试经验库

DSH（DeepSeek Harness）在 Windows 上的使用与调试经验集合。
内容以「症状 → 根因 → 处置」与「可照做的流程」为主，便于检索与引用。

环境：DSH 0.2.0-rc.2 桌面版，Windows 11（Build 26200）

00-速查（入口）

| 文件 | 用途 |
| 症状索引.md | 报错 / 异常 → 去哪看 |
| 操作索引.md | 想做什么 → 去哪看 |
| 未解决清单.md | 还没解决的问题 |

01-操作手册

| 文件 | 内容 |
| 安全操作.md | 环境 / 配置 / 目录 / 仓库 / 效率 五类操作 |
| 危险操作.md | 会导致问题的操作 + 正确替代做法 |

00-总览

| 文件 | 主题 |
| 从零开始：DSH改装指南.md | 从零配置 DSH 的完整顺序与注意事项 |
| Windows沙箱与令牌问题合集.md | 沙箱 / 权限 / 令牌的层次模型与判别决策树 |

02-失败模式

| 文件 | 主题 |
| 低完整性标签污染程序.md | 工作区被设 Low 完整性 → 里面的 Electron 应用秒退（0x80000003、无任何日志） |
| 工作区权限阻塞所有命令.md | 工作区权限不足时任何命令都起不来（两种形态） |
| pwsh写入范围只有工作区.md | 完全权限下 pwsh 仍只能写工作区 |
| DSH双客户端互斥.md | 两个桌面客户端共用 userData / 端口 → 后启动的起不来 |
| 插件装了不激活.md | 三层激活判据（dsh.client / inject 完整性） |
| Windows下HOME为空.md | process.env.HOME 为空 → 插件读不到文件 |
| 工具数据源不一致.md | Config 是快照、plugin_manager 是实时 |
| 受限沙箱下git推送失败.md | 受限模式下 git push 必失败的两个原因 |
| 管道截断导致假失败.md | \| Select-Object -First N → 子进程退出码变 -1 |

03-可复用工作流

| 文件 | 主题 |
| 为agent选择工具而非GUI.md | 把"给人用的操作"换成"给 agent 用的接口" |
| 安装第三方DSH插件.md | 从寻源到验证的完整流程 |
| 查清DSH内部行为.md | 读 app.asar 查明内部逻辑 |
| 核对故障报告的归因.md | 逐条核对一份故障报告的归因是否成立 |

04-自省

| 文件 | 主题 |
| 我的六类误判.md | 排查过程中犯过的错误判断 |

许可

本仓库内容采用 CC BY-NC-SA 4.0（署名 — 非商业性使用 — 相同方式共享 4.0 国际）许可。

- 官方全文：LICENSE
- 中文说明与免责：LICENSE.md

引用格式：

来源：DSH 调试经验库（<https://github.com/NAGOTOXIMU/dsh-experience>）许可：CC BY-NC-SA 4.0

⚠️ 仓库内含涉及注册表、权限（icacls）、完整性标签、卸载、删除的操作说明，请先在可回滚的环境验证后再用于生产环境。