Monyeah777/NinFenz

简体中文 · English · 日本语
> 唯一官方仓库：https://github.com/Monyeah777/NinFenz ｜ npm ninfenz ｜ GitHub Packages @monyeah777/ninfenz
> 其他账号下的同名仓库均为未经授权的镜像快照，不代表本项目，也不接受 Issue/PR。
站点（线上）：https://ninfenz.dev · 机器入口 llms.txt
NF 终端（TUI）演示 —— 全屏人机入口（纯标准库）；菜单与动作是 nf CLI 真命令的受控调用方。
键位按顶尖终端约定：Tab 切面板、↑↓ 在当前面板内移动、/ 过滤、? 看键位。
演示帧文本 —— 与 --demo 渲染器逐字一致，便于检索/复制
┌ NF TUI v1.0.0 · NinFenz 内容契约层 ──────────────────────────────────────────────────────────┐
│仓库 NinFenz · 能力区 9 焦点 动作 · 就绪（0 项待办）│
├────────────────────────┬─────────────────────────────────────────────────────────────────────┤
│ 能力区 1/9 │▍ 动作 · 环境自检（2） │
│▸ 0 环境自检（2） │❯ 只读体检 nf doctor │
│ 1 一键演示世界（1） │ 体检（机器面） │
│ 2 需求 → 装配计划（2）│ │
│ 3 全链生产（2） ├─────────────────────────────────────────────────────────────────────┤
│ 4 校验与体检（4） │ 输出 · 1-3/3 · 已跟随 │
│ 5 货架与资产（4） │❯ nf doctor （退出码 0 · 0.42s） │
│ 6 管线与模块（4） │环境自检：Python 3.11 · 仓库在场 · 模块 13 · 管线 3 │
│ 7 帮助与命令面（2） │✔ 只读体检通过：无缺件 / 无越界 / 无非确定性输出 │
│ 8 写盘表单（13） │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
├────────────────────────┴─────────────────────────────────────────────────────────────────────┤
│ Tab 切面板 · ↑↓ 移动 · / 过滤 · Enter 运行 · ? 帮助 · q 退出 │
└──────────────────────────────────────────────────────────────────────────────────────────────┘
python tui/nf.py 进全屏界面；--selftest 跑安全自检，--demo 打印上面这帧，--exec "nf doctor" 是脚本面
（无 TTY 亦可：--list-actions --json 给 agent 列动作与退出码）。命令在后台线程跑，运行中 Ctrl-C 只取消该命令；
路径参数过仓库包含性判据、写盘需键入 yes 确认、密钥只从环境变量读并遮蔽显示。细节见 tui/README.md。
> 双许可（分层）· 代码 AGPL-3.0-only 或商业许可 · 协议文本 CC BY 4.0 · 见 LICENSING.md
NF 是内容契约层——定义“AI 稳定产出长内容”的协议、质量与资产标准；协议本身域中立、模型无关。
别名与检索词：NF · NinFenz · 宁封子 · 内容契约层（content contract layer）· 规范驱动的内容工厂 · 长内容生成协议 · 装配式内容生产 · 模块/管线/资产 · 质量门禁 · 域包 · MCP 接入。
不是什么：不是模型、不是提示词模板集、不是某厂商 SDK——协议本体域中立、模型无关；MCP 只是可对接的连接协议之一。
bash verify.sh（当前基线见下方生成区「质量凭证」行） · python scripts/nf.py --version
## ⚡ 如果你是 AI / Agent
这是什么：规范驱动的文档工厂，装模块/管线/资产 → 校验 → 输出。
入口链：docs/agent/AGENTSTART.md（开工）→ docs/agent/AIROUTING.md（选线）→ docs/meta/DEEPDIVE.md（懂得深）。
机器凭证：bash verify.sh（当前基线见下方生成区的「质量凭证」行，由 nf stats --write 写入）；机器入口清单见 llms.txt；语言面见 README.en.md · README.ja.md（三面的机读事实与语言切换行由 check34 的语言面扫描断言一致；注册表 = protocol/locales.json）。
要懂 NF 为什么这样设计：读 docs/meta/DEEPDIVE.md。
## 快速开始
作者/开发者，5 分钟：第一跳照 docs/quickstart.md 的 6 步逐条复制粘贴；想一条命令自检用 bash scripts/quickstartcheck.sh（判据：退出码 0 · 墙钟 ≤ 300 秒 · 文档步数 == 脚本步数）。
1. bash verify.sh
2. python scripts/nf.py shell（交互终端：端壳退役后的人机入口，见 docs/terminal.md）
3. python scripts/nf.py demo
4. python scripts/nf.py --help
5. python scripts/nf.py doctor
6. python scripts/nf.py completion bash
> 安全边界（nf verify 会执行目标仓库自带的门禁脚本）：nf verify 的引擎会在本进程内
> 执行当前仓库 verify.sh 里的内嵌 Python（CWE-94 执行面）。故只有当前运行代码所在的
> 安装根自动可信；外部仓库即使伪造官方 origin 也默认拒绝执行（退出码 2 并给修复
> 指引）。确需执行须显式 nf verify --trust-repo（风险自担）；fork/镜像可用
> NFTRUSTOWNERS 显式 opt-in。只读体检请用 bash verify.sh，或先人工审阅该仓库的
> verify.sh。详见 SECURITY.md。
AI 装配：
1. 读 docs/agent/AGENTSTART.md
2. 读 docs/agent/agent组装指令包v0.2.md
3. 按需取 01/02/06/07 与 community 包
4. 组装完整版并过 ##7 自检
5. nf assemble " " --build --dest （组装式命令：直接产「完整版」单文件）
6. nf assemble " " --check
### 常见问题（FAQ）