多功能工具箱 dgngjx-skill v4.1.0

🚀 dgngjx CLI 统一入口 ⭐ v3.9.0 新增

✅ 开箱即用（纯 Python 标准库 argparse，零依赖）

v4.1.0 新增：--install-pack 安装可选包、--list-packs 列出可用包、--health 首次体检报告。

# 直接调用工具（参数化，非交互）
dgngjx calc.mortgage --amount 1000000 --years 30 --rate 4.2
dgngjx text.encode --method base64 --text "Hello World"
dgngjx img.compress --path ./photos/ --quality 80 --format JPEG
dgngjx hash.md5 --file document.pdf
dgngjx exchange --amount 100 --from USD --to CNY

# 机器可解析输出（供 CI/计划任务使用）
dgngjx sys.monitor --json

# 无人值守模式（跳过非危险确认点）
dgngjx file.rename --dir ./photos/ --prefix "vacation_" --yes
# 或设置环境变量
export DGNGJX_ASSUME_YES=1
dgngjx img.convert --path ./photos/ --format PNG

# 包管理（v4.1.0 新增）
dgngjx --list-packs          # 列出所有可用包
dgngjx --install-pack ent    # 安装娱乐包
dgngjx --install-pack media  # 安装媒体包
dgngjx --install-pack ai     # 安装 AI 包

# 体检报告（v4.1.0 新增）
dgngjx --health              # 首次运行体检

# 无参数启动 → 进入交互向导（兼容旧体验）
dgngjx

#!/usr/bin/env python3
"""dgngjx CLI - 多功能工具箱统一命令行入口"""
import argparse, json, os, sys

def load_registry():
    """加载工具注册表"""
    reg_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "registry.json")
    with open(reg_path, encoding="utf-8") as f:
        return json.load(f)

def build_tool_index(registry):
    """将 modules[].tools 嵌套结构扁平化为 tool_id → info 索引"""
    index = {}
    for mod in registry.get("modules", []):
        for tool_id, tool_info in mod.get("tools", {}).items():
            tool_info["module_id"] = mod["id"]
            tool_info["module_name"] = mod["name"]
            tool_info["pack"] = mod.get("pack", "core")
            index[tool_id] = tool_info
    return index

def main():
    parser = argparse.ArgumentParser(prog="dgngjx", description="多功能工具箱 dgngjx-skill")
    parser.add_argument("tool", nargs="?", help="工具路径，如 calc.mortgage / text.encode / img.compress")
    parser.add_argument("--json", action="store_true", help="输出机器可解析 JSON")
    parser.add_argument("--yes", "-y", action="store_true", help="跳过非危险确认点")
    parser.add_argument("--help-tools", action="store_true", help="列出所有可用工具")
    parser.add_argument("--list-packs", action="store_true", help="列出所有可用包（v4.1.0）")
    parser.add_argument("--install-pack", metavar="PACK", help="安装指定包（v4.1.0）")
    parser.add_argument("--health", action="store_true", help="运行体检报告（v4.1.0）")
    
    args, remaining = parser.parse_known_args()
    
    if os.environ.get("DGNGJX_ASSUME_YES"):
        args.yes = True
    
    registry = load_registry()
    
    # 包管理命令
    if args.list_packs:
        packs = registry.get("packs", {})
        print("📦 可用包：")
        for pid, pinfo in packs.items():
            default = "（默认）" if pinfo.get("default") else ""
            print(f"  {pid}: {pname}{default} — {pinfo.get('description','')}")
        return
    
    if args.install_pack:
        pack_id = args.install_pack
        packs = registry.get("packs", {})
        if pack_id not in packs:
            print(f"❌ 未知包: {pack_id}。可用: {', '.join(packs.keys())}")
            return
        # 标记包已安装（写入配置文件）
        config_path = os.path.join(os.path.expanduser("~"), ".workbuddy", "dgngjx_config.json")
        config = {}
        if os.path.exists(config_path):
            with open(config_path, encoding="utf-8") as f:
                config = json.load(f)
        installed_packs = config.get("installed_packs", ["core"])
        if pack_id not in installed_packs:
            installed_packs.append(pack_id)
        config["installed_packs"] = installed_packs
        os.makedirs(os.path.dirname(config_path), exist_ok=True)
        with open(config_path, "w", encoding="utf-8") as f:
            json.dump(config, f, ensure_ascii=False, indent=2)
        print(f"✅ 已安装包: {packs[pack_id]['name']}")
        return
    
    if args.health:
        # 运行体检
        health_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "health_check.py")
        if os.path.exists(health_path):
            os.system(f"{sys.executable} {health_path} --force")
        else:
            print("❌ 未找到 health_check.py")
        return
    
    tool_index = build_tool_index(registry)
    
    if args.help_tools or not args.tool:
        if args.tool:
            tool_info = tool_index.get(args.tool)
            if tool_info:
                print(f"工具: {args.tool}")
                print(f"描述: {tool_info.get('description','')}")
                print(f"参数: {json.dumps(tool_info.get('params',{}), ensure_ascii=False, indent=2)}")
            else:
                print(f"❌ 未找到工具: {args.tool}")
        else:
            print("🔧 dgngjx-skill 交互向导")
            print("=" * 40)
            for mod in registry.get("modules", []):
                print(f"\n{mod['name']}:")
                for tool_id, tool_info in mod.get("tools", {}).items():
                    print(f"  {tool_id}: {tool_info.get('description','')}")
        return
    
    tool_info = tool_index.get(args.tool)
    if not tool_info:
        print(f"❌ 未找到工具: {args.tool}")
        print(f"可用工具: {', '.join(list(tool_index.keys())[:10])}...")
        sys.exit(1)
    
    tool_args = {}
    i = 0
    while i < len(remaining):
        if remaining[i].startswith("--"):
            key = remaining[i][2:].replace("-","_")
            if i + 1 < len(remaining) and not remaining[i+1].startswith("--"):
                tool_args[key] = remaining[i+1]
                i += 2
            else:
                tool_args[key] = True
                i += 1
        else:
            i += 1
    
    tool_args["_json"] = args.json
    tool_args["_yes"] = args.yes
    
    module = tool_info.get("module_id")
    print(f"▶ 运行: {args.tool} (模块 {module})")

