 zeyu.fz
|
491858be4a
|
docs(readme): 更新 Bailian KB dsh 插件的文档和添加运行时说明
- 增补详细的 runtime-behavior.md，说明插件的内部运行逻辑和设计取舍
- 完善 packages/bailian-kb-dsh 的 README，添加英文版及使用要求说明
- 细化配置项说明，示例及环境变量配置方式展示
- 增加 LICENSE 文件，明确 Apache 2.0 许可证
- 说明插件安装、配置、和卸载的详细步骤
- 规范 README 和文档多语言版本的同步更新及说明管理
- 说明服务发现、缓存刷新及代理行为的设计和技术细节
- 细化 Web UI 配置页功能介绍和操作指导
|
2026-08-24 18:55:28 +08:00 |
|
|
zeyu.fz
|
7bc1c49cb6
|
feat(release): 给 publish.yml 加 bailian-kb-dsh 通道
复用同一个 Publish workflow 入口（package 下拉多一项 bailian-kb-dsh），路由到
独立的 publish-kb-dsh.mjs 处理：
- 版本读自身 package.json（不广播全套 bl 版本）
- stable 打 bailian-kb-dsh-v<version> tag（与 bl 的 v<version> 错开命名空间）
- channel 临时 bump 到 0.0.0-beta-<sha>-<stamp>（形态与 bl channel 一致），
finally 还原 package.json
- 走自身的 tsc + tsdown build，无 binary，无 OSS CDN
- 复用 lib/git.mjs / lib/npm.mjs / lib/proc.mjs 三个薄工具
- 复用 workflow 入口 UI 与 setup 步骤（checkout / pnpm / node 24 / gitleaks
/ install），stable 走 environment: production Required Reviewers gate
不复用 publish-stable.mjs / publish-channel.mjs：它们的 loadAndValidatePackages
会广播 core 版本给全套锁步包并强校验一致性，把 kb-dsh 塞进去第一步就 throw。
故意分开是为了保住这个隔离。
本地 --dry-run 端到端跑通：build → 幂等性查重 → pack + publint + gitleaks →
pnpm publish --tag latest|<channel> --provenance --dry-run；channel 模式的
finally 还原后 git diff 干净。
文档：dsh-plugin.md 补发布小节 + 已知待办（publint 那条 web bundle CJS/ESM
warning）；publish.md 加 bailian-kb-dsh 定位；packages.mjs 与 AGENTS.md 的
注释同步指向新的 job 与 script 名。
|
2026-08-24 15:44:19 +08:00 |
|
|
zeyu.fz
|
a393bdc56b
|
refactor(kb-dsh): 删除已过期的 reference/*.md，参数详情交还 --help
插件不是 CLI，没有义务维护一份 bl 参数手册。已有的 8 个 reference 文件锚死在
bailian-cli 1.16.0：--description 改为必填后（1.17.1）它就在教一条必然失败的命令。
SKILL.md 备注列改为引导 agent 跑 `bl <命令> --help`（与其自身前置检查第 1 步
一致）；核心示例补 --description；命令参考段从死链改为纯指引。
docs/agents/dsh-plugin.md D 项同步更新：不带 reference/，不由生成器产出。
|
2026-08-24 15:17:55 +08:00 |
|
|
zeyu.fz
|
d24104f7dc
|
feat(kb-dsh): 接入仓库工程约定并改名为公开包 bailian-kb-dsh
包名 @ali/bailian-kb-dsh → bailian-kb-dsh（公开 npm）：package.json name +
cordis.patch.yml insert.name + tsdown PLUGIN_ID 三处同步（漏一处即 dsh 运行时崩）。
产物 lib/ → dist/（本仓 .gitignore 忽略 dist 不忽略 lib），连带 main/types/
exports/files/tsdown outDir 同步；.gitignore 补 *.tsbuildinfo。
依赖接 catalog（yaml/typescript/@types/node/vite-plus）；测试导入 vitest →
vite-plus/test（全仓统一约定，消掉唯一的 vitest 依赖漂移）。
tsconfig 拆三件套：tsconfig.json 纯类型检查覆盖 src+tests（供 oxlint 自动发现，
含 jsx/DOM），tsconfig.build.json 产出 node 半，tsconfig.web.json 隔离检查 web 半。
补齐 tests 从未被类型检查暴露的一处 partial 输入类型错误。
根 vite.config.ts 新增两条 override：web 半 no-restricted-imports 把 tsdown 构建期
的 bundle purity gate 提前到 lint 期；全包放开 _ 前缀的 no-unused-vars。
文档：新增 docs/agents/dsh-plugin.md，AGENTS.md 项目地图/版本锁步例外/分层边界/
场景索引同步，packages.mjs 注释说明故意不进发布白名单。
格式化（单引号无分号 → 双引号加分号）由 pre-commit 的 vp check --fix 自动完成，
无法单独成 commit，一并纳入。
全仓 vp check 0 error；插件 13 文件 85 测试全绿；build + typecheck 通过。
|
2026-08-24 11:02:44 +08:00 |
|