关于 setup
confide:setup 是 CONFIDE 本地去标识化工具包的一键安装与配置脚本,适用于准备使用 confide:anon 和 confide:red 的用户。它检查依赖与 Ollama 状态,并写入默认配置;就绪检查和配置写入不会读取或传输文本内容。
主要功能
- 01检查依赖与服务就绪状态
- 02安装核心依赖并拉取模型
- 03写入或重置默认配置
- 04查看当前配置
- 05就绪检查仅输出状态信息
适用场景
- 01首次安装 CONFIDE 工具包
- 02检查运行脱敏工具前的依赖
- 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——请勿在此处重新定义偏好设置。
-
检查就绪状态(默认,不安装):
python3 skills/setup/scripts/setup.py --check输出 ✓/✗ 表格:Python 依赖是否可导入(natasha、scrubadub、phonenumbers、pymorphy2)、Ollama 是否可访问(
GET ollama_host/api/tags)、是否已拉取anon_model、PATH 中是否有 llama.cpp(可选),以及配置是否存在。仅包含布尔值——不含 PII。 -
安装所有内容(尽力而为,容忍失败):
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。 - 每个步骤都会报告 ✓/✗;某个步骤失败不会中止其他步骤。
- 使用 pip 安装:
-
写入最优默认配置(幂等):
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 写入:
| 键 | 值 | 原因 |
|---|---|---|
engine | ollama | 零配置、Metal 加速,可处理长文档(llama.cpp 处理较长俄语文本需 400 秒) |
anon_model | qwen2.5:3b | 用于准 PII 的快速本地 LLM 层 |
red_attacker_model | qwen2.5:3b | 本地默认值;这是一个下限——更强的攻击者才是真正的上限 |
languages | ["ru", "en"] | 双语语料 |
layers | ["regex", "natasha", "llm"] | 确定性 → 俄语 NER → 准 PII |
redaction_style | typed_placeholder | [PERSON]、[DATE] 等(可逆映射仅在本地保留,绝不发送) |
privacy.local_only | true | 原始文本绝不离开本机 |
privacy.cloud_apis | false | 默认禁用云服务 |
privacy.cloud_only_on_synthetic | true | 仅在合成数据或经同意的数据上选择性启用云端攻击者 |
ollama_host | http://localhost:11434 | 本地 Ollama |
备注
- llama.cpp 是可选的(可复现引擎)——如果存在,则检测并记录;绝非必需。
confide:red使用的更大型攻击者模型是可选的;本地 3b 默认模型会低估风险。- 可导入的函数,供编程调用 / 测试使用:
readiness()、ensure_config(reconfigure=False)、install(with_presidio=False)、show_config()。