react-principles

用途：为 React 组件、自定义 Hook 的编写、评审与重构提供一套实践准则。主要能力：一是组件模型约定，组件视为纯函数 (props, state) → JSX，渲染阶段无副作用，数据单向流动，父传子用 props、子传父用回调，禁止就地修改 state 或 props；二是设计流程，按单一职责拆解层级，先把数据模型形状映射到组件树，静态阶段只用 props，保持最小状态，把状态提升到所有使用者的最近公共祖先，并把 setter/handler 下传；三是明确什么不是状态，能从现有 state 或 props 计算、作为 prop 传入、长期不变的值都不应作为状态，优先存 ID 等原始值、渲染时再推导对象；四是 Effect 纪律，useEffect 只用于与外部系统同步，如 DOM API、网络连接、第三方组件、浏览器订阅，不是生命周期钩子，也不是数据转换管道。资料还给出判断方法与反模式替换表，例如用渲染期计算替代 Effect 派生状态、用 key 重置状态、用事件处理器替代 Effect 中发起的 POST、用 useSyncExternalStore 替代 Effect 订阅外部 store；并要求依赖数组包含所有响应式值、不得抑制 react-hooks/exhaustive-deps、setup 获取的资源须在 cleanup 释放、一个 Effect 只负责一项同步关注点。附带参考文件 references/not-need.md、lifecycle.md、separating.md、dependencies.md、reusing.md 分别对应消除多余 Effect、Effect 生命周期与依赖契约、事件处理器与 Effect 的区分及 useEffectEvent、依赖精简与稳定、自定义 Hook 抽取。适用场景：编写或评审组件时判断状态归属、是否该写 Effect，以及重构副作用代码。限制：资料未提供安装命令、运行方式、平台与授权信息。