cli-calctool 0.1.0

package/skills/calctool/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: calctool
+description: 按需生成「万能计算工具」：用户输入一个领域需求（如"我是财务，想要一个经营健康诊断工具"），本技能通过提问明确指标、公式、输入方式与输出形式，生成一个可执行、可验证、可发布的在线计算工具——支持自定义指标、自定义公式逻辑、用户上传内容自动识别（Excel 映射 / 图片 OCR）、报告输出。当用户想"把某套计算逻辑/指标/公式做成在线工具"时使用。
+---
+
+# calctool
+
+把「业务计算逻辑」编译为「可执行的在线计算工具」的生成器。
+
+## 全链路总流程（老板视角 → 可运行工具）
+
+```
+老板（任何 IDE / DSH）："我要搭电商运营计算工具"
+  ↓
+1. 顾问式对话（intake-round）   —— 智能体主动给方案（基于领域参考包），
+   老板逐轮确认指标/公式/口径，直到说"创建"
+  ↓
+2. 情报蜂群（research）        —— 自动派情报智能体搜索行业标准/抓指定地址，
+   产出可溯源参考包（老板说"电商"等关键词时自动触发）
+  ↓
+3. 蜂群执行（brain-invoke/complete）—— 需求自动拆解为 fields/formulas/rules/
+   imports/reports/pages 任务，依赖图驱动并行，独立复核，确定性合并
+  ↓
+4. 编译工具（compile-tool）    —— 引擎定义 → 可运行工程文件清单
+   （App 壳/公式引擎/存储/构建，页面自动生成：录入/指标卡/报告）
+  ↓
+5. 环境适配（probe-env/adapt-config）—— 自动探测 Node 版本/包管理器/OS/架构，
+   Node≥18 全功能、16 兼容(sql.js)、<16 零构建预览；pnpm/yarn/npm 自动适配
+  ↓
+6. 完成前门禁（final-gate）      —— 审计/测试/运维三智能体协调接管检测，
+   全部符合通过（engine-valid / 基准样例全通过 / 环境就绪）才标记完成
+  ↓
+7. 交付运行                     —— 按适配命令一键搭建（pnpm install → pnpm run dev）
+   → 老板得到可交互工具；后续对话继续改指标/公式（热更新）
+
+或直接走「全自动流水线」（auto-pipeline）——老板只需说需求 + 授权一次：
+  授权(告知消耗) → 情报蜂群 → 蜂群生成 → 测试审计 → 编译 → 自动启动弹出页面
+  → 完成前门禁（审计/测试/运维三智能体协调接管，全部符合通过才标记完成）
+  全程无需老板参与，热更新即时生效
+```
+
+**关键**：老板一句话 → 对话确认 → 情报 → 蜂群 → 编译 → 环境适配 → **可运行工具**。全程框架不变，需求变更只改配置。
+
+## 何时使用
+
+- 用户描述了一个领域场景（财务、运营、工程、教育、医疗……）并想要一个可交互的在线计算工具
+- 用户已有指标、公式、评分或报告逻辑，想固化成工具
+- 用户需要"自定义指标 + 自定义公式 + 上传识别"能力
+
+不要用于：纯展示型页面（无计算）、与计算无关的 CRUD 后台。
+
+## 核心原则
+
+1. **确定性计算**：正式数字由版本化确定性引擎（公式 AST + Decimal 运行时）产生；模型/OCR/AI 只产生候选、草稿与解释，绝不直接给出不可追溯的正式结果。
+2. **配置化而非代码化**：工具 = 一份可发布的引擎定义（字段目录 + 公式图 + 规则包 + 导入映射 + 视图 + 报告），不是散落的页面代码。
+3. **显式除零**：所有除法必须选 `div`（除零报错）或 `safeDivide`（除零回退），不静默吞错。
+4. **零虚构**：能力未接入时保持"未接入态"（planned/not_installed/disconnected），不虚构数据、状态或按钮。
+
+## 五步实施流程
+
+### 1. intake —— 收集需求（必须提问，一次一问）
+调用运行时 intake 或按下面问题逐条问用户：
+- 目标：这个工具帮用户完成什么？什么必须发生、什么绝不允许发生？
+- 输入指标：用户会输入哪些字段？（如收入、成本、人数、月份）
+- 公式逻辑：哪些指标由公式算出？（如毛利 = 收入 - 成本）
+- 输入方式：手工录入 / Excel 上传 / 图片 OCR / 三者都要？
+- 输出形式：指标卡、表格、诊断报告、历史记录？
+- 约束：单位、精度、语言、离线/在线、禁止项？
+
+### 2. 生成引擎定义（Engine Definition）
+```yaml
+engineId: <kebab-case-引擎名>
+name: <显示名>
+category: <领域，如 finance/operations/education>
+ownerType: platform-template
+status: draft
+semanticVersion: 1.0.0
+compatibilityProfile: legacy-compatible
+decimalPolicy: decimal-string
+defaultLocale: zh-CN
+```
+包含（详见 references/engine-meta-model.md）：
+- field-catalog：字段目录（类型：amount/ratio/int/enum/dimension/date）
+- formula-graph：公式图（节点 = 字段/公式，边 = 依赖）
+- rule-packs：规则包（阈值、评分、分级）
+- import-profiles：导入映射（Excel 列 / OCR 字段 → 字段目录）
+- report-template：报告模板（指标卡 + 表格 + 诊断结论）
+
+### 3. 编译公式（详见 references/formula-dsl.md）
+- 把自然语言/Excel 公式编译为 JSON AST（禁止 eval/new Function）
+- 运算符走最小注册表（add/sub/mul/div/safeDivide/percentOf/if/case/sum/avg/lookup…）
+- 数值用 Decimal 字符串，单位编译期推断，错误结构化传播
+- 发布前跑依赖图检查：引用存在、无环、可见范围
+
+### 4. 生成在线工具（详见 references/declarative-pages.md）
+- 表单页：录入字段（按 field-catalog 自动生成）
+- 指标卡页：公式结果 StatGrid
+- 报告页：结构化输出 + 可导出
+- 页面用声明式规格（ApplicationPageSpec），不手写重复模板
+
+### 5. 验收与发布
+- validate：确定性校验引擎定义（引用闭合、无环、单位一致、测试通过）
+- 上传识别走导入 Profile（Excel 映射 + OCR 草稿确认，自动导入先进草稿）
+- **完成前门禁（final-gate）**：每次项目完成之前，审计/测试/运维三智能体协调接管检测——
+  - **审计智能体**：引擎定义确定性校验 0 findings、公式仅走受控 AST（禁 eval）、引用闭合
+  - **测试智能体**：基准样例（testSuites）全部通过，一个不过都不放行
+  - **运维智能体**：环境探测成功、依赖分级适配、安装/启动命令可用、热更新就绪
+  - 三智能体全部符合通过（gate passed）才标记完成；任一未通过返回 findings，修复后重新接管检测
+- 发布为版本化引擎，任何公式/字段/阈值变化都创建新版本，不原地修改
+- 输出：可运行的在线工具 + 引擎定义包 + 验收报告 + 完成前门禁结论
+
+## 多智能体蜂群模式（大脑协同，推荐复杂工具用）
+
+单智能体 `compile-inline` 适合简单工具；复杂工具（多字段 + 多公式 + 规则 + 导入 + 报告）用**蜂群协同**，多智能体并行生成、独立复核、确定性合并——准确率更高、产出更强。
+
+### 大脑模式（brain-handshake）
+- `ide`：用当前 IDE 的多智能体（subagent）执行蜂群（默认）
+- `hermes_local`：用用户本地安装的 Hermes 执行蜂群
+
+### 蜂群流程（协议 calctool.coordinator.run-plan/1.0）
+
+1. **brain-handshake**：协商大脑模式（ide/hermes_local），返回蜂群能力
+2. **brain-invoke**：传需求 → **自动拆解**为蜂群任务（按需派发，需要几个派几个）：
+   - `fields` 字段目录（入口，总是有）
+   - `formulas` 公式图（有公式才派）· 独立复核
+   - `rules` 规则包（有规则才派）· 独立复核
+   - `imports` 导入映射（有导入才派）
+   - `reports` 报告模板（有报告才派）
+   - `pages` 页面规格（总是有）
+   依赖图驱动：fields 先 → formulas/imports 并行 → reports → pages；maxParallel 控制并发
+3. **brain-invoke 批量派发**：每个就绪 work item 派给一个独立智能体，收集产物
+4. **brain-events / brain-status**：流式收集事件、查询蜂群状态（就绪/运行/阻塞）
+5. **brain-complete**：提交全部产物 → **确定性合并**为引擎定义 → 校验 → 发布
+6. **brain-cancel**：随时取消蜂群
+
+### 准确率与用户控制
+- **准确率**：合并后引擎定义必须通过确定性校验（引用闭合/公式链/单位/Decimal/无环），0 findings 才发布
+- **用户控制**：每一步产物可查看、修改、重试（budget.maxAttempts）；最终工具可测算、改公式、调阈值
+- **编程能力**：蜂群产物是真实可编译的引擎定义（JSON AST + Decimal 运行时），不是伪代码
+
+## 输出产物
+
+```
+<engine-id>/
+├── manifest.yaml           # 引擎身份与版本
+├── field-catalog.json      # 字段目录
+├── formula-graph.json      # 公式图（AST）
+├── rule-packs.json         # 规则包
+├── import-profiles.json    # 导入映射
+├── report-template.json    # 报告模板
+└── tests/                  # 确定性测试（样例 → 期望结果）
+```
+
+## 参考文档
+
+- `references/engine-meta-model.md` —— 引擎元模型（字段/公式/规则/导入/报告）
+- `references/formula-dsl.md` —— 公式 DSL 与运行时（AST/Decimal/依赖图/错误值）
+- `references/declarative-pages.md` —— 声明式页面规格系统（表单/指标/报告渲染）
+- `references/import-ocr.md` —— 导入与 OCR（Excel 映射/图片识别/草稿确认）
+- `references/finance-example.md` —— 经营健康诊断完整范例（50 字段 → 10 指标 → 报告）
+
+## 安全规则
+
+- 不执行任意 JavaScript；公式只走受控 AST
+- 上传文件先验证类型/大小/指纹，OCR 结果进草稿不覆盖正式数据
+- 不虚构后端数据；未接入能力显示真实状态
+- 财务/税务输出需明确"经营估算模型，生产使用前由专业人员复核"

