前言¶
在 DeepSeek Harness（DSH）里，每个会话都绑定一套权限预设：仅可查看、工作区内修改、或完全权限。日常开发时，这些设置分散在各个会话内部——要改某一个，得先进入该会话；要确认「哪些会话仍是完全权限」，往往只能逐个打开核对。会话一多，这类运维式检查就会占用不少时间。
社区插件 dsh-permission-panel（维护者 kirito787-neet，分类 admin-security）把同一工作区下的会话权限收进一张表，支持搜索、按工作区分组、按权限等级筛选，以及单条或批量修改。面板不自行持久化权限状态，读写均走宿主原生命令，因此列表里看到的与各会话实际生效的策略一致。项目声明代码、测试与文档等产物由 AI 生成，作者提供想法与验收方向；使用前请自行复核源码与许可证（MIT）。
这是什么¶
dsh-permission-panel 是 DSH 的工作区权限面板插件：一页浏览所有（非归档、非子代理）会话的权限预设，按需单改或批量改，并可查看「当前会话」在宿主侧实际生效的策略说明。同一份源码同时支持 Web 与 Desktop 两种载体。
核心功能¶
会话列表与分组¶
每个会话一行，展示彩色首字头像、标题、工作目录；正在运行的会话带绿点。列表按工作区分组，默认收起；组头显示工作区名、路径、会话数与已选数量。不属于任何工作区的会话落在末尾「未分组」。工具栏提供「展开全部 / 折叠全部」。归档会话不出现在列表中，面板底部会说明跳过了多少条。
权限尚未从宿主读回时，行内会显示「待读 / 读取中 / 失败」；查询不会打开或激活会话，可在后台刷新；读不出时可点刷新重试。
搜索与筛选¶
- 搜索：按标题、目录、工作区名匹配，实时显示「匹配 N / 总数」。有搜索词时自动展开所有分组，避免匹配项藏在折叠组里。
- 按权限等级筛选：工具栏标签（如「完全权限」）可只显示对应预设的会话；标签上的数量会随搜索条件变化。
- 定位当前会话：从会话头部入口打开面板时，可用该按钮清除搜索与筛选、展开所在分组，并将当前行滚到视区中央并短暂高亮。
搜索与筛选可叠加；被藏起来的行不会参与误选批量操作（见下文）。
修改权限¶
三档预设：仅可查看、工作区内修改、完全权限。
- 单条：行右侧下拉选择，立即生效。
- 批量：勾选多行后，底部批量条选择预设并「应用到所选」；部分失败会列出未成功的会话。
- 被搜索或筛选隐藏的行会自动从选中中移除，批量只作用于当前可见行；折叠分组不影响已勾选项。
- 切换到完全权限前需确认风险提示；批量切换只确认一次。
新会话默认权限¶
面板内可设置之后新建会话使用的默认预设，不影响已有会话。
当前会话策略卡片¶
从会话头部的「权限」按钮进入时，顶部卡片展示当前会话标题、宿主读回的实际生效预设及原文说明；别处改过权限后，重开面板或「重新读取」即可更新。该卡片仅在此入口出现；设置 → 插件 → 工作区权限 为全页视图，无主视图「当前会话」概念，故不显示此卡片。
Desktop 快捷键¶
| 命令 | 默认键位 | 载体 |
|---|---|---|
| 重启 DSH（权限面板） | Ctrl+Shift+R（macOS Cmd+Shift+R） |
仅 Desktop |
命令注册在官方快捷键服务，可在 设置 → 快捷键 中改键。可在 设置 → 插件 → 权限面板 关闭该快捷键（键位与冲突检测仍保留）。Web 载体无「重启应用」场景，故无此键位。
安装与启用¶
--profile 为必填，无默认 profile；--profile desktop 须使用 DSH Desktop 自带的 dsh，普通 @deepseek-ai/dsh 会拒绝。
# 从 npm 安装（推荐）
dsh plugin --profile <profile> add dsh-permission-panel
# 需要固定某一版时
dsh plugin --profile <profile> add dsh-permission-panel@3.3.0
卸载：
dsh plugin --profile <profile> remove dsh-permission-panel
安装完成后重启 DSH（Desktop 重启应用，Web 重启 dsh web）。在 设置 → 插件 中可见「权限面板」与「工作区权限」相关页面。从源码或 tarball 安装见仓库 docs/COMPATIBILITY.md。
当前 npm 包版本为 3.3.0（README 记载：3.3.0 增加按权限等级筛选与定位当前会话；更早变更见仓库提交记录）。
典型用法¶
- 安装并重启后，打开 设置 → 插件 → 工作区权限，或在工作中的会话里点头部 「权限」（后者还可看顶部当前会话策略卡片）。
- 用搜索或权限标签缩小范围；需要整理某工作区时展开对应分组。
- 单条改权限用行尾下拉；多条勾选后使用底部「应用到所选」。
- 若希望新建会话默认更保守或更开放，在面板中调整「新会话默认权限」。
适用场景与注意¶
适合经常在 DSH 中并行多个工作区、多个会话，需要集中审计或批量收紧/放宽权限的开发者。完全权限风险较高，插件在切换前强制确认，批量亦同。
使用前请注意：
- 插件在当前 dsh 进程权限下运行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，并知悉项目免责声明（非 DeepSeek 官方产品、按现状提供等）。
- 面板不保存权限副本；以宿主为准。
- 社区插件目录 SkillHub 条目 与 GitHub 为公开信息来源，目录站点与 DeepSeek / 幻方无官方从属关系。
DSH 生态强调「一切皆插件」；权限面板补的是「跨会话可见、可批改」这一环，而不是替代会话内的细粒度策略设计。
结尾¶
若你受困于权限设置分散、核对成本高，dsh-permission-panel 提供统一表格视图，并与宿主权限保持同源读写。进一步了解可访问 SkillHub 插件页 与 GitHub：kirito787-neet/dsh-permission-panel。
