半窗 Halfpane

Halfpane（半窗）is a local-first writing workspace for Chinese long-form fiction.

Current status: Phase 0 engineering foundation.

This repository is intentionally narrow right now. It validates the desktop shell, local data model, migration tests, and project documentation before introducing AI-assisted writing workflows.

Product direction

Halfpane is designed to become a quiet, writing-first desktop workspace for long-form novel projects.

Long-term product loop:

1. 创作规划
2. 正文写作
3. AI 审稿
4. 修订候选
5. 待确认设定
6. 故事圣经入库
7. 伏笔和连续性维护
8. 备份恢复

The author remains in control. AI suggestions must not silently become confirmed story facts.

Current scope

Phase 0 includes:

1. Tauri + React + TypeScript desktop shell
2. SQLite v0 schema
3. migration smoke tests from an empty database
4. pre-reserved model configuration table for later AI assistant integration
5. minimal writing-focused UI shell
6. documentation for future review, Story Bible, quality gate, and workflow boundaries

Phase 0 explicitly does not include:

1. real AI integration
2. AI review
3. AI prose generation
4. automatic Story Bible updates
5. full editor business flow
6. login, membership, cloud sync, marketplace, or publishing workflows
7. plugin or MCP execution
8. complex theme system or marketing homepage

Tech stack

1. Tauri 2
2. React 19
3. TypeScript
4. Vite
5. SQLite through Rust-side migration tests

Quick start

Install dependencies:

npm install

Run the development server:

npm run dev

Build the frontend:

npm run build

Run migration checks:

npm run test:migration
npm run test:migration:node

Quality gate

Before calling a non-trivial change complete, run the relevant checks from docs/quality-gate.md.

Current baseline commands:

npm run build
npm run test:migration
npm run test:migration:node

There is currently no lint script and no standalone typecheck script. npm run build runs tsc && vite build.

Documentation map

Start here:

docs/README.md

Important documents:

File	Purpose
docs/project-context.md	Short project context for new sessions and agents
docs/phase-roadmap.md	Phase boundaries and build order
docs/quality-gate.md	Local and CI quality gates
docs/development-skill-map.md	Skill and development workflow routing
docs/multi-agent-workflow.md	Lightweight HanaAgent development loop
docs/database-schema-v0.sql	Current SQLite schema
docs/ui-theme-direction.md	UI visual direction
docs/review-workflow-spec.md	Future review and Gate workflow
docs/knowledge-story-bible-spec.md	Future Story Bible and knowledge governance workflow
docs/source-materials/	Archived original source materials

GitHub Actions

The repository includes a basic Windows CI workflow:

.github/workflows/ci.yml

It runs:

1. npm ci
2. npm run build
3. npm run test:migration
4. npm run test:migration:node

Current next best slices

Recommended near-term work:

1. manual Story Bible entry list
2. chapter card persistence
3. migration smoke test improvements
4. basic search over confirmed project records
5. manual review issue and proposed change flow

Avoid using early slices for:

1. real AI review
2. full editor rewrite
3. plugin runtime
4. custom multi-agent orchestrator
5. cloud sync or membership

License

No open-source license has been selected yet. Unless a license is added, all rights are reserved by default.