release: prepare v1.17.10

Author: rockyshi1993

CHANGELOG.md

@@ -1,16 +1,17 @@
 # 变更日志 (CHANGELOG)
 
 > **说明**: 版本概览摘要；历史版本见对应详细变更文件。
-> **最新版本详细变更文档**: [`changelogs/releases/v1.17.9.md`](./changelogs/releases/v1.17.9.md)
+> **最新版本详细变更文档**: [`changelogs/releases/v1.17.10.md`](./changelogs/releases/v1.17.10.md)
 > **最后更新**: 2026-08-17
-> **当前版本**: v1.17.9 修复 Windows Grok Hook 的 PowerShell 命令解析，收敛为插件唯一 lifecycle Owner，并补齐事务、临时目录、Memory/Profile current-truth 与发布链回归；版本发布权威以对应 Git tag、npm registry 与 GitHub Release 为准。
+> **当前版本**: v1.17.10 统一 DevCodex 的公开产品表达，建立公开用户文档与 GitHub Pages，收敛 README 信息架构和跨入口 metadata，并补强动态工作流、Skill、宿主与 endpoint 身份合同；版本发布权威以对应 Git tag、npm registry 与 GitHub Release 为准。
 
 ---
 
 ## 版本概览
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.17.10](./changelogs/releases/v1.17.10.md) | 2026-08-17 | 📚 **公开产品表达与用户文档站**：统一意图驱动 AI Coding 工作流运行时定位；README 迁移到任务型入口，公开 Rspress/Pages 文档上线；package/plugin/CLI/GitHub metadata 对齐；V2 动态事实与 endpoint 身份负向合同防止跨入口漂移 | [查看](./changelogs/releases/v1.17.10.md) |
 | [v1.17.9](./changelogs/releases/v1.17.9.md) | 2026-08-17 | 🔧 **Grok Hook 启动与唯一 Owner 修复**：Windows canonical transport 兼容 PowerShell；用户级 Grok Hook 退役受管 lifecycle 声明，由插件独占六事件；verifier 分离物理声明、精确去重结果与 mutation owner，并同步事务、workspace temp、Memory/Profile 发布链闭环 | [查看](./changelogs/releases/v1.17.9.md) |
 | [v1.17.8](./changelogs/releases/v1.17.8.md) | 2026-08-16 | 🔧 **宿主稳定入口与 SkillRoute 自举修复**：Hook 信任身份与不可变 runtime generation 解耦；Codex 未分发 UserPromptSubmit 时由结构化 MCP 回退建立同一 SkillRoute envelope；多项目 pending 保留 exact host/显式 Skill，ContextRead 拒绝用 sidecar 覆盖复合返回体失配；S15 兼容 Hook/MCP 两种证据形态并绑定真实入口，closure 复算当前 runtime/adapter/evidence | [查看](./changelogs/releases/v1.17.8.md) |
 | [v1.17.7](./changelogs/releases/v1.17.7.md) | 2026-08-15 | 🔧 **全局运行态一致性与首载闭环修复**：正文读取绑定持久计划并在源层有界；未解析目标、catalog sidecar、Memory 状态、配置 CAS/Readiness、命令/对象身份与 CLI/Desktop 证据分层完成跨消费者收敛；Windows Node 18 插桩递归与验证预算假失败已关闭 | [查看](./changelogs/releases/v1.17.7.md) |

README.md

@@ -1,6 +1,6 @@
-# DevCodex v1.17.9 — 使用入口
+# DevCodex v1.17.10 — 使用入口
 
-> AI workflow injector for Copilot / Claude Code / Codex / Gemini / Grok / Cursor Beta · publisher: Rocky · version: 1.17.9
+> AI workflow injector for Copilot / Claude Code / Codex / Gemini / Grok / Cursor Beta · publisher: Rocky · version: 1.17.10
 
 ## 正式主支持客户端
 

RULES.md

