soft_quay_web/docs/current-state.md

# 当前实现状态

> 本文是可覆盖的**项目级快照**,记录代码与任务的现实状态,帮助 AI coding agent 避免只看计划而忽略仓库现状。
> 执行记录写进各任务文件(`docs/tasks/W-<编号>.md`)的 `## 执行记录`,不在本文重复维护。

## 当前快照

- 日期:2026-07-20
- 阶段:**文档就绪、代码未起步**。harness coding 文档集(00~06、api、tasks、agent-context 等)已建立;原始设计规格已完整拆分进编号文档后删除(git 历史可查)。
- 代码:无。没有 go.mod / 源码目录;`init.sh` / `init.ps1` 顶部三个命令为占位符,运行会主动失败(预期,W-001 替换)。
- 协议权威源:`../soft_quay/docs/api.md`、`../soft_quay/schemas/`(manifest/app/installed-app/download-task)、`../soft_quay/testdata/catalog/canonical-vectors.json` 均存在于同级客户端仓库;引用方式(submodule / 版本化拷贝)未裁定(W-001)。
- 客户端配套现状:`soft_quay` 已完成 Phase 0~4,corpus 已冻结(soft_quay/T-614);客户端当前 blocker 之一是缺可信 Catalog 发布源,对应本仓库 M2/M3。
- 版本管理:git 已初始化(main 分支,本地,无远端)。
- 当前 blocker:无技术 blocker;立项裁定项(签名私钥管理 W-003、权威源引用方式 W-001)未裁定前,对应实现不能开工。

## 当前目录要点

| 路径 | 状态 | 说明 |
| --- | --- | --- |
| `docs/` | 已有 | harness coding 文档集(本次初始化完成)+ 原始设计规格 |
| `docs/tasks/` | 已有 | 仅 README 与模板,尚无任务文件;下一步按路线图落 W-001/W-003 |
| `scripts/` | 已有 | `validate_agent_context.py`(上下文清单校验) |
| `init.sh` / `init.ps1` | 占位 | W-001 替换真实命令 |
| 源码目录 | 无 | W-001 建立 |

## 任务状态

任务状态以 `docs/tasks/` 各任务文件 frontmatter 的 `status` 为准。本节只写项目级摘要:

- 已完成:无(项目刚初始化)。
- 正在进行:无。下一步按 [`06-tasks.md`](06-tasks.md) 落成 Phase 0 任务;W-003(私钥管理裁定)与 W-001(骨架)无相互依赖,建议先落 W-001。

## 当前可运行内容

```bash
# 上下文清单校验(唯一当前可运行的验证):
python3 scripts/validate_agent_context.py

# init 脚本当前会按预期失败并提示命令未替换:
./init.sh
```

## 开始编码前检查

1. 读仓库级 agent 规则文件 `AGENTS.md`。
2. 读 `docs/00-ai-start-here.md`。
3. 读 `docs/05-coding-rules.md`。
4. 在 `docs/tasks/` 找到 frontmatter `status: TODO` 且依赖均 `DONE` 的任务文件;暂无任务时,先按 `docs/06-tasks.md` 路线图落成任务文件。
5. 把任务改为 `DOING` 再动手。

## 维护规则

当实际状态发生变化时,同步更新本文件:新增入口文件、初始化框架、新增可运行命令、发现文档和代码现实不一致、阶段或 blocker 变化。本文件只保留当前快照,不保留完整历史。