OpenWrite如何守护你的小说数据:本地存储、Workspace隔离与模型密钥安全完整指南
OpenWrite如何守护你的小说数据:本地存储、Workspace隔离与模型密钥安全完整指南
正在使用 OpenWrite(DeepSeek Harness 小说创作插件)写长篇的你,是否担心过:写了几十万字的小说存在哪里?同时开两部作品会不会互相覆盖?填进系统的模型 API Key 会不会外泄?OpenWrite 在设计上就针对这三点做了防护——数据本地存储、Workspace 隔离、凭据安全。本文用通俗的语言带你完整看懂它的数据安全机制,并给出一份可直接照做的安全清单。
一、本地存储:你的小说只留在自己的电脑里 📁
OpenWrite 的核心理念非常直白:人物、设定、大纲、正文和评审全部保存在你自己选择的本地作品目录,而不是上传到任何云端服务。插件不依赖"把稿子发到网上"才能工作,模型只在需要你发起创作任务时才被调用。
各类数据的具体去向如下:
| 数据 | 存放位置 | 说明 |
|---|---|---|
| 小说正文、大纲、人物、设定、评审记录 | 你选定的作品目录 | 初始化时还会为该目录创建独立的 Git 仓库,方便版本管理 |
| 下载缓存、Python 运行环境、管理记录、隔离配置与凭据 | $DSH_HOME/openwrite/ |
未指定 DSH_HOME 时使用 dsh 默认目录 |
| 版本化预设(技能包) | $DSH_HOME/.agent-presets/ |
官方预设按版本号命名,不会覆盖你的自定义预设 |
几个对作者很重要的细节:
- 卸载不删数据:正常卸载只会停掉插件自己启动的进程,作品、配置、凭据、历史会话默认全部保留(详见 docs/INSTALL.md 的"卸载"一节)。
- 清理缓存有边界:想释放空间只能删
$DSH_HOME/openwrite/cache/,不能删整个目录——里面还有配置和管理记录。 - 文件读写范围明确:插件只读写已绑定的作品目录与上述托管目录,权限披露见 docs/DSH_STORE.md。
💡 一句话总结:小说是"你的文件",OpenWrite 只是在你电脑的指定目录里工作,随时可以打包带走。
二、Workspace 隔离:多作品互不"串门" 🏠
同时写两部小说?OpenWrite 用 Workspace 身份模型 从结构上杜绝了"写 A 改到 B"这类事故。
隔离是怎么做到的?
- 一个 Workspace = 一部作品:每个已初始化的 dsh Workspace 对应一个 OpenWrite 项目根目录(含
novel_config.yaml),切换 Workspace 即切换全部能力。 - 每个根目录独立应用实例:任务队列、写锁、评审、搜索、DAG、模型测试等全部按 root 隔离,各自维护独立的 revision 与缓存;模型档案等用户级设置按设计共享,互不污染。
- 前端缓存也隔离:浏览器 localStorage 的键全部带 workspace 后缀(形如
dsh-novel.<key>.<workspaceId>),切换作品时旧数据清空重建,迟到的旧响应一律丢弃。
身份校验是"fail closed"(失败即拒绝)风格:请求必须携带可验证的 Workspace 身份,路径会做 realpath 规范化并拒绝相对路径、.. 穿越、嵌套根目录;上下文缺失时直接报错而不是回退到某个"默认项目"。常见错误码含义如下(完整契约见 docs/WORKSPACE_CONTEXT_CONTRACT.md):
| 错误码 | 含义 |
|---|---|
WORKSPACE_CONTEXT_MISSING |
缺少 Workspace 身份,请求被拒绝 |
WORKSPACE_ROOT_INVALID |
路径非法(相对路径、穿越、嵌套等) |
WORKSPACE_NOT_INITIALIZED |
该目录还没初始化为作品 |
WORKSPACE_CONTEXT_MISMATCH |
操作目标与当前 Workspace 不一致 |
这套机制的实际意义是:浏览器面板只能提交 Workspace ID,无法注入任意文件系统路径——id 到路径的映射完全在宿主侧完成,从源头堵死了越权访问目录的可能。
三、模型密钥安全:API Key 的正确打开方式 🔐
写章、审稿要调用模型,因此必须配置 API Key。OpenWrite 对密钥的保护分四层:
① 凭据由界面统一管理,存放位置隔离
小说生成、评审与测试模型在「任务 → 模型」中添加服务商并填写 API Key,托管模式的模型档案、路由和凭据统一读取 $DSH_HOME/openwrite/state/config/,与作品目录完全分离。官方文档明确提醒:不要把密钥粘贴到对话、作品正文或 Git 仓库。
② 子进程环境"允许列表":无关 API Key 不继承
插件启动的 Python 运行环境不是"继承整个系统环境",而是经过白名单过滤:只有 packages/openwrite-bridge/src/managed-runtime.ts 中声明的 ALLOWED_ENV(PATH、代理、语言、包索引镜像等)可以传入,且凭据类环境变量名会被 buildChildEnv 主动剔除。换句话说,即使你电脑里配着别的服务商的 Key,OpenWrite 的运行环境也不会把它们带进去。
③ 诊断与日志自动脱敏
报错信息不是原样透传的。sanitizeDiagnostic 会把 URL 中的账号密码、token/key/secret 参数、以及疑似 32 位以上的十六进制串统一替换为 [redacted],避免凭据出现在日志和界面报错里。
④ 后端只监听本机回环地址
OpenWrite 的领域后端只绑定回环地址(localhost),端口自动分配,实例认证凭据只在宿主与后端之间传递,外部设备无法直接访问你的作品数据接口。诊断接口 /api/workspace/context 也明确"不返回凭据、正文"。
✅ 对照检查:配置模型时,如果 Key 出现在聊天框、正文或代码仓库里,请立即去服务商后台作废并重新生成。
四、作者安全清单:5 条照做即可 ✅
- 作品目录选在自己的磁盘上,并保留插件自动创建的 Git checkpoint(Git 可选,未安装时功能照常,仅版本保护不可用)。
- 一部小说一个 Workspace:新建作品走"目录选择 → workspace.create → 初始化"流程,不要把两部作品塞进同一个根目录。
- API Key 只在「任务 → 模型」界面填写,绝不粘贴进对话、正文或提交进 Git。
- 升级前先备份:迁移工具会把备份写入
$DSH_HOME/openwrite/migration-backups/,且不触碰你的作品、凭据和其他插件。 - 只清理指定缓存:删
$DSH_HOME/openwrite/cache/是安全的,删整个$DSH_HOME/openwrite/会丢失配置与凭据。
五、延伸阅读 📚
| 资料 | 内容 |
|---|---|
| docs/WORKFLOWS.md | Workspace 模型与日常创作流程 |
| docs/WORKSPACE_CONTEXT_CONTRACT.md | Workspace 身份、路由与错误码完整契约 |
| docs/INSTALL.md | 模型配置、迁移、升级与卸载的数据保留规则 |
| docs/DSH_STORE.md | 插件权限与文件、网络、凭据能力披露 |
| packages/openwrite-bridge/src/managed-runtime.ts | 运行环境管理:环境白名单与诊断脱敏实现 |
总结:OpenWrite 把"小说是你的资产"作为设计前提——数据本地化、作品间强隔离、密钥分层保护。理解了本文的三层机制,你就能放心地把长篇连载交给它,同时牢牢掌握自己数据的主动权。