@klarkxy/dsh-dev-index 0.2.6 → 0.2.7
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 +4 -4
- package/README.zh-CN.md +7 -7
- package/client.js +3 -3
- package/dsh.plugin.json +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
[简体中文](README.zh-CN.md)
|
|
6
6
|
|
|
7
|
-
Read the official DeepSeek Harness
|
|
7
|
+
Read the official DeepSeek Harness docs without leaving 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
|
|
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
24
|
- The tools only read; they never install anything. Installing stays with the DSH plugin manager.
|
|
25
25
|
- The website follows the latest DSH release, which may differ from the version you run.
|
|
26
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
|
|
28
|
-
- Cancelling the last request using a GitHub CLI check waits for that check to stop
|
|
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 works only 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.
|
|
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
|
|
20
|
-
- 创造模式下，智能体获得五个只读工具：`dsh_docs_search` 和 `dsh_docs_fetch`
|
|
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
|
-
-
|
|
24
|
+
- 这些工具只读，不安装任何东西；安装仍由 DSH 插件管理器负责。
|
|
25
25
|
- 官网对应最新发布的 DSH，可能与你正在使用的版本不同。
|
|
26
26
|
- npm 元数据不能证明插件与你的 DSH 兼容。
|
|
27
|
-
- GitHub 数据来自本机已登录的 gh CLI 或匿名 API（匿名额度有限，约每小时几十次请求）；插件不保存任何 GitHub 凭据。按 `dsh.plugin.json`
|
|
28
|
-
- 取消最后一个使用 GitHub CLI
|
|
27
|
+
- GitHub 数据来自本机已登录的 gh CLI 或匿名 API（匿名额度有限，约每小时几十次请求）；插件不保存任何 GitHub 凭据。按 `dsh.plugin.json` 清单的代码搜索仅在 gh 已登录时可用。
|
|
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;
|
|
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-
|
|
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-
|
|
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.
|
|
3
|
+
"version": "0.2.7",
|
|
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.
|
|
3
|
+
"version": "0.2.7",
|
|
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.
|
|
83
|
+
"@klarkxy/dsh-plugin-kit": "0.5.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": "
|
|
116
|
+
"contentHash": "a2daf4a6e10ea93df0733a844d8e8eee52a8d946908b0efec797b1dec2467896"
|
|
117
117
|
}
|
|
118
118
|
}
|