dsh-tool-writing

面向 DeepSeek Harness 的「写文引擎」插件：让 harness 具备长篇网络小说的创作能力，并用一把独立的 DeepSeek key 承担「子线程 / 分流 / 多线并行」的生成与检索任务。

设计定位

• 主 Agent（harness 自身模型）：总调度，负责主线叙事、结构、设定、以及「新奇的、出其不意的想法」的决策。
• 本插件（独立 key）：把重活分流出去——并发生成多章草稿、批量出点子、批量扩写细纲，以及资料检索与一致性筛查。
• 饲料区（书库）：导入并管理多本小说，建立全文索引，供考据、风格参考与设定借鉴。

工具集

创作核心

| 工具 | 作用 | |---|---| | `novel_init` | 初始化小说项目（元信息 + 目录骨架） | | `novel_outline` | 生成/展开主线、分卷、章节细纲（可并行） | | `novel_lore` | 人物/世界观/时间线/伏笔的增删改查 | | `novel_brainstorm` | 并发生成 N 个新奇点子 | | `novel_draft` | 起草一章正文（综合设定+大纲+前文，支持分卷） | | `novel_continue` | 从最近章节自动续写下一章 | | `novel_batch` | 并发生成多章草稿（分流/多线） | | `novel_polish` | 润色/改写 | | `novel_review` | 一致性审校（检索前文+设定，筛查矛盾） | | `novel_research` | 资料检索/考据，归纳成笔记 | | `novel_status` | 查看项目进度（分卷/章节/字数） | | `novel_export` | 导出全书为单个 Markdown/TXT | | `novel_summarize` | 生成章节情节摘要，写入可检索的情节日志 | | `novel_setting_extract` | 从正文自动抽取人物/世界观/伏笔到 lore/ | | `novel_foreshadow` | 伏笔回收追踪（登记/回收/查未回收） | | `novel_brief` | 模糊需求一键开书（一句话 → 完整方案） | | `novel_distill` | 蒸馏文本为精华 + 保留校验（项目/书库，含全书语义召回） | | `novel_handbook` | 生成给人读的导航手册（含语义召回名场面） | | `novel_simulate` | 深度推演引擎（心理/因果/交汇/反常识意外） | | `novel_semantic` | 混合语义检索（向量召回+字面召回+LLM 重排，按含义而非字面） | | `novel_vsearch` | 纯向量语义检索（cosine 相似度，免 LLM，快速看命中） | | `novel_embed` | 构建/补全语义向量索引（增量、断点续传、内容变更自动重嵌） | | `novel_evolution` | 设定/人物演化追踪（auto 检测 + 手动 + 历史 + 版本 diff 陈旧检测） | | `novel_threads` | 多线叙事与线索图谱（登记/交汇/图谱/停滞提醒） | | `novel_style` | 风格指纹（剖析文风、多风格档案、自动注入所有生成） | | `novel_decision` | 人机共创决断点（选项+利弊，人做美学决断） | | `novel_sync` | 章末自动编排（摘要+抽取+演化+伏笔提醒 一键） |

饲料区 + 扩展检索

| 工具 | 作用 | |---|---| | `novel_library_import` | 导入小说（.txt/.md/.epub，自动识别编码 + 自动分章） | | `novel_library_list` | 列出书库所有小说 | | `novel_library_read` | 读某本小说的某一章 | | `novel_library_delete` | 删除已导入的小说 | | `novel_library_search` | 书库全文检索（SQLite FTS5 trigram + LIKE 混合） | | `novel_search` | 扩展检索：项目 + 书库 联合全文检索 |

语义向量检索使用百炼 `text-embedding-v3`（1024 维，复用 DASHSCOPE_API_KEY，零新增成本）：`novel_embed` 建索引（增量可续传，内容变更自动作废重嵌），`novel_semantic` 混合召回，`novel_vsearch` 纯向量；无 key 时自动退化为字面检索。

项目目录约定

``` novel.json # 作品元信息 + 分卷/章节进度 lore/ # characters/ world/ timeline/ foreshadowing/ other/ outline/ # 主线与分卷/章节细纲 chapters/ # 正文（可按分卷建子目录） research/ # 考据与审校笔记 .writing-index.sqlite # 项目全文检索索引（SQLite，自动维护） ```

书库默认位于 `$DSH_HOME/writing-library/`（可配 `libraryRoot`）。

配置

| 字段 | 默认值 | 含义 | |---|---|---| | `apiKeyEnv` | `DSH_WRITING_API_KEY` | 独立 key 的环境变量名/凭证引用 | | `apiKey` | `""` | 内联 key（不建议，避免泄露） | | `baseURL` | `https://api.deepseek.com` | DeepSeek 端点 | | `model` | `deepseek-chat` | 分流用的模型（可用 deepseek-reasoner） | | `maxConcurrency` | `4` | 并发上限 | | `maxTokens` | `4096` | 单次生成最大 token | | `temperature` | `0.8` | 采样温度 | | `projectRoot` | `.` | 小说项目根目录（默认当前工作区） | | `libraryRoot` | `$DSH_HOME/writing-library` | 书库根目录 |

密钥安全

密钥绝不硬编码。优先级：凭证存储（`$DSH_HOME/.credentials.yaml` 的 `DSH_WRITING_API_KEY`）→ 环境变量 → 内联 config。

安装（profile）

``` dsh plugin --profile web add file:<本目录> ```

然后在写作预设的 `agent.cordis.yml` 中挂载：

```yaml

• id: tool-writing name: 'dsh-tool-writing' config: apiKeyEnv: DSH_WRITING_API_KEY model: deepseek-chat maxConcurrency: 4 ```