Typecho Draft Publisher 技能使用说明

安装技能

插件内置的技能目录是 usr/plugins/DraftPublisher/skills/typecho-draft-publisher。将整个目录复制到 Codex 的用户技能目录；不要复制到项目仓库中以免意外提交本机配置。

在 Windows PowerShell 中：

Copy-Item -Recurse -Force .\usr\plugins\DraftPublisher\skills\typecho-draft-publisher "$env:USERPROFILE\.codex\skills\typecho-draft-publisher"

重启 Codex 或开启新的会话后，可在提示中使用 $typecho-draft-publisher。技能包包含一个只依赖 Python 标准库的本地发布脚本。

配置本机凭据

不要把 Token 写进项目仓库或技能源文件。技能安装后，在用户技能目录中将 .env.example 复制为 .env，然后仅编辑该本地 .env：

Copy-Item "$env:USERPROFILE\.codex\skills\typecho-draft-publisher\.env.example" "$env:USERPROFILE\.codex\skills\typecho-draft-publisher\.env"

.env 只读取 TYPECHO_DRAFT_URL 与 TYPECHO_DRAFT_TOKEN，且只从技能安装目录读取，不会扫描项目目录。现有环境变量优先于 .env，因此仍可用于 CI 或系统凭据管理器。

.env 内容示例：

TYPECHO_DRAFT_URL=http://127.0.0.1/typecho/index.php/action/draftpublisher
TYPECHO_DRAFT_TOKEN=在插件配置中复制的Bearer Token

远程站点必须使用 HTTPS：

TYPECHO_DRAFT_URL=https://blog.example.com/index.php/action/draftpublisher

可用系统的安全凭据管理工具或 CI 的 Secret 变量代替本地 .env。不要使用 setx 后把环境或配置文件提交到项目中，也不要在 AI 提示词、文章 Front Matter、日志或 shell 历史中直接记录 Token。发布脚本不提供命令行 Token 参数。

发布方式

先将文章写入 Markdown 文件，例如 article.md。检查将要发送的请求而不发布：

python "$env:USERPROFILE\.codex\skills\typecho-draft-publisher\scripts\publish_draft.py" `
  --file .\article.md --title '文章标题' --tags 'Typecho,AI' --categories '1' --dry-run

实际创建草稿：

python "$env:USERPROFILE\.codex\skills\typecho-draft-publisher\scripts\publish_draft.py" `
  --file .\article.md --title '文章标题' --tags 'Typecho,AI' --categories '1'

脚本每次调用自动生成 Idempotency-Key。若命令因网络问题而无法确定结果，使用输出中的 --idempotency-key 值再次执行；不要立即用新 Key 重发。成功后登录 Typecho 后台，在草稿中审核、补充分类或封面，然后由人工发布。

Codex 提示示例

使用 $typecho-draft-publisher 将当前目录的 article.md 作为“Typecho 接口草稿”发布到本地 Typecho 草稿箱。先核对文章内容，发布前执行 dry-run，创建后只报告 cid 和响应状态，不要输出 Token。

技能只负责通过已配置的本地脚本提交草稿。它不应自行开启插件的远程模式、修改 CIDR/TLS 配置、生成或轮换 Token，也不应发布已创建的草稿。

测试用例：

技能下载地址：skills.zip