employee-name-patch-20261103.md 4.2 KB

运维001:看板称呼补丁

目标:员工首次资料入库或上传前,Skill询问希望公开显示的姓名/昵称;按稳定员工键保存并复用,明确跳过也记住。本人提供的称呼不等于企微通讯录实名。本补丁不需要CorpID、通讯录Secret或发送者映射。

本次范围

  • Skill更新6个已有文件:SKILL.md、references/identity.md、references/workshop-tasks.md、scripts/ksf-workshop.mjs、scripts/ksf-secure.mjs、FILES.sha256。其他5个文件保持原字节。凭据绑定、员工/Agent档案、会话索引及状态目录原样保留。
  • 后端仅更新ksfGetPublicBoard、新增ksfEmployeeDisplayName;保留Start/Save/Sync/Read四个既有函数。新增函数不是公开写接口;服务须data:read,保存还须ingest:write,并核对已有会话的服务owner/员工/Agent。
  • 静态仅更新src/core/kfs/employee.js一句来源说明。不发布首页或其他页面。
  • 运行时只有员工明确提供称呼/明确跳过后才写workshopDisplayNames及操作审计。报告、项目、会话归属和原文不迁移、不重存。

1. 核验与部署后端

解压到站点外独立目录;在解包根目录执行。外层清单验证全部通过后再继续:

sha256sum -c FILES.sha256
export KSF_PLATFORM_CONFIG=/opt/ksf-identity-private/platform.json
node server/identity/manage.mjs deploy-employee-name
node server/identity/manage.mjs deploy-employee-name --apply --receipt-dir /opt/ksf-identity-private/receipts

平台连接沿用已有0600私有文件,不打印内容。部署默认只读,apply前必须匹配现网r5公开函数SHA256 d4c7e2923a13b56b60821f02c8ca4ab472fca3664cde8fcdbf3f621e51047b23。新增函数先部署,公开读函数最后更新;任何基线差异停止,不强行覆盖。保留部署回执并独立回读两个函数哈希,其他四函数应保持不变。匿名调用新函数应AUTH_REQUIRED。

2. 发布唯一静态文件

node scripts/publish-employee-name.mjs --target-dir /opt/kangshifu-web
node scripts/publish-employee-name.mjs --target-dir /opt/kangshifu-web --apply

只允许匹配已发布r5的employee.js,未知改动停止;工具保存站点外备份并回读。GET公开URL /src/core/kfs/employee.js 核对与deploy/employee-name-static.json的raw SHA256一致,首页和其他文件保持不变。本工具无网络请求。

3. 安装目标Skill

将包内skills/ksf-workshop-runtime与scripts/install-workshop-skill.mjs按原相对目录复制到agent-node-u17879018108内的站点外目录(例如/opt/data/ksf-employee-name-patch-20261103),然后在包根目录:

node scripts/install-workshop-skill.mjs --check
node scripts/install-workshop-skill.mjs

目标固定 /opt/data/skills/ksf-workshop-runtime,filesChecked=11,changed应恰为本单列出的6项。安装器识别当前employee-read补丁基线,未知版本停止。核对目标FILES.sha256 10/10通过,credentialBindingPreserved/stateDirectoryPreserved等均true,会话索引btrFqkz0yw.json仍为1129B及SHA256 24ef684e53f2d93421da79aab3ab8382419741f8b33fa530c38a7b88311110ee。不改网关、不重启;下一次Skill加载生效。

4. 真实消息验收

转发配套《王刚001-看板称呼最小验收》,由当前员工本人回答想用的称呼。运维不代选测试用户称呼。首次只保存/回读称呼并检查公开看板即可,不需要新建会话或重传报告。真实消息与生产浏览器验收前,仍记browserVerified=false,不声明已上线生效。

回退

node server/identity/manage.mjs rollback --receipt /绝对路径/本次部署回执.json
node server/identity/manage.mjs rollback --receipt /绝对路径/本次部署回执.json --apply
node scripts/publish-employee-name.mjs --target-dir /opt/kangshifu-web --rollback /绝对路径/静态备份.json
node scripts/publish-employee-name.mjs --target-dir /opt/kangshifu-web --rollback /绝对路径/静态备份.json --apply

Skill从安装回执backup恢复changed的6个文件;三处均先校验当前仍为本次版本,存在并发修改则停止。回退代码不会删除已保存的称呼注册表,也不触碰业务报告;旧版看板暂不投影自报称呼。