dsh-github-sync

GitHub 同步插件 (@local/dsh-github-sync)

专为 DSH 插件开发者设计：把本地工作区里的插件作为干净副本推送到各自独立的 GitHub 仓库，并给新仓库打上 dsh-plugin topic。

核心设计与特性

1. 绝对防误触 / 双阶段确认机制（自然交互 + 零日常污染）：

• 平时不注入任何系统提示词，完全不消耗日常聊天的 Context 和 token（通过标准 Skill 机制按需加载）。
• 插件自身绝不自动上传，也没有任何后台轮询/保存即上传的钩子。
• 全面支持自然语言驱动：无需再像旧版那样死板地连发两次特定 /git 语法，用户自然表达同步意图即可唤醒执行。
• 双阶段安全确认（Tool Guard）：即使 AI 产生幻觉试图直接调用 github_sync_push，若未经用户确认，调用会被工具层强拦截拒绝，强制要求先跑 github_sync_plan 汇报改动，并在获得用户明确肯定后带上 confirm: true 才能执行真实推送。

1. 凭据安全（Token 只存一次，且不可能被推上去）：

• GitHub Token 只放在机器级用户目录：%USERPROFILE%.dsh\github-sync\config.json。
• 该文件不在任何工作区/仓库里，绝不进 git，所有 DSH 会话和 profile 自动复用。
• 不要把 token 写进插件目录里的 `sync.config.json`：那个文件在干净副本范围内，等于把密钥放到待上传目录。若真写了，插件会：① 在状态里告警；② 由密钥扫描把含密钥的文件从干净副本中剔除并列为阻断项，绝不推上去。
• 推送时通过临时生成的凭据助手（Credential Helper）把 token 交给 git，命令行参数、remote URL、报错信息里都不会出现明文（报错统一脱敏）。
• 密钥扫描覆盖：GitHub 经典/细粒度 token、Slack token、AWS Access Key、sk- 风格密钥、Google API key、私钥文件头及 .pem, .key, .crt, .cert, .token, .secret, .auth 等敏感扩展名。文档里的占位符（如 ghp_xxxx）不会误报。

1. 干净副本（Clean Copy）：

• 自动排除运行时与非必要文件：.git/、node_modules/、cache/、dist/、build/、coverage/、*.status.json、*.local.json、.env*、_scratch/、_research/ 等。
• 符号链接不跟随（避免把仓库外的内容复制进去）。
• 插件若自带 .gitignore 或配置了 include 白名单，一律尊重（include 白名单也不会绕过密钥扫描）。
• 智能增量同步：发布时镜像工作树与干净副本进行增量 diff 比对，未变动文件完全不擦写磁盘，大幅减少 I/O 磨损并杜绝 Windows 文件句柄占用冲突（EBUSY）；干净副本里删除的文件会作为删除提交出现在历史中。
• 单文件大小沿用 GitHub 自己的数字，不自定：默认上限 maxFileBytes = 100 MiB，正是 GitHub 的硬上限（官方原文：*GitHub blocks files larger than 100 MiB*）；超过 50 MiB 按 GitHub 的规则给警告但仍可推（官方原文：*you will receive a warning from Git*）。超过上限是阻断项而非静默漏掉——静默丢文件会发布出一个悄悄坏掉的插件。密钥扫描的范围与上限一致，大文本文件无法靠体积绕过扫描。

1. 提交署名归你（不是工具的假身份）：

• 提交的作者署名默认按 token 所属账号派生，邮箱用 GitHub 的 noreply 形式 +@users.noreply.github.com：既能关联到你的头像，又不公开真实邮箱。
• 想用自己的邮箱就配 git.userEmail（git.userName 可选）。前提是该邮箱已在 GitHub 账号里验证过：GitHub 靠邮箱归属提交，没验证过的邮箱会让提交显示成一个没有头像、点不开的陌生人。
• 注意 git 的性质：写进提交的邮箱是公开的。不想公开就用默认的 noreply 形式。

1. 标准 git 流程：增量提交、真实历史、普通推送：

