dsh-Basics-Panel

dsh-basics-panel

DSH Web 插件「基础能力面板」：在 设置 → 基础能力 中可视化管理 MCP 服务器、技能、规则与归档会话。

当前兼容版本

插件 0.4.2 要求 DSH >=0.2.1-rc.2 <0.3.0-0。 本次实际核对与回归的宿主是 0.2.1-rc.2；范围内未来版本仍需复验，不代表预先认证。

• 修复升级后四个页签的空 HTTP 405：旧插件等待已移除的 webRuntime，后端未挂载，请求落到静态页面 fallback。
• 宿主注入改为 webServer / connection / sessions / skills / tools，所有管理请求先走公开的 connection.admit()：沿用宿主 Host/Origin 栅栏、浏览器登录 Cookie 和 API Peer 认证，并只允许 owner 身份。
• 不提供免认证降级，不再维护旧的独立信任栅栏。401 提示重新登录；空 405 提示检查安装副本并重启。
• 全局规则补齐 $DSH_AGENTS_HOME/AGENTS.md（默认 ~/.agents/AGENTS.md），与 $DSH_HOME/AGENTS.md 一起发现；新建全局规则仍只写 DSH 根。
• 四个 DSH 开发依赖对齐 0.2.1-rc.2，Cordis 对齐 4.0.5；两个插件清单版本同步为 0.4.2。

较早 DSH 请保留旧插件版本；0.4.1 之前的兼容记录不代表 0.4.2 继续支持旧宿主。详细操作见 使用文档；本轮证据与限制见 0.2.1 兼容记录。

功能与范围

配置文件、规则和会话产物使用 DSH 宿主本地文件系统，不是当前远程工作区的 SSH 文件系统。归档删除不清理附件、查询 SQLite 索引等派生数据，也不承诺协调其他进程的会话写入锁；有其他进程使用同一会话时不要删除。

安装与更新

此包当前没有 npm registry 发布包。先在源码目录构建，再用官方 CLI 安装本地依赖：

pnpm install
pnpm typecheck
pnpm test
pnpm build
dsh plugin --profile web add file:<源码目录绝对路径>

当前 web profile 已经是 file: 依赖时，可使用本仓库的定向同步通道；构建本身不会更新安装副本：

pnpm run sync
pnpm run sync:check

同步目标默认为 $DSH_HOME/profiles/web/node_modules/dsh-basics-panel，可用 --profile、DSH_PROFILE、DSH_HOME 覆盖。同步前请备份安装副本和 profile；同步脚本会整体替换本插件的发布目录，不修改其他插件。不要把尚未完成的构建同步到运行环境。

更新后必须重启原 DSH 进程，并在原页面 Ctrl+F5 刷新。 只刷新浏览器不会重新挂载宿主路由；不需要另开 Web 服务。401 时通过 DSH 启动提供的登录链接重新进入，不要关闭认证。

开发与回归

pnpm typecheck
pnpm test
pnpm build

真实宿主契约测试需要将 DSH_RUNTIME_NODE_MODULES 指向所测试 DSH 的 node_modules；未指定时该组明确跳过，指定无效路径或宿主缺少服务时必须失败。PowerShell 示例：

$env:DSH_RUNTIME_NODE_MODULES = '<当前 DSH 安装目录>/node_modules'
pnpm test
dsh --profile web --dump-config

真实测试加载官方 Cordis、Connection、BrowserAuth 与兼容性预检，使用隔离内存凭据；不会读取用户凭据、调用模型或启动替代 GUI。HTTP 回归另外覆盖四类读取、只读写入拒绝、请求体上限、认证失败、原型属性拒绝及路由卸载。--dump-config 只是组合预检，不等同于全部服务实际激活或浏览器点击验收。

可选服务必须在调用时刻解析

workspaceRegistry、sessionPersistence、agentPresets 等可能晚于本插件就绪，因此各功能每次请求重新 ctx.get()，不在启动时固化空值，也不将可选服务变成强制依赖。

安全

• 每个管理请求先通过宿主认证和来源校验，拒绝后不读取请求体、不调用功能后端。
• MCP 配置敏感值脱敏；文件写入须重新发现路径白名单；技能/规则保存有大小与 mtime 检查。
• readOnly 禁止所有修改；allowSessionDelete: false 可单独禁止删除归档。
• 归档删除只接受归档集合里的 ID，重新定位并验证宿主本地会话目录；不是上游会话删除 API，也不是跨进程回收服务。

License

MIT