前言¶
做玻璃橱窗、展柜或透明投影屏方案时，常见流程是：先估环境照度与画面面积，再反推流明、选膜增益、核对投射比和安装距离，最后拼一版报价。这些步骤分散在表格、产品册和口头经验里，Agent 若缺少固定公式与产品线约束，容易混用不同算法或漏掉经销商政策里的边界条件。
下面介绍 SkillHub 上的 NanoAR投影光学显示方案（坐标 @user_78038b51/nanoar-projector-advisor，版本 1.0.0）。它把 nanoAR 透明投影膜参数、光学计算 SOP、投影机推荐库和报价单导出流程写进通用 SKILL.md，让支持 Skills 的编码助手在相关对话里按同一套规则作答。
这是什么¶
NanoAR投影光学显示方案（包内名 nanoar-projector-advisor）是社区来源（community）的 professional 类 Agent Skill，由 SkillHub 用户 user_78038b51 发布；SkillHub 页面标注作者为「蓝莓胖子」。标签显示 不需要 API Key（requires_api_key=false）。
一句话定位：面向 投影机选型、亮度计算、透明投影膜（光子晶体膜）参数、nanoAR 报价与经销商政策、玻璃橱窗/展柜方案 等话题，自动加载规则并输出可复核的计算过程与方案结构。
核心功能¶
以下内容均来自该 Skill 的 SKILL.md 及同包参考文件，为 Agent 被触发后的行为规范，而非独立 SaaS 接口。
触发场景¶
当对话涉及例如：投影机选型或推荐、投影亮度/流明计算、透明投影膜（增益、透过率）、nanoAR 产品报价或经销商政策、玻璃橱窗/展柜/透明屏幕方案时，应加载本 Skill。
固定光学公式¶
Skill 要求 不得用其他公式替代，默认对比度按 10:1，且 默认不额外加工程余量（仅当用户明确要求时才单独加安全余量）：
P_lux = E_lux × 10 # 屏幕前照度 = 环境照度 × 10
Lm = P_lux × S # 所需流明 = 屏幕前照度 × 画面面积（㎡）
B_nit = P_lux × G / π # 画面亮度（nit），G 为屏幕增益
投影距离 = 画面宽度（m） × 投射比
计算 SOP¶
用户提供场景参数后，按顺序：确认画面尺寸（宽已知时可按 16:9 推高度）→ 算面积 → 算 P_lux → 算流明需求 → 向上取整到 500lm 档位 → 查 references/projector_db_summary.md 推荐机型 → 用对应膜型号增益核算 B_nit → 给出投影距离建议。
nanoAR 膜产品线摘要¶
Skill 内嵌 A/B/C 系列型号表（如 A 系列 38D、2KD；B 系列 HB1；C 系列 C1H、C3T），含增益、透过率、视角与适用场景，并给出选膜优先级说明（普通商业室内优先 A 系列；垂直安装考虑 HB1；强光或高亮定向场景考虑 C 系列）。
报价与经销商政策¶
包含膜材供货价档位（A/B 级、合资公司、终端市场参考价）、保证金与年采购要求、项目备案保护期（如 A 级 180 天、B 级 90 天）等要点，供方案说明与商务边界引用。
方案输出与 Excel 报价单¶
用户要「推荐方案」「出一版方案」时，标准输出应包含：计算过程（公式+数值）、推荐膜型号及理由、推荐投影机（亮度、价格、投射比）、系统总造价估算、安装与角度等注意事项；输出后 主动询问 是否按模板导出 Excel。
确认导出时：使用 templates/光子透明屏项目报价单_Template_V1.1.xlsx，不改动版式，映射规则见 references/quote_template_mapping.md，通过 scripts/generate_quote_from_template.py 生成；未指定路径时默认 D:\99Downloads\WorkBuddy，文件名 报价单_<项目名>_<日期>.xlsx。报价日期默认为执行当天，有效期为报价日期 + 30 天。
包内还提供 scripts/calc_projector.py，可在本地用命令行做与 SOP 一致的辅助计算（需 Python 3）。
安装与启用¶
SkillHub 官方页面给出的安装提示是：参照 SkillHub 安装说明，安装坐标 @user_78038b51/nanoar-projector-advisor。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向 当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install @user_78038b51/nanoar-projector-advisor --dir <你的 skills 目录>
常见路径（以 SkillHub 文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后按你所用客户端的要求 重启或重新加载 Agent，使 SKILL.md 生效。
典型用法¶
在已启用该 Skill 的对话中，可直接用自然语言给出场景参数。Skill 文档中的示例如下。
用户输入：「商场橱窗，玻璃2m×1.5m，环境光 300lux，推荐方案」
期望的结构化输出：
- 计算过程（列公式与代入数值）
- 推荐膜型号（含理由）
- 推荐投影机（亮度、价格、投射比）
- 系统总造价估算
- 注意事项（安装距离、角度等）
- 追问是否需要导出 Excel 报价单
若需在本地脚本侧验算，可进入 Skill 目录查看 scripts/calc_projector.py 的参数说明后运行（具体子命令以脚本内 argparse 为准）。
适用场景与注意¶
适合谁：透明屏/橱窗集成商、展陈设计、需要把光学计算与 nanoAR 膜材、投影机库、报价模板绑在同一工作流里的开发者或售前工程师；希望在 Cursor、Claude Code、Codex 等支持 Skills 的环境里复用同一套 SOP 的团队。
限制与注意：
- 能力边界由
SKILL.md与references/、templates/定义；投影机列表、映射表更新需随 Skill 包版本维护，文中未写的机型或价格不应臆测。 - 默认光学计算 不加工程余量；现场眩光、膜污损、多台拼接等需用户明确提出再调整。
- Excel 默认导出路径为 Windows 盘符
D:\99Downloads\WorkBuddy；在 Linux/macOS 上应让用户指定输出目录或改脚本调用参数。 - SkillHub 统计（截至页面与抓取资料）：评分 100000，下载约 885 次，安装约 4 次；与第三方转载数据不一致时以 SkillHub 为准。
结尾¶
NanoAR投影光学显示方案 把透明投影场景的光学公式、选型步骤、膜材与商务政策、报价单导出流程固化成 Agent 可执行的 Skill，适合在编码助手对话里做可复核的方案推演。官方 SkillHub 页面：https://www.skillhub.cn/skills/user_78038b51/nanoar-projector-advisor；API 入口：https://api.skillhub.cn/user_78038b51/nanoar-projector-advisor。
