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

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

---

✨ 功能亮点

🗂️ 分组管理

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

📊 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

Apache-2.0 © 2026 jadramcool

_{Made with ❤️ for the DSH community}