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 的响应能力。

核心用法

siyuan-task-skill 是一个专为思源笔记(SiYuan Note)设计的任务管理自动化工具，通过调用 SiYuan HTTP API 实现任务的全生命周期管理。

初始化配置：用户需编辑 config.env 配置 SiYuan 实例地址、API Token 和笔记本名称，然后运行 python3 task_ops.py init 自动创建「任务清单」文档及 TASK 数据库（属性视图）。

任务数据模型：任务以数据库行形式存储，包含任务名称（主键/关联子文档）、任务内容、相关方、重要程度、紧急程度、状态、备注、时间戳等10个字段。每个任务自动创建同名子文档，含「任务描述」「任务附件」「下一步」三段式模板。

CLI 操作：create 创建任务（自动建子文档）、list 列出全部任务、find 按状态筛选、start/complete/suspend 状态流转、rename 重命名（同步子文档）、attach-image 插入图片、delete 删除（级联子文档）。

程序化调用：可直接导入 TaskManager 类，在 Python 脚本中集成复杂工作流，如批量创建、状态自动化流转等。

显著优点

1. 零依赖安全架构：仅使用 Python 标准库（urllib、json、pathlib），无第三方包引入，彻底规避供应链攻击风险
2. 数据完全私有：所有任务数据存储于用户自管的 SiYuan 实例，零外部传输，符合隐私合规要求
3. 双模型设计：数据库视图支持筛选统计，子文档支持富文本编辑与附件管理，兼顾结构化与灵活性
4. 自动化关联：任务与子文档自动绑定，重命名、删除操作级联同步，减少人工维护成本
5. 配置外部化：API 凭证与端点通过环境文件管理，无硬编码敏感信息

潜在缺点与局限性

1. 网络依赖：需稳定连接 SiYuan 实例，离线状态无法操作
2. HTTP 默认风险：默认配置使用明文 HTTP，内网环境虽可接受，但公网部署需额外配置 HTTPS
3. 无权限管控：一旦获取 API Token，即可全权操作笔记本，缺乏细粒度 RBAC
4. 状态流转硬编码：start/complete/suspend 为固定状态机，不支持自定义工作流
5. 子文档模板固定：三段式模板不可配置，特殊场景需手动调整

适合人群

• 思源笔记重度用户，需在笔记系统内统一管理任务与知识
• 追求数据隐私、拒绝 SaaS 任务管理工具的个人或团队
• 开发者/技术用户，希望将任务管理集成到自动化工作流
• 本地优先(LoCal-first) 软件理念践行者

常规风险

| 风险项 | 说明 | 缓解措施 |

|--------|------|----------|

| Token 泄露 | config.env 明文存储 API Token | 设置 600 权限、不提交 Git、定期轮换 |

| 中间人攻击 | HTTP 传输无加密 | 内网/VPN 部署或启用 HTTPS |

| 来源可信度 | T3 个人开发者维护 | 关注更新动态、必要时 Fork 自维护 |

| 级联删除误操作 | delete 命令同时删除子文档 | 操作前确认 row_id、建议先备份 |

安全认证综合评分 89 分（A 级），属标准安全级别，适合日常使用。