# workbench **Repository Path**: badhope/workbench ## Basic Information - **Project Name**: workbench - **Description**: Workbench - a local-first desktop workbench (Tauri 2 + React 19): live process / port / dev-server visibility + AI session token cost metering. All data stays on-device. MIT licensed. - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-12 - **Last Updated**: 2026-10-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 工作台 Workbench [English](README.md) | **简体中文** | [日本語](README.ja.md) > Tauri 2 桌面端 · 本机运维仪表盘 · AI 会话成本计量 [![CI](https://github.com/X33834/workbench/actions/workflows/ci.yml/badge.svg)](https://github.com/X33834/workbench/actions/workflows/ci.yml) [![Release](https://img.shields.io/github/v/release/X33834/workbench?color=22d3ee&label=release)](https://github.com/X33834/workbench/releases/latest) [![License](https://img.shields.io/github/license/X33834/workbench?color=34d399)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20x64-0078d4)](#系统要求) [![Tauri](https://img.shields.io/badge/Tauri-2-24c8db?logo=tauri&logoColor=white)](https://tauri.app/) [![React](https://img.shields.io/badge/React-19-61dafb?logo=react&logoColor=white)](https://react.dev/) 一个本地优先、隐私可控的桌面运维工作台：进程、端口、开发服务器与 AI 编码会话 的 token 成本，一屏看清。数据仅存本机，深浅双主题。界面提供 **English / 简体中文 / 日本語** 三语切换。 **当前只在 Windows 上开发与打包**（端口采集走 `netstat -ano`，安装目标为 NSIS）；macOS / Linux 尚未接入采集与打包，属未验证状态。 **🌐 项目主页** —— 每个镜像都有自己的落地页（见下方镜像表），且各站链接 自动指向该镜像自己的仓库与 Release。 --- ## 下载 无需配置开发环境，下载即用（Windows 10 / 11 x64）。下方每个 GitHub 镜像 都发布**自己的 Release**（安装包相同），任选顺手的平台： | 方式 | 文件 | 说明 | |------|------|------| | **推荐** | `Workbench_<版本>_x64-setup.exe`（Releases → latest） | NSIS 安装包，约 4 MB，双击安装 | | 免安装 | `workbench.exe`（Releases → latest） | 单文件直接运行，不写注册表 | > 安装包未做代码签名，Windows SmartScreen 可能提示「未知发布者」—— > 点「更多信息 → 仍要运行」即可。这是证书需要付费所致，不是文件有风险。 ### 镜像仓库 代码完全一致，五个平台；各自跑各自的 CI，受支持的平台各自发布 Release： | 平台 | 仓库 | 落地页 | |------|------|--------| | GitHub | [X33834/workbench](https://github.com/X33834/workbench) | [x33834.github.io/workbench](https://x33834.github.io/workbench/) | | GitHub | [badhope/workbench](https://github.com/badhope/workbench) | [badhope.github.io/workbench](https://badhope.github.io/workbench/) | | GitHub | [Morningstar202604/workbench](https://github.com/Morningstar202604/workbench) | [morningstar202604.github.io/workbench](https://morningstar202604.github.io/workbench/) | | Gitee | [badhope/workbench](https://gitee.com/badhope/workbench) | —（下载见其 Release 页） | | GitCode | [badhope/workbench](https://gitcode.com/badhope/workbench) | —（下载见其 Release 页） | --- ## 界面预览 > 以下截图截自**浏览器演示模式**（`npm run preview`）：非 Tauri 环境会注入 > `src/lib/demo.ts` 的静态演示数据，所有路径均为占位串，不含任何真实机器信息。 | 概览 | 进程监控 | |------|----------| | ![概览](docs/screenshots/01-overview.png) | ![进程监控](docs/screenshots/02-processes.png) | | CPU / 内存趋势、磁盘与进程分类 | 全进程快照、虚拟滚动、杀进程二次确认 | | 服务与端口 | AI 会话与成本计量 | |------------|-------------------| | ![服务与端口](docs/screenshots/03-servers.png) | ![AI 会话](docs/screenshots/04-ai-sessions.png) | | netstat 端口识别与开发框架标注 | 会话预览、token 计量、预算与模型分解 | | 项目管理 | 任务看板 | |----------|----------| | ![项目管理](docs/screenshots/05-projects.png) | ![任务看板](docs/screenshots/06-tasks.png) | | 本地项目、Git 分支检测、卡片/表格双视图 | 拖拽看板，待办 / 进行中 / 已完成 | | 设置 | 运行日志 | |------|----------| | ![设置](docs/screenshots/07-settings.png) | ![运行日志](docs/screenshots/08-logs.png) | | 主题、刷新间隔、预算与数据导入导出 | 内置日志查看器，按需尾部读取 | 截图可自行重生（需先 `npm run build` 并启动 `npm run preview`，另开一个 `chrome --headless=new --remote-debugging-port=9222`，然后 `node scripts/shoot_docs.mjs`）。脚本内置演示模式断言，页面未出现演示标记时 直接拒绝截图，避免把真实数据写进仓库。 ## 功能概览 | 模块 | 能力 | |------|------| | 🖥 **概览** | CPU / 内存趋势图、磁盘占用环形图、进程分类统计 | | ⚙ **进程** | 全进程快照、CPU / 内存排序、虚拟滚动（只渲染视口内的行）、杀进程二次确认、AI 代理识别 | | 🌐 **服务与端口** | netstat 端口监听识别、开发框架标注（Vite/Next/Django…） | | 🤖 **AI 会话** | opencode 在线会话、本地 Claude/Codex 会话预览 | | 💰 **成本计量** | token 消耗统计、按日/月趋势、预算告警、Anthropic 缓存折扣计价 | | 📁 **项目** | 本地项目管理、Git 分支自动检测 | | ✅ **任务** | 看板式任务板（拖拽切换） | | ⚙ **设置** | 主题/刷新间隔可调、预算告警自定义、JSON 数据导入导出 | | 📋 **运行日志** | 内置日志查看器、自动刷新 | ## 成本计量 - **三级降级**：measured（API 上报 usage）→ estimated（字符数启发式）→ zero_pricing - **40+ 模型价格内置**；`pricing_overrides.json` 覆盖当前**只读**（需手工放置文件，UI 未提供编辑入口） - **Anthropic 缓存语义**：`input_tokens` 不含缓存，`cache_read_input_tokens` 按 0.1×、`cache_creation_input_tokens` 按 1.25× 独立计价 - **按日归属**：measured 与 estimated 记录都按 JSONL 行级 `timestamp` 落到各自那一天（无时间戳时回退上一天 / 文件 mtime 日），会话追加只改最新一天，趋势图不会重写历史 - **未定价不冒充消费**：型号推断失败标 `unknown` 并记为 `zero_pricing`，不会按某个具体型号编造单价 - **幂等且防重复**：每个会话文件在库中只保留最新一组记录（按 `file_path` 整组替换），文件变化不会叠加旧快照 - **估算可关闭**：设置页 `计入估算记录` 开关实时影响总览 / 趋势 / 模型分解聚合 - **预算告警**：系统通知，防重复打扰 - **扫描范围**：成本扫描覆盖 `~/.claude/projects` 与 `~/.codex/sessions` 全部会话文件（UI 预览仍只展示最近 10 条） ## 桌面行为 - 关闭窗口 = 隐藏到托盘；托盘左键切换显示，托盘菜单「退出工作台」真正结束进程 - 全局快捷键 `Ctrl+Shift+W` 切换窗口可见性（被占用时降级为警告，不影响启动） - 日志按启动滚动（>5MB 归档为 `workbench.log.1`），运行日志页按需尾部读取 - 终止进程对 PID 0/4 与关键系统进程（csrss/lsass/services 等）直接拒绝 ## 快速开始 ### 系统要求 | 项 | 要求 | |----|------| | 操作系统 | Windows 10 / 11（x64）—— 仅此平台经过验证 | | 运行时 | WebView2 Runtime（Windows 11 预装；Windows 10 现代版本通常已含） | | 磁盘 | 约 35 MB（安装后），免安装版单文件约 15 MB | | 权限 | 无需管理员权限；进程终止需与目标进程同级权限 | | 网络 | 不需联网。仅在你主动使用 AI 会话页时会探测本地 opencode 服务 | ### 从 Release 安装（推荐） 1. 到 [Releases](https://github.com/X33834/workbench/releases/latest) 下载 `Workbench_<版本>_x64-setup.exe` 2. 若 SmartScreen 拦截：点「更多信息」→「仍要运行」 3. 安装后从开始菜单启动「工作台」 ### 从源码构建 环境要求：[Node.js](https://nodejs.org/) ≥ 20、 [Rust](https://www.rust-lang.org/tools/install) ≥ 1.77、WebView2。 ```bash npm install ``` ### IPC 契约类型生成 前端引用的跨 IPC 类型不在 `src/types.ts` 手写，而是由 Rust 结构体生成： ```bash cd src-tauri cargo test --test export_bindings # 重新生成 src/generated/*.ts ``` `src/types.ts` 只做 re-export，`src/generated/` 作为契约快照入库。 改完 Rust 结构体必须重跑上面这条命令，否则 CI 的漂移门禁会直接拦下。 ### 开发模式 ```bash npm run tauri dev # 桌面开发模式（含热更新） npm run dev # 仅前端，浏览器演示模式，无需 Rust ``` ### 生产构建 ```bash npm run tauri build ``` 构建产物位于 `src-tauri/target/release/bundle/`。 ## 技术栈 | 层 | 选型 | |----|------| | 运行时 | Tauri 2 (Rust + OS Webview) | | 前端框架 | React 19 + TypeScript（strict）+ Vite 8 | | 状态管理 | Zustand 5 (persist) | | 样式 | Tailwind CSS 4 + 双主题 CSS 变量 | | 图表 | ECharts 6（按需引入 + 暗/亮双主题注册） | | 虚拟滚动 | @tanstack/react-virtual 3（展开行高度可变，进入视口后实测回写行高） | | 状态订阅 | Zustand 5 `useShallow` 选择器 + 页面组件 `memo`（自身切片不变不重渲染） | | IPC 通道 | Tauri IPC + spawn_blocking | | IPC 契约 | ts-rs 12 由 Rust 结构体生成 `src/generated/*.ts`，CI 校验无漂移 | | 进程采集 | sysinfo | | 端口解析 | netstat 解析器（POSIX / Windows 双方言兼容） | | 多语言 | 英语默认，可切换简体中文 / 日本語 | | 质量门禁 | ESLint 10 + Prettier 3 + vitest 5 + clippy `-D warnings` | ## 项目结构 ``` workbench/ ├── src/ # 前端源码 │ ├── pages/ # 8 个功能页面（按需 lazy 加载） │ ├── lib/ # store / api / echarts / chartTheme / i18n / util │ ├── generated/ # ts-rs 生成的 IPC 契约类型（勿手改） │ ├── ui.tsx # 共享组件库 │ ├── types.ts # 类型 re-export 与前端专有类型 │ ├── App.tsx # 主应用入口 │ └── styles/global.css # 全局样式与主题变量 ├── src-tauri/ # Rust 后端 │ ├── capabilities/ # Tauri 权限集（最小面） │ ├── icons/ # 应用图标（由 scripts/make_icons.py 生成） │ ├── src/ │ │ ├── commands.rs # IPC 命令层 │ │ ├── procs.rs # 进程快照 + 终止 │ │ ├── ports.rs # netstat 解析 │ │ ├── devserver.rs # 开发框架识别 │ │ ├── ai.rs # AI 会话拉取 │ │ ├── pricing.rs # 模型价格匹配 │ │ ├── session_meter.rs # JSONL token 成本解析 │ │ ├── cost_store.rs # 成本数据持久化 │ │ ├── ipc_guard.rs # IPC 入参白名单 │ │ └── lib.rs # Tauri 启动入口 │ └── tests/ # IPC 契约导出测试 ├── docs/ # GitHub Pages 落地页 + 截图 ├── scripts/ # 图标生成与截图辅助脚本 └── .github/workflows/ # CI / Release / Pages ``` ## 开发与质量 ```bash npm run format:check # Prettier 格式检查 npm run lint # ESLint（零警告） npm run test # 前端单测（vitest，48 个用例） npm run coverage # 覆盖率 npm run build # tsc + vite build cd src-tauri cargo test # 后端单测 + IPC 契约导出 cargo clippy --all-targets -- -D warnings # 零警告门禁 ``` Rust 侧纯逻辑（netstat 解析、框架识别、价格匹配、token 提取、JSON 存储、IPC 守卫） 都有 `#[cfg(test)]` 单测；前端有 vitest 单测覆盖 util / store / 共享组件 / 错误边界。 CI 跑格式、静态检查、类型检查、构建、两侧单测、clippy 零警告， 并校验 `src/generated/` 与 Rust 结构体一致。 ## 常见问题
成本计量是怎么算的？准不准？ 解析本机 Claude Code / Codex 会话 JSONL 中的 usage 字段，按内置的 40+ 模型价格计算。 分三级可信度： - **measured** —— 文件里有真实 usage 上报，最准 - **estimated** —— 无 usage，按字符数启发式估算（可在设置里关掉） - **zero_pricing** —— 型号无法识别，标为不计费而**不**编造单价 Anthropic 的缓存 token 按官方语义单独计价（读 0.1×、写 1.25×）。
会不会把数据上传到云端？ 不会。项目、任务、成本账本、日志都写在本机 app data 目录。应用只在本地做两件事： 读 `netstat` 看端口、读本机 session 文件算成本。唯一的可选外连是探测本机 opencode 服务（默认 4096 端口），失败只显示「未检测到」，不影响其它功能。
杀进程会误杀系统关键进程吗？ 不会。PID 0/4 与 csrss、lsass、services 等关键系统进程被后端直接拒绝， 前端另有二次确认；终止前会刷新并校验进程身份，避免 PID 复用导致误杀。
关闭窗口后程序去哪了？怎么真正退出？ 隐藏到系统托盘（有意设计，便于常驻监控）。右键托盘图标选「退出工作台」才结束进程； 快捷键 Ctrl+Shift+W 可随时显示 / 隐藏窗口。
Windows 提示「未知发布者」怎么办？ 安装包未做代码签名（证书需付费），SmartScreen 因此会拦截。 点「更多信息 → 仍要运行」即可，也可直接下载免安装 exe。
## Roadmap 已完成与计划中的方向。欢迎在 Issues 里投票或提新想法。 - [x] 进程 / 端口 / 开发服务器实时监控 - [x] AI 会话成本计量与预算告警 - [x] 项目与任务管理 - [x] 深浅双主题、日志查看器 - [x] 多语言界面（English / 简体中文 / 日本語） - [ ] 跨平台支持（macOS / Linux 采集与打包） - [ ] 安装包代码签名 - [ ] `pricing_overrides.json` 的 UI 编辑入口 - [ ] 成本账本分片存储（支撑十万级记录） - [ ] 页面级端到端测试 ## 已知限制 - 仅 Windows 验证：端口采集写死 `cmd /c netstat -ano`，`ports.rs` 的 POSIX 分支当前不会被执行 - 前端渲染行为仍以人工验证为主：vitest 覆盖 util / store / 共享组件 / 错误边界， 8 个页面的交互路径尚无端到端测试 - 成本账本落在单个 `cost_data.json`（写操作已串行化），记录数很大时全量读写会开始吃力 - `pricing_overrides.json` 只有读取路径，没有写入入口 - 安装包未做代码签名，首次运行可能触发 SmartScreen 提示 - 托盘菜单文案当前仅中文（前端界面已完整三语） ## 数据存储 | 文件 | 用途 | 位置 | |------|------|------| | `data.json` | 项目与任务 | `app data dir` | | `cost_data.json` | 成本记录 + 定价设置 | `app data dir` | | `pricing_overrides.json` | 用户自定义模型价格覆盖（只读，需手工放置） | `app data dir` | | `workbench.log` | 运行日志 | `app data dir` | | `*.corrupt-<时间戳>` | 数据文件解析失败时的原样备份（不会被下次保存覆盖） | `app data dir` | Windows 下 `app data dir` 为 `%APPDATA%\com.workbench.desktop`。 ## 参与贡献 - 贡献流程与代码约定见 [CONTRIBUTING.md](CONTRIBUTING.md) - 安全漏洞请走私密通道，见 [SECURITY.md](SECURITY.md) - 社区行为规范见 [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) - 版本变更记录见 [CHANGELOG.md](CHANGELOG.md) ## License [MIT](LICENSE) © 2026 x1882