Skip to content

add docs#3559

Merged
deepin-bot[bot] merged 3 commits intolinuxdeepin:masterfrom
Johnson-zs:doc_extesion
Feb 4, 2026
Merged

add docs#3559
deepin-bot[bot] merged 3 commits intolinuxdeepin:masterfrom
Johnson-zs:doc_extesion

Conversation

@Johnson-zs
Copy link
Contributor

No description provided.

Moved all documentation files from docs/ to docs/api/ directory
This restructuring improves the project organization by creating a clear
API documentation section
The change maintains all file contents while providing better logical
grouping for documentation

Influence:
1. Verify documentation links and references still work correctly
2. Check build system paths for documentation generation
3. Test any scripts or tools that depend on documentation file locations
4. Ensure documentation accessibility remains unchanged

chore: 重新组织文档结构

将所有文档文件从 docs/ 移动到 docs/api/ 目录
此次重构通过创建清晰的API文档部分来改进项目组织结构
变更保持了所有文件内容,同时为文档提供了更好的逻辑分组

Influence:
1. 验证文档链接和引用是否仍然正常工作
2. 检查文档生成的构建系统路径
3. 测试依赖于文档文件位置的任何脚本或工具
4. 确保文档可访问性保持不变
Added comprehensive documentation for DDE file manager extension
mechanism including:
1. Main README.md with overview of all supported extension types
2. Four placeholder specification files for different extension
mechanisms
3. Detailed comparison table for extension type selection
4. Technical requirements and target audience guidance
5. Version conventions and related resources

This documentation provides developers with clear guidelines for
extending DDE file manager functionality through various standardized
interfaces.

Influence:
1. Verify all documentation files are properly created and accessible
2. Check documentation structure and content accuracy
3. Test links between documentation files work correctly
4. Review technical specifications for completeness
5. Validate example references and external links

docs: 添加 DDE 文件管理器扩展机制文档

新增了 DDE 文件管理器扩展机制的完整文档,包括:
1. 主 README.md 文件,概述所有支持的扩展类型
2. 四个不同扩展机制的规范文件占位符
3. 详细的扩展类型选择对比表
4. 技术要求和目标受众指南
5. 版本约定和相关资源

该文档为开发者提供了通过各种标准化接口扩展 DDE 文件管理器功能的清晰
指南。

Influence:
1. 验证所有文档文件是否正确创建并可访问
2. 检查文档结构和内容的准确性
3. 测试文档文件之间的链接是否正常工作
4. 审查技术规范的完整性
5. 验证示例引用和外部链接的有效性
@deepin-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: Johnson-zs

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

This commit adds comprehensive documentation for the DDE File Manager
extension plugin system. The documentation covers the complete
specification for developing dfm-extension plugins, including four
plugin types: Menu, EmblemIcon, Window, and File plugins.

Key additions:
1. Complete plugin lifecycle management and ABI stability guidelines
2. Detailed interface specifications for all four plugin types with
code examples
3. Memory management rules and best practices
4. Development environment setup and build instructions
5. Deployment guidelines and installation locations
6. Debugging techniques and common issue resolution
7. Performance optimization recommendations
8. Security considerations and compatibility notes

The documentation provides practical examples for each plugin type,
including complete implementation code snippets and CMake configuration
templates. It also addresses version compatibility between V5 and V6
interfaces and provides migration guidance.

Log: Added comprehensive documentation for DDE File Manager extension
plugin development

Influence:
1. Review the documentation structure and technical accuracy
2. Verify code examples compile correctly
3. Test the build instructions with sample projects
4. Validate deployment guidelines on target systems
5. Check cross-references and external links
6. Confirm all interface specifications are complete and accurate

docs: 添加 dfm-extension 插件规范文档

本次提交为 DDE 文件管理器扩展插件系统添加了完整的文档。文档涵盖了开发
dfm-extension 插件的完整规范,包括四种插件类型:菜单插件、角标插件、窗口
插件和文件插件。

主要新增内容:
1. 完整的插件生命周期管理和 ABI 稳定性指南
2. 所有四种插件类型的详细接口规范及代码示例
3. 内存管理规则和最佳实践
4. 开发环境设置和构建说明
5. 部署指南和安装位置说明
6. 调试技术和常见问题解决方案
7. 性能优化建议
8. 安全考虑和兼容性说明

文档为每种插件类型提供了实际示例,包括完整的实现代码片段和 CMake 配置模
板。同时解决了 V5 和 V6 接口之间的版本兼容性问题,并提供了迁移指导。

Log: 新增 DDE 文件管理器扩展插件开发完整文档

