Vault Interface
Public project metadata

只公开项目需要被看见的那部分信息。

Vault Interface 为项目提供一套稳定、可验证、与具体平台无关的公共描述方式。私人研究、工作记录、未发布作品、私有部署清单、提供商账户状态、凭据及其他未批准公开的运维信息继续留在私人空间;公共接口只暴露经过确认、适合公开的最小元数据。非敏感的构建来源、版本或发布状态可以在项目明确批准后公开。

第一次接触整个体系?

如果你还不知道 AHICP、PPF、Vault Interface 和 Starter 怎样配合,可以先从 AHICP 介绍页开始。那里从使用者角度解释整套体系,并说明怎样让 AI 继续完成技术配置。

核心思想:公共描述不等于公开整个项目

私人项目状态

研究笔记、Working Memory、未发布手稿、私有仓库位置、私有部署清单、提供商账户状态、访问凭据、内部决策和其他未批准公开的信息。

公共项目描述

当前 Schema 的核心必填字段包括项目 ID、双语标题、类型、状态、领域、主题、source_of_truth 与 website。其他字段只有在 Schema 允许且项目明确批准时才公开;私有仓库地址可以省略。

Vault Interface 的作用不是“把私人 Vault 搬到公共网络”,而是定义一层最小、清楚、可验证的公共投影。

这层接口怎样工作

1 · 私人项目
项目内部保留完整内容、工作状态、来源,以及不应公开的部署与提供商状态;经批准的非敏感构建或发布元数据可以进入公共投影。
↓ 只选择允许公开的字段
2 · 公共元数据
使用统一 Schema 描述项目和网站。私有仓库地址等敏感定位信息可以省略,不是必填项。
↓ 验证
3 · Schema + Validator
模板和验证器检查字段结构,减少不同项目各写一套格式造成的漂移。
↓
4 · 公共发现
网站、索引、Portfolio、AI 或其他工具可以读取同一套公开信息,而不需要访问私人项目状态。

为什么要与具体平台解耦

平台可以更换

公共描述不绑定某一家 Vault、云平台、发布服务或数据库。

公开字段保持稳定

即使后台实现变化,对外的项目描述仍可以保持一致。

最小披露

只要求公共使用真正需要的字段,不为了“完整”而公开私人标识或内部状态。

自动检查

Schema 和验证器让机器能够检查格式,同时保留项目决定哪些内容可以公开的边界。

在整个体系中的位置

AHICP

管理探究、证据、决定、项目记忆和 AI 协作。

PPF

管理源内容、构建、发布、版本和归档。

Vault Interface

把允许公开的项目信息投射成统一、可验证的公共描述。

Starter

让 AI 组合、采用和升级这些独立组件。

进一步了解

阅读公共元数据不会授予私人仓库、私人工作状态或部署系统的访问权限。

Public project metadata

Publish only the part of a project that needs to be visible.

Vault Interface gives projects a stable, validated, provider-neutral way to describe themselves publicly. Private research, working state, unpublished work, private deployment inventory, provider-account state, credentials, and other unapproved operational details stay private; the public interface exposes only metadata approved for disclosure. Non-sensitive build provenance, versions, or publication state may be public when the project explicitly approves them.

New to the full stack?

If AHICP, PPF, Vault Interface, and Starter are unfamiliar, begin with the AHICP introduction. It explains the system from the user’s point of view and shows how to hand technical setup to an AI.

The core idea: a public description is not the whole project

Private project state

Research notes, Working Memory, unpublished manuscripts, private repository locations, private deployment inventory, provider-account state, credentials, internal decisions, and anything else not approved for disclosure.

Public project description

The current schema requires core fields including project ID, bilingual title, kind, status, areas, topics, source_of_truth, and website. Other fields are public only when the schema permits them and the project explicitly approves disclosure; a private repository locator may be omitted.

Vault Interface does not move a private vault onto the public web. It defines a small, explicit, validated public projection of a project.

How the interface works

1 · Private project
The project keeps full content, working state, sources, and non-public deployment/provider state internally; approved non-sensitive build or publication metadata may be included in the public projection.
↓ select only fields approved for disclosure
2 · Public metadata
A shared schema describes the project and website. Sensitive locators, such as a private repository address, can be omitted.
↓ validate
3 · Schema + validator
Templates and validators check the structure so projects do not drift into incompatible one-off formats.
↓
4 · Public discovery
Websites, indexes, portfolios, AI systems, or other tools can read the same public description without access to private project state.

Why the interface is provider-neutral

Providers can change

The public contract is not tied to one vault product, cloud platform, publishing service, or database.

Public fields stay stable

Back-end implementation can change without forcing every public consumer to learn a new project format.

Minimize disclosure

Only fields that public consumers actually need are required. Private identifiers are not exposed merely for completeness.

Validate automatically

Schemas and validators make the format machine-checkable while the project still decides what may be disclosed.

Where Vault Interface fits in the stack

AHICP

Handles inquiry, evidence, decisions, project memory, and AI collaboration.

PPF

Handles source, build, publication, releases, and archive.

Vault Interface

Projects the information approved for disclosure into a shared, validated public description.

Starter

Lets an AI compose, adopt, and upgrade the independent components.

Go deeper

Reading public metadata never grants access to a private repository, private working state, or deployment systems.