Skip to main content
H

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-qibi

README

dsh-qibi

dsh-qibi

起笔写作台 · DeepSeek Harness 原生小说工作台

把本机的起笔(QiBi)书稿接进 DSH:左侧栏一个面板、12 个工具、13 种 AI 写作动作。

License Tested DSH version Node dsh-plugin

⚡ 快速安装 · 🎨 工作台一览 · 🚀 开始使用 · ✨ 核心能力 · 🧰 工具参考 · 🔒 数据与安全 · 🛠️ 排错 · 🌐 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,左侧栏出现「起笔」即为生效。


三步开始

  1. 直接开始。Windows 首次使用默认在 D:\dsh-qibi\data 初始化空白库;没有 D 盘时使用用户目录下的独立 dsh-qibi/data。不读取旧的起笔测试库,也不附带示例小说。
  2. 按需更改位置。面板提供“数据位置”按钮,可以填写或选择文件夹,选择“新建空白库”或“连接已有库”,点击保存即可。选择通过 DSH 配置服务持久化,重启后保留;已有书稿不会被搬移或覆盖。
  3. 创建作品或让 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_storageinfo configure查看或保存数据位置;新建空白库或连接已有库,通过 DSH 配置服务保留选择
qibi_status—数据目录、当前作者、作品/章节/字数统计、写入是否开启、面板选中项
qibi_novellist get create update delete作品增删改查;删除需 confirm: true
qibi_chapterlist read write create update delete move章节读写与增删;完整 read 返回 token,写入时带 expectedToken
qibi_revisionlist restore章节版本历史与恢复
qibi_outlinelist create update delete总纲与章节细纲
qibi_characterlist create update delete state set_state ai_extract ai_generate import_candidates人物设定与动态账本;AI 只生成候选,确认导入时同名跳过
qibi_continuityvolumes create_volume update_volume summary set_summary writer_state set_writer_state分卷、章节摘要、写作状态与伏笔账本
qibi_kbquery stats reindex起笔自带 BM25 检索与索引维护
qibi_search—章节标题/正文 + 人物关键词检索
qibi_export—整本 Markdown / TXT
qibi_distillauthors 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   # 可选:只在需要固定某个作者时填写
键默认含义
allowWritetrue硬开关。false 时不创建新库,面板与工具只读取已有库
dataDirWindows 优先 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 便携 exeDSH 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功能清单、数据通路、安全边界与已知限制的完整版
LICENSEMIT

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