# 笔临 (Bilin)

长篇创作智能协作平台 — Electron 桌面客户端 v2.0.0（平台基建）

## 功能概览（v2.0.0）

- 撤销堆栈持久化：每章最多 50 条，跨会话 Ctrl+Z
- 云同步：加密 `.novel-all` → WebDAV / 本地目录
- 崩溃日志：`electron-log` + 异常退出提示
- 自动更新：`electron-updater`（E2E 模式禁用）
- 扩展 API 骨架、内置 Skill / MCP 占位

## 功能概览（v1.5.0）

- 故事时间线：章节/手动事件聚合、角色出生年冲突检测
- 角色弧线：设定 Tab 聚合知识库节点
- 敏感词合规：本地词库 + 编辑器波浪下划线
- 引用详情抽屉、章节悬停预览、自定义 AI 快捷命令

## 功能概览（v1.4.0）

- 导出矩阵：章/卷/全书 → txt、md、docx（含目录）、pdf（A4）
- 连续阅读模式：设备宽度、字体主题、虚拟 3 章翻页
- 驾驶舱今日大纲任务、专注模式环境音效

## 功能概览（v1.3.0）

- `.novel` 单书项目包导出/导入（含数据库、元数据、附件）
- `.novel-all` 批量导出/导入全部书籍与全局设置
- 主页「导出所有书籍」、设置页备份区、导出模态项目包选项
- 大文件导出确认与进度推送

## 功能概览（v1.2.0）

- 书籍设置：书名/分类/目标字数/简介/封面、驾驶舱偏好、删书
- 分卷右键管理、章节双击改名/删除、章节元数据与标签
- 模板变量自动填充（含大纲项与角色列表）
- AI 会话重命名/归档/导出/删除
- 专注模式快捷键、TTS 朗读、顶栏日更进度条

## 功能概览（v1.1.0）

- 章节模板与快速新建章（§10）
- 导入 txt / md / docx 并自动分章（§11.1）
- 投稿预设与单章导出（复制剪贴板 / 存 txt）（§20.2）
- 全局灵感捕获增强：任意界面快捷键、未开书可选书、保存仅 toast（§20.6）

## 功能概览（v1.0.0）

- 角色关系图谱：Cytoscape 可视化、设定面板关系 CRUD、三种布局（P7）
- 个人写作分析：今日字速、时段热力、POV/卷分布、近 7 日趋势（P9）
- 章节视角（POV）选择与驾驶舱内嵌分析区
- AI 章节知识自动抽取、合并审核、高置信度批量采纳（P5.2）
- 知识库 AI 上下文：半自动推荐 + 勾选注入四种写作模式（P6）
- 驾驶舱：全书/本卷字数、存稿缓冲、伏笔摘要、快速入口（P5）
- 知识库 MVP：手动条目、审核流、伏笔追踪、地标同步（P5）
- 章间衔接：上下章片段 + 可选 AI 建议（P5）
- 更新计划：发布状态、存稿阈值提醒（P5）
- 自动写作：章节目标、场景规划、连续生成、暂停转交互（P4.1）
- 向导式写作：5 步引导、策略预览、生成后交互微调（P4.1）
- 交互式写作：剧情走向建议、场景生成、命名暂停、微调确认、成章落盘（P4）
- 章节拖拽、全局搜索替换、灵感捕获、`@` 跳转、引用钉住（P2.1）
- AI 对话助手：会话持久化、流式输出、上下文编辑、快捷命令（P3）
- AI 设置页、命名一致性检查、离线降级、AI 快照（P3）

## 开发

```bash
npm install --legacy-peer-deps
npm run dev
```

数据库使用 Node.js 内置 `node:sqlite`（无需原生模块编译）。

## 测试

```bash
npm run build
npm run test:release   # 发布前快速门禁：build + 导入/产物检查 + 启动冒烟 E2E
npm run test           # 全量单元/集成（含 LM Studio 十章小说 IT，耗时长）
npm run test:ci        # 完整 CI：build + 全量 UT/IT + 全量 E2E
npm run test:e2e       # 仅 E2E（需先 build）
```

**AI 相关测试前置条件**：本地 [LM Studio](http://127.0.0.1:1234) 需运行，模型默认 `gemma-4-e4b-it`（可通过环境变量 `BILIN_AI_MODEL` / `BILIN_AI_BASE_URL` 覆盖）。

## 文档

- P5 作家工作流 + 知识库设计规格：`docs/superpowers/specs/2026-07-06-bilin-p5-workflow-knowledge-design.md`
- P5 实现计划：`docs/superpowers/plans/2026-07-06-bilin-p5-workflow-knowledge.md`
- P4.1 自动/向导写作设计规格：`docs/superpowers/specs/2026-07-09-bilin-p41-auto-wizard-design.md`
- P4.1 实现计划：`docs/superpowers/plans/2026-07-09-bilin-p41-auto-wizard.md`
- P4 交互式写作设计规格：`docs/superpowers/specs/2026-07-08-bilin-p4-interactive-design.md`
- P4 实现计划：`docs/superpowers/plans/2026-07-08-bilin-p4-interactive.md`
- P2.1 + P3 设计规格：`docs/superpowers/specs/2026-07-07-bilin-p21-p3-design.md`
- P2.1 + P3 实现计划：`docs/superpowers/plans/2026-07-07-bilin-p21-p3.md`
- P2 设计规格：`docs/superpowers/specs/2026-07-06-bilin-p2-design.md`
- UI 原型：`design/ui_pc.html`