- Home
- Plugins
- Tools & Capabilities
- dsh-qibi
dsh-qibi
huajikano/dsh-qibi
QiBi writing desk: a native sidebar panel and 12 qibi_* tools for a local SQLite manuscript library, with optimistic-lock saves, pre-write revision backups, BM25 search, whole-book export, and model-assisted prose, character extraction and continuity notes.
Install
dsh plugin --profile web add github:huajikano/dsh-qibiREADME
dsh-qibi
起笔写作台 · DeepSeek Harness 原生小说工作台
把本机的起笔(QiBi)书稿接进 DSH:左侧栏一个面板、12 个工具、13 种 AI 写作动作。
⚡ 快速安装 · 🎨 工作台一览 · 🚀 开始使用 · ✨ 核心能力 · 🧰 工具参考 · 🔒 数据与安全 · 🛠️ 排错 · 🌐 English
本地优先。 书稿在你明确指定的本机数据库中读写,所有作品、正文与设定都留在你自己的磁盘上。首次安装不会自动连接旧库,发行包不含任何小说内容、用户数据库或备份。
Native QiBi writing desk for DeepSeek Harness: sidebar panel, 12 model tools, and 13 AI writing actions over your local
novelforge.db.
起笔桌面版:huajikano/qibi-desktop。本仓库提供独立的 DSH 插件,使用 DSH 原生界面。
目录
| 开始使用 | 创作与能力 | 维护与文档 |
|---|---|---|
| 工作台一览 快速安装 三步开始 | 核心能力 工具参考 AI 写作动作 | 配置 数据与安全边界 排错 开发 |
工作台一览
DSH 左侧栏出现一枚「起笔」图标,点开是 DSH 原生面板(不是 iframe)。左侧作品 → 章节树,右侧八个页签:
| 页签 | 做什么 |
|---|---|
| 正文 | 编辑当前章,停止输入后自动保存;本章出场人物可一键插入光标处;细纲锚点按标题前 8 字在正文定位,已写到的直接跳转;Alt+F 专注模式;Ctrl+Z / Ctrl+Y 撤销重做(含 AI 写入等程序化改动) |
| 大纲 | 总纲与章节细纲的查看、新建、修改、删除(字段级乐观锁) |
| 人物 | 人物设定卡与动态账本(位置 / 境界 / 道具 / 状态 / 近期事件 / 关键关系) |
| 蒸馏 | 作者素材解析、生成提示、风格版本与作品绑定 |
| 连续性 | 分卷、章节微摘要(关键事件 / 章末钩子)、作品写作状态与伏笔账本 |
| 检索 | 关键词检索 + 起笔自带 BM25 知识库检索,可整本重建索引 |
| 版本 | 章节历史版本列表与恢复(恢复前先把当前正文备份) |
| 导出 | 整本导出 Markdown / TXT 文本 |
保存状态在标题栏直接可见:保存中… / 已保存 / 未保存 / 冲突。冲突时不会静默覆盖,而是给出「重载起笔版本」与「强制覆盖(先备份)」两个出口。
主题与明暗
点击面板顶部 主题 → 外观与主题,选择后立即生效:
- 默认 经典白 / 浅色,保留白色工作台、浅灰目录和近黑主按钮。
- 另有 Claude 暖色、羊皮纸、森林、暮色、蔷薇,每套支持浅色、深色和跟随系统。
- 跟随 DSH 直接采用宿主当前主题,不单独覆盖起笔颜色。
- 设置中可同时查看浅深色示例,也可一键 恢复默认白色。选择保存在当前浏览器;存储被禁用时会明确提示。
- 主题只影响起笔及其弹窗,不改变 DSH 全局主题;切换不会重新加载章节或清空编辑状态。
连续性自动整理(v1.4.0)
进入“连续性”,选择已有正文的章节,点击 AI 自动整理本章。系统使用 DSH 当前模型,从已保存正文补齐本章摘要、关键事件和章末悬念,并把有原文依据的新伏笔追加到全书账本,完成后直接保存。已有手动笔记、正文、进度和已回收状态不变。
希望以后自动完成时,开启当前作品的 标为已发布时自动整理。开关默认关闭,首次开启会确认模型调用与写入;在起笔的章节设置中把章节从其他状态改为“已发布”时触发。普通自动保存、重新打开页面、重复保存“已发布”均不触发。连续发布的章节排队逐章处理,失败不反复调用,仍可手动重试。
整理会调用当前模型,可能产生费用。单章最多24,000个UTF-16字符,超出会在调用前拒绝,不截断假装完整。当前宿主会话内,相同正文和已保存资料不变时跳过重复调用;分卷仍为可选的手动分组。旧伏笔格式不适合追加时原样保留,并在结果里标明;AI提炼仍需作者审阅,不自动将伏笔标记为已回收。暂未进行真实模型及本轮界面截图测试。
本节功能均包含在 v1.4.0 发行包中。
普通作者使用入口(v1.4.0)
- 大纲 → 总纲 / 章节细纲:通过归属筛选和搜索查找条目,选择“查看全文”或“编辑”。宽窗口列表与编辑区分栏;窄窗口先显示当前编辑区。
Ctrl / ⌘ + Enter保存,取消或离开有未保存确认;遇到并发冲突先复制需要的内容,再主动重载。 - 作品设置:基本信息与简介分区,题材和状态可选候选或自定义;底部保存修改,关闭未保存修改需确认。删除作品位于单独折叠的危险操作区,删除前应先导出需保留内容。
- 连续性 → 写作状态 → 伏笔列表:添加条目,编辑标题、详情、状态和备注,最后点击写作状态的“保存”。原有未知字段会保留;不支持安全列表编辑的旧格式显示“高级 JSON”,不会自动清空或转换。
- 主题 → 外观与主题 → 显示密度:默认舒适,放大按钮和辅助文字;也可切回原来的紧凑布局。配色仍默认经典白,密度与主题分别记忆。
- 人物 → 从正文提取人物:可选起止章节,逐批点击分析。每批一次模型调用;下一批合并进现有候选,不覆盖已经编辑的字段和勾选。长章节会接着上批偏移分析,不只取开头。一次最多确认导入30人,其余候选留待继续导入。分批期间若修改正文或章序,应重新开始。
- 蒸馏:按“建立作者 → 添加素材 → 对话生成 → 应用风格”完成。复制指令后需粘贴到 DSH 对话并发送;生成保存后回面板刷新,确认应用到当前作品。复制失败仍可手动选取指令。
本节普通作者使用入口包含在 v1.4.0 及之后版本中。安装地址见下方。
配色选择方式参考 dsh-claude-style 的公开设计规范,预设色值独立配置,不附带其专有字体、品牌标记或渲染引擎。
快速安装
运行要求:已验证 DSH
0.2.2-rc.3· Node.js ≥ 24。首次使用自动准备空白数据库;也可主动连接原起笔数据库,无须运行起笔桌面程序。
推荐从 v1.4.0 Release 安装预构建包,已包含 client.js,不需要本机构建前端:
dsh plugin --profile web add -w https://github.com/huajikano/dsh-qibi/releases/download/v1.4.0/dsh-qibi-1.4.0.tgz
dsh web
也可从固定 GitHub 标签安装源码包:
dsh plugin --profile web add -w github:huajikano/dsh-qibi#v1.4.0
桌面版可在 设置 → 插件 → 添加插件 中粘贴上述 .tgz 下载地址,或选择解压后的本地目录。
装好后重启 DSH,左侧栏出现「起笔」即为生效。
三步开始
- 直接开始。Windows 首次使用默认在
D:\dsh-qibi\data初始化空白库;没有 D 盘时使用用户目录下的独立dsh-qibi/data。不读取旧的起笔测试库,也不附带示例小说。 - 按需更改位置。面板提供“数据位置”按钮,可以填写或选择文件夹,选择“新建空白库”或“连接已有库”,点击保存即可。选择通过 DSH 配置服务持久化,重启后保留;已有书稿不会被搬移或覆盖。
- 创建作品或让 Agent 参与。空白工作台可直接新建作品;连接已有库后会列出该作者的书稿。Agent 可以通过
qibi_storage使用同一套目录设置操作。
选中章节会同步给宿主:Agent 的系统提示里多一行「作者当前在 DSH 面板里选中了作品《X》·第 N 章」,于是「这一章」不需要再问是哪一章。
核心能力
| 模块 | 说明 |
|---|---|
| 书稿读写 | 作品 / 章节 / 大纲 / 人物 / 分卷 / 摘要 / 写作状态的增删改查;章节可上移下移 |
| 版本历史 | 每次覆盖正文前自动写入起笔的 chapter_revisions(沿用其「最近 50 版」策略);删除章节前另存正文到 dataDir/chapter-backups/ |
| 并发保护 | 保存带 updated_at + 正文哈希 的令牌,校验与写入在同一个 BEGIN IMMEDIATE 事务内完成;大纲/人物/分卷/摘要/写作状态亦有字段级令牌 |
| 写入护栏 | 已有正文必须带令牌才能写;空内容覆盖、疑似「截断成前缀」的写回默认拒绝;读取被截断时不发放令牌 |
| 检索 | 与起笔同源的 BM25(kb_chunks、同一套分词与打分),写入时同步重建该章分块 |
| AI 人物 | “人物”页可从当前章或全书已保存正文提取候选,也可用一句话构想生成一个角色;先勾选编辑再确认导入,同名跳过不覆盖。全书分析默认有章节与字符上限,超出会提示 |
| 蒸馏作者 | 上传 TXT / MD / HTML / JSON / EPUB 样章解析成素材;把 Agent 产出的三段结果存为版本,可回滚、可绑定到作品;绑定后生成时遵循该版本的写作 Skill |
| 导出 | 整本 Markdown / TXT,返回文本与建议文件名(落盘交给 DSH 的文件工具) |
| 不重复造轮子 | 插件不内置模型调用层:AI 走 DSH 自己的 ctx.llm,用你当前默认模型,因此不需要在插件里另配 Key |
工具参考
12 个领域工具,每个用 action 区分动作。省略 novelId / chapterId 时默认取面板当前选中项。
| 工具 | 动作 | 说明 |
|---|---|---|
qibi_storage | info configure | 查看或保存数据位置;新建空白库或连接已有库,通过 DSH 配置服务保留选择 |
qibi_status | — | 数据目录、当前作者、作品/章节/字数统计、写入是否开启、面板选中项 |
qibi_novel | list get create update delete | 作品增删改查;删除需 confirm: true |
qibi_chapter | list read write create update delete move | 章节读写与增删;完整 read 返回 token,写入时带 expectedToken |
qibi_revision | list restore | 章节版本历史与恢复 |
qibi_outline | list create update delete | 总纲与章节细纲 |
qibi_character | list create update delete state set_state ai_extract ai_generate import_candidates | 人物设定与动态账本;AI 只生成候选,确认导入时同名跳过 |
qibi_continuity | volumes create_volume update_volume summary set_summary writer_state set_writer_state | 分卷、章节摘要、写作状态与伏笔账本 |
qibi_kb | query stats reindex | 起笔自带 BM25 检索与索引维护 |
qibi_search | — | 章节标题/正文 + 人物关键词检索 |
qibi_export | — | 整本 Markdown / TXT |
qibi_distill | authors author read save bind unbind versions rollback create add_text | 蒸馏作者的素材、版本与绑定 |
写章节的推荐顺序:先 qibi_chapter(action=read) 拿 token,再带 expectedToken 写入。这样作者同时在起笔里改稿时不会被覆盖。
AI 写作动作
面板内的 13 个动作全部通过 DSH 的 ctx.llm 发起,使用你当前的默认模型:
AI 写作顶部“生成模型”旁提供“思考强度”选择,档位直接读取当前模型能力。默认“跟随当前设置”,手动选择会同时作用于生成和继续生成,并按模型在本机记忆;不会改动 DSH 全局设置。不支持调节的模型会显示原因,模型切换后重新打开抽屉即可刷新档位。
- 选区(3):去 AI 味、润色、扩写——只替换选中文本。
- 整章(5):起草、续写、润色、去 AI 味、扩写。
- 分析(5):审稿、拆解、章节摘要、细纲、创作顾问。
配套约定:输出未完整结束时只能复制、不能写回正文;达到模型长度上限时可点「继续生成」接着写完;写回正文后通知条可一键撤销;每次完整生成留在抽屉的「生成历史」里(本机保存),应用时另在起笔版本历史写一条 AI 生成 · 模式名。
上下文按「作品 → 章节目录/摘要 → 细纲 → 人物 → 分卷 → 进度/伏笔 → 蒸馏 Skill → 前文」组装,并全部做长度上限,避免把整本塞进一次请求。
配置
在面板点击“数据位置”即可更改并保存,不需要手工编辑配置文件。高级用户也可通过配置指定:
- id: qibi
config:
allowWrite: true
dataDir: 'D:\dsh-qibi\data'
userId: 1 # 可选:只在需要固定某个作者时填写
| 键 | 默认 | 含义 |
|---|---|---|
allowWrite | true | 硬开关。false 时不创建新库,面板与工具只读取已有库 |
dataDir | Windows 优先 D:\dsh-qibi\data | 独立数据目录,可在界面保存;也支持 QIBI_DATA_DIR。不会自动连接旧起笔库 |
userId | 当前库中的可用作者 | 新库仅创建“本地作者”,没有小说内容 |
面板右上角的写入开关只能在 allowWrite: true 的前提下临时收窄,不能放宽。
数据与安全边界
- 唯一数据通路是本机的
novelforge.db(WAL 模式)。插件与起笔.exe没有进程关系,不需要起笔正在运行;两边同时开着也安全(busy_timeout+ 短事务)。 - 只动内容表:
novels/chapters/outlines/characters/volumes/chapter_summaries/character_states/novel_writer_state/chapter_revisions/kb_chunks/ 蒸馏相关表。绝不读取users.*_api_key_enc(AES-GCM 密文,插件不需要密钥)。 - 不改已有库结构:新目录首次初始化空库结构;连接已有数据库时不建表、不加列、不迁移,缺少可选列时降级。
- 不覆盖手稿:写前备份 + 令牌乐观锁(见核心能力)。
- 归属校验:作品 / 章节 / 大纲 / 人物 / 分卷都按当前作者校验,换
userId既看不到也写不了别人的作品。 - 插件不经手任何 API Key;AI 请求由 DSH 宿主发起。
与起笔应用的关系
这是一个独立的 DSH 插件,不是起笔的一部分,也不会被一起打包:
| 起笔桌面版 | dsh-qibi | |
|---|---|---|
| 形态 | Electron 便携 exe | DSH profile 里的一个包 |
| 界面 | 自己的完整前端 | DSH 原生面板(sidebar.panellist + main) |
| 关系 | — | 只通过磁盘上那一个 novelforge.db 与起笔相交 |
因此:卸载插件不影响起笔桌面版;本插件可独立初始化空白库,不要求安装 exe。主动连接桌面版数据库时,两端共用该目录中的书稿。
已知限制
- 地图编辑器、管理员与公网隧道、起笔自带的模型调用层不在插件范围内(AI 由 DSH 承担)。
- 蒸馏作者在插件里不调用模型:面板负责素材与版本,生成由 Agent 通过
qibi_distill完成。 - 分卷可新建与修改,但「章节归属哪个分卷」仍按起笔数据只读展示。
- 若在起笔里大批量重建 BM25 索引,请以起笔侧结果为准。
排错
| 现象 | 处理 |
|---|---|
| 左侧栏没有「起笔」图标 | 确认 DSH ≥ 0.2;重启 DSH;在「设置 → 插件」里确认 qibi 这一行是开启状态 |
| 面板提示数据库无法连接 | 点击“数据位置”,选择或填写目录,按需新建空白库或连接已有库并保存 |
| 保存提示「已被改动」 | 起笔或另一个窗口改过这一章。选择「重载」或「强制覆盖(先备份)」 |
| 写入被拒绝 | 检查 allowWrite 与面板右上角写入开关;Agent 侧最常见原因是漏带 expectedToken |
| 面板取数 401/403 | 刷新页面重新登录宿主的浏览器会话 |
| 想看插件在做什么 | qibi_status 一次性给出数据目录、作者、统计与写入状态 |
开发
npm install
npm run build # src/*.jsx → client.js(React 由宿主提供)
npm run test:release # 临时夹具验证首次使用隔离 + 浏览器渲染;不需要私有书稿
npm run test:local # 可选:针对本机已有起笔库的集成自检
test:release 在临时目录模拟既有数据库,断言首次使用不打开它,作品与章节计数保持为零。test:local 只在临时副本执行写入,不会把数据库打包到发行物。
自检覆盖:路由与工具契约、12 个工具的动作、只读拒写、正文保存的四处不变量(字数 / 版本备份 / 作品总字数 / 知识库分块)、令牌乐观锁、版本恢复、人物动态账本、章节摘要、写作状态、知识库重建与 BM25 检索、导出文本,以及 client.js 的 slot 渲染。
写测试只落临时副本,并在结束时断言真实库没有任何改动。自检需要本机已有一份起笔数据库(只读取它);scripts/make-icon.py 生成市场用位图(Pillow)。
改动生效方式:src/ 改完 node build.mjs 后刷新页面;lib/、index.js 改完在插件页把 qibi 关掉再打开即可,不必重启 DSH。
文档
| 文档 | 内容 |
|---|---|
| docs/DETAIL.md | 功能清单、数据通路、安全边界与已知限制的完整版 |
| LICENSE | MIT |
License
MIT · 插件自绘图标同为 MIT;不含任何第三方小说文本或图标素材。
Language / English Guide
The panel follows the host language; switch at Settings → General → Language. Your manuscripts, outlines and assets keep whatever language they already use.
dsh-qibi is a DeepSeek Harness plugin with a native writing panel, eight tabs, 12 qibi_* tools and 13 AI writing actions routed through ctx.llm. A fresh Windows install prefers D:\dsh-qibi\data and initializes an empty compatible SQLite database with one local author and no novels. Use Data location to create a new empty library or explicitly connect an existing QiBi library; the host configuration editor saves the choice across restarts. Existing databases are never migrated or overwritten during setup. Chapter writes use revision backups and optimistic-lock tokens. The QiBi desktop app is optional and need not be running.
Related plugins
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora