🗂️ dsh-workspace-hub — 工作区中枢

> DSH 工作区的一站式组织与洞察面板 — 分组归类、拖拽排序、内联编辑，配上 Token、花费与额度的实时统计，让每个工作区都一目了然。

![npm](https://www.npmjs.com/package/dsh-workspace-hub) !Version !License !Node !Platform

---

✨ 功能亮点

🗂️ 分组管理

三层拖拽排序 — 分组卡片、工作区行、会话行随意拖放，带实时插入指示线，视觉与结果严格一致
内联编辑 — 新建/重命名分组、工作区、会话全部就地完成，告别浏览器弹窗
一键展开 / 折叠 — 全部分组一键收放，长列表不再翻到手酸
🔍 消息搜索 — 标题 + 消息全文双通道，快速定位任意会话
会话分叉 / 归档 — 生命周期操作一步到位

📊 Token 统计

行内精简总量 — 工作区标题下方一眼看到消耗规模
悬停明细卡 — 当前 / 含归档双口径，输入 / 输出 / 缓存读 / 缓存写四桶拆分，逐会话列表，按模型归因
总览面板 — 合计、分组小计、工作区排行（条形占比）、逐会话明细
🟢 实时刷新 — 每 30 秒自动静默刷新（标签页隐藏时自动暂停），聊天中的 token / 费用用量无需刷新页面即更新

💰 花费统计

按模型 × 单价 × 时段 精确计价，不是平均估算
单价卡片设置 — 每个模型一张卡片，空闲 / 高峰两行三档单价
🟢 deepseek 全系默认官方价 — 内置 2026-08-17 峰谷定价（V4-Flash / V4-Pro），任意 provider（含 opencode）下的 deepseek 模型都自动按官方价计费，pro 型号自动用 pro 价；你改过的价格始终优先
⏱️ 三档时段口径：

- 全部（默认）= 空闲桶按空闲价 + 高峰桶按高峰价（真实总花费） - 空闲 / 高峰 只看对应时段 - ✅ 恒等式：全部 = 空闲 + 高峰

📡 OpenCode Go 额度

三窗口用量 — 5 小时滚动 / 本周 / 本月，百分比 + 进度条（<50% 绿 / 50–80% 黄 / ≥80% 红）+ 重置时间
一键刷新 — 绕过缓存直连官方端点
密钥自动读取自 ~/.local/share/opencode/auth.json（opencode-go / opencode 条目），零配置

> 💾 数据存储：分组、排序、单价全部持久化到 Host 磁盘 ~/.dsh/wsfm-folders.json 与 ~/.dsh/wsfm-prices.json（换浏览器 / 清缓存 / 换端口仍在），浏览器 localStorage 仅作快速加载兜底；费用与 Token 结果持久化到 ~/.dsh/wsfm-cost.json 与 ~/.dsh/wsfm-tokens.json（按会话日志水位校验，重启不重算未变化的会话，首次计算后秒回）；费用 / 额度缓存在浏览器 localStorage（dsh.wsCost.v1 / dsh.wsUsage.v1）。无服务端状态，卸载即清净。

---

🏗️ 架构

半	入口	职责
🖥️ Host	`src/index.ts` → `lib/index.js`	`/api/wsfm/tokens`、`/api/wsfm/cost`（磁盘缓存 + 水位校验）、`/api/wsfm/usage`（OpenCode Go 额度代理）、`/api/wsfm/folders`、`/api/wsfm/prices`（分组与单价持久化），全部 loopback-only JSON 路由
🌐 Client	`src/client/index.js` → `lib/client.js`	ModuleLoader handoff bundle；注入 `sidebar.workspaces` 槽位

🪶 零第三方运行时依赖 — host 侧零依赖，client 侧仅 peer 依赖 react
🔒 所有 API 带浏览器同源信任围栏，会话数据绝不上公网
⚡ 性能：费用与 Token 结果持久化并按会话日志水位校验，重启不重算未变化的会话；30 秒实时刷新（标签页隐藏自动暂停）

---

🛠️ 构建

pnpm install
pnpm build

产出 lib/index.js（tsc）+ lib/types/*.d.ts + lib/client.js（ModuleLoader bundle）。

📦 安装

推荐（npm，已发布到官方源）：

dsh plugin --profile web add dsh-workspace-hub

从 GitHub 安装（仓库自带构建产物，无需本地构建）：

dsh plugin --profile web add github:Jadramcool/dsh-workspace-hub

本地开发（构建后）：

pnpm install && pnpm build
dsh plugin --profile web add link:<本仓库路径>

> 📌 安装后只需重启 dsh web 即可生效 —— 包内部的 dsh.bundle.patch 声明会在 dsh plugin add 时自动注册进 profile 的 bundle 层，无需手动编辑任何 patch 文件；重启后插件行即进入 roster，host 路由与侧边栏槽位自动接管。

🗑️ 卸载

dsh plugin --profile web remove dsh-workspace-hub

---

📄 License

<p align="center"> <sub>Made with ❤️ for the DSH community</sub> </p>

来源信息

安装

检查来源文件