四家照见知识库（Fourfold Classics Knowledge Kernel）· FFCKK V1.1 Ready

• 道：道德经 · 易经 · 庄子
• 儒：论语 · 中庸 · 大学 · 孟子
• 佛：金刚经 · 心经
• 阳明：传习录

10 部经典 · 11 Pack（含共享层）· 1321 条处境照见 · 36 个处境。

一个知识节点 R1 → 收到新证据 → Issue → Evidence Bundle → Evolution Candidate → Impact Analysis → Human Review → Regression → R2。点开任何演化记录可以看到：旧版本是什么、新版本是什么、哪里变了、为什么变、引用什么证据、旧版还能不能访问。

• ✅ ① Formal R1→R2：R1 仍可完整回放（快照不可变）
• ✅ ② Historical 查 R2-only 对象 → MISS（无 current fallback）
• ✅ ③ Source S1→S2：新版本用 S2，历史版本仍绑定 S1
• ✅ ④ Relation / Path 修改 → structured diff 可见
• ✅ ⑤ P0 Issue → Candidate → Review → Regression → Release trace 完整
• ✅ ⑥ Release 出问题 → rollback → 问题 Release 不被删除

六闭环验收：docs/V0.7/reports/V07_1_CLOSURE_EVOLUTION_REPORT.md · 跨产品 Truth：docs/V0.7/reports/V07_1_CLOSURE_CROSS_PRODUCT_REPORT.md · 演化 API：/api/classics/v1/evolution/*

• MCP · https://ffckk.halfwaylab.cn/mcp — 标准 MCP（Streamable HTTP）：ffckk_orchestrate / ffckk_insight / ffckk_compare / ffckk_source / ffckk_path / ffckk_lookup / ffckk_personal_evolution / ffckk_trusted_query；每用户/产品独立 API Key（Bearer），用量自动记录（鉴权强制）
• POST /api/classics/v1/trusted-query — V1.0 Trusted Query（协议 §42）：query + knowledge_scope + expression_mode → answer / trust（T0–T4 Trust Badge）/ claims / citations / has_conflict / abstention / evidence_drawer，protocol=FFCKK-TKP-1.0（Bearer）
• POST /api/classics/v1/illuminate — V1.1 语境理解与照见：query(+minimal_context) → context / focused_question / perspectives（四家）/ contrast / insight / reflection / action / claims / evidence_drawer，protocol=FFCKK-Illumination-1.1（Bearer）
• GET /api/classics/v1/trusted-query/sources — V1.0 Source Registry（按 source_grade S0–S4，Bearer）
• GET /api/classics/v1/trusted-query/audit — V1.0 可信回答审计链（append-only，Bearer）
• POST /api/classics/v1/orchestrate — V0.6 智能编排（Intent → Route → Plan → Select → Assemble → Trace + explanation，Bearer；五产品 productId 产品化编排）
• GET /api/classics/v1/orchestrate/observations — 编排观测（intent/route/cacheHit/耗时，Bearer）
• POST /api/classics/v1/agent/run — V0.7.1 Agent 编排壳（按 plan 执行只读工具 + Guard + Budget + Run Trace，Bearer）
• /api/classics/v1/evolution/…V0.9… — 知识演化引擎：change-signals（检测/交接）、state（create/evolve/rollback/history/compare）、semantic-drift（检测/交接）、graph-evolution（node/relation/correction/expansion/proposals）、conflicts（register/perspectives/review/resolve）、agents（run/tools/proposals）、events（emit/transition）、audit、personal-evolution（隐私边界）、metrics（Bearer；治理写操作需 X-Actor，AI 被拒）
• /api/classics/v1/discovery/* — V0.8 知识发现：sources/signals/candidates/qualifications/engine（relation/conflict/gap）/handoff/auto-handoff/trust/open-web/external-packs/agent/products-matrix/observation（Bearer；Candidate-only，永不绕过治理）
• /api/classics/v1/evolution/* — V0.7 演化治理：signals/triage/issues、candidates/transition/revise、evidence、impact、review/approvals、regression、evolution lineage、sources/rights、policy/benchmark、drift（GET 查询 + POST 检测）、historical snapshot/replay/diff、manifests、products pins（Bearer；治理写操作需 X-Actor 头）
• POST /api/classics/v1/insights — 经典照见（四家视角 + 行动方案，Bearer；synthesize:true 附加跨家整合综合回答）
• POST /api/classics/v1/runtime — 统一 Knowledge Runtime（lookup/explore/compare/source/path/report_support，Bearer）
• POST /api/classics/v1/runtime/adapters/:id/execute — Product Adapter 端到端（FRA/FPP/FRC/Half Atlas/Voice fixture，Bearer）
• GET /api/classics/v1/runtime/observations — Runtime 遥测（按模式汇总 + 最近记录，Bearer）
• GET /api/classics/v2/graph/* — Graph V2（Bearer）
• POST /api/classics/v3/graph/runtime — Graph Runtime V3（Bearer）
• POST /api/classics/v3/graph/studio-query — 图谱查询（公开限流）
• GET /api/classics/v3/workbench/relations|dimensions — 关系/维度（公开）
• POST /api/classics/v3/workbench/impact — Impact 分析（公开）
• GET /api/classics/v3/workbench/candidates — 候选收件箱（Bearer）
• POST /api/classics/v3/workbench/candidates/batch-review — 批量审校（Bearer）
• GET /api/classics/v3/workbench/releases — 候选 Release 清单（Bearer）
• POST /api/demo/compare — Demo 对比（公开限流）

完整契约：/openapi.json · 第三方 AI 接入指南（MCP + REST）：docs/THIRD_PARTY_API_GUIDE_V1.0.md

版本口径声明

V1.1 Context Understanding & Illumination Engine（/api/classics/v1/illuminate：Context→Question Focus→四家照见→共识差异→照见 Insight→反思/行动，protocol=FFCKK-Illumination-1.1）+ V1.0 Trusted Knowledge Protocol（/api/classics/v1/trusted-query，Evidence→Trust→Expression，protocol=FFCKK-TKP-1.0）；延续 V0.9 Knowledge Evolution Engine（已获生产授权，V09_PRODUCTION_AUTHORIZATION_GRANTED=true）+ V0.8 Discovery + V0.7 演化治理 + V0.6 智能编排 + V0.5 统一 Runtime；AI 只发现/提议/分析，不批准不更新；未切换 Active、未改 Formal/Rights/Historical；产品投影仅 staging，尚无默认业务调用；V1.0/V1.1 生产授权位待项目方显式授予。

「production 环境」≠「默认业务座底」：环境可生产，但产品投影仍为 staging、无默认调用。Trustware 口径以本声明与 /ready 为准。

权威事实表（/api/classics/v1/ready 同源，供外部审计复核）

Active Releases：

V1.1（当前，已部署） Context Understanding & Illumination

• ✅ 语境理解（Context Model：surface/tension/stakes/constraints/desired + C1/C2/C3 置信）
• ✅ 问题聚焦（Focused Question：找到"真正值得回答的问题"）
• ✅ 四家照见（道/儒/佛/阳明，每家 50–100 字，明显不同）+ 共识与差异
• ✅ 照见 Insight（重新聚焦为一个洞见，非摘要/鸡汤）+ 反思问题 + 可选最小行动
• ✅ 全程保留 V1.0 Evidence/Citation（可信边界）；protocol=FFCKK-Illumination-1.1
• ✅ 包测试 3/3 + V1.1 七项评价 7/7；生产已部署（/illuminate）

V1.1 计划与规范：docs/V1.1/FFCKK_V1.1_开发计划与实现规范.md · 验证与交接：docs/V1.1/FFCKK_V1.1_验证与交接报告.md

V1.0（已部署） Trusted Knowledge Protocol

• ✅ 六组件协议内核（@halfway/classics-trust）：Source Registry（S0–S4）/ Evidence Fragment Store（MSES）/ Claim Engine（六类 + Truth Boundary + 反洗白）/ Trust Engine（T0–T4 + Conflict + Critical Claim + Abstention）/ Expression Renderer（Mode A–E + Evidence Drawer）/ Citation Validator（MUST 01–10）+ Audit Log
• ✅ 13 步管道 → POST /api/classics/v1/trusted-query（protocol=FFCKK-TKP-1.0）；检索复用 V0.x 智能编排（语义+处境匹配），自由措辞问题可命中
• ✅ 表达五模式 + Trust Badge + 查看依据（Evidence Drawer）+ Abstention 拒答（不伪造知识）；T0 不得作为确定事实输出
• ✅ Demo 三栏对比（通用 AI / 四家照见 / V1.0 可信回答）；MCP 新增 ffckk_trusted_query（8 工具）
• ✅ 46 协议单测 + Golden 19/19 + API 测试全绿；生产已部署（/ready apiVersion 1.0.0）

V1.0 规划与规范：docs/V1.0/FFCKK_V1.0_Trusted_Knowledge_Protocol_实现规划与规范.md · 验证与交接：docs/V1.0/FFCKK_V1.0_验证与交接报告.md

V0.9（当前，已获生产授权） 知识演化引擎

• ✅ Change Detection Engine：source/entity/relation/timeline/semantic 变化检测 + 假变化过滤 + 资格四问 + 优先级 + Evidence Binding + Governance Handoff
• ✅ Knowledge State Version：不可变版本历史（before/after + reason + evidence + approval）、diff、rollback（回滚即新版本，不删历史）
• ✅ Semantic Drift：term/concept/relation/context 四层 + EXPANSION/NARROWING/SHIFT/REINTERPRETATION/LOSS/REVIVAL；Similarity ≠ Meaning 永久拒收；文化/哲学语义强制人工
• ✅ Graph Evolution：节点（Created→Enriched→Connected→Reinterpreted→Archived）+ 关系（Candidate→Verified→Active→Changed→Deprecated）+ 强度模型 + 修正/扩展提案
• ✅ Conflict Resolution：source/interpretation/historical/semantic/evidence 五类 + Evidence-based Debate + Resolution 状态机（MERGE/KEEP_MULTIPLE/PRIORITIZE/DEFER/ARCHIVE），AI 不裁决
• ✅ Evolution Agent：Research/Change/Semantic/Conflict/Graph/Evidence/Review 7 角色，只读工具，Proposal 需证据，AI 建议≠决策
• ✅ Evolution Event System：六类事件 + 队列（pending→processing→review→approved，approved 仅人工）+ 自动路由
• ✅ Evolution Audit：operation/decision/evidence/version 四类日志，只追加不可改（责任追溯）
• ✅ Personal Evolution：experience→memory→reflection→pattern→insight + 用户行为变化检测；owner/permission/sharingScope 必填，不存 raw transcript
• ✅ Evolution Metrics：freshness / change acceptance / conflict resolution / trust stability（Score ≠ Truth）
• ✅ Evolution Golden 18/18、V0.9 单元+API 82/82、生产授权（V09_PRODUCTION_AUTHORIZATION_GRANTED=true）

V0.9 结项与授权：docs/V0.9/reports/V09_PRODUCTION_AUTHORIZATION_REPORT.md · Benchmark docs/V0.9/reports/V09_EVOLUTION_BENCHMARK.md

V0.8（已发布，已获生产授权） 知识发现与可信生长

• ✅ 知识发现层：Source/Signal/Candidate/Qualification/Engine（relation/conflict/gap/cross-knowledge）/Scoring/Handoff/Security + Observation（持久化）
• ✅ Open Web Candidate-only、External Pack 永不 Formal、Discovery Agent 只读提议、五产品 Discovery 矩阵
• ✅ Discovery Golden 8/8、Security 9 攻击面 0 越权、Discovery→V0.7 治理端到端
• ✅ 结项：V08_ACCEPTED_WITH_DEFERRED_NONCRITICAL_ITEMS + 生产授权（V08_PRODUCTION_AUTHORIZATION_GRANTED=true）

V0.8 结项与授权：docs/V0.8/reports/V08_FINAL_ACCEPTANCE.md · docs/V0.8/reports/V08_PRODUCTION_AUTHORIZATION_REPORT.md

V0.7（已发布） 知识演化与持续改进

• ✅ 演化闭环：Observe → Issue → Evidence → Candidate → Impact → Human Review → Regression → Release → Observe Again（/api/classics/v1/evolution/*）
• ✅ 演化执行：Formal/Relation/Path/Source/Rights/Policy/Benchmark/Drift + Historical Snapshot/Diff/Replay + Release Impact Manifest
• ✅ 五产品演化：Exact Pin（不自动升级）、显式迁移、历史回放、权限分离、跨产品 Truth Divergence=0（Scenario A-J）
• ✅ 治理边界：AI 可提议不可批准、Usage/Feedback 不定义 Truth、演化不改写历史、Critical Zero=0
• ✅ 结项：V07_ACCEPTED_WITH_DEFERRED_NONCRITICAL_ITEMS + Batch 23 生产授权（V07_PRODUCTION_AUTHORIZATION_GRANTED=true）

V0.7 结项与授权：docs/V0.7/reports/V07_FINAL_ACCEPTANCE_REPORT.md · docs/V0.7/reports/V07_PRODUCTION_AUTHORIZATION_REPORT.md

V0.6（已发布） 知识智能编排与可信适配

• ✅ 知识智能层：Intent 理解（16 意图 + 歧义/澄清）→ Knowledge Router（最小化 packScope + reason codes）→ Orchestration Plan → Adaptive Assembly（10 档案，Generated-as-Formal=0）
• ✅ Explainability：/orchestrate 返回人话解释（为什么选/为什么没选/来源/缺家披露）+ MCP ffckk_orchestrate summaryOnly
• ✅ 五产品产品化编排（half-atlas/fra/fpp/frc/voice：graph/path/evidence/discussion/support-first）+ 跨产品 Formal Identity 15/15
• ✅ 评测与安全：57 测试、intent/routing 13、跨家 20、Security Abuse 6/6、Agent 写工具 13/13、red-team 18
• ✅ 缓存与治理：Intent/Route 缓存（personal/historical 不缓存）、Release 状态机、restore 演练 PASS、SLO + incident/rollback 流程
• ✅ 结项：V06_ACCEPTED

V0.6 审计与结项：docs/V0.6/reports/V06_FINAL_ACCEPTANCE_REPORT.md · 主执行清单：docs/V0.6/四家照见知识库_FFCKK_V0.6_Codex主执行清单.md

V0.5（已发布） 知识运行层与多产品集成

• ✅ 统一 Knowledge Runtime：六种正式模式（lookup/explore/compare/source/path/report_support）+ SDK client.runtime()
• ✅ Product Adapter 契约 + 五产品 fixture（FRA/FPP/FRC/Half Atlas/Voice），响应投影遵守字段选择/分组规范
• ✅ Runtime 遥测（调用/耗时/错误按模式汇总）、只读缓存、历史快照 pin
• ✅ MCP Streamable HTTP 服务（/mcp）+ 每用户/产品独立 API Key（sha256 存储、用量日志、可单独撤销）
• ✅ 十部经典 + 四家照见 + 跨家整合 + 1287 维度 + 24 跨经典配对 + 16 真实 Path（V0.4 资产全量沿用）
• ✅ 正式 Production 已发布（ffckk.halfwaylab.cn，NODE_ENV=production）

V0.5 审计与差距：docs/V0.5/V05_BASELINE_RUNTIME_CONTRACT与INTEGRATION_GAP_AUDIT.md · V0.4 结项：docs/V0.4/V04_RC_SUMMARY.md

V0.4（已发布） 知识生产与发布就绪

• ✅ 十部经典入库（心经/中庸/大学/孟子）、四家照见机制、跨家整合综合回答
• ✅ 1287 维度 approved + 16 真实 Path + Workbench 审校闭环
• ✅ 检索决策（TF-IDF 保持）+ 第三方 API 指南 V0.4

• ✅ database — Local PostgreSQL 16; 20 releases / 50000+ review records seeded (eleven packs including four new).
• ✅ schema — S1: JSON Schema / Zod validators and database migrations are implemented.
• ✅ asset_inventory — Eleven packs (7 original + heart/zhongyong/daxue/mencius) inventoried; 1321 insight cards / 36 situations.
• ✅ canonical_import — Ten classics imported: 81 chapters (Daodejing) + 64 hexagrams (Yijing) + Lunyu + Diamond + Zhuangzi + Chuanxilu + Heart Sutra + Zhongyong + Daxue + Mencius full text.
• ✅ gold_samples_batch_1 — 24 gold samples approved by project-owner batch authorization (2026-08-04).
• ✅ formal_releases — Active releases: ddj-0.2.1 / yijing-0.2.0 / lunyu-0.2.1 / diamond-0.2.1 / zhuangzi-0.2.0 / chuanxilu-0.2.0 / shared-0.1.0 / heart-0.1.0 / zhongyong-0.1.0 / daxue-0.1.0 / mencius-0.1.0.
• ✅ pack_registry — Packs registered with published staging releases.
• ✅ product_registry — half-atlas-voice-staging active; 产品投影为 staging（尚无默认业务调用，V0.7 口径）。
• ✅ projection_registry — 五产品投影已注册（staging）；产品投影尚未默认启用（与 V0.7 状态声明一致）。
• ✅ active_releases — Active releases (11 packs): ddj-0.2.1 / yijing-0.2.0 / lunyu-0.2.1 / diamond-0.2.1 / zhuangzi-0.2.0 / chuanxilu-0.2.0 / shared-0.1.0 / heart-0.1.0 / zhongyong-0.1.0 / daxue-0.1.0 / mencius-0.1.0.
• ✅ full_text_index — In-memory full-text index built from loaded releases.
• ✅ vector_index — Local n-gram vector index built from all loaded releases (neural provider optional).
• ✅ relation_index — Relation adjacency loaded from releases.
• ✅ gate_config — Pack gates (ddj/yijing/lunyu/diamond) enforced; input-level gates apply to all routed packs; misreading inputs blocked.
• ✅ runtime_pipeline — R0-R26 pipeline with situation-aware ranking implemented and tested (staging).
• ✅ snapshot_store — In-memory snapshot and idempotency service is implemented.
• ✅ trusted_query_protocol — FFCKK V1.0 Trusted Knowledge Protocol kernel（@halfway/classics-trust）：Source Registry（S0–S4）/ Evidence Fragment Store（MSES）/ Claim Engine（六类+Truth Boundary+反洗白）/ Trust Engine（T0–T4+Conflict+Critical Claim+Abstention）/ Expression Renderer（Mode A–E+Evidence Drawer）/ Citation Validator（MUST 01–10）+ Audit Log；POST /api/classics/v1/trusted-query（协议 §42，protocol=FFCKK-TKP-1.0）。
• ✅ mcp_gateway — ffckk-mcp online（POST /mcp，Streamable HTTP）；鉴权强制：无 key → 401；工具走同一 Runtime 管线；每用户独立 key 已启用

curl -X POST https://ffckk.halfwaylab.cn/api/classics/v1/illuminate \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"query":"我应该继续坚持这份工作，还是辞职？"}'

V1.1 语境理解与照见：返回 context / focused_question / perspectives（四家 50–100 字）/ contrast / insight / reflection / action / claims / evidence_drawer，protocol=FFCKK-Illumination-1.1。

curl -X POST https://ffckk.halfwaylab.cn/api/classics/v1/trusted-query \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"query":"什么是知行合一？","knowledge_scope":["ffckk"],"expression_mode":"conversation"}'

V1.0 可信回答：返回 answer + trust（Trust Badge）+ claims（六类 + truth_boundary）+ citations + has_conflict + abstention + evidence_drawer（查看依据），protocol=FFCKK-TKP-1.0。

curl -X POST https://ffckk.halfwaylab.cn/api/classics/v1/insights \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"productId":"half-atlas-voice-staging","scenario":"stage_report","privacyMode":"private","synthesize":true,"userText":"最近同时推进太多事情，越用力越没进展"}'

返回四家视角照见 + 行动方案 + 出处/Release 版本；synthesize:true 时附加跨家整合综合回答（schools / traditions / nonEquivalences）；误读输入会被 Gate 阻断。