if __name__ == "__main__":
    main()

30 秒速查表

🆕 v4.1.0 更新提醒

🔔 您正在使用 dgngjx-skill v4.1.0

检查更新：skillhub search dgngjx-skill

升级命令：skillhub upgrade dgngjx-skill

📧 有任何建议？联系作者邮箱：njskills@agent.qq.com

快速开始

第一次用？做这 3 步

你可以直接说（触发词）

📋 registry.json 工具注册表 ⭐ v3.9.0 新增

49 个工具的元数据注册表，包含模块/参数 schema/依赖声明/示例/安全等级。CLI 启动时只加载此文件（轻量），工具代码延迟加载。

{
  "version": "4.1.0",
  "total_tools": 49,
  "packs": {
    "core": {"name": "核心包", "description": "默认加载", "default": true},
    "ent": {"name": "娱乐包", "description": "娱乐/生活模块", "default": false},
    "media": {"name": "媒体包", "description": "图片/PDF/视频", "default": false},
    "ai": {"name": "AI包", "description": "AI 办公", "default": false}
  },
  "modules": [...]
}

字段说明：deps 为空表示零依赖；safety 为 warn 表示需用户确认；pack 表示所属包（core 默认加载，其余按需安装）。

🔒 安全规则（v3.9.0 分级重构）

dgngjx-skill v3.9.0 起采用三级安全策略：🔴 硬拦截 / 🟡 警告+确认 / 🟢 自由读写。

🔴 硬拦截（不处理，即使明确要求也拒绝）

Windows 可执行 / 批处理脚本： .bat、.cmd、.ps1、.vbs、.exe、.dll、.lnk、.msi

其他风险脚本： .sh、.com、.scr、.hta、.reg

二进制镜像 / 安装包： .iso、.dmg、.apk、.jar

系统缓存 / 隐藏文件： .DS_Store、.git 目录、.env、.log、.tmp

🟡 警告+用户确认（显示风险说明，用户确认后可读写）

Office 二进制文档： .docx、.xlsx、.pptx、.doc、.xls、.ppt、.xlsm、.docm、.pptm

⚠️ 警告内容："此操作将读取/写入 Office 文档，可能包含宏或敏感数据。确认继续？"

