dsh-yanfield
Manifest valid★ 3A long-form fiction writing desk inside DeepSeek Harness: a shelf of books, a three-column editor (chapter tree, prose, AI assistant), outlines, character/world/foreshadowing notes, story archives, an
砚田 Yanfield
DeepSeek Harness 里的长篇写作台。
正文、大纲、设定与 AI 助手,在同一张书桌上。
书稿留在本地,模型用你已配好的 DeepSeek,AI 的改动由你逐段审阅。
[!NOTE] 砚田还在打磨中,界面与行为会继续调整。遇到问题、有想法,欢迎在 Issues 里说——用「Bug 报告 / 功能建议」模板带上环境与复现步骤会快很多;也欢迎直接提 PR。目前项目由我一人维护,难免有疏漏,感谢你的理解与包涵~ 也欢迎随时反馈问题。
约 24 秒。画面来自 DSH 中的隔离示例作品,审阅环节使用预置的示例改动。
三栏写作台 · 示例书稿 · 点击图片查看原图
这个插件做什么
砚田是一个 DeepSeek Harness 插件,不是独立应用:安装后 Harness 左侧导航会出现「砚田」,点开就是一个跑在面板里的长篇写作台。
界面跟随 DSH 的语言设置(设置 → 通用 → 语言):DSH 用英文时,侧栏显示 Yanfield,工作台、AI 面板与设置页也全部切换为英文;中文界面保持原样。书稿内容不会被翻译,AI 用你写作的语言回复。
- 写作台:作品 / 卷 / 章三级结构,三栏布局(目录 · 正文 · AI),自动保存、字数统计、专注模式、排版可调、宣纸 / 夜航双主题。
- 资料随写随查:章纲、设定、角色、伏笔、故事档案都在左栏,浮窗就地编辑,不离开正文。
- AI 改稿,作者做主:AI 读资料、多步执行,提出正文与资料改动;正文逐段对比(绿色新增、红色删除),你决定保留哪几段,确认后才写进书稿。
- 本地优先:书稿、设定、对话都在本机 SQLite 里;模型走 Harness 已经配好的 DeepSeek,不需要再填一遍 Key。
安装
需要 DeepSeek Harness >=0.2.1-rc.5。按你启动的 profile 选择下面一条命令,安装 npm 上的预构建包。
# Web 版
dsh plugin --profile web add dsh-yanfield
# 桌面版
dsh plugin --profile desktop add dsh-yanfield
安装完成后完全退出 Harness 再重新打开(只刷新页面不够:插件含宿主侧代码,需要重启进程)。
如果需要离线安装,可以从 GitHub Releases 下载 dsh-yanfield.tgz,再运行 dsh plugin --profile <profile> add "<本地安装包路径>"。
确认装好:
- 左侧导航出现「砚田」;
- 打开
砚田 → 设置 → 关于,核对版本和构建时间。构建时间是产物生成时间。
更新时用同一个 profile 执行 dsh plugin --profile <profile> add dsh-yanfield@latest,然后重启 Harness。回退可把 @latest 换成目标版本,例如 @0.1.1。之前用 GitHub 地址安装的用户也可以用这个命令切到 npm。
第一次使用
- 点左侧「砚田」,在书架页 新建作品(书名、类型、封面底色、一句话简介)。
- 进入作品后点 写作,就来到三栏写作台:左栏目录 / 章纲 / 设定 / 档案,中间正文,右侧 AI 助手。
- 右侧输入框直接说需求即可,例如「把第一段改得更有画面感,只改第一段」「为下一章写一份章纲」「给周晚建一张角色卡」。
- AI 提出的正文改动会在正文区打开审阅:逐段「保留 / 还原」,点「确认审阅结果」后只写入保留的段落;资料改动在任务卡里逐项确认。
模型来源(设置 → 模型服务):
| 方式 | 需要什么 | 说明 |
|---|---|---|
| DSH 账号登录 | 在 Harness 里登录 DeepSeek | 推荐,零配置;余额可直接查 |
| 官方 API Key | DEEPSEEK_API_KEY | 按量计费;也可在 DSH 的模型服务页填写 |
| DSH 自定义模型 | 在 DSH 的「设置 → 模型」中配置 API | 可接入 LM Studio、vLLM 或 llama.cpp |
| 离线演示 | 不需要 | 只有模板文本,用于试用界面,不能真正改稿 |
在砚田的「模型服务」或写作助手中直接选择模型。模型按 DSH 路由分组。
功能