package/skills/calctool/install-meta.json

@@ -0,0 +1,7 @@
+{
+  "source": "KKyA6xljUX",
+  "slug": "calctool",
+  "version": "v0.3.0",
+  "endpoint": "https://cli.tax/api/public/skills/KKyA6xljUX",
+  "installedAt": "2026-08-17T00:00:00.000Z"
+}

package/skills/calctool/platform-template/README.md

@@ -0,0 +1,74 @@
+# calctool 平台模板
+
+由 calctool 生成的**可运行计算工具**工程模板（配置驱动、框架不变）。
+
+## 一键运行
+
+```bash
+npm install        # 或 pnpm install / yarn install（环境自动适配）
+npm run dev        # 启动开发服务器 http://localhost:5173
+```
+
+## 结构
+
+```
+├── src/
+│   ├── main.tsx                    # 入口（Ant Design X ConfigProvider）
+│   ├── App.tsx                     # 应用壳（录入/指标卡/链路/报告/授权 五页）
+│   ├── engine-definition.json      # ★ 引擎定义 + 链路（改这里 = 改工具，框架不动）
+│   ├── engine/
+│   │   ├── evaluate.ts             # JSON AST + decimal.js 确定性求值
+│   │   └── (recompute.ts 依赖图增量重算，按需扩展)
+│   ├── pipeline.ts                 # ★ 链路编排（联通节点，非单页孤岛）
+│   ├── authz.ts                    # ★ 授权管理（首次使用同意 + 逐能力授权，一次授权持久化）
+│   └── store.ts                    # 存储层（localStorage，可换 sqlite）
+├── vite.config.ts
+└── package.json
+```
+
+## 整套工具（联通节点，非单页孤岛）
+
+工具由**联通节点**组成，数据流在节点间流动：
+
+```
+录入/导入 → 数据校验 → 确定性计算 → 数据存储 → 指标卡/报告
+                                    ↘ 自动化（可选）
+```
+
+- 改动指标/公式：只改 `engine-definition.json`，链路自动感知
+- 新增能力：在 `pipeline.ts` 加节点（如导入、导出、告警），页面无需改
+- 页面「链路」Tab 可视化每个节点及其上下游，改工具时定位影响范围
+
+## 授权与消耗提示
+
+1. **首次使用总提示**：打开工具时弹窗告知"可能调用其他技能辅助、可能增加消耗"，同意后持久化不再提示（可按工具分别记录）
+2. **逐能力授权**：实际调用外部能力（Blueprint/搜索/模型/存储/自动化）前询问，一次授权永久记住
+3. **授权管理页**：随时查看已授权能力、撤销授权
+
+
+## 改指标/公式（需求变更，框架不变）
+
+编辑 `src/engine-definition.json`：
+
+```json
+{
+  "fields": [{ "key": "visitors", "label": "访客数", "type": "integer", "unit": "人" }],
+  "formulas": [
+    { "key": "conversionRate", "label": "转化率",
+      "expression": { "op": "safeDivide", "args": [{ "ref": "orders" }, { "ref": "visitors" }] } }
+  ]
+}
+```
+
+保存即热更新——**不用改任何代码**。
+
+## 公式运算符（详见 formula-dsl.md）
+
+`add / sub / mul / div（除零报错）/ safeDivide（除零回退）/ percentOf / round / if / ref / lit`
+
+## 环境适配
+
+- Node ≥18：全功能（可换 better-sqlite3 持久化）
+- Node 16：兼容（sql.js WASM）
+- Node <16：建议只用 L0 配置预览
+- 包管理器：npm/pnpm/yarn 命令自动适配