• 每个插件一个常驻本地镜像仓库（clone），存放在 %USERPROFILE%.dsh\github-sync\mirrors，.git 保留 → 历史正常累积。
• 每次发布 = 把干净副本同步进镜像 → 一个真实提交 → 普通 `git push`（不强制）。git log / git blame / git revert 全部可用。
• 推送前先 fetch 并以远端 tip 为基准提交，所以别人在 GitHub 网页上的修改、或另一台克隆推上来的提交，都会被保留，你的提交落在它们上面（而不是把它们抹掉）。
• 无变更不提交：干净副本与远端一致时不产生空提交，结果为 unchanged。
• 推送被拒绝就如实报错，绝不偷偷强推。拒绝信息会区分「远端有本地没有的提交（竞态，重跑即可）」和「分支受保护（要去改仓库设置）」两种情况。
• `force` 保留为显式选项（原本的快照语义）：生成一个孤立根提交（干净副本）并强推，远端历史被替换。用途是"这个提交必须从历史里消失"（比如误提交了密钥），不是日常发布。
• 镜像坏了/想重新对齐远端：删掉该镜像目录即可，下次会自动重建。

1. 开源协议（按需生成，不替你选）：

• 插件目录里已有 LICENSE / COPYING 等文件时直接沿用。
• 缺失且配置了 github.license 时，从 GitHub 官方接口 GET /licenses/{key} 取权威正文（不自己编），替换版权行后作为 LICENSE 写进同一个提交。正文会缓存到 licensesDir，之后不再依赖网络。
• 未配置时只告警：选协议是法律决定，不该由工具替你定。
• 占位符按各协议实际形态替换（MIT/ISC/BSD 用 [year]/[fullname]，Apache-2.0 用 [yyyy]，MPL-2.0 无占位符则原样保留）。

1. 自适应：先判定"这是什么"，再套对应规则：

• 工具会先判断目标是不是 DSH 插件，依据是 package.json 的 dsh.bundle / dsh.client，或关键词含 dsh（cordis.patch.yml 同样算），并把这个判定和它的依据报出来（状态、试运行、/git 说明里都写），所以判断是可见、可反驳的，不靠猜。
• 不是所有目录都套同一条规则：dsh- 前缀、dsh-plugin topic 只对判定为 DSH 插件的目标生效；普通项目不套用，也不会被打上 DSH 的标签。
• 工作区扫描只认带 DSH 指纹的目录——这是刻意的：否则它会把你的笔记、图片堆、node_modules 一起当成待发布物。
• 扫描结果 ≠ 可发布范围（重要）。扫描器只回答"工作区里有什么看起来像 DSH 插件"，它不是权限的来源——权限来自你（或正在那个项目里工作的会话）的要求。所以 github_sync_plan / github_sync_push 的 plugins 参数也可以直接写目录路径（相对或绝对），扫描没认出来的目录照样能发布。详见下一条。

1. 按路径发布：任何目录都能推：

• plugins 参数接受三种写法，按顺序解析：插件名（仓库名 / 目录名 / 包名）→ 目录路径 → 都失败才报错。
• 所以 /git 推送 my-app（工作区里同名目录）和 /git 推送 ../my-app（工作区外）都能用。适合自己的普通项目、别的宿主的插件，或任何你不想为了发布而改目录名/加 DSH 标记的东西。
• 发布流程完全一样：干净副本（排除 node_modules、cache、.env、*.status.json…）、密钥扫描、单文件上限、真实提交与普通推送。唯一的差别是不套 DSH 的命名约定，也不打 `dsh-plugin` topic（除非你显式要求）。
• 计划里会明确标注「显式给出的路径，不在扫描结果里」，并且如果这个目录正好是扫描根目录本身，会额外提醒"会把该目录下所有内容当成一个仓库"。
• 每个目标的仓库名默认取目录名；想改就在配置里写 plugins（键可用请求时的原字符串 / 绝对路径 / 目录名任一）："plugins": { "my-app": { "repo": "my-app-gh", "visibility": "public" } }。
• 唯一会拒绝的路径是与 DSH 自己的目录（~/.dsh，存着 token、会话记录、发布镜像）相重叠的目录——例如 ~、~/.dsh、~/.dsh/profiles。这是为了保护密钥，不是约定。

1. 命名约定：`dsh-` 前缀（建议，不是硬墙）：

