dsh-exa-tools 0.1.0 → 0.1.1
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.en-US.md +5 -14
- package/README.md +5 -14
- package/docs/TECHNICAL.en-US.md +11 -0
- package/docs/TECHNICAL.md +11 -0
- package/package.json +2 -2
package/README.en-US.md
CHANGED
|
@@ -1,4 +1,8 @@
|
|
|
1
|
-
|
|
1
|
+
<h1 align="center">
|
|
2
|
+
<img src="icon.svg" width="64" height="64" alt="">
|
|
3
|
+
<br>
|
|
4
|
+
dsh-exa-tools
|
|
5
|
+
</h1>
|
|
2
6
|
|
|
3
7
|
Exa web search and fetch tools for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). Adds two tools to every agent in the profile:
|
|
4
8
|
|
|
@@ -131,19 +135,6 @@ See [docs/TECHNICAL.en-US.md](docs/TECHNICAL.en-US.md) for the architecture: bun
|
|
|
131
135
|
- The API key is stored in the profile patch (plain text on disk); DSH's credentials service is not used in this version.
|
|
132
136
|
- No `EXA_API_KEY` environment fallback yet — the key comes from the plugin page or the profile patch.
|
|
133
137
|
|
|
134
|
-
## Publishing
|
|
135
|
-
|
|
136
|
-
Pushing a `v*` version tag releases automatically: GitHub Actions verifies the tag matches `package.json`, installs dependencies, runs the client tests, packs the tarball, and creates a GitHub Release with the asset attached.
|
|
137
|
-
|
|
138
|
-
```sh
|
|
139
|
-
# 1. Bump version in package.json, commit and push
|
|
140
|
-
git tag v0.1.1
|
|
141
|
-
git push origin v0.1.1
|
|
142
|
-
# 2. Actions creates the Release (with tgz); also publishes to npm when NPM_TOKEN is set
|
|
143
|
-
```
|
|
144
|
-
|
|
145
|
-
One-time setup for npm publishing: add an `NPM_TOKEN` secret (an npmjs.com Automation token) under **Settings → Secrets and variables → Actions**. Without it the workflow skips npm and only creates the Release.
|
|
146
|
-
|
|
147
138
|
## License
|
|
148
139
|
|
|
149
140
|
[MIT](LICENSE)
|
package/README.md
CHANGED
|
@@ -1,4 +1,8 @@
|
|
|
1
|
-
|
|
1
|
+
<h1 align="center">
|
|
2
|
+
<img src="icon.svg" width="64" height="64" alt="">
|
|
3
|
+
<br>
|
|
4
|
+
dsh-exa-tools
|
|
5
|
+
</h1>
|
|
2
6
|
|
|
3
7
|
给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)接入 Exa 搜索的插件,为 profile 中的每个 agent 增加两个工具:
|
|
4
8
|
|
|
@@ -131,19 +135,6 @@ pnpm test:client # 设置页 / 导航图标 / 卡片注册
|
|
|
131
135
|
- API Key 存于 profile patch(磁盘明文);本版本未使用 DSH 的 credentials 服务。
|
|
132
136
|
- 暂不支持 `EXA_API_KEY` 环境变量回退——Key 来自插件页面或 profile patch。
|
|
133
137
|
|
|
134
|
-
## 发布
|
|
135
|
-
|
|
136
|
-
推送 `v*` 版本标签即自动发布:GitHub Actions 会校验标签与 `package.json` 版本一致、安装依赖、跑客户端测试、打包 tgz,并创建带附件的 GitHub Release。
|
|
137
|
-
|
|
138
|
-
```sh
|
|
139
|
-
# 1. 修改 package.json 的 version,提交并推送
|
|
140
|
-
git tag v0.1.1
|
|
141
|
-
git push origin v0.1.1
|
|
142
|
-
# 2. Actions 自动建 Release(附 tgz);配置了 NPM_TOKEN 时同步发布 npm
|
|
143
|
-
```
|
|
144
|
-
|
|
145
|
-
npm 自动发布的一次性准备:仓库 **Settings → Secrets and variables → Actions** 新增 `NPM_TOKEN`(npmjs.com 的 Automation token)。未配置时 workflow 自动跳过 npm 发布,只建 Release。
|
|
146
|
-
|
|
147
138
|
## 许可证
|
|
148
139
|
|
|
149
140
|
[MIT](LICENSE)
|
package/docs/TECHNICAL.en-US.md
CHANGED
|
@@ -218,3 +218,14 @@ A local-directory install **links** the checkout: the profile's `node_modules/ds
|
|
|
218
218
|
## 11. Release pipeline
|
|
219
219
|
|
|
220
220
|
`.github/workflows/release.yml`, triggered by pushing a `v*` tag: verify the tag matches the `package.json` version → `pnpm install --frozen-lockfile` → client tests (`test:client`, offline and deterministic; `smoke` / `test:apply` hit the live Exa endpoints and stay local dev tools) → `pnpm pack` → `softprops/action-gh-release` creates the Release with the tarball attached and generated notes → `npm publish --access public` when the repository's `NPM_TOKEN` secret is set (skipped otherwise). The workflow needs `contents: write`.
|
|
221
|
+
|
|
222
|
+
Cutting a release:
|
|
223
|
+
|
|
224
|
+
```sh
|
|
225
|
+
# 1. Bump version in package.json, commit and push
|
|
226
|
+
git tag v0.1.1
|
|
227
|
+
git push origin v0.1.1
|
|
228
|
+
# 2. Actions creates the Release (with tgz); also publishes to npm when NPM_TOKEN is set
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
One-time setup for npm publishing: add an `NPM_TOKEN` secret (an npmjs.com Automation token, which bypasses 2FA) under **Settings → Secrets and variables → Actions**. Without it the workflow skips npm and only creates the Release; you can also publish manually with `npm publish --access public` (interactive authorization if the account has 2FA). A version cannot be published twice: if you published manually, pushing the same tag again after configuring the token fails at the npm step.
|
package/docs/TECHNICAL.md
CHANGED
|
@@ -217,3 +217,14 @@ ctx.configForms.whileServed(['exa-tools'], () =>
|
|
|
217
217
|
## 11. 发布流水线
|
|
218
218
|
|
|
219
219
|
`.github/workflows/release.yml`,推送 `v*` 标签触发:校验标签与 `package.json` 版本一致 → `pnpm install --frozen-lockfile` → 客户端测试(`test:client`,离线且确定;`smoke` / `test:apply` 访问真实 Exa 端点,保留为本地开发工具)→ `pnpm pack` → `softprops/action-gh-release` 创建带 tgz 附件的 Release(自动生成 release notes)→ 仓库配置了 `NPM_TOKEN` secret 时执行 `npm publish --access public`(未配置则跳过)。workflow 需要 `contents: write` 权限。
|
|
220
|
+
|
|
221
|
+
发版步骤:
|
|
222
|
+
|
|
223
|
+
```sh
|
|
224
|
+
# 1. 修改 package.json 的 version,提交并推送
|
|
225
|
+
git tag v0.1.1
|
|
226
|
+
git push origin v0.1.1
|
|
227
|
+
# 2. Actions 自动建 Release(附 tgz);配置了 NPM_TOKEN 时同步发布 npm
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
npm 自动发布的一次性准备:仓库 **Settings → Secrets and variables → Actions** 新增 `NPM_TOKEN`(npmjs.com 的 Automation token,不受 2FA 限制)。未配置时 workflow 跳过 npm 发布,只建 Release;也可以本地手动 `npm publish --access public`(账号开启 2FA 时需交互授权)。注意同一版本不可重复发布:手动发过的版本,配置 token 后再推同名标签会在 npm 步骤失败。
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-exa-tools",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "无需API Key给DSH接入Exa的免费搜索和Fetch工具,也可以填入API Key获得更好体验",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"exports": {
|