A local-first bookshelf rendered as a 3D starfield: galaxies group books by genre, star colour shows unread, reading and finished, and cover art appears as you approach. Imports EPUB, PDF, TXT, MOBI, AZW3, DOCX and Markdown, opens them in a full-screen reader with six display modes and eight Chinese fonts, and stores highlights and notes in local SQLite.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:zhang-1239/stellar-shelf
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
一个私人的书架,长成了一片星空。
打开就是一个可以漂进去的宇宙——星系是分类,星的颜色是阅读状态,靠近一颗星才看清它是一本书,翻开就能读。数据全部在本地,不联网、不上传、不分享。

它是什么
- 星系 = 题材:古典 / 小说 / 神话 / 文学 / 社科 / 科学 / 艺术 / 生活。每本书按标签自动归入一个星系。
- 颜色 = 状态:蓝(未读)、黄(在读)、白(已读完)、青(今日推荐,会呼吸)。
- 远近 = 层次:远看是一颗星,靠近二十几「光年」内,封面才会浮出来。
- 能读:翻开进入全屏阅读器,日常 / 护眼 / 米黄 / 夜间 / 星空 / 自定义六种显示模式,八种中文字体(含开源的霞鹜文楷)。
- 能记:划词摘录、写想法,摘录会回到正文里点亮。
- 能收:上传 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 公版书,书目与封面信息来自豆瓣读书,仅作文本与元数据的展示,请支持正版。
Links
More in this category
zhu1090093659/dsh-web#packages/dsh-task-board★ 10458
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
zhu1090093659/dsh-web#packages/dsh-web-all★ 10458
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
ccch1mneyyy/dsh-TUI★ 7797
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7271
A fixed-corner whale widget for the DSH web GUI — balance, today's usage and per-turn cost with peak/off-peak pricing, editable balance-alert and daily-budget bubbles, a module-based custom bubble queue with A/B weighted choices and random lines or images, 30+ vendor templates (OpenAI, OpenRouter, Kimi, SiliconFlow, Ark, Zhipu, MiniMax and more) with per-model balance and subscription quota, plus task-end sound, imported audio, custom roles and a resource manager. Local-only, no telemetry.
omdsh-dev/DSH-better-sidebar★ 5191
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
omdsh-dev/dsh-genui★ 1007
Interactive UI components rendered inline in replies: layout, charts, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.