Skip to content

CROSS-REFERENCE-AND-URL-CLEANUP-PLAN.md

Latest commit

 

History

History
305 lines (228 loc) · 7 KB

CROSS-REFERENCE-AND-URL-CLEANUP-PLAN.md

File metadata and controls

305 lines (228 loc) · 7 KB

交叉引用和URL清理计划

📋 任务目标

  1. 交叉引用准确性：确保所有章节间的引用链接准确无误
  2. URL清理：移除书中的具体网址，改为描述性文字
  3. 价格时间限定：所有涉及价格和数字的地方加上时间限定（如"2026年初"）

🔍 问题分析

问题1：交叉引用不准确

风险：

  • 章节重新编号后，内部链接可能失效
  • "参见第X章"的引用可能指向错误章节
  • 导航链接（上一章/下一章）可能不正确

需要检查的位置：

  • 每章开头的"本章导航"
  • 每章结尾的"下一步"链接
  • 正文中的"参见第X章"引用
  • README.md中的章节链接

问题2：网址和价格问题

风险：

  • 网址内容可能变化（价格、政策等）
  • 价格信息可能过时
  • 缺少时间限定，读者不知道信息时效性

需要处理的内容：

  • 云服务商价格（腾讯云、阿里云、火山引擎等）
  • API服务价格（DeepSeek、Kimi、Claude等）
  • 具体网址链接
  • 数字相关的描述

📝 执行计划

阶段1：交叉引用检查（优先级：高）

1.1 检查所有章节的导航链接

需要检查的文件（18个章节）：

基础篇（5章）：

  • 01-introduction.md
  • 02-installation.md
  • 03-advanced-deployment.md
  • 04-maintenance-upgrade.md
  • 05-quick-start.md

核心功能（4章）：

  • 06-file-management.md
  • 07-knowledge-management.md
  • 08-schedule-management.md
  • 09-automation-workflow.md

进阶功能（8章）：

  • 10-skills-extension.md
  • 11-multi-platform-integration.md
  • 12-feishu-bot.md
  • 13-wework-dingtalk-qq.md
  • 14-api-integration.md
  • 15-advanced-configuration.md
  • 16-tools-policy.md
  • 17-node-management.md

实战案例（4章）：

  • 15-personal-productivity.md
  • 16-advanced-automation.md
  • 17-creative-applications.md
  • 18-solo-entrepreneur-cases.md

1.2 检查正文中的章节引用

搜索关键词：

  • "第X章"
  • "参见"
  • "详见"
  • "查看第"
  • "见第"

1.3 检查README.md

  • 目录链接
  • 快速开始链接
  • 实战案例链接

阶段2：URL清理（优先级：高）

2.1 需要清理的URL类型

云服务商：

  • 腾讯云官网
  • 阿里云官网
  • 火山引擎官网
  • Cloudflare官网

API服务商：

  • DeepSeek官网
  • Kimi官网
  • Claude官网
  • OpenAI官网

IM平台：

  • 飞书开放平台
  • 企业微信开放平台
  • 钉钉开放平台
  • QQ开放平台

其他：

  • GitHub仓库链接（保留）
  • OpenClaw官方文档（保留）
  • 技术文档链接（保留）

2.2 URL处理原则

需要移除的URL：

  • 云服务商购买页面
  • API服务商定价页面
  • 第三方服务商链接

可以保留的URL：

  • OpenClaw官方网站
  • OpenClaw官方文档
  • GitHub开源项目
  • 技术标准文档

替换方式：

# 原文
访问腾讯云官网：https://cloud.tencent.com/

# 修改为
访问腾讯云官网（搜索"腾讯云"即可找到）

阶段3：价格和数字时间限定（优先级：高）

3.1 需要添加时间限定的内容

云服务价格：

  • 腾讯云：20元/月 → 腾讯云：约20元/月（2026年初价格）
  • 火山引擎：9.9元/月 → 火山引擎：约10元/月（2026年初价格）
  • 阿里云：价格相近 → 阿里云：价格相近（2026年初）

API价格：

  • DeepSeek：5-30元/月 → DeepSeek：约5-30元/月（2026年初价格）
  • Kimi：10-50元/月 → Kimi：约10-50元/月（2026年初价格）
  • Claude：50-200元/月 → Claude：约50-200元/月（2026年初价格）

其他数字：

  • Skills数量：1800+ → 1800+（截至2026年初）
  • 效率提升数据：保持不变（来自实测）
  • 版本号：2026.2.9 → 2026.2.9（2026年2月版本）

3.2 时间限定格式

推荐格式：

  • 价格：约XX元/月（2026年初价格，实际价格以官网为准）
  • 数量：XX个（截至2026年初）
  • 版本：vX.X.X（2026年X月版本）

🔧 执行步骤

步骤1：批量搜索问题（使用grepSearch）

# 搜索所有章节引用
rg "第\d+章" docs/

# 搜索所有URL
rg "https?://" docs/

# 搜索价格相关
rg "元/月|美元|USD|CNY" docs/

步骤2：逐章修复

按照优先级顺序：

  1. 修复导航链接（最重要）
  2. 修复正文引用
  3. 清理URL
  4. 添加时间限定

步骤3：验证

  • 所有章节导航链接正确
  • 所有正文引用准确
  • 所有URL已清理或保留合理
  • 所有价格和数字已添加时间限定

📊 预估工作量

任务 文件数 预估时间
导航链接检查 18个章节 1-2小时
正文引用检查 18个章节 2-3小时
URL清理 18个章节 1-2小时
价格时间限定 5-10处 30分钟
验证测试 全部 1小时
总计 18个章节 5-8小时

🎯 优先级排序

P0（立即执行）

  1. 修复第13章的导航链接（新创建的合并章节）
  2. 修复README.md的章节链接
  3. 检查第11-17章的导航链接（重新编号的章节）

P1（尽快执行）

  1. 清理所有云服务商URL
  2. 清理所有API服务商URL
  3. 添加价格时间限定

P2（后续优化）

  1. 统一引用格式
  2. 优化描述性文字
  3. 补充说明文字

📝 修改示例

示例1：导航链接修复

原文（第13章）：

- [← 返回多平台集成概述](09-multi-platform-integration.md)
- [← 查看飞书配置](09-1-feishu-bot.md)
- [→ 查看API集成](10-api-integration.md)

修改为：

- [← 返回多平台集成概述](11-multi-platform-integration.md)
- [← 查看飞书配置](12-feishu-bot.md)
- [→ 查看API集成](14-api-integration.md)

示例2：URL清理

原文：

访问腾讯云官网：https://cloud.tencent.com/
价格：20元/月

修改为：

访问腾讯云官网（搜索"腾讯云轻量应用服务器"即可找到）
价格：约20元/月（2026年初价格，实际价格以官网为准）

示例3：价格时间限定

原文：

- 云端部署（腾讯云）：20元起
- API费用（DeepSeek）：5-30元

修改为：

- 云端部署（腾讯云）：约20元起/月（2026年初价格）
- API费用（DeepSeek）：约5-30元/月（2026年初价格）

✅ 验证清单

交叉引用验证

  • 所有"本章导航"链接正确
  • 所有"下一步"链接正确
  • 所有正文中的"第X章"引用准确
  • README.md所有链接可用

URL清理验证

  • 无云服务商购买链接
  • 无API服务商定价链接
  • 保留必要的官方文档链接
  • 所有URL都有说明文字

价格时间限定验证

  • 所有价格都有时间限定
  • 所有数字都有时间说明
  • 格式统一规范

创建时间：2026-02-17
优先级：P0（最高）
预计完成时间：1-2天