🟢 自由读写（非风险类型，无需确认）

图片（.jpg/.png/.webp/.bmp/.gif/.tiff）、文档（.pdf/.md/.txt/.csv/.json/.xml）、音频（.mp3/.wav/.m4a）、视频（.mp4/.gif）等非风险类型。

import os

# === v3.9.0 安全规则：三级分级策略 ===

BLOCKED_EXTENSIONS = {
    '.bat', '.cmd', '.ps1', '.vbs', '.exe', '.dll', '.lnk', '.msi',
    '.sh', '.com', '.scr', '.hta', '.reg',
    '.iso', '.dmg', '.apk', '.jar',
    '.ds_store', '.env', '.log', '.tmp',
}

WARN_EXTENSIONS = {
    '.docx', '.xlsx', '.pptx', '.doc', '.xls', '.ppt', '.xlsm', '.docm', '.pptm',
}

BLOCKED_DIRS = {'.git', '.svn', '.hg', '__pycache__', 'node_modules', '.idea', '.vscode'}

def _is_safe_file(filepath: str, assume_yes: bool = False) -> tuple:
    """检查文件安全等级。返回 (状态, 原因) 状态: 'safe' / 'warn' / 'block'"""
    basename = os.path.basename(filepath)
    if basename.startswith('.') and basename.lower() in {'.ds_store', '.env', '.gitconfig', '.bashrc'}:
        return 'block', f"隐藏系统文件 {basename} 被拦截"
    parts = filepath.replace('\\', '/').split('/')
    for part in parts:
        if part.lower() in BLOCKED_DIRS:
            return 'block', f"系统目录 {part} 被拦截"
    ext = os.path.splitext(filepath)[1].lower()
    if ext in BLOCKED_EXTENSIONS:
        return 'block', f"{ext} 可执行/风险类型被安全规则禁止"
    if ext in WARN_EXTENSIONS:
        if assume_yes:
            return 'safe', ""
        return 'warn', f"将读写 Office 文档({ext})，可能包含宏或敏感数据"
    return 'safe', ""

def _is_safe_output(filepath: str) -> tuple:
    """检查输出文件类型是否安全（不允许生成可执行/危险文件）"""
    ext = os.path.splitext(filepath)[1].lower()
    if ext in {'.exe', '.dll', '.bat', '.cmd', '.ps1', '.vbs', '.sh', '.com', '.scr', '.hta', '.reg', '.msi', '.apk', '.jar'}:
        return False, f"安全规则禁止生成 {ext} 文件"
    return True, ""

⚡ 自适应硬件调度 （v3.5 新增）

dgngjx-skill 会自动检测你的电脑配置（CPU核心数、内存大小），并根据硬件能力调整并发任务数量和资源分配，绝不拖累低配电脑。

import os, sys, subprocess, platform

def get_hardware_info() -> dict:
    """自动检测用户电脑硬件信息，用于智能调度"""
    info = {
        'cpu_count': os.cpu_count() or 2,
        'ram_mb': 0,
        'platform': platform.system(),
        'is_low_end': False,
        'max_workers': 1,
        'max_file_size_mb': 100,
    }
    
    try:
        if info['platform'] == 'Windows':
            result = subprocess.run(
                ['wmic', 'computersystem', 'get', 'TotalPhysicalMemory', '/value'],
                capture_output=True, text=True, timeout=10
            )
            for line in result.stdout.split('\n'):
                if 'TotalPhysicalMemory' in line:
                    bytes_val = int(line.split('=')[1].strip())
                    info['ram_mb'] = bytes_val // (1024 * 1024)
                    break
        elif info['platform'] == 'Linux':
            with open('/proc/meminfo', 'r') as f:
                for line in f:
                    if line.startswith('MemTotal'):
                        info['ram_mb'] = int(line.split()[1]) // 1024
                    break
        elif info['platform'] == 'Darwin':
            result = subprocess.run(
                ['sysctl', '-n', 'hw.memsize'], capture_output=True, text=True, timeout=5
            )
            info['ram_mb'] = int(result.stdout.strip()) // (1024 * 1024)
    except Exception:
        info['ram_mb'] = 4096
    
    if info['ram_mb'] < 4096 or info['cpu_count'] <= 2:
        info['is_low_end'] = True
        info['max_workers'] = 1
        info['max_file_size_mb'] = 50
    elif info['ram_mb'] < 8192 or info['cpu_count'] <= 4:
        info['max_workers'] = 2
        info['max_file_size_mb'] = 200
    else:
        info['max_workers'] = min(info['cpu_count'], 4)
        info['max_file_size_mb'] = 500
    
    return info

