dsh-sidebar-drawer
Web GUI 左侧边栏的边缘悬停抽屉：将指针移至屏幕左边缘时显示，指针停留在其中时保持显示，指针离开后收回
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-sidebar-drawer@0.1.1
Sidebar Drawer 以 dsh-sidebar-drawer 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
左侧栏边缘抽屉：侧栏收起时，把鼠标移到屏幕最左边 10px 内并停留 500ms 就会抽出侧栏；鼠标停在抽屉里期间一直保持抽出；鼠标离开抽屉后自动收回。
一个纯浏览器行为插件（Host 半边是空的），只借用 DSH 自己的侧栏开合，不改动任何内置文件。
逐条场景、状态机不变量与已知缺口见 docs/behavior.md。
这是一个 DSH plugin bundle：包内自带 cordis.patch.yml，package.json 里声明了
dsh.bundle.patch，所以它由 Plugin Manager 安装并托管挂载行 —— 不需要你手改 profile 的补丁文件。
# 从 npm 安装（推荐，带版本钉住）
dsh plugin --profile desktop add dsh-sidebar-drawer@0.1.1
# 从 GitHub 安装（同样钉住版本，走仓库的 v0.1.1 tag）
dsh plugin --profile desktop add "github:1dustycy/dsh-sidebar-drawer#v0.1.1"
# 跟随 main 最新提交（便于拿到最新行为改动）
dsh plugin --profile desktop add github:1dustycy/dsh-sidebar-drawer
# 从本地目录安装（开发用：写入 link: 依赖，改动即时生效）
dsh plugin --profile desktop add /path/to/dsh-sidebar-drawer
把 desktop 换成你要装的 profile 名（如 web、tui）。这条命令做两件事：把包装进
~/.dsh/profiles/<name>/package.json 的 dependencies，并把 dsh-sidebar-drawer 加进该 profile 的
dsh.profile.bundles。装完后刷新页面即可生效，不需要重启 App（客户端半边由 bundle 的 mtime
轮询 + /plugins/events 热加载）。
卸载：
dsh plugin --profile desktop remove dsh-sidebar-drawer
为什么不直接往 profile 的
cordis.patch.yml里加一行？那是与其他会话共享的文件，被覆盖时 症状是插件"装了但没生效"，且从插件自身看不出任何异常。理由见 ADR-0003。
要求：DSH Desktop（或任何带 Web GUI 的 profile）。客户端半边注入
@deepseek-ai/dsh-client-ui-layout，所以目标 profile 必须已挂载 Web 布局 bundle。
peerDependencies 为 @deepseek-ai/cordis >=4.0.4 <5 —— 从 registry 安装时 Plugin Manager 会先
核对这一条，不兼容就在下载之前拒绝。
node test/client.test.mjs # 单元套件：vm + DOM 替身 + 会推进的虚拟时钟，不需要浏览器
node test/browser.test.mjs # 浏览器套件：真实 Chromium + CDP 真实鼠标事件与真实 CSS 动画
npm test # 依次跑上面两套
node tools/probe.mjs # 诊断工具：打印一次边缘停留的决策轨迹
npm pack --dry-run # 确认发布内容
改 lib/client.js 后刷新页面即可生效（前提是 profile 的 hmr 行处于启用状态，桌面 profile 默认启用）。
test/browser.test.mjs 自带 HTTP 服务与浏览器进程，跑完即退出；需要本机有 Chromium（找不到会自动跳过）。
SHOT=<路径> node test/browser.test.mjs 会把最后"抽屉打开"的画面存成 PNG（docs/harness-open.png
即由此生成）。顶部那张动图反过来 —— 它是真实 GUI 的屏幕录制，不是夹具 —— 用
node tools/demo-gif.mjs <录屏文件> 重新生成，需要本机有 ffmpeg。test/harness.html 是内置三栏
框架的等价复刻，用浏览器直接打开并加 ?plugin=<client.js 的 URL> 也能手工试。
改测试夹具前请先读 docs/implementation.md。 两套夹具必须精确建模出厂 shell 的锚点契约：夹具一旦把条件锚点写成常驻，就会在一个已损坏的 bundle 上全绿 —— 本插件正是这样发布过一个"指针停在边缘不动就无限开合"的缺陷。
| 文档 | 内容 |
|---|---|
| docs/behavior.md | 行为规格：逐条场景、状态机不变量、已知缺口 |
| docs/implementation.md | 实现要点：出厂锚点契约、判定逻辑、可调参数 |
| docs/adr/ | 决策记录（为什么这样做） |
| CONTEXT.md | 术语表：中文措辞与代码标识符的对应 |
MIT