{"id":481,"date":"2026-06-29T08:56:12","date_gmt":"2026-06-29T08:56:12","guid":{"rendered":"https:\/\/www.ai-diagrams.com\/cn\/living-documentation-a-hands-on-review-of-the-vpascode-and-opendocs-integration\/"},"modified":"2026-06-29T08:56:12","modified_gmt":"2026-06-29T08:56:12","slug":"living-documentation-a-hands-on-review-of-the-vpascode-and-opendocs-integration","status":"publish","type":"post","link":"https:\/\/www.ai-diagrams.com\/cn\/living-documentation-a-hands-on-review-of-the-vpascode-and-opendocs-integration\/","title":{"rendered":"\u6d3b\u6587\u6863\uff1aVPasCode \u4e0e OpenDocs \u96c6\u6210\u7684\u5b9e\u6218\u8bc4\u6d4b"},"content":{"rendered":"

\u5f15\u8a00<\/h2>\n

\u4f5c\u4e3a\u4e00\u540d\u62e5\u6709\u4e03\u5e74\u4ee5\u4e0a\u7ecf\u9a8c\u3001\u81f4\u529b\u4e8e\u5f25\u5408\u5de5\u7a0b\u56e2\u961f\u4e0e\u4e1a\u52a1\u5229\u76ca\u76f8\u5173\u8005\u4e4b\u95f4\u5dee\u8ddd\u7684\u4ea7\u54c1\u7ecf\u7406\uff0c\u6211\u4e00\u76f4\u5c06\u6587\u6863\u89c6\u4e3a\u65e2\u5fc5\u8981\u53c8\u4ee4\u4eba\u5934\u75bc\u7684\u95ee\u9898\u3002\u6211\u4eec\u90fd\u6e05\u695a\u5176\u4e2d\u7684\u56f0\u6270\uff1a\u5de5\u7a0b\u5e08\u6784\u5efa\u590d\u6742\u7684\u7cfb\u7edf\uff0c\u4f46\u89e3\u91ca\u8fd9\u4e9b\u7cfb\u7edf\u7684\u56fe\u8868\u5f80\u5f80\u5b58\u5728\u4e8e\u9759\u6001\u6587\u4ef6\u4e2d\uff0c\u4ee3\u7801\u4e00\u5408\u5e76\u5c31\u7acb\u523b\u8fc7\u65f6\u3002\u7ed3\u679c\u5c31\u662f\u2018\u6587\u6863\u503a\u52a1\u2019\u2014\u2014\u4e00\u4e2a\u65e0\u4eba\u4fe1\u4efb\u7684\u77e5\u8bc6\u5e93\uff0c\u56e0\u4e3a\u5b83\u65e0\u6cd5\u53cd\u6620\u771f\u5b9e\u60c5\u51b5\u3002<\/p>\n

\u6700\u8fd1\uff0c\u6211\u6709\u673a\u4f1a\u8bd5\u7528 Visual Paradigm \u63a8\u51fa\u7684\u4e00\u9879\u65b0\u5de5\u4f5c\u6d41\u7a0b\uff0c\u5b83\u627f\u8bfa\u89e3\u51b3\u8fd9\u4e00\u786e\u5207\u95ee\u9898\u3002\u901a\u8fc7\u7ed3\u5408VPasCode<\/strong>\uff0c\u4e00\u4e2a\u6587\u672c\u8f6c\u56fe\u8868\u5de5\u5177\uff0c\u4ee5\u53caOpenDocs<\/strong>\uff0c\u4e00\u4e2a\u7531\u4eba\u5de5\u667a\u80fd\u9a71\u52a8\u7684\u77e5\u8bc6\u7ba1\u7406\u5e73\u53f0\uff0c\u4ed6\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65e0\u7f1d\u7684\u201c\u56fe\u8868\u5373\u4ee3\u7801\u201d\u5de5\u4f5c\u6d41\u3002\u672c\u8bc4\u6d4b\u5c06\u63a2\u8ba8\u8fd9\u4e00\u96c6\u6210\u5982\u4f55\u8fd0\u4f5c\uff0c\u5b83\u5bf9\u8de8\u804c\u80fd\u56e2\u961f\u4e3a\u4f55\u91cd\u8981\uff0c\u4ee5\u53ca\u5982\u4f55\u5c06\u4f60\u7684\u6280\u672f\u6587\u6863\u4ece\u9759\u6001\u5b58\u6863\u8f6c\u53d8\u4e3a\u4e00\u4e2a\u52a8\u6001\u3001\u6d3b\u8dc3\u7684\u8d44\u4ea7\u3002<\/p>\n

\"Living<\/p>\n\n

\u8bbe\u7f6e\u4e0e\u5de5\u5177\uff1a\u5feb\u901f\u5165\u95e8<\/h2>\n

\u5927\u591a\u6570\u7ed8\u56fe\u5de5\u5177\u7684\u5165\u95e8\u95e8\u69db\u5f88\u9ad8\u2014\u2014\u4f60\u9700\u8981\u5b66\u4e60\u4e13\u6709\u7684\u62d6\u62fd\u5f0f\u754c\u9762\uff0c\u6216\u7ba1\u7406\u7e41\u91cd\u7684\u684c\u9762\u5b89\u88c5\u3002VPasCode \u91c7\u7528\u4e0d\u540c\u65b9\u6cd5\uff0c\u5229\u7528\u4f60\u53ef\u80fd\u5df2\u7ecf\u719f\u6089\u7684\u8bed\u6cd5\uff0c\u4f8b\u5982 PlantUML\u3001Mermaid.js \u6216 Graphviz\u3002<\/p>\n

\u8981\u5f00\u59cb\u4f7f\u7528\uff0c\u4f60\u9700\u8981\u8bbf\u95ee\u4e24\u4e2a\u5173\u952e\u7ec4\u4ef6\uff1a<\/p>\n

    \n
  1. \n

    VPasCode<\/strong>\uff1a\u8fd9\u662f\u4f60\u4f7f\u7528\u4ee3\u7801\u521b\u5efa\u89c6\u89c9\u5185\u5bb9\u7684\u753b\u5e03\u3002\u5b83\u652f\u6301\u5b9e\u65f6\u9884\u89c8\uff0c\u8ba9\u4f60\u5728\u8f93\u5165\u65f6\u5373\u53ef\u770b\u5230\u56fe\u8868\u7684\u5373\u65f6\u66f4\u65b0\u3002<\/p>\n<\/li>\n

  2. \n

    OpenDocs<\/strong>\uff1a\u8fd9\u662f\u4f60\u56e2\u961f\u77e5\u8bc6\u5e93\u7684\u4e2d\u5fc3\u67a2\u7ebd\u3002\u4f60\u7684\u6280\u672f\u89c4\u683c\u3001API \u6587\u6863\u548c\u4ea7\u54c1\u9700\u6c42\u90fd\u5b58\u653e\u5728\u8fd9\u91cc\u3002<\/p>\n<\/li>\n<\/ol>\n

    \u8fde\u63a5\u5de5\u4f5c\u6d41<\/h3>\n

    \u8fd9\u79cd\u8bbe\u7f6e\u6700\u4ee4\u4eba\u8033\u76ee\u4e00\u65b0\u7684\u4e00\u70b9\u662f\u5176\u7b80\u6d01\u6027\u3002\u65e0\u9700\u751f\u6210\u590d\u6742\u7684 API \u5bc6\u94a5\uff0c\u4e5f\u65e0\u9700\u914d\u7f6e Webhook\u3002\u8be5\u96c6\u6210\u662f\u539f\u751f\u4e91\u67b6\u6784\uff0c\u5e76\u76f4\u63a5\u5d4c\u5165 Visual Paradigm \u751f\u6001\u7cfb\u7edf\u4e2d\u3002<\/p>\n

    \u53ea\u9700\u4f7f\u7528\u76f8\u540c\u7684 Visual Paradigm \u8d26\u53f7\u767b\u5f55\u4e24\u4e2a\u5e73\u53f0\u3002\u8ba4\u8bc1\u6210\u529f\u540e\uff0c\u7cfb\u7edf\u4f1a\u81ea\u52a8\u8bc6\u522b\u5f7c\u6b64\u3002\u5f53\u4f60\u51c6\u5907\u5206\u4eab\u4e00\u4e2a\u53ef\u89c6\u5316\u5185\u5bb9\u65f6\uff0cVPasCode \u4e2d\u7684\u201c\u53d1\u9001\u5230 OpenDocs \u5de5\u4f5c\u6d41\u201d\u6309\u94ae\u4f1a\u5b89\u5168\u5730\u5c06\u4f60\u7684\u56fe\u8868\u8def\u7531\u81f3\u4f60\u7684 OpenDocs \u5de5\u4f5c\u533a\u3002<\/p>\n\n

    \u56fe\u8868\u5373\u4ee3\u7801\u7684\u5b9e\u6218\uff1a\u5b9e\u7528\u6848\u4f8b<\/h2>\n

    \u4e3a\u4e86\u771f\u6b63\u7406\u89e3\u8fd9\u4e00\u5de5\u4f5c\u6d41\u7684\u4ef7\u503c\uff0c\u6211\u7528\u4ea7\u54c1\u7ecf\u7406\u548c\u5de5\u7a0b\u5e08\u6bcf\u5929\u90fd\u4f1a\u9047\u5230\u7684\u4e09\u79cd\u5e38\u89c1\u573a\u666f\u8fdb\u884c\u4e86\u6d4b\u8bd5\uff1a\u8bb0\u5f55\u7528\u6237\u6d41\u7a0b\u3001\u7ed8\u5236\u7cfb\u7edf\u67b6\u6784\u56fe\u4ee5\u53ca\u5efa\u6a21\u6570\u636e\u7ed3\u6784\u3002<\/p>\n

    \u793a\u4f8b 1\uff1a\u7528\u6237\u8ba4\u8bc1\u7684\u65f6\u5e8f\u56fe<\/h3>\n

    \u8bb0\u5f55 API \u4ea4\u4e92\u5bf9\u65b0\u5f00\u53d1\u8005\u7684\u5165\u804c\u81f3\u5173\u91cd\u8981\u3002\u4e0e\u5176\u624b\u52a8\u7ed8\u5236\u65b9\u6846\u548c\u7bad\u5934\uff0c\u6211\u4f7f\u7528 VPasCode \u4e2d\u7684 PlantUML \u6765\u5b9a\u4e49\u7528\u6237\u767b\u5f55\u6d41\u7a0b\u7684\u903b\u8f91\u3002<\/p>\n

    \"\"<\/p>\n

    \u5728 VPasCode \u4e2d\u7f16\u8f91 PlantUML<\/a><\/p>\n

    \n
    \nPlantUML<\/span>
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728 VPasCode \u4e2d\u7f16\u8f91 PlantUML<\/span>
    \n<\/a>\n<\/div>\n
    \n
    \r\n
    \r\n Plantuml<\/span>\r\n \r\n <\/path><\/path><\/svg>\r\n Edit Plantuml in VPasCode<\/span>\r\n <\/a>\r\n <\/div>\r\n
    \r\n 
    @startuml\r\ntitle \u7528\u6237\u8ba4\u8bc1\u6d41\u7a0b\r\nactor \u7528\u6237\r\nparticipant \"\u524d\u7aef\u5e94\u7528\" as \u524d\u7aef\r\nparticipant \"\u8ba4\u8bc1\u670d\u52a1\" as \u8ba4\u8bc1\r\ndatabase \"\u7528\u6237\u6570\u636e\u5e93\" as \u6570\u636e\u5e93\r\n\r\n\u7528\u6237 -> \u524d\u7aef\uff1a\u8f93\u5165\u51ed\u636e\r\n\u524d\u7aef -> \u8ba4\u8bc1\uff1aPOST \/login\r\n\u8ba4\u8bc1 -> \u6570\u636e\u5e93\uff1a\u67e5\u8be2\u7528\u6237\r\n\u6570\u636e\u5e93 --> \u8ba4\u8bc1\uff1a\u8fd4\u56de\u7528\u6237\u6570\u636e\r\n\u8ba4\u8bc1 --> \u524d\u7aef\uff1aJWT \u4ee4\u724c\r\n\u524d\u7aef --> \u7528\u6237\uff1a\u91cd\u5b9a\u5411\u81f3\u4eea\u8868\u677f\r\n@enduml\r\n<\/code><\/pre>                <\/div>\r\n                
    \r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n            <\/div>\r\n            \n<\/p><\/div>\n
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728 VPasCode \u4e2d\u7f16\u8f91 PlantUML<\/span>
    \n<\/a>\n<\/div>\n<\/div>\n
    \u5728 VPasCode \u4e2d\u7f16\u8f91 PlantUML<\/a><\/p>\n
    \u56fe\u8868\u6e32\u67d3\u5b8c\u6210\u540e\uff0c\u70b9\u51fb\u201c\u53d1\u9001\u5230 OpenDocs \u5de5\u4f5c\u6d41\u201d<\/strong>\u6211\u76f4\u63a5\u5c06\u8fd9\u4e2a\u56fe\u8868\u63a8\u5165\u4e86\u6211\u7684\u6280\u672f\u89c4\u8303\u6587\u6863\u3002\u8fd9\u6d88\u9664\u4e86\u5bfc\u51faPNG\u6587\u4ef6\u3001\u6b63\u786e\u547d\u540d\u5e76\u624b\u52a8\u4e0a\u4f20\u7684\u9700\u8981\u3002<\/p>\n
    \"This<\/p>\n
    \u793a\u4f8b2\uff1a\u5fae\u670d\u52a1\u7684C4\u5bb9\u5668\u56fe<\/h3>\n
    \u5728\u4e0e\u5229\u76ca\u76f8\u5173\u8005\u8fdb\u884c\u9ad8\u5c42\u6b21\u67b6\u6784\u8ba8\u8bba\u65f6\uff0cC4\u6a21\u578b\u6781\u4e3a\u91cd\u8981\u3002\u5b83\u6709\u52a9\u4e8e\u660e\u786e\u7cfb\u7edf\u8fb9\u754c\uff0c\u800c\u4e0d\u4f1a\u9677\u5165\u4ee3\u7801\u7ec6\u8282\u4e2d\u3002\u4ee5\u4e0b\u662f\u6211\u5728\u6620\u5c04\u4e00\u4e2a\u7b80\u5355\u7684\u7f51\u4e0a\u94f6\u884c\u7cfb\u7edf\u65f6\u7684\u65b9\u6cd5\uff1a<\/p>\n
    \"\"<\/p>\n
    \u5728VPasCode\u4e2d\u7f16\u8f91PlantUML<\/a><\/p>\n
    \n
    \nPlantUML<\/span>
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728VPasCode\u4e2d\u7f16\u8f91PlantUML<\/span>
    \n<\/a>\n<\/div>\n
    \n            
    \r\n                                
    \r\n                    Plantuml<\/span>\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n                                
    \r\n                    
    @startuml\r\n!include <C4\/C4_Context>\r\n!include <C4\/C4_Container>\r\n\r\nPerson(user, \"\u5ba2\u6237\", \"\u4f7f\u7528\u7f51\u4e0a\u94f6\u884c\u7cfb\u7edf\")\r\n\r\nSystem_Boundary(bank, \"\u7f51\u4e0a\u94f6\u884c\u7cfb\u7edf\") {\r\n    Container(web_app, \"Web\u5e94\u7528\", \"Java, Spring MVC\", \"\u5411\u7528\u6237\u4ea4\u4ed8\u5185\u5bb9\")\r\n    Container(api, \"API\u540e\u7aef\", \"Java, Spring Boot\", \"\u5904\u7406\u4e1a\u52a1\u903b\u8f91\")\r\n    ContainerDb(db, \"\u6570\u636e\u5e93\", \"SQL\", \"\u5b58\u50a8\u7528\u6237\u8d26\u6237\u548c\u4ea4\u6613\u8bb0\u5f55\")\r\n}\r\n\r\nRel(user, web_app, \"\u4f7f\u7528\")\r\nRel(web_app, api, \"\u901a\u8fc7HTTPS\u8c03\u7528\")\r\nRel(api, db, \"\u8bfb\u53d6\/\u5199\u5165\")\r\n@enduml\r\n<\/code><\/pre>                <\/div>\r\n                
    \r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n            <\/div>\r\n            \n<\/p><\/div>\n
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728VPasCode\u4e2d\u7f16\u8f91PlantUML<\/span>
    \n<\/a>\n<\/div>\n<\/div>\n
    \u5728VPasCode\u4e2d\u7f16\u8f91PlantUML<\/a><\/p>\n
    \u793a\u4f8b3\uff1a\u4ea7\u54c1\u7ba1\u7406\u7c7b\u56fe<\/h3>\n
    \u5728\u5b9a\u4e49\u4ea7\u54c1\u9700\u6c42\u65f6\uff0c\u5bf9\u6570\u636e\u5b9e\u4f53\u7684\u6e05\u6670\u7406\u89e3\u81f3\u5173\u91cd\u8981\u3002\u6211\u4f7f\u7528\u7c7b\u56fe\u6765\u5efa\u6a21\u4ea7\u54c1\u76ee\u5f55\uff0c\u660e\u786e\u4e86\u4ea7\u54c1\u3001\u7c7b\u522b\u548c\u8ba2\u5355\u4e4b\u95f4\u7684\u5173\u7cfb\u3002<\/p>\n
    \"\"<\/p>\n
    \u5728VPasCode\u4e2d\u7f16\u8f91PlantUML<\/a><\/p>\n
    \n
    \nPlantUML<\/span>
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728VPasCode\u4e2d\u7f16\u8f91PlantUML<\/span>
    \n<\/a>\n<\/div>\n
    \n            
    \r\n                                
    \r\n                    Plantuml<\/span>\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n                                
    \r\n                    
    @startuml\r\nclass Product {\r\n    +String name\r\n    +Double price\r\n    +String sku\r\n    +getDetails()\r\n}\r\n\r\nclass Category {\r\n    +String categoryName\r\n    +List<Product> products\r\n}\r\n\r\nclass Order {\r\n    +int orderId\r\n    +Date orderDate\r\n    +List<Product> items\r\n}\r\n\r\nProduct \"1\" -- \"*\" Category : \u5c5e\u4e8e\r\nOrder \"1\" -- \"*\" Product : \u5305\u542b\r\n@enduml\r\n<\/code><\/pre>                <\/div>\r\n                
    \r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n            <\/div>\r\n            \n<\/p><\/div>\n
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728VPasCode\u4e2d\u7f16\u8f91PlantUML<\/span>
    \n<\/a>\n<\/div>\n<\/div>\n
    \u5728VPasCode\u4e2d\u7f16\u8f91PlantUML<\/a><\/p>\n\n
    AI\u529f\u80fd\uff1a\u63d0\u5347\u60a8\u7684\u5de5\u4f5c\u6d41\u7a0b<\/h2>\n
    Visual Paradigm\u5728\u6b64\u9886\u57df\u8131\u9896\u800c\u51fa\u7684\u539f\u56e0\u5728\u4e8e\u96c6\u6210\u4e86AI\u529f\u80fd\u3002\u5728\u6211\u7684\u6d4b\u8bd5\u8fc7\u7a0b\u4e2d\uff0c\u6211\u53d1\u73b0\u6709\u4e09\u4e2a\u529f\u80fd\u7279\u522b\u6709\u52a9\u4e8e\u52a0\u5feb\u6587\u6863\u7f16\u5199\u8fc7\u7a0b\uff1a<\/p>\n