@klarkxy/dsh-dev-index 0.2.6 → 0.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  [简体中文](README.zh-CN.md)
6
6
 
7
- Read the official DeepSeek Harness documentation without leaving DSH, and give Creator mode tools to look up the docs and check plugins before installing them.
7
+ Read the official DeepSeek Harness docs inside DSH, and give Creator mode tools to look up docs and check plugins before installing them.
8
8
 
9
9
  ## Install
10
10
 
@@ -17,15 +17,15 @@ Replace `web` with your profile name and restart the profile.
17
17
  ## Use
18
18
 
19
19
  - **Plugins → DSH Docs** shows the [official documentation site](https://deepseek-harness.github.io/deepseek-harness/) inside DSH, with a Chinese / English switch.
20
- - In Creator mode the agent gets five read-only tools: `dsh_docs_search` and `dsh_docs_fetch` to find and read official docs, `dsh_plugins_search` and `dsh_plugins_fetch` to check a plugin's npm information before installing it (search sources: catalog, npm or GitHub repositories), and `dsh_github_fetch` to inspect a GitHub plugin repository and pin its branch to an exact commit. Creator mode is also reminded to verify runtime interfaces with `cordis_inspect_list` and `cordis_inspect_query`.
20
+ - In Creator mode the agent gets five read-only tools: `dsh_docs_search` and `dsh_docs_fetch` to find and read official docs; `dsh_plugins_search` and `dsh_plugins_fetch` to check a plugin's npm information before installing it (search sources: catalog, npm or GitHub repositories); and `dsh_github_fetch` to inspect a GitHub plugin repository and pin its branch to an exact commit. Creator mode is also reminded to verify runtime interfaces with `cordis_inspect_list` and `cordis_inspect_query`.
21
21
 
22
22
  ## Limits
23
23
 
24
- - The tools only read; they never install anything. Installing stays with the DSH plugin manager.
25
- - The website follows the latest DSH release, which may differ from the version you run.
26
- - npm metadata is not proof that a plugin works with your DSH.
27
- - GitHub data comes from your local signed-in gh CLI or anonymous API access (a small hourly quota); the plugin stores no GitHub credentials. Manifest-based code search is only available when gh is signed in.
28
- - Cancelling the last request using a GitHub CLI check waits for that check to stop. Unloading the plugin waits for its active GitHub requests and CLI processes to finish.
24
+ - The tools are strictly read-only; installing plugins stays with the DSH plugin manager.
25
+ - The website tracks the latest DSH release, which may differ from the version you run.
26
+ - npm metadata describes the published package; verify host compatibility before relying on a plugin.
27
+ - GitHub data comes from your local signed-in gh CLI or anonymous API access (a small hourly quota), with zero GitHub credentials stored by the plugin. Manifest-based code search requires a signed-in gh CLI.
28
+ - Cancelling the last request using a GitHub CLI check waits for that check to stop; unloading the plugin waits for its active GitHub requests and CLI processes to finish.
29
29
 
30
30
  ## Install from GitHub
31
31
 
package/README.zh-CN.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  [English](README.md)
6
6
 
7
- 不离开 DSH 就能阅读 DeepSeek Harness 官方文档;创造模式还会获得查文档、在安装前核对插件信息的工具。
7
+ 在 DSH 内直接阅读 DeepSeek Harness 官方文档;创造模式还会获得查文档、安装前核对插件的工具。
8
8
 
9
9
  ## 安装
10
10
 
@@ -16,16 +16,16 @@ dsh plugin --profile web add @klarkxy/dsh-dev-index
16
16
 
17
17
  ## 使用
18
18
 
19
- - 「插件 → DSH 文档」会在 DSH 内显示[官方文档站](https://deepseek-harness.github.io/deepseek-harness/),可切换中文 / English。
20
- - 创造模式下,智能体获得五个只读工具:`dsh_docs_search` 和 `dsh_docs_fetch` 用于查找和阅读官方文档,`dsh_plugins_search` 和 `dsh_plugins_fetch` 用于在安装前查看插件的 npm 信息(搜索源可选 catalog、npm 或 GitHub 仓库),`dsh_github_fetch` 用于查看 GitHub 插件仓库的元数据并把分支解析成可锁定的 commit。创造模式还会被提醒用 `cordis_inspect_list` 和 `cordis_inspect_query` 核对运行时接口。
19
+ - 「插件 → DSH 文档」在 DSH 内显示[官方文档站](https://deepseek-harness.github.io/deepseek-harness/),可切换中文 / English。
20
+ - 创造模式下,智能体获得五个只读工具:`dsh_docs_search` 和 `dsh_docs_fetch` 用于查找和阅读官方文档;`dsh_plugins_search` 和 `dsh_plugins_fetch` 用于在安装前查看插件的 npm 信息(搜索源可选 catalog、npm 或 GitHub 仓库);`dsh_github_fetch` 用于查看 GitHub 插件仓库的元数据并把分支解析成可锁定的 commit。创造模式还会被提醒用 `cordis_inspect_list` 和 `cordis_inspect_query` 核对运行时接口。
21
21
 
22
22
  ## 限制
23
23
 
24
- - 这些工具只读,不会安装任何东西;安装仍由 DSH 插件管理器负责。
25
- - 官网对应最新发布的 DSH,可能与你正在使用的版本不同。
26
- - npm 元数据不能证明插件与你的 DSH 兼容。
27
- - GitHub 数据来自本机已登录的 gh CLI 或匿名 API(匿名额度有限,约每小时几十次请求);插件不保存任何 GitHub 凭据。按 `dsh.plugin.json` 清单的代码搜索只有在 gh 已登录时可用。
28
- - 取消最后一个使用 GitHub CLI 检查的请求时,会等待检查停止;卸载插件会等待正在进行的 GitHub 请求和 CLI 进程结束。
24
+ - 这些工具均为只读查询,插件安装仍由 DSH 插件管理器负责。
25
+ - 官网对应最新发布的 DSH,可能与你正在使用的版本有差异。
26
+ - npm 元数据仅反映已发布的包信息,与当前 DSH 的兼容性需另行核对。
27
+ - GitHub 数据来自本机已登录的 gh CLI 或匿名 API(匿名额度有限,约每小时几十次请求),插件本身零凭据存储。按 `dsh.plugin.json` 清单的代码搜索需先登录 gh CLI。
28
+ - 取消最后一个使用 GitHub CLI 检查的请求时,会等待该检查停止;卸载插件会等待正在进行的 GitHub 请求和 CLI 进程结束。
29
29
 
30
30
  ## 从 GitHub 安装
31
31
 
@@ -33,7 +33,7 @@ dsh plugin --profile web add @klarkxy/dsh-dev-index
33
33
  dsh plugin --profile web add "github:klarkxy/dsh-plugins#path:/plugins/dsh-dev-index"
34
34
  ```
35
35
 
36
- 从 GitHub 安装会在本机构建插件,pnpm 会先要求你允许。把下面内容加入 `$DSH_HOME/profiles/web/pnpm-workspace.yaml` 后再执行一次安装命令:
36
+ 从 GitHub 安装会在本机构建插件,pnpm 会先要求你允许。把下面内容加入 `$DSH_HOME/profiles/web/pnpm-workspace.yaml` 后,再执行一次安装命令:
37
37
 
38
38
  ```yaml
39
39
  allowBuilds:
package/client.js CHANGED
@@ -26,7 +26,7 @@ const css = `
26
26
  & *, & *::before, & *::after { box-sizing: border-box; }
27
27
  & h1, & h2, & h3, & h4, & p, & figure { margin: 0; }
28
28
  /* Keyboard focus only: pointer input keeps the native resting appearance. */
29
- & :focus-visible { outline: var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary)); outline-offset: 2px; border-radius: var(--dsw-radius-sm); }
29
+ & :focus-visible { outline: var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary)); outline-offset: 2px; }
30
30
  & [hidden] { display: none !important; }
31
31
 
32
32
  /* --- Type tiers. The same 14/22 and 12/18 steps the primitives use. --- */
@@ -36,7 +36,7 @@ const css = `
36
36
  /* --- Layout scaffolding. Each recipe also matches the root itself, because
37
37
  * this plugin's one surface carries the root class and the stack on the same
38
38
  * element; a descendant-only rule would leave it unstyled. --- */
39
- &.dsh-ui-stack, & .dsh-ui-stack { display: flex; flex-direction: column; gap: 12px; }
39
+ &.dsh-ui-page, & .dsh-ui-page { display: flex; flex-direction: column; gap: 16px; width: 100%; max-width: 760px; min-width: 0; }
40
40
  &.dsh-ui-row-wrap, & .dsh-ui-row-wrap { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; }
41
41
  &.dsh-ui-spacer, & .dsh-ui-spacer { flex: 1; min-width: 0; }
42
42
 
@@ -116,7 +116,7 @@ const css = `
116
116
 
117
117
  return h('section', {
118
118
  'aria-label': chinese ? 'DSH 文档浏览器' : 'DSH documentation browser',
119
- className: 'dsh-di-root dsh-ui-stack',
119
+ className: 'dsh-di-root dsh-ui-page',
120
120
  },
121
121
  h('style', null, css),
122
122
  h('div', { className: 'dsh-ui-row-wrap' },
package/dsh.plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "id": "@klarkxy/dsh-dev-index",
3
- "version": "0.2.6",
3
+ "version": "0.2.8",
4
4
  "main": "lib/index.js",
5
5
  "description": "DSH Docs: read the official DSH documentation in the Plugins page; Creator mode searches docs and checks plugin metadata on npm and GitHub with native tools.",
6
6
  "engines": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@klarkxy/dsh-dev-index",
3
- "version": "0.2.6",
3
+ "version": "0.2.8",
4
4
  "description": "DSH Docs: read the official DSH documentation in the Plugins page; Creator mode searches docs and checks plugin metadata on npm and GitHub with native tools.",
5
5
  "icon": "./icon.svg",
6
6
  "keywords": [
@@ -80,7 +80,7 @@
80
80
  "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2"
81
81
  },
82
82
  "dependencies": {
83
- "@klarkxy/dsh-plugin-kit": "0.4.0"
83
+ "@klarkxy/dsh-plugin-kit": "0.6.0"
84
84
  },
85
85
  "peerDependenciesMeta": {
86
86
  "@deepseek-ai/dsh-agent-preset-registry": {
@@ -113,6 +113,6 @@
113
113
  "registry": "https://registry.npmjs.org/"
114
114
  },
115
115
  "dshRelease": {
116
- "contentHash": "377d5037bbd8893b148874afb94991f8b493eeeb7b00a60c4ea19fbe4a5a1926"
116
+ "contentHash": "de442e4da0d9f144bde20dde12730db1c2e4031f30c62447eb49771cf6395fcc"
117
117
  }
118
118
  }