Folio (兰亭) v1.0.2 — Community-ready release

中文

v1.0.2（2026-08-16） 面向社区做了发布级收敛：

路径契约：发布版统一「仓库根 = 用户工作区」；根级 _cli.py 转发入口，插件 / guard / skills 的 python _cli.py 口径全部可用；.env、output、inbox、_knowledge 全部锚定仓库根。
去宿主化：运行时目录 .trae → .folio；skills 自动挂载到 .agents/skills/（DSH 识别副本）。
PPT 口径：自研 python-pptx 后端（不依赖 node）；--shots 截图才需要本机 PowerPoint。
社区基建：GitHub Actions CI（pytest + 插件 JS 自检）、Issue/PR 模板、requirements-dev.txt、真实 clone 地址、环境要求清单。
文档收敛：README / RELEASE_NOTES / CHANGELOG / 产品说明 / 白皮书 / usage 全部对齐；spec 协议文档补入发布版。

附件（本 Release）：

中文演示方案 HTML + PPTX（5 页，引擎真实生成，verify PASS）
English demo proposal HTML + PPTX (5 pages, generated by the engine, verify PASS)
产品说明 v4.0（中文）+ Product Brief v4.0 (English)

演示 spec 源文件见仓库 samples/。

v1.0.2 (2026-08-16) is the community-ready release:

One workspace contract: repo root = user workspace; root-level _cli.py shim keeps python _cli.py working everywhere.
Host-neutral runtime dir .folio (no more Trae-specific .trae); skills auto-sync to .agents/skills/ for DSH.
Self-built python-pptx PPT pipeline — Node.js not required; PowerPoint only needed for --shots.
Community infrastructure: CI (pytest + plugin JS self-checks), issue/PR templates, requirements-dev.txt, real clone URL, requirements table.
Bilingual demo outputs (HTML + PPTX) attached; source specs in samples/.