skillhub/plugins/dsh
XiaoSeS c4c3d5b63c
feat(dsh): refine skill lifecycle and release 0.3.0 (#986)
Refine marketplace actions, scoped installation, native questions, progress, removal and exact-version upgrades; align downloadable version pagination and OpenSpec.\n\nSigned-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-20 15:18:23 +08:00
..
scripts fix(dsh): support verified runtime patches and reconnect receipts (#967) 2026-10-19 13:40:54 +08:00
src feat(dsh): refine skill lifecycle and release 0.3.0 (#986) 2026-10-20 15:18:23 +08:00
test feat(dsh): refine skill lifecycle and release 0.3.0 (#986) 2026-10-20 15:18:23 +08:00
.eslintrc.cjs feat(dsh): add native SkillHub plugin for DeepSeek Harness (#956) 2026-10-16 19:22:26 +08:00
.gitignore feat(dsh): add native SkillHub plugin for DeepSeek Harness (#956) 2026-10-16 19:22:26 +08:00
bun.lock feat(dsh): refine skill lifecycle and release 0.3.0 (#986) 2026-10-20 15:18:23 +08:00
cordis.patch.yml feat(dsh): add native SkillHub plugin for DeepSeek Harness (#956) 2026-10-16 19:22:26 +08:00
LICENSE feat(dsh): add native SkillHub plugin for DeepSeek Harness (#956) 2026-10-16 19:22:26 +08:00
package.json feat(dsh): refine skill lifecycle and release 0.3.0 (#986) 2026-10-20 15:18:23 +08:00
README.en.md feat(dsh): refine skill lifecycle and release 0.3.0 (#986) 2026-10-20 15:18:23 +08:00
README.md feat(dsh): refine skill lifecycle and release 0.3.0 (#986) 2026-10-20 15:18:23 +08:00
THIRD_PARTY_NOTICES.md feat(dsh): add native SkillHub plugin for DeepSeek Harness (#956) 2026-10-16 19:22:26 +08:00
tsconfig.build.json feat(dsh): add native SkillHub plugin for DeepSeek Harness (#956) 2026-10-16 19:22:26 +08:00
tsconfig.json feat(dsh): add native SkillHub plugin for DeepSeek Harness (#956) 2026-10-16 19:22:26 +08:00

SkillHub for DeepSeek Harness

中文

A native DSH plugin for anonymous skill browsing, conversation search and installation, and local upgrade/removal. Open 技能中心 (Skill Center) in the DSH sidebar. The installation core is bundled; a separate SkillHub CLI installation is unnecessary.

Version 0.2.0 adds source-aware installation status to catalog cards and conversation results, including recorded versions, user/project scopes and abnormal records. Conversation status is a query-time snapshot. No matching record does not exclude manual or other-source installations, and file presence does not prove DSH activation. Matching uses Registry source, namespace and slug; a same-named directory from another source is not claimed.

Version 0.2.1 defaults to https://skill.xfyun.cn when registryUrl is omitted. An explicit empty or whitespace-only value still disconnects; existing custom addresses are preserved. CLI defaults and credentials are not inherited.

This version uses the independent dsh-v0.2.1 release tag and retains the DSH dependency compatibility and historical receipt fixes from 0.1.1. Until npm publication and public-package verification finish, validate this version using its built tarball.

Requirements and validation scope

Component Requirement or scope
DSH 0.2.0-rc.2, with the matching official module versions
Cordis The two explicitly verified complete combinations below
Host Node >=24.2.0 <25; Node 24.0.0 is unsuitable
Build package manager Bun 1.3.13, using frozen lockfiles
UI Chinese, DSH light/dark themes and narrow layouts
Verified environments Linux DSH Host/browser integration; Windows browser UI and interactions against a real Host
Pending validation Real macOS Host/client; other DSH releases; real model execution of SaaS skills

Windows browser acceptance does not establish complete native Windows Host filesystem support. CI results do not replace desktop, model, or target-instance acceptance. See the repository's compatibility design and acceptance criteria.

Build and package

From the repository root:

cd cli
bun install --frozen-lockfile
cd ../plugins/dsh
bun install --frozen-lockfile
bun run check
npm pack --dry-run --ignore-scripts

check builds Host/Client, generated Remote bindings and declarations, then runs type checking, lint and tests. Lint uses the locked tools in cli/. Bun is a build dependency; the packaged Host runs under Node. React and React DOM are supplied by DSH.

Create a separate output directory outside the checkout, then generate the candidate:

npm pack --ignore-scripts --pack-destination /absolute/path/to/candidate-output

A dry run does not produce an installable package. Retain each candidate and its checksum; do not overwrite packages used for acceptance or rollback.

This version retains the following complete combinations from 0.1.1, rejecting mixed or unlisted patch versions. Pinning the DSH main package does not lock its transitive ~ dependencies; the actual Host resolution is checked.

Combination Cordis Loader Include Timer
Retained baseline 4.0.4 1.0.5 1.0.9 1.1.6
New patch combination 4.0.5 1.0.6 1.0.10 1.1.7

Published 0.1.0 still requires the original Cordis 4.0.4 baseline and does not include these fixes. Historical receipts use a freshly verified read-only context; expired installation references and plans never regain write authorization.

Install from npm

After 0.2.1 is published on npm, use these commands to install it. Check DSH, Node and a complete Cordis combination listed above, stop the target Web Profile Host, then install the exact version. Before publication, use the local candidate instructions below:

dsh plugin --profile skillhub-test add @astron-team/skillhub-dsh@0.2.1 --ignore-scripts
dsh --profile skillhub-test --host 127.0.0.1 --port 0 --no-open

Replace skillhub-test with the intended Web Profile; initial creation is documented below. When registryUrl is omitted, the plugin uses https://skill.xfyun.cn. To use a self-hosted instance, change, test and save the source in plugin settings. Explicitly saving an empty address disconnects. Before publication, use a local candidate; failure to fetch an unpublished npm version does not indicate a plugin loading error.

Install a local candidate

These commands target the specified DSH Web release. Use the same Profile and DSH home for installation, startup and maintenance. skillhub-test is an example Profile. Skill-write testing requires a dedicated test account/container, workspace and test skills: a separate Profile or DSH_HOME alone does not isolate the shared inventory.

Create a new Web Profile once:

dsh --profile skillhub-test --from-default-profile web --dump-config

Stop the Host using that Profile, install the tarball, and start it:

dsh plugin --profile skillhub-test add /absolute/path/to/candidate.tgz --ignore-scripts
dsh --profile skillhub-test --host 127.0.0.1 --port 0 --no-open

Open the local entry printed by the Host. It may contain an access credential; do not include it in reports, screenshots or commits. The example binds loopback. Remote access requires the environment's existing access controls.

Skip Profile creation for an existing Web Profile. The base Profile automatically created by plugin add does not supply the Web Client. If dsh is not on PATH, replace it with node /absolute/path/to/@deepseek-ai/dsh/lib/bin.js from the installed target release.

The Loader entry ID is astron-skillhub; skillhub is the Host/Remote service name. Custom patches must target the owning plugin's correct Loader ID, without changing another plugin's entry.

Configure a Registry

Open DSH Plugins → @astron-team/skillhub-dsh → SkillHub 设置.

  1. Enter the HTTP(S) instance base address in Registry 地址. A deployment subpath is allowed; credentials, query parameters, fragments and API endpoint suffixes are not.
  2. Select 测试连接 (Test connection) to test the current draft URL without saving it. The result reports public catalog or basic-search availability and elapsed time. Requests have a 10-second timeout; failures can be retried. Editing the address clears the previous result. Success does not establish download or all optional-module availability.
  3. Choose visibility for versions, security audit and reviews.
  4. Select 保存配置 (Save). After the saved confirmation, open 技能中心 and search for a public test skill.

已配置 means a nonempty address is saved, not that connectivity has been tested. An empty address disconnects the source. 重置修改 (Reset changes) restores the current Host snapshot without a network reload or save. Read-only connections cannot edit configuration. On a revision conflict, reset the draft before editing the current values.

Field Meaning
registryUrl Registry base URL; defaults to https://skill.xfyun.cn when omitted; explicit empty/whitespace disconnects without fallback; custom values are preserved
detailTabs.versions Version history visibility
detailTabs.securityAudit Security audit visibility
detailTabs.reviews Read-only review visibility

Each visibility setting accepts auto, show or hide. Auto detects actual anonymous availability. Show does not grant server access. Hide does not request the module. Anonymous audit access is currently denied; this must not be presented as a successful audit. A SaaS instance without reviews can hide that tab.

Browse, install and manage skills

  • Browse supports search, server sorting, real labels and explicit Load more, normally 12 results per page. A first-page 404/405 can fall back to bounded legacy search, with an explicit pagination/sorting limitation. A failed label filter never silently returns unfiltered results.
  • Details show fixed-version documentation and optional tabs. Select a downloadable version before confirming installation. Existing-target protection remains; skill downgrades are not supported.
  • Installed records can be filtered by source, scope and keyword. The right-side version card contains detail refresh and update checks. Upgrade confirms the complete target set; removal affects one confirmed location. Missing directories have a separate stale-record cleanup action.
  • astron_skillhub_search only searches. Result cards provide a detail action; the drawer offers explicit installation confirmation.
  • An explicit request to install a uniquely selected result does not require opening the drawer first. astron_skillhub_install verifies the search-time version and content snapshot. It accepts a selectionRef or a full coordinate, exclusively, and a user/project scope. Expired or ambiguous references are rejected without switching to current latest.

Local operations require an active conversation so that the Host can resolve trusted roots. Files are written on the Host machine, not the browser machine. There is no login, review-submission or permission-management flow.

Acceptance, completed file writes, DSH discovery and model use are distinct states. Expand 安装记录 to inspect verification, current inventory and the original operation. A historical completion does not prove that version is still installed or has been executed. After a Host restart, historical searches require explicit 重新查看详情 to revalidate the record; old references do not regain write permission.

Verify a candidate

From plugins/dsh:

node scripts/smoke-native-host.mjs --artifact /absolute/path/to/candidate.tgz --report /absolute/path/to/host-smoke-summary.json

This uses an isolated Web Profile to test installation and Host loading. It makes no model calls and does not replace UI or full skill lifecycle acceptance. Source-only browser and transaction probes are documented in the integration guide.

Check an anonymously downloadable, published test skill at an exact version:

bun run probe:registry --registry 'https://registry.example' --namespace 'demo' --slug 'test-skill' --version '1.0.0' --output /absolute/path/to/registry-report.json

Replace example values and use a new output file. The probe checks search, resolution, metadata, documentation, optional modules and archive fingerprints. Extraction is temporary; it does not install or execute skills. Directory pagination, labels, sorting and actual DSH pages require separate tests. Required failures return a nonzero exit code; audit HTTP success does not establish a validated public audit schema.

Manual checks should include configuration save/reset, search/details, user/project installation, upgrades/removal, history, themes/narrow layouts, failure retries and source changes. Model acceptance requires separate configuration and call-budget authorization.

Update, rollback and refresh

  1. Stop new operations and finish or recover accepted transactions in the original compatible environment.
  2. Retain the current tarball and stop the Host using the Profile.
  3. Install the replacement with the same plugin ... add command. Preserve the Profile, Registry, conversations and model settings.
  4. Restart the Host and open its valid entry. If the browser still shows old UI, hard-refresh it (Windows: Ctrl+Shift+R).
  5. Check Skill Center, configuration, existing records and historical queries before exercising a test skill.

Browser refresh does not reload Node modules. Dependency changes require a full Host restart; disabling/re-enabling the plugin is insufficient. Official RC.2 may leave the original browser tab blank after a same-port Host restart. Re-enter using a valid entry and preserve operation records; do not resubmit installation to recover the UI.

Rollback uses a retained, verified compatible tarball and the same procedure. Replacement between development candidates is not a promise of cross-release journal compatibility. Never delete journals or replace the package to bypass pending recovery. Plugin rollback is separate from skill-version downgrade.

Disable/re-enable the package using its switch in DSH Plugins. To remove it:

dsh plugin --profile skillhub-test remove @astron-team/skillhub-dsh

remove does not accept --ignore-scripts. Package removal does not uninstall skills or delete inventory and operation logs. For an uncertain result, query the original request; use 核验并恢复 when recovery is required.

Server synchronization and independent release

The plugin Host calls anonymous Registry HTTP APIs; local file transactions stay on the Host. SaaS does not need a new API that controls user filesystems. Define and verify contracts in open source first, then synchronize missing routes, fields, anonymous policy and tests to SaaS. Public npm 0.2.0 has verified catalog, search, documentation, version selection and fixed-version project installation against https://skill.xfyun.cn, including files/fingerprint, inventory and DSH discovery. This candidate and its public package require separate acceptance. Non-SemVer versions with no reliable ordering, including date-based versions, remain blocked from automatic upgrades; no executable upgrade action is offered. Verified first-time fixed-version installation remains available. Real model execution of SaaS skills is unverified. See the Registry contract.

The plugin uses independent dsh-v<version> tags. check-dsh-plugin.yml runs normal clean-install checks on Linux/macOS/Windows × Node 24.2.0/current Node 24, plus an isolated retained-Cordis baseline regression. release-dsh-plugin.yml is manual and defaults to candidate-only operation. Publishing requires an approved version, publishable manifest, candidate acceptance and explicit release authorization; configured environment protection rules must also be satisfied. Version updates are explicit commits; npm publication uses the dedicated workflow after release authorization.

See the release guide and release notes. OpenSpec and integration links refer to the source repository; those documents are not included in the tarball.

Open-source interaction update (unreleased)

Market cards open details and offer separate installation-management actions. Multiple installed scopes require a selected target. Conversation installs without an explicit scope use the Host input-adjacent question UI to choose current project, current user, or cancel before any installation write. Hosts without an answerer retain a pending card that opens a compact confirmation dialog. Market install actions open the same dialog without detail-page navigation. A trusted project is preselected when available, but never submitted automatically. A later explicit user scope may start a new call. Details omit complete leading frontmatter and reuse public reads for 60 seconds without bypassing write validation. The versions tab requests downloadableOnly=true, requiring the updated open-source backend; SaaS synchronization and acceptance remain separate.

After confirmation, the installation dialog expands to the right, keeping the skill, version, and scope on the left and concise real progress on the right. Narrow screens stack the sections. Progress remains indeterminate until completion; closing the dialog does not cancel a submitted installation.

Installation controls use current inventory rather than historical success receipts. An existing installation selects its scope and offers removal. Project-only scope uses the project directory; all-project scope uses the current user directory on this Host. Changing scope never installs automatically; a removed installation may be explicitly installed again.

Removal from market cards, installed rows, and detail controls opens an in-place confirmation. It shows the skill, version, selected scope, and impact. Opening only prepares a plan; confirmation executes it. Cancel and Escape never remove files, and existing expiry, identity, and local-file checks still apply.

Version selection is read-only. A verifiable newer selected version offers an explicit exact-version upgrade; equal versions do not upgrade again, older versions cannot downgrade, and unorderable versions are blocked. Confirmation lists all installed targets that the shared transaction updates. Latest-update checks remain available, with in-place confirmation, local-change protection, and recovery.