ProseForge

2. 安装核心依赖

```bash

可选：RAG 检索依赖（chromadb + sentence-transformers）

uv pip install -e ".[rag]"

安装

pip install -e .

安装后，pre.py 的世界观提醒自动使用语义检索替代关键词子串匹配。

安装测试工具

uv pip install pytest ```

5. 验证安装

uv pip install pytest
python -m pytest tests/ -x -q

预期输出：全部测试通过（~280 项）。

---

推荐的标准使用顺序

3. 配置路径

cp config.example.json config.json

编辑 config.json（结构见 config.example.json），按需调整 paths：

{
  "app": { "name": "Novel Forge - 小说引擎", "version": "0.8.0", "mode": "local" },
  "paths": {
    "db_path": "./data/novel_memory.db",
    "novels_root": "./novels",
    "exports_root": "./exports",
    "outputs_root": "./outputs"
  },
  "novel": { "default_slug": "demo_novel", "default_title": "Demo Novel" }
}

db_path 是默认回退路径；实际写作用槽位库 workspace/<slot>/novel.db。路径用正斜杠 /，pathlib 自动跨平台。

在 Hermes 配置中启用该插件（注册的 toolset 名为 hermes-forgen-engine）

4. 注册插件（按你的 Agent 选择）

ProseForge 提供三个插件表面，选一个即可：

Hermes Agent（推荐）：

```bash

把插件源码 plugin/proseforge-Hermes/ 链接到 Hermes 的 profiles/<profile>/plugins/ 下

注册后可用工具: nf_pipeline, nf_project

```

Codex： 将 plugin/proseforge-codex/ 链接到 Codex 的插件目录。 提供两个入口：nf_pipeline（写/审/改/卷）、nf_project（建/管/导）。

Claude： 将 plugin/proseforge-claude/ 放入 Claude 的 projects 目录。 提供 SKILL.md 引导 Claude 调用对应工作流。

`nf_pipeline`

nf_pipeline 负责写作流水线本身。

可以把它理解成“章节生产线”。

---

插件表面

当前仓库里可以看到三种表面：

虽然外层平台不同，但内部尽量共用同一套入口名和同一套逻辑。

这也是为什么 README 一直强调：

• nf_project
• nf_pipeline

因为这两个名字才是跨平台稳定的“公共语言”。

---