_HW = get_hardware_info()
print(f"🖥️ 系统检测: {_HW['cpu_count']}核 | {_HW['ram_mb']}MB RAM | {_HW['platform']}")
if _HW['is_low_end']:
    print("⚡ 已启用低配模式：单任务运行，小文件优先，绝不卡顿")
else:
    print(f"⚡ 已启用标准模式：最多 {_HW['max_workers']} 并发，文件上限 {_HW['max_file_size_mb']}MB")

调度策略一览：

📦 依赖管理

检测环境

任何功能使用前，AI 先跑这个脚本看看缺了什么：

import sys, subprocess
print(f"Python: {sys.version.split()[0]}")
pkgs = {'PIL':'Pillow(PIL)','rembg':'rembg','PyPDF2':'PyPDF2','cv2':'opencv-python','jieba':'jieba'}
for pkg, name in pkgs.items():
    try: __import__(pkg); print(f"  ✅ {name}")
    except: print(f"  ❌ {name}（缺失）")
try:
    subprocess.run(['ffmpeg','-version'], capture_output=True, text=True)
    print("  ✅ ffmpeg")
except: print("  ❌ ffmpeg（缺失）")

一键安装

pip install Pillow PyPDF2 jieba

AI 必须问用户确认后再执行。

按功能安装

⚠️ rembg 首次运行会自动下载 ~300MB 模型（1-5分钟），装好后可离线使用。 💡 jieba 为可选依赖，词频统计不装 jieba 也能用（会自动降级到正则分词）。

FFmpeg 一键安装（v3.0 简化）

💡 最简方案：打开 PowerShell，粘贴 winget install ffmpeg 一行搞定。

❌ 不支持（边界情况说明）

📦 包化架构（v4.1.0 新增）

