v0.8.0

[xiaxi626]

This release turns link into a real source registry: eighteen new external sources on top of trae-cn — nineteen in total — each with its own discovery function behind one generic --source-dir override, all exposed in the panel. It also narrows trae-cn to skills/ only, fixes editor TypeScript resolution for src/client, and hardens the shell-completion test harness.

✨ Features

• Generic link source registry: a SOURCE_CONFIGS table pairs every source with its environment variable, default root and discovery function, replacing the hardcoded Trae path list. --source-dir <path> overrides the selected source root for every source (the legacy --trae-cn-dir stays as an alias); the override is threaded through POST /skills-nexus/link (sourceDir), the panel's root-directory input and the browser client, and all four shell completion templates offer it.
• trae (international): ~/.trae/skills/, overridable with TRAE_DIR.
• qoder: user-level skills/ plus marketplace plugins — reads plugins/installed_plugins_v2.json, resolves each plugin's skill directories from its plugin.json (falling back to ./skills/), and excludes the qoder-bundler publisher that ships with the client.
• qoder-cn: the same layout under ~/.qoder-cn, reusing one discovery function instead of a second copy of the layout knowledge.
• codebuddy / workbuddy: plain <root>/skills/ scanning.
• Thirteen further sources: copilot ~/.copilot, claude-code ~/.claude, pi ~/.pi/agent, codex ~/.codex, cursor ~/.cursor, shared ~/.agents, opencode ~/.config/opencode, gemini ~/.gemini, zcode ~/.zcode, openclaw ~/.openclaw, augment ~/.augment, kimi-code ~/.kimi-code, windsurf ~/.codeium/windsurf. What they share is the discovery contract — one level of <root>/skills/, no recursion, no flat SKILL.md, no plugin manifest, no version layer — not the nature of their roots: client home, config root, agent directory, state dir, a subdirectory of a data root, a cross-tool shared root, a legacy personal location and a nested vendor path all appear here. Six reuse the client's own official variable (COPILOT_HOME, CLAUDE_CONFIG_DIR, PI_CODING_AGENT_DIR, CODEX_HOME, OPENCODE_CONFIG_DIR, OPENCLAW_STATE_DIR); the other seven take a Nexus-side *_DIR. SUPPORTED_SOURCES is now 19.
• Boundary rules kept explicit: ~/.agents is registered once as shared; compatibility directories (~/.agents, ~/.claude, ~/.codex) are never merged into a vendor source, so one physical directory never becomes several entries. KIMI_CODE_HOME and GEMINI_CLI_HOME are deliberately not scan roots — they replace the client's data root or home, not the Nexus scan root.
• Panel: twenty source buttons, nineteen enabled, Antigravity the only disabled placeholder (its global skill directory differs between the app, CLI and IDE builds, so the contract stays open). Trae and every enabled source preview through source-aware link calls.

🐛 Fixes

• link trae-cn scans skills/ only: ~/.trae-cn/builtin_skills/ is no longer discovered — silently, by design. Existing entries remain removable with remove --group trae-cn/builtin_skills --yes.
• Editor TypeScript resolution: src/client/tsconfig.json gives the panel its own project file, so TS Server stops falling back to the root tsconfig.json and reporting TS2307 / TS7016 on panel.tsx and the panel render test.
• Shell-completion test harness: an abnormal child death (NTSTATUS exit, signal, or null status) is now distinguished from a genuinely broken template and retried once, so a flaky runner no longer turns a green matrix red with an empty error message.
• Windows fixture teardown: temporary trees are removed through a retrying helper, so a transient EBUSY can no longer fail an unrelated suite.

⚙️ Changed

• Test coverage: 836 tests · 833 pass · 3 skip (up from 754 in v0.7.0). The three skips are the real bash / zsh / fish completion runs.
• Docs: bilingual README / ARCHITECTURE / sources-and-packages / verify-link-sources updated — the source table now lists all nineteen, the verification guide gained an eighth checkpoint (PASS agent clients), and every new group has an uninstall line.
• Uninstall: dsh-skills-nexus remove --group <source> --yes removes only the symlinks and manifest entries; the linked source directories are never touched.
• README: capability overview and external-source tables, an npm-downloads badge, and the registry install note now points at "the latest published npm release" instead of a hardcoded version number.
• Verification: typecheck, lint, the full 836-test suite, both build steps with no lib/ drift, and all eight bash blocks of both verification guides pass locally. The thirteen new roots follow each client's official documentation; they were not exercised against installed clients on this machine.

⬆️ Install / Upgrade

• New: dsh plugin --profile web add "github:xiaxi626/dsh-skills-nexus", then restart once.
• Upgrade: dsh plugin --profile web remove dsh-skills-nexus then re-add. Already-registered skills are untouched; refresh with dsh-skills-nexus update.

---

本次发布把 link 变成真正的来源注册表：在 trae-cn 之外新增十八个外部来源，合计十九个，每个来源都有自己的发现函数，共用同一个 --source-dir 根覆盖，并在面板里全部可见。同时把 trae-cn 收窄到只扫 skills/，修复 src/client 的编辑器 TypeScript 解析，并加固补全测试工装。