写作
- 作品 / 卷 / 章三级结构;新建卷、新建章、拖拽排序,章节树显示字数与状态
- 正文自动保存(延迟可调)+ 手动保存;字数、段落、阅读时间实时统计
- 排版可调:衬线 / 黑体、字号、字重、行高、字间距、段落间距、页边距、最大行宽
- 专注模式(隐藏侧栏)、打字机模式(光标居中)、写作目标与每日字数
Alt + 1收起 / 打开目录,Alt + J聚焦 AI 输入框,Ctrl / ⌘ + K快速跳转,Ctrl / ⌘ + F页内查找
资料
- 总纲 / 卷纲 / 章纲三级大纲(目标、冲突、场景节拍、钩子)
- 角色卡、世界观、伏笔、故事档案(本章摘要、人物状态、设定变动、时间线、待确认冲突)
- 设定在揭示章节前默认对 AI 隐藏;关掉「AI 可见性」后即使
@引用也读不到 - TXT 导入(识别「第 N 章」等标题自动拆章,预览后写入)、Markdown / TXT 导出
AI 助手
- 一个对话里完成续写、改稿、建卡、改设定、理章纲;带技能预设、文风选择与可自定义人设
@引用章节、角色、设定、伏笔、档案;上下文预算与分节预览可调- 关键进展按顺序保留,当前步骤原地更新;上翻阅读时暂停自动滚动
- 正文改动在正文区逐段审阅(绿色新增 / 红色删除),资料改动按字段对比
- 助手根据本轮指令查找和读取资料,再生成待审阅的改动。批量改动的成功项可以先审阅,失败项可在「执行记录」查看。需要从新稿整理资料时,可在同一条指令里提出,候选会附上可核对的正文引文
- 支持把常用指令存成提示词预设。工具栏「AI 助手」的续写、扩写、润色和去 AI 味快捷任务会使用对应的预设

