会话工作区隔离 xarleyn/dsh-session-scope

[!IMPORTANT]
本仓库已归档，只读。 插件已迁入 xarleyn/dsh-plugins monorepo，并以 @yadsh/dsh-session-scope 发布（源码：plugins/dsh-session-scope）。
旧的无作用域包 dsh-session-scope 已由 @yadsh/dsh-session-scope 取代。

dsh-session-scope

[!IMPORTANT]
本仓库已归档。

插件开发已迁至 xarleyn/dsh-plugins monorepo，那里现在是项目的正式主页。

请改用新仓库：

* 获取新版本和更新；
* 提交 bug 报告和功能请求；
* 提交 pull request 和后续开发。

本仓库仅作历史留存，保持只读。

为 DeepSeek Harness 提供独立的按会话工作区可见性层。
会话保留原有工作区和 cwd，只向智能体暴露明确选中的工作区目录。

核心策略规则是：

Permission != Scope

权限控制效果（read-only、workspace-write 或 danger-full-access）。会话作用域独立控制工作区哪部分可见（full、focused 或 Linux 的 isolated）。

开发状态

0.5.0 已实现规范到第 4 阶段。当前包含：

- 可复用上游目录选择器、路径安全、文件系统围栏和沙箱集成的 TypeScript 移植；
- 严格的 TypeScript 会话作用域领域模型；
- 持久化的 session-scope/set 快照和最后写入胜出折叠；
- full、focused、isolated 状态词汇；
- 规范根校验、嵌套根折叠、导航祖先和稳定错误码；
- 类型化宿主操作（getScope、setScope、listScopeDirectory 和 getScopeCapabilities），以及 /scope 命令和 session-scope 投影；
- 内容路径与导航路径的纯可见性规则、过滤后的目录列表，以及限定作用域的 glob/grep/search 根；
- 运行时文件系统强制，按会话通过 AsyncLocalStorage 携带，包括文本读取和有界字节读取，以及针对已知路径感知工具的单调最终守卫；
- 跨选中内容根的广泛 glob/grep 组合，包括省略路径时的失败关闭处理和输出路径复验；
- 面向模型的作用域上下文，暴露可访问根，但不提及隐藏的兄弟目录；
- 独立的 Scope 组合器标签和树选择器，与普通权限选择器分离；
- 通过 DSH 现有 bubblewrap 服务商实现 Linux isolated 进程隔离，用于一次性 bash 和持久 PTY 创建；
- 空工作区覆盖层，仅重新绑定选中根，权限感知
- 只读/可写挂载，以及挂载后的工作目录；
- 后端能力探测：能实际探测后端能力，并对未知 runner 配置档、部分生效、不支持的平台和 danger-full-access 一律按失败关闭处理；
- 进程生命周期围栏：前台或后台 shell 任务、常驻终端仍持有旧挂载视图时，阻止切换作用域；
- 作用域内的前置步骤文件系统上下文：用于工作区指令和项目技能发现；工作区之外的用户/OS 路径仍走 DSH 的常规策略；
- 选定作用域下 LSP 调用按失败关闭处理，因为当前上游 LSP 服务商会索引整个会话工作区；
- fork 继承：通过持久化种子继承，子代理在发布前按失败关闭初始化，覆盖嵌套子代理和恢复的子代理；
- 兼容折叠：处理旧版 workspace-scope/selection 会话；
- Vitest 覆盖移植过来的基础原语和新的作用域状态。

Focused 作用域覆盖 DSH 文件系统服务和已知的路径感知工具，但不限制任意 shell 进程。Isolated 作用域还会限制 DSH 支持的 bash 和 PTY 启动路径，前提是 Linux 服务商选中了完全生效且可识别的 bubblewrap 配置档。其他后端不支持 Isolated，目前也不能与 danger-full-access 组合；这些组合按失败关闭处理，不会静默降级为 Focused。

安装

npm install dsh-session-scope

包内以 cordis.patch.yml 形式提供 DSH bundle 补丁，并通过包的 exports 映射暴露服务端和 Web 客户端入口。需要 Node.js 20 或更高版本。

开发

npm install
npm run check

CI 在 Linux、macOS 和 Windows 上运行 TypeScript 构建、Vitest 测试套件、包契约检查，以及针对 compatibility.json 中列出的 DSH 版本做打包插件组合冒烟测试。

TypeScript 源码位于 src/；npm run build 会把可分发的 ES 模块、source map 和声明文件输出到 lib/。测试用 Vitest 运行。

前作与署名

最初的目录选择器、路径规范化、文件系统围栏和沙箱集成改编自 jiangr100 的 dsh-workspace-scope-selection，按 MIT 许可证使用。原始版权声明保留在 LICENSE 中。