D-Bus 应用接口接入规范 ​

SERVICE="org.deepin.Reader"    # D-Bus 服务名
OBJ="/org/deepin/Reader"       # 对象路径
IFACE="org.deepin.Reader"      # 接口名（通常与服务名相同）
APP_ID="org.deepin.reader"     # 应用标识（用于启动服务）

SERVICE="org.deepin.Reader"    # D-Bus 服务名
OBJ="/org/deepin/Reader"       # 对象路径
IFACE="org.deepin.Reader"      # 接口名（通常与服务名相同）
APP_ID="org.deepin.reader"     # 应用标识（用于启动服务）

SVC="org.deepin.Filemanager.Daemon"
BASE="/org/deepin/Filemanager/Daemon"

# 各子路径和接口
DEV_PATH="$BASE/DeviceManager"; DEV_IFACE="$SVC.DeviceManager"
VAULT_PATH="$BASE/VaultManager"; VAULT_IFACE="$SVC.VaultManager"
TAG_PATH="$BASE/TagManager"; TAG_IFACE="$SVC.TagManager"

SVC="org.deepin.Filemanager.Daemon"
BASE="/org/deepin/Filemanager/Daemon"

# 各子路径和接口
DEV_PATH="$BASE/DeviceManager"; DEV_IFACE="$SVC.DeviceManager"
VAULT_PATH="$BASE/VaultManager"; VAULT_IFACE="$SVC.VaultManager"
TAG_PATH="$BASE/TagManager"; TAG_IFACE="$SVC.TagManager"

DEST="org.mpris.MediaPlayer2.DeepinMusic"

DEST="org.mpris.MediaPlayer2.DeepinMusic"

BUS="system"                        # 使用系统总线（默认为 session）
SVC_SYS="org.deepin.SystemMonitorSystemServer"
PATH_SYS="/org/deepin/SystemMonitorSystemServer"

BUS="system"                        # 使用系统总线（默认为 session）
SVC_SYS="org.deepin.SystemMonitorSystemServer"
PATH_SYS="/org/deepin/SystemMonitorSystemServer"

# 标准：通过 ensure_service 启动
_ensure() { ensure_service session "$SERVICE" "$APP_ID|deepin-reader" || return 1; }

# 无需启动（系统常驻服务）
# 不定义 _ensure 函数

# 自定义启动逻辑
_ensure() {
    if command -v deepin-terminal &>/dev/null; then
        deepin-terminal &
    else
        ensure_service session "$SERVICE" "deepin-terminal" || return 1
    fi
}

# 标准：通过 ensure_service 启动
_ensure() { ensure_service session "$SERVICE" "$APP_ID|deepin-reader" || return 1; }

# 无需启动（系统常驻服务）
# 不定义 _ensure 函数

# 自定义启动逻辑
_ensure() {
    if command -v deepin-terminal &>/dev/null; then
        deepin-terminal &
    else
        ensure_service session "$SERVICE" "deepin-terminal" || return 1
    fi
}

tool_help() { cat <<'EOF'
reader — PDF 阅读器
  open <file> [file2...]    打开文档文件
EOF
}

tool_help() { cat <<'EOF'
reader — PDF 阅读器
  open <file> [file2...]    打开文档文件
EOF
}

# 操作 font-size → 函数 tool_font_size
tool_font_size() {
    _ensure && dbus_get_or_set session "$SERVICE" "$OBJ" \
        "$IFACE.consoleFontSize" "$IFACE.setConsoleFontSize" int32 "$1"
}

# 操作 font-size → 函数 tool_font_size
tool_font_size() {
    _ensure && dbus_get_or_set session "$SERVICE" "$OBJ" \
        "$IFACE.consoleFontSize" "$IFACE.setConsoleFontSize" int32 "$1"
}

READONLY="status metadata position"

READONLY="status metadata position"

