SAGEBOOK 使用说明

一、SAGEBOOK 是什么

SAGEBOOK 是一套部署在网页上的写作工具集，不依赖后端服务器，所有书稿默认保存在你浏览器的本地存储（localStorage）中，完全私有。它通过调用你自己的 AI（本地 Ollama 或云端 API）提供续写、润色、审查等能力。

二、三步开始

1. 配置 AI：打开 设置，选择「本地 Ollama」或「云端大模型」并填写模型信息（推荐本地 Ollama，免费用、数据不出本机）。
2. 进入编辑器：回到首页点「开始写作」，或书稿页左上角 📚 SAGEBOOK 回首页再进入。
3. 动手写 + 调 AI：直接在中间写作区动笔；选中文字 → 右侧面板切到「💬 AI 助手」或「⚡ 技能」→ 让 AI 续写、润色或审查。

举例：从零到第一段 AI 续写

黑暗里没有预想中的供桌，只有一道裂隙，像被人从地底撕开。
低语声贴着耳根爬上来，喊的都是他早已忘了的名字。

三、首页功能

状态栏（五张卡片）

「开始写作」玻璃容器

首页中央的液态玻璃大卡，点击进入 主编辑器。背后彩色光晕与流动高光仅作视觉装饰。

「更多创作工具」可展开板块

与「开始写作」同款玻璃容器，点击后向下展开 10 个工具入口（写作技能、大纲、角色、世界观、知识图谱、写作分析、平台工具、AI 集成、模板库、设置）。再点一次收起。

「官方使用帮助说明」容器

「三步开始」下方的同款玻璃容器，点击直达本说明文档（docs.html），随时回看功能用法。

四、主编辑器（核心工作区）

地址：main-editor.html。布局为左侧章节树、中间写作区、右侧 AI 面板，顶部为工具栏。

顶部工具栏

左侧 · 章节目录

• 点击章节切换当前编辑文件；悬停章节行右侧出现三个按钮：
• ✏️ 重命名：行内输入新名，自动补 .md 后缀。
• 📋 创建副本：复制全文并新开一份（标题自动加「(副本)」）。
• 🗑 删除：二次确认后删除；仅剩一章时禁止删除。

中间 · 写作区

• 支持 Markdown 语法；顶部「AI 续写」按钮可在光标处生成续写内容。
• 续写结果以浮层出现，可 ✓ 接受 / ✗ 拒绝 / 🔄 重新生成。
• 输入实时自动保存，无需手动存盘。

他握紧剑柄，裂隙在脚下蔓延成河。

河水是冷的，却映出成千上万张脸——每一张都在喊同一个字：归。

右侧 · AI 面板（5 个标签页）

💬 AI 助手 · 对话举例

我的反派「灰雾」总在关键节点出现又消失，读者觉得机械降神。怎么改得更有因果？

把灰雾的每次现身都挂到主角一个"未完成的抉择"上：
· 第2章他犹豫是否救陌生人 → 灰雾在救下的人眼里一闪
· 第5章他隐瞒真相 → 灰雾从被隐瞒者身后渗出
这样出场=代价兑现，读者能回溯因果，不再是天降。

📋 模板 · 插入举例

【角色卡】
姓名：
年龄：
身份 / 阵营：
外在目标：
深层欲望：
最大恐惧：
核心矛盾：
一句话人设：

⚡ 技能面板内置 5 项

在这个充满神秘与未知的世界里，他感到十分震撼，内心涌起一种难以言喻的复杂情绪。

异界压顶，他脊背一凉。说不清是怕，还是终于等到。

五、设置页面

地址：settings.html。集中配置 AI 引擎与云同步。

1. AI 引擎配置

📌 举例 · 配置本地 Ollama

引擎：本地 Ollama
地址：http://localhost:11434
模型：qwen2.5:14b

📌 举例 · 配置云端模型

引擎：云端大模型
API 地址：https://api.openai.com/v1
API Key：sk-xxxxxxxxxxxxxxxx
模型：gpt-4o-mini

2. 一键本地启动器（解决混合内容限制）

解决：双击项目里的 start-local.command（macOS）/ start-local.bat（Windows），它会自动起一个本地服务器并打开浏览器，让你以 http://localhost 访问本站，从而正常使用本地 Ollama。无需安装任何额外软件。