v4.1.0 引入四包机制，SKILL.md 从 129KB 瘦身至 30KB，模块详情外置到 references/modules/*.md。

四包一览

包安装方式

# CLI 安装
dgngjx --install-pack ent
dgngjx --install-pack media
dgngjx --install-pack ai

# 查看已安装包
dgngjx --list-packs

模块详情文件

🏥 首次运行体检报告（v4.1.0 新增）

首次运行时自动检测环境，输出就绪率和缺失依赖一键安装命令。

#!/usr/bin/env python3
"""dgngjx-skill 首次运行体检报告 v4.1.0"""
import sys, subprocess, os, json, platform

HEALTH_FILE = os.path.join(os.path.expanduser("~"), ".workbuddy", "dgngjx_health.json")

def check_python():
    v = sys.version_info
    ok = v >= (3, 8)
    return {"name": "Python", "status": "ok" if ok else "warn",
            "version": f"{v.major}.{v.minor}.{v.micro}", "required": "≥ 3.8",
            "fix": None if ok else "请升级 Python 到 3.8+"}

def check_module(pkg_name, import_name=None):
    import_name = import_name or pkg_name
    try:
        __import__(import_name)
        return {"name": pkg_name, "status": "ok", "version": "", "required": "", "fix": None}
    except ImportError:
        return {"name": pkg_name, "status": "missing", "version": "", "required": "", "fix": f"pip install {pkg_name}"}

def check_ffmpeg():
    try:
        r = subprocess.run(["ffmpeg", "-version"], capture_output=True, text=True, timeout=5)
        if r.returncode == 0:
            return {"name": "FFmpeg", "status": "ok", "version": r.stdout.split(chr(10))[0][:50], "required": "", "fix": None}
    except: pass
    return {"name": "FFmpeg", "status": "missing", "version": "", "required": "视频转换/编辑", "fix": "winget install ffmpeg"}

def check_network():
    try:
        import urllib.request
        req = urllib.request.Request("https://api.github.com", headers={"User-Agent":"dgngjx/4.1"})
        urllib.request.urlopen(req, timeout=5)
        return {"name": "网络连接", "status": "ok", "version": "", "required": "", "fix": None}
    except Exception as e:
        return {"name": "网络连接", "status": "warn", "version": "", "required": "汇率/知识查询", "fix": f"网络受限: {type(e).__name__}"}

def run_health_check(force=False):
    if not force and os.path.exists(HEALTH_FILE):
        try:
            with open(HEALTH_FILE, encoding="utf-8") as f:
                prev = json.load(f)
            if prev.get("skipped", False):
                return None
        except: pass

    checks = [
        check_python(),
        check_module("Pillow", "PIL"),
        check_module("PyPDF2"),
        check_module("rembg"),
        check_module("jieba"),
        check_ffmpeg(),
        check_network(),
    ]

    ok_count = sum(1 for c in checks if c["status"] == "ok")
    missing = [c for c in checks if c["status"] == "missing"]

    print("=" * 50)
    print("  🏥 dgngjx-skill 首次运行体检报告")
    print("=" * 50)
    for c in checks:
        icon = "✅" if c["status"] == "ok" else ("⚠️" if c["status"] == "warn" else "❌")
        ver = f" ({c['version']})" if c["version"] else ""
        print(f"  {icon} {c['name']}{ver}")
    print(f"  就绪率: {ok_count}/{len(checks)} ({ok_count*100//len(checks)}%)")
    if missing:
        print("  📦 缺失依赖（一键安装）：")
        cmds = []
        for c in missing:
            if c["fix"]:
                print(f"    • {c['name']}: {c['fix']}")
                if "pip install" in c["fix"]:
                    cmds.append(c["fix"].replace("pip install ", ""))
        if cmds:
            print(f"  快速安装: pip install {' '.join(cmds)}")
    print("=" * 50)

    os.makedirs(os.path.dirname(HEALTH_FILE), exist_ok=True)
    with open(HEALTH_FILE, "w", encoding="utf-8") as f:
        json.dump({"checked": True, "skipped": False, "ok_count": ok_count, "total": len(checks)}, f)
    return checks

if __name__ == "__main__":
    force = "--force" in sys.argv
    run_health_check(force=force)

功能模块

v4.1.0 起模块详情外置，主文档只保留模块名称索引，完整代码见 references/modules/*.md。

最佳实践

场景 1：新电脑第一次用

你: "帮我检测一下环境"
AI: 跑检测脚本 → 自适应硬件调度初始化 → 体检报告
你: "帮我装一下"
AI: pip install Pillow PyPDF2 jieba
你: "帮我压缩 D:\photo.jpg"
AI: ✅ 完成

场景 2：低配电脑性能保护

处理 50MB 图片时
→ 系统检测到 4GB RAM → 自动单任务模式
→ 显示 "⚠️ 50MB 文件 → 压缩可能需1-2分钟"
→ 分配最小资源，不卡顿

场景 3：安全文件拦截

你: "帮我压缩 C:\Windows\system32\cmd.exe"
AI: 🚫 .exe 可执行程序 — 安全规则禁止处理

❓ 常见问题

Q1: 第一次使用怎么做？

直接说一句话。零依赖功能直接跑。需安装功能会提示。

Q2: 发现 skill 有更新怎么办？

skillhub upgrade dgngjx-skill

或检查：skillhub search dgngjx-skill

Q3: 有什么建议/bug？

📧 邮箱：njskills@agent.qq.com 作者会阅读每一条反馈。

Q4: 处理大文件太慢？

v3.5.0 起已根据你的硬件自动调度，低配机会自动降为小文件单任务模式，不会出现卡死。

Q5: 批量重命名风险？

必须先预览，确认输入 YES 才执行。可执行文件会自动跳过。

Q6: MD转HTML支持复杂语法吗？

支持标题、列表、代码块、引用、粗体、行内代码。复杂表格建议用 pandoc。

Q7: 汇率查询需要联网吗？

默认无需联网（内置 30+ 种常见货币缓存）。输入联网模式可获取实时汇率，联网失败自动降级到缓存。

Q8: 历史记录存在哪里？

保存在 ~/.workbuddy/dgngjx_history.json，保留最近 200 条。可随时搜索或清空。

Q9: 会议纪要需要安装 whisper 吗？

不需要。默认使用模式 C（手动粘贴文本）即可零依赖运行。需要自动化 ASR 时再安装 whisper 或配置 Paraformer API。

Q10: 周报是自动记录的吗？

是的。使用工具后，系统自动记录到 ~/.workbuddy/dgngjx_history.json。周报生成时自动汇总本周期记录。

Q11: dgngjx CLI 怎么用？

安装 skill 后，可直接用 dgngjx 模块.工具 --参数 调用。例如 dgngjx calc.mortgage --amount 1000000 --years 30 --rate 4.2。无参数启动进入交互向导。加 --json 输出机器可解析 JSON，加 --yes 或设置 DGNGJX_ASSUME_YES=1 跳过非危险确认点。

Q12: registry.json 是什么？

49 个工具的元数据注册表，包含模块归属、参数 schema、依赖声明和安全等级。CLI 启动时只加载此文件（轻量），工具代码延迟加载。

Q13: v4.1.0 的四包机制怎么用？

默认加载 core 核心包（37 个零依赖工具）。需要图片/PDF/视频功能时，运行 dgngjx --install-pack media 安装媒体包。需要娱乐功能时，运行 dgngjx --install-pack ent 安装娱乐包。运行 dgngjx --list-packs 查看所有可用包。

功能分类统计

更新日志

| v4.1.0 | 2026-09-17 | 增加：包化架构（SKILL.md 129KB→30KB + 11模块外置 references/modules/*.md）；增加：四包机制（core/ent/media/ai，CLI --install-pack/--list-packs）；增加：首次运行体检报告（Python/Pillow/PyPDF2/rembg/jieba/ffmpeg/网络/磁盘）；迁移：娱乐模块（笑话/壁纸/BMI/番茄钟）移至 ent 可选包；优化：registry.json 独立文件 + pack 字段；增加：个税五险全国化（tax_2026.yaml 数据包，13城市查表+7级分段累进引擎）；增加：汇率缓存时效治理（72h TTL + 陈旧标注 + 警示横幅）；增加：独立个税计算器（模块1.2.1） | | v3.9.0 | 2026-08-24 | 增加：统一 CLI 入口（argparse 子命令 + registry.json 注册表 + 49 工具参数化）；拆分：编码/哈希拆分为 encode + hash 独立工具；合并：图片五功能合并为 img 统一入口（compress/convert/removebg/idphoto/repair）；优化：安全规则分级重构（🔴 硬拦截 / 🟡 警告+确认 / 🟢 自由读写）；增加：无人值守支持（DGNGJX_ASSUME_YES 环境变量 + --yes + --json 输出） | | v3.8.0 | 2026-08-17 | 增加：会议纪要生成器（模块11.1 ASR三级降级链）；增加：周报/月报自动生成（模块10.6）；优化：系统资源监控（模块10.1 wmic→PowerShell CIM） | | v3.7.0 | 2026-08-07 | 增加：CSV查看器/密码强度/颜色转换/随机数/文本差异/BMI/番茄钟/汇率查询/历史记录/配置持久化/管道联动；优化：开箱即用率57%→65% | | v3.6.0 | 2026-07-07 | 增加：文件哈希/UUID/时间戳/IP工具；扩展：单位换算8→28种；扩展：编码新增MD5/SHA+进制互转 | | v3.5.0 | 2026-07-14 | 增加：硬件调度/安全过滤/系统监控/批量重命名/MD转HTML/更新提醒 | | v3.0.0 | 2026-07-13 | 增加：jieba分词/视频编辑/路径修复/FFmpeg脚本/模块9 | | v2.5.0 | 2026-07-12 | 增加：HTTP语法修复；扩充坑表格 | | v2.2.0 | 2026-07-11 | 修复：多个bug | | v2.1.0 | 2026-07-10 | 修复：单位换算float崩溃+壁纸urllib缺失 | | v2.0.0 | 2026-07-09 | 增加：国内联网优化；大文件性能增强 | | v1.0.0 | 2026-07-02 | 初始版本，8大模块29个工具 |

一键安装后可用功能

发布信息

• 作者：Admin
• 联系邮箱：njskills@agent.qq.com
• 许可证：MIT
• 支持平台：Windows / macOS / Linux
• 当前版本：v4.1.0
• 检查更新：skillhub search dgngjx-skill
• 升级命令：skillhub upgrade dgngjx-skill