diff --git a/docs/development-plan.md b/docs/development-plan.md
index e993d34..e571ffc 100644
--- a/docs/development-plan.md
+++ b/docs/development-plan.md
@@ -261,6 +261,9 @@ PH2-S1/S2/S3/S4 之间除标注的依赖外相互独立，可并行推进。
- **U-028 [Value Path]** `v_artifact_browser`
- 依赖：U-011
+ - Done：Artifact 列表+预览+血缘链可用（原文档缺 Done/覆盖行，2026-07-31 补上）
+ - **实现补充（2026-07-31）**：`c_artifact_get` 在机器可读的 `sdd-mvcp-contract.json` 里其实定义过（`GET /api/artifacts/:artifact_id`），只是 03-C 的正文一直没写出来；`c_artifact_list` 连 MVCP JSON 里都没有 operation 定义，纯粹是 `v_artifact_browser` 自己的过滤字段（`artifact_type_filter`/`task_id_filter`）倒逼出来的缺口，和 U-025 补 `c_task_list` 是同一类"读接口没人建"问题。新增 `src/artifact_query.py`：`list_artifacts()` 返回裸数组（跟 `list_tasks()` 保持同款风格，不跟 MVCP JSON 里 `c_task_list` 的 `{items,total}` 包一层——本地单项目 MVP 不需要分页，跟自己代码库已有约定保持一致比跟一份机器生成的镜像文件保持一致更重要）；`get_artifact()` 顺带把血缘链（`lineage_chain()`，按 `depends_on_artifact_ids` 往回走，多个依赖时只走第一个——原型图和这条流水线的实际产出都只有线性 BRD→PRD→SDD 链，没有真正的多依赖分叉场景）和文件内容（`artifact` 表本身没有 content 列，内容活在磁盘上，走 `project.target_folder_path` + `artifact.file_path` 拼出绝对路径现读）一起返回，预览面板一次请求就够。前端 `v_artifact_browser` 的预览统一用 `` 纯文本展示，不做 Markdown 渲染/代码高亮——02-V 原文想要那个效果，但这需要引入第一个前端第三方库（图表/高亮/markdown 解析器），和这个控制台"纯 vanilla JS、无构建步骤"的一贯做法（05 §5.7 精神延伸到前端）冲突，判断为有意简化而非漏做。顺手把 `frontend/index.html` 的常驻导航栏加上了"产物"链接（之前只有 Dashboard/Tasks/Settings 三个占位项）。真实服务器验证过三级血缘链（BRD→PRD→SDD）返回顺序正确。
+ - 覆盖：02-V `v_artifact_browser`；03-C `c_artifact_get`（正文订正补全）+ 新增 `c_artifact_list`
- **U-029 [Value Path]** `v_skill_library` + `v_skill_audit_log`
- 依赖：U-018
diff --git a/docs/sdd/03-C-控制与接口.md b/docs/sdd/03-C-控制与接口.md
index 5ddb687..ab822e3 100644
--- a/docs/sdd/03-C-控制与接口.md
+++ b/docs/sdd/03-C-控制与接口.md
@@ -171,6 +171,13 @@
- `side_effects`：写文件 + Git commit（commit message 包含 `task_id` 与 `artifact_type`）
- `errors`：`GIT_COMMIT_FAILED`（可重试）
+## 3.7.1 `c_artifact_get` / `c_artifact_list`（2026-07-31 订正：`c_artifact_get` 此前只存在于机器可读的 `sdd-mvcp-contract.json`，正文一直没写；`c_artifact_list` 连 MVCP JSON 里都没有，`v_artifact_browser` 自己的过滤字段倒逼补上）
+
+- `GET /api/artifacts/:artifact_id`（`c_artifact_get`）、`GET /api/artifacts?project_id=&task_id=&artifact_type=`（`c_artifact_list`，`project_id` 必填）
+- `output_contract`：`c_artifact_list` 返回裸数组；`c_artifact_get` 返回单条 `artifact` 全部字段 + `content`（现读磁盘文件，`artifact` 表本身无 content 列）+ `lineage`（按 `depends_on_artifact_ids` 回溯的血缘链，oldest-first，含自身）
+- `idempotent`：是
+- `errors`：`NOT_FOUND`（不可重试，仅 `c_artifact_get`）；`INVALID_INPUT`（不可重试，仅 `c_artifact_list`）：缺少 `project_id`
+
## 3.8 `c_skill_update`
- `POST /api/skills/:skill_id/update`
diff --git a/docs/sdd/unit_matrix.json b/docs/sdd/unit_matrix.json
index 1d9491b..f4f1019 100644
--- a/docs/sdd/unit_matrix.json
+++ b/docs/sdd/unit_matrix.json
@@ -43,7 +43,7 @@
{"id": "U-025", "phase": "PH3", "sub_phase": "PH3-S2", "name": "v_dashboard + v_task_board + v_task_detail（见 development-plan.md 2026-07-31 实现补充）", "classification": "Value Path", "depends_on": ["U-024"], "coverage": {"model": [], "view": ["v_dashboard", "v_task_board", "v_task_detail"], "controller": ["c_task_list", "c_task_get", "c_org_loop_route"], "process": [], "requirement": []}, "done": "三个页面可正常展示实时数据；补上此前无 Unit 认领的 c_task_list/c_task_get HTTP 路由，c_org_loop_route 首次接上 HTTP；v_graph_visualizer/v_log_viewer 子模块占位等 U-026/U-027"},
{"id": "U-026", "phase": "PH3", "sub_phase": "PH3-S2", "name": "v_graph_visualizer（见 development-plan.md 2026-07-31 实现补充）", "classification": "Value Path", "depends_on": ["U-024"], "coverage": {"model": [], "view": ["v_graph_visualizer"], "controller": [], "process": [], "requirement": []}, "done": "Work Graph DAG 分层视图含 waiting_for_quota 信息态；Org Graph 层复用 v_task_detail 已有的 org-strip 面板，不重复渲染"},
{"id": "U-027", "phase": "PH3", "sub_phase": "PH3-S3", "name": "execution_log_file + 日志查看器（见 development-plan.md 2026-07-31 实现补充）", "classification": "Value Path", "depends_on": ["U-024"], "coverage": {"model": ["execution_log_file", "log_retention_config"], "view": ["v_log_viewer"], "controller": ["c_execution_log_get", "c_ws_log_tail"], "process": ["p_log_retention_cleanup"], "requirement": ["REQ-13"]}, "done": "REQ-13 happy/boundary/failure 通过；补上此前从未存在的 append_log 写路径；顺带修了 U-024 就存在的 server_close() 并发 segfault 隐患（conn_lock 未覆盖）"},
- {"id": "U-028", "phase": "PH3", "sub_phase": "PH3-S3", "name": "v_artifact_browser", "classification": "Value Path", "depends_on": ["U-011"], "coverage": {"model": [], "view": ["v_artifact_browser"], "controller": [], "process": [], "requirement": []}, "done": "Artifact 列表+预览+血缘链可用"},
+ {"id": "U-028", "phase": "PH3", "sub_phase": "PH3-S3", "name": "v_artifact_browser（见 development-plan.md 2026-07-31 实现补充）", "classification": "Value Path", "depends_on": ["U-011"], "coverage": {"model": [], "view": ["v_artifact_browser"], "controller": ["c_artifact_get", "c_artifact_list"], "process": [], "requirement": []}, "done": "Artifact 列表+预览+血缘链可用；预览为纯文本，不做 Markdown 渲染/代码高亮（避免引入前端第三方依赖）"},
{"id": "U-029", "phase": "PH3", "sub_phase": "PH3-S3", "name": "v_skill_library + v_skill_audit_log", "classification": "Value Path", "depends_on": ["U-018"], "coverage": {"model": [], "view": ["v_skill_library", "v_skill_audit_log"], "controller": [], "process": [], "requirement": []}, "done": "Skill 库与变更审计日志可查看"},
{"id": "U-030", "phase": "PH3", "sub_phase": "PH3-S4", "name": "并发/预算/日志保留配置页", "classification": "Value Path", "depends_on": ["U-019", "U-021"], "coverage": {"model": ["org_concurrency_config"], "view": ["v_concurrency_settings", "v_budget_settings", "v_log_retention_settings"], "controller": ["c_concurrency_config_update", "c_budget_config_update", "c_log_retention_config_update"], "process": [], "requirement": []}, "done": "三个配置页可用且改动生效"},
diff --git a/frontend/app.js b/frontend/app.js
index a4e5359..9f580b6 100644
--- a/frontend/app.js
+++ b/frontend/app.js
@@ -77,6 +77,7 @@ function connectLogTailSocket(nodeExecId, { onChunk, onClose }) {
const routes = {
"#/": { render: renderDashboard, mount: mountDashboard },
"#/tasks": { render: renderTaskBoard, mount: mountTaskBoard },
+ "#/artifacts": { render: renderArtifactBrowser, mount: mountArtifactBrowser },
"#/settings": { render: () => "Settings placeholder -- real content is PH3 (U-030)
" },
"#/setup": { render: renderProjectSetup, mount: mountProjectSetup },
"#/goals/new": { render: renderGoalComposer, mount: mountGoalComposer },
@@ -968,3 +969,109 @@ function mountTaskDetail(taskId) {
closeAllLogViewers();
});
}
+
+// ---- v_artifact_browser (02-V §2.8): artifact list + read-only preview ----
+// Preview renders content in a plain block for every artifact_type --
+// 02-V asks for Markdown rendering / syntax highlighting, but pulling in a
+// markdown/highlighting library would be this frontend's first external
+// dependency (05 §5.7's "no build step" ethos extends to keeping the
+// console vanilla-JS-only); a monospace raw-text preview is a deliberate,
+// documented simplification, not a missed requirement.
+
+const ARTIFACT_TYPES = ["brd", "prd", "sdd", "benchmark", "bug_record", "code_diff", "test_report"];
+
+function renderArtifactBrowser() {
+ if (!getCurrentProjectId()) return renderNoProjectSelected();
+ return `
+
+
Artifact 浏览器
+
+
+ 全部类型（artifact_type_filter）
+ ${ARTIFACT_TYPES.map((t) => '' + t + " ").join("")}
+
+
+ 全部任务（task_id_filter）
+
+
+
+
加载中…
';
+ const artifact = await fetch("/api/artifacts/" + encodeURIComponent(artifactId)).then((r) => r.json());
+ const lineageHtml = artifact.lineage.map((a, i) => {
+ const isCurrent = a.artifact_id === artifactId;
+ const label = escapeHtml(a.artifact_type) + (isCurrent ? "（当前）" : "");
+ const arrow = i < artifact.lineage.length - 1 ? " → " : "";
+ return '' + label + " " + arrow;
+ }).join("");
+ previewEl.innerHTML = (
+ '血缘链：' + lineageHtml + "
"
+ + '' + (artifact.content == null ? "（文件不可用）" : escapeHtml(artifact.content)) + " "
+ );
+ }
+
+ async function refreshList() {
+ const params = new URLSearchParams({ project_id: projectId });
+ if (typeFilterEl.value) params.set("artifact_type", typeFilterEl.value);
+ if (taskFilterEl.value) params.set("task_id", taskFilterEl.value);
+ const artifacts = await fetch("/api/artifacts?" + params.toString()).then((r) => r.json());
+ if (artifacts.length === 0) {
+ listEl.innerHTML = ' 暂无产物 ';
+ previewEl.innerHTML = '暂无产物
';
+ return;
+ }
+ listEl.innerHTML = artifacts.map((a) =>
+ '' + escapeHtml(a.artifact_type) + "
"
+ + escapeHtml(a.file_path.split("/").pop()) + "
Dashboard
Tasks
+ Artifacts
Settings