Releases: URaux/shufang
Release list
群星阅览室 v0.6.1 — Obsidian 回归，书库收拾干净
这版主要是把 Obsidian 请回来，顺便把书库收拾干净了
Obsidian 默认装了
译文是机器翻的，一定有要改的地方。Obsidian 读写的就是你书库里那批文件，在它里面改完，这边立刻看得到——所以它现在是默认安装的一环，不是可选配件。
装的时候会问一句（默认装）；网不好按 N 跳过也行，以后重跑安装器随时能补。装不上不会影响安装，程序自带的网页界面照样能看能改。
装好之后，正文上方会多一个「在 Obsidian 里打开」，点了直接跳到那一章——书库会自动登记好，不用你自己去点"打开文件夹作为库"。
书库不再乱糟糟
以前书库文件夹里摊着一堆你看不懂也不该改的文件。现在除了 Library（你的书）之外，全都收进了 .群星阅览室 这个隐藏文件夹：偏好、助手说明、每本书的记忆、聊天记录都在里面。
升级会自动搬，不会丢东西。想看的话打开"显示隐藏文件"就能看到，改也随你改。
修的问题
上一版聊天是坏的。 包里带的 Node 太旧，翻译助手根本起不来——但传书、整理都是好的，所以很难看出问题在哪。这版换了新版 Node，装的时候还会自己检查一遍。
开新对话之后，旧的整理结果不再赖着不走。
装过 Obsidian 的人不会再被要求重装一遍。 之前只认 C 盘的默认位置，装到别的盘就当没装过，白下 300 多 MB。
Mac 装 Obsidian 之前根本装不上（下载地址找错了）。
下载哪个
- Windows：
shufang-v0.6.1-win-full.zip— 解压后双击「安装群星阅览室.vbs」 - Mac：
shufang-v0.6.1-mac-full.zip— 解压后双击「安装群星阅览室.command」，第一次被系统拦就右键选"打开"
Node、Pandoc、程序都在包里。装的时候会问程序和书库放哪（C 盘紧张可以换盘），然后粘一个 DeepSeek API key。
已经装过的：打开程序会自动更新。你填的 key、书库位置、手机上存的链接都会保留。
群星阅览室 v0.6.0 — 译文能自己改了，对话能开好几段
这版补上了"自己动手"和"对话该有的样子"
译文可以自己改了
之前机器翻出来什么就是什么，想改只能去装 Obsidian 或者翻文件夹。现在正文上方有个「✏️ 改一改」，点了就变成编辑框，改完保存。
保存前会看一眼文件有没有被助手动过——如果它刚好把这一章重写了，会提示你先刷新看看新版本，而不是闷头把它的活儿覆盖掉。
装了 Obsidian 的话还会多一个「在 Obsidian 里打开」，双链、大纲、图谱、全文搜索都能用上。
对话能开好几段了
跟平常用的网页版聊天一样：左边一列会话，能新建、改名、删，最近用的排在上面。标题拿你说的第一句话自动生成。
删掉的会话会先挪进书库的「已删除」文件夹，不是立刻抹掉——误点了还能捞回来。
读书和对话真的分开了
之前打开 A 书，右边显示的还是 B 书的对话；读书模式和对话模式看到的永远是同一串。现在：
- 读书模式右边：只谈你正开着的这本书，记录跟着书走
- 对话模式：跟具体哪本书无关的通用对话
会记住你说过的话
说一次"译文要大白话，不要文言腔"，以后每本书都照办。说一次"这本书里 Dinah 译成黛娜"，只对这本书生效。
分三层存成三个 markdown（书库根的「我的偏好」、每本书的「记忆」和「章节记忆」），都在你的书库里，能直接看、直接改、直接删——不是藏在哪儿的黑盒。
窗口像个正经软件了
启动后开的是无地址栏、无标签页的独立窗口，任务栏里是自己的图标。
修的问题
上一版聊天是坏的。 包里带的 Node 版本太旧，翻译助手根本起不来——但传书、整理还是好的，所以很难看出问题出在哪。这版换成了新版 Node，并且装的时候会自己检查一遍。
扫描版 PDF 的正文不再竖着排。 之前一句话会被拆成一行一个词。
扫描版的章节名回来了。 之前叫「第 1 部分」「第 2 部分」，现在会根据内容起名。
下载哪个
- Windows：
shufang-v0.6.0-win-full.zip— 解压后双击「安装群星阅览室.vbs」 - Mac：
shufang-v0.6.0-mac-full.zip— 解压后双击「安装群星阅览室.command」，第一次被系统拦就右键选"打开"
Node、Pandoc、程序都在包里，不用另外下载。装的时候会问程序和书库放哪（C 盘紧张可以换盘），然后粘一个 DeepSeek API key 就好。
已经装过的：打开程序会自动更新，不用重新下载；你原来填的 key、书库位置、手机上存的链接都会保留。
群星阅览室 v0.5.2 — 入库快了 9 倍，修好残缺的摘要和译名表
这版主要是快了，以及修好了几个「看着有、其实是残的」的东西
整本书入库从 4 分钟降到半分钟。
原因是模型默认会先"想"很久，而思考消耗的额度和写正文是同一份预算。同一本《爱丽丝梦游仙境》实测：
| 之前 | 现在 | |
|---|---|---|
| 译名表 | 46 秒，一个字都没写出来 | 5 秒，正常生成 |
| 全书梗概 | 62 秒，写到一半没了 | 12 秒，完整 |
| 每章摘要 | 每一章都从句子中间断掉 | 完整，句号收尾 |
| 整本端到端 | 247 秒 | 28 秒 |
也就是说之前译名表一直在静默失败，梗概和每章摘要一直是残的——文件看着都在，内容不完整。现在关掉了不必要的思考过程。
上传后 15 秒就能点进去读，摘要在后台继续补，不用干等。
其他修复
重装不再清空你的设置。 之前升级一次：API key 要重填、访问令牌换新（手机上存的链接全部失效）、自定义端口丢失、书库还会被挪回"文档"文件夹。现在这些全部沿用。
章节名补全。 之前书里显示的是"CHAPTER I. / CHAPTER II."，点进去之前完全不知道讲什么；现在是"CHAPTER I. Down the Rabbit-Hole"。
PDF 支持补齐。 之前只有联网安装版装了 PDF 组件，全量包和 Mac 版根本没有这一步。现在四个安装器都装，且默认就装。
弹窗中文不再乱码。 双击安装文件时如果没解压，本该提示"请先解压"，之前显示的是一串乱码。
下载哪个
- Windows：
shufang-v0.5.2-win-full.zip— 解压后双击「安装群星阅览室.vbs」。Node、Pandoc、程序全在包里，不用下载。 - Mac：
shufang-v0.5.2-mac-full.zip— 解压后双击「安装群星阅览室.command」。第一次运行如果被系统拦，右键选"打开"。
装的时候会问两个位置（程序装哪、书库放哪），C 盘紧张的话可以都换到别的盘。然后粘一个 DeepSeek API key（platform.deepseek.com 注册后创建），就完事了。
已经装过的：打开程序会自动更新，不用重新下载。
群星阅览室 v0.4.0 — 大脑换 dsh，自动更新修好
大脑换成 dsh（DeepSeek Harness，DeepSeek 官方 agent）——不再绕 Anthropic 兼容层，DeepSeek key 直连官方接口，对用户更省事。自动更新也在这个版本里修到真正能用。
怎么装（先看这里）
先去 platform.deepseek.com 注册并充几块钱，创建一个 API key（sk- 开头，装的时候要粘贴）。
| 你的电脑 | 下载哪个 | 怎么用 |
|---|---|---|
| Windows · 网络不稳/没梯子 | shufang-v0.4.0-windows-full.zip（154MB，推荐） |
解压 → 双击「一键安装.bat」→ 选装哪个盘 → 粘 key。全程零下载 |
| Windows · 网络没问题 | install-windows.bat |
双击。系统若警告「不常下载的文件」，选保留/仍要运行 |
| Mac | install-mac.zip |
解压得到「安装群星阅览室.command」→ 右键点它选「打开」 |
| 其它情况 | shufang-v0.4.0-offline.zip |
解压后进 shufang\installer 双击 install.bat（组件仍需联网下载） |
所有安装器都支持自选安装位置（C 盘满了装 D 盘）。装完只有翻译时连 DeepSeek（国内直连，不用梯子）。
v0.4.0 变了什么
- 大脑换 dsh：新安装默认用 DeepSeek 官方 agent；已装 v0.3.0 的老用户自动更新后仍走原来的方式，不受影响，想切新的重跑一次安装器即可
- 自动更新修好了：之前有三个叠着的 bug 让它其实从来没成功过（下载器报错处理、中文文件名解压、版本检查全坏）；这版实测「发现新版本 → 全量替换 → 失败回滚 → 二次运行确认最新」全链路通过
- 长任务（翻一整章）时界面会显示「还在干活」的心跳提示，不再像卡死
- 翻译效果做过对照测试：整章翻译、译名表一致性、书库读写、多轮对话衔接全部等效
多人校对协作（v0.3.0 引入）
发起人「共享这本书」拿邀请串微信发朋友；朋友「加入朋友共享的书」粘贴即可，不用注册任何账号。选中译文提建议、拍板采纳自动改文、断网照常用。共享仓库强制私密（确认不了私密就不放行）。
🤖 Generated with Claude Code
群星阅览室 v0.3.0 — 多人校对协作
书房改名 群星阅览室，并带来这个版本的主角：多人校对协作。
怎么装（先看这里）
先去 platform.deepseek.com 注册并充几块钱，创建一个 API key（sk- 开头，装的时候要粘贴）。
| 你的电脑 | 下载下面哪个 | 怎么用 |
|---|---|---|
| Windows · 网络不稳/没梯子 | shufang-v0.3.0-windows-full.zip（169MB，推荐） |
解压 → 双击「一键安装.bat」→ 选装哪个盘 → 粘 key。全程零下载，Node/Pandoc/Claude Code 都在包里 |
| Windows · 网络没问题 | install-windows.bat |
双击。系统若警告「不常下载的文件」，选保留/仍要运行 |
| Mac | install-mac.zip |
解压得到「安装群星阅览室.command」→ 右键点它选「打开」（直接双击第一次会被系统拦） |
| 其它情况 | shufang-v0.3.0-offline.zip |
解压后进 shufang\installer 双击 install.bat（安装器在包里，组件仍需联网下载） |
全量包和两个在线安装器都支持自选安装位置（C 盘满了装 D 盘）。装完只有 DeepSeek 翻译时需要联网（国内直连，不用梯子）。
新功能：几个朋友合啃一本书
- 发起人点「🤝 共享这本书」，按向导走完（需要一个 GitHub 账号，只有发起人需要），得到一个邀请串微信发给朋友
- 朋友点「📥 加入朋友共享的书」，粘贴邀请串，书就出现在书架上——不用注册任何账号
- 读译文时选中一句话就能「✏️ 提个建议」：改成什么 + 为什么；发起人点「采纳」自动改译文
- 也可以直接改文本：改动自动提交、自动合并、自动同步；两人撞到同一句时后到的版本自动备份，不会丢
- 断网照常用，联网自动补传；顺带每本书都有了本地版本历史，改坏了能找回
技术细节见 docs/2026-08-15-collab-research.md（isomorphic-git + GitHub 私有仓 + 建议文件模式，全程不需要用户安装 git）。
安装器加固（Windows + Mac）
- Windows 零依赖版：不再需要 winget、不要管理员权限，Node/Pandoc 都装进用户目录；修了配置文件带 BOM 导致 API key「神秘丢失」的 bug；自动更新以前其实没生效，这版真的会更新了（带失败回滚）
- Mac：Obsidian 改成可选（装不上不再卡死整个安装）；API key 输入不再回显（防止落进日志）；更新失败自动回滚
升级方式
已经装过的什么都不用做：双击桌面启动器自动升到这版。
🤖 Generated with Claude Code
书房 v0.2.0 — 本地啃书翻译器
在自己电脑上啃外文书：AI 整理梗概摘要 → 想看哪章翻哪章 → Obsidian/网页/手机阅读。
安装（推荐，什么都不用下载）
Windows：按 Win 键搜 powershell 打开，粘贴回车：
$f="$env:TEMP\shufang-install.ps1";iwr https://raw.githubusercontent.com/URaux/shufang/master/installer/install.ps1 -OutFile $f -UseBasicParsing;powershell -NoProfile -ExecutionPolicy Bypass -File $f
Mac：Cmd+空格搜「终端」打开，粘贴回车（不需要 Homebrew，不要管理员密码）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/URaux/shufang/master/installer/install-mac.sh)"
装完桌面出现「启动书房」，双击即用。以后每次启动自动更新，不用重装。
下面的 zip 是干嘛的
shufang-v0.2.0-offline.zip 是离线安装包（Windows）：网络不便时下载解压，双击 installer 里的 install.bat。
需要一个 DeepSeek API key（几块钱能翻好几本书）。详细说明看仓库 README。