til

核心用法

til 是一款专为开发者设计的 OpenTIL 平台 CLI 客户端，提供三种知识捕获模式：

1. 显式捕获 (/til <content>)：将用户输入的技术要点直接生成规范化的 TIL 条目，支持自动标题生成、标签推断和多语言检测，内容经过 AI 润色后直接发布或保存为草稿。

2. 对话提取 (/til)：智能扫描当前会话历史，识别可记录的技术洞察（如调试突破、语言特性、性能优化技巧），支持多候选展示供用户选择，确保不遗漏任何"Aha Moment"。

3. 自动检测 (Auto-detection)：在协助用户解决问题的过程中，主动识别值得记录的知识点并适时建议捕获，实现知识管理的零摩擦体验。

此外，该技能提供完整的内容生命周期管理，包括列表查看、发布/下线、AI 辅助编辑、批量捕获、标签分类管理及本地草稿同步等功能，全部通过直观的子命令完成。

显著优点

• 无缝 CLI 集成：无需离开终端即可完成从记录到发布的全流程，支持环境变量和配置文件双模式认证，适配个人开发者和团队协作场景。

• 智能内容生成：自动检测内容语言、生成 SEO 友好的 URL slug、撰写摘要，并基于技术领域自动推荐标签（如 go、postgresql、react），大幅降低内容整理负担。

• 多账户与离线支持：支持通过 Profile 机制管理多个 OpenTIL 账户（个人/工作），且在 API 不可用时自动降级到 ~/.til/drafts/ 本地存储，确保数据永不丢失。

• 规范的内容标准：强制要求内容去敏感化（移除项目名、公司信息）、自包含（无需上下文即可理解）和普世价值（符合 StackOverflow 回答标准），提升知识库质量。

• 完善的错误处理：针对 401/403/422/429/5xx 等各类 API 错误提供具体修复指引，支持 Token 过期时的 inline 重新认证，无需手动重新配置。

潜在缺点与局限性

• 第三方服务依赖：核心功能完全依赖 OpenTIL 云服务，需持续的网络连接，离线状态下仅能保存草稿无法发布，存在供应商锁定风险。

• 来源可信度限制：作者为个人开发者（T3 来源），非知名技术公司或开源基金会背书，长期维护稳定性存疑，企业级用户需谨慎评估。

• Token 安全管理：需在本地存储 til_ 开头的 Personal Access Token，尽管文件权限设置为 600，但仍存在潜在的凭证泄露风险。

• 内容隐私考量：技术笔记将上传至第三方服务器，对数据隐私要求极高的场景（如涉及商业机密、内部架构细节）不适用，尽管支持内容脱敏。

• 功能边界限制：管理子命令（list、publish、delete 等）必须联网使用，无本地回退；且 AI 辅助编辑功能受限于底层模型能力，可能产生不准确的技术解释。

适合的目标群体

• 终身学习者：希望建立个人知识管理系统（PKM），记录日常技术学习、调试经验和最佳实践的软件开发者。

• 技术写作者：需要维护技术博客或团队知识库的内容创作者，可通过批量捕获和标签管理高效组织文章。

• 多身份管理者：在开源社区（个人身份）和企业环境（工作身份）间切换的开发者，利用 Profile 机制隔离不同上下文的内容。

• CLI 重度用户：习惯在终端工作的工程师，厌恶 context switching，追求命令行原生体验的高效用户。

使用风险

• 数据持久性风险：尽管本地草稿机制提供了缓冲，但若长期未同步且未备份本地 ~/.til/drafts/ 目录，仍存在数据丢失风险；建议定期执行 /til sync。

• API 限流与可用性：高频使用可能触发 OpenTIL API 的速率限制（429 错误），且服务宕机时将影响内容发布流程，需关注服务状态。

• Token 过期与权限：Token 长期未使用可能过期，导致需要重新授权；此外，不同子命令需要不同 scopes（read/write/delete），权限配置不当会导致操作失败。

• 内容合规风险：自动发布功能默认将内容设为公开（public），若误上传敏感信息（如 API keys、内部 URL），即使后续删除也可能已被爬虫索引，建议先用 draft 模式审核。