# 社区收录准备计划 / Community Submission Readiness Plan

> 更新日期 / Updated: 2026-08-27
>
> 本文件是 dsh-git-chain 面向 DSH 社区目录收录的准备清单。它区分“目录结构可收录”和“产品可以被公开推荐”两个门槛；目录收录本身不是官方审核、运行时测试、安全审计或兼容性保证。

## 结论 / Decision

- **目录结构：GO candidate**。仓库已公开，默认分支为 `main`，根目录有 `package.json` 和 `cordis.patch.yml`，并且已经添加 `deepseek-harness`、`dsh-plugin` 主题。
- **公开推荐：GO（限定已验证组合）**。固定 `v0.1.0` 包已经在独立 profile 完成旧版升级、卸载清理、重装恢复、真实 Desktop 重启和 UI 回归；固定包解包后的 fallback smoke 也已通过。
- **当前发布定位：稳定版 `v0.1.1`**。稳定 Release 使用与本次主线一致的不可变 tag、固定 tarball 附件和最终 Release notes；未列出的 DSH/OS 组合仍不能被泛化为已兼容。

## 收录目标和规则来源 / Target and Rules

本轮准备面向以下公开发现渠道：

1. [DSH Plugin Directory](https://github.com/alexchenzl/dsh-plugin-directory)：通过 GitHub issue form 提交一个插件包。
2. [DSHPlugin](https://github.com/oa1mgo/dshplugin)：从 `dsh-plugin` 主题和社区目录发现公开仓库。
3. GitHub `dsh-plugin` topic：作为基础可发现性入口。

`dsh-plugin-directory` 当前要求包 URL 指向默认分支上的准确包目录；目录内必须直接有 `package.json`，声明 `dsh.bundle.patch`，并包含声明的补丁文件。提交还需要一个精确分类、一句事实描述和一条从项目文档复制的单行安装命令。

## 硬性收录条件 / Directory Eligibility

| 条件 | 当前状态 | 证据或动作 |
| --- | --- | --- |
| 公开仓库 | 已通过 | `https://github.com/ShinonomeAya/dsh-git-chain` 可访问 |
| 默认分支包 URL | 已通过 | 根目录包，默认分支 `main` |
| 根目录 `package.json` | 已通过 | `package.json` 直接位于仓库根目录 |
| `dsh.bundle.patch` | 已通过 | `package.json` 中的 `dsh.bundle.patch` 指向 `./cordis.patch.yml` |
| 补丁文件存在 | 已通过 | `cordis.patch.yml` 位于仓库根目录 |
| 社区分类 | 已确定 | `Coding & Dev Tools (coding)` |
| 一句事实描述 | 已准备 | `A DeepSeek Harness plugin that renders repository history as an SVG Git commit graph and provides commit details, diffs, filtering, and guarded local branch switching.` |
| 单行安装命令 | 已准备 | 见下方提交字段，且已出现在双语 README 的源码安装说明中 |
| 许可证和公开协作入口 | 已通过 | MIT、`CONTRIBUTING.md`、`SECURITY.md`、GitHub Issues |

这些条件满足后，目录层面的收录可以提交；它们不代表插件已经通过运行时质量或安全审核。

## 非阻断但建议补齐 / Recommended, Not Blocking

这些事项不是当前目录结构校验的硬性条件，但会提升公开项目的长期可信度：

- 增加 `CODE_OF_CONDUCT.md`，明确社区交流边界和维护者处理方式。
- 为 GitHub Issues 增加 bug report 和 feature request 模板，减少缺少复现信息的问题。
- 本次正式稳定版本已提供固定 tarball 和 SHA-512 Release 附件；若要面向普通用户推广，再考虑发布 npm 包。
- 收录后继续观察安装反馈和重复挂载问题；稳定版发布后若出现回归，按兼容性矩阵和安全策略处理。

## 产品公开推荐门槛 / Product Readiness Gate

### 已通过

- `v0.1.0` tag 和 GitHub Public Preview Release 已创建。
- Node 22/24 CI 通过，包含 typecheck、55 项测试、build、package check、生产依赖审计和 Chromium smoke。
- 本地 DSH Desktop `2.0.2.0` 已验证完整图、分支勾选同步、详情、Diff、刷新和 first-parent `7 → 3 → 7`。
- 独立 `gitchain-test` profile 已使用固定 `v0.1.0` tarball 安装，真实 Desktop 重启后插件入口和 Host 图查询仍可用。
- 双语 README、兼容性矩阵、变更记录、贡献指南和安全策略已存在。
- 固定包生命周期的执行顺序、证据字段和稳定版门禁见 [固定包生命周期计划](RELEASE-LIFECYCLE-PLAN.md)；当前生命周期门禁已完成。

### 稳定 Release 已完成

- 已创建与当前主线一致的稳定 tag，并在 Release 中附上固定 tarball 与 SHA-512。
- 已更新 README、CHANGELOG、兼容性矩阵和 Release notes，使版本号、附件、安装命令和验证组合一致。
- 将每个结果回填 [兼容性矩阵](COMPATIBILITY.md)，只声明真实验证过的 DSH、OS、Node 和 profile 组合。

固定包 UI first-parent 已验证：真实 DSH Desktop 中 `7 → 3 → 7`，当前分支保持 `master`。

## 分阶段执行计划 / Phased Plan

### P0：冻结公开输入

**目标：** 让目录审核能直接读取到一个自洽的公开仓库。

- 保持包名、版本、默认分支、仓库 URL、许可证和 `dsh.bundle.patch` 一致。
- 让 README 的安装命令可复制，明确当前是 Public Preview，不承诺未经验证的 DSH 版本。
- 保留双语说明、截图、已知限制、贡献和安全入口。
- 清理公开文档中的本机绝对路径、profile 私有配置和其他环境专属信息。

**完成标准：** 根目录包结构通过 `check:package`，README 链接有效，工作区没有未说明的敏感文件。

### P1：固化可复现发布物

**目标：** 让维护者和用户可以确认安装的是同一份代码。

- 从固定 tag 构建 tarball，记录 SHA-512；下一次正式 Release 将 tarball 和校验值作为 Release 附件。
- 在 Release 说明中列出 DSH、Node.js、Git 要求、安装命令、Public Preview 状态和已知限制。
- 继续保留 tag CI 和 main CI 的运行链接，发布前只使用绿色结果。

**完成标准：** 固定 tag、构建产物、校验值、安装方式和兼容性声明互相一致。

### P2：完成固定 DSH profile 验收

**目标：** 证明公开安装包不是只能在本地 link 下工作。

- 在 `gitchain-test` profile 完成安装、启动、重启和核心操作；UI first-parent 已记录为 `7 → 3 → 7`。
- 完成固定版本升级，确认 single-instance 和 bundle patch 没有重复注入。
- 完成卸载、入口清理、重装恢复和固定包 fallback 验证。
- 截图或日志只保留产品界面、版本、结果和必要路径，不提交本地 profile、仓库私有内容或凭据。

**完成标准：** [兼容性矩阵](COMPATIBILITY.md) 中固定包生命周期项为 `PASS`，并能复核每个节点。

### P3：提交社区目录

**目标：** 以事实描述提交，不把社区目录误写成官方商店。

- 先提交仓库变更并推送到 `main`，让目录读取到默认分支上的最新 `package.json`、补丁和 README。
- 使用下方预填字段创建一个 submission issue；不要重复提交同一个包。
- 记录 issue URL、提交日期和目录返回结果。
- 如果目录只完成结构校验，仍保留 Public Preview 和兼容性边界。

**完成标准：** 目录记录指向正确仓库根目录，分类、描述和命令与本文件及 README 一致。

### P4：收录后维护

**目标：** 让目录条目和实际发布状态持续一致。

- 每次版本发布同步更新 README、CHANGELOG、兼容性矩阵和 Release notes。
- DSH 或 Node 兼容性发生变化时，先更新验证矩阵，再更新目录描述或安装命令。
- 发现重复挂载、安装回退或安全问题时，先暂停推广并按 `SECURITY.md` 处理。

## 提交表单预填内容 / Submission Form

```text
Package URL:
https://github.com/ShinonomeAya/dsh-git-chain

Primary category:
Coding & Dev Tools (coding)

Description:
A DeepSeek Harness plugin that renders repository history as an SVG Git commit graph and provides commit details, diffs, filtering, and guarded local branch switching.

Install command:
dsh plugin --profile desktop add link:/absolute/path/to/dsh-git-chain
```

安装命令使用项目 README 已公开的源码安装方式。当前尚未发布 npm 包，因此不把不存在的 npm 包名写进社区条目。

### Current submission / 当前申请

- Issue: [#218](https://github.com/alexchenzl/dsh-plugin-directory/issues/218)
- Submitted: 2026-08-27
- Status: `OPEN`，已获得 `plugin-submission` 标签，等待目录结构校验结果。

## 收录证据包 / Evidence Packet

提交前保存以下信息：

- 仓库 URL、默认分支和提交 SHA。
- tag、Release URL、是否 prerelease，以及 tarball SHA-512。
- DSH 版本、OS、profile、安装源和测试时间。
- 核心 UI、first-parent、详情/Diff、刷新、重启、升级、卸载重装和 fallback 结果。
- GitHub Actions 的 main/tag run URL。
- 社区目录 submission issue、提交日期和最终状态。
- 代表性截图；截图不得包含私有仓库内容、凭据或本地 profile 配置。
- 尚未解决的限制和公开 Issue 链接。

## Definition of Done

只有同时满足以下条件，才把项目对外描述为“可公开推荐”：

1. 目录结构条件全部通过。
2. 固定包 DSH profile 生命周期全部通过。
3. 自动化门禁和 GitHub Actions 全部为绿色。
4. README、稳定 Release、兼容性矩阵和提交字段一致。
5. 发布说明明确“社区目录是发现入口，不是官方背书或安全审计”。

当前准确表述是：**`v0.1.1` 稳定 Release 已完成，固定 profile 生命周期和 fallback 已通过；产品可针对已记录组合公开推荐，其他组合仍需单独验证。**