目标:员工首次资料入库或上传前,Skill询问希望公开显示的姓名/昵称;按稳定员工键保存并复用,明确跳过也记住。本人提供的称呼不等于企微通讯录实名。本补丁不需要CorpID、通讯录Secret或发送者映射。
解压到站点外独立目录;在解包根目录执行。外层清单验证全部通过后再继续:
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。
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一致,首页和其他文件保持不变。本工具无网络请求。
将包内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加载生效。
转发配套《王刚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个文件;三处均先校验当前仍为本次版本,存在并发修改则停止。回退代码不会删除已保存的称呼注册表,也不触碰业务报告;旧版看板暂不投影自报称呼。