• DSH 插件的文件夹建议带 dsh- 前缀，仓库名默认就等于那个文件夹名（文件夹 = 插件在磁盘上的身份）。所以 dsh-sticker/ → 仓库 dsh-sticker。
• 不合规时默认只警告（naming: "warn"）：仓库名会照文件夹名走，在 dsh-plugin 汇总里不太像同类——这是外观问题，不是数据问题，所以不值得拒绝发布。警告里会给出确切的改名建议（例如 nova-preset → dsh-nova-preset）以及改名的代价。
• 想恢复硬拦就设 naming: "block"；naming: "off" 则完全不检查。
• 任何情况下都不会静默改名——只报告，由你决定。
• 包名（package.json 的 name）与文件夹名不一致不影响判定：规则只认文件夹。
• 有意的例外：显式写 plugins..repo 即按你的值走，不再判定合规。
• 注意：改文件夹名会打断 profile 里按路径建立的 link: 依赖，改完需要在插件管理里重新安装/链接。

1. 联合投稿（GitHub topics）：

• 默认给判定为 DSH 插件的仓库打上 dsh-plugin topic，全部汇总到 https://github.com/topics/dsh-plugin —— 这就是"联合投稿"的落地方式，不需要任何中心化注册表。
• 改 github.topics 可加自己的标签；写 [] 表示不打标签；单个插件可用 plugins..topics 覆盖。
• topics 页只收录公开仓库：私有仓库打了标签也不会出现在那里。要真正"被联合投稿收录"，仓库得是 public。
• topics 在代码推送成功之后才设置，所以即使打标签失败也不会影响代码上传。

快速配置使用

1. 填写 GitHub 账号与 Token（只需一次）

编辑用户配置文件（不在任何仓库里）： %USERPROFILE%.dsh\github-sync\config.json （插件首次加载会自动生成带注释的模板，所以通常直接打开改就行。）

{
  "github": {
    "owner": "你的GitHub用户名",
    "token": "ghp_xxxx 或 github_pat_xxxx",
    "topics": ["dsh-plugin"],
    "license": "MIT",
    "copyright": "你的署名或组织名"
  }
}

owner 也可以写在插件目录的 sync.config.json 里；用户文件里的空字符串不会覆盖插件目录里已填的值（留空即"未指定"，要清空请写 null）。 github.license 留空表示不自动生成（只在状态里告警）；github.copyright 留空则用 github.owner。 想让提交署自己的名字/邮箱，再加一段 "git": { "userName": "你的名字", "userEmail": "你的邮箱" }；该邮箱要先在 GitHub 账号里验证过才会关联到你的头像。留空则自动用账号的 noreply 邮箱（可关联、且不公开真实邮箱）。

Token 权限要求（依据 GitHub REST 官方文档核实）

经典 Token（Classic）— 只勾 `repo` 就够：

- repo 已包含 public_repo，所以勾了它就同时覆盖公开仓库与私有仓库。

- POST /user/repos（在自己账号下建仓）官方原文：*need the public_repo or repo scope to create a public repository, and repo scope to create a private repository.* → `repo` 一个就够。

- POST /orgs/{org}/repos（在组织下建仓）官方原文同上，但额外要求：*The authenticated user must be a member of the organization.*

- repo 同时给到代码读写，所以推送也用它。

- 勾 repo 时 UI 会自动带上 repo:status、repo_deployment、public_repo、repo:invite，无害，不用管。security_events、delete_repo、write:packages 都不需要。

