cli-calctool 0.3.4 → 1.0.1

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

@@ -1,80 +0,0 @@
-// calctool 链路编排：整套工具 = 联通节点（非单页孤岛）
-// 定义数据如何在节点间流动：输入 → 校验 → 计算 → 存储 → 输出 → 自动化
-// 节点可增删改，链路随之更新 —— 后期改工具只动这里，不改页面
-
-import type { FormulaNode } from './engine/evaluate'
-
-export type PipelineNodeKind =
-  | 'input'          // 数据输入（表单/导入）
-  | 'validate'       // 校验（必填/类型/范围）
-  | 'compute'        // 确定性计算（公式引擎）
-  | 'store'          // 数据存储（持久化）
-  | 'output'         // 输出（指标卡/报告/导出）
-  | 'automate'       // 自动化（触发器/定时/通知）
-
-export type PipelineNode = {
-  id: string
-  kind: PipelineNodeKind
-  label: string
-  inputs: string[]        // 上游节点 id
-  outputs: string[]       // 下游节点 id
-  config?: Record<string, unknown>
-}
-
-export type Pipeline = {
-  engineId: string
-  nodes: PipelineNode[]
-  // 数据流：input -> validate -> compute -> store -> output (+ automate)
-}
-
-/** 默认链路：整套工具的骨架（模块联通，非孤岛） */
-export function defaultPipeline(engineId: string): Pipeline {
-  return {
-    engineId,
-    nodes: [
-      { id: 'input', kind: 'input', label: '录入/导入', inputs: [], outputs: ['validate'] },
-      { id: 'validate', kind: 'validate', label: '数据校验', inputs: ['input'], outputs: ['compute'] },
-      { id: 'compute', kind: 'compute', label: '确定性计算', inputs: ['validate'], outputs: ['store', 'output'] },
-      { id: 'store', kind: 'store', label: '数据存储', inputs: ['compute'], outputs: ['output'] },
-      { id: 'output', kind: 'output', label: '指标卡/报告', inputs: ['compute', 'store'], outputs: [] },
-      { id: 'automate', kind: 'automate', label: '自动化（可选）', inputs: ['store'], outputs: ['output'], config: { enabled: false } },
-    ],
-  }
-}
-
-export type FieldDef = {
-  key: string
-  label: string
-  type: 'number' | 'integer' | 'money' | 'percent' | 'text' | 'date' | 'enum'
-  unit?: string
-  required?: boolean
-}
-
-export type FormulaDef = {
-  key: string
-  label: string
-  expression: FormulaNode
-}
-
-export type EngineDefinition = {
-  engineId: string
-  name: string
-  semanticVersion: string
-  category: string
-  decimalPolicy: string
-  fields: FieldDef[]
-  formulas: FormulaDef[]
-  rules: unknown[]
-  pipeline: Pipeline
-}
-
-/** 在链路中找节点的上下游（改工具时定位影响范围） */
-export function nodeNeighbors(pipeline: Pipeline, nodeId: string) {
-  const node = pipeline.nodes.find((n) => n.id === nodeId)
-  if (!node) return null
-  return {
-    node,
-    upstream: pipeline.nodes.filter((n) => node.inputs.includes(n.id)),
-    downstream: pipeline.nodes.filter((n) => n.inputs.includes(nodeId)),
-  }
-}

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

