dsh-self-checking-profile

dsh Self Checking

中文 | English

本仓库为 DeepSeek Harness / dsh 提供 Self Checking 权限模式，并同时维护两条安装路线：

• Plugin 路线（plugin/） —— 一个普通的 dsh bundle 包 dsh-self-checking，通过 dsh plugin add 安装。
• Legacy profile 路线（legacy/） —— 对上游 @deepseek-ai 包的 可复现 fork 层，以独立 profile 方式安装。

两条路线暴露同一个权限预设：Web 选择器中的 🛡️🔍 Self Checking，会话中 用 /permission self-checking 切换。模型侧行为一致：命令与文件操作默认在 workspace-write 下执行；访问工作区外被拦截一次；重试完全相同的命令/操作 后以完全访问执行。

快速安装

Plugin 路线

# 在本仓库检出目录中
./install-plugin.sh            # 默认安装到 web profile
# 或显式指定：
./install-plugin.sh -p web -h ~/.dsh

powershell -ExecutionPolicy Bypass -File install-plugin.ps1

启动 dsh 后在权限选择器中选择 🛡️🔍 Self Checking。

包暂未发布到 npm，因此 install-plugin.* 当前安装本地 plugin/ 目录。 发布后的命令将是：dsh plugin --profile web add dsh-self-checking。

Legacy profile/fork 路线

# 在本仓库检出目录中
./install-legacy.sh                 # profile 名：self-checking
npx @deepseek-ai/dsh --profile self-checking

powershell -ExecutionPolicy Bypass -File install-legacy.ps1

完整的 fork 重建、补丁生成、上游三方合并流程见 legacy/README.md。

两条路线的原理与差异

模型可见语义刻意保持一致：拦截/失败 marker、一次性完全重试解锁、fs 防御性 失败提示、sandbox_permissions + justification 显式审批通道均相同。

仓库结构

├── plugin/                      dsh-self-checking bundle 包（新路线）
│   ├── lib/                     Host 插件 + shell/fs 服务子类
│   ├── cordis.patch.yml         禁用原生服务行并添加预设
│   ├── scripts/                 dev-profile 安装器和安装后校验器
│   └── tests/                   单元、Cordis、原生工具层、live runner
├── legacy/                      原 fork/profile 路线
│   ├── profile/forks/           12 个遮蔽 fork 包
│   ├── upstream/                字节级上游基线（0.1.2-rc.1）
│   ├── patches/                 锚定补丁清单 + 审阅 diff
│   ├── tools/                   snapshot / merge / gen-patches / rebuild / release
│   ├── tests/                   legacy 回归 + ACL 探针
│   ├── install.sh / install.ps1
│   ├── verify.mjs
│   └── docs/                    README 引用的截图
├── install-plugin.sh / .ps1     plugin 路线安装器（本地 file 包）
├── install-legacy.sh / .ps1     legacy/install.* 的薄封装
├── docs/self-checking-routes.md 交付路线决策记录
├── CHANGELOG.md
└── LICENSE

应该选择哪条路线？

• 日常安装与体验：Plugin 路线。
• 需要字节级可复现 fork 层、上游基线追踪，或要求会话日志与升权词汇中出现 真正的 self-checking 模式：Legacy 路线。

环境要求

• dsh 0.1.2-rc.1（先运行任意 dsh profile 一次，确保 ~/.dsh/profiles/node_modules 存在）；
• Windows、macOS 或 Linux。Plugin 路线目前只在 Windows 上有真实 runner 测试覆盖；Legacy 路线代码与平台无关。

开发

# Plugin 路线
cd plugin
npm test
npm run test:live    # Windows 真实 pwsh + windows-acl runner

# Legacy 路线
node legacy/tests/verify-self-checking.mjs
node legacy/tests/verify-acl-probe.mjs    # Windows 真实 ACL 探针

详见 plugin/README.md、 legacy/README.md 和 docs/self-checking-routes.md。