dsh-config-manager 0.1.37 → 0.1.38

package/lib/client.d.ts

@@ -527,6 +527,15 @@ declare const uiZh: {
   readonly 'marketPublish.repoWhitespace': "仓库地址不能包含空白字符";
   readonly 'marketPublish.repoScheme': "仓库地址必须为 http(s) 链接";
   readonly 'marketPublish.repoUserinfo': "仓库地址不能包含用户名或密码（userinfo）；凭据请通过 DSH credentials 提供";
+  readonly 'myConfigs.autoField': "系统自动";
+  readonly 'myConfigs.field.id': "条目 ID";
+  readonly 'myConfigs.field.author': "作者";
+  readonly 'myConfigs.field.version': "版本";
+  readonly 'myConfigs.field.updatedAt': "更新时间";
+  readonly 'myConfigs.status.notListed': "未收录";
+  readonly 'myConfigs.status.pendingPr': "PR 待审核";
+  readonly 'myConfigs.status.listed': "已收录";
+  readonly 'myConfigs.form.errorName': "名称不能为空";
 };
 type UiTextKey = keyof typeof uiZh;
 /** UI 翻译函数：key → 当前语言文案（{param} 插值；未知键回退 zh/键名）。 */
@@ -1166,8 +1175,11 @@ declare class MarketApi {
   /** 浏览内置市场（合并 index + 本地缓存状态 → 条目列表带 cacheState） */
   browse(): Promise<MarketBrowseResponse>;
   /** 下载 + 校验单条目（dry-run 预览：拉取 → §6 校验 → analyzeImport → createImportPlan）。
+   *  repo 可选：条目来源仓库（作者自托管）。自托管条目（官方 index 带 repo 引用、或「我的配置」
+   *  未收录条目）内容文件在作者自己的公开仓库，必须显式传 repo 才能从正确来源拉取；
+   *  缺省 = 市场仓库（官方同仓条目）。
    *  真正落盘由用户对预览确认后走现有 executeImportPlan（confirm:true 安全阀 + 回滚）。 */
-  download(itemId: string): Promise<MarketDownloadResult>;
+  download(itemId: string, repo?: string): Promise<MarketDownloadResult>;
   /** 发布向导：由「上传 zip + 用户填写元数据」生成市场条目包（L2 manifest + SHA-256 + sections），
    *  供 UI 展示/复制与引导推送。零写入配置（发布目录在受控临时区）；不含任何凭据字段。 */
   prepare(payload: MarketPreparePayload): Promise<MarketPrepareResponse>;
@@ -1175,6 +1187,104 @@ declare class MarketApi {
   downloadPublishUrl(zipPath: string): string;
 }
 //#endregion
+//#region src/market/my-repo.d.ts
+/** 条目收录状态：未收录（本地独有）｜ PR 待审核（带 PR 链接）｜ 已收录（官方市场 index 含该 id） */
+type MyItemStatus = 'not-listed' | 'pr-pending' | 'listed';
+/** 上传表单：仅用户填写的描述性内容；id/author/version/updatedAt/repoUrl 全自动 */
+interface MyRepoForm {
+  /** 配置名（预填 zip 文件名，可改）；id 由其派生稳定 slug */
+  name: string;
+  description?: string;
+  categories?: string[];
+}
+/** upload / update 返回（ok=false 时携带已脱敏 error + errorCode） */
+interface UploadResult {
+  ok: boolean;
+  itemId: string;
+  version: string;
+  sha256: string;
+  sections: SectionId[];
+  /** 用户公开仓库 URL（https://github.com/<login>/dsh-configs） */
+  repoUrl: string;
+  prNumber: number | null;
+  prUrl: string | null;
+  warnings: string[];
+  /** ok=false 时：可展示错误（已脱敏，无 token 形态） */
+  error?: string;
+  /** ok=false 时：错误分类码（unauthorized/prepare_failed/...；无则 'internal'） */
+  errorCode?: string;
+}
+/** listItems 条目：用户仓库 index.json 条目 + 收录状态 */
+interface MyItemEntry {
+  id: string;
+  name: string;
+  version?: string;
+  description?: string;
+  author?: string;
+  updatedAt?: string;
+  categories?: string[];
+  status: MyItemStatus;
+  /** status=pr-pending 时：PR 链接 */
+  prUrl?: string;
+  /** 用户公开仓库 URL */
+  repoUrl: string;
+}
+//#endregion
+//#region src/client/market/my-configs-api.d.ts
+/**
+ * POST /me/status 响应：登录态 + 用户配置仓库状态（设计文档 §4.2）。
+ * 仅非敏感展示位：login 用户名可回显；token 值永不回传浏览器。
+ */
+interface MyMeStatusResponse {
+  loggedIn: boolean;
+  /** GitHub 登录名（展示 @login 用） */
+  login?: string;
+  /** 用户自己的配置仓库 URL（无则尚未创建） */
+  repoUrl?: string;
+  /** 配置仓库是否已存在（false = 尚未创建过） */
+  repoExists?: boolean;
+}
+/**
+ * 一键上传/更新请求体中的表单（设计文档 §2.4 用户输入最小化）：
+ * 仅 name（必填，预填 zip 文件名可改）/ description（可选）/ categories（可选）；
+ * id / author / version / updatedAt 全部系统自动生成，不在表单里。
+ * categories 为数组（UI 层先经 parseCategories 解析逗号分隔文本）。
+ * **与 Host 半 my-repo.ts 的 MyRepoForm 同构**（对齐导出，避免漂移）。
+ */
+type MyConfigsFormPayload = MyRepoForm;
+/**
+ * POST /me/upload | /me/update 响应（**对齐 host 半 my-repo.ts 的 UploadResult**）。
+ * ok=false 时 itemId/version/sha256 可为空串，warnings/error/errorCode 携带可展示信息（已脱敏）。
+ */
+type MyUploadResult = UploadResult;
+/** POST /me/items 响应：用户仓库的全部条目（空仓库 → 空数组）。
+ *  条目 = Host 侧 MyItemEntry（含收录状态 status + prUrl + repoUrl，§4.5 在 Host 判定）。 */
+interface MyItemsResponse {
+  items: MyItemEntry[];
+}
+/**
+ * 「我的配置」浏览器半数据入口（MarketPanel 的「我的配置」子视图注入业务面）。
+ * 登录（GitHub device flow）不在此类 —— 复用 SyncApi.githubStart/githubPoll/githubCancel。
+ */
+declare class MyConfigsApi {
+  readonly t: UiT;
+  constructor(t?: UiT);
+  /** 读取登录态 + 用户配置仓库状态（token 失效 → Host 返回 401/未登录，UI 引导重新登录） */
+  meStatus(): Promise<MyMeStatusResponse>;
+  /** 一键上传：校验 → 建/复用仓库 → 写入用户仓库 → fork → 改官方 index → 提收录 PR */
+  meUpload(payload: {
+    zipPath: string;
+    form: MyConfigsFormPayload;
+  }): Promise<MyUploadResult>;
+  /** 读取已上传条目列表（用户仓库 index.json；每条目含 Host 侧判定的收录状态） */
+  meItems(): Promise<MyItemsResponse>;
+  /** 一键更新：version 自动 +1，复用/重开收录 PR */
+  meUpdate(payload: {
+    zipPath: string;
+    form: MyConfigsFormPayload;
+  }): Promise<MyUploadResult>;
+}
+//#endregion
 //#region src/client/client-types.d.ts
 /** 本插件 Client 半的注入业务面：每个 settings.section 注册项都拿到同一个 api 实例 */
 interface ConfigManagerSectionInjected {
@@ -1185,6 +1295,8 @@ interface ConfigManagerSectionInjected {
   syncT: import('@deepseek-ai/dsh-client-ui-slots').TranslateNS<'config-manager-sync'>;
   /** 配置市场 API（备份与迁移页第 5 个 tab 使用，主 section 注册时注入） */
   marketApi: MarketApi;
+  /** 「我的配置」API（MarketPanel 的「我的配置」子视图使用，主 section 注册时注入） */
+  myConfigsApi: MyConfigsApi;
   /** 配置市场 locale（config-manager-market 命名空间，主 section 注册时注入） */
   marketT: import('@deepseek-ai/dsh-client-ui-slots').TranslateNS<'config-manager-market'>;
 }
@@ -1618,6 +1730,62 @@ declare const zh: {
   readonly 'publish.submit.repoMissing': "收录引用需要托管仓库 URL——请先在上一步「生成条目包」中填写。";
   readonly 'publish.copied': "已复制";
   readonly 'publish.copyFailed': "复制失败，请手动选择文本复制";
+  readonly 'myconfigs.tab.browse': "浏览市场";
+  readonly 'myconfigs.tab.myconfigs': "我的配置";
+  readonly 'myconfigs.back': "返回市场";
+  readonly 'myconfigs.login.title': "GitHub 登录";
+  readonly 'myconfigs.login.hint': "登录后即可一键上传配置到你的公开仓库（自动创建 <login>/dsh-configs）并提交官方市场收录（目标仓库固定，不可修改）。";
+  readonly 'myconfigs.login.checking': "正在检查登录状态…";
+  readonly 'myconfigs.login.loggedInAs': "已登录：{login}";
+  readonly 'myconfigs.login.targetRepo': "收录目标（固定）：{repo}";
+  readonly 'myconfigs.login.repoMissing': "配置仓库尚未创建，首次上传将自动创建（公开）";
+  readonly 'myconfigs.login.repoReady': "配置仓库：{repo}";
+  readonly 'myconfigs.login.start': "使用 GitHub 登录";
+  readonly 'myconfigs.login.relogin': "重新登录";
+  readonly 'myconfigs.login.cancel': "取消登录";
+  readonly 'myconfigs.login.userCode': "一次性代码：{code}";
+  readonly 'myconfigs.login.openAuth': "打开授权页";
+  readonly 'myconfigs.upload.title': "一键上传";
+  readonly 'myconfigs.upload.selectHint': "选择导出的配置 zip（先在「导出」tab 生成备份文件，再回到这里选择）。市场通道永不携带秘密——包含密钥的备份将被拒绝。";
+  readonly 'myconfigs.upload.select': "选择 ZIP…";
+  readonly 'myconfigs.upload.reselect': "重新选择";
+  readonly 'myconfigs.upload.selected': "已选择：{name}";
+  readonly 'myconfigs.upload.validate': "开始校验";
+  readonly 'myconfigs.upload.validating': "校验中…";
+  readonly 'myconfigs.upload.validateOk': "校验通过：内容合法、不含密钥";
+  readonly 'myconfigs.upload.validateSecrets': "包含密钥：市场通道永不携带秘密，拒绝上传";
+  readonly 'myconfigs.upload.validateInvalid': "内容校验未通过，无法上传";
+  readonly 'myconfigs.upload.form.title': "条目信息";
+  readonly 'myconfigs.upload.form.name': "名称";
+  readonly 'myconfigs.upload.form.nameHint': "预填 zip 文件名，可修改";
+  readonly 'myconfigs.upload.form.description': "描述（可选）";
+  readonly 'myconfigs.upload.form.categories': "类别（可选，逗号分隔）";
+  readonly 'myconfigs.upload.form.autoHint': "以下字段由系统自动生成：";
+  readonly 'myconfigs.upload.run': "一键上传";
+  readonly 'myconfigs.upload.running': "上传中…";
+  readonly 'myconfigs.update.title': "更新配置";
+  readonly 'myconfigs.update.hint': "版本将自动 +1，已预填原条目信息（名称可改）。";
+  readonly 'myconfigs.update.run': "一键更新";
+  readonly 'myconfigs.update.running': "更新中…";
+  readonly 'myconfigs.result.title': "上传/更新完成";
+  readonly 'myconfigs.result.version': "版本 {version}";
+  readonly 'myconfigs.result.sha256': "SHA-256：{hash}";
+  readonly 'myconfigs.result.sections': "分区：{sections}";
+  readonly 'myconfigs.result.repo': "配置仓库";
+  readonly 'myconfigs.result.openRepo': "打开仓库";
+  readonly 'myconfigs.result.pr': "收录 PR #{number}";
+  readonly 'myconfigs.result.openPr': "查看 PR";
+  readonly 'myconfigs.list.title': "已上传";
+  readonly 'myconfigs.list.empty': "尚未上传任何配置";
+  readonly 'myconfigs.list.loading': "正在读取…";
+  readonly 'myconfigs.list.refresh': "刷新";
+  readonly 'myconfigs.list.summary': "共 {total} 条 · {listed} 已收录 · {pending} 待审核 · {none} 未收录";
+  readonly 'myconfigs.list.openRepo': "打开仓库";
+  readonly 'myconfigs.item.update': "更新";
+  readonly 'myconfigs.item.install': "装回本地";
+  readonly 'myconfigs.item.openPr': "查看收录 PR";
+  readonly 'myconfigs.error.loadStatus': "登录状态读取失败";
+  readonly 'myconfigs.error.loadItems': "已上传列表读取失败";
   readonly 'common.cancel': "取消";
   readonly 'common.close': "关闭";
   readonly 'common.retry': "重试";
@@ -1653,8 +1821,12 @@ interface SyncSettingsViewProps {
 //#region src/client/market/MarketPanel.d.ts
 interface MarketPanelProps {
   api: MarketApi;
+  /** 「我的配置」API（/me/* 端点：登录态/一键上传/查看已上传/一键更新；登录复用 SyncApi.github*） */
+  myConfigsApi: MyConfigsApi;
   /** 确认导入复用的主 ConfigManagerApi（executeImportPlan：安全阀 + 回滚） */
   importApi: ConfigManagerApi;
+  /** GitHub 登录 API（「我的配置」登录卡复用 sync github device flow，同 token 槽） */
+  syncApi: SyncApi;
   t: TranslateNS<'config-manager-market'>;
 }
 //#endregion