姚章浩
67a4a6582b
本仓此前没有任何 agent 上下文文件，代理每次都得重新讲一遍规范。 新增 AGENTS.md：指向系统级规范（zheromiku/eng-standards-main），并写明 本仓已核实的现状（CI / runner / main 已受分支保护）。 为什么用 AGENTS.md 而不是 .hermes.md：Codex / Claude Code / OpenCode 读的 也是 AGENTS.md，跨工具可移植。
Knowledge Adapter Service
Small Python 3.12/FastAPI adapter for Dify External Knowledge retrieval through an existing WeKnora deployment, with stable UUID image URLs backed by a Private Alibaba Cloud OSS bucket.
Status
Slices 1–8 provide implementation, automated tests, and prepared delivery artifacts. Production deployment is not authorized. Slice 9 must complete real test-environment Dify → Adapter → WeKnora → OSS E2E and produce an audit report before a production decision.
Documentation
- Architecture
- Security model
- Test deployment and rollback
- Key and credential rotation
- Slice 9 verification and E2E audit
Local validation
make check
Compose rendering requires an external non-secret env file:
make compose-config ENV_FILE=/absolute/path/to/adapter.env
Neither target starts containers. image-build is explicit and requires Docker access; no target deploys or modifies production.