岗位知识沉淀助手（加密保险库）
一句话定位
把"只在老员工脑子里、散落文档/邮箱里"的岗位操作知识，变成机器可检索、可回放、加密不外泄的系统记忆。
解决的三大痛点
- AI 答不准：通用 AI 对"某版本某财务/业务软件怎么操作"只会给笼统、凭记忆编造的步骤，系统里根本没有它说的按钮。本技能让 AI 基于用户自己真实上传的文档和录屏作答。
- 交接记不住、录不全：旧人急于离职滔滔不绝，新人应接不暇；更糟的是只录屏会漏掉口头讲解。本技能屏幕共享 + 麦克风语音双路并行录制，操作与讲解同时完整捕获，事后随时查、反复查，交接零缺失。
- 文档进垃圾堆（本机 + 邮箱）：各岗位积攒的厂商培训课件、操作手册，散落在电脑本地和邮箱附件里，因人员进出、时间久远无人维护，沦为无法检索的"文档垃圾堆"。本技能支持本机上传与邮箱直接上传，脱敏、分门别类，重获价值。
适用场景（一眼看懂）
- 财务/人事/运营/IT 等任何岗位的离职交接：屏幕共享 + 麦克风语音，把老员工操作与讲解一并录下。
- 把公司积攒的软件操作手册、培训 PPT、PDF 课件上传——从本机电脑/手机，或直接连邮箱（邮件+附件一并入库），变成可对话查询的知识库。
- 向 AI 提问"在 XX 软件 XX 版本里怎么操作 XX"，获得基于真实文档/录屏的精确步骤。
- 数据安全要求高：首次启动在界面自选访问权限——要么"本人多端私有"（电脑+手机端都能用、除本人外查不到），要么"本机锁定"（仅当前这台电脑能用、手机和其他电脑都打不开），且全功能统一生效。
数据访问权限模式（首次启动界面自选 · 覆盖全部功能）
技能首次初始化时，会在界面上由用户自行选择数据访问隔离模式（两种模式均可事后在设置中切换，切换涉及数据迁移，详见 guide.md 第 6 节）。该模式对交接录制、文档上传、邮箱上传等所有功能的数据统一生效。
模式 A · 本人多端私有（默认）
- 仅用户本人的 WorkBuddy 账号可查询；本人电脑端 + 手机端都可使用，数据在两端间端到端加密同步。
- 除本人两端外，任何其他人（任何账号、任何设备）都无法通过该技能查到或看到该用户上传/录制的内容。
模式 B · 本机锁定（单机最高隔离）
- 仅限该 WorkBuddy 用户在当前登录的这台电脑上使用；数据严格留在本机，零上传、零同步。
- 手机端、以及在其他电脑上登录同一账号，均不可用——即便同一账号，换了设备就访问不到。
两种模式都确保"授权边界之外任何人都看不到"，区别只在于授权边界是"本人多端"还是"仅此一台电脑"。用户按自身合规要求（个人单机等密 vs 多端协同）自由选择。
三大核心能力
能力一：交接录制沉淀（屏幕共享 + 麦克风语音双路录制）
- 经用户授权后，并行捕获两类信号：① 屏幕共享画面 + 操作动作（点击位置/菜单路径）；② 麦克风语音讲解。
- 二者时间对齐，自动生成"带讲解的操作步骤"，可回放、可对话检索。
- 双路录制确保"操作看得见、讲解听得清"，交接过程无任何缺失——这是相对"只录屏"或"纯实时问答"的关键升级。
- 与"实时问答型"（如豆包边共享边问）的区别：本能力是沉淀型——一次录全，事后慢慢消化，不依赖旧人是否在场。
- 录制的全部数据遵循所选"数据访问权限模式"（A 或 B）。
能力二：电子文档知识库（本机上传 + 邮箱上传 + 脱敏 + 分类）
- 上传渠道 A · 本机端上传：用户从电脑/手机本地选择操作手册/培训课件（PDF/Word/PPT/Excel）上传。
- 上传渠道 B · 电子邮件直接上传（半自动 + 人工确认闸门）：
- 用户选择"邮箱上传"后，由本人确认并输入邮箱密码（密码仅本地输入、不明文留存、不写入任何日志/缓存）。
- 系统列出邮件，由用户亲手点击勾选要上传的邮件（半自动，不自动全量拉取，避免误传私密邮件）。
- 上传时若邮件含附件，连同附件一并上传，正文与附件共同入库。
- 强制脱敏：本地识别并屏蔽人名、账号、金额、客户名、内部地址等敏感实体，再形成索引。
- 分门别类：按软件、版本、模块、岗位自动打标签，形成条理化的"系统记忆"。
- 对话时基于真实文档作答，正面解决"AI 凭记忆编按钮"。
- 以上全部数据遵循所选"数据访问权限模式"（A 或 B）。
能力三：多端同步 + 端到端加密（隐私底座 · 对应权限模式 A）
- 用户本人的电脑端、手机端 WorkBuddy 账号均可查询使用同一份知识库（即"模式 A · 本人多端私有"的实现机制）。
- 除本人两端外，任何人都无法通过本技能查到或看到该用户上传的文档。
- 采用端到端加密（E2EE）：文档在用户设备加密后上传，密钥仅存于本人设备，云端只存密文，连平台也无法解密。
- 若用户选择权限"模式 B · 本机锁定"，则本能力不启用，数据全程零上传、仅存当前电脑（见"数据访问权限模式"章节）。
安全执行原则（半自动 + 人工确认闸门）
适用于"邮箱上传"与未来"代用户操作系统"（RPA）两类场景，必须遵循：
- 技能仅负责路径导航、列邮件/填表、数据准备；
- 登录邮箱、输入密码、勾选上传哪些邮件、生成凭证、付款等关键动作，必须本人亲手操作/确认；
- 密码不明文留存于任何日志、缓存、截图；
- 财务容错率极低，默认"半自动 + 人工确认"，不承诺全自动。
引导工作流（供 WorkBuddy 执行）
- 权限模式选择（首次启动必做）：在界面上引导用户选择数据访问权限模式——A 本人多端私有（默认）/ B 本机锁定。选择结果决定后续所有数据的存储与同步边界（见上"数据访问权限模式"章节与 guide.md 第 6 节）；模式 B 下强制本地优先、零上传。
- 建库阶段：引导用户选择上传渠道——本机端文件，或邮箱直接上传（半自动闸门：本人输密码→勾选邮件→带附件入库）；调用文档解析与对话能力构建本地索引；先以"本地优先、零上传"满足个人场景。
- 脱敏阶段：在本地对文档/邮件/附件做敏感实体识别与打码，再建索引。
- 录制阶段：引导用户开启屏幕共享 + 麦克风语音双路录制交接过程，整理为带讲解的步骤。
- 加密同步阶段：当平台支持 E2EE 多端同步且用户选择"模式 A"时启用；若选择"模式 B"则以本地处理呈现，并在界面明确告知"数据仅留在本机"。
详细流程、脱敏规则与加密机制见references/guide.md。
隐私承诺（给用户）
- 数据访问边界由您首次启动在界面自选：模式 A 本人多端私有（端到端加密同步、除本人外任何人都查不到）；模式 B 本机锁定（仅当前电脑可用、零上传、手机及其他电脑均不可访问）。
- 无论哪种模式，授权边界之外的任何人都看不到您的知识库；技能上架分发的是"能力"，不含任何用户文档，他人安装同一技能不会看到您的资料。
- 邮箱密码仅本人本地输入，技能不存储、不中转。
- 模式 B 下数据严格留在本机；模式 A 下采用端到端加密，云端只存密文、连平台也无法解密。
Resources
references/
guide.md：详细工作流指南、脱敏规则、E2EE 多端隔离机制、两种权限模式的技术实现与切换、半自动闸门设计、邮箱上传流程、能力边界说明。
支付宝付费改造契约（PAYSKILL）
本技能为付费技能（PAYSKILL）。调用遵循支付宝 AI 生意画像契约，由平台调度层执行 probe → pay → complete → ack 流程：
- probe（探测）：平台调用前先探测是否已持有本技能的支付宝有效订阅 / 付费凭证。已付费则直接放行。
- 402 Payment-Needed：未付费时，脚本向标准输出返回 HTTP 状态
402与Payment-Needed标记，提示用户通过支付宝完成付费（pay），平台据此唤起付费页。 - complete（扣费确认）：用户在支付宝完成扣费后，平台下发
Payment-Proof（付费凭证）。 - ack（验签放行）：平台携带
Payment-Proof重试本次调用；scripts/payment_gate.py验签该凭证，确认有效后放行主流程。
订阅持久化与幂等：
- 付费状态缓存在本地
.pay_cache/state.json，避免每次调用重复付费（订阅持久化）。 - 同一
Payment-Proof在 24h 幂等窗口内仅生效一次，避免重复扣费。
现金流改造后的调用套路：
用户调用 → 平台 probe →
未付费：下发 402 Payment-Needed → 支付宝 pay → complete → 下发 Payment-Proof
已付费/携带 Proof：脚本 ack 验签 → 放行主流程
> 本契约由 SkillHUB 平台调度层解析，脚本本地仅处理 402 / 验签 / 持久化 三环节；付费本体交给支付宝。
支付宝 AI 按量付费（Machine Pay / A2M）改造说明
本 Skill 已按支付宝官方 A2M 协议改造为 Pay Skill，付费闸口位于 scripts/payment_gate.py，统一调用云端计费服务 https://pay.pembroli.cn/api/resource。
付费流程
- 未付费调用时，服务端返回 HTTP 402 +
Payment-Needed头，携带金额、商户、订单号及 RSA2 签名。 - 买家侧
payment_gate.py收到 402 后引导用户完成支付，平台回传Payment-Proof。 - 客户端携带
Payment-Proof重试资源端点。
验付调用
服务端收到 Payment-Proof 后，调用支付宝验付接口（alipay.aipay.agent.payment.verify）核验凭证有效性（trade_no、out_trade_no、active 状态），验证失败返回 400，验证通过才进入资源发放。
履约确认
资源发放成功后，服务端异步调用履约确认接口（alipay.aipay.agent.fulfillment.confirm，trade_no）回执，标记本笔订单已履约；并按 out_trade_no 做幂等，重复请求直接返回已缓存结果，杜绝重复收费。
幂等与缓存
买家侧按 slug 本地缓存 Payment-Proof（24h TTL），有效期内免重复支付；服务端按订单号幂等，保证同一笔订单只履约一次。
