Design and Implementation Records

These documents preserve design intent and implementation context. They are grouped by maintenance purpose, not by delivery date. Most records are written in the language used by the original implementation work.

The current code and tests are authoritative. Read Documentation Maintenance before treating a proposal or dated record as a current contract.

Architecture and long-lived contracts

• Avatar performance module maintenance
• Avatar tool interaction design and maintenance
• Avatar tool prompt guidelines
• Cat Mind state-machine rules
• Cat idle states
• Deep topic hooks
• LLM prompt budget
• Proactive reason-code guide
• User activity tracker
• Voice design architecture

Implemented design records

• ASR client phase record
• Compact chat mode
• Memory event journal
• User-driven memory evidence
• PNGTuber lightweight avatar
• Translation subtitle panel
• TTS provider and voice-source unification
• Live2D idle motion selection and recovery
• PNGTubeRemix layered physics compatibility

N.E.K.O 小剧场与剧本工坊

• 小剧场架构：当前唯一的实现合同——模块与权限、Story Package／Session／Ledger／记忆归档数据合同、回合流水线、复核与确定性检查、生命周期事务、胶囊展示合同与可选模块开关。
• 小剧场设计决策记录：关键取舍、被否决方案及已知风险与未验证范围。

剧本工坊 SDK 的调用、宿主与发布合同见仓库 theater_workshop/README.md。

Product-flow and interaction records

• Seven-day floating avatar guide
• Floating avatar panel functions
• Post-tutorial low-disruption chat branches
• CAT1 Playground Drop
• Focus / True-Name mode
• Memory-browser particle dissolve
• Yui guide-system cursor hiding

Security, persistence, and incident analysis

• Screen-history isolation and local references — Chinese-only. Stage 0A-1 (request-side rewrite of chained screen comments) is implemented; explicit reference selection, delivery and context isolation remain a proposal.
• Local mutation endpoint authentication
• Steam Auto-Cloud synchronization
• Telemetry distribution and Steam user ID race

Approved proposals (not yet implemented)

• Catgirl visiting infrastructure (v3, all decisions approved)
  • T1~T5 on-device measurements — Chinese-only. Implemented record (2026-10-02): same-origin iframe checks in the real Electron Pet window; all passed on Windows (one compatibility-mode T2 blank-frame run was excluded by the owner as operator interference; 0 blanks in 7,700 re-tested frames); macOS T3/T4 is still pending.

New records should state whether they are a current contract, implemented record, proposal, historical snapshot, or deprecated document near the beginning.