AI 与费用
- 模型:
设置 → 模型服务和写作助手的模型列表同时显示 DSH 各路由中的可用模型。LM Studio、vLLM 和 llama.cpp 的配置方式见 AI 与费用。 - 模型目录:
deepseek-flash(DeepSeek-V4.1-Flash,支持文本与图像)与deepseek-v4-pro(DeepSeek-V4-Pro,纯文本),上下文各约 100 万 token;Harness 新增模型时会自动同步进选择器。 - 余额:输入框底部的「余额」直接查 DSH 已登录账号的余额,不需要填 Key。
- 费用:底部「今日 N tok · 预估 ¥X」是今日累计的估算,不是单次任务;单价由插件内置的 DeepSeek 官方价目表提供,按北京时间自动区分高峰与空闲(高峰为工作日 9:00–12:00、14:00–18:00,其余时段与法定节假日按空闲计,空闲价是高峰价的一半)。估算仅供参考,账单以 DeepSeek 官方为准。
- 用量控制:每轮先用一次短模型调用判断任务范围,一般决策轮关闭深度思考。小段润色、选区改写自动降档,较长的工具回执分页返回。
截图
| 书架 | 深色写作台 |
|---|---|
![]() | ![]() |
数据与备份
- 书稿默认在
$DSH_HOME/yanfield/yanfield.db(含-wal/-shm附属文件)。设置 → 数据会显示实际路径并能一键打开所在文件夹。 - 用环境变量
YANFIELD_DB_PATH可指定数据库文件。若 profile 的cordis.patch.yml配置了插件的dataDir,优先使用该目录里的yanfield.db。 - 在 设置 → 数据 → 导出备份 下载
.yanfield文件。可以选择作品,备份正文、设定、资料和 AI 历史,也可以整库备份,额外带走全局设置、预设、模型服务配置和统计。 - 在 导入备份 预览文件并导入作品副本。只有整库备份可用来 恢复整库,恢复前砚田会在数据目录保存一份
yanfield-before-restore-*.db。需要回退时,退出 Harness,再用该快照替换当前数据库文件,并移走当前库的同名-wal和-shm文件。 - 整库导出默认省略模型服务 API Key。请勾选 加密备份并包含模型服务 API Key 来迁移砚田保存的密钥。Harness 管理的账号与凭据需要在目标环境分别配置。
- 数据库结构升级前,砚田会在同一目录创建整库快照。备份失败时会停止升级。升级成功后保留最近三份自动升级备份。
- 卸载插件不会删除书稿;数据库仍在上面那个路径里。
排障
左侧没有「砚田」
先确认是完全退出 Harness 后重开的(不是刷新页面),再看 设置 → 插件 里 dsh-yanfield 是否已启用、版本是否为刚装的那次。
发消息报 no API key / 模型不可用
当前选的是「DeepSeek 官方 API Key」路由下的模型,但还没有填 Key。在砚田选择「DeepSeek 账号登录」分组下的模型,或在 DSH 的「设置 → 模型」填写 API Key。
余额显示「—」或提示未登录
余额来自 DSH 已登录的 DeepSeek 账号。先在 Harness 里登录 DeepSeek 账号,再回来点一下「查询余额」。
费用一直是「费用未知」
说明这次调用没有返回 usage(比如请求中断),或者模型不在内置价目表里、你也没有在 设置 → AI 与上下文 里填单价。填上三档单价后会显示预估值。
书稿在哪 / 换电脑怎么迁
见上面「数据与备份」。换机器时导出整库备份,在目标环境导入并恢复。
怎么卸载
dsh plugin --profile desktop remove dsh-yanfield
然后重启 Harness。书稿不会被删除。
开发
需要 Node.js ≥ 22.19(构建与自检用;运行时由 Harness 提供)。
npm ci # 按 package-lock.json 安装构建依赖
npm test # 构建 dist/,再运行清单检查与冒烟测试
client/ 插件半区:Shadow DOM 挂载、插槽注册、样式入口
src/host.ts 宿主半区:/yanfield 下的 REST/SSE 路由、模型与账号桥接
src/yanfield/ 写作台本体(React 组件、领域逻辑、SQLite 访问)
scripts/ 构建、自检、冒烟、重装
docs/ 功能、AI 与费用、架构、开发、常见问题
从本地源码安装到隔离 profile 的步骤见 本地联调。架构与数据模型见 架构说明,功能清单见 功能说明,AI 接入和费用见 AI 与费用,排障见 常见问题。
English docs: README.en.md · docs/en/
路线图
- v0.1.x(当前):三栏写作台、资料系统、AI 审阅与费用可视化;
- 下一步:章节版本快照与回滚、EPUB 导出、更细的写作统计;
- 更远:知识图谱视图、多模型对比、协作审阅。
致谢
界面与领域逻辑来自 砚田 Yanfield。本仓库是它的 DeepSeek Harness 插件化版本,复用 Harness 的模型服务和明暗主题。
许可
PolyForm Noncommercial 1.0.0:可以自用、学习、修改和分享,不得商用。用它写出来的小说,版权归作者。
Comments
Loading…
Similar plugins
A notebook inside DeepSeek Harness: one page, typeset as you write, with suggestions, structure and translation at the edge of the page.
★ 0
MIT
JavaScript
dsh plugin --profile web add @tyouter/dsh-notesby qinpeizhan77
Local-first fiction workspace that links outlines, chapters, characters, timelines, writing rules, and continuity checks to the conversation.
★ 10
↓ 278/wk
MIT
TypeScript
Aug 30, 2026
dsh plugin --profile web add deepseek-harness-novel-studioby NIRVANA-APOC
Local-first AI literature desk for DeepSeek Harness: parsing, bilingual reading, in-page AI answers, knowledge graphs, and agent library tools.
★ 0
TypeScript
Nov 9, 2026
dsh plugin --profile web add dsh-litnotesby peterwangze
DSH (DeepSeek Harness) 自动化小说写作发布流水线插件:claude-writing-workflow 迁移版 agent 预设 + 小说工作台(可视化/实时渲染/章节编辑)+ 多平台发布配置与数据驱动优化闭环
★ 9
NOASSERTION
JavaScript
Nov 10, 2026
dsh plugin --profile web add dsh-novel-writingby x2802490130-prog
Writing engine for DeepSeek Harness: long-form web-novel orchestration with a separate DeepSeek key, lore management, semantic retrieval, and a corpus library.
★ 12
↓ 380/wk
MIT
JavaScript
Aug 25, 2026
dsh plugin --profile agent add dsh-tool-writingby shiyan688
禁AI腔清单能让模型不像 AI,这个工作台让它像你:标好/坏段落 → 压成写作规律(只有规律进写稿上下文)→ 开新章(方向/候选/选段/合并定稿)→ 批注式微调(只改你标过的段,逐字核对)→ 张力曲线与账目体检。dsh 插件,775 条断言。
★ 15
↓ 362/wk
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-novel-craft