package/skills/calctool/platform-template/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>calctool 计算工具</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/skills/calctool/platform-template/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "calctool-tool",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "description": "calctool 生成的可运行计算工具（配置驱动，Ant Design X + decimal.js）",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "antd": "^6.0.0",
+    "@ant-design/x": "^2.9.0",
+    "decimal.js": "^10.4.3",
+    "lucide-react": "^0.469.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.4",
+    "typescript": "^5.6.0",
+    "vite": "^6.0.0"
+  }
+}

package/skills/calctool/platform-template/src/App.tsx

@@ -0,0 +1,233 @@
+// calctool 生成的可运行工具：整套工具（联通节点，非单页孤岛）
+// 链路：录入 → 校验 → 计算 → 存储 → 输出（+ 自动化）
+// 调用外部能力前必须授权（一次授权持久化，不再提示）
+import { useEffect, useState } from 'react'
+import { Alert, Button, Card, Form, Input, InputNumber, message, Modal, Segmented, Space, Statistic, Table, Tag, Typography } from 'antd'
+import { evaluateEngine } from './engine/evaluate'
+import { ToolStore } from './store'
+import { authz, OnboardingConsent, type CapabilityKind } from './authz'
+import { defaultPipeline, nodeNeighbors, type EngineDefinition } from './pipeline'
+import engine from './engine-definition.json'
+
+const { Title, Paragraph, Text } = Typography
+
+const def = engine as EngineDefinition
+const store = new ToolStore(def.engineId)
+const pipeline = def.pipeline ?? defaultPipeline(def.engineId)
+const onboarding = new OnboardingConsent(def.engineId)
+
+export default function App() {
+  const [form] = Form.useForm()
+  const [results, setResults] = useState<Record<string, string>>({})
+  const [page, setPage] = useState<string>('input')
+  const [history, setHistory] = useState(store.list())
+  const [authzModal, setAuthzModal] = useState<{ capability: CapabilityKind; purpose: string } | null>(null)
+  const [showOnboarding, setShowOnboarding] = useState(!onboarding.accepted())
+
+  // 首次使用总提示（一次性同意，持久化不再弹）
+  useEffect(() => {
+    if (!onboarding.accepted()) setShowOnboarding(true)
+  }, [])
+
+  const acceptOnboarding = () => {
+    onboarding.accept()
+    setShowOnboarding(false)
+    message.success('已记录同意；如需调整可在「授权管理」页查看')
+  }
+
+  // 授权确认（一次授权持久化；未授权则询问，授权后不再提示）
+  const ensureAuthz = (capability: CapabilityKind, purpose: string): boolean => {
+    if (authz.isGranted(capability)) return true
+    setAuthzModal({ capability, purpose })
+    return false
+  }
+  const confirmAuthz = () => {
+    if (authzModal) {
+      authz.grant(authzModal.capability, authzModal.purpose)
+      message.success(`已授权「${authz.label(authzModal.capability)}」，后续不再提示`)
+      setAuthzModal(null)
+    }
+  }
+
+  const run = (values: Record<string, unknown>) => {
+    // 计算前需授权存储能力（写入历史）
+    if (!ensureAuthz('storage', '保存计算记录到本地历史')) return
+    try {
+      const inputs = Object.fromEntries(
+        Object.entries(values).map(([k, v]) => [k, v === undefined || v === '' ? null : Number(v)]),
+      )
+      // 链路：compute -> store -> output
+      const out = evaluateEngine(def.formulas, inputs)
+      setResults(out)
+      store.save(inputs, out)
+      setHistory(store.list())
+      message.success('计算完成')
+      setPage('dashboard')
+    } catch (error) {
+      message.error(error instanceof Error ? error.message : '计算失败，请检查输入')
+    }
+  }
+
+  // 首次使用总提示弹窗（同意后持久化，不再弹出）
+  const renderOnboardingModal = () => (
+    <Modal
+      open={showOnboarding}
+      title={`欢迎使用「${def.name}」`}
+      okText="同意并开始使用"
+      cancelText="暂不使用"
+      onOk={acceptOnboarding}
+      onCancel={acceptOnboarding}
+      closable={false}
+      maskClosable={false}
+    >
+      <Paragraph>
+        <Text strong>关于能力调用与消耗：</Text>
+      </Paragraph>
+      <Paragraph>
+        本工具为整套计算工具（录入 → 校验 → 计算 → 存储 → 输出，联通节点）。
+        使用过程中<b>可能调用其他技能辅助</b>（如 Blueprint 开发流程编排、互联网情报搜索、AI 模型），
+        <b>可能增加调用消耗</b>。
+      </Paragraph>
+      <Paragraph type="secondary">
+        同意后不再提示；后续可在「授权管理」页查看已授权能力并随时撤销。
+      </Paragraph>
+    </Modal>
+  )
+
+  // 授权确认弹窗（用户可见，一次授权）
+  const renderAuthzModal = () => (
+    <Modal
+      open={authzModal !== null}
+      title="能力调用授权"
+      okText="授权"
+      cancelText="拒绝"
+      onOk={confirmAuthz}
+      onCancel={() => setAuthzModal(null)}
+    >
+      {authzModal ? (
+        <Paragraph>
+          本工具将调用 <Text strong>{authz.label(authzModal.capability)}</Text>：
+          <br />{authzModal.purpose}
+          <br />
+          <Text type="secondary">授权一次后永久记住，后续不再提示。可在「授权管理」页撤销。</Text>
+        </Paragraph>
+      ) : null}
+    </Modal>
+  )
+
+  const renderInput = () => (
+    <Card title="录入" style={{ maxWidth: 720, margin: '0 auto' }}>
+      <Form form={form} layout="vertical" onFinish={run}>
+        {def.fields.map((f) => (
+          <Form.Item
+            key={f.key}
+            name={f.key}
+            label={`${f.label}${f.unit ? `（${f.unit}）` : ''}`}
+            rules={[{ required: Boolean(f.required), message: `请输入${f.label}` }]}
+          >
+            {['integer', 'number', 'money', 'percent'].includes(f.type)
+              ? <InputNumber style={{ width: '100%' }} placeholder={`请输入${f.label}`} />
+              : <Input placeholder={`请输入${f.label}`} />}
+          </Form.Item>
+        ))}
+        <Button type="primary" htmlType="submit">计算</Button>
+      </Form>
+    </Card>
+  )
+
+  const renderDashboard = () => (
+    <Card title="指标卡" style={{ maxWidth: 720, margin: '0 auto' }}>
+      <Space direction="vertical" size="middle" style={{ width: '100%' }}>
+        <Button onClick={() => setPage('input')}>返回修改</Button>
+        <Space wrap size="large">
+          {def.formulas.map((f) => (
+            <Statistic key={f.key} title={f.label} value={results[f.key] ?? '—'} precision={2} valueStyle={{ fontSize: 22 }} />
+          ))}
+        </Space>
+        <Text type="secondary">计算基于确定性公式引擎（decimal.js），结果可复现。</Text>
+      </Space>
+    </Card>
+  )
+
+  const renderPipeline = () => (
+    <Card title="工具链路（整套工具 · 联通节点）" style={{ maxWidth: 720, margin: '0 auto' }}>
+      <Space direction="vertical" size="middle" style={{ width: '100%' }}>
+        {pipeline.nodes.map((node) => {
+          const neighbors = nodeNeighbors(pipeline, node.id)
+          const downstream = neighbors?.downstream.map((n) => n.id).join(' → ') || '（终端）'
+          return (
+            <div key={node.id} style={{ border: '1px solid #d9d9d9', borderRadius: 8, padding: 12 }}>
+              <Space>
+                <Tag color="blue">{node.kind}</Tag>
+                <Text strong>{node.label}</Text>
+                <Text type="secondary">→ {downstream}</Text>
+              </Space>
+            </div>
+          )
+        })}
+        <Alert type="info" showIcon message="链路说明" description="工具由联通节点组成：录入 → 校验 → 计算 → 存储 → 输出。改动指标/公式只改引擎定义，链路自动感知；新增自动化节点可扩展。" />
+      </Space>
+    </Card>
+  )
+
+  const renderReport = () => (
+    <Card title="历史记录" style={{ maxWidth: 720, margin: '0 auto' }}>
+      <Table<Record<string, unknown>>
+        rowKey="id"
+        dataSource={history}
+        pagination={{ pageSize: 5 }}
+        columns={[
+          { title: '时间', dataIndex: 'updatedAt', render: (v: string) => new Date(v).toLocaleString() },
+          { title: '输入', dataIndex: 'inputs', render: (v: Record<string, unknown>) => JSON.stringify(v) },
+          { title: '结果', dataIndex: 'results', render: (v: Record<string, unknown>) => JSON.stringify(v) },
+        ]}
+      />
+      <Button danger style={{ marginTop: 16 }} onClick={() => { if (ensureAuthz('storage', '清空本地历史记录')) { store.clear(); setHistory([]) } }}>清空历史</Button>
+    </Card>
+  )
+
+  const renderAuthz = () => (
+    <Card title="授权管理" style={{ maxWidth: 720, margin: '0 auto' }}>
+      <Table<ReturnType<typeof authz.list>[number]>
+        rowKey="capability"
+        dataSource={authz.list()}
+        pagination={false}
+        columns={[
+          { title: '能力', dataIndex: 'capability', render: (v: CapabilityKind) => authz.label(v) },
+          { title: '状态', dataIndex: 'granted', render: (v: boolean) => (v ? <Tag color="green">已授权</Tag> : <Tag>未授权</Tag>) },
+          { title: '授权时间', dataIndex: 'grantedAt', render: (v: string) => new Date(v).toLocaleString() },
+          { title: '操作', render: (_, r) => <Button size="small" danger onClick={() => { authz.revoke(r.capability); setPage('authz') }}>撤销</Button> },
+        ]}
+      />
+    </Card>
+  )
+
+  return (
+    <div style={{ maxWidth: 960, margin: '0 auto', padding: '32px 16px' }}>
+      <Title level={2} style={{ textAlign: 'center' }}>{def.name}</Title>
+      <Paragraph type="secondary" style={{ textAlign: 'center' }}>
+        引擎 ID：{def.engineId} · 整套工具（{pipeline.nodes.length} 个联通节点）· 配置驱动
+      </Paragraph>
+      <div style={{ textAlign: 'center', marginBottom: 24 }}>
+        <Segmented
+          value={page}
+          onChange={(v) => setPage(String(v))}
+          options={[
+            { label: '录入', value: 'input' },
+            { label: '指标卡', value: 'dashboard' },
+            { label: '链路', value: 'pipeline' },
+            { label: '报告', value: 'report' },
+            { label: '授权', value: 'authz' },
+          ]}
+        />
+      </div>
+      {page === 'input' && renderInput()}
+      {page === 'dashboard' && renderDashboard()}
+      {page === 'pipeline' && renderPipeline()}
+      {page === 'report' && renderReport()}
+      {page === 'authz' && renderAuthz()}
+      {renderOnboardingModal()}
+      {renderAuthzModal()}
+    </div>
+  )
+}

