Question 1

如何阻止 security-guidance 插件的 python_subprocess_shell 规则标记 Markdown 文档中的代码？

Accepted Answer

这是安全指南 v2.0.0 中已知的误报情况。该规则当前缺少用于排除文档文件的路径过滤器。作为临时解决方案，您可以忽略 .md/.mdx/.rst 文件中的这些警告，或手动编辑 hooks/patterns.py，在规则中添加 `path_filter: lambda p: not p.endswith(_DOC_EXTS)`。预计未来更新中将提供正式修复；请跟踪问题 #2045 了解进展。

Question 2

如何修复 security-guidance 插件中的 'output_format deprecated' HTTP 400 错误？

Accepted Answer

更新 plugins/security-guidance/hooks/llm.py，将 schema 嵌套到 output_config.format 下，而不是已弃用的顶层 output_format。具体而言，将 `"output_format": {"type": "json_schema", "schema": output_schema}` 替换为 `"output_config": {"format": {"type": "json_schema", "schema": output_schema}}`。如果你在 adaptive-thinking 分支上，请将 `effort` 合并到现有字典中：将 `payload["output_config"] = {"effort": "high"}` 改为 `payload["output_config"]["effort"] = "high"`。该补丁位于 issue #2097。这解决了 400 错误并防止防护栏失效。

Question 3

为什么Claude Code在没有给出任何原因的情况下显示“Permission to use Edit has been denied”？

Accepted Answer

安全指南插件钩子通过`sys.exit(2)`发出拒绝信号，且未携带JSON负载，导致生成通用拒绝消息。请将该插件升级至能输出包含`permissionDecisionReason`的正确JSON拒绝消息的版本。如无法立即升级，请手动修补钩子脚本（例如`security_reminder_hook.py`），将裸`sys.exit(2)`替换为：

```python
import json
print(json.dumps({
    "hookSpecificOutput": {
        "hookEventName": "PreToolUse",
        "permissionDecision": "deny",
        "permissionDecisionReason": f"{rule_name}: {reminder[:120]}"
    }
}))
sys.exit(0)
```

此举可在UI中提供上下文（匹配模式、风险类别）。请追踪上游修复以移除本地补丁的需求。

Question 4

为什么Claude Code的安全指南钩子会显示'hook json output validation failed'错误？

Accepted Answer

该钩子输出的是纯文本而非 JSON。编辑 hooks/security_reminder_hook.py 第 272 行：将 `print(reminder, file=sys.stderr); sys.exit(2)` 替换为 `print(json.dumps({"decision": "block", "reason": reminder})); sys.exit(2)`。这将输出有效的 JSON，从而解决验证错误。

Question 5

为什么 Microsoft Store Python 会报错 "can't open file ... [Errno 2] No such file or directory",即使文件在 Windows 上确实存在?该如何修复?

Accepted Answer

根本原因:Microsoft Store/MSIX 版本的 Python(例如 `PythonSoftwareFoundation.Python.3.10`,从 PATH 解析为 `WindowsApps` 下的 `python3.10`/`python3`)运行在 Windows AppContainer 沙箱中。它能通过 `python -c` 探测并报告真实的版本号,但被拒绝读取其他应用的数据文件夹(例如 `%APPDATA%\Roaming\Claude\...`),因此对于明确存在的文件也会报告 Errno 2。`sg-python.sh` 在 Pass 1 中就锁定了这个解释器,永远不会回退到可正常工作的 python.org 安装版本,因此每个 hook(`UserPromptSubmit`、`PostToolUse`、`Stop`)都会失败——而带有 `asyncRewake: true` 的 `Stop` 会在每一轮重新触发该错误。

修复方案 A —— 从 PATH 中移除沙箱化的解释器:卸载 Store 版 Python(设置 > 应用),或在 设置 > 应用 > 高级应用设置 > 应用执行别名 中禁用它,然后从 python.org 安装 Python,并用 `where python` / `where python3` 验证真正的解释器被优先解析。

修复方案 B —— 修补 `sg-python.sh`,使探测验证真实的脚本执行,而不仅仅是 `-c`。将一个一次性脚本写入与目标脚本相同的目录(不是 /tmp —— 该目录在沙箱允许的范围内,无法重现故障):

```sh
can_run_script() {
    local target_dir="$1"; shift
    target_dir="$(dirname -- "$target_dir")"
    local tmp="$target_dir/.sg-python-probe-$$.py"
    printf 'pass
' > "$tmp" 2>/dev/null || return 1
    if command -v cygpath >/dev/null 2>&1; then
        "$@" "$(cygpath -w "$tmp")" >/dev/null 2>&1
    else
        "$@" "$tmp" >/dev/null 2>&1
    fi
    local rc=$?
    rm -f "$tmp" 2>/dev/null
    return $rc
}
```

然后在全部三轮(pass)中,将每个 `exec` 调用点都用 `is_sdk_compatible "$v" && can_run_script "$1" "$cmd"` 作为前置条件(`$1` = 真实的目标脚本路径)。这样 shim 就会跳过沙箱化的 Store 版 `python3.10`/`python3`,回退到 python.org 的 `python`(例如 `C:\PythonXXX\python.exe`)。

使用以下命令验证:`bash sg-python.sh "$PLUGIN_ROOT/hooks/security_reminder_hook.py"` —— 它应该成功执行,而不是报 Errno 2 失败。

claude-plugins-official

项目简介

README 预览

常见问题 (5)

同类型项目

awesome

public-apis

project-based-learning

computer-science