{"id":482,"date":"2026-06-29T08:56:12","date_gmt":"2026-06-29T08:56:12","guid":{"rendered":"https:\/\/www.ai-diagrams.com\/tw\/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\/tw\/living-documentation-a-hands-on-review-of-the-vpascode-and-opendocs-integration\/","title":{"rendered":"\u6d3b\u6587\u4ef6\uff1a\u5c0d VPasCode \u8207 OpenDocs \u6574\u5408\u7684\u5be6\u8e10\u8a55\u4f30"},"content":{"rendered":"

\u5f15\u8a00<\/h2>\n

\u4f5c\u70ba\u4e00\u540d\u64c1\u6709\u4e03\u5e74\u4ee5\u4e0a\u7d93\u9a57\u3001\u81f4\u529b\u65bc\u5f4c\u5408\u5de5\u7a0b\u5718\u968a\u8207\u5546\u696d\u5229\u76ca\u76f8\u95dc\u8005\u4e4b\u9593\u6e9d\u58d1\u7684\u7522\u54c1\u7d93\u7406\uff0c\u6211\u59cb\u7d42\u8a8d\u70ba\u6587\u4ef6\u65e2\u662f\u5fc5\u8981\u4e4b\u7269\uff0c\u4e5f\u662f\u4e00\u5927\u75db\u9ede\u3002\u6211\u5011\u90fd\u6e05\u695a\u5176\u4e2d\u7684\u6399\u624e\uff1a\u5de5\u7a0b\u5e2b\u5efa\u69cb\u8907\u96dc\u7cfb\u7d71\uff0c\u4f46\u89e3\u91cb\u9019\u4e9b\u7cfb\u7d71\u7684\u5716\u8868\u5f80\u5f80\u5b58\u65bc\u975c\u614b\u6587\u4ef6\u4e2d\uff0c\u4e00\u65e6\u7a0b\u5f0f\u78bc\u5408\u4f75\uff0c\u9019\u4e9b\u5716\u8868\u4fbf\u7acb\u523b\u904e\u6642\u3002\u7d50\u679c\u5c31\u662f\u300e\u6587\u4ef6\u50b5\u52d9\u300f\u2014\u2014\u4e00\u500b\u6c92\u6709\u4eba\u4fe1\u4efb\u7684\u77e5\u8b58\u5eab\uff0c\u56e0\u70ba\u5b83\u7121\u6cd5\u53cd\u6620\u73fe\u5be6\u60c5\u6cc1\u3002<\/p>\n

\u6700\u8fd1\uff0c\u6211\u6709\u6a5f\u6703\u8a66\u7528 Visual Paradigm \u63a8\u51fa\u7684\u4e00\u9805\u65b0\u5de5\u4f5c\u6d41\u7a0b\uff0c\u5b83\u627f\u8afe\u80fd\u89e3\u6c7a\u9019\u500b\u7cbe\u78ba\u554f\u984c\u3002\u900f\u904e\u7d50\u5408VPasCode<\/strong>\u2014\u2014\u4e00\u7a2e\u6587\u5b57\u8f49\u5716\u8868\u5de5\u5177\uff0c\u8207OpenDocs<\/strong>\u2014\u2014\u4e00\u500b\u7531\u4eba\u5de5\u667a\u6167\u9a45\u52d5\u7684\u77e5\u8b58\u7ba1\u7406\u5e73\u53f0\uff0c\u4ed6\u5011\u6210\u529f\u6253\u9020\u4e86\u4e00\u689d\u7121\u7e2b\u7684\u300c\u5716\u8868\u5373\u7a0b\u5f0f\u78bc\u300d\u5de5\u4f5c\u6d41\u7a0b\u3002\u672c\u8a55\u6e2c\u5c07\u63a2\u8a0e\u6b64\u6574\u5408\u5982\u4f55\u904b\u4f5c\uff0c\u5c0d\u8de8\u529f\u80fd\u5718\u968a\u7684\u91cd\u8981\u6027\uff0c\u4ee5\u53ca\u5982\u4f55\u5c07\u4f60\u7684\u6280\u8853\u6587\u4ef6\u5f9e\u975c\u614b\u5b58\u6a94\u8f49\u8b8a\u70ba\u6d3b\u8e8d\u4e14\u6301\u7e8c\u66f4\u65b0\u7684\u8cc7\u7522\u3002<\/p>\n

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

\u8a2d\u5b9a\u8207\u5de5\u5177\uff1a\u958b\u59cb\u4f7f\u7528<\/h2>\n

\u5927\u591a\u6578\u5716\u8868\u5de5\u5177\u7684\u5165\u9580\u9580\u6abb\u90fd\u5f88\u9ad8\u2014\u2014\u4f60\u9700\u8981\u5b78\u7fd2\u5c08\u6709\u7684\u62d6\u66f3\u5f0f\u4ecb\u9762\uff0c\u6216\u7ba1\u7406\u7e41\u91cd\u7684\u684c\u9762\u5b89\u88dd\u3002VPasCode \u5247\u63a1\u53d6\u4e0d\u540c\u7684\u65b9\u5f0f\uff0c\u5229\u7528\u4f60\u53ef\u80fd\u5df2\u7d93\u719f\u6089\u7684\u8a9e\u6cd5\uff0c\u4f8b\u5982 PlantUML\u3001Mermaid.js \u6216 Graphviz\u3002<\/p>\n

\u8981\u958b\u59cb\u4f7f\u7528\uff0c\u4f60\u9700\u8981\u53d6\u5f97\u5169\u500b\u95dc\u9375\u7d44\u4ef6\u7684\u5b58\u53d6\u6b0a\u9650\uff1a<\/p>\n

    \n
  1. \n

    VPasCode<\/strong>\uff1a\u9019\u662f\u4f60\u53ef\u4ee5\u4f7f\u7528\u7a0b\u5f0f\u78bc\u5275\u5efa\u8996\u89ba\u5167\u5bb9\u7684\u756b\u5e03\u3002\u5b83\u652f\u63f4\u5373\u6642\u9810\u89bd\uff0c\u8b93\u4f60\u5728\u8f38\u5165\u6642\u5373\u53ef\u770b\u5230\u5716\u8868\u5373\u6642\u66f4\u65b0\u3002<\/p>\n<\/li>\n

  2. \n

    OpenDocs<\/strong>\uff1a\u9019\u662f\u5718\u968a\u77e5\u8b58\u5eab\u7684\u4e2d\u592e\u6a1e\u7d10\u3002\u4f60\u7684\u6280\u8853\u898f\u683c\u3001API \u6587\u4ef6\u8207\u7522\u54c1\u9700\u6c42\u90fd\u5b58\u653e\u65bc\u6b64\u3002<\/p>\n<\/li>\n<\/ol>\n

    \u9023\u63a5\u5de5\u4f5c\u6d41\u7a0b<\/h3>\n

    \u6b64\u8a2d\u5b9a\u6700\u4ee4\u4eba\u8033\u76ee\u4e00\u65b0\u4e4b\u8655\u5728\u65bc\u5176\u7c21\u6f54\u6027\u3002\u7121\u9700\u751f\u6210\u8907\u96dc\u7684 API \u91d1\u9470\uff0c\u4e5f\u7121\u9700\u8a2d\u5b9a Webhook\u3002\u6b64\u6574\u5408\u70ba\u539f\u751f\u96f2\u7aef\u67b6\u69cb\uff0c\u76f4\u63a5\u5167\u5efa\u65bc Visual Paradigm \u751f\u614b\u7cfb\u7d71\u4e2d\u3002<\/p>\n

    \u53ea\u9700\u4f7f\u7528\u76f8\u540c\u7684 Visual Paradigm \u5e33\u865f\u767b\u5165\u5169\u500b\u5e73\u53f0\u3002\u8a8d\u8b49\u6210\u529f\u5f8c\uff0c\u7cfb\u7d71\u6703\u81ea\u52d5\u8b58\u5225\u5f7c\u6b64\u3002\u7576\u4f60\u6e96\u5099\u5206\u4eab\u8996\u89ba\u5167\u5bb9\u6642\uff0cVPasCode \u4e2d\u7684\u300c\u50b3\u9001\u81f3 OpenDocs \u5de5\u4f5c\u6d41\u7a0b\u300d\u6309\u9215\u6703\u5b89\u5168\u5730\u5c07\u4f60\u7684\u5716\u8868\u8def\u7531\u81f3 OpenDocs \u5de5\u4f5c\u7a7a\u9593\u3002<\/p>\n\n

    \u5716\u8868\u5373\u7a0b\u5f0f\u78bc\u7684\u5be6\u969b\u61c9\u7528\uff1a\u5be6\u52d9\u7bc4\u4f8b<\/h2>\n

    \u8981\u771f\u6b63\u7406\u89e3\u6b64\u5de5\u4f5c\u6d41\u7a0b\u7684\u50f9\u503c\uff0c\u6211\u4ee5\u7522\u54c1\u7d93\u7406\u8207\u5de5\u7a0b\u5e2b\u6bcf\u65e5\u5e38\u898b\u7684\u4e09\u500b\u60c5\u5883\u9032\u884c\u6e2c\u8a66\uff1a\u8a18\u9304\u4f7f\u7528\u8005\u6d41\u7a0b\u3001\u7e6a\u88fd\u7cfb\u7d71\u67b6\u69cb\uff0c\u4ee5\u53ca\u5efa\u6a21\u8cc7\u6599\u7d50\u69cb\u3002<\/p>\n

    \u7bc4\u4f8b 1\uff1a\u4f7f\u7528\u8005\u9a57\u8b49\u7684\u9806\u5e8f\u5716<\/h3>\n

    \u8a18\u9304 API \u4e92\u52d5\u5c0d\u65bc\u65b0\u958b\u767c\u4eba\u54e1\u7684\u5165\u8077\u81f3\u95dc\u91cd\u8981\u3002\u7121\u9700\u624b\u52d5\u7e6a\u88fd\u65b9\u6846\u8207\u7bad\u982d\uff0c\u6211\u4f7f\u7528 VPasCode \u4e2d\u7684 PlantUML \u4f86\u5b9a\u7fa9\u4f7f\u7528\u8005\u767b\u5165\u6d41\u7a0b\u7684\u908f\u8f2f\u3002<\/p>\n

    \"\"<\/p>\n

    \u5728 VPasCode \u4e2d\u7de8\u8f2f PlantUML<\/a><\/p>\n

    \n
    \nPlantUML<\/span>
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728 VPasCode \u4e2d\u7de8\u8f2f 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 \u4f7f\u7528\u8005\u9a57\u8b49\u6d41\u7a0b\r\nactor \u4f7f\u7528\u8005\r\nparticipant \"\u524d\u7aef\u61c9\u7528\u7a0b\u5f0f\" as \u524d\u7aef\r\nparticipant \"\u9a57\u8b49\u670d\u52d9\" as \u9a57\u8b49\r\ndatabase \"\u4f7f\u7528\u8005\u8cc7\u6599\u5eab\" as \u8cc7\u6599\u5eab\r\n\r\n\u4f7f\u7528\u8005 -> \u524d\u7aef: \u8f38\u5165\u6191\u8b49\r\n\u524d\u7aef -> \u9a57\u8b49: POST \/login\r\n\u9a57\u8b49 -> \u8cc7\u6599\u5eab: \u67e5\u8a62\u4f7f\u7528\u8005\r\n\u8cc7\u6599\u5eab --> \u9a57\u8b49: \u56de\u50b3\u4f7f\u7528\u8005\u8cc7\u6599\r\n\u9a57\u8b49 --> \u524d\u7aef: JWT \u6191\u8b49\r\n\u524d\u7aef --> \u4f7f\u7528\u8005: \u91cd\u5c0e\u5411\u81f3\u5100\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\u7de8\u8f2f PlantUML<\/span>
    \n<\/a>\n<\/div>\n<\/div>\n
    \u5728 VPasCode \u4e2d\u7de8\u8f2f PlantUML<\/a><\/p>\n
    \u5716\u8868\u6e32\u67d3\u5b8c\u6210\u5f8c\uff0c\u9ede\u64ca\u300c\u50b3\u9001\u81f3 OpenDocs \u5de5\u4f5c\u6d41\u7a0b\u300d<\/strong>\u76f4\u63a5\u5c07\u6b64\u5716\u8868\u63a8\u5165\u6211\u7684\u6280\u8853\u898f\u683c\u6587\u4ef6\u4e2d\u3002\u9019\u6d88\u9664\u4e86\u5c0e\u51fa PNG \u5716\u7247\u3001\u6b63\u78ba\u547d\u540d\u4e26\u624b\u52d5\u4e0a\u50b3\u7684\u9700\u8981\u3002<\/p>\n
    \"This<\/p>\n
    \u7bc4\u4f8b 2\uff1a\u5fae\u670d\u52d9\u7684 C4 \u5bb9\u5668\u5716<\/h3>\n
    \u5728\u8207\u5229\u76ca\u76f8\u95dc\u8005\u9032\u884c\u9ad8\u968e\u67b6\u69cb\u8a0e\u8ad6\u6642\uff0cC4 \u6a21\u578b\u81f3\u95dc\u91cd\u8981\u3002\u5b83\u6709\u52a9\u65bc\u91d0\u6e05\u7cfb\u7d71\u908a\u754c\uff0c\u800c\u4e0d\u6703\u9677\u5165\u7a0b\u5f0f\u78bc\u7d30\u7bc0\u4e2d\u3002\u4ee5\u4e0b\u662f\u6211\u5728\u7c21\u55ae\u7684\u7dda\u4e0a\u9280\u884c\u7cfb\u7d71\u4e0a\u7684\u7e6a\u88fd\u65b9\u5f0f\uff1a<\/p>\n
    \"\"<\/p>\n
    \u5728 VPasCode \u4e2d\u7de8\u8f2f PlantUML<\/a><\/p>\n
    \n
    \nPlantUML<\/span>
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728 VPasCode \u4e2d\u7de8\u8f2f 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\n!include <C4\/C4_Context>\r\n!include <C4\/C4_Container>\r\n\r\nPerson(user, \"\u5ba2\u6236\", \"\u4f7f\u7528\u7dda\u4e0a\u9280\u884c\u7cfb\u7d71\")\r\n\r\nSystem_Boundary(bank, \"\u7dda\u4e0a\u9280\u884c\u7cfb\u7d71\") {\r\n    Container(web_app, \"Web \u61c9\u7528\u7a0b\u5f0f\", \"Java, Spring MVC\", \"\u5411\u4f7f\u7528\u8005\u63d0\u4f9b\u5167\u5bb9\")\r\n    Container(api, \"API \u5f8c\u7aef\", \"Java, Spring Boot\", \"\u8655\u7406\u696d\u52d9\u908f\u8f2f\")\r\n    ContainerDb(db, \"\u8cc7\u6599\u5eab\", \"SQL\", \"\u5132\u5b58\u4f7f\u7528\u8005\u5e33\u6236\u8207\u4ea4\u6613\u8cc7\u6599\")\r\n}\r\n\r\nRel(user, web_app, \"\u4f7f\u7528\")\r\nRel(web_app, api, \"\u900f\u904e HTTPS \u547c\u53eb\")\r\nRel(api, db, \"\u8b80\u53d6\/\u5beb\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\u5728 VPasCode \u4e2d\u7de8\u8f2f PlantUML<\/span>
    \n<\/a>\n<\/div>\n<\/div>\n
    \u5728 VPasCode \u4e2d\u7de8\u8f2f PlantUML<\/a><\/p>\n
    \u7bc4\u4f8b 3\uff1a\u7522\u54c1\u7ba1\u7406\u7684\u985e\u5225\u5716<\/h3>\n
    \u5728\u5b9a\u7fa9\u7522\u54c1\u9700\u6c42\u6642\uff0c\u5c0d\u8cc7\u6599\u5be6\u9ad4\u7684\u6e05\u6670\u7406\u89e3\u81f3\u95dc\u91cd\u8981\u3002\u6211\u4f7f\u7528\u985e\u5225\u5716\u4f86\u5efa\u6a21\u7522\u54c1\u76ee\u9304\uff0c\u91d0\u6e05\u7522\u54c1\u3001\u5206\u985e\u8207\u8a02\u55ae\u4e4b\u9593\u7684\u95dc\u4fc2\u3002<\/p>\n
    \"\"<\/p>\n
    \u5728 VPasCode \u4e2d\u7de8\u8f2f PlantUML<\/a><\/p>\n
    \n
    \nPlantUML<\/span>
    \n
    \n<\/path><\/path><\/svg>
    \n\u5728 VPasCode \u4e2d\u7de8\u8f2f 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\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 : \u5c6c\u65bc\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\u5728 VPasCode \u4e2d\u7de8\u8f2f PlantUML<\/span>
    \n<\/a>\n<\/div>\n<\/div>\n
    \u5728 VPasCode \u4e2d\u7de8\u8f2f PlantUML<\/a><\/p>\n\n
    AI \u9a45\u52d5\u529f\u80fd\uff1a\u63d0\u5347\u60a8\u7684\u5de5\u4f5c\u6d41\u7a0b<\/h2>\n
    Visual Paradigm \u5728\u6b64\u9818\u57df\u4e2d\u812b\u7a4e\u800c\u51fa\u7684\u539f\u56e0\u5728\u65bc\u6574\u5408\u4e86 AI \u529f\u80fd\u3002\u5728\u6211\u6e2c\u8a66\u671f\u9593\uff0c\u6211\u767c\u73fe\u6709\u4e09\u500b\u529f\u80fd\u7279\u5225\u6709\u52a9\u65bc\u52a0\u5feb\u6587\u4ef6\u7de8\u5beb\u6d41\u7a0b\uff1a<\/p>\n