# 笔临 (Bilin)

长篇创作智能协作平台 — Electron 桌面客户端 v1.0.0（P7 角色关系图谱 + P9 个人写作分析）

## 功能概览（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      # 单元 / 集成测试
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`