@@ -1,53 +0,0 @@
-// calctool 存储层：数据持久化
-// 默认 localStorage（零依赖，任何环境可用）；Node 全功能模式可换 better-sqlite3
-export type ToolRecord = {
-  id: string
-  engineId: string
-  inputs: Record<string, string | number>
-  results: Record<string, string>
-  createdAt: string
-  updatedAt: string
-}
-
-const KEY_PREFIX = 'calctool:record:'
-
-export class ToolStore {
-  constructor(private readonly engineId: string) {}
-
-  list(): ToolRecord[] {
-    if (typeof localStorage === 'undefined') return []
-    const records: ToolRecord[] = []
-    for (let i = 0; i < localStorage.length; i++) {
-      const key = localStorage.key(i)
-      if (key?.startsWith(`${KEY_PREFIX}${this.engineId}:`)) {
-        try {
-          records.push(JSON.parse(localStorage.getItem(key) ?? 'null'))
-        } catch { /* 跳过损坏记录 */ }
-      }
-    }
-    return records.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
-  }
-
-  save(inputs: Record<string, string | number>, results: Record<string, string>): ToolRecord {
-    const now = new Date().toISOString()
-    const record: ToolRecord = {
-      id: `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
-      engineId: this.engineId,
-      inputs, results, createdAt: now, updatedAt: now,
-    }
-    if (typeof localStorage !== 'undefined') {
-      localStorage.setItem(`${KEY_PREFIX}${this.engineId}:${record.id}`, JSON.stringify(record))
-    }
-    return record
-  }
-
-  clear(): void {
-    if (typeof localStorage === 'undefined') return
-    const keys: string[] = []
-    for (let i = 0; i < localStorage.length; i++) {
-      const key = localStorage.key(i)
-      if (key?.startsWith(`${KEY_PREFIX}${this.engineId}:`)) keys.push(key)
-    }
-    keys.forEach((k) => localStorage.removeItem(k))
-  }
-}

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

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "jsx": "react-jsx",
-    "strict": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "esModuleInterop": true,
-    "noEmit": true,
-    "types": ["vite/client"]
-  },
-  "include": ["src"]
-}

package/skills/calctool/platform-template/vite.config.ts

@@ -1,7 +0,0 @@
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-
-export default defineConfig({
-  plugins: [react()],
-  server: { port: 5173, host: true },
-})

package/skills/calctool/references/declarative-pages.md

@@ -1,69 +0,0 @@
-# 声明式页面规格系统
-
-把"信息型页面"从代码降级为**数据声明**，用通用渲染器渲染几十个页面，避免复制粘贴页面结构。这是生成工具页面的核心机制。
-
-## 1. 规格 Schema
-
-```ts
-interface ApplicationPageSpec {
-  title: string;
-  description?: string;
-  tabs?: TabSpec[];
-  actions?: ActionSpec[];       // 页头操作（default|primary|danger）
-  sections?: SectionSpec[];     // 内容分区
-}
-
-interface SectionSpec {
-  layout: 'rows' | 'grid' | 'table' | 'steps';
-  rows?: RowSpec[];             // 标签/值/说明/状态/行内操作
-  metrics?: MetricSpec[];       // 指标卡
-  columns?: ColumnSpec[];
-  data?: (string | number)[][]; // 表格数据
-  empty?: EmptyStateSpec;       // 空状态（标题/说明/操作）
-}
-```
-
-## 2. 注册与路由匹配
-
-- 规格文件按域拆分（core/settings/management/finance/studio/supplementary），每份是 `Record<string, ApplicationPageSpec>` + 路由映射
-- 支持参数化路由：`/tools/:toolId/runs/:runId`、`/automations/:automationId/edit`
-- 匹配算法：按路径段数**从长到短**排序 → 逐段精确匹配（`:` 前缀为参数位）→ 命中后提取 params → `encodeURIComponent` 回填规格内 `href`
-
-## 3. 渲染器
-
-`ApplicationPageSpec → 通用构建块组件树`：
-
-```
-PageShell（内容 768px）
-  → PageHeader（标题/说明/操作）
-  → SectionCard × N（分区）
-    → 按 layout 分发：
-      rows   → SettingRow 行
-      grid   → 网格卡
-      table  → 表格
-      steps  → 步骤条
-      empty  → EmptyState
-```
-
-- 无 `href` 的操作自动 `disabled`——保证"未接入"按钮不产生假交互
-- 所有构建块来自共享组件（PageShell/PageHeader/SectionCard/SettingRow/EmptyState/StatGrid/PageList/Toolbar），页面只提供数据
-- 单文件 ≤ 1000 行（审计脚本强制），接近上限必须拆分
-
-## 4. 生成工具时的页面映射
-
-| 工具模块 | 页面规格 |
-|---|---|
-| 录入表单 | 字段目录 → 自动生成 rows/grid 表单（含必填/类型/单位） |
-| 指标卡 | 公式结果 → metrics 数组（StatGrid） |
-| 专题工具 | 每个专题 → 独立 SectionCard（增值税/盈亏平衡/定价/利润率优化） |
-| 历史记录 | table 布局 + 分页 |
-| 诊断报告 | 指标卡 + 表格 + 诊断结论 + 建议 |
-| 空状态 | 无数据时 EmptyState（不虚构装饰图标） |
-
-## 5. 硬约束（从工具项目继承）
-
-- 正文内容容器统一 768px（与 Composer 同宽），窄屏等比收窄，禁止按页面类型自由设宽
-- 禁内联 style、禁硬编码颜色、禁阴影
-- 图标统一 Lucide、14px、描边 2
-- 空页面不显示装饰图标，不虚构状态/数据/提示/按钮
-- 能拆成组件的内容禁止堆积在页面文件中

package/skills/calctool/references/engine-meta-model.md

@@ -1,123 +0,0 @@
-# 引擎元模型（Engine Meta-Model）
-
-一个可发布、可运行、可验收的"计算工具"= 一份**引擎定义**。本文件规定引擎定义的结构与约束。
-
-## 1. 顶级对象
-
-```ts
-interface EngineDefinition {
-  id: string;                    // kebab-case 稳定机器标识
-  name: string;                  // 中文显示名，可改
-  semanticVersion: string;       // 语义版本，发布后不可原地修改
-  status: 'draft' | 'review' | 'published' | 'retired';
-  compatibilityProfile?: string; // 如 legacy-compatible（复现旧口径）
-  decimalPolicy: 'decimal-string' | 'source-compatible-float';
-  inputSchema: JsonSchema;       // 输入校验
-  fields: FieldDefinition[];     // 字段目录
-  tables: TableDefinition[];     // 表格定义（如成本结构表）
-  dimensions: DimensionDefinition[]; // 维度（公司/部门/周期）
-  entities: EntitySchemaDefinition[]; // 实体
-  relations: RelationDefinition[];    // 关系
-  choiceSources: ChoiceSourceDefinition[];
-  interactionRules: InteractionRuleDefinition[];
-  formulas: FormulaDefinition[]; // 公式图
-  rules: RuleDefinition[];       // 规则包（阈值/评分/分级）
-  views: ViewDefinition[];       // 视图
-  documents: MarkdownDocumentDefinition[]; // Markdown 说明/报告
-  approvalPolicyRefs: string[];
-  importProfiles: ImportProfile[]; // 导入映射
-  reports: ReportDefinition[];   // 报告模板
-  outputs: OutputContract[];     // 输出契约（跨引擎引用用）
-  permissions: EnginePermissionPolicy;
-  testSuites: EngineTestSuite[]; // 确定性测试
-  migrationFrom?: EngineMigration[];
-}
-```
-
-**铁律**：
-- `id` 与字段 `key` 是稳定机器标识；中文标签可以改，ID 不改
-- 所有引用用 ID，不用页面标题或表格坐标作主键
-- 发布版本不可原地修改；运行记录绑定精确的 `engineVersionId`
-- 跨引擎只允许引用对方声明的输出契约
-
-## 2. 字段类型
-
-```text
-number, money, percent, integer, text, richText, boolean,
-date, dateTime, enum, singleSelect, multiSelect, dimensionRef,
-entityRef, file, image, object, repeatGroup, table, reference, derived
-```
-
-每个数值字段至少含：
-- `key`（稳定 ID）、`label`（中文标签）、`type`
-- `required` / `defaultValue`
-- `precision` / `rounding`（金额、比例、整数分别定义）
-- `unit`（如 CNY、CNY/person、%）
-- 枚举字段含 `choiceSourceRef`
-
-## 3. 公式定义
-
-```ts
-interface FormulaDefinition {
-  key: string;
-  label: string;
-  type: 'derived' | 'score' | 'aggregate' | 'lookup';
-  expression: FormulaAst;        // 编译后的 AST（见 formula-dsl.md）
-  source?: string;               // 可读字符串（仅编辑用，保存必须 AST）
-  outputUnit?: string;
-  description?: string;
-}
-```
-
-## 4. 规则包（Rule Pack）
-
-```ts
-interface RuleDefinition {
-  id: string;
-  name: string;
-  kind: 'threshold' | 'scoring' | 'grading' | 'validation';
-  // 阈值：区间 → 级别
-  // 评分：指标值 → 0-100 分（可曲线/分段）
-  // 分级：总分 → 健康等级（如 优/良/中/差）
-  inputs: string[];              // 引用字段/公式 key
-  evaluation: RuleAst;           // 条件 AST
-}
-```
-
-## 5. 导入 Profile
-
-```ts
-interface ImportProfile {
-  id: string;
-  kind: 'excel' | 'ocr' | 'manual';
-  sourceFormat: string;          // Excel 列 / OCR 字段布局
-  mapping: { source: string; targetField: string; transform?: string }[];
-  verification: 'draft' | 'auto'; // 自动导入先进草稿
-}
-```
-
-## 6. 报告模板
-
-```ts
-interface ReportDefinition {
-  id: string;
-  name: string;
-  sections: ReportSection[];
-  // 指标卡 / 表格 / 诊断结论 / 历史分位 / 建议
-}
-```
-
-## 7. 版本与迁移
-
-- `1.x legacy-compatible`：复现原工具结果（保留旧公式、边界、取整）
-- `2.x corrected`：修正数据质量问题（通过显式迁移发布，绝不静默改变旧运行）
-- 任何公式/字段/阈值/导入映射/报告变化 → 新版本
-
-## 8. 引擎状态机（能力接入）
-
-```text
-planned → not_installed → disconnected → configuring
-  → pending_verification → connected → disabled | unavailable
-```
-
-健康状态 `healthy/degraded/failed/unknown` **只在真实连接与探针后出现**；客户端不能提交健康状态。

package/skills/calctool/references/finance-example.md

@@ -1,132 +0,0 @@
-# 范例：经营健康诊断引擎（finance-health-diagnosis）
-
-完整走通「50 输入字段 → 归类 → 利润 → 十大指标评分 → 健康度 → 报告」的引擎定义范例。这是 calctool 的 reference implementation：任何新工具都可对照此结构生成。
-
-## 1. 引擎身份
-
-```yaml
-engineId: finance-health-diagnosis
-name: 经营健康诊断
-category: finance
-ownerType: platform-template
-status: published
-semanticVersion: 1.0.0
-compatibilityProfile: legacy-compatible
-decimalPolicy: decimal-string
-defaultCurrency: CNY
-defaultLocale: zh-CN
-schemaVersion: engine-spec/1
-```
-
-版本族：`1.x legacy-compatible`（复现原工具）；`2.x corrected`（修正财务口径，显式迁移发布）。
-
-## 2. 六层计算链路
-
-```
-输入层：利润表 50 个基础字段（货品成本、账单/订单/流量费用、薪酬、仓储…）
-  → 归类层：商品成本 / 账单费用 / 订单费用 / 流量费用 / 薪酬 / 仓储费用
-  → 利润层：GSV / 运营毛利 GP_oper / 管理费用 / 税前净利润 NP / 占比
-  → 诊断层：十大指标 / 动态阈值 / 单项得分 / 健康等级 / 加权健康度
-  → 专题层：增值税 / 盈亏平衡 / 私域复购 / 单品定价 / 利润率优化
-  → 展示层：历史分位 / 诊断重点 / HTML 报告 / 历史记录 / OGSM 执行方案
-```
-
-## 3. 十大指标权重（默认）
-
-| 指标 | 权重 |
-|---|---:|
-| 定价倍数 | 30% |
-| GSV | 17% |
-| 薪酬效率 | 15% |
-| GSV 人效 | 5% |
-| 毛利人效 | 5% |
-| 净利人效 | 5% |
-| 增值税率 | 10% |
-| 人均办公费用 | 3% |
-| 仓储费用占比 | 5% |
-| 单件发货成本 | 5% |
-
-## 4. 通用评分曲线（0-100）
-
-高值更优：
-```text
-S_high(A;P,E) = clamp(60 + 30 × (A-P)/(E-P), 0, 100)
-```
-
-低值更优（E < P，斜率自然为负）：
-```text
-S_low(A;P,E) = clamp(60 + 30 × (A-P)/(E-P), 0, 100)
-```
-
-带盈亏点的分段函数（定价倍数、GSV）：
-```text
-若 A < B： S_break = clamp(round(30 + 30 × (A-B)/(P-B)), 0, 100)
-否则：     S_break = clamp(round(60 + 30 × (A-P)/(E-P)), 0, 100)
-```
-（B=盈亏平衡，P=合格，E=优秀）
-
-## 5. 分数等级
-
-| 分数 | 等级 |
-|---:|---|
-| 非有限/空 | 需要优化成本结构而非数值 |
-| <60 | 危险 |
-| 60-<70 | 合格 |
-| 70-<80 | 良好 |
-| 80-<90 | 优秀 |
-| >=90 | 卓越 |
-
-## 6. 指标定义（当前值公式 + 目标 + 样例）
-
-| 指标 | 公式 | 合格/良好/优秀 | 样例分 |
-|---|---|---|---|
-| 定价倍数 | `S / 货品成本` | 动态阈值 | 63 |
-| GSV | `S` | 动态 | 63 |
-| 薪酬效率 | `GP_oper / 薪酬福利` | 2.0 / 2.5 / 3.0 | 71 |
-| GSV 人效 | `S / 正式员工数` | 100k / 120k / 150k | 60 |
-| 毛利人效 | `GP_oper / 正式员工数` | 17k / 20.4k / 25.5k | 61 |
-| 净利人效 | `NP / 正式员工数` | 5k / 6k / 7.5k | 64 |
-| 增值税率 | `C_tax / S` | 综合税率×1.0/0.9/0.8 | 38.4 |
-| 人均办公费用 | `办公费用 / 正式员工数` | 1,600 / 1,200 / 800 | 63.75 |
-| 仓储费用占比 | `仓储费用 / S` | 4.0% / 3.5% / 3.0% | 63 |
-| 单件发货成本 | `仓储费用 / 真实发货单量` | 1.80 / 1.60 / 1.40 | 76.5 |
-
-动态定价倍数阈值：
-```text
-c = 货品成本 / S
-n = 当前税前净利率
-盈亏倍数 B = 1 / (c + n)
-合格倍数 P = 1 / (c + n - 5%)
-```
-
-## 7. 总健康分
-
-- 加权：`总分 = Σ(指标分 × 权重)`，保留 2 位小数
-- 样例：62.2362（健康）
-- 历史百分位：程序按当前版本重算每条历史记录的十大指标，与全站用户样本比较
-
-## 8. 引擎定义产物（calctool 生成模板）
-
-```
-finance-health-diagnosis/
-├── manifest.yaml           # 引擎身份（见 §1）
-├── field-catalog.json      # 50 个输入字段 + 10 个派生指标
-├── scope-dimensions.json   # 公司 / 周期 维度
-├── formula-graph.json      # 六层公式图（§2）
-├── rule-packs.json         # 权重 + 评分曲线 + 等级（§3-5）
-├── import-profiles.json    # Excel 单元格映射 + OCR 字段映射
-├── report-template.json    # 指标卡 + 表格 + 诊断结论 + 建议
-└── tests/                  # 样例复算（健康分 62.2362 等）
-```
-
-## 9. 导入映射要点
-
-- 原工具为 Excel 导入：F 列单元格映射到字段目录，配置表覆盖顺序以算法主文档为准
-- 原生表格确定性解析，不做 OCR；截图/扫描件走 OCR + 人工草稿确认
-- 所有自动导入先进入草稿，人工确认后才写正式数据
-
-## 10. 生产注意事项
-
-- 增值税模块属于经营估算模型，生产使用前必须由持证财税人员复核
-- 本引擎复现的是当前产品口径，不代表会计准则、税法意见或税务筹划建议
-- 模型（Hermes/MiMo/OCR）只生成候选、草稿和解释，不能替代已发布确定性引擎给出正式财务数字

package/skills/calctool/references/formula-dsl.md

@@ -1,92 +0,0 @@
-# 公式 DSL 与确定性运行时
-
-## 1. 禁止任意 JavaScript
-
-禁止存储并执行 `eval(formula)` / `new Function(formula)`。原因：任意代码执行、无法静态分析、无法稳定迁移、难以做单位检查和依赖审计。
-
-自然语言或可视化公式统一编译为 **JSON AST**：
-
-```json
-{
-  "op": "mul",
-  "args": [
-    { "ref": "gmv" },
-    { "op": "sub", "args": [{ "lit": "1" }, { "ref": "preRefundRate" }] },
-    { "op": "sub", "args": [{ "lit": "1" }, { "ref": "postRefundRate" }] }
-  ]
-}
-```
-
-可提供接近 Excel 的编辑语法（字符串只用于编辑；保存前必须解析为 AST，执行时不重新解释任意脚本）。
-
-## 2. 最小运算符注册表
-
-| 类别 | 运算符 |
-|---|---|
-| 算术 | `add sub mul div mod pow abs neg min max` |
-| 比例 | `percentOf percentageChange basisPoints` |
-| 比较 | `eq ne gt gte lt lte between` |
-| 逻辑 | `and or not if case` |
-| 空值 | `coalesce isNull isFinite safeDivide` |
-| 取整 | `round floor ceil truncate` |
-| 聚合 | `sum avg minOf maxOf count countIf sumIf` |
-| 表格 | `rowRef column map filter groupBy lookup` |
-| 文本 | `concat trim upper lower match` |
-| 日期 | `dateAdd dateDiff startOf endOf` |
-| 维度 | `selectedIds containsAny containsAll isDescendantOf memberAttribute` |
-| 财务（二阶段） | `npv irr pmt rate` |
-| 统计（二阶段） | `percentile rank stdev` |
-| 引用 | `ref tableRef engineOutput configRef` |
-
-**显式除法**（必选其一）：
-- `div`：除数为 0 产生错误值（`DIV_ZERO`）
-- `safeDivide`：除数为 0 使用指定回退值（如兼容旧引擎"除零返回 0"）
-
-## 3. Decimal、单位与错误值
-
-生产运行时不依赖 JS `number` 作为财务真值：
-
-- 内部数值用 `decimal.js` 或等价 Decimal 实现
-- JSON 中以**字符串**持久化 Decimal
-- 公式定义精度和取整边界
-- 单位在**编译期推断**：
-  - `金额 + 比例` → 类型错误 `UNIT_MISMATCH`
-  - `金额 ÷ 人数` → 推导为 `CNY/person`
-- 错误以结构化值传播，不伪装成 0：
-
-```ts
-type CalcError =
-  | { code: 'DIV_ZERO'; nodeId: string }
-  | { code: 'MISSING_INPUT'; fieldId: string }
-  | { code: 'UNIT_MISMATCH'; expected: string; actual: string }
-  | { code: 'NON_FINITE'; nodeId: string }
-  | { code: 'CYCLE'; path: string[] };
-```
-
-## 4. 依赖图（发布前必查）
-
-1. 从 AST 提取字段和公式依赖
-2. 验证引用存在且符合可见范围
-3. 建立有向图
-4. 检测循环（`CYCLE` 错误）
-5. 标记跨模块/跨引擎引用（必须绑定版本和输出契约）
-
-## 5. 编译流程
-
-```
-自然语言/Excel 公式
-  → 解析（JSON AST，含 op/args/ref/lit）
-  → 类型检查（单位推断、字段存在、操作数类型）
-  → 依赖提取（字段/公式/表格/维度引用）
-  → 循环检测
-  → 编译为可执行运行时
-  → 测试（样例 → 期望结果，Decimal 精确比对）
-  → 发布（版本化，不可变）
-```
-
-## 6. 执行语义
-
-- 增量重算：字段变化只重算下游依赖
-- 执行轨迹：记录每个节点的输入/输出/错误，可审计
-- 快照：运行记录绑定引擎版本 + 输入 + 结果，可复现
-- 错误值传播：上游错误 → 下游保持错误（不吞掉）

package/skills/calctool/references/import-ocr.md

@@ -1,72 +0,0 @@
-# 导入与 OCR（上传内容自动识别）
-
-用户上传内容自动识别的分层管道设计——让工具能"读懂"Excel、图片、PDF 并填入字段。
-
-## 1. 分层管道
-
-```
-浏览器显式选择文件
-  → 私有对象存储原件区
-  → 确定性预处理（类型/大小/指纹校验）
-  → 原始证据层（OCR / 解析器原始输出）
-  → 语义层（多模态模型：理解内容 → 候选字段）
-  → 映射/校验层（文本模型：候选 → 标准字段，口径解释）
-  → 规则引擎（勾稽校验、冲突判定）
-  → 人工确认（草稿）→ 正式计算
-```
-
-## 2. 铁律
-
-1. **原始识别必须有确定性证据**：保存 OCR 原始 JSON、坐标、置信度、RequestId、页面图、模型/提示词/规则版本；任何改写都能反查原文框
-2. **原生 Excel/CSV 不做 OCR**：先用确定性解析器读单元格、公式、合并区域、工作表、格式；只有截图、扫描件、无法解析或以图片嵌入的表格才进入 OCR
-3. **PDF 按页编排**：OCR 一次识别一页，多页扫描件走页级任务（受控并发、可重试、页级状态）
-4. **所有对外任务异步化**：即使接口同步返回，产品 API 也返回内部 jobId（排队/限流/重试/取消/复核/审计）
-5. **自动导入先进草稿**：候选字段不直接覆盖正式数据
-
-## 3. 腾讯云能力矩阵（财务场景）
-
-| 场景 | 接口 | 用途 |
-|---|---|---|
-| 普通清晰页面 | `GeneralBasicOCR` | 非关键文字批量预识别 |
-| 长数字/小字/模糊/倾斜/金额密集/税率 | `GeneralAccurateOCR` | 关键财务字段默认 |
-| 表格 | `RecognizeTableAccurateOCR` | 表格、单元格文字、行列跨度、坐标、置信度，可返回 Base64 Excel |
-
-## 4. 导入 Profile（ImportProfile）
-
-```ts
-interface ImportProfile {
-  id: string;
-  kind: 'excel' | 'ocr' | 'manual';
-  sourceFormat: string;          // Excel 列 / OCR 字段布局
-  mapping: {
-    source: string;              // 源列/字段
-    targetField: string;         // 目标字段 key
-    transform?: string;          // 归一化变换
-  }[];
-  verification: 'draft' | 'auto'; // 默认 draft
-}
-```
-
-导入字段至少关联：
-- 页码、工作表、单元格（溯源）
-- `semanticConfidence`：模型对字段语义和映射关系的候选置信
-- 映射规则版本
-- 状态映射（草稿/确认/拒绝）
-
-## 5. 人工确认界面
-
-- 展示：OCR 证据（原文框/坐标）↔ 候选映射 ↔ 置信度
-- 操作：确认 / 修正 / 拒绝；确认后写入正式字段
-- 审计留痕：谁在何时确认了什么，原始证据完整保留
-
-## 6. 前端导入交互
-
-- `<input type="file" multiple>` 渐进增强；`webkitdirectory` 支持目录批量
-- 先本地校验（扩展名 + MIME + 大小上限 + 去重指纹），再上传
-- 上传即返回 jobId，状态轮询（queued → processing → review → done/failed）
-
-## 7. 失败与边界
-
-- 解析失败：保留原始文件 + 错误详情，提示重新上传或人工录入
-- 置信度低于阈值：强制进入人工确认，不自动通过
-- OCR 与 Excel 混用：同一字段多来源时以人工确认为准，记录来源优先级

package/skills/calctool/templates/ecommerce-ops/README.md

@@ -1,27 +0,0 @@
-# 电商运营领域模板（ecommerce-ops）
-
-情报智能体（research-agent）从互联网收集的电商运营行业参考包，全部可溯源（见 `domain-reference.yaml` 的 sources）。
-
-## 内容
-
-- **10 个核心指标**：GMV / 转化率 / 客单价 / ROAS / ROI / 复购率 / UV / PV / LTV / CAC
-- **8 组计算口径**：转化率分母、ROI vs ROAS、GMV vs 实收、客单价、复购率、归因、LTV/CAC、漏斗
-- **6 项行业基准**：转化率 2-5%、ROAS ≥4、复购 25-30%、LTV/CAC ≥3 等
-- **1 条漏斗链路**：曝光 → 点击 → 访问 → 加购 → 下单 → 支付
-
-## 5 处口径争议（生成工具时做成用户可配置项）
-
-| 配置项 | 选项 | 影响 |
-|---|---|---|
-| 转化率分母 | UV 去重访客 / Sessions 会话数 | 结果差异可达 2 倍 |
-| 投产比分子 | 收入（ROAS）/ 利润（ROI） | 「投产比」一词两种语境 |
-| GMV 扣退款 | 是 / 否 | 流水口径 vs 净额口径 |
-| 复购率窗口 | 30 天 / 90 天 / 自然年 | 复盘 vs 品类周期 |
-| 归因窗口 | 7 天点击 / 1 天浏览 / 28 天 / 自定义 | 广告效果评估 |
-
-> 最终口径以老板确认为准，本模板只提供行业参考。
-
-## 使用方式
-
-calctool 的 research 蜂群任务在老板说「电商」等关键词时自动加载此模板，
-作为 fields/formulas 设计的领域知识基础。