Influence:
1. 审查文档结构和技术准确性
2. 验证代码示例能否正确编译
3. 使用示例项目测试构建说明
4. 在目标系统上验证部署指南
5. 检查交叉引用和外部链接
6. 确认所有接口规范完整准确
@deepin-ci-robot
Copy link
Contributor

deepin pr auto review

Git Diff 代码审查报告

整体评估

本次提交主要完成了文档结构的重组工作,将原有的文档从 docs/ 目录重新组织到 docs/api/ 目录,并新增了 docs/extension/ 目录用于存放扩展开发相关的文档。这是一个重要的文档架构改进,使文档结构更加清晰和模块化。

详细审查意见

1. 语法与逻辑

1.1 CMakeLists.txt 修改

-        add_subdirectory(docs)
+        add_subdirectory(docs/api)

评估:修改正确。将文档构建路径从 docs 更新为 docs/api,与目录结构调整一致。

1.2 文档结构重组

评估

  • 将原有文档移动到 docs/api/ 目录下,逻辑合理
  • 新增 docs/README.md 作为文档入口点,提供了清晰的导航
  • 新增 docs/extension/ 目录用于存放扩展开发文档,与 api/ 目录职责划分清晰

建议

  1. 考虑在 docs/extension/README.md 中添加与 docs/README.md 的交叉引用,便于用户在扩展文档中返回主文档
  2. 考虑在 docs/api/ 目录下也添加一个 README.md,简要说明 API 文档的内容和结构

2. 代码质量

2.1 文档组织

优点

  • 文档结构层次分明,便于维护和查找
  • 使用了清晰的目录命名约定
  • 提供了完整的导航和快速开始指南

建议

  1. docs/extension/ 目录下的 TODO 文件应该尽快填充内容,或者至少添加更详细的计划说明
  2. 考虑添加一个 docs/migration/ 目录,用于存放版本迁移指南,帮助开发者从旧版本迁移

2.2 文档内容

优点

  • docs/extension/05-dfm-extension-plugin.md 内容详尽,涵盖了插件开发的各个方面
  • 提供了完整的示例代码和最佳实践
  • 包含了详细的接口说明和注意事项

建议

  1. 考虑将文档中的代码示例提取到单独的代码仓库或目录,便于直接使用和测试
  2. 可以添加一些常见问题的 FAQ 部分,帮助开发者解决常见问题

3. 代码性能

由于本次提交主要是文档重组,不涉及代码执行,因此性能方面没有直接影响。但文档中提到的插件开发指南中包含了一些性能相关的建议:

优点

  • 文档中提到了延迟加载子菜单的性能优化建议
  • 提供了缓存策略的建议,避免高频系统调用
  • 强调了进程隔离的重要性,避免阻塞主进程

建议

  1. 可以考虑在文档中添加性能基准测试的示例或指南
  2. 可以添加一些性能监控和调试的工具介绍

4. 代码安全

优点

  • 文档中明确提到了插件运行在文件管理器进程空间,需要遵循系统安全策略
  • 强调了避免在插件中执行危险操作(如 system()eval()
  • 提到了对用户输入进行验证和清理的重要性

建议

  1. 可以在文档中添加一个专门的安全章节,详细说明插件开发中的安全注意事项
  2. 可以添加一些安全编码的最佳实践和常见安全漏洞的防范措施
  3. 考虑添加一个安全审计的清单,帮助开发者检查插件的安全性

5. 其他建议

  1. 文档版本控制:建议在文档中添加版本信息,明确文档适用的文件管理器版本
  2. 国际化:考虑为文档提供多语言版本,至少支持英文和中文
  3. 文档生成:考虑使用自动化工具生成文档,如 Doxygen 或 Sphinx,提高文档维护效率
  4. 文档测试:建议添加文档测试流程,确保文档中的示例代码和命令是可执行的

总结

本次提交是一个高质量的文档重组工作,显著改善了文档的组织结构和可维护性。文档内容详尽,覆盖了插件开发的各个方面,并提供了良好的实践建议。通过进一步完善文档内容、添加更多实用信息和最佳实践,可以使文档更加完善和有用。

建议尽快填充 TODO 文件的内容,并考虑添加更多实用工具和指南,帮助开发者更高效地开发插件。

Copy link

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry @Johnson-zs, you have reached your weekly rate limit of 500000 diff characters.

Please try again later or upgrade to continue using Sourcery

Copy link

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry @Johnson-zs, you have reached your weekly rate limit of 500000 diff characters.

Please try again later or upgrade to continue using Sourcery

@Johnson-zs
Copy link
Contributor Author

/forcemerge

@deepin-bot
Copy link
Contributor

deepin-bot bot commented Feb 4, 2026

This pr force merged! (status: behind)

@deepin-bot deepin-bot bot merged commit 3a1cbf5 into linuxdeepin:master Feb 4, 2026
20 of 21 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants