﻿================================================================
excel-hyperlink 技能包 — 使用说明
================================================================

【版本】v1.0
【作者】寒地45°吕政仪
【适用】Windows 10/11 + OpenClaw/QClaw v0.2.34+
【许可】可自由分发，禁止用于非法用途

----------------------------------------------------------------
一、技能用途
----------------------------------------------------------------

生成带【可点击超链接】的 Excel 文件，并修复 Windows 系统级
注册表配置，使超链接在 Excel / WPS 中点击即可打开目标文件。

核心能力：
  1. 动态生成汇总表（gen.py）
  2. 修复已有 xlsx 超链接样式（fix.py）
  3. 批量附件打包 + 生成汇总表（pack.py）
  4. Windows 注册表修复工具箱（reg.py）
  5. 个人微信发送（wechat-access 通道）

----------------------------------------------------------------
二、文件结构
----------------------------------------------------------------

excel-hyperlink-skill/
├── SKILL.md                    ← 技能主文档（AI 读取）
├── 说明.txt                    ← 本文件
├── scripts\
│   ├── gen.py                 ← 通用超链接生成器（主脚本）
│   ├── fix.py                 ← 修复任意 xlsx 超链接样式
│   ├── pack.py                ← 批量附件打包 + 汇总表
│   └── reg.py                ← Windows 注册表修复工具箱
└── examples\
    ├── openclaw.example.json  ← OpenClaw 主配置示例（已脱敏）
    └── weixin-channel.example.json ← 个人微信发送配置示例

----------------------------------------------------------------
三、快速使用
----------------------------------------------------------------

【场景1：让 AI 生成汇总表】
  直接对 AI 说："用 excel-hyperlink 生成日志汇总表"
  AI 会自动调用 gen.py，根据提供的数据实时生成 xlsx。

【场景2：修复已有 Excel 超链接】
  cd scripts
  python reg.py check       # 检查当前注册表状态
  python reg.py fix-xlsx    # 修复 Excel 超链接安全限制
  python reg.py fix-txt     # 修复 .txt 文件关联
  python reg.py fix-all     # 执行全部修复

【场景3：批量附件打包】
  python pack.py <输出zip> <文件1> <文件2> ...

【场景4：个人微信发送】
  message(
      action="send",
      channel="wechat-access",
      target="<老板微信userId>",   # 数字，非昵称
      message="日志汇总...",
      media="C:\\路径\\企微日志汇总.xlsx"
  )

----------------------------------------------------------------
四、Windows 注册表修复（reg.py）
----------------------------------------------------------------

执行 `python reg.py fix-all` 可一次性修复以下系统问题：

【问题1】Excel 超链接点击无反应
  原因：Excel 默认禁用 file:/// 协议超链接（安全策略）
  修复：设置 CheckHyperlinksBeforeReading = 0
  路径：HKCU\Software\Microsoft\Office\16.0\Excel\Preferences

【问题2】.txt 双击打不开（关联到损坏的 UWP）
  原因：UserChoice 指向已卸载/损坏的 UWP 应用
  修复：删除 UserChoice，恢复 notepad.exe 关联

【问题3】.url 快捷方式无法打开本地文件
  原因：ieframe.dll 对 file:/// 有安全限制（设计如此）
  替代方案：
    1. ✅ 使用 Excel 超链接（本技能生成方式）
    2. ✅ 使用 .lnk 快捷方式（winshell.CreateShortcut）
    3. ⚠️ 使用 .bat 批处理（start "" "完整路径"）
    4. ✅ 使用 HTML 附件清单（pack.py 生成）

----------------------------------------------------------------
五、个人微信发送（wechat-access 通道）
----------------------------------------------------------------

【重要】发个人微信用 `wechat-access` 通道，不是 `openclaw-weixin`！

| 通道              | 状态   | 用途                    |
|-------------------|--------|-------------------------|
| wechat-access     | ✅ 可用 | 发老板个人微信（实测成功）|
| openclaw-weixin   | ❌ 需扫码 | 微信机器人接收，未登录无法发 |

【配置要求】
  1. OpenClaw 已配置 wechat-access（见 examples/openclaw.example.json）
  2. target 必须是微信 userId（数字），不是昵称
  3. 发送文件支持 xlsx / pdf / docx 等格式

【实测结果】
  {
    "channel": "wechat-access",
    "to": "1178341238",
    "result": {"ok": true}
  }

----------------------------------------------------------------
六、安全注意事项
----------------------------------------------------------------

1. 【禁止打包真实密钥】
   examples/ 下的 .json 均为脱敏示例，真实 token / secret
   已替换为占位符。发布前请确认未包含真实凭据。

2. 【注册表修改需谨慎】
   reg.py 修改的是当前用户（HKCU）注册表，不影响系统全局。
   如需系统级修复，请以管理员身份运行 PowerShell。

3. 【文件关联恢复】
   fix-txt 会将 .txt 关联到记事本。如需其他编辑器，
   请手动设置默认程序。

4. 【移动端兼容】
   OOXML 格式跨平台兼容，但 file:/// 本地链接在手机上
   无法访问（文件不在手机）。建议：
   - 上传腾讯文档 → 填云文档 URL
   - 放企业微信微盘 → 填微盘链接
   - 打成 zip 发微信 → 对方下载后用手机 WPS 打开

----------------------------------------------------------------
七、发布到 SkillHub
----------------------------------------------------------------

本技能包已通过安全审查（无真实密钥、无恶意代码），
可直接发布到 SkillHub 供其他用户安装使用。

【发布方式】
  方式1：将本文件夹压缩为 zip，通过 SkillHub 后台上传
  方式2：使用 skill_workshop 创建提案并发布
  方式3：skillhub_install install_skill_zip <本地zip路径>

【技能元数据】
  name: excel-hyperlink
  description: 生成带可点击超链接的 Excel 文件，修复 Windows 注册表使超链接生效，支持个人微信发送
  version: 1.0
  author: 寒地45°吕政仪
  platform: Windows（核心功能）；macOS/Linux（生成功能）

----------------------------------------------------------------
八、常见问题
----------------------------------------------------------------

Q1：为什么 Excel 里超链接是蓝色下划线但点击没反应？
A1：Excel 默认禁用 file:/// 超链接。运行 `python reg.py fix-xlsx`
    取消安全检查即可。

Q2：为什么 WPS 打不开超链接？
A2：WPS 不识别 Word 注册表的 SingleClickToOpenHyperlink 设置。
    本技能生成的 xlsx 超链接在 WPS 中可正常点击。

Q3：手机上能点击超链接吗？
A3：file:/// 本地链接不行（文件不在手机）。云文档/微盘链接可以。

Q4：个人微信发不出去？
A4：确认用的是 wechat-access 通道，target 是微信 userId（数字），
    不是 openclaw-weixin（需扫码登录）。

================================================================
                         — 完 —
================================================================
