精神空间 Jokii-Joy/novel-writer

精神空间 · Mindspace

DeepSeek Harness 里的一体化小说写作插件：章节树、沉浸写作、AI 校对与一键排版、导入导出（txt / md / docx / epub / pdf）、投稿向导与期刊库、收件箱、加密本地存档，外加一个 Android 手机端，在同一个 Wi-Fi 下与桌面双向同步。

书架与编辑器

功能

- 写作：可折叠章节树、沉浸模式、打字机模式、粗光标、九套阅读主题、白天/黑夜。
- AI：AI 校对逐条给出修改建议；一键排版；模型选择与自动回退。
- 稿件：导入 txt / md / docx / epub 自动分章；导出 txt / md / docx / epub / pdf。
- 投稿：三步投稿向导，内置 79 家文学期刊库（可增删改），按体裁/字数/风格推荐。
- 邮件：SMTP 发信、IMAP 收件箱，直接在插件里读投稿回信。
- 存档：本地 IndexedDB + 可选加密（PBKDF2 + AES-256-GCM），版本历史与回收站。
- 手机：Android App 与桌面局域网同步（配对码 / 扫码），断网改动合并时不丢书。

安装

插件包目录即仓库根。在 DSH 里执行：

plugin_manager action=install_bundle target=<本仓库绝对路径>

安装后左侧栏出现书本图标，点击进入「精神空间」主面板。校验 Host 是否就绪（dsh web 的端口每次启动都会变）：

curl http://127.0.0.1:<web端口>/novel-writer/api/ping
{"ok":true,"data":{"name":"novel-writer","version":"1.2.0",...}}

改 Host 代码后要重载插件（Node 模块已缓存）：

plugin_manager action=set_plugin target=include:novel-writer enabled=false
plugin_manager action=set_plugin target=include:novel-writer enabled=true

只改客户端则重建产物，刷新页面即可：

node scripts/build-client.mjs # client/src/.js → client/client.js（含加载闸门）

手机端

APK 在 dist/精神空间.apk（约 0.52 MB，Android 7.0+，无需 Gradle 构建）。
源码在 app/，用 node tools/build-apk.mjs 重新打包。

配对：桌面「设置 → 手机同步」生成地址与配对码 → 手机「配对」里手填（扫码为备选）。
同步走局域网 HTTP，端口 41288，UDP 41287 发现；正文在手机上以明文存放，桌面侧的同步缓存仍用本机密钥加密。

开发

node scripts/verify-host.mjs # 离线宿主测试（不需要运行中的 DSH）
node scripts/verify-docs.mjs # 导入导出与 docx/epub 排版断言
node tools/build-apk.mjs # 重打 APK（工具链在 .tools/android/）

- 运行时零第三方依赖：Host 只用 Node 内置模块，Client 只用宿主提供的 react 与主题 token。
- 入口：index.js（Host）+ client/client.js（浏览器，由 client/src/.js 按文件名拼接）。
- 接口：/novel-writer/api/*，统一 {ok, data|error}，方法表见 docs/CONTRACT.md。
- 目录说明与逐轮改动记录见 docs/CHANGELOG.md。

提交与发布

每次 git commit 后自动上传到 GitHub（.githooks/post-commit → tools/auto-push.mjs），失败会重试并记在 .tools/push.log。配置见 docs/CHANGELOG.md 的「上传到 GitHub」一节。

许可

Copyright (C) 2025 Jokii-Joy

本项目以 GNU General Public License v3.0 or later 发布，全文见 LICENSE。
你可以自由使用、修改和分发；分发修改后的版本时须同样以 GPL-3.0-or-later 开放源代码，并保留版权声明。本程序不提供任何担保。