✨ docs: 把提交信息规范固化成 CONTRIBUTING.md

约定 emoji 在行首、类型关键字与作用域用英文、描述用中文,并给出 10 种
类型的 emoji 与码位表。因为行首 emoji 会让 commitlint / semantic-release
这类工具读不到类型,规范里同时记录了两种应对方式。

顺手修掉 README 里一句会误导的话:本地 link: 安装时,profile 的
node_modules 可能是与源码同 inode 的硬链接副本,只刷新页面看不到改动。
This commit is contained in:
pyh
2026-09-30 16:49:22 +08:00
parent fee7799d7e
commit b5545b0806
3 changed files with 114 additions and 0 deletions
+10
View File
@@ -76,6 +76,8 @@ https://gitea.iwake.top/dsh-plugin/session-delete.git#v2.0.0
DSH 暂不支持插件自动更新,升级就是用新标签重装一次(建议先移除旧版本)。安装或升级后:**宿主半变更需要重启 DSH**(完全退出再打开,仅关闭窗口不一定退出进程);只改浏览器半时刷新页面即可。
如果你是在本地开发这个插件(profile 里装的是 `link:` 到工作目录),**光刷新页面看不到改动**:profile 的 `node_modules` 里可能是一份与源码同 inode 的硬链接副本,需要移除再重装一次插件,让 profile 重新取一份。
## 兼容性
基于 **DeepSeek Harness 0.2.0-rc.2** 编写。DSH 仍在演进,其它版本与平台组合未逐一验证。
@@ -84,6 +86,14 @@ DSH 暂不支持插件自动更新,升级就是用新标签重装一次(建
- **宿主半**只依赖稳定的服务契约:`sessionQuery`(`traceSession` 取血缘、`listSessions` 取语料)、`sessionPersistence`(含其 JSONL 后端的 `locate()` 诊断钩子,用于定位会话目录)、`workspaceRegistry`、`connection.fetch`(注册受认证的 exact 路由),以及 spill 后端的目录规则。
- **跨半边通信**走 `connection.fetch` 注册的 `POST /api/plugin/session-delete/delete` 与 `.../orphans` 两条路由,浏览器半用文档相对路径请求(支持挂载前缀)。这是静态客户端包与宿主半通信的正规通道;`host.call` 属于动态客户端运行器,不适用于包形式的插件。
## 贡献
提交信息用「emoji + Conventional Commits + 中文描述」,规则、类型表和示例见 [CONTRIBUTING.md](CONTRIBUTING.md)。想省事可以让 git 带上模板:
```bash
git config commit.template .gitmessage
```
## License
[MIT](LICENSE)