siyuan-task

思源笔记任务管理 Skill 通过 Python 脚本与 SiYuan Note HTTP API 深度集成，为用户提供本地化的自动化任务管理解决方案。

核心用法：用户配置 config.env 中的 API 地址和 Token 后，运行 init 命令初始化"任务清单"数据库结构。通过 task_ops.py 提供的 CLI 或 Python API，可实现任务的创建、查询、状态流转（未开始→进行中→结束/挂起）、重命名及删除。每个任务自动关联独立子文档，支持图片附件插入，形成"数据库视图+详细文档"的双层架构。

显著优点：该方案最大优势在于零外部依赖，仅使用 Python 标准库即可运行，部署极为轻量。与思源原生 Attribute View 数据库无缝集成，自动维护任务与子文档的关联关系，实现笔记与任务管理的深度融合。提供 CLI 和程序化两种调用方式，既满足快速命令操作，也支持集成到复杂自动化工作流。所有数据严格保留在本地 SiYuan 实例，符合隐私优先理念。

潜在缺点：首先，环境依赖较重，必须预先运行思源笔记服务端并开启 API 接口，配置门槛对非技术用户不够友好。其次，功能相对基础，缺乏任务依赖关系、优先级矩阵可视化等高级项目管理特性。最为关键的是删除操作不可逆，会级联删除关联子文档，且没有回收站机制。此外，作为 T3 级社区项目，长期维护和兼容性更新存在不确定性。

适合群体：主要面向将思源笔记作为核心知识库的技术从业者、知识工作者，特别是需要在笔记系统内统一管理任务与相关资料、追求本地优先（local-first）架构的用户。适合中小规模任务管理（建议数百条以内），不适合复杂项目协作场景。

使用风险：数据安全方面，需警惕误删导致的数据永久丢失，建议操作前确认并定期备份。配置安全方面，config.env 包含敏感 API Token，若泄露可能导致笔记数据被未授权访问，应避免提交到版本控制。兼容性风险上，该 Skill 依赖思源特定的 Attribute View 数据结构，未来思源版本更新可能导致 API 不兼容。性能方面，大量并发操作可能受限于思源 HTTP API 的响应能力。