cosense

cosense 技能是一个专为 Cosense（原 Scrapbox）知识管理平台用户设计的强大工具包。它通过将 Cosense API 封装为易于使用的命令行界面，实现了 AI 代理与您的项目数据之间的无缝互动。此技能非常适合希望自动化个人知识库维护、同步文档或将 Cosense 整合到更广泛研究与笔记工作流程中的进阶用户及开发者。它需要配置 COSENSE_SID 和 COSENSE_PROJECT 等环境变量来进行身份验证并锁定特定项目。

• 执行细致的页面操作，包括读取页面为 JSON 或纯文本格式，以及列出项目内容。

• 直接通过代理界面使用关键字搜索整个项目。

• 安全地建立新页面，执行前会自动检查标题冲突以避免覆盖。

• 使用安全的 safe-import 协议更新现有页面，该协议强制处理完整内容，防止意外数据丢失。

• 在每次写入操作前执行自动备份，并将文件保存于指定目录以便随时恢复。

• 在修改前产生差异对照 (diff)，让您在执行前确认变更内容并取得明确同意。

• 本技能依赖 secure import API，该 API 将页面内容视为完全覆盖；编辑时请确保保留所有行数，以免发生意外删除。

• API 请求大小限制为 30MB，足以应付大多数标准页面导入需求。

• 请确保正确在您的 shell 环境配置文件（如 ~/.zshenv 或 ~/.zshrc）中导出 COSENSE_SID 和 COSENSE_PROJECT，以确保代理能稳定访问。

• 工具采用 Cosense 项目结构，其中导入的第一行会被视为页面标题，遵循此语法对于成功执行至关重要。

• 强烈建议定期备份，内置的 backup 与 list-backups 指令可自动化此程序，确保项目数据完整性。