@@ -0,0 +1,34 @@
+# DevCodex v1.17.10
+
+> 发布日期：2026-08-17
+> 类型：Patch / 公开产品表达、README 与用户文档站
+
+## 发布摘要
+
+v1.17.10 将 DevCodex 的 README、npm、Plugin、CLI、GitHub 和公开文档统一到“意图驱动的 AI Coding 工作流运行时”，并把详细排错从仓库首页迁移到独立的 GitHub Pages 用户文档站。产品运行时、Hook、MCP、工作流与自动推进语义没有改变。
+
+## 公开产品表达与合同
+
+- 新增 `PublicProductExpressionV1` 稳定语义源，并从现有 workflow、Skill portfolio 和宿主 owner 动态生成 `PublicProductProjectionV1`。
+- `PublicReadmeContractV2` 校验产品品类、六主两高级工作流、86/83/3 Skill 生命周期、六宿主状态、用户路径与跨入口 metadata；V1 仅保留一版只读兼容。
+- endpoint 身份验证不再把 HTTP 200 当作充分条件，同时校验最终 URL、title、品牌标记以及 404、停放页和组织聚合页负例。
+- GitHub topics 采用集合语义回读，兼容平台排序，同时保持 package/plugin keywords 的 canonical 顺序。
+
+## README 与公开文档
+
+- README 从 783 行收敛到 350 行，保留首次成功、工作流/Skill/宿主边界、常见任务、最短恢复路径、更新、卸载和 Workspace Skill。
+- Grok ParserError/双来源、Cursor 命令碰撞与 Cloud 边界、sandbox 状态、临时目录、Memory/SkillRoute 协议等高级内容迁入公开文档。
+- 新增独立、tracked、`private: true` 的 `public-site/` Rspress 站点；9 个 Markdown 页面按用户任务组织，构建同时检查 dead links 和 anchors。
+- `website/` 保持维护者私有文档站，不进入公开 Git、npm 包或 Pages 发布物。
+
+## GitHub Pages 与公开入口
+
+- Pages 使用 GitHub Actions workflow 构建与部署，PR 只构建，main/manual 才部署；build 与 deploy 权限分离。
+- `https://devcodex-labs.github.io/devcodex/` 已通过在线身份回读后，才成为 package、plugin、CLI 和 GitHub repository 的 canonical 用户入口。
+- GitHub description、homepage 与 topics 使用相同产品表达并逐字段回读；`devcodex.dev` 继续只作为历史 schema identity/custom-domain candidate，不作为本版本导航入口。
+
+## 验证与兼容性
+
+发布资格要求 public expression/readme/docs/Profile、Rspress build/link、full/coverage/audit、Node 18/22/24/26 与 Windows 控制面、package boundary、publish dry-run、fresh tarball install/self-pack、目标提交 CI/Pages、npm/GitHub Release/provenance 和本机六宿主全部通过。
+
+本版本不新增 root runtime dependency、产品 CLI、Hook、MCP、Rule、Skill、Prompt、后台服务、端口、自定义域名或删除动作。最终 commit、Actions run、registry tarball 摘要和本机 generation 以发布报告及 `ProfileCurrentTruthV1` 为准。

changelogs/releases/v1.17.10.md

@@ -1,11 +1,11 @@
 # 未发布变更（Unreleased）
 
 > **用途**: 记录尚未正式发版的实现级变更。
-> **当前**: v1.17.9 已发布并完成 R7；本文件记录其后的公开产品表达、README 契约与公开站点补丁候选。新 patch 的远端 tag、npm 与 GitHub Release 完成前仍只属于候选，当前发行事实由 Profile 05 的 `ProfileCurrentTruthV1` 对照 package、workflow、npm 与 GitHub。
+> **当前**: v1.17.9 已发布并完成 R7；v1.17.10 已生成公开产品表达、README 契约与公开站点发布候选。目标 tag、npm 与 GitHub Release 完成前仍只属于候选，当前发行事实由 Profile 05 的 `ProfileCurrentTruthV1` 对照 package、workflow、npm 与 GitHub。
 
 ## 当前未发布实现候选
 