- 唯一例外：若某插件目录含 .github/workflows/*.yml，需要额外勾 workflow（授予"添加和更新 Actions 工作流文件"）。首次推送到空仓库时不存在"同名同内容的旧分支"，那条豁免不成立。

细粒度 Token（Fine-grained）：

- 推送代码：Contents: Read and write。

- 自动新建仓库：Administration: write 或 Repository creation: write（官方为"满足其一"）。

- 打 topics：Administration: write。

- 组织启用了 SAML SSO 时，token 需单独授权给该组织，否则 403。

权限不足时不用猜：报错会直接打出 HTTP 状态码与对应提示（401 认证失败 / 403 权限不足 / 404 看不到）。分支保护导致推送被拒时会明确说是分支保护，而不是伪装成别的错误。

2. 在会话中使用（两阶段确认）

得益于 v0.5.0 的双阶段安全防护，您既可以自然对话唤起，也可以随时发起预览：

帮我看看有哪些插件改动了     → 自动调用 github_sync_status / github_sync_plan，只读汇报
把 dsh-sticker 推到 GitHub  → 自动先执行试运行 Plan，向您汇报改动文件与大小，等待确认
推吧 / 确认推送              → 收到您的肯定答复后，才真正执行增量提交与远程推送

/git 命令依然作为快捷入口保留，您可以根据习惯随时使用。

3. 命令与工具说明

• /git [要求]：快捷触发入口（留空只读调查，带意图发起同步）。
• github_sync_status：只读查看配置、token 来源、git 可用性、目标清单与判定结果（哪些是 DSH 插件、哪些不是）、协议与镜像位置（只读，不联网）。
• github_sync_plan：试运行（Dry Run），列出将提交/排除的文件与原因、会打的 topic、协议是沿用还是生成。verbose 可看全部排除项（只读，不提交也不推送）。
• github_sync_push：真正的提交与推送。默认增量提交 + 普通 push；force: true 才会用单次快照替换远端历史。仓库不存在时按 visibility 自动创建，随后打 topics。需要 `confirm: true` 确认参数或前置授权。

常见的几件运维事

想做的事 · 怎么做 只想看会发生什么 · github_sync_plan（或 github_sync_push 加 dryRun: true），都不提交、不推送 重跑一次被拒的推送 · 直接再推一次：会先 fetch 远端再提交，通常就正常了 某个提交必须从历史里消失 · github_sync_push 带 force: true（远端历史被替换成单次快照） 镜像状态坏了 · 删掉 %USERPROFILE%.dsh\github-sync\mirrors，下次自动重建 某个插件不想带协议 · 该插件目录放自己的 LICENSE（会被沿用），或给该插件设 license: ""

改代码之后：模块缓存（实测结论）

DSH 的 Loader 按模块 URL 缓存，并且不看内容与修改时间：文件内容改掉之后，运行中的进程仍然复用旧模块。实测过两次，结论是：

• 只改入口文件名不够。 单独把入口改名、模块目录原样不动，宿主依旧跑旧逻辑 —— 因为被 import 的模块 URL 没变。
• 每个改过内容的文件都必须换 URL。 要么重启 DSH（最省心，推荐），要么把改动的文件/目录一起改名，再重新 enable 一次 bundle。
• cordis.patch.yml 里的 name 指向入口文件，入口改名时同步更新；package.json 的 exports / files 也要跟着改。

实际操作最省事的流程：改完代码 → 重启 DSH。只有在不能重启时才用改名法。

目录结构

main.mjs                入口：系统提示词闸门 + /git 指令 + 三个工具 + 守卫
core/config.js          配置合并、凭据定位、命名与 topic 规范化、告警
core/discover.js        插件发现 + dsh- 前缀约定（文件夹即仓库名）
core/manifest.js        干净副本清单 + 密钥扫描 + glob/gitignore 匹配
core/license.js         协议检测与生成（正文取自 GitHub 官方接口并缓存）
core/git.js             常驻镜像、增量提交、普通/强制推送、凭据助手
core/github.js          REST：建仓、查仓库、打 topics
core/sync.js            计划 / 执行编排（命名阻断、协议、topics、结果汇总）
core/prompt.js          /git 闸门（按会话、按轮次授权）与工具守卫
sync.config.json        插件自带配置（只放通用默认值）
sync.status.json        运行期诊断（自动生成，永不推送）

（src/、lib/、internal/ 与 index.js、host.mjs、plugin.mjs 都是同一份代码的早期名字：因为上面的模块缓存机制，每次改动都得换 URL，所以历史名被留在了旧代次里。今后请优先重启 DSH，别靠改名。）

发布约定

这个插件自己也遵守它检查别人的那两条约定（/git 的说明与 Skill 规范中均有明确要求）：

1. 有改动就升 `package.json` 的 `version`。文件变了而版本没变，插件会在推送结果里警告。
2. README 必须全篇同步维护：

• 检查并修改所有与当前版本行为、机制、架构不一致的旧描述，确保正文机制与现版本严格吻合；
• 末尾保留「版本历史」小节，按版本倒序记录，每条必须标注当前系统真实时间（格式：年-月-日 时:分），绝不可臆造。升了版本但 README 搜不到该版本号，插件同样会警告。

📌 版本历史

v0.5.0（2026-10-13 21:40）

• 双阶段确认机制（解绑死板 `/git` 门禁）：移除必须在聊天框显式输入 /git 才能推送的硬性拦截，全面支持自然语言对话驱动。真实推送工具 github_sync_push 引入 confirm: true 参数校验，未确认前调用会自动拦截并提示先汇报 Plan，彻底杜绝 Agent 误推送。
• 智能增量镜像同步：重构 core/git.js 中的文件同步逻辑，从暴力的“全盘物理清空再全量重新写入”升级为“智能比对大小与 mtime 的增量同步”，大幅削减高频磁盘 I/O 并根绝 Windows 文件句柄占用冲突（EBUSY）。
• 标准 Skill 规范支持：建立 dsh-github-sync 标准技能，做到日常对话 0 Token 消耗，并在需要同步时自然激活。
• 扩展敏感文件扩展名扫描：将 .pem, .key, .crt, .cert, .token, .secret, .auth 等扩展名纳入密钥扫描范围，消除漏检隐患。

v0.4.0（2026-10-07 00:05）

• 按路径发布：扫描结果不再是可发布范围的上限。github_sync_plan / github_sync_push 的 plugins 参数现在也接受目录路径（相对或绝对），解析顺序是「插件名 → 目录路径 → 报错」。原来只认扫描结果的写法把发现当成了授权，而那两件事毫无关系：扫描器只是便利设施（列一下工作区里有什么），发布权限来自人的要求。
• 于是自己的普通项目、别的宿主的插件、任何不想为发布而改名或加 DSH 标记的目录都可以直接推；会话本身就在该项目开发环境里时，直接给出目录即可。
• 显式目标不套 DSH 命名约定、不打 `dsh-plugin` topic；其余流程完全一致（干净副本、密钥扫描、单文件上限、真实提交与普通推送）。仓库名默认取目录名，可在 plugins 里用「请求原字符串 / 绝对路径 / 目录名」任一键覆盖。
• 新增一条安全拒绝（不是约定）：与 DSH 自己的目录（~/.dsh，含 token、会话记录、发布镜像）相重叠的路径一律拒绝，避免误把凭据推上去。目录恰好是扫描根目录本身时会额外提醒。
• 修掉两个实现缺陷：①"没有匹配的插件"曾在解析显式路径之前就发出，导致同一个计划里既有正常条目又有假报错；②读取 package.json 复用了扫描器的函数（无 DSH 标记即返回 undefined），导致普通项目的名字与版本读不到（显示 0.0.0）。现在"读清单"与"判定是不是插件"是两件事。
• /git 说明新增一节「范围不等于扫描结果」。

v0.3.0（2026-10-06 18:40）

• `/git` 改成两阶段：/git 本身只进入调查轮（只读），推送工具会被拒绝并说明"要上传请再发一条带推送意图的 /git"；只有带推送意图（推送 / 上传 / 发布 / 同步 / push…）才是推送轮。这样"看看会推什么"不再被迫变成一次上传，而上传依然只可能发生在人明确要求的当轮。明说"先别推送/只看"会覆盖掉句中的"推送"。
• 判定代替一律套用：工具先判定目标是不是 DSH 插件（依据 package.json 的 dsh.bundle / dsh.client，或关键词含 dsh），并把判定结果与依据报在状态、试运行与 /git 说明里；dsh- 前缀与 dsh-plugin topic 只对 DSH 插件生效，普通项目不套用、不打 DSH 标签。
• `dsh-` 前缀从硬拦改为默认警告：新增 naming: "warn" | "block" | "off"，默认 warn（仍可发布，警告里给出确切改名建议与改名代价）；要恢复原来的硬拦设 block。任何情况下都不会静默改名。
• /git 的说明里新增一节讲清"先判定再套规则"，并明确：硬性要求只有两条——不要静默改名，不要静默替人决定协议。
• 顺带清理：core/discover.js 末尾多余的 export default（同一类 unwrapExports 坑）。

v0.2.2（2026-10-06 17:20）

• 让"消息工厂"的解析变成可失败但不致命：v0.2.1 改成静态 import { createUserMessage } from '@deepseek-ai/dsh-llm'，但实测该裸模块名从插件目录解析不到（宿主的包在 app.asar 内的 /dsh/node_modules/，插件在外部，Node 只会从插件目录往上找 node_modules）。静态 import 解析失败会让整个 bundle 加载失败——/git 闸门与三个工具会一起消失，比原 bug 更严重。
• 现在是加载期后台尝试 + 失败容忍：能解析就用宿主官方工厂，解析不到就用语义等价的本地实现（deepFreeze(structuredClone({ ...input, role: 'user', id: randomUUID() }))，与宿主 createMessage 逐字对应）。两条路径产出的消息都带非空 id，都不会破坏会话回放。
• 新增测试 ghsync-steer-test.mjs：驱动真实 bundle 与真实 apply()，断言真正进入收件箱的消息具备 id/role/source/content 且被冻结、两次注入 id 不同。故意不桩掉 `@deepseek-ai/dsh-llm`——"这个包能否解析"正是必须不影响结果的那件事。
• 顺带记录一个宿主自身的坑：dsh-agent/README.md 里 steer() 的官方示例只写了 content 与 source（没有 `id`），而 steer(input) 的实现是原样 inbox.splice(input)、不补 id，所以照文档写出来的插件会写出回放时校验失败的会话事件。宿主自己的调用方（dsh-api-session-controller）都是先用 createUserMessage 造消息再 steer，照它做才对。
• 补齐自动生成的用户配置模板：模板原先只有 github.owner / token / topics，新装的人根本不知道还能配提交署名和开源协议。现在模板同时列出 git.userName / git.userEmail 与 github.license / github.copyright，并注明"留空就按账号派生 noreply 邮箱（可关联头像、不公开真实邮箱）""自填邮箱需先在 GitHub 账号里验证过"。默认值仍安全留白：协议留空 = 不替你选协议，只提醒。
• 顺带清理：core/prompt.js、core/config.js 末尾多余的 export default（unwrapExports 的 exports.default ?? exports 会因此把具名导出整片遮掉，属同一类坑）。

v0.2.1（2026-10-06 12:36）

• 修复 `/git` 注入的消息缺 `id`，导致会话历史加载失败：/git 之前用裸对象 { role, content, source } 调 agent.steer()，而会话日志按原样记录 user/message，缺少 id 的事件在重启回放时被校验器拒绝——报 session event at seq N lacks an identified message，整个会话的历史加载都会失败（不只是 /git 那一轮）。
• 现在改用 harness 工厂 createUserMessage（来自 @deepseek-ai/dsh-llm）构造消息，由它生成并冻结 id，与其余用户消息一致。
• 仅影响 /git 注入的轮次；已写坏的历史事件需要单独修补，插件本身无法回改。

v0.2.0（2026-10-06 11:31）

• 改用标准 git 流程：每个插件一个常驻本地镜像（%USERPROFILE%.dsh\github-sync\mirrors），每次发布是增量提交并普通推送，历史累积、可用 git log/blame/revert；无变更不产生空提交。
• 推送前先 fetch 并以远端 tip 为基准提交，所以别人在网页或别处推上来的提交会被保留，不会被覆盖。
• 强推保留为显式选项 force：生成孤立根提交（干净副本）替换远端历史，用于"某个提交必须消失"（例如误提交密钥），不是日常发布。
• 新增开源协议支持：插件已有 LICENSE 则沿用；缺失且配置了 github.license 时从 GitHub 官方接口取正文（替换版权行、缓存到本地）写进同一提交；未配置只告警——选协议是法律决定，不替用户定。
• 提交署名归账号：默认按 token 所属账号派生，用 +@users.noreply.github.com，可关联头像且不公开真实邮箱；可用 git.userName/git.userEmail 覆盖。
• 单文件上限对齐 GitHub 官方数字：默认 maxFileBytes = 100 MiB（官方硬上限），超过 50 MiB 按官方规则警告但可推；超限是阻断项而非静默漏掉。密钥扫描范围与上限一致。
• 推送被拒时区分竞态（重跑即可）与分支保护（需去仓库设置改），不再笼统报错。
• 提交内容严格等于干净副本：干净副本里没有的文件会在下次提交中作为删除出现在历史里。
• 新增上述两条发布约定检查（有改动没升版本 / 升了版本 README 没记）。

v0.1.0（2026-10-05 16:16）

• 首次发布。把插件作为干净副本推送到独立 GitHub 仓库，单次快照强制推送。
• /git 单轮授权闸门：平时零注入，插件绝不自动上传，未授权轮的推送工具调用会被硬拦截。
• token 只存机器级用户目录，经临时凭据助手交给 git，不进命令行、URL 或报错文本；发布前做密钥扫描。
• dsh- 前缀命名约定（文件夹即仓库名），不合规列为阻断项并给出确切改名建议。
• 默认给仓库打 dsh-plugin topic（联合投稿汇总页），在代码推送成功后设置。