✨ 新增

• 通用来源注册表：SOURCE_CONFIGS 为每个来源登记环境变量、默认根与发现函数，取代原先写死的 Trae 路径列表。--source-dir <path> 对任何来源覆盖所选根（旧参数 --trae-cn-dir 保留为别名）；覆盖规则贯通 POST /skills-nexus/link（sourceDir）、面板的根目录输入与浏览器客户端，四种 shell 补全模板均提供该参数。
• trae（国际版）：~/.trae/skills/，可用 TRAE_DIR 覆盖。
• qoder：用户级 skills/ 之外还读市场插件——解析 plugins/installed_plugins_v2.json，按插件自己的 plugin.json（缺省 ./skills/）定位技能目录，并排除随客户端下发的 qoder-bundler 发布方。
• qoder-cn：~/.qoder-cn 下布局完全相同，复用同一个发现函数，不再复制一份布局知识。
• codebuddy / workbuddy：按 <root>/skills/ 一层扫描。
• 另外十三个来源：copilot ~/.copilot、claude-code ~/.claude、pi ~/.pi/agent、codex ~/.codex、cursor ~/.cursor、shared ~/.agents、opencode ~/.config/opencode、gemini ~/.gemini、zcode ~/.zcode、openclaw ~/.openclaw、augment ~/.augment、kimi-code ~/.kimi-code、windsurf ~/.codeium/windsurf。它们共享的是发现契约——只扫 <root>/skills/ 一层、不递归、不认扁平 SKILL.md、不读插件清单、没有版本层——而根的性质并不统一：客户端 home、配置根、agent 目录、state 目录、数据根下的子目录、跨工具共享根、旧版个人位置、嵌套 vendor 路径都在其中。其中六个复用客户端自己的官方变量（COPILOT_HOME、CLAUDE_CONFIG_DIR、PI_CODING_AGENT_DIR、CODEX_HOME、OPENCODE_CONFIG_DIR、OPENCLAW_STATE_DIR），其余七个使用 Nexus 侧的 *_DIR。SUPPORTED_SOURCES 至此为十九项。
• 边界规则明确写出：~/.agents 只登记一次，来源名为 shared；兼容目录（~/.agents、~/.claude、~/.codex）一律不并入任何 vendor 来源，避免同一物理目录被注册成多条。KIMI_CODE_HOME 与 GEMINI_CLI_HOME 刻意不作为扫描根——它们替换的是客户端的数据根 / home，不是 Nexus 的扫描根。
• 面板：来源行共二十个按钮，十九个可用，Antigravity 是唯一禁用占位（它的 global 技能目录在 app / CLI / IDE 三种形态下各不相同，契约未定前不纳管）。Trae 起所有已启用来源都走「来源感知」的预览与执行。

🐛 修复

• link trae-cn 只扫 skills/：~/.trae-cn/builtin_skills/ 不再被发现，静默忽略属有意行为。存量条目仍可用 remove --group trae-cn/builtin_skills --yes 清理。
• 编辑器 TypeScript 解析：新增 src/client/tsconfig.json，让面板拥有自己的项目文件，TS Server 不再回落到根 tsconfig.json 而把 panel.tsx 与面板渲染测试报成 TS2307 / TS7016。
• 补全测试工装：把「子进程异常死亡」（NTSTATUS 退出码、被信号杀死、status 为空）与「模板真错」区分开，并立即重试一次，runner 抖动不再以一条空错误消息把全绿矩阵刷红。
• Windows 夹具清理：临时目录改走带重试的删除助手，瞬时 EBUSY 不再连累无关套件。

⚙️ 变更

• 测试覆盖：836 条 · 833 通过 · 3 跳过（v0.7.0 为 754 条）。三个跳过项是 bash / zsh / fish 补全的真 shell 实跑。
• 文档：双语 README / ARCHITECTURE / sources-and-packages / verify-link-sources 同步——来源表列全十九行，验证指南新增第八个检查点（PASS agent clients），每个新组都给出卸载命令。
• 卸载：dsh-skills-nexus remove --group <source> --yes 只删除链接与 manifest 条目，被链接的源目录全程不动。
• README：新增能力总览与外部来源表、npm 下载量徽章，registry 安装说明改为指向「最新发布版本」而不再硬编码版本号。
• 验证：typecheck、lint、836 项全量测试、两步构建（lib/ 无漂移）、两份验证指南的全部八个 bash 块在本机通过。十三个新根依据各客户端官方文档；本机未安装这些客户端，未对它们做真机链接验收。

⬆️ 安装 / 升级

• 新装：dsh plugin --profile web add "github:xiaxi626/dsh-skills-nexus"，随后重启一次。
• 升级：dsh plugin --profile web remove dsh-skills-nexus 后重新 add。已注册技能不受影响，用 dsh-skills-nexus update 刷新。

---

This discussion was created from the release v0.8.0.