dsh-no-workspace

为 DeepSeek Harness 提供「只读会话」的插件。
不选工作区，即刻开始；一经选择，永久只读。

_{社区插件，并非 DeepSeek 官方产品。中文 · English}

这是什么

dsh-no-workspace 是一个 DeepSeek Harness（dsh）插件：在工作区选择器中提供「不使用工作区（只读会话）」入口，并提供「只读会话」模式。无论从哪个入口进入，会话都被结构性锁定为只读——只能对话、网页检索、查会话历史、跟踪任务与目标；文件访问受控（隔离目录内的相对路径免审批，其余读取逐次审批），没有 Shell、没有写入工具、没有子代理。

主要功能

不使用工作区（只读会话） 工作区选择器菜单中的入口：点击后直接创建无工作区会话并跳转进入。会话工作目录是 $DSH_HOME/.dsh-no-workspace/<sessionId>/ 下的空隔离目录。	结构性只读锁定 会话成为只读的瞬间写入零长度 turn/start+turn/end，使其永久非 blank，官方预设切换守卫从此拒绝任何预设变更——工具面不可升级。
只读会话模式 「只读会话」同时出现在模式选择器中，已有会话可切换进入（同样立即锁定）。也可用 /readonly-session 命令创建。	与官方构建零耦合 不修改官方源码、不修改官方构建产物、不装饰任何官方服务。菜单项由精确路由在 serve 时于内存中注入官方 bundle，官方包重建、升级、pnpm install 后无需任何重放操作。

安装

前置：本机已有一份已构建的官方 dsh 项目（在其目录内执行过 pnpm install && pnpm run build）。以下步骤中的 <仓库地址>、<dsh 项目目录> 请替换为实际路径，不要照抄示例。

# 1. 获取插件源码
git clone <仓库地址> dsh-no-workspace
cd dsh-no-workspace

# 2. 构建插件
pnpm install && pnpm run build

# 3. 安装进 web profile（在官方 dsh 项目目录内执行；命令由 dsh CLI 提供）
cd <dsh 项目目录>
pnpm dsh plugin --profile web add <插件目录的绝对路径>

# 4. 重启 dsh web，浏览器硬刷新（Ctrl+F5）
pnpm dsh web

说明：

• 第 3 步把插件登记到 $DSH_HOME/profiles/web（$DSH_HOME 默认为 ~/.dsh），路径写法与平台无关；
• 首次启动时插件把 presets/no-workspace 复制到 $DSH_HOME/.agent-presets/no-workspace/（幂等，用户编辑过的副本不会被覆盖）；
• 把本 README 与仓库链接一起交给 AI 时，AI 按上述四步执行即可完成安装，无需任何手工改动官方项目。

使用

• 打开工作区选择器 → 「不使用工作区（只读会话）」；或输入 /readonly-session 命令；或创建会话后在模式选择器中选择「只读会话」。
• 会话一经选择即被锁定：写入零长度 turn/start+turn/end 使其永久非 blank，官方预设切换守卫（agent-preset-locked）从此拒绝任何预设变更。
• 通过「不使用工作区」菜单或 /readonly-session 命令创建的会话，默认模型为 deepseek-v4-flash + reasoningEffort: 'low'，会话内可随时手动修改；从模式选择器切换的会话沿用其原有模型。

安全模型

承诺	机制
工具面不可升级	会话成为 no-workspace 的瞬间（创建时或 blank 期切换时）写入零长度 turn/start+turn/end → 永久非 blank → 官方预设切换守卫永久拒绝任何切换
无写入/无命令	no-workspace 预设只挂只读工具；官方 tool-fs（read/write/edit）与 Shell 工具从不挂载
文件访问受控	绝对路径 → 每次调用用户审批（fail-closed）；相对路径 → 仅当会话目录位于隔离根（settings.dsh-no-workspace.isolatedRoot）之内时免审批，否则同样审批；无会话目录的读取直接拒绝
权限旋钮无效果	沙箱模式可切换，但没有写工具消费更宽的模式；只读由工具面结构性保证

与官方项目的关系

本项目是 deepseek-ai/deepseek-harness 的社区插件，基于官方插件机制构建：

• 工具/命令/预设各守各的作用域与数据，不覆盖任何官方组件；
• 唯一的共享面是用户预设名录（$DSH_HOME/.agent-presets/no-workspace），由插件安装、幂等复制；
• 菜单项由 host 端的精确路由在 serve 时注入官方 bundle 内容（内存装饰，可逆，卸载即还原）；
• 核心的智能体、模型、工具、会话、Web UI 与插件生态均来自官方项目，本插件只在其上添加「只读会话」这一项能力。

开发

pnpm install
pnpm run build     # tsc（host）+ tsdown（host + browser bundle）
pnpm test          # vitest

目录：src/（命令/隔离/锁定/设置/菜单注入）、src/tools/（只读工具）、src/client/（菜单项）、presets/（预设组合）。完整设计记录见 docs/design.md。

License

本项目遵循 MIT License。

本项目是 DeepSeek Harness 的社区插件，并非 DeepSeek 官方产品。DeepSeek 是 DeepSeek AI 的商标。