# 笔临 (Bilin)

长篇创作智能协作平台 — Electron 桌面客户端 v0.5.0（P4.1 自动 + 向导写作）

## 功能概览（v0.5.0）

- 自动写作：章节目标、场景规划、连续生成、暂停转交互（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      # 单元 / 集成测试
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` 覆盖）。

## 文档

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