feat(w5): ship v2.0.0 platform sync, undo persistence, and updates

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-08 18:24:51 +08:00
parent cb6b4c3731
commit fe421ffc55
60 changed files with 2207 additions and 36 deletions
@@ -0,0 +1,47 @@
+# 笔临扩展开发指南
+
+笔临 v2.0.0 提供 **扩展 API 骨架**，用于声明第三方扩展点。当前版本**不加载或执行**第三方代码，仅校验 `manifest` 并展示占位列表。
+
+## BilinExtension 清单
+
+在扩展包的 `bilin-extension.json` 中声明：
+
+```json
+{
+  "name": "my-extension",
+  "version": "1.0.0",
+  "description": "示例扩展",
+  "main": "index.js",
+  "permissions": ["filesystem.read"],
+  "contributes": {
+    "importers": [{ "id": "myfmt", "extensions": [".mybook"], "label": "My Format" }],
+    "exporters": [{ "id": "myexport", "extensions": [".mybook"], "label": "Export My Format" }]
+  }
+}
+```
+
+## 扩展点
+
+| 扩展点 | 说明 |
+|--------|------|
+| `sidePanels` | 侧栏自定义面板 |
+| `importers` | 自定义导入格式 |
+| `exporters` | 自定义导出格式 |
+| `aiBackends` | 可选 AI 后端 |
+| `skills` | AI Skill |
+| `editorExtensions` | TipTap 节点/标记 |
+| `menuItems` | 工具栏/右键菜单 |
+
+## 安全
+
+- 扩展默认沙箱运行，需声明 `permissions`
+- 敏感权限需用户在设置中显式授权（后续版本）
+- 扩展仅能通过笔临提供的 API 与核心交互
+
+## 开发者模式
+
+设置 → 扩展 → 开启「开发者模式」后，可从本地文件夹读取 manifest 做校验（不执行 `main`）。
+
+## 相关类型
+
+见 `src/shared/extension-api.ts` 与 `src/main/services/extension-registry.ts`。
@@ -0,0 +1,78 @@
+# 笔临 Wave 5 平台基建 Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 交付 v2.0.0：撤销堆栈持久化、云同步、崩溃日志、自动更新、扩展 API 骨架、Skill/MCP 占位。
+
+**Architecture:** Schema v11 `undo_stack`；`SyncService` 加密 `.novel-all`；`electron-log` + `electron-updater`；`ExtensionRegistry` stub。
+
+**Tech Stack:** Electron 36、electron-log、electron-updater、Vitest、Playwright
+
+**Spec:** `docs/superpowers/specs/2026-07-08-bilin-master-completion-design.md` §9
+
+**Master Program:** Wave 5/5 → v2.0.0
+
+---
+
+## File Map
+
+| 文件 | 职责 |
+|------|------|
+| `src/main/db/schema-v11.sql` | undo_stack |
+| `src/main/services/undo-stack.service.ts` | 持久化撤销 |
+| `src/main/services/sync.service.ts` | 本地/WebDAV 同步 |
+| `src/main/services/log.service.ts` | electron-log |
+| `src/main/services/update.service.ts` | electron-updater |
+| `src/main/services/extension-registry.ts` | 扩展注册表 stub |
+| `src/shared/extension-api.ts` | BilinExtension 类型 |
+| `src/renderer/components/settings/SyncSettingsTab.tsx` | 备份与同步 |
+| `e2e/timeline.spec.ts` | E2E-TL-01~03 |
+
+---
+
+## Task 1: Schema v11 + 撤销堆栈
+
+- [x] **Step 1:** schema-v11 + migrate v11
+- [x] **Step 2:** UndoStackRepository + Service + IPC
+- [x] **Step 3:** TipTap 防抖持久化 + 跨会话 Ctrl+Z
+- [x] **Step 4:** E2E-UNDO-01
+
+---
+
+## Task 2: 云同步
+
+- [x] **Step 1:** sync-crypto AES-256-GCM
+- [x] **Step 2:** SyncService local-folder + WebDAV
+- [x] **Step 3:** SyncSettingsTab + 冲突模态
+- [x] **Step 4:** IT-SYNC-01 + E2E-SYNC-01
+
+---
+
+## Task 3: 日志与崩溃报告
+
+- [x] **Step 1:** LogService + 启动检测
+- [x] **Step 2:** 发送报告 stub + UT-LOG-01
+
+---
+
+## Task 4: 自动更新
+
+- [x] **Step 1:** UpdateService + IPC 事件
+- [x] **Step 2:** 顶栏更新提示（BILIN_E2E 禁用 / BILIN_MOCK_UPDATE mock）
+- [x] **Step 3:** IT-UPDATE-01 + E2E-UPDATE-02
+
+---
+
+## Task 5: 扩展 API + Skill/MCP
+
+- [x] **Step 1:** extension-api.ts + registry stub
+- [x] **Step 2:** docs/extensions/README.md
+- [x] **Step 3:** ExtensionsSettingsTab + AI Skill/MCP 占位
+
+---
+
+## Task 6: i18n + v2.0.0
+
+- [x] **Step 1:** app.getLocale 首次语言
+- [x] **Step 2:** 全量 test + E2E
+- [x] **Step 3:** 版本 **v2.0.0**