3. 云同步（手机 / 电脑互通）

见 第八节 详解。

六、写作技能页（完整 12 项）

地址：writing-skills.html。一个独立的「输入文本 → 选技能 → 看结果」工作台，适合脱离编辑器单独处理片段、设定草稿。

用法：左侧粘贴/输入文本 → 点任一技能卡片 → 右侧出 AI 结果 → 「📋 复制结果」或「💾 下载 .txt」。

逐项举例（输入 → 输出）

在这个充满神秘与未知的世界里，他感到十分震撼，内心涌起一种难以言喻的复杂情绪。

异界压顶，他脊背一凉。说不清是怕，还是终于等到。

她很快地跑过了长长的走廊，心里很着急。

她提裙掠过长廊，足音敲得心跳一样急。廊灯一盏盏退到身后，像被她甩开的呼吸。

雨下了一整夜，他没睡。

雨下了一整夜，敲在瓦上像谁在门外数着他的罪。他靠墙坐着，听水从檐角淌成线，把窗纸洇出一片模糊的亮。枕头是干的，被褥是干的，只有眼角那点湿，他不肯擦。

剑光落下的前一刻，他忽然听见师父的声音。

「收手。」两个字很轻，却压得满室风声一滞。他手腕一颤，剑尖偏了三寸，削落的不是敌首，而是自己束发的带子——黑发泼下来，遮住了他骤然红了的眼。

林默在祠堂发现裂隙，灰雾低语，归尘之力初醒。

第一卷 · 裂隙初醒
  · 第1章 祠堂的门：林默返乡，推开尘封祠堂
  · 第2章 地底的裂缝：裂隙现身，灰雾第一次低语
  · 第3章 归尘之力：本能觉醒，救下陌生人反埋隐患
支线：被救者身世的真相（可于第5章回收）

主角救了反派伪装的无辜者，与之同行。

1. 让被救者"无意"透露假情报，把主角引向陷阱——信任与背叛的张力。
2. 同行中反派暗中替主角挡一次险，主角开始怀疑"恶"的界定。
3. 暴露临界点：主角发现对方手上的旧伤与自己师父同源。
4. 反转：所谓"拯救世界"的任务，恰恰需要先毁掉主角守护的人。

裂隙撕裂大地，灰雾低语，归尘之力能重塑万物。

世界观 · 九界
· 地理：地表被九道裂隙切成浮岛，岛间靠"归尘桥"相连。
· 势力：守界人（维持裂隙）、灰雾（裂隙溢出的意识集合）、归尘族（能操控归尘之力）。
· 力量体系：归尘之力以"记忆"为燃料——忘得越多，力量越强，代价是自我消散。
· 核心规则：裂隙每百年扩张一次，称为"归尘之潮"。
· 历史：上一次潮汛毁了一整界，残魂化为灰雾的低语。

场景：林默与守界人长老初次对峙，长老质疑他的身份。

长老：「归尘族的血，会在月光下泛青。你伸手。」
林默：「若我伸了，您是要验明正身，还是借机取我性命？」
长老：「（笑）小孩子，活到现在，我取过的人命，比你走过的路还多。」
林默：「那您该认得——杀我的人，从没有活着回去过。」

主角卡在"要不要打开祠堂裂隙"的抉择。

方向1【开】：放出的灰雾附身村民，主角被迫屠村——极致虐点，但需铺垫村民羁绊。
方向2【不开】：裂隙自行扩张，全村沉陷，主角背负见死不救的愧——更易共情。
方向3【假开真封】：主角佯装开启，实则逆向封印，引灰雾入体——埋"人形裂隙"伏笔。
方向4【第三方抢开】：宿敌抢先开启，主角从阻止变收拾烂摊——转移冲突对象。
方向5【开一半】：只裂开指缝大小，漏出的低语逐渐替换村民记忆——细思极恐的日常侵蚀。

林默，归尘族遗孤，在祠堂醒来。

姓名：林默
身份：归尘族最后的血脉，被守界人秘密送出九界
性格：外冷内执，习惯把情绪切成小块慢慢咽
欲望：找回被裂隙吞掉的妹妹
恐惧：怕自己打开裂隙的瞬间，会变成下一个灰雾
核心矛盾：救世需借归尘之力，借力即靠近消散
弧光：从"想关掉裂隙"到"学会与裂隙共存"

