mcpField
S
setup

setup

github.com/glebis安全40266 次安装2 天前更新
代码仓库

关于 setup

confide:setup 是 CONFIDE 本地去标识化工具包的一键安装与配置脚本,适用于准备使用 confide:anon 和 confide:red 的用户。它检查依赖与 Ollama 状态,并写入默认配置;就绪检查和配置写入不会读取或传输文本内容。

主要功能

  1. 01检查依赖与服务就绪状态
  2. 02安装核心依赖并拉取模型
  3. 03写入或重置默认配置
  4. 04查看当前配置
  5. 05就绪检查仅输出状态信息

适用场景

  1. 01首次安装 CONFIDE 工具包
  2. 02检查运行脱敏工具前的依赖
  3. 03为本地文本处理写入默认设置

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/glebis/claude-skills --skill setup

安装后在 Claude Code 中输入/setup确认已加载。

附带文件scripts/setup.py

详细介绍

confide:setup

一次性安装程序 + 最优默认配置写入器,适用于 CONFIDE 本地去标识化工具包。运行后,confide:anon(编辑文字记录)和 confide:red(检查残余的再识别风险)无需进一步配置即可使用。

本地优先: 所有检测和编辑都在用户的计算机上运行。就绪状态检查和配置写入绝不会读取、打印或传输任何文字记录文本或 PII——只涉及布尔值和配置路径。

适用场景

触发语句:“set up confide”“install confide”“configure confide de-id”“confide setup”“get confide ready to anonymize”。

运行方式

入口点为 scripts/setup.py。它会导入共享核心(shared/confide_core.py)中的规范 DEFAULTS——请勿在此处重新定义偏好设置。

  1. 检查就绪状态(默认,不安装):

    python3 skills/setup/scripts/setup.py --check
    

    输出 ✓/✗ 表格:Python 依赖是否可导入(natasha、scrubadub、phonenumbers、pymorphy2)、Ollama 是否可访问(GET ollama_host/api/tags)、是否已拉取 anon_model、PATH 中是否有 llama.cpp(可选),以及配置是否存在。仅包含布尔值——不含 PII。

  2. 安装所有内容(尽力而为,容忍失败):

    python3 skills/setup/scripts/setup.py --install            # core deps + ollama pull
    python3 skills/setup/scripts/setup.py --install --with-presidio   # + optional EN baseline
    
    • 使用 pip 安装:natasha scrubadub phonenumbers pymorphy2 pymorphy2-dicts-ru "setuptools<81"(setuptools<81 为 pymorphy2 提供 pkg_resources)。可通过 --with-presidio 启用可选的 presidio-analyzer。
    • 如果 PATH 中有 ollama,则运行 ollama pull qwen2.5:3b。
    • 每个步骤都会报告 ✓/✗;某个步骤失败不会中止其他步骤。
  3. 写入最优默认配置(幂等):

    python3 skills/setup/scripts/setup.py --write-config   # writes only if absent
    python3 skills/setup/scripts/setup.py --reconfigure    # overwrites with defaults
    python3 skills/setup/scripts/setup.py --show           # print current config
    

    首次运行且不存在配置时,脚本会自动写入默认值。 --write-config 不会覆盖现有的(用户自定义)配置;如需强制重置,请使用 --reconfigure。

配置位于 ~/.config/confide/config.json。

选定的最优偏好设置(来自 SPEC.md)

根据 confide_core.DEFAULTS 写入:

键值原因
engineollama零配置、Metal 加速,可处理长文档(llama.cpp 处理较长俄语文本需 400 秒)
anon_modelqwen2.5:3b用于准 PII 的快速本地 LLM 层
red_attacker_modelqwen2.5:3b本地默认值;这是一个下限——更强的攻击者才是真正的上限
languages["ru", "en"]双语语料
layers["regex", "natasha", "llm"]确定性 → 俄语 NER → 准 PII
redaction_styletyped_placeholder[PERSON]、[DATE] 等(可逆映射仅在本地保留,绝不发送)
privacy.local_onlytrue原始文本绝不离开本机
privacy.cloud_apisfalse默认禁用云服务
privacy.cloud_only_on_synthetictrue仅在合成数据或经同意的数据上选择性启用云端攻击者
ollama_hosthttp://localhost:11434本地 Ollama

备注

  • llama.cpp 是可选的(可复现引擎)——如果存在,则检测并记录;绝非必需。
  • confide:red 使用的更大型攻击者模型是可选的;本地 3b 默认模型会低估风险。
  • 可导入的函数,供编程调用 / 测试使用:readiness()、ensure_config(reconfigure=False)、 install(with_presidio=False)、show_config()。

评论

支持 Markdown