# 操作函数：打开图片（带安全校验）
tool_open() {
    _ensure || return 1

    # 安全校验：禁止空参数
    if [ $# -eq 0 ]; then
        echo "Error: Missing file path." >&2
        return 1
    fi

    local valid_files=()
    for f in "$@"; do
        # 安全校验：检查文件是否存在且可读
        if [ ! -f "$f" ] || [ ! -r "$f" ]; then
            echo "Warning: Skipping invalid or unreadable file '$f'" >&2
            continue
        fi
        valid_files+=("$f")
    done

    # 安全校验：如果没有有效文件则中止
    if [ ${#valid_files[@]} -eq 0 ]; then
        echo "Error: No valid files to open." >&2
        return 1
    fi

    if [ ${#valid_files[@]} -gt 1 ]; then
        dbus_call_void session "$SERVICE" "$OBJ" "$IFACE.OpenFiles" \
            "array:string:$(join_args "${valid_files[@]}")"
    else
        dbus_call_void session "$SERVICE" "$OBJ" "$IFACE.OpenFile" "string:${valid_files[0]}"
    fi
}

# 操作函数：打开图片（带安全校验）
tool_open() {
    _ensure || return 1

    # 安全校验：禁止空参数
    if [ $# -eq 0 ]; then
        echo "Error: Missing file path." >&2
        return 1
    fi

    local valid_files=()
    for f in "$@"; do
        # 安全校验：检查文件是否存在且可读
        if [ ! -f "$f" ] || [ ! -r "$f" ]; then
            echo "Warning: Skipping invalid or unreadable file '$f'" >&2
            continue
        fi
        valid_files+=("$f")
    done

    # 安全校验：如果没有有效文件则中止
    if [ ${#valid_files[@]} -eq 0 ]; then
        echo "Error: No valid files to open." >&2
        return 1
    fi

    if [ ${#valid_files[@]} -gt 1 ]; then
        dbus_call_void session "$SERVICE" "$OBJ" "$IFACE.OpenFiles" \
            "array:string:$(join_args "${valid_files[@]}")"
    else
        dbus_call_void session "$SERVICE" "$OBJ" "$IFACE.OpenFile" "string:${valid_files[0]}"
    fi
}

tool_introspect() {
    local recursive="${1:-}"
    echo "=== Daemon ==="
    introspect_display session "$SVC" "$BASE" "$recursive"
    echo ""
    echo "=== TextIndex ==="
    introspect_display session "$TI_SVC" "$TI_PATH" "$recursive"
}

tool_introspect() {
    local recursive="${1:-}"
    echo "=== Daemon ==="
    introspect_display session "$SVC" "$BASE" "$recursive"
    echo ""
    echo "=== TextIndex ==="
    introspect_display session "$TI_SVC" "$TI_PATH" "$recursive"
}

ALIASES="fullscreen=FullscreenScreenshot window=TopWindowScreenshot"

ALIASES="fullscreen=FullscreenScreenshot window=TopWindowScreenshot"

#!/bin/bash
# dt-example.sh — 示例应用
SERVICE="org.deepin.Example"
OBJ="/org/deepin/Example"
IFACE="org.deepin.Example"
APP_ID="org.deepin.example"

tool_help() { cat <<'EOF'
example — 示例应用
  （运行 introspect 查看可用方法）
EOF
}

#!/bin/bash
# dt-example.sh — 示例应用
SERVICE="org.deepin.Example"
OBJ="/org/deepin/Example"
IFACE="org.deepin.Example"
APP_ID="org.deepin.example"

tool_help() { cat <<'EOF'
example — 示例应用
  （运行 introspect 查看可用方法）
EOF
}

#!/bin/bash
# dt-image-viewer.sh — 图片查看器

# 端点变量
SERVICE="org.deepin.ImageViewer"
OBJ="/org/deepin/ImageViewer"
IFACE="org.deepin.ImageViewer"
APP_ID="org.deepin.image-viewer"

# 帮助信息
tool_help() { cat <<'EOF'
image-viewer — 图片查看器
  open <file> [file2...]    打开图片文件
  scale [N]                 查询/设置缩放比例（浮点数）
  current                   获取当前打开的图片路径
EOF
}

# 服务启动
_ensure() { ensure_service session "$SERVICE" "org.deepin.image-viewer|deepin-image-viewer" || return 1; }

# 操作函数
tool_open() {
    _ensure || return 1

    # 输入校验：禁止空参数（参见"输入校验与健壮性"）
    if [ $# -eq 0 ]; then
        echo "Error: Missing file argument." >&2
        return 1
    fi

    local valid_files=()
    for f in "$@"; do
        # 输入校验：检查文件存在且可读
        if [ ! -f "$f" ] || [ ! -r "$f" ]; then
            echo "Warning: Skipping invalid or unreadable file '$f'" >&2
            continue
        fi
        valid_files+=("$f")
    done

    if [ ${#valid_files[@]} -eq 0 ]; then
        echo "Error: No valid files to open." >&2
        return 1
    fi

    # 通过 FD 传递文件，避免路径参数（R4）
    if [ ${#valid_files[@]} -gt 1 ]; then
        # 批量调用 OpenFiles（参数类型 ah），一次性传递所有 FD
        local fd_list=()
        for f in "${valid_files[@]}"; do
            exec {fd}<> "$f"
            fd_list+=("$fd")
        done
        dbus_call_void session "$SERVICE" "$OBJ" "$IFACE.OpenFiles" \
            "array:unix_fd:$(join_args "${fd_list[@]}")"
        for fd in "${fd_list[@]}"; do
            exec {fd}>&-
        done
    else
        exec {fd}<> "${valid_files[0]}"
        dbus_call_void session "$SERVICE" "$OBJ" "$IFACE.OpenFile" "unix_fd:$fd"
        exec {fd}>&-
    fi
}
# 数值边界校验：缩放比例须在 [0.0, 10.0] 区间（R3 能力边界）
tool_scale() {
    _ensure || return 1
    if [ -n "$1" ]; then
        # 正则校验：必须是合法数字格式（整数或浮点），防止非数字输入被 awk 静默转为 0 绕过边界
        if ! echo "$1" | grep -qE '^-?[0-9]*\.?[0-9]+$'; then
            echo "Error: scale must be a number, got '$1'." >&2
            return 1
        fi
        # 拒绝越界值
        awk -v v="$1" 'BEGIN{exit !(v+0>=0 && v+0<=10)}' || {
            echo "Error: scale must be in [0.0, 10.0]." >&2
            return 1
        }
    fi
    dbus_get_or_set session "$SERVICE" "$OBJ" "$IFACE.GetScale" "$IFACE.SetScale" double "$1"
}
tool_current() { _ensure && dbus_call session "$SERVICE" "$OBJ" org.freedesktop.DBus.Properties.Get "string:$IFACE" "string:CurrentFileName"; }

# 只读操作（不需要启动服务，只需检查）
READONLY="current"

#!/bin/bash
# dt-image-viewer.sh — 图片查看器

# 端点变量
SERVICE="org.deepin.ImageViewer"
OBJ="/org/deepin/ImageViewer"
IFACE="org.deepin.ImageViewer"
APP_ID="org.deepin.image-viewer"

# 帮助信息
tool_help() { cat <<'EOF'
image-viewer — 图片查看器
  open <file> [file2...]    打开图片文件
  scale [N]                 查询/设置缩放比例（浮点数）
  current                   获取当前打开的图片路径
EOF
}

# 服务启动
_ensure() { ensure_service session "$SERVICE" "org.deepin.image-viewer|deepin-image-viewer" || return 1; }

# 操作函数
tool_open() {
    _ensure || return 1

    # 输入校验：禁止空参数（参见"输入校验与健壮性"）
    if [ $# -eq 0 ]; then
        echo "Error: Missing file argument." >&2
        return 1
    fi

    local valid_files=()
    for f in "$@"; do
        # 输入校验：检查文件存在且可读
        if [ ! -f "$f" ] || [ ! -r "$f" ]; then
            echo "Warning: Skipping invalid or unreadable file '$f'" >&2
            continue
        fi
        valid_files+=("$f")
    done

    if [ ${#valid_files[@]} -eq 0 ]; then
        echo "Error: No valid files to open." >&2
        return 1
    fi

    # 通过 FD 传递文件，避免路径参数（R4）
    if [ ${#valid_files[@]} -gt 1 ]; then
        # 批量调用 OpenFiles（参数类型 ah），一次性传递所有 FD
        local fd_list=()
        for f in "${valid_files[@]}"; do
            exec {fd}<> "$f"
            fd_list+=("$fd")
        done
        dbus_call_void session "$SERVICE" "$OBJ" "$IFACE.OpenFiles" \
            "array:unix_fd:$(join_args "${fd_list[@]}")"
        for fd in "${fd_list[@]}"; do
            exec {fd}>&-
        done
    else
        exec {fd}<> "${valid_files[0]}"
        dbus_call_void session "$SERVICE" "$OBJ" "$IFACE.OpenFile" "unix_fd:$fd"
        exec {fd}>&-
    fi
}
# 数值边界校验：缩放比例须在 [0.0, 10.0] 区间（R3 能力边界）
tool_scale() {
    _ensure || return 1
    if [ -n "$1" ]; then
        # 正则校验：必须是合法数字格式（整数或浮点），防止非数字输入被 awk 静默转为 0 绕过边界
        if ! echo "$1" | grep -qE '^-?[0-9]*\.?[0-9]+$'; then
            echo "Error: scale must be a number, got '$1'." >&2
            return 1
        fi
        # 拒绝越界值
        awk -v v="$1" 'BEGIN{exit !(v+0>=0 && v+0<=10)}' || {
            echo "Error: scale must be in [0.0, 10.0]." >&2
            return 1
        }
    fi
    dbus_get_or_set session "$SERVICE" "$OBJ" "$IFACE.GetScale" "$IFACE.SetScale" double "$1"
}
tool_current() { _ensure && dbus_call session "$SERVICE" "$OBJ" org.freedesktop.DBus.Properties.Get "string:$IFACE" "string:CurrentFileName"; }

# 只读操作（不需要启动服务，只需检查）
READONLY="current"

#!/bin/bash
# dt-calculator.sh — 计算器
SERVICE="org.deepin.Calculator"
OBJ="/org/deepin/Calculator"
IFACE="org.deepin.Calculator"
APP_ID="org.deepin.calculator"

tool_help() { cat <<'EOF'
calculator — 计算器
  （运行 introspect 查看可用方法，方法名可直接作为操作名调用）
EOF
}

#!/bin/bash
# dt-calculator.sh — 计算器
SERVICE="org.deepin.Calculator"
OBJ="/org/deepin/Calculator"
IFACE="org.deepin.Calculator"
APP_ID="org.deepin.calculator"

tool_help() { cat <<'EOF'
calculator — 计算器
  （运行 introspect 查看可用方法，方法名可直接作为操作名调用）
EOF
}

# 查看接口
deepin-cli-tools calculator introspect

# 直接调用（通过通用调度，自动 Introspect 匹配）
deepin-cli-tools calculator Calculate "1+2*3"

# 查看接口
deepin-cli-tools calculator introspect

# 直接调用（通过通用调度，自动 Introspect 匹配）
deepin-cli-tools calculator Calculate "1+2*3"