Doc-Smith 清除配置

清除 Doc-Smith 的站点授权和部署配置。

触发场景

• 用户要求清除授权 token
• 用户要求清除部署配置
• 用户说”清除配置”、”重置”、”清除授权”

存储说明

授权信息 (authTokens)：

• 存储在系统 keyring（如 macOS Keychain）中
• 服务名：aigne-doc-smith-publish
• 按站点 hostname 组织，支持多站点授权
• 如果系统不支持 keyring，回退到 ~/.aigne/doc-smith-connected.yaml

部署配置 (deploymentConfig)：

• appUrl 字段存储在 workspace 的 .aigne/doc-smith/config.yaml 中

可清除的内容

工作流程

1. 确认清除内容

根据用户输入确定要清除的内容：

情况一：用户明确指定了清除目标

例如用户说：

• “清除授权” → 清除 authTokens
• “清除部署配置” → 清除 deploymentConfig
• “清除所有配置” → 清除全部

直接执行清除操作。

情况二：用户未明确指定

使用 AskUserQuestion 工具询问用户：

请选择要清除的内容：

选项：
1. 站点授权 (authTokens) - 清除后需要重新授权才能发布
2. 部署配置 (deploymentConfig) - 清除后需要重新指定发布目标
3. 全部清除

2. 清除站点授权

如果用户选择清除授权：

Step 1: 获取已授权站点列表

node skills/doc-smith-clear/scripts/list-auth.mjs

输出格式：

{"sites": ["site1.arcblock.io", "site2.arcblock.io"]}

如果没有授权信息，返回 {"sites": []}。

Step 2: 确认要清除的站点

如果有多个站点，使用 AskUserQuestion 询问用户要清除哪些：

发现以下已授权的站点：
- site1.arcblock.io
- site2.arcblock.io

请选择要清除授权的站点：

选项：
1. site1.arcblock.io
2. site2.arcblock.io
3. 清除全部站点授权

如果只有一个站点，直接询问是否清除该站点的授权。

Step 3: 执行清除

# 清除指定站点
node skills/doc-smith-clear/scripts/clear-auth.mjs --site=site1.arcblock.io

# 清除全部站点
node skills/doc-smith-clear/scripts/clear-auth.mjs --all

3. 清除部署配置

如果用户选择清除部署配置：

Step 1: 检查配置文件是否存在

ls .aigne/doc-smith/config.yaml

如果不存在，提示用户：”当前目录没有 Doc-Smith 部署配置，无需清除。”

Step 2: 执行清除

node skills/doc-smith-clear/scripts/clear-deployment-config.mjs

4. 返回结果

显示清除结果：

• 已清除的站点授权列表（如果清除了授权）
• 是否清除了部署配置
• 后续提示（如”需要重新授权才能发布”）

脚本说明

list-auth.mjs

列出所有已授权的站点 hostname。

输出：JSON 格式，包含 sites 数组

clear-auth.mjs

清除站点授权信息。

参数：

• --site=<hostname>: 清除指定站点的授权
• --all: 清除所有站点的授权

输出：JSON 格式，包含清除结果

clear-deployment-config.mjs

清除 config.yaml 中的 appUrl 字段。

输出：JSON 格式，包含清除结果

错误处理

• 配置文件不存在：返回提示信息，不视为错误
• 无授权信息可清除：返回提示信息，不视为错误
• 无效的站点名称：提示用户正确的站点名称

注意事项

• 清除操作不可恢复，执行前确保用户已确认
• 清除站点授权后需要重新授权才能发布到该站点
• 清除部署配置后下次发布需要重新指定目标 URL
• 站点授权是全局的（存储在用户目录），不依赖于当前 workspace