@klarkxy/dsh-dev-index 0.2.1 → 0.2.2
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 +3 -22
- package/README.zh-CN.md +4 -23
- package/dsh.plugin.json +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
# DSH Docs
|
|
2
2
|
|
|
3
3
|
<!-- release-state-note -->
|
|
4
|
-
The [repository registry](../../README.md#plugin-lifecycle) tracks Draft → Testing → Published, moving forward only. Fixes, testing and version updates keep published packages Published; each update still passes release checks. First publication explicitly selects Testing packages and records Published only after npm archive verification. See the [release guide](../../RELEASING.md).
|
|
5
4
|
|
|
6
5
|
[简体中文](README.zh-CN.md) | [English](README.md)
|
|
7
6
|
|
|
8
|
-
Runtime: Node `^22.19.0 || >=24.0.0` and DSH `>=0.1.7-rc.2`. The documentation reader is a DSH Web client; the four read-only tools and the Creator-mode guidance run in the host.
|
|
7
|
+
Runtime: Node `^22.19.0 || >=24.0.0` (26 verified) and DSH `>=0.1.7-rc.2`. The documentation reader is a DSH Web client; the four read-only tools and the Creator-mode guidance run in the host.
|
|
9
8
|
|
|
10
9
|
Read the official DSH documentation without leaving DSH. The Plugins page embeds the official docs, and Creator mode also gets four native read-only tools: `dsh_docs_search` and `dsh_docs_fetch` to look up documentation, `dsh_plugins_search` and `dsh_plugins_fetch` to check a plugin's npm metadata. Installing and removing plugins stays with the official plugin manager; this plugin never installs anything.
|
|
11
10
|
|
|
@@ -54,7 +53,7 @@ The published npm package includes the built `lib/` files.
|
|
|
54
53
|
dsh plugin --profile web add "github:klarkxy/dsh-plugins#path:/plugins/dsh-dev-index"
|
|
55
54
|
```
|
|
56
55
|
|
|
57
|
-
A Git install runs `prepare`, which builds `lib/`. pnpm blocks that script until the profile allowlists it
|
|
56
|
+
A Git install runs `prepare`, which builds `lib/`. pnpm blocks that script until the profile allowlists it; the DSH CLI prints the exact key to add under `allowBuilds` in `$DSH_HOME/profiles/web/pnpm-workspace.yaml`:
|
|
58
57
|
|
|
59
58
|
```yaml
|
|
60
59
|
allowBuilds:
|
|
@@ -63,25 +62,7 @@ allowBuilds:
|
|
|
63
62
|
|
|
64
63
|
Run the add command again: that allowance executes this package's build on your machine. Pin a commit when the plugin source must not move.
|
|
65
64
|
|
|
66
|
-
Peer ranges on `@deepseek-ai/dsh-system-prompt` and `@deepseek-ai/dsh-agent-preset-registry` are checked against the running `dsh` version.
|
|
67
|
-
|
|
68
|
-
## Install from this checkout
|
|
69
|
-
|
|
70
|
-
```bash
|
|
71
|
-
pnpm install
|
|
72
|
-
pnpm --filter @klarkxy/dsh-dev-index build
|
|
73
|
-
dsh plugin --profile web add ./plugins/dsh-dev-index
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
Restart the profile, or let HMR apply the new bundle. Then:
|
|
77
|
-
|
|
78
|
-
```bash
|
|
79
|
-
dsh --profile web --dump-config
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
The composition should contain a `dsh-dev-index` row. Start a new Creator-mode session to pick up the documentation guidance automatically.
|
|
83
|
-
|
|
84
|
-
There is no configuration: the patch inserts the plugin and sets no keys.
|
|
65
|
+
Peer ranges on `@deepseek-ai/dsh-system-prompt` and `@deepseek-ai/dsh-agent-preset-registry` are checked against the running `dsh` version. The loader does not enforce `engines.dsh`.
|
|
85
66
|
|
|
86
67
|
## License
|
|
87
68
|
|
package/README.zh-CN.md
CHANGED
|
@@ -1,11 +1,10 @@
|
|
|
1
|
-
# DSH 文档
|
|
1
|
+
# DSH 文档
|
|
2
2
|
|
|
3
3
|
<!-- release-state-note -->
|
|
4
|
-
插件生命周期见[仓库状态清单](../../README.zh-CN.md#插件生命周期):草稿 → 测试中 → 已发布,只向前推进。已发布插件的修复、测试和升版保持已发布;每次更新仍须通过发布检查。首次发布须明确选择测试中的包,并在 npm 归档验证成功后登记。详见[发布规则](../../RELEASING.zh-CN.md)。
|
|
5
4
|
|
|
6
5
|
[简体中文](README.zh-CN.md) | [English](README.md)
|
|
7
6
|
|
|
8
|
-
**运行环境**:Node `^22.19.0 || >=24.0.0
|
|
7
|
+
**运行环境**:Node `^22.19.0 || >=24.0.0`(已验证 26)、DSH `>=0.1.7-rc.2`。文档阅读器是 DSH Web 客户端;四个只读工具和创造模式指引运行在宿主里。
|
|
9
8
|
|
|
10
9
|
不离开 DSH 就能读到官方文档:插件页内嵌官方文档站,创造模式另外拿到四个原生只读工具——`dsh_docs_search` 和 `dsh_docs_fetch` 检索文档,`dsh_plugins_search` 和 `dsh_plugins_fetch` 查核插件的 npm 元数据。安装和卸载插件始终由官方插件管理器负责,本插件不安装任何东西。
|
|
11
10
|
|
|
@@ -54,7 +53,7 @@ npm 包包含已构建的 `lib/`。
|
|
|
54
53
|
dsh plugin --profile web add "github:klarkxy/dsh-plugins#path:/plugins/dsh-dev-index"
|
|
55
54
|
```
|
|
56
55
|
|
|
57
|
-
Git 安装会运行 `prepare` 来构建 `lib/`。pnpm 在允许之前会拦住这个脚本,DSH
|
|
56
|
+
Git 安装会运行 `prepare` 来构建 `lib/`。pnpm 在允许之前会拦住这个脚本,DSH CLI 会打印出要写进 `$DSH_HOME/profiles/web/pnpm-workspace.yaml` 里 `allowBuilds` 的确切包名:
|
|
58
57
|
|
|
59
58
|
```yaml
|
|
60
59
|
allowBuilds:
|
|
@@ -63,25 +62,7 @@ allowBuilds:
|
|
|
63
62
|
|
|
64
63
|
然后再执行一次 add:该许可会在本机执行这个包的构建。需要固定插件来源时请钉住 commit。
|
|
65
64
|
|
|
66
|
-
`@deepseek-ai/dsh-system-prompt` 和 `@deepseek-ai/dsh-agent-preset-registry` 的 peer 范围会对照正在运行的 `dsh`
|
|
67
|
-
|
|
68
|
-
## 从本仓库安装
|
|
69
|
-
|
|
70
|
-
```bash
|
|
71
|
-
pnpm install
|
|
72
|
-
pnpm --filter @klarkxy/dsh-dev-index build
|
|
73
|
-
dsh plugin --profile web add ./plugins/dsh-dev-index
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
安装后重启该 profile,或让 HMR 应用新 bundle。然后:
|
|
77
|
-
|
|
78
|
-
```bash
|
|
79
|
-
dsh --profile web --dump-config
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
组合结果里应有 `dsh-dev-index` 这一行。新建创造模式会话即可自动收到文档指引。
|
|
83
|
-
|
|
84
|
-
没有配置项:补丁只插入插件,不设置任何键。
|
|
65
|
+
`@deepseek-ai/dsh-system-prompt` 和 `@deepseek-ai/dsh-agent-preset-registry` 的 peer 范围会对照正在运行的 `dsh` 版本检查。加载器不强制 `engines.dsh`。
|
|
85
66
|
|
|
86
67
|
## 许可证
|
|
87
68
|
|
package/dsh.plugin.json
CHANGED
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.2",
|
|
4
4
|
"description": "DSH Docs: read the official DSH documentation in the Plugins page; Creator mode searches docs and checks plugin npm metadata 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.3.
|
|
83
|
+
"@klarkxy/dsh-plugin-kit": "0.3.1"
|
|
84
84
|
},
|
|
85
85
|
"peerDependenciesMeta": {
|
|
86
86
|
"@deepseek-ai/dsh-agent-preset-registry": {
|
|
@@ -107,6 +107,6 @@
|
|
|
107
107
|
"registry": "https://registry.npmjs.org/"
|
|
108
108
|
},
|
|
109
109
|
"dshRelease": {
|
|
110
|
-
"contentHash": "
|
|
110
|
+
"contentHash": "fda890d3919ae02dff3dcb2f4d33894921a5e36885e019a50ed8705e48124202"
|
|
111
111
|
}
|
|
112
112
|
}
|