DeepSeek Harness 插件

zhang-1239/stellar-shelf

Star 数 ★ 0 分类 UI 增强 收录于 2026-11-16

把书架渲染成可以漂进去的 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 公版书,书目与封面信息来自豆瓣读书,仅作文本与元数据的展示,请支持正版。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。