package/skills/calctool/platform-template/src/authz.ts

@@ -0,0 +1,103 @@
+// calctool 授权管理：调用外部能力前的透明授权 + 一次授权持久化
+// 原则：调用任何外部能力（blueprint / 网络搜索 / 模型 / 外部 API）前必须告知用户，
+// 用户授权一次后记住（localStorage 持久化），后续不再重复提示。
+
+export type CapabilityKind =
+  | 'blueprint'      // Blueprint 开发流程编排
+  | 'web-search'     // 情报蜂群网络搜索
+  | 'model'          // AI 模型调用
+  | 'external-api'   // 外部 API（数据源/报表导出等）
+  | 'storage'        // 本地/远端数据存储
+  | 'automation'     // 自动化（定时/触发器）
+
+export type Authorization = {
+  capability: CapabilityKind
+  granted: boolean
+  grantedAt: string
+  note?: string
+}
+
+const AUTH_KEY = 'calctool:authz:v1'
+const ONBOARDING_KEY = 'calctool:onboarding:v1'
+const CAPABILITY_LABELS: Record<CapabilityKind, string> = {
+  'blueprint': 'Blueprint 开发流程编排',
+  'web-search': '互联网情报搜索',
+  'model': 'AI 模型调用',
+  'external-api': '外部 API 数据源',
+  'storage': '数据存储',
+  'automation': '自动化任务',
+}
+
+/** 首次使用总提示：告知工具可能调用其他技能/增加消耗，同意后持久化不再弹 */
+export class OnboardingConsent {
+  constructor(private readonly engineId: string) {}
+
+  private key(): string { return `${ONBOARDING_KEY}:${this.engineId}` }
+
+  /** 是否已同意首次使用提示 */
+  accepted(): boolean {
+    if (typeof localStorage === 'undefined') return true
+    return localStorage.getItem(this.key()) === 'accepted'
+  }
+
+  /** 同意并持久化（一次同意，不再提示） */
+  accept(): void {
+    if (typeof localStorage !== 'undefined') {
+      localStorage.setItem(this.key(), 'accepted')
+    }
+  }
+
+  /** 首次使用提示文案（可自定义，默认含消耗提示） */
+  notice(extra?: string): string {
+    return extra ?? '本工具为整套计算工具，可能调用其他技能辅助使用（如 Blueprint 开发流程编排、互联网情报搜索、AI 模型），可能增加调用消耗。同意后不再提示，可随时在「授权管理」页查看与撤销。'
+  }
+}
+
+export class AuthzManager {
+  private store: Record<string, Authorization> = {}
+
+  constructor() {
+    if (typeof localStorage === 'undefined') return
+    try {
+      this.store = JSON.parse(localStorage.getItem(AUTH_KEY) ?? '{}')
+    } catch { this.store = {} }
+  }
+
+  /** 是否已授权某能力 */
+  isGranted(capability: CapabilityKind): boolean {
+    return this.store[capability]?.granted === true
+  }
+
+  /** 需要授权时的提示文案 */
+  promptFor(capability: CapabilityKind, purpose: string): string {
+    return `调用「${CAPABILITY_LABELS[capability]}」：${purpose}。是否授权？授权一次后不再提示。`
+  }
+
+  /** 记录授权（一次授权，持久化） */
+  grant(capability: CapabilityKind, note?: string): void {
+    this.store[capability] = {
+      capability, granted: true, grantedAt: new Date().toISOString(), note,
+    }
+    if (typeof localStorage !== 'undefined') {
+      localStorage.setItem(AUTH_KEY, JSON.stringify(this.store))
+    }
+  }
+
+  /** 撤销授权 */
+  revoke(capability: CapabilityKind): void {
+    delete this.store[capability]
+    if (typeof localStorage !== 'undefined') {
+      localStorage.setItem(AUTH_KEY, JSON.stringify(this.store))
+    }
+  }
+
+  list(): Authorization[] {
+    return Object.values(this.store)
+  }
+
+  static label(capability: CapabilityKind): string {
+    return CAPABILITY_LABELS[capability]
+  }
+}
+
+export const authz = new AuthzManager()