把书架渲染成可以漂进去的 3D 星空:星系按题材分组,星的颜色表示未读 / 在读 / 已读完,靠近时才显示出封面。支持导入 EPUB、PDF、TXT、MOBI、AZW3、DOCX、Markdown,全屏阅读器提供六种显示模式与八种中文字体,摘录与笔记保存在本地 SQLite。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:zhang-1239/stellar-shelf
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
一个私人的书架,长成了一片星空。
打开就是一个可以漂进去的宇宙——星系是分类,星的颜色是阅读状态,靠近一颗星才看清它是一本书,翻开就能读。数据全部在本地,不联网、不上传、不分享。

它是什么
- 星系 = 题材:古典 / 小说 / 神话 / 文学 / 社科 / 科学 / 艺术 / 生活。每本书按标签自动归入一个星系。
- 颜色 = 状态:蓝(未读)、黄(在读)、白(已读完)、青(今日推荐,会呼吸)。
- 远近 = 层次:远看是一颗星,靠近二十几「光年」内,封面才会浮出来。
- 能读:翻开进入全屏阅读器,日常 / 护眼 / 米黄 / 夜间 / 星空 / 自定义六种显示模式,八种中文字体(含开源的霞鹜文楷)。
- 能记:划词摘录、写想法,摘录会回到正文里点亮。
- 能收:上传 EPUB / PDF / TXT / MOBI / AZW3 / DOCX / Markdown;豆瓣推荐源可自行开启。

安装
需要 DeepSeek Harness 0.1.7 及以上。
dsh plugin --profile web add @zhangxij/stellar-shelf
或者在 Harness 的插件管理里搜 stellar-shelf。
装完不用配置:空书库会自动装入三本公版书(《洛神赋》《诗经》《山海经》),并把它们设成"已读完 / 在读 / 未读"三种状态,附两条示例笔记。所以第一眼就能看到两个星系、三种颜色的星、以及可以直接点开读的目录。

数据在哪
- 安装版:
%LOCALAPPDATA%\stellar-shelf(macOS/Linux 为~/.stellar-shelf) - 可用环境变量接管:
SHELF_DATA_DIR、SHELF_PORT
数据库是 SQLite,正文是普通 HTML 文件,随时可以整个目录拷走。
隐私
- 书架数据全部本地,没有任何上传。
- 豆瓣推荐源默认关闭;开启后才会去抓豆瓣读书的公开页面。关闭时「今日星群」只从你自己没读完的书里挑。
权限说明
插件会启动一个本地 HTTP 服务(127.0.0.1,端口从 7317 起自动找空闲),并读写自己的数据目录。除此之外不访问网络、不执行外部命令。
许可证
MIT。随包附带的霞鹜文楷字体为 SIL OFL 1.1(精简包不含字体)。
书源为 Project Gutenberg 公版书,书目与封面信息来自豆瓣读书,仅作文本与元数据的展示,请支持正版。
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10458
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10458
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7797
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7271
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 5191
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
omdsh-dev/dsh-genui★ 1007
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。