-- **公开产品表达、README V2 与 GitHub Pages 补丁候选**：新增稳定产品语义与动态工作流/Skill/六宿主投影，公共 README 采用意图驱动工作流运行时定位并保留 V1 兼容入口；新增独立 `public-site/` Rspress 站点、PR 构建和 main Pages 发布链，维护者 `website/` 继续不进入公开仓/npm 包。homepage 先使用真实仓库回退，只有 Pages 品牌身份回读 PASS 后才切换；发布后还须验证 GitHub metadata、npm registry、fresh install、本机六宿主与新会话生效。
+- **v1.17.10 公开产品表达、README V2 与 GitHub Pages 发布候选**：稳定产品语义与动态工作流/Skill/六宿主投影已经接入；公共 README 收敛为任务入口，详细 Grok/Cursor/sandbox/runtime 内容迁入独立 `public-site/`，维护者 `website/` 继续不进入公开仓/npm 包。Pages 已以 workflow 模式上线并通过 URL/title/brand/404 负向身份回读，package/plugin/CLI/GitHub homepage 已切到该产品页面；发布后仍须验证 npm registry、provenance、fresh install、本机六宿主与新会话生效。完整说明见 `changelogs/releases/v1.17.10.md`。
 - **v1.17.9 聚合发布候选**：纳入 v1.17.8 发布后已核实的 35 项失败关闭、事务/CAS、workspace temp V2、Memory 与 Profile current-truth 修复；同时修复 Windows Grok 通过 PowerShell 执行受管 Hook 时首个引号可执行文件被解析为字符串而触发 `ParserError`，统一使用可被 `cmd.exe` 与 PowerShell 接受的稳定 Node 启动命令。Grok 用户级全局文件退出 DevCodex lifecycle 声明，六事件由用户级 `devcodex-workspace` plugin 单独拥有；runtime verifier 分别核对物理声明、Grok 精确去重后的有效 handler 与 mutation owner。Grok 默认导入 DevCodex Claude Hook 时，稳定 launcher 依据四项 Grok 保留环境指纹在回执读取前静默退出；用户自有 Hook、Grok Claude 兼容偏好、portable 模式与其他五宿主语义不变。完整说明见 `changelogs/releases/v1.17.9.md`。
 - **v1.17.8 宿主稳定入口与 SkillRoute 自举修复已归档（PI-251～255 / PF-303～307）**：六宿主 Hook 改为稳定 launcher，由 committed receipt 安全转发到当前不可变 runtime，避免每次升级改变 Codex Hook 信任身份；`profile_context_plan` 在宿主没有分发 UserPromptSubmit 时返回并复用精确 SkillRoute bootstrap，并把多项目 pending 的 canonical hostVariant/显式 Skill 保真带入 MCP；ContextRead 对复合 content 选择唯一主 schema，拒绝用 sidecar 覆盖可观察的身份失配；S15 归一化 Hook history 与结构化 receipt，并以 evidence-bound hostVariant 阻止 Desktop ambient 污染 CLI。完整说明见 `changelogs/releases/v1.17.8.md`；正式发布事实以 Git tag、npm registry、GitHub Release 与 `ProfileCurrentTruthV1` 为准。
 - **v1.17.7 全局运行态一致性与首次加载闭环修复已归档**：22 项确认问题及 Windows Node 18 插桩递归、验证预算假失败均已关闭；GitHub CI、Publish、npm/GitHub tarball parity 与六宿主本机更新已经完成。完整说明见 `changelogs/releases/v1.17.7.md`。

changelogs/unreleased.md

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "ControlContentDuplicationInventoryV1",
-  "sourceBundleDigest": "e0b60bfb467843436470b1f6768ea805668f94d7719d9a29e2f667005361fc3f",
+  "sourceBundleDigest": "a397acdbbfa42b961f2ca1f94ede9c210b3ee180426c096268e0d46e95693cc5",
   "thresholds": {
     "minParagraphChars": 100,
     "sectionThreshold": 0.94,

content/duplication-inventory.json

@@ -2,7 +2,7 @@
 applyTo: "**"
 description: 安全底线与输出语言规则，定义 S01~S07、违规处理与不可豁免边界
 priority: P2
-version: 1.17.9
+version: 1.17.10
 ---
 # 安全底线规范（S01~S07）
 

content/instructions/00-safety.instructions.md

@@ -2,7 +2,7 @@
 applyTo: "**"
 description: 通用规范总则，覆盖优先级、意图路由、Profile/active-root、宿主适配与治理总线
 priority: P5
-version: 1.17.9
+version: 1.17.10
 ---
 # 通用规范
 

content/instructions/01-common.instructions.md

@@ -2,7 +2,7 @@
 applyTo: "**"
 description: 意图驱动的 Profile 加载、active-root 路径、目标项目识别与项目现实扩展规范
 priority: P5
-version: 1.17.9
+version: 1.17.10
 ---
 # Profile 加载与项目现实扩展
 

content/instructions/01a-profile-loading.instructions.md

@@ -2,7 +2,7 @@
 applyTo: "**"
 description: 任务切换边界、RecordRouter 分流、Improvement Intake 与提交发布边界的通用规范
 priority: P5
-version: 1.17.9
+version: 1.17.10
 ---
 # 任务边界与 RecordRouter