版本与发布
本项目从 v1.1.0 起启用版本号管理:package.json 的 version 是唯一真相源,CHANGELOG.md 记录每个版本的变化,打 tag 后由 GitHub Actions 校验一致性并发布 Release。
版本号规则
遵循语义化版本:
| 变更类型 | 升级位 | 例子 |
|---|---|---|
| 不兼容的改动(删除工具、改参数含义、改存储结构) | major | 1.1.0 → 2.0.0 |
| 向下兼容的新功能(新 Tab、新工具、新操作) | minor | 1.1.0 → 1.2.0 |
| 向下兼容的修复(样式、文案、数据源回退) | patch | 1.1.0 → 1.1.1 |
版本号出现在三处,且都从同一份 package.json 读取,不存在手写漂移:
- 面板头部右侧的
vX.Y.Z徽标(来自service.status) GET /api?op=version与GET /health- 独立服务启动日志一行
[HiTrading] vX.Y.Z 本地 HTTP 服务已启动
升级流程
# 1) 先把本次改动写进 CHANGELOG.md 的 [Unreleased] 段落# 2) 升版本(会把 Unreleased 定版为带日期的版本段落,并维护 compare 链接)npm run bump -- patch # 或 minor / major / 1.2.3
# 3) 脚本会提示下面这几条,逐条执行git add package.json CHANGELOG.mdgit commit -m "chore(release): v1.2.0"git tag -a v1.2.0 -m "v1.2.0"git push origin main --follow-tags只校验不修改(CI 与本地都可以跑):
npm run check:version校验内容:version 必须是 x.y.z;CHANGELOG.md 里必须有对应版本的段落;版本号不能低于 CHANGELOG 已发布的最高版本;发布流水线里 tag 必须等于 package.json 的版本(避免 tag 打 v1.2.0 却发布 1.1.0 的包)。
打上 v*.*.* 标签后有两个工作流同时触发:
.github/workflows/release.yml:语法检查 → 版本一致性校验 →npm pack→ 生成 Release 说明 → 上传hitrading.tgz创建 GitHub Release。.github/workflows/npm-publish.yml:版本/清单校验 →npm pack --dry-run→ 若该版本尚未发布则npm publish。免 token,使用 npm Trusted Publishing(OIDC),一次性配置见第 2 步。
发布到 dshmarket 市场
dshmarket 是 DeepSeek Harness 内的插件市场。它的目录数据来自 awesome-dsh-plugin,每天由 CI 刷新,同时对外提供一份 format-1 索引(https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json)。所以「上架市场」等于「让仓库被这个目录收录」,不需要单独提交表单。
第 0 步:自检
收录有硬性要求,先确认仓库满足:
package.json声明了dsh.bundle.patch(只有dsh.client会被拒),且同目录有cordis.patch.yml- 仓库里有真实可运行的代码(不是占位或纯 README)
- 仓库至少 1 天历史(CI 自动检查仓库创建时间,不看提交数)
- 仓库添加了
dsh-plugin这个 GitHub topic - 描述客观准确:里面提到的数字、工具名、API 名会与代码核对
本仓库可以一条命令自查:
npm run check:manifest第 1 步:加 GitHub topic
gh api -X PUT repos/atorber/dsh-hitrading/topics \ -H "Accept: application/vnd.github+json" \ -f names[]=dsh-plugin -f names[]=cordis -f names[]=a-share第 2 步:发布到 npm(推荐,非必须)
发布 npm 后安装时跳过构建审批(allowBuilds),市场也会优先下载 npm tarball 而不是整个 GitHub 仓库。
本项目已配置 .github/workflows/npm-publish.yml:打 v*.*.* 标签时自动发布,与 GitHub Release 同步。发布使用 npm Trusted Publishing(OIDC),无需任何 token / Secret,只需在 npmjs.com 一次性登记这个工作流:
- 打开 npmjs.com → @atorber/hitrading → Settings → Trusted publishing,点 Add trusted publisher,选择 GitHub Actions。
- 填写(必须与仓库/工作流完全一致):
- Organization or user:
atorber - Repository:
dsh-hitrading - Workflow filename:
npm-publish.yml(只填文件名,不含.github/workflows/路径) - Environment: 留空
- Allowed actions: 勾选
npm publish(新登记的默认只允许npm stage publish,不勾选则本工作流的直接发布会被拒绝)
- Organization or user:
- 保存。首次登记的配置需在 2 天内完成一次成功发布才会正式绑定,否则会过期需重新添加。
之后每次推送 tag,流水线会:校验版本一致性与清单 → npm pack --dry-run 检查产物 → 若该版本尚未发布则 npm publish --access public。npm CLI 自动检测 GitHub Actions 的 OIDC 环境,用短时凭证换发布令牌;provenance 由 npm 自动生成,无需 --provenance 参数。已在 registry 上的版本会跳过,重复触发不会报错。
也可以在 Actions 页面手动 workflow_dispatch 补发某个已有 tag 的版本。
如果你更想在本地手动发布,也可以:
npm login # 需要 npmjs.com 账号npm config set registry https://registry.npmjs.orgnpm publish --access public # publishConfig.access=public不发布 npm 也可以:把 npm pack 出来的 tarball 挂到 GitHub Release 上,然后在收录条目里加 tarball: 指过去(必须是 GitHub Release 托管的 https .tgz,且 latest/download/ 配带版本号的文件名会腐烂,建议 pin tag)。
第 3 步:准备仓库内的市场材料
已经放在仓库根目录,随版本一起维护,不需要额外操作:
assets/icon-180.png— 180×180 方形栅格图(市场里约 96px 显示,禁用 SVG 与第三方图床)screenshots.json— 1–8 张截图,相对路径,次日构建时自动拾取market/atorber__dsh-hitrading.yml— 待提交给目录仓库的条目文件
第 4 步:向目录仓库提 PR
在 awesome-dsh-plugin/awesome-dsh-plugin 提一个 PR,只新增一个文件 data/plugins/atorber__dsh-hitrading.yml,内容就是本仓库 market/ 下那份:
url: https://github.com/atorber/dsh-hitradingname: atorber/dsh-hitradingcategory: toolsdescription: en: A-share market assistant with 13 agent tools and a 15-tab console ... zh: A股投资助手:14 个 Agent 工具 + 16 个 Tab 控制台 ...icon: https://raw.githubusercontent.com/atorber/dsh-hitrading/main/assets/icon-180.png规则要点:
- 文件名固定为
<owner>__<repo>.yml,url必须与仓库地址完全一致 - 只有
description.en是必填,句号结尾;描述里出现:必须给整行加引号 category取值见目录的分类表(tools/ui/workflow/docs/skill等)- 一个 PR 最多 3 条
- 不要手改
README.md,它是自动生成的
CI 会依次检查条目数、dsh.bundle、仓库年龄,然后跑 awesome-lint 与站点构建;绿了之后由维护者人工读代码核对描述。如果被打了 held: author 标签,改动推到同一分支并留一条评论即可,不必重开 PR。
第 5 步:等待生效
目录合并后网站自动重建,次日构建会拾取截图与图标。用户在 DeepSeek Harness 里即可通过市场搜索到本插件:
dsh plugin --profile web add dshmarket # 装市场客户端(dsh 0.2.1+)重启 dsh web 后在 Plugins 页使用 Plugin Market / Discover。也可以在 Plugins → Discover → Index sources 里直接添加索引源:
https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json备选:不依赖市场的安装方式
即使不收录,也可以直接用 GitHub 地址安装:
对 DeepSeek Harness 说「帮我安装 GitHub 插件 https://github.com/atorber/dsh-hitrading」或本地软链开发(见安装)。