Files
bilin/README.md
bing 958bb18539 fix(ui): make chapter bridge manual-only and add release gate
Remove auto chapter-bridge prompt on book/chapter open so users trigger it from the cockpit. Fix AiPanel duplicate import that broke dev builds, and add release smoke tests plus test:release/test:ci scripts.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-09 19:09:18 +08:00

99 lines
4.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 笔临 (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(含目录)、pdfA4
- 连续阅读模式:设备宽度、字体主题、虚拟 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 # 完整 CIbuild + 全量 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`