前言¶
用 DeepSeek Harness(DSH)跑会话时,待办、随手笔记、常用链接往往散落在系统备忘录或浏览器里;想看当前会话烧了哪些 token、本机 CPU 和磁盘占用,又要切到别的工具。DSH 生态里侧边栏可以挂第三方页面,但若每个能力各占一个 tab,右栏很快挤满。dsh-personal-studio 把待办、笔记、书签、会话统计、服务器状态收进同一个侧边栏 tab,数据落在本机文件,不依赖联网同步。
这是什么¶
dsh-personal-studio 由维护者 siungolai 发布,分类为客户端插件,许可证 MIT。它是基于 dsh-better-sidebar 的消费型侧边栏插件:向 better-sidebar 注册一个页面,再由 better-sidebar 挂到 DSH 原生右侧栏。五个面板在同一 tab 内切换,不占满整条右栏。
要求 DSH 0.2.0-rc.2 或更新;README 标明插件 badge 为 DSH ≥ 0.2.0-rc.2。v0.1.0 已在 DSH 0.2.1-rc.2 与 better-sidebar 0.28.0 的 web profile 上完成端到端联调。
核心功能¶
| 面板 | 能力 | 数据来源 |
|---|---|---|
| 待办 | 标题、勾选完成、优先级、截止日、关联会话;可按手动 / 截止日 / 优先级排序 | 本机 data.json |
| 笔记 | 目录树 + 正文,文件夹可嵌套 | 本机 data.json |
| 书签 | 扁平列表,点击用浏览器打开 | 本机 data.json |
| 会话 | 各会话 token 消耗与运行时长(只读) | DSH 会话统计 |
| 状态 | CPU / 内存 / 磁盘占用(只读) | 运行 DSH 的本机 |
待办、笔记、书签写入 ~/.dsh/personal-studio/data.json(Windows 为 C:\Users\<你>\.dsh\personal-studio\data.json)。写入采用临时文件再改名的原子写;单文件上限 8 MiB,超限拒绝写入并报错。v1 不做跨设备同步。
三个偏好项(刷新间隔、待办默认排序、是否显示已完成待办)保存在 better-sidebar 的设置里,默认值分别为 5 秒、手动排序、不显示已完成。
装好后可在两处进入:DSH 原生右侧栏的「工作台」tab(标题可带未完成待办数,如 工作台 3),以及 better-sidebar 底部工作台的「工作台」卡片。面板切换器为:待办 / 笔记 / 书签 / 会话 / 状态。
安装与启用¶
下面按 README 快速入门顺序说明。先确认环境:DSH 0.2.0-rc.2+;dsh-better-sidebar 0.28.0(在 DSH 0.2.1-rc.2 及更新版本上请固定此版本;不写版本号可能装到与宿主不匹配的包,启动时出现 better-sidebar: pending (waiting for service: webRuntime));源码安装时需 Node.js 20+。
1、安装 better-sidebar(若尚未安装)¶
dsh plugin --profile web add dsh-better-sidebar@0.28.0
桌面版将 --profile web 改为 --profile desktop,且须使用 DeepSeek Harness 自带的 dsh 命令。
2、安装 dsh-personal-studio¶
当前 README 写明:npm 包尚未发布,源码安装为现阶段可用方式。在仓库根目录构建后执行 dsh plugin add:
git clone https://github.com/siungolai/dsh-personal-studio.git
cd dsh-personal-studio
pnpm install
pnpm run build
dsh plugin --profile web add .
add . 以 link 方式挂入 profile 并自动完成挂载。也可使用绝对路径:dsh plugin --profile web add /path/to/dsh-personal-studio。
包发布后 README 给出的 npm 方式为:
dsh plugin --profile web add dsh-personal-studio
3、重启宿主¶
| 场景 | 动作 |
|---|---|
dsh web |
停掉再起 |
| 桌面版 | 完全退出 DeepSeek Harness 再打开 |
| 浏览器 | 硬刷新 Ctrl/Cmd + Shift + R |
4、卸载¶
dsh plugin --profile web remove dsh-personal-studio
数据文件仍留在 ~/.dsh/personal-studio/data.json,需自行删除。
典型用法¶
安装并重启后,在「工作台」内可依次验证:
- 待办:底部输入框输入标题回车;勾选左侧框,观察 tab 标题与「待办」上的未完成计数是否变化。
- 笔记:新建文件夹并写入正文(v1 为纯文本编辑,不做 Markdown 渲染)。
- 书签:粘贴
http或https链接回车,点击打开。 - 会话:查看各会话 token 与时长;无数据的会话不显示行。
- 状态:查看本机 CPU / 内存 / 磁盘,默认每 5 秒刷新(可在 better-sidebar 设置中改为 1–300 秒)。
备份或迁移:复制 data.json 到同路径即可。
适用场景与注意¶
适合希望在 DSH 界面内完成轻量任务管理、随手记与书签收藏,并顺带查看会话 token 与本机资源的用户。插件 host 半持有数据文件并采集系统指标,以当前 DSH 进程权限运行;安装前请阅读 GitHub 仓库 源码与 MIT 许可证,自行评估是否满足环境策略。
需注意的 v1 限制(README 已列出):不做跨设备同步;笔记不按 Markdown 渲染;会话列表无时间戳故不按时间排序;未完成待办数在 DSH 原生右栏无法使用 better-sidebar 的 badge 位,故显示在 tab 标题与面板切换器上。
若装完不见「工作台」,按 README 排查:依赖版本是否 pending、better-sidebar 是否为 0.28.0、是否重启宿主、cordis.patch.yml 是否重复挂载 dsh-personal-studio。
结尾¶
dsh-personal-studio 把个人工作台收进 DSH 右侧栏单个 tab,本机存储、不联网同步,依赖 better-sidebar 与 DSH 0.2.0-rc.2 及以上宿主。目录页见 SkillHub 插件页,源码与完整说明见 GitHub:siungolai/dsh-personal-studio。DSH 社区插件目录为独立站点,与 DeepSeek / 幻方无官方从属关系。