nex_shift/docs
mula.liu ef68121aeb docs: record the release's constraints in the ledger and the READMEs
Three ledger sections, the 0.1.12 version row, and the user-facing lines
they describe.

「Windows 一键安装运行组件」is the fullest of them: four independent defects
hid in ten lines, and each one reads as "安装失败" from the UI, so the
section records which signal decides the outcome (exit code first, prose
only to break a tie) and why the attempt ladder starts on the command line
0.1.11 already sent.

「钉图窗口的放大与还原」and 「闲置时的取样节奏」record constraints that are
invisible in the code and easy to simplify back into a bug: sizing off
`monitor.size()` instead of the work area, mixing logical and physical
pixels between `set_size` and `set_position`, making a silent Shift copy
deaf in order to save 0.03%, and restoring `default_window_icon()` on the
tray because the colour wheel looked friendlier in the source.

Co-Authored-By: Codex <noreply@openai.com>
2026-11-19 17:52:01 +08:00
..
ARCHITECTURE.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
BUILD_WINDOWS.md release: prepare Shift 0.1.8 2026-10-27 18:45:32 +08:00
ENGINEERING-NOTES.md docs: record the release's constraints in the ledger and the READMEs 2026-11-19 17:52:01 +08:00
MOBILE.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
README.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
RELEASE.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
ROADMAP.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
SECURITY.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
SPECIFICATION.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00

README.md

Shift documentation

Start with the user guide, then choose the engineering document that matches the work.

Document Audience Contents
../README.md / ../README.zh-CN.md Users Features, formats, shortcuts, privacy, known limitations
ARCHITECTURE.md Contributors Process/window model, module ownership, events, data flows
SPECIFICATION.md Product and QA Observable behaviour, naming, limits, acceptance criteria
SECURITY.md Security reviewers and maintainers Trust boundaries, update and LAN risk, residual gaps
ENGINEERING-NOTES.md Contributors Regression ledger and non-negotiable implementation constraints
RELEASE.md Release maintainers Channel layout, signing, update handoff and verification
BUILD_WINDOWS.md Builders Windows prerequisites, cross-build and installer notes
ROADMAP.md Contributors Completed milestones and next desktop work
MOBILE.md Product planning Mobile feasibility and architecture plan
../CONTRIBUTING.md Contributors Setup, checks, change rules and manual matrix

Source of truth

  • Current code and tests define implemented behavior.
  • The conversion/tool tables in README describe the user-visible catalogue; the runtime catalogue lives in src/lib/conversionFormats.ts and src/lib/radialOrder.ts.
  • Platform/runtime limitations must be stated as unverified when no real hardware run exists.
  • Do not claim a CI run without linking its log.