第3章 归尘之力（约 1200 字，动作戏为主）。

【风格】短句利落，动作戏节奏好；但环境描写偏少，画面偏"空"。
【节奏】中段打斗拖了 400 字，建议砍掉两个重复的格挡回合。
【人物】主角动机（救妹妹）本章没呼应，读者易丢失牵挂。
【悬念】结尾停在"裂隙闭眼"，钩子够；建议多留一句灰雾的余音。
修改建议：
1. 打斗中插一句妹妹的旧物特写，锚定动机。
2. 用一处环境变化（如烛火变青）替代一段招式说明。
3. 结尾补半句低语，让悬念有"声音"。

关于"记忆与力量"的段落。

1. 「归尘族最锋利的刀，是忘了自己是谁。」——适用：主角初次全力觉醒
2. 「他们叫它力量，我们叫它告别。」——适用：长老解释归尘之力的代价
3. 「裂隙不吞人，它只是把人，还成本来的样子。」——适用：揭示灰雾本质是残魂
4. 「记住一切的人，最先死在回忆里。」——适用：主角面对抉择的低谷

七、构思 / 分析 / 发布 工具

首页「更多创作工具」展开后进入的 8 个独立模块，各自专注一类创作任务：

📌 各工具使用示例

八、手机 / 电脑云同步

本地书稿默认只存浏览器。开启云同步后，书稿会被托管到 GitHub Gist 或 Gitee 仓库，凭 Token 在多端共享——不受「公网页 vs 本地页」来源隔离影响。

第一步 · 在设置页配置（电脑端）

1. 打开 设置 → 「云同步（手机/电脑互通）」。
2. 选择平台：GitHub Gist 或 Gitee 仓库。
3. 填写对应 Token：
   • GitHub：到 Personal Access Tokens 生成，勾选 gist 权限。
   • Gitee：到 Gitee 个人设置生成私有令牌，并填写「仓库（owner/repo）+ 文件路径」。
4. （GitHub）可留空 Gist ID，首次「☁ 同步」会自动创建。
5. 可选开启「自动定时同步」，设定间隔（默认 10 分钟，后台静默上传）。

📌 举例 · GitHub Gist 配置

平台：GitHub Gist
Token：ghp_AbCdEf1234567890
Gist ID：（留空，首次同步自动建）

📌 举例 · Gitee 仓库配置

平台：Gitee 仓库
Token：你的 Gitee 私人令牌
仓库：yourname/sagebook-sync
路径：sagebook_novel.json

第二步 · 同步使用

第三步 · 在手机 / 另一台电脑

用同一浏览器打开本站 → 设置页填入相同的 Token → 点「⬇ 拉取」即可下载书稿继续写。之后各自「☁ 同步」即可互通。

九、常见问题

Q1：在公网页（sagebool.github.io）连不上本地 Ollama？

这是浏览器混合内容安全限制：HTTPS 页不能请求本地 HTTP 地址。解决：用项目里的 start-local.command / start-local.bat 起本地服务器，以 http://localhost 访问即可。

Q2：点技能 / 续写提示「未配置 AI」？

先到 设置 配置本地 Ollama 或云端 API Key 并测试通过，再回编辑器使用。

Q3：AI 调用失败 / 报错？

依次检查：① 本地 Ollama 是否在运行（ollama serve）；② 云端 Key 是否正确、额度是否充足；③ 网络是否畅通；④ 若在公网页用本地模型，参见 Q1。

Q4：我的书稿存在哪？私密吗？

默认只存在你浏览器的 localStorage，不上传任何服务器，完全私有。只有你主动开启「云同步」才会托管到 Gist/Gitee（由你的 Token 控制权限）。

Q5：换设备或换浏览器书稿看不见？

本地存储按「浏览器 + 域名」隔离，不会自动跨设备。请用第八节的云同步在设备间搬运。

Q6：误删了章节能恢复吗？

删除前有二次确认；若已确认删除，可尝试从「☁ 同步」的云端版本「⬇ 拉取」恢复（前提是之前同步过）。