# 文档索引与接手状态

核对日期：2026-10-16（Asia/Shanghai）。本页集中维护交付、候选身份与验收状态；行为以对应契约为准，版本、依赖和命令以仓库配置为准。历史记录不作为当前任务安排。

## 当前交付

**本轮交付范围（2026-10-16）：** 用户已要求本地安装、重新采集周末数据并发布补丁版本，取代早先仅本地候选、不发布的限制；原七天采样仍保持停止，不恢复。准备 v0.4.10，增加固定日历截止、锁屏／休眠独立状态与事件计数；计划覆盖本周末至 10 月 19 日 09:00（Asia/Shanghai），允许正常休眠和缺口。下方旧候选的安装和验证身份均保留；实际新包安装、采样启动、远端 CI 与发布结果在完成后另行追加记录。

**已发布：v0.4.9**，源码 `aac5bba0ba450f35e0b014d9b0a0a17a1f3fd6f2`。M1–M6 已纳入该版本；[main CI](https://github.com/takboo/dsh-coopanion/actions/runs/38706065646) 的 10 项检查、[发布 CI](https://github.com/takboo/dsh-coopanion/actions/runs/38708215499) 的 13 项检查通过，覆盖三平台与两版宿主六组安装。npm／Release 同包身份见[交付记录](evidence/releases/v0.4.9/README.md)。10 月 16 日早先的只读查询显示当时最新 Release 为 v0.4.9，结果见[远端核对快照](evidence/p1/diagnostics-followup-20261016/remote-delivery-check.json)。

**日用旧候选：0.4.10**，源码 `3a93a369bfa72f53941bd8a5c45c3cdd6ca58e07`，包 SHA-256 `56d55538d0f30e0f677e4ff0748fa23991990434724ff7371c48a01cfa476ec1`。本机日用 Desktop 保留这个包，候选核验与安装证据见[固定记录](evidence/p1/diagnostics-20261016/README.md)，配置纠正和运行状态见[后续核对](evidence/p1/diagnostics-followup-20261016/README.md)。它的原始包与证据保持不变。

**键盘跨平台修订候选（仅本地）：0.4.10**，源码 `555503ef54e1375b084a6bc34d9472e9726658be`，包 SHA-256 `f459a7c8715bf892d9b0649521bc26a9d29befddc09950d89319d43e0fc48d34`。修复 macOS 监听授权误门槛及 JXA 循环崩溃，加入 Windows Raw Input 与 Linux X11 活动类别适配；Wayland／不可用会话保守 unknown。macOS 类型、229 项单测（另 1 项跳过）、12 项 Node 检查、完整收件箱／串行原生和两版同包安装通过；固定包真实 macOS 辅助进程与 Linux x64／ARM64 隔离 X11 合成键盘／仅鼠标测试通过。481 份产品输入与源码逐字节匹配。Linux Xorg 与 Windows 11 本地控制台 VM 的同包键鼠／退让／恢复验证已通过，临时 VM 已回收，见[VM 原生记录](evidence/p1/keyboard-vm-20261016/README.md)。三平台 CI 探针已接入但远端未执行；macOS 可见输入面板初验通过：物理输入→退让，仅鼠标 30 秒保持 idle，稳定空闲后自然恢复到出发／观察／开始返回。先前聊天提示尝试未计验收；Windows／Linux 物理输入、跨应用／生命周期、三平台完整资源与自然体验仍待验收。见[独立记录](evidence/p1/keyboard-platforms-20261016/README.md)。未推送、未发布、未改日用安装。

**前次 NPC 候选（保留原包）：0.4.10**，源码 `ac5938fd0b7bbdf1b716a023a48cab3c6004e77a`，包 SHA-256 `7bae84f1b152dbf42f21b5b1916e6b9376357d9c02b8e230892119d9bfd7e673`。完成有限空间循环、保留意图的退让／恢复、小窝设置和保守输入适配；类型、222 项单测（另 1 项平台跳过）、12 项 Node 检查、完整收件箱／原生及两版宿主同包安装通过。包内 479 份产品输入逐字节匹配固定提交；候选、失败尝试和三组短测见[独立记录](evidence/p1/npc-life-20261016/README.md)。该包本机真实键盘为 unknown；后续修复由上方新候选独立结算，原始证据不回写。受控循环通过不等于物理键盘、完整资源预算或用户体验通过；未推送、未发布、未改日用安装。

P1 实现与部分验证完成，**旧候选的短时体验未通过**：用户反馈基本没有“活”的感觉，已取消七天试用和填表要求。用户已认可[有限空间 NPC 日常的首步方向](npc-daily-life-plan.md)：从小窝出发、观察／移动／停留，忙碌时退让并保留安排，空闲后恢复探索。现有动作／表情可复用，音效可选，实体窝和玩具尚无；本轮本地源码已加入有限空间调度、意图保留、受控移动、保守键盘适配与小窝设置；新候选与验证记录已独立绑定，未更改日用安装。macOS 本机输入面板初验通过，跨应用、其他平台物理键盘与主观体验仍待验收。[能力探针](evidence/p1/npc-capability-20261016/README.md)只证明原语，未交付新循环。P2／P3 和素材 A1–A3 尚未实施；本产品仍随 Harness 运行，不包含独立运行。

| 范围 | 现有证据 | 尚待验证 |
|---|---|---|
| 目标完成、会话续接、异常恢复、字号 | v0.4.9 三平台／两版宿主 CI；候选本机回归 | 真实模型会话、物理锁屏和休眠恢复 |
| 多屏与 DPI | 纯几何、受控布局、浏览器、原生及安装检查 | 物理多屏、混合 DPI 与真实跨屏点击 |
| 日常节奏与资源 | 策略／界面／原生／安装检查；M6 与 P1 本机短时资源对照 | 长期日常体验、两小时新包结果、其他平台资源测量 |
| 旧 P1 与诊断候选 | macOS 类型、211 项单测（另 1 项平台跳过）、12 项 Node 检查、浏览器／收件箱／原生及两版宿主同包安装；Linux 212 项单测、VM 短测通过 | 短时体验未通过；新候选远端三平台／六组安装未执行，旧 macOS CI 失败仅已做本机修正；两小时资源与物理设备仍待验收 |
| NPC 有限空间与键盘修订 | macOS 完整收件箱／串行原生、两版新包安装、本机物理输入／仅鼠标／自然恢复初验通过；Linux Xorg／Windows 11 控制台 VM 同包虚拟键鼠及自然恢复通过；旧候选短测独立保留 | Windows／Linux 物理输入、跨应用／生命周期、完整预算／两小时新包资源、远端三平台 CI 和自然体验待验收 |
| 系统通知 | N0 私有原型的单实例 macOS 实机记录，后续受控投递与服务集成 | 当前分发包通知中心送达、留存、点击及跨平台实机验收 |
| 社区市场 | 本轮查询目录 [PR #7073](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/7073) 仍 open、未合并 | 合并后的在线目录、搜索与修改记录可见性 |

## P1 观察与体验结论

| 观察 | 本轮确认 | 接续时的判断依据 |
|---|---|---|
| 新包 Linux VM 两小时 | 旧包于 10 月 16 日 13:33:50 开始，早先核对时仍在采样；本轮未重查最终状态，不能算作 NPC 结果 | 读取最终 `summary.json`，核对包身份、时长、RSS 首末窗口、活动／邀请、存档与队列；启动和进度快照不能代替最终通过 |
| 本机原七天被动采样 | 已按用户意见于 10 月 16 日 14:35:23 停止，保留 112 条样本和结束摘要；短时体验未通过 | [停止与反馈记录](evidence/p1/experience-rejected-20261016/README.md)；不再要求七天、补天数、填表或评分。自动动作计数不能推翻用户无感的反馈 |

试用开关的操作入口见[使用指南](usage.md#自主陪伴p1-候选功能尚未发布)，时钟、缺口、托管与报告语义见[诊断契约](diagnostics-contract.md)。本机采样器及其截止控制进程已退出，桌宠和设置保留；旧 VM 资源观察保留原任务，本轮未覆盖、重启或复用其结果；后续需要时只读核对。历史记录中的七天计划、打分表和补足天数已失效，仅保留原始语境。

## 现行资料

| 工作 | 阅读入口 |
|---|---|
| 产品介绍与快速开始 | [项目首页](../README.md) |
| 安装、操作、配置与阅读规则 | [使用指南](usage.md) |
| 本地开发、构建与验证 | [开发指南](development.md) |
| 自主日常、主动互动、长期养成的分阶段实施与 P1 验收 | [路线图](roadmap.md) |
| P1 体验修订：现有动作／表情／音效／物件评估，小窝、有限探索、键鼠避让与状态连续 | [NPC 日常修订与能力边界](npc-daily-life-plan.md) |
| GPT 辅助母版、分件、绑定及角色包的素材计划 | [素材与建模计划](character-art-pipeline.md) |
| 完成判断、提醒身份、领取和请求结算 | [提醒契约](notification-contract.md) |
| 冷会话续接、请求去重、草稿与接受回执 | [会话契约](session-chat-contract.md) |
| 退出、有限恢复、运行代次与临时状态边界 | [恢复契约](desktop-recovery-contract.md) |
| 独立字号与阅读／输入状态保持 | [文字契约](text-readability-contract.md) |
| 显示器归属、坐标转换与切屏 | [多屏契约](multi-display-contract.md) |
| 自主日常、低频邀请、关系存档与旧模式兼容 | [自主陪伴契约](companionship-contract.md) |
| 默认关闭的本地诊断接口与独立采样器 | [诊断契约](diagnostics-contract.md) |
| 默认关闭的旧本地时段动作策略 | [日常节奏契约](daily-rhythm-contract.md) |
| 角色制作、API 2 与动作回退 | [角色接口](characters.md) |
| CI、同包验证、发布与市场流程 | [发布流程](releasing.md) |
| 各版本修改内容 | [版本记录](release-notes.md) |
| 对应源码、素材与依赖许可 | [第三方声明](../THIRD_PARTY_NOTICES.md)、[上游固定版本](../web/upstream/UPSTREAM.md) |

## 历史资料与本机输出

[归档目录](archive/README.md)保留已经执行的计划与阶段交接；[证据目录](evidence/README.md)保留固定提交的验收材料。它们提供来源与复现信息，不安排当前任务。原始证据路径和字节保持不变，以保留摘要链。

`.cache/` 保存工具链、旧 checkout、固定测试包及下载证据；`artifacts/` 保存本机测试输出，可能来自不同提交。两者已被 Git 忽略，普通 `rg` 也跳过归档与证据。追溯时显式使用 `rg --no-ignore` 并核对完整身份；新检查用独立目录，避免覆盖历史包或把旧截图当作本次结果。当前目录中的缓存是否仍存在不属于证据有效性的保证。

更新行为时同步对应契约；更新交付或验收状态时修改本页并链接新增证据。发布说明保留各版本原意，历史记录中的过期状态在本页解释，不回写为后来的结果。