Overview
dsh-sidebar-panel
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **details 列替换**:插件以 `priority: -1` 顶替内置 DetailsPanel(单槽位只能有一个渲染者)。内置面板的"工具详情"座(`conversation.details.tool`)属于其自身声明,插件无法复用,故"工具"页签为自建详情视图;聊天里的 Inspect 按钮仍会打开右侧列,但不会自动选中工具。 - **开合偏好(常驻)**:面板开合状态存于浏览器 localStorage(`dshSidebarPanel:details-open`),默认 `open`。**切会话/新建会话不会自动收起**:宿主框架在切换会话(及 blank 会话首次发言 engage)时会调用 `closeDetails()` 收起 details 列,插件检测到会话/blank 变化后会自动重开,直到用户主动点击收起/关闭(记为 `closed`,此后所有切换都保持收起,直到再次点击打开)。 - **blank(新建会话 hero)期间面板也常驻**:宿主布局在 blank 状态下会把 details 列宽强制为 0、并隐藏整个会话 header(右上角按钮随之消失)。插件只注入**一条声明式 CSS 规则**(`!important`,三列:`<侧栏>px | 聊天区 minmax(0,1fr) | 面板 360px`)在 blank 且偏好为打开时生效——不触碰宿主内联样式、不与 React 渲染竞争,宿主任何重渲染都无法覆盖;三列是真实 grid 单元格,面板**结构性固定在右侧固定宽度**,不可能全屏或遮挡聊天区。同时在**右上角原位**渲染同款固定折叠按钮(仅 blank 期间显示,点击真实开合并同步布局状态);会话正式启用后规则移除、宿主恢复正常接管,固定按钮自动隐藏、右上角 header 按钮回归。 - **费用匹配**:费用是估算值,取决于定价表配置;金额保留 6 位小数传输、按大小自适应显示精度。 - **改动追踪**:只覆盖写文件类工具调用;bash/pwsh 内部的文件改动无法可靠捕获。 - **概览请求数/费用/运行时间**:由服务端从会话事件日志折叠(`request/header`、`assistant/message` 的 usage),插件安装前的历史会话在首次访问时会一次性补算;运行时间 = 自首次请求至今(含空闲)。 - **账户数据口径**:**余额**来自 DeepSeek 官方接口(需在 DSH 凭据/环境变量中配置 `DEEPSEEK_API_KEY`,否则显示"未配置"提示)。官方仅提供余额查询接口,无公开的累计消费/请求次数接口,故账户卡片不再展示这两项;官方精确账单可通过"充值"按钮进入 https://platform.deepseek.com/usage 查看。 - **跨域防护**:GET 请求不做 Origin 校验(同源 GET 本就不带 Origin 头);POST 依赖"不响应 CORS 预检 + 仅接受 JSON"防线(与 DSH 宿主 API 同策略)。
