WordPress插件归档需在主文件头添加Archive Date等静态字段、用ARCHIVE.md按倒序记录变更、并通过update_option将归档状态存入数据库以实现可追溯与复用。
WordPress插件笔记需要归档，是为了让开发过程中的调试记录、配置变更、版本适配说明等可追溯、可复用，避免每次升级或迁移时重新摸索。
在插件主文件中嵌入归档元数据
打开你的插件主PHP文件（如 my-plugin.php），在插件头注释块内添加归档相关字段。
在 /* 和 */ 之间，紧接在 Plugin Name: 后面，新增一行：Archive Date: 2026-08-26。
这行必须手写，不能靠函数动态生成——因为插件头是静态解析的，【WordPress只读取注释块中的固定字符串，不执行任何PHP代码】。
如果该插件已上线且多人协作，建议同时加 Archive Notes: 初版归档，含WP 6.7兼容性验证记录，方便后续回溯。
用独立Markdown文件管理详细归档笔记
在插件根目录下新建一个文件：ARCHIVE.md。
文件首行写标题：`# 插件归档日志`，第二行空行，第三行开始按时间倒序记录。
每条归档条目以 `## YYYY-MM-DD` 开头，下面用无序列表写具体事项，例如：
中文敏感词/违禁词检测与内容合规性检查工具。支持对小红书（Xiaohongshu）、Douyin（抖音）、WeChat（微信）、Weibo（微博）、Bilibili（哔哩哔哩）、Zhihu（知乎）、Taobao（淘宝）、JD.com（京东）等主流平台的禁用词、限用词及高风险词进行文本扫描与合规性分析。
- 修改 `wp_easyarchives()` 调用方式，适配 PHP 8.3 的 strict_types 模式
- 将缓存刷新逻辑从 `save_post` 移至 `transition_post_status`，避免草稿触发误刷
注意：不要把敏感信息（如API密钥、数据库密码）写进这个文件，【该文件会被Git提交并可能公开】。
通过WordPress选项表持久化归档状态
方法一：用 update_option() 存储结构化归档标记
在插件激活钩子中加入：
register_activation_hook( __FILE__, 'my_plugin_activate' );<br>function my_plugin_activate() {<br> update_option( 'my_plugin_archive_version', '1.2.5' );<br> update_option( 'my_plugin_last_archived', current_time('mysql') );<br>}
方法二：为每次重要变更创建带时间戳的选项键
例如发布新功能后执行：update_option( 'my_plugin_archive_20260826_fix_cache', 'done' );，这样可在后台直接查某次归档是否生效。
这一步做完，插件笔记的归档就已写入数据库，下次更新前可先比对 my_plugin_last_archived 时间戳。
