ID Protocol

ID Protocol — AI 工具的可移植上下文

将工作偏好保存在由你掌控的文件中。ID 将经过审核的个人资料转化为精简且经过隐私筛选的上下文，可在不同 AI 工具和代码仓库之间使用。

五分钟上手

需要 Python 3.11 或更高版本。

uv tool install id-protocol
mkdir my-id-profile && cd my-id-profile
idctl init --owner-id demo

编辑 profiles/demo/profile.minimal.md，然后构建并检查可移植输出：

idctl validate --owner-id demo
idctl refresh-soul --owner-id demo
idctl export-compact --owner-id demo
idctl diff --owner-id demo --since 7d

入门个人资料在你审核之前只是临时版本。请使用 demo 或 my-work-profile 这样的别名，无需提供法定姓名。ID 不会上传生成的文件。

文件与所有权

文件	用途
profile.minimal.md	由所有者编辑的精简起始个人资料
profile.core.md	需要更完整来源时使用的规范个人资料
profile.extended.md	可选的详细工作流和上下文
privacy-policy.v1.json	对各字段的导出权限设置
handshake.md	应用上下文时使用的简明规则
soul.md	为 Agent 生成的简短引导内容
context.compact.json	经过隐私筛选的可移植上下文
mcp.context.resource.json	外部 MCP 适配器的资源载荷

Markdown 个人资料仍是事实来源。生成的 JSON 是传输视图，可能会省略细节。此软件包是本地 CLI，不提供 MCP 服务，也不会同步供应商账户。

隐私行为

导出精简上下文和 MCP 资源时，需要有效策略，且其 owner_id 必须与请求的个人资料匹配。未列出的字段仅保留在本地。缺失、格式错误、混用、冲突或所有者不匹配的策略都会阻止导出。

早期版本的旧版列表策略会在验证和导出期间于内存中规范化。其源文件保持不变，限制仍然有效。--allow-unfiltered 仅允许在经过审核的旧版工作流中缺少策略时继续操作；它不能绕过无效策略。

将导出内容附加到其他工具之前，请先检查结果。请参阅隐私模型、策略架构和威胁模型。

ABVX 工具链

产品	职责	经测试的版本
ID	人类偏好和操作约束	0.5.2
agentsgen	代码仓库说明和命令	0.5.0
SET	以审核为先的工作流规划和导出	0.4.0
abvx-agent-skills	可选的可复用工作流	0.15.0

这些工具仍可独立安装。ID 不会安装配套工具，也不会授予工具权限。

对于已包含经过审核的 ID 个人资料的代码仓库：

idctl install-set-hook --path .

适配器会向 SET 返回所有者本地引导指针，并保留现有的自定义钩子。请参阅SET 集成指南。

证据

三个可复现的演示使用合成数据，展示已安装环境中的引导流程、经策略筛选后的省略行为、旧版策略兼容性，以及 agentsgen/SET 交接。它们衡量本地 CLI 行为和运行时，而非 AI 答案质量。

历史基准快照是一个附带明确限制的小型示例。AI 客户端的行为仍取决于各自的配置和上下文规则。

开发

git clone https://github.com/markoblogo/ID.git
cd ID
python -m venv .venv
. .venv/bin/activate
python -m pip install ".[dev]" build twine
make validate
make drift-check
make coverage
make release-build
make release-check

请先阅读文档索引、协议、集成边界和贡献指南。在公开的问题和拉取请求中使用合成个人资料。

ABVX 生态系统

• AGENTS.md_generator — 导出经过审核的上下文，用于仓库指南。当前版本：v0.5.1。
• AGENTS.md_generator — 确保仓库指南和机器可读上下文保持最新。当前版本：v0.5.1。
• abvx-agent-skills — 在维护工作中使用共享且可审核的 Agent 能力。当前版本：v0.16.1。

此区块由经过审核的 ABVX 生态系统注册表生成。