merge: integrate upstream v0.3.0 with security hardening and doc cleanup

[1263-ux]

概述

从 open-agent-power/main（v0.3.0，50 个提交）合并到本分支，叠加 28 个本分支提交。总共 32 commits，66 files, +2,033 / −2,394。

前 22 个提交是合并前的本分支工作（Book POC 闭环验收、过期资产清理、原子写入加固）；后 4 个是合并后的收尾（构建修复、安全加固、文档死链修复）。

变更分类

🟢 吸收上游 v0.3.0（合并自动合入）

• oks eval recall / oks eval compare — 离线召回质量评测
• oks trace start/append/judge/feedback/propose/finish/validate — 执行轨迹（provenance，不参与召回）
• CONSTITUTION P0（Python ≥3.12）、P3/P5/A2/A4 修正
• 飞书 Worker 模块化：scripts/feishu_worker/ 子包（12 模块）
• 打包修复：.codex/.agents 入 wheel，维护者 skill 排包

🔴 安全加固（3 个独立修复）

这些是本分支发现并修复的，非上游代码的原有问题：

漏洞	严重程度	修复
Draft status: rejected 仍可晋升为 Wiki	中	store.py:promote_draft() — 晋升前检查 meta.get("status") == "rejected"，匹配 CONSTITUTION A3「人工门禁」不变量
wiki create --area "../../outside" 路径穿越	高	store.py:write_wiki_page() — 拒绝不符合 [a-z][a-z0-9-]* 的 area，覆盖 wiki create、drafts promote、drafts reject 三个入口
extractors/web.py 绕过 SSRF 防护直接 requests.get(allow_redirects=True)	高	新增 _safe_fetch() — 调用 network.py 的 assert_public_network_target 检查初始 URL 及每一跳重定向目标，拦截 127.0.0.1、10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、169.254.0.0/16

🟡 构建修复

cli/setup.py — setup() 前加 _sync_from_checkout() 调用。此前 vendoring 只在 build_py 钩子中执行，但 setuptools 在配置阶段就验证 oks_connector 包目录存在，导致 pipx install ./cli --force 从干净工作树直接失败。

🟡 资产清理

• 删除 settings/handlers.json — 注册已移入代码（cli._CAPABILITIES 字典），无运行时代码引用
• 删除 _meta/frontmatter-schema.md — 被 raw-evidence-schema.md 替代，无运行时代码引用
• 删除 capabilities/ 目录 — 能力定义在 schemas/，capability_check.py 使用硬编码模块映射
• 删除死代码（raw_ingest.py、multimodal_feedback.py、keyframe_probe.py）
• 删除未使用依赖（python-frontmatter、gitpython）

🟡 README 更新

Core CLI 区块增加 v0.3.0 新增命令（oks eval、oks trace、oks capability、recall --goal --format --explain），区分普通用户安装与开发者源码安装。

🟡 文档死链修复

修复 docs/ 下 11 处死链接（core-learning-loop-poc.md、memories.md、raw-materials.md、phase-history-summary.md 等），重写 AGENTS.md 与当前 CLAUDE.md 对齐。

合并注意事项

树冲突

三个文件已被删除，上游修改了它们。需要按本分支决定处理：

文件	本分支	建议
settings/handlers.json	已删除	保持删除 — 无运行时代码引用，注册在 cli._CAPABILITIES 中
_meta/frontmatter-schema.md	已删除	保持删除 — 被 raw-evidence-schema.md 替代
capabilities/README.md	已删除	保持删除 — 整个目录的能力定义已移至 schemas/ 和代码中

test_optional_extensions.py 中原来的 test_handler_install_hints_point_at_real_channels 测试需更新——它读取了已删除的 handlers.json。本分支已用 test_capability_registry_entries_are_valid 替换，验证对象改为 cli._CAPABILITIES 字典。

内容冲突

本分支的 _lark_cli.py 与上游 100% 一致，零冲突。feishu_base_worker.py 的改动已通过上游模块化重构自然消解。

不建议 revert 的提交

d74ee65（merge commit）之后的 3 个提交（5cc358b、3d2f2f2、38ece4f）各自独立，每个都修复了真实问题。建议整体合入，不要挑拣。

验证

345 tests passed (89 cli + 256 scripts)
pipx install ./cli --force → oks 0.3.0 ✅
wheel + sdist build ✅
Source→Raw→Agent Draft→Promote→Wiki→Search(1.01)→Recall(double-path) ✅
rejected Draft promote blocked ✅
area="../" path traversal blocked ✅
SSRF: _safe_fetch blocks 127.0.0.1, 10.0.0.1, 172.16.0.1, 192.168.1.1, 169.254.169.254 ✅
all docs/ cross-references resolve ✅
git status --short clean ✅

提交列表

38ece4f docs: fix 11 dead cross-references and rewrite stale AGENTS.md
3d2f2f2 fix: security hardening — rejected draft gate, area path traversal, web SSRF
5cc358b fix: build vendoring timing, Rich date rendering, test API adaptation
d74ee65 merge: integrate upstream v0.3.0 (50 commits)
fca0799 docs: clarify install methods and document capability scope
ceaabf9 docs: remove stale book-poc-report reference from architecture evidence table
c0982c7 fix: resolve import isolation and formula capability consistency
c6bc093 feat: add accept skill for evidence-first isolated acceptance testing
034cd80 fix: verify capability env-python can import required module
e6faf36 docs: translate key reports to Chinese, update Kimi K3 case, expand anti-bot research
f3384eb docs: remove stale acceptance logs, handoff notes, and superseded designs
547926b feat: deduplicate lark-cli path resolver into shared _lark_cli.py
14a0dbb fix: harden atomic writes to full A5 compliance (mkstemp+fsync+os.replace+dir fsync)
050e1ba docs: fix schemas location and add runtime-notice README
3015768 docs: remove stale capabilities/ and handlers.json, fix all references
9436967 docs: remove wrong-project _meta files, fix references
f1e4652 chore: remove unused dependencies (python-frontmatter, gitpython)
7875f65 chore: remove dead tools (raw_ingest, multimodal_feedback, keyframe_probe)
f697b72 docs: record openclaw validation gap
118f632 docs: align architecture and agent prompt links
5279744 docs: record remote acceptance cleanup
ac5c695 docs: add platform research and kimi case
7a3b8fb docs: record clean server deployment acceptance
1e7cfaf fix: write ingest raw bundles under active kb
87315a3 docs: align word goal landing status
125baf2 docs: complete book poc core loop
feb84f9 test: freeze book poc ab evaluation
e19bdbf docs: refine book candidate review evidence
ee01a2f docs: audit book poc and execution gates
f6784a7 fix: render dated drafts in review list
49a1112 docs: record book poc awaiting review
0f0c855 fix: decode utf8 plain text intake