fuli-context 0.23.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (681) hide show
  1. package/README.md +169 -979
  2. package/README.zh-CN.md +157 -830
  3. package/dist/web/assets/{AboutPage-S8QFfzpA.js → AboutPage-Dx07_Z8u.js} +1 -1
  4. package/dist/web/assets/{AboutSectionHeading-B5CzH4Zs.js → AboutSectionHeading-BdhpM609.js} +1 -1
  5. package/dist/web/assets/AgentAppsPage-5VW0uCTz.js +1 -0
  6. package/dist/web/assets/{AgentAppsPage-BuJWNNdL.css → AgentAppsPage-BCxrjrsE.css} +1 -1
  7. package/dist/web/assets/AgentAvatar-DbsG1_BY.css +1 -0
  8. package/dist/web/assets/AgentAvatar-DlAQP7gm.js +1 -0
  9. package/dist/web/assets/{AgentHand-BGGdVdd9.js → AgentHand-FPFg9-Y1.js} +1 -1
  10. package/dist/web/assets/AgentManagement-CLFw9oV9.css +1 -0
  11. package/dist/web/assets/AgentManagement-UTe4I3WA.js +7 -0
  12. package/dist/web/assets/AgentMentionCopy-B9eIIr3L.css +1 -0
  13. package/dist/web/assets/AgentMentionCopy-C5ExlutT.js +1 -0
  14. package/dist/web/assets/{AgentName-CUjBNQ8j.js → AgentName-C8mYbtKs.js} +1 -1
  15. package/dist/web/assets/AgentProfilePage-BLeyT3By.js +5 -0
  16. package/dist/web/assets/{AgentProfilePage-D5QUzw5N.css → AgentProfilePage-DumsVHP1.css} +1 -1
  17. package/dist/web/assets/AgentServicesPage-B2mDUgYZ.css +1 -0
  18. package/dist/web/assets/AgentServicesPage-BXi152Xc.js +1 -0
  19. package/dist/web/assets/{AppViewerPage-CcOlwxck.js → AppViewerPage-BR8ttEGa.js} +1 -1
  20. package/dist/web/assets/{BackToTop-C3KYEoCW.js → BackToTop-5_AQRMZl.js} +1 -1
  21. package/dist/web/assets/{BoardCardFieldsMenu-BlBWT1j7.js → BoardCardFieldsMenu-Bb_Z9a4Q.js} +1 -1
  22. package/dist/web/assets/{BoardMoveMenu-Bc7xC1Uh.js → BoardMoveMenu-B-f8O6cC.js} +1 -1
  23. package/dist/web/assets/{Breadcrumb-C_xMiD-Z.js → Breadcrumb-DtM5lZy5.js} +1 -1
  24. package/dist/web/assets/{CaptureChangePage-Bekp1aWg.js → CaptureChangePage-BzwcfacI.js} +1 -1
  25. package/dist/web/assets/ConnectionsPage-C_vgqwF2.js +1 -0
  26. package/dist/web/assets/ConnectionsPage-DS2PEG6K.css +1 -0
  27. package/dist/web/assets/{CopyFixPrompt-Bp-UX4Hq.js → CopyFixPrompt-CErC3Paj.js} +1 -1
  28. package/dist/web/assets/DataFormatPage-Ccy_e9rf.css +1 -0
  29. package/dist/web/assets/DataFormatPage-DwL4Ofc9.js +2 -0
  30. package/dist/web/assets/DebugTurnPage-UpK_3ZWY.js +1 -0
  31. package/dist/web/assets/DebugTurnsPage-C0aZg5-3.js +1 -0
  32. package/dist/web/assets/{DialogTitle-Lj5s6nwG.js → DialogTitle-BQXOe8EK.js} +1 -1
  33. package/dist/web/assets/{EmployeeRedirectPage-DnvwJeCN.js → EmployeeRedirectPage-BjWpXDSM.js} +1 -1
  34. package/dist/web/assets/EmployeeScopeDialog-Bt3ZlDyZ.js +1 -0
  35. package/dist/web/assets/EmployeeScopeDialog-U_-eNH0Z.css +1 -0
  36. package/dist/web/assets/{EmployeeWorkbench-BhReI8l6.css → EmployeeWorkbench-Bp9pUkfS.css} +1 -1
  37. package/dist/web/assets/EmployeeWorkbench-GtJIUD5G.js +4 -0
  38. package/dist/web/assets/FieldRoot-DRf4wM5x.js +1 -0
  39. package/dist/web/assets/FlaGrowth-DgVLB8hp.css +1 -0
  40. package/dist/web/assets/FlaGrowth-OQtTLTng.js +1 -0
  41. package/dist/web/assets/FlaOccupationKit-BvrKsosv.css +1 -0
  42. package/dist/web/assets/FlaOccupationKit-C-x4VrKk.js +1 -0
  43. package/dist/web/assets/{FlaTaskSheets-CNdaBy1P.js → FlaTaskSheets-CoaF5CbQ.js} +1 -1
  44. package/dist/web/assets/FlasPage-CgIVOGFM.js +1 -0
  45. package/dist/web/assets/FlasPage-H99IZ9M6.css +1 -0
  46. package/dist/web/assets/{GrowthLoading-Cr8xZwwO.js → GrowthLoading-VuVo2vLf.js} +1 -1
  47. package/dist/web/assets/{HowtoPage-Cv1YQy1s.js → HowtoPage-CZ3mOdLc.js} +1 -1
  48. package/dist/web/assets/{HowtoPage-t12tDDpS.css → HowtoPage-CrvMmT6K.css} +1 -1
  49. package/dist/web/assets/InboxPage-1ue8vA7H.css +1 -0
  50. package/dist/web/assets/InboxPage-zNUnnYeJ.js +6 -0
  51. package/dist/web/assets/{KnowledgeDeleteButton-FEyEvhlR.js → KnowledgeDeleteButton-BlUnSG3b.js} +1 -1
  52. package/dist/web/assets/{KnowledgeHardDeleteSection-CVwTeMEJ.js → KnowledgeHardDeleteSection-CznXBtHY.js} +1 -1
  53. package/dist/web/assets/KnowledgeItemEditPage-DGRNkAYd.js +1 -0
  54. package/dist/web/assets/{KnowledgeItemSummaryCard-49EADY_Z.js → KnowledgeItemSummaryCard-Co5JKBHl.js} +1 -1
  55. package/dist/web/assets/KnowledgeOrganizerPage-BWvF1GEu.js +1 -0
  56. package/dist/web/assets/KnowledgeOrganizerPage-CJaFkfS7.css +1 -0
  57. package/dist/web/assets/KnowledgePage--Z4_kAhq.js +1 -0
  58. package/dist/web/assets/KnowledgePeek-BgzQA9SI.js +1 -0
  59. package/dist/web/assets/{KnowledgePeek-Bm5jRVA9.css → KnowledgePeek-CwZVuSkf.css} +1 -1
  60. package/dist/web/assets/{KnowledgeTurnReceiptPage-BOz7IpaK.js → KnowledgeTurnReceiptPage-Csyjimeg.js} +1 -1
  61. package/dist/web/assets/KnowledgeWorkspace-0yOpWtEB.js +4 -0
  62. package/dist/web/assets/{KnowledgeWorkspace-DCoVFyf0.css → KnowledgeWorkspace-BgWo6lBj.css} +1 -1
  63. package/dist/web/assets/{MeAvatar-CYVcRiuW.js → MeAvatar-aY_q8cKs.js} +1 -1
  64. package/dist/web/assets/{MeLink-BdqkzhT6.js → MeLink-B0pNwVLa.js} +1 -1
  65. package/dist/web/assets/MenuSeparator-BR-uLovR.js +1 -0
  66. package/dist/web/assets/ModelSettingsPage-B9PS1Kay.css +1 -0
  67. package/dist/web/assets/ModelSettingsPage-BL6MsF7C.js +1 -0
  68. package/dist/web/assets/{NotFoundPage-Dmn32VWo.js → NotFoundPage-Cr1MaPuk.js} +1 -1
  69. package/dist/web/assets/NoticeRow-BXZWn4EZ.js +1 -0
  70. package/dist/web/assets/NoticeRow-ktVO_9Es.css +1 -0
  71. package/dist/web/assets/OccupationsPage-CkVqZ2pz.js +1 -0
  72. package/dist/web/assets/OccupationsPage-Dup7WzNh.css +1 -0
  73. package/dist/web/assets/OverviewPage-DFW3Ua0Z.js +1 -0
  74. package/dist/web/assets/OverviewPage-Dr4jrXW4.css +1 -0
  75. package/dist/web/assets/{PageColumns-DpfaPeu7.js → PageColumns-DvehZlYm.js} +1 -1
  76. package/dist/web/assets/PageOutline-CFGtHmOK.js +1 -0
  77. package/dist/web/assets/PageOutline-DG5ZYtA8.css +1 -0
  78. package/dist/web/assets/{PersonalProfilePage-DdBfHnqq.css → PersonalProfilePage-DnjNX2xK.css} +1 -1
  79. package/dist/web/assets/PersonalProfilePage-TxsNr44t.js +1 -0
  80. package/dist/web/assets/PersonalProjectsPage-AhgP6CL8.js +1 -0
  81. package/dist/web/assets/{PinIcon-B7dvh7ld.js → PinIcon-BTQsnxRY.js} +1 -1
  82. package/dist/web/assets/PopperContent-DtMksk76.js +1 -0
  83. package/dist/web/assets/{Presence-D3HKb5Hb.js → Presence-B0zMpCF4.js} +1 -1
  84. package/dist/web/assets/ProfileAuthorChip-BqT9Vv65.js +1 -0
  85. package/dist/web/assets/ProfileAuthorChip-CAWNGoW3.css +1 -0
  86. package/dist/web/assets/{ProjectAgentsPage-RpfiV2Fm.css → ProjectAgentsPage-CjeXFzHr.css} +1 -1
  87. package/dist/web/assets/ProjectAgentsPage-O-cMavcz.js +5 -0
  88. package/dist/web/assets/{ProjectJudgmentPolicy-GA33aSRi.js → ProjectJudgmentPolicy-CyHAu0nm.js} +2 -2
  89. package/dist/web/assets/{PublicProjectsPage-PJlBI8IE.js → PublicProjectsPage-Ck1QSR0R.js} +1 -1
  90. package/dist/web/assets/RecentNotices-vJobVOcm.js +1 -0
  91. package/dist/web/assets/{RoundtablesPage-DT5DUXsa.js → RoundtablesPage-C3dYekQ5.js} +6 -6
  92. package/dist/web/assets/{RoundtablesPage-DK9A9J-y.css → RoundtablesPage-DL-IOngN.css} +1 -1
  93. package/dist/web/assets/RovingFocusGroup-CUqyjFSs.js +1 -0
  94. package/dist/web/assets/{RovingFocusItem-CFd7tXzD.js → RovingFocusItem-CyyuWXjE.js} +1 -1
  95. package/dist/web/assets/{SessionMigrationPage-BZ1lEDQr.js → SessionMigrationPage-DukDM0TP.js} +1 -1
  96. package/dist/web/assets/SessionRecordsPage-DZ5ZBiuS.js +1 -0
  97. package/dist/web/assets/SettingsPage-BVIU7iFS.js +1 -0
  98. package/dist/web/assets/SettingsPage-Cj3pEWcd.css +1 -0
  99. package/dist/web/assets/SharedJefaReportPage-DUY03VLS.js +1 -0
  100. package/dist/web/assets/TagVocabularyPage-BKLFJiSu.js +1 -0
  101. package/dist/web/assets/TaskBlockerClear-BBmPbomO.css +1 -0
  102. package/dist/web/assets/TaskBlockerClear-BxOiiuK8.js +1 -0
  103. package/dist/web/assets/TaskBlockerNotice-iUiD3BuZ.js +1 -0
  104. package/dist/web/assets/{TaskReason-LQ0CFiKu.js → TaskReason-D5j7L8tl.js} +1 -1
  105. package/dist/web/assets/TeamCard-CDunbIrP.js +1 -0
  106. package/dist/web/assets/TeamCard-CihQsZZ1.css +1 -0
  107. package/dist/web/assets/{TeamCardsWidget-DGX9k0S6.js → TeamCardsWidget-CUW-fPn7.js} +1 -1
  108. package/dist/web/assets/TeamIsland-CmpDmIX2.js +9 -0
  109. package/dist/web/assets/{TeamIsland-BBQbpozz.css → TeamIsland-DvtcsAsb.css} +1 -1
  110. package/dist/web/assets/{Teleport-C1upABpY.js → Teleport-Dzdr8umQ.js} +1 -1
  111. package/dist/web/assets/{TextField-ZnmRqG0h.js → TextField-BPhEpEv9.js} +1 -1
  112. package/dist/web/assets/TonborgDelegationSwitch-C1nkJqkJ.js +1 -0
  113. package/dist/web/assets/TonborgDelegationSwitch-DeqERWoo.css +1 -0
  114. package/dist/web/assets/{UiChip-CizeOu1Q.js → UiChip-BEQ067LV.js} +1 -1
  115. package/dist/web/assets/{UiDialog-CGTzxn3-.js → UiDialog-JjqzOA0z.js} +1 -1
  116. package/dist/web/assets/{UiDisclosure-ueMA4jl0.js → UiDisclosure-L6GEJHSw.js} +1 -1
  117. package/dist/web/assets/{UiIcon-sD1hUsOF.js → UiIcon-vgD4v8q8.js} +1 -1
  118. package/dist/web/assets/UiIconButton-BzyMc14P.js +1 -0
  119. package/dist/web/assets/{UiSegmented-BZ-jqnPE.js → UiSegmented-CIIm3KoV.js} +1 -1
  120. package/dist/web/assets/{UiWeight-BRO3oVMZ.js → UiWeight-D-2iZ_Kc.js} +1 -1
  121. package/dist/web/assets/VirtualDirectoryList-BJecsQct.css +1 -0
  122. package/dist/web/assets/VirtualDirectoryList-BV8KsA-Z.js +1 -0
  123. package/dist/web/assets/{VisuallyHidden-B8wfJ_mU.js → VisuallyHidden-BxKxuXRF.js} +1 -1
  124. package/dist/web/assets/VisuallyHiddenInput-DD4vhlqT.js +1 -0
  125. package/dist/web/assets/WidgetSlot-Dw5nWlb7.js +2 -0
  126. package/dist/web/assets/WorkbenchListHead-B0TjHsTO.js +1 -0
  127. package/dist/web/assets/WorkbenchListPage-BX6Z9gkB.css +1 -0
  128. package/dist/web/assets/WorkbenchListPage-D0xX-YNl.js +1 -0
  129. package/dist/web/assets/_plugin-vue_export-helper-B4pFJCwG.js +9 -0
  130. package/dist/web/assets/agent-apps-B1Je-mpY.js +1 -0
  131. package/dist/web/assets/agent-occupation-CjfQqSzd.js +1 -0
  132. package/dist/web/assets/{agent-pins-8KX0ynzy.js → agent-pins-DxHlJ96z.js} +1 -1
  133. package/dist/web/assets/agent-profile-BNPLhDog.css +1 -0
  134. package/dist/web/assets/{agent-roster-records-PfAgndHp.js → agent-roster-records-Bi5HWDif.js} +1 -1
  135. package/dist/web/assets/agent-work-summary-o_9-QWBL.js +1 -0
  136. package/dist/web/assets/{agent-workflows-DQlqVOoA.js → agent-workflows-DgdbJqpg.js} +1 -1
  137. package/dist/web/assets/{attach-closest-edge-D2qlayPy.js → attach-closest-edge-DUc_VUVO.js} +1 -1
  138. package/dist/web/assets/{attention-store-BnZ8l3kk.js → attention-store-Bod20yM3.js} +1 -1
  139. package/dist/web/assets/{badge-DX_xrLV6.js → badge-tMy2Qr94.js} +1 -1
  140. package/dist/web/assets/{button-CEkPBC1E.js → button-DnKFsImW.js} +1 -1
  141. package/dist/web/assets/{card-DNQ0_6vT.js → card-Ccu7HCNb.js} +1 -1
  142. package/dist/web/assets/{catalog-KnpBkv5t.js → catalog-CJUV8OJ6.js} +1 -1
  143. package/dist/web/assets/checkbox-D1R6kTUB.js +1 -0
  144. package/dist/web/assets/{client-CSQcWFRh.js → client-D-G2i5VU.js} +2 -2
  145. package/dist/web/assets/client-links-store-UgmraFBZ.js +1 -0
  146. package/dist/web/assets/combobox-C7QLYGzs.js +1 -0
  147. package/dist/web/assets/console-DgRc8Itw.js +1 -0
  148. package/dist/web/assets/{conversation-launcher-settings-CXFE-q_A.js → conversation-launcher-settings-CZAfuu8B.js} +1 -1
  149. package/dist/web/assets/copy-mention-C0EJhDPy.js +1 -0
  150. package/dist/web/assets/{dialog-CxhKMo0D.js → dialog-Bbq93W68.js} +1 -1
  151. package/dist/web/assets/{dist-B9GqMC5C.js → dist-Dd8yFhv6.js} +1 -1
  152. package/dist/web/assets/{dist-DIJqkL4O.js → dist-PpsW5ZE3.js} +1 -1
  153. package/dist/web/assets/dropdown-menu-1fGUL0V3.js +1 -0
  154. package/dist/web/assets/{field-LNsBZqam.js → field-DjVv_wIS.js} +1 -1
  155. package/dist/web/assets/{format-bytes-Bqefdt37.js → format-bytes-BKq_E0Hs.js} +1 -1
  156. package/dist/web/assets/hover-card-BO-929hq.js +1 -0
  157. package/dist/web/assets/{identity-DRfhWjty.js → identity-DIG-uOiU.js} +1 -1
  158. package/dist/web/assets/index-C7IVLf_v.js +24 -0
  159. package/dist/web/assets/index-DF0TcfPY.css +1 -0
  160. package/dist/web/assets/{input-UoZ-0Xne.js → input-DmwRmYO2.js} +1 -1
  161. package/dist/web/assets/is-equal-8VOV02sH.js +1 -0
  162. package/dist/web/assets/{label-DpjbTOxt.js → label-BvwPUTS4.js} +1 -1
  163. package/dist/web/assets/label-table-CDzYRZpc.js +1 -0
  164. package/dist/web/assets/{model-CpuIG8Du.js → model-0TZRbkN2.js} +1 -1
  165. package/dist/web/assets/model-BF_ZMPLi.js +1 -0
  166. package/dist/web/assets/model-BjUERpoQ.js +3 -0
  167. package/dist/web/assets/model-CaR7VPg7.js +1 -0
  168. package/dist/web/assets/{model-pJ6k3zYD.js → model-Dfe81jZT.js} +1 -1
  169. package/dist/web/assets/{model-BYKHVgJr.js → model-DpkZUZUL.js} +1 -1
  170. package/dist/web/assets/{model-13BQndfF.js → model-Tmn6HvL-.js} +1 -1
  171. package/dist/web/assets/{model-B5g0CFcM.js → model-y7OUvtKz.js} +1 -1
  172. package/dist/web/assets/motion-C1fZrqmI.js +1 -0
  173. package/dist/web/assets/{motion-C-ZimCUS.js → motion-mAmbRj_M.js} +1 -1
  174. package/dist/web/assets/{motion-preference-BQiiwhab.js → motion-preference-Dz9S1bZa.js} +1 -1
  175. package/dist/web/assets/npm-copies-BLRc0FXW.js +1 -0
  176. package/dist/web/assets/{client-connection-model-DVwA-GIu.css → npm-copies-GRyMAduA.css} +1 -1
  177. package/dist/web/assets/occupation-catalog-_SnxxRbK.js +1 -0
  178. package/dist/web/assets/occupation-kits-DFC6Auuc.js +1 -0
  179. package/dist/web/assets/{option-CcHPBOo6.js → option-DC8frdbr.js} +1 -1
  180. package/dist/web/assets/{orchestration-filters-DmF4Qs8E.js → orchestration-filters-UeiAHJqn.js} +1 -1
  181. package/dist/web/assets/overview-data-Cq1gefY5.js +1 -0
  182. package/dist/web/assets/page-refresh-DdRJaxMv.js +1 -0
  183. package/dist/web/assets/{page-title-NXphgeQI.js → page-title-Cm9u_qw1.js} +1 -1
  184. package/dist/web/assets/person-profile-BH2AzOfw.js +1 -0
  185. package/dist/web/assets/{popover-xSRzcSmY.js → popover-DW__YCSE.js} +1 -1
  186. package/dist/web/assets/popup-host-ctKYu9Ze.js +1 -0
  187. package/dist/web/assets/profile-model-DtISOJ-X.js +1 -0
  188. package/dist/web/assets/{project-board-layout-DBQeP_QP.js → project-board-layout-CTM8kAgq.js} +1 -1
  189. package/dist/web/assets/{project-capture-BhYsDWwJ.js → project-capture-B3pNhpFF.js} +1 -1
  190. package/dist/web/assets/{project-origin-D8jy8EF_.js → project-origin-BO8Ngccf.js} +1 -1
  191. package/dist/web/assets/quick-edit-api-B169r5Qb.js +1 -0
  192. package/dist/web/assets/radio-group-DqA46cXQ.js +1 -0
  193. package/dist/web/assets/review-api-CJaNgPMA.js +1 -0
  194. package/dist/web/assets/review-list-BbV-Mle7.js +1 -0
  195. package/dist/web/assets/review-store-DSQpb5P8.js +1 -0
  196. package/dist/web/assets/{role-names-PECaMfQo.js → role-names-By0xdfTn.js} +1 -1
  197. package/dist/web/assets/roundtable-live-u9qUU6aA.js +1 -0
  198. package/dist/web/assets/{runtime-dom.esm-bundler-f39i44Mt.js → runtime-dom.esm-bundler-DhFy4Djs.js} +1 -1
  199. package/dist/web/assets/save-file-oGyIokMI.js +1 -0
  200. package/dist/web/assets/select-TqPBladU.js +1 -0
  201. package/dist/web/assets/{session-launch-offers-X9b0DwF1.js → session-launch-offers-CtQeY4Qk.js} +1 -1
  202. package/dist/web/assets/{settings-restart-BnwcTv3i.js → settings-autosave-C7vW3_SP.js} +1 -1
  203. package/dist/web/assets/settings-restart-p12HUUve.js +1 -0
  204. package/dist/web/assets/{shared-report-BxNVLalR.js → shared-report-DQBSigHB.js} +3 -3
  205. package/dist/web/assets/{source-adapters-aupsL146.js → source-adapters-DPJzumzC.js} +1 -1
  206. package/dist/web/assets/{switch-B3Y3oE_n.js → switch-D7w_0h3m.js} +1 -1
  207. package/dist/web/assets/tabs-DR8k0PN9.js +1 -0
  208. package/dist/web/assets/{task-card-fields-DAx6zMLz.js → task-card-fields-X1ZYCm_j.js} +1 -1
  209. package/dist/web/assets/{task-labels-BdDFvSAy.js → task-labels-LuXoQhF9.js} +1 -1
  210. package/dist/web/assets/{task-reason-7WnPreht.js → task-reason-ChpbGtyx.js} +1 -1
  211. package/dist/web/assets/{team-sheets-Cr0ZTPw3.js → team-sheets-DYCQqa8I.js} +1 -1
  212. package/dist/web/assets/{textarea-CRzFqL9a.js → textarea-D53VYanK.js} +1 -1
  213. package/dist/web/assets/ui-D4nAhcmu.css +1 -0
  214. package/dist/web/assets/ui-DmNbL8MW.js +1 -0
  215. package/dist/web/assets/{useAgentRecords-CMtpd3Fj.js → useAgentRecords-Hy9nqMs7.js} +1 -1
  216. package/dist/web/assets/useAgentWorkSummary-mloD4p12.js +1 -0
  217. package/dist/web/assets/{useApi-CROJJdhE-CRCgNOqq.js → useApi-CROJJdhE-DnUGUb8O.js} +1 -1
  218. package/dist/web/assets/{useClipboardCopy-DkqKK3wY.js → useClipboardCopy-BTuQMeWI.js} +1 -1
  219. package/dist/web/assets/{useFocusReturn-BZpVmQnM.js → useFocusReturn-4hUmSzj9.js} +1 -1
  220. package/dist/web/assets/{useForwardExpose-Di-MnbTz.js → useForwardExpose-BDmW7q7u.js} +1 -1
  221. package/dist/web/assets/{useForwardPropsEmits-L9XcB5DG.js → useForwardPropsEmits-BzT2luD4.js} +1 -1
  222. package/dist/web/assets/useForwardScopeId-DZCnSswO.js +1 -0
  223. package/dist/web/assets/useKnowledgeConfirm-L8wnJCuX.js +1 -0
  224. package/dist/web/assets/useKnowledgeItemPeek-C_huXt6E.js +1 -0
  225. package/dist/web/assets/{useMinimumLoadingDisplay-CWPiOaDl.js → useMinimumLoadingDisplay-Dkl8NQru.js} +1 -1
  226. package/dist/web/assets/usePageTools-CbDOdIrg.js +1 -0
  227. package/dist/web/assets/usePrimitiveElement-tPQM7XJs.js +1 -0
  228. package/dist/web/assets/{useProjectAgentRoster-CWVpSsQ3.js → useProjectAgentRoster-BBmRvcgr.js} +1 -1
  229. package/dist/web/assets/{useRoutePeek-DxLVksbJ.js → useRoutePeek-CRbCDqsm.js} +1 -1
  230. package/dist/web/assets/useTeamPeople-D_5cxxf1.js +1 -0
  231. package/dist/web/assets/{useTeamWork-BTZd_wKs.js → useTeamWork-CXEQwF4n.js} +1 -1
  232. package/dist/web/assets/{useTypeahead-pEZNpBls.js → useTypeahead-CVYuxPOD.js} +1 -1
  233. package/dist/web/assets/{utils-BsxOjD1Q.js → utils-BnrWDlfm.js} +1 -1
  234. package/dist/web/assets/utils-BsGjKHV8.js +1 -0
  235. package/dist/web/assets/verification-DbCo_dnY.js +1 -0
  236. package/dist/web/assets/{version-db3QWWjt.js → version-1lwoVj6f.js} +1 -1
  237. package/dist/web/assets/{vue-router-B79HWW1l.js → vue-router-D4_ms6om.js} +1 -1
  238. package/dist/web/assets/workbench-card-Dt0820yW.css +1 -0
  239. package/dist/web/index.html +90 -74
  240. package/docs/agent-conversations-and-collaboration.md +55 -58
  241. package/docs/agent-interface-architecture.md +7 -2
  242. package/docs/agent-roundtable.md +7 -7
  243. package/docs/client-connections.md +85 -8
  244. package/docs/client-links.md +16 -1
  245. package/docs/employee-agents.md +1 -1
  246. package/docs/judgment-and-autonomy.md +2 -0
  247. package/docs/public-personal-architecture.md +1 -1
  248. package/graph-provider/fuli_graph/app.py +2 -0
  249. package/graph-provider/fuli_graph/graph_field_contract.py +6 -3
  250. package/graph-provider/fuli_graph/graph_format_migrations.py +6 -0
  251. package/graph-provider/fuli_graph/graph_models.py +11 -62
  252. package/graph-provider/fuli_graph/graph_query.py +46 -105
  253. package/graph-provider/fuli_graph/knowledge_batch_confirmation.py +7 -5
  254. package/graph-provider/fuli_graph/knowledge_duplicate_models.py +24 -0
  255. package/graph-provider/fuli_graph/knowledge_duplicate_rules.py +157 -0
  256. package/graph-provider/fuli_graph/knowledge_duplicates.py +357 -0
  257. package/graph-provider/fuli_graph/knowledge_item_routes.py +3 -1
  258. package/graph-provider/fuli_graph/knowledge_item_view.py +45 -2
  259. package/graph-provider/fuli_graph/knowledge_item_view_models.py +21 -0
  260. package/graph-provider/fuli_graph/knowledge_management.py +6 -1
  261. package/graph-provider/fuli_graph/knowledge_outdated.py +15 -5
  262. package/graph-provider/fuli_graph/knowledge_review.py +65 -2
  263. package/graph-provider/fuli_graph/knowledge_review_models.py +5 -0
  264. package/graph-provider/fuli_graph/knowledge_search.py +0 -31
  265. package/graph-provider/fuli_graph/knowledge_versions.py +12 -1
  266. package/graph-provider/fuli_graph/models.py +9 -2
  267. package/graph-provider/fuli_graph/preference_versions.py +28 -7
  268. package/graph-provider/fuli_graph/project_agent_routes.py +60 -2
  269. package/graph-provider/fuli_graph/project_agent_task_models.py +63 -5
  270. package/graph-provider/fuli_graph/store.py +2 -0
  271. package/graph-provider/fuli_graph/store_project_agent_task_activity.py +12 -3
  272. package/graph-provider/fuli_graph/store_project_agent_task_blockers.py +110 -23
  273. package/graph-provider/fuli_graph/store_project_agent_task_pages.py +186 -0
  274. package/graph-provider/fuli_graph/store_project_agent_task_reads.py +6 -4
  275. package/graph-provider/fuli_graph/store_project_agent_task_recruitment.py +0 -7
  276. package/graph-provider/fuli_graph/store_project_agent_tasks.py +4 -3
  277. package/graph-provider/fuli_graph/store_task_contexts.py +14 -4
  278. package/graph-provider/fuli_graph/task_blocker.py +38 -6
  279. package/graph-provider/fuli_graph/tonborg_confirmation.py +48 -0
  280. package/graph-provider/pyproject.toml +1 -1
  281. package/native/win32/fuli-win-helper.exe +0 -0
  282. package/npm-shrinkwrap.json +16 -50
  283. package/package.json +2 -2
  284. package/packages/roundtable/src/peer/node-store.js +2 -6
  285. package/packages/roundtable/src/roundtable/chat-service.js +2 -1
  286. package/packages/roundtable/src/roundtable/chat.js +11 -1
  287. package/packages/roundtable/src/roundtable/delivery-state.js +43 -0
  288. package/packages/roundtable/src/roundtable/fla-address.js +6 -0
  289. package/packages/roundtable/src/roundtable/group-discussion-store.js +2 -2
  290. package/packages/roundtable/src/roundtable/group-discussion.js +15 -15
  291. package/packages/roundtable/src/roundtable/person-conversation.js +2 -1
  292. package/packages/roundtable/src/roundtable/service.js +38 -9
  293. package/packages/roundtable/src/roundtable/store.js +8 -5
  294. package/packages/roundtable/src/storage/database-format.js +21 -16
  295. package/registry/client-links.json +66 -4
  296. package/registry/occupation-plugins.json +593 -0
  297. package/skills/capturing-session-knowledge/SKILL.md +15 -2
  298. package/skills/capturing-session-knowledge/references/capture.md +22 -6
  299. package/skills/capturing-session-knowledge/references/coordination.md +16 -6
  300. package/skills/capturing-session-knowledge/references/retrieval.md +23 -6
  301. package/skills/flreview/SKILL.md +1 -1
  302. package/skills/operating-fuli/SKILL.md +39 -12
  303. package/skills/operating-fuli/references/workflow-recipes.md +9 -5
  304. package/src/acceptance-checks/port.js +37 -0
  305. package/src/adaptive-runtime/settings.js +1 -1
  306. package/src/adaptive-runtime/state.js +3 -3
  307. package/src/agent-apps/host-tools/catalog.js +7 -0
  308. package/src/agent-apps/store.js +2 -10
  309. package/src/agent-delegation/person-words.js +15 -1
  310. package/src/agent-kits/cli-presence.js +78 -0
  311. package/src/agent-kits/client-installer.js +9 -5
  312. package/src/agent-kits/installer-manifest.js +11 -6
  313. package/src/agent-kits/legacy-hook-cleanup.js +4 -3
  314. package/src/agent-kits/new-sessions.js +82 -0
  315. package/src/agent-kits/opencode-plugin-gate.js +3 -1
  316. package/src/agent-kits/pins.js +12 -12
  317. package/src/agent-kits/ports.js +5 -2
  318. package/src/agent-kits/session-launcher.js +11 -4
  319. package/src/agent-kits/vendor/agent-installer/README.md +1 -1
  320. package/src/agent-kits/vendor/agent-installer/index.d.ts +1 -1
  321. package/src/agent-kits/vendor/agent-session-launcher/README.md +1 -1
  322. package/src/agent-kits/vendor/agent-session-launcher/index.d.ts +30 -1
  323. package/src/agent-kits/vendor/agent-session-launcher/index.mjs +8 -0
  324. package/src/agent-roundtable/tools.js +3 -3
  325. package/src/agent-services/store.js +2 -4
  326. package/src/agent-tools/agent-workflow-definitions.js +7 -3
  327. package/src/agent-tools/checkpoint-definitions.js +5 -4
  328. package/src/agent-tools/fla-lesson-definitions.js +24 -0
  329. package/src/agent-tools/graph-definitions.js +8 -0
  330. package/src/agent-tools/graph-handlers.js +10 -1
  331. package/src/agent-tools/interface-catalog.js +34 -9
  332. package/src/agent-tools/model-backend-definitions.js +1 -1
  333. package/src/agent-tools/occupation-kit-definitions.js +20 -0
  334. package/src/agent-tools/project-agent-definitions.js +19 -40
  335. package/src/agent-tools/project-agent-tool-definitions.js +5 -1
  336. package/src/agent-tools/reply-echo-definitions.js +18 -0
  337. package/src/agent-tools/tonborg-question-definitions.js +26 -0
  338. package/src/agent-workflows/agent-tools.js +69 -3
  339. package/src/agent-workflows/port.js +32 -4
  340. package/src/agent-workflows/store.js +16 -9
  341. package/src/agents/choice-answers.js +19 -0
  342. package/src/agents/claude-code/choice-answers.js +49 -0
  343. package/src/agents/claude-code/fla-menu-command.js +14 -0
  344. package/src/agents/claude-code/lifecycle-hook.js +16 -9
  345. package/src/agents/claude-code/turn-records.js +38 -0
  346. package/src/agents/codex/fla-prompts.js +98 -0
  347. package/src/agents/codex/lifecycle-hook.js +8 -7
  348. package/src/agents/cursor/lifecycle-hook.js +3 -2
  349. package/src/agents/identity-receipt.js +9 -7
  350. package/src/agents/lifecycle-failure.js +9 -0
  351. package/src/agents/lifecycle-message.js +4 -5
  352. package/src/agents/opencode/lifecycle-hook.js +12 -7
  353. package/src/agents/opencode/plugin.js +7 -2
  354. package/src/agents/token-usage-resolver.js +1 -1
  355. package/src/agents/turn-receipt.js +5 -4
  356. package/src/cli/command-registry.js +1 -1
  357. package/src/cli/local-runtime-command.js +5 -2
  358. package/src/cli/local-runtime-options.js +7 -3
  359. package/src/cli/models-command.js +15 -11
  360. package/src/cli/update-command.js +2 -2
  361. package/src/cli/update-installation.js +23 -6
  362. package/src/cli/workspace-connection-command.js +2 -2
  363. package/src/client-links/registry.js +6 -112
  364. package/src/conversations/entry-skeleton.js +113 -55
  365. package/src/conversations/human-interaction.js +1 -1
  366. package/src/conversations/person-words.js +29 -0
  367. package/src/conversations/preference-session.js +17 -14
  368. package/src/conversations/stop-auto-close.js +28 -7
  369. package/src/conversations/task-context-view.js +113 -27
  370. package/src/conversations/turn-findings.js +105 -0
  371. package/src/data-format/format-notices.js +2 -1
  372. package/src/data-format/local-stores.js +22 -1
  373. package/src/debug-turns/model-capture.js +1 -1
  374. package/src/debug-turns/record.js +1 -1
  375. package/src/desktop/cli-path.js +253 -0
  376. package/src/desktop/desktop-app-package.js +31 -0
  377. package/src/desktop/{fuli-links.js → desktop-client-links.js} +20 -16
  378. package/src/desktop/desktop-controller.js +35 -3
  379. package/src/desktop/npm-adoption-store.js +7 -0
  380. package/src/desktop/npm-adoption.js +119 -0
  381. package/src/desktop/npm-copies.js +73 -0
  382. package/src/desktop/npm-copy-control.js +56 -0
  383. package/src/desktop/npm-copy-data.js +51 -0
  384. package/src/desktop/npm-copy-uninstall.js +67 -0
  385. package/src/desktop/windows-controller.js +13 -1
  386. package/src/desktop/windows-installation-switch.js +1 -1
  387. package/src/desktop/windows-node-launcher.js +11 -0
  388. package/src/desktop/windows-uninstall.js +3 -0
  389. package/src/dreaming/astro-calls.js +47 -0
  390. package/src/dreaming/projects.js +39 -0
  391. package/src/dreaming/run.js +38 -36
  392. package/src/dreaming/scheduler.js +2 -2
  393. package/src/employees/builtin/jefa/board-store.js +2 -10
  394. package/src/employees/builtin/jefa/tools.js +1 -1
  395. package/src/employees/management-policy.js +1 -1
  396. package/src/employees/manifest.js +1 -1
  397. package/src/employees/service.js +11 -1
  398. package/src/external-knowledge/document-mapping.js +1 -1
  399. package/src/external-knowledge/index.js +0 -4
  400. package/src/fla-growth/lessons.js +40 -0
  401. package/src/fla-growth/task-verification.js +25 -0
  402. package/src/fla-growth/tool-suggestions.js +107 -0
  403. package/src/fla-growth/verification.js +30 -0
  404. package/src/graphiti/agent-access-policy.js +1 -1
  405. package/src/graphiti/agent-conversations.js +2 -2
  406. package/src/graphiti/agent-growth.js +32 -4
  407. package/src/graphiti/capture-change-confirmation.js +4 -1
  408. package/src/graphiti/capture-notice.js +2 -1
  409. package/src/graphiti/capture-onboarding.js +1 -1
  410. package/src/graphiti/collaboration-preference-projection.js +1 -1
  411. package/src/graphiti/conversation-triage.js +1 -1
  412. package/src/graphiti/execution-mode.js +1 -1
  413. package/src/graphiti/federated-application.js +16 -8
  414. package/src/graphiti/fla-mention.js +105 -96
  415. package/src/graphiti/fla-menu-reader.js +25 -0
  416. package/src/graphiti/fla-menu.js +108 -0
  417. package/src/graphiti/fla-picker.js +21 -16
  418. package/src/graphiti/fuli-markup.js +60 -0
  419. package/src/graphiti/group-member-context.js +1 -1
  420. package/src/graphiti/human-review-channel.js +16 -2
  421. package/src/graphiti/knowledge-result-budget.js +2 -2
  422. package/src/graphiti/knowledge-review.js +2 -1
  423. package/src/graphiti/local-runtimes.js +11 -0
  424. package/src/graphiti/preference-task-scope.js +1 -1
  425. package/src/graphiti/project-agent-control-plane.js +6 -0
  426. package/src/graphiti/project-agent-mapping.js +23 -10
  427. package/src/graphiti/project-agent-mention.js +10 -28
  428. package/src/graphiti/project-agent-task-entry.js +1 -1
  429. package/src/graphiti/project-agent-task-sheets.js +1 -1
  430. package/src/graphiti/project-agent-workflows.js +20 -5
  431. package/src/graphiti/project-knowledge-presence.js +27 -0
  432. package/src/graphiti/project-path-context.js +2 -2
  433. package/src/graphiti/provider-client.js +24 -0
  434. package/src/graphiti/recall-policy.js +1 -1
  435. package/src/graphiti/reply-echo-agent-tool.js +36 -0
  436. package/src/graphiti/reply-echo-group.js +85 -0
  437. package/src/graphiti/reply-echo.js +87 -0
  438. package/src/graphiti/session-knowledge-migration.js +2 -1
  439. package/src/graphiti/session-prompt-sentences.js +52 -0
  440. package/src/graphiti/session-records.js +3 -2
  441. package/src/graphiti/source-marker.js +14 -0
  442. package/src/graphiti/task-blocker-progress.js +24 -1
  443. package/src/graphiti/task-context-entry.js +11 -0
  444. package/src/graphiti/task-entry-group-discussion.js +31 -31
  445. package/src/graphiti/task-entry-named-fla.js +40 -70
  446. package/src/graphiti/task-entry-preferences.js +1 -1
  447. package/src/graphiti/task-entry-project-scope.js +4 -4
  448. package/src/graphiti/task-entry-read-only.js +1 -1
  449. package/src/graphiti/task-entry-standing-owner.js +3 -3
  450. package/src/graphiti/task-experiences.js +21 -3
  451. package/src/graphiti/task-knowledge-checkpoint.js +4 -1
  452. package/src/graphiti/task-knowledge-recall.js +140 -25
  453. package/src/graphiti/task-prompt-statement.js +49 -0
  454. package/src/graphiti/task-remember.js +23 -9
  455. package/src/graphiti/task-stated-rules.js +75 -0
  456. package/src/graphiti/temporary-project-scope.js +1 -1
  457. package/src/graphiti/topic-proposals.js +6 -5
  458. package/src/graphiti/user-taste-skill.js +1 -1
  459. package/src/graphiti/workflow-candidate-mapping.js +1 -1
  460. package/src/http/agent-delegation-gate.js +9 -0
  461. package/src/http/api-router.js +16 -0
  462. package/src/http/cli-path-api-router.js +35 -0
  463. package/src/http/desktop-client-api-router.js +18 -0
  464. package/src/http/dreaming-api-router.js +10 -7
  465. package/src/http/graph-api-router.js +17 -0
  466. package/src/http/notices-api-router.js +37 -0
  467. package/src/http/npm-copies-api-router.js +36 -0
  468. package/src/http/occupation-plugins-api-router.js +43 -0
  469. package/src/http/reply-echo-api-router.js +53 -0
  470. package/src/http/response.js +1 -1
  471. package/src/http/retrospectives-api-router.js +18 -0
  472. package/src/http/session-launch-api-router.js +34 -1
  473. package/src/http/static-handler.js +1 -1
  474. package/src/http/task-blocker-api-router.js +17 -5
  475. package/src/http/task-verification-api-router.js +16 -0
  476. package/src/http/whats-new-api-router.js +34 -0
  477. package/src/judgment/acceptance.js +10 -3
  478. package/src/judgment/agent-view.js +21 -4
  479. package/src/judgment/conversation.js +86 -2
  480. package/src/judgment/delegated-reviews.js +23 -0
  481. package/src/judgment/engine.js +49 -16
  482. package/src/judgment/explain-method.js +11 -0
  483. package/src/judgment/http.js +17 -2
  484. package/src/judgment/question-options.js +97 -0
  485. package/src/judgment/question-tools.js +235 -0
  486. package/src/judgment/review-delegation.js +89 -0
  487. package/src/judgment/review-prompt.js +44 -3
  488. package/src/judgment/review-verdicts.js +13 -4
  489. package/src/judgment/runtime.js +3 -1
  490. package/src/judgment/service.js +25 -5
  491. package/src/judgment/store.js +44 -8
  492. package/src/judgment/verdict-schema.js +6 -0
  493. package/src/judgment/visible-items.js +15 -4
  494. package/src/knowledge-duplicates/scheduler.js +28 -0
  495. package/src/knowledge-hard-delete/forget-references.js +5 -2
  496. package/src/knowledge-impressions/store.js +17 -5
  497. package/src/local-runtime/console-autostart-record.js +95 -0
  498. package/src/local-runtime/console-autostart.js +143 -0
  499. package/src/local-runtime/console-health.js +26 -0
  500. package/src/local-runtime/installed-console-launcher.js +73 -0
  501. package/src/local-runtime/lifecycle.js +85 -21
  502. package/src/local-runtime/processes.js +15 -2
  503. package/src/local-runtime/unresponsive-console.js +77 -0
  504. package/src/mcp/create-mcp-server.js +4 -0
  505. package/src/mcp/fla-menu-prompts.js +60 -0
  506. package/src/mcp/runtime.js +11 -3
  507. package/src/mcp/session-id.js +3 -2
  508. package/src/mcp/tool-annotations.js +5 -2
  509. package/src/mcp/tool-profiles.js +1 -1
  510. package/src/mcp/tool-result.js +3 -1
  511. package/src/model-backends/adapters/anthropic-messages.js +2 -2
  512. package/src/model-backends/adapters/ollama-local-build.js +1 -1
  513. package/src/model-backends/adapters/openai-chat.js +2 -2
  514. package/src/model-backends/budget.js +10 -1
  515. package/src/model-backends/config.js +2 -2
  516. package/src/model-backends/endpoint-models.js +80 -0
  517. package/src/model-backends/http.js +3 -1
  518. package/src/model-backends/keys-http.js +5 -4
  519. package/src/model-backends/models-http.js +54 -0
  520. package/src/model-backends/port.js +32 -5
  521. package/src/model-backends/prompt.js +11 -1
  522. package/src/model-backends/role-settings.js +27 -2
  523. package/src/model-backends/role-trust.js +3 -15
  524. package/src/model-backends/role-work-store.js +2 -12
  525. package/src/model-backends/runtime.js +11 -2
  526. package/src/model-backends/secret-store.js +61 -12
  527. package/src/model-backends/suggestion-log.js +6 -15
  528. package/src/model-backends/usage-ledger.js +28 -18
  529. package/src/notices/recent-notices.js +175 -0
  530. package/src/notifications/needs-person.js +1 -1
  531. package/src/occupation-plugins/agent-tools.js +59 -0
  532. package/src/occupation-plugins/choice-store.js +65 -0
  533. package/src/occupation-plugins/manifest.js +165 -0
  534. package/src/occupation-plugins/port.js +104 -0
  535. package/src/occupation-plugins/recruitment.js +38 -0
  536. package/src/presence/windows-helper-pin.js +1 -1
  537. package/src/registry/updatable-manifest.js +127 -0
  538. package/src/retrieval-terms/fill.js +1 -1
  539. package/src/retrospectives/run.js +113 -0
  540. package/src/retrospectives/runs.js +18 -0
  541. package/src/retrospectives/scheduler.js +58 -0
  542. package/src/server/application-lifecycle.js +1 -1
  543. package/src/server/signal-shutdown.js +31 -0
  544. package/src/server.js +26 -18
  545. package/src/setup/first-run-capture.js +6 -2
  546. package/src/setup/graph-runtime.js +46 -38
  547. package/src/setup/neo4j-memory-profile.js +1 -1
  548. package/src/setup/paths.js +2 -0
  549. package/src/standing-assignments/store.js +2 -4
  550. package/src/system/client-connection-status.js +3 -1
  551. package/src/system/doctor.js +19 -2
  552. package/src/system/graph-migration.js +1 -1
  553. package/src/system/platform-path.js +21 -9
  554. package/src/system/runtime-settings.js +19 -7
  555. package/src/system/settings-guide.js +7 -0
  556. package/src/system/system-service.js +41 -2
  557. package/src/task-blockers/console-port.js +12 -6
  558. package/src/text/markdown-link.js +12 -0
  559. package/src/text/single-line.js +6 -0
  560. package/src/text/utf8-preview.js +7 -6
  561. package/src/whats-new/lines/0.25.0.json +17 -0
  562. package/src/whats-new/release-lines.js +66 -0
  563. package/src/whats-new/whats-new.js +70 -0
  564. package/src/work-surfaces/store.js +2 -4
  565. package/dist/web/assets/AgentAppsPage-BYXraPFM.js +0 -1
  566. package/dist/web/assets/AgentManagement-Bza8k5ra.js +0 -7
  567. package/dist/web/assets/AgentManagement-CeF4mjtg.css +0 -1
  568. package/dist/web/assets/AgentMentionCopy-C72hY2QL.js +0 -1
  569. package/dist/web/assets/AgentMentionCopy-CNKrzZvE.css +0 -1
  570. package/dist/web/assets/AgentProfilePage-kp7-gRRx.js +0 -5
  571. package/dist/web/assets/AgentServicesPage-ARIWfmuh.css +0 -1
  572. package/dist/web/assets/AgentServicesPage-IsGaz7FY.js +0 -1
  573. package/dist/web/assets/ConnectionsPage-BpvecWXD.js +0 -1
  574. package/dist/web/assets/ConnectionsPage-Cwt-knQQ.css +0 -1
  575. package/dist/web/assets/DataFormatPage-dsy8d3oA.js +0 -2
  576. package/dist/web/assets/DataFormatPage-sSnjjUY4.css +0 -1
  577. package/dist/web/assets/DebugTurnPage-cIJV7xDW.js +0 -1
  578. package/dist/web/assets/DebugTurnsPage-B6Te_Alp.js +0 -1
  579. package/dist/web/assets/EmployeeScopeDialog-CXNZ62Ab.js +0 -1
  580. package/dist/web/assets/EmployeeScopeDialog-Do5PHQh7.css +0 -1
  581. package/dist/web/assets/EmployeeWorkbench-DALIO-cM.js +0 -4
  582. package/dist/web/assets/FieldRoot-DRnAC66O.js +0 -1
  583. package/dist/web/assets/FlaGrowth-7wlv31Tl.js +0 -1
  584. package/dist/web/assets/FlaGrowth-BzXY8pcx.css +0 -1
  585. package/dist/web/assets/FlasPage-BCs1Ffpf.js +0 -1
  586. package/dist/web/assets/FlasPage-SLQDMv47.css +0 -1
  587. package/dist/web/assets/InboxPage-Bkx6nIhb.css +0 -1
  588. package/dist/web/assets/InboxPage-CgJnymOY.js +0 -4
  589. package/dist/web/assets/KnowledgeItemEditPage-rwpM8cF1.js +0 -1
  590. package/dist/web/assets/KnowledgeOrganizerPage-7IdnjM3L.js +0 -1
  591. package/dist/web/assets/KnowledgeOrganizerPage-CNm2jvJZ.css +0 -1
  592. package/dist/web/assets/KnowledgePage-gxqOIZxf.js +0 -1
  593. package/dist/web/assets/KnowledgePeek-CQyCxHFj.js +0 -1
  594. package/dist/web/assets/KnowledgeWorkspace-A7zVb26p.js +0 -4
  595. package/dist/web/assets/MenuSeparator-quqkZZXY.js +0 -1
  596. package/dist/web/assets/ModelSettingsPage-B8jC_uew.js +0 -3
  597. package/dist/web/assets/ModelSettingsPage-DhCn_SF6.css +0 -1
  598. package/dist/web/assets/OccupationsPage-BVREfX_R.js +0 -1
  599. package/dist/web/assets/OccupationsPage-Di7B-bPl.css +0 -1
  600. package/dist/web/assets/OverviewPage-CHyEbdP4.js +0 -1
  601. package/dist/web/assets/OverviewPage-xdF5g6bZ.css +0 -1
  602. package/dist/web/assets/PageOutline-BKBQ1T4d.js +0 -1
  603. package/dist/web/assets/PageOutline-BqVgnlos.css +0 -1
  604. package/dist/web/assets/PersonalProfilePage-Cxp2gn6J.js +0 -1
  605. package/dist/web/assets/PersonalProjectsPage-821imOxR.js +0 -1
  606. package/dist/web/assets/PopperContent-DNqbLkNa.js +0 -1
  607. package/dist/web/assets/ProfileAuthorChip-7HSHODdR.js +0 -1
  608. package/dist/web/assets/ProfileAuthorChip-C_0hzDoP.css +0 -1
  609. package/dist/web/assets/ProjectAgentsPage-DBsXS6Xa.js +0 -5
  610. package/dist/web/assets/RovingFocusGroup-BB0d3k17.js +0 -1
  611. package/dist/web/assets/SessionRecordsPage-BMAAtIAt.js +0 -1
  612. package/dist/web/assets/SettingsPage-BYNEk6BM.js +0 -1
  613. package/dist/web/assets/SettingsPage-Uj1IpZpS.css +0 -1
  614. package/dist/web/assets/SharedJefaReportPage-g35o6jUb.js +0 -1
  615. package/dist/web/assets/TagVocabularyPage-COubNJXz.js +0 -1
  616. package/dist/web/assets/TaskBlockerClear-B5MpHdlh.js +0 -1
  617. package/dist/web/assets/TaskBlockerClear-CjSNfpyP.css +0 -1
  618. package/dist/web/assets/TaskBlockerNotice-CIN0HRiE.js +0 -1
  619. package/dist/web/assets/TeamCard-CsmWDw2Q.css +0 -1
  620. package/dist/web/assets/TeamCard-D-kLa5rT.js +0 -1
  621. package/dist/web/assets/TeamIsland-BIo-l49b.js +0 -9
  622. package/dist/web/assets/UiIconButton-CCo4NPYv.js +0 -1
  623. package/dist/web/assets/UiNotice-DGPFbVo7.js +0 -1
  624. package/dist/web/assets/VirtualDirectoryList-1vLi41SD.css +0 -1
  625. package/dist/web/assets/VirtualDirectoryList-BkV3gj5E.js +0 -1
  626. package/dist/web/assets/VisuallyHiddenInput-Bdcr9CwC.js +0 -1
  627. package/dist/web/assets/WidgetSlot-DFojQaSo.js +0 -2
  628. package/dist/web/assets/_plugin-vue_export-helper-B9AJmZbc.js +0 -9
  629. package/dist/web/assets/agent-apps-CKGFfySp.js +0 -1
  630. package/dist/web/assets/agent-avatar-V6M_DF3r.js +0 -1
  631. package/dist/web/assets/agent-occupation-PZ2YAIM8.js +0 -1
  632. package/dist/web/assets/agent-profile-Clb-gYu-.css +0 -1
  633. package/dist/web/assets/agent-work-summary-bzTwEUaA.js +0 -1
  634. package/dist/web/assets/checkbox-DPyLHneg.js +0 -1
  635. package/dist/web/assets/client-connection-model-vO2cap6a.js +0 -1
  636. package/dist/web/assets/client-links-store-DMqe0MbK.js +0 -1
  637. package/dist/web/assets/combobox-zUq9bkyM.js +0 -1
  638. package/dist/web/assets/console-DaoAO-EO.js +0 -1
  639. package/dist/web/assets/context-menu-CcGDnF_k.js +0 -1
  640. package/dist/web/assets/dropdown-menu-CXmMnCBh.js +0 -1
  641. package/dist/web/assets/fla-mention-D_Qb7VeY.js +0 -1
  642. package/dist/web/assets/index-B4AMPpl_.css +0 -1
  643. package/dist/web/assets/index-BYIOAXnn.js +0 -2
  644. package/dist/web/assets/label-table-BnWNYfyk.js +0 -1
  645. package/dist/web/assets/model-CDevUwUw.js +0 -1
  646. package/dist/web/assets/model-P5fSGsiJ.js +0 -1
  647. package/dist/web/assets/motion-QY5FKKko.js +0 -1
  648. package/dist/web/assets/occupation-catalog-uDDhZwKK.js +0 -1
  649. package/dist/web/assets/person-profile-DXXfpvta.js +0 -1
  650. package/dist/web/assets/popup-host-Bmvrf-2t.js +0 -1
  651. package/dist/web/assets/profile-model-6gTmScHC.js +0 -1
  652. package/dist/web/assets/quick-edit-api-WLh_88w6.js +0 -1
  653. package/dist/web/assets/radio-group-B4r78nDh.js +0 -1
  654. package/dist/web/assets/roundtable-live-DFeDF56c.js +0 -1
  655. package/dist/web/assets/save-file-rPduHi2f.js +0 -1
  656. package/dist/web/assets/select-_JO3Mxdp.js +0 -1
  657. package/dist/web/assets/tabs-BlcZiEMY.js +0 -1
  658. package/dist/web/assets/ui-BopQuQfc.js +0 -1
  659. package/dist/web/assets/ui-CoUaCzmO.css +0 -1
  660. package/dist/web/assets/useAgentWorkSummary-BQbhaHov.js +0 -1
  661. package/dist/web/assets/useForwardScopeId-CUQFIAIj.js +0 -1
  662. package/dist/web/assets/useKnowledgeItemPeek-PmQJixw5.js +0 -1
  663. package/dist/web/assets/useTeamPeople-CDISP0PM.js +0 -1
  664. package/dist/web/assets/utils-B4pBTmyh.js +0 -1
  665. package/src/workspace-protocol/array-validation.js +0 -19
  666. package/src/workspace-protocol/base64url-contract.js +0 -27
  667. package/src/workspace-protocol/constants.js +0 -37
  668. package/src/workspace-protocol/error-contract.js +0 -24
  669. package/src/workspace-protocol/fact-contract.js +0 -110
  670. package/src/workspace-protocol/governance-contract.js +0 -47
  671. package/src/workspace-protocol/index.js +0 -53
  672. package/src/workspace-protocol/json-budget.js +0 -19
  673. package/src/workspace-protocol/manifest-contract.js +0 -186
  674. package/src/workspace-protocol/publication-contract.js +0 -212
  675. package/src/workspace-protocol/query-contract.js +0 -149
  676. package/src/workspace-protocol/scalar-contract.js +0 -192
  677. package/src/workspace-protocol/sync-contract.js +0 -184
  678. package/src/workspace-protocol/text-contract.js +0 -39
  679. package/src/workspace-protocol/validation.js +0 -66
  680. /package/dist/web/assets/{UiNotice-ZCBdABdM.css → UiIconButton-ZCBdABdM.css} +0 -0
  681. /package/dist/web/assets/{settings-restart-BU_GGtbG.css → settings-autosave-BU_GGtbG.css} +0 -0
package/README.zh-CN.md CHANGED
@@ -1,883 +1,210 @@
1
1
  <p align="center">
2
2
  <picture>
3
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/JevonsCode/fuli/main/brand/svg/mark/fuli-mark-dark.svg" />
4
- <img src="https://raw.githubusercontent.com/JevonsCode/fuli/main/brand/svg/mark/fuli-mark-color.svg" alt="Fuli Logo" width="72" />
3
+ <source media="(prefers-color-scheme: dark)" srcset="brand/svg/lockup/fuli-lockup-bilingual-horizontal-dark.svg" />
4
+ <img src="brand/svg/lockup/fuli-lockup-bilingual-horizontal.svg" alt="FULI 复利 标志" width="200" />
5
5
  </picture>
6
6
  </p>
7
7
 
8
- <h1 align="center">复利(Fuli)</h1>
8
+ <p align="center">
9
+ <picture>
10
+ <source media="(prefers-color-scheme: dark)" srcset="docs/readme/hero-zh-dark.webp" />
11
+ <img src="docs/readme/hero-zh.webp" alt="FULI 复利:你的 AI 工具共用一份记忆,记着你和你的项目" width="800" />
12
+ </picture>
13
+ </p>
14
+
15
+ <p align="center">FULI 是一个插件,让你的任务穿梭在你所有的 Agent 客户端之间:Claude Code、Codex、OpenCode……它们共用一份记忆、一套品味和一支 FLA 团队。哪个合适就用哪个,换着用也不用从头交代。它不替代你的客户端,也不改动你自己的配置:你的模型、订阅、会话和设置都照旧,FULI 只作为插件加上自己的那几项;在控制台移除某个客户端,或者卸载 FULI,它加的配置就会拿掉。</p>
9
16
 
10
17
  <p align="center">
11
- <a href="README.md">English</a> · 简体中文 · <a href="https://有点.意思.com/fuli/">产品网站</a>
18
+ <a href="README.md">English</a> · 简体中文 · <a href="https://有点.意思.com/fuli/">产品网站</a> · <a href="https://github.com/JevonsCode/fuli/releases/latest">下载</a>
12
19
  </p>
13
20
 
14
21
  <p align="center">
22
+ <a href="https://github.com/JevonsCode/fuli/releases/latest"><img src="https://img.shields.io/github/v/release/JevonsCode/fuli?style=flat&label=desktop" alt="最新版本" /></a>
15
23
  <a href="https://www.npmjs.com/package/fuli-context"><img src="https://img.shields.io/npm/v/fuli-context?style=flat&logo=npm&label=fuli-context" alt="npm 版本" /></a>
16
- <a href="https://www.npmjs.com/package/fuli-context"><img src="https://img.shields.io/npm/dm/fuli-context?style=flat" alt="npm 月下载量" /></a>
24
+ <a href="https://github.com/JevonsCode/fuli/releases"><img src="https://img.shields.io/github/downloads/JevonsCode/fuli/total?style=flat&label=desktop%20downloads" alt="客户端下载量" /></a>
25
+ <a href="https://www.npmjs.com/package/fuli-context"><img src="https://img.shields.io/npm/dm/fuli-context?style=flat&label=npm%20downloads" alt="npm 下载量" /></a>
17
26
  <a href="LICENSE"><img src="https://img.shields.io/npm/l/fuli-context?style=flat" alt="许可证" /></a>
18
27
  </p>
19
28
 
20
- **换 AI 工具,留住你自己。**
21
-
22
- 复利(Fuli)就是 **compound interest**:收益再生收益。
23
-
24
- 复利的初衷,是在你和 AI 一起工作时,留住你自己的品味、个性和判断。我们相信,人不必再事事亲力亲为。
25
- 你可以腾出手来做决定、想点子,也可以歇一歇。
26
-
27
- 复利支持 Codex、Claude Code,以及其他支持 MCP 和 Skills 的 Agent 客户端。让这些客户端接入同一份 Fuli 数据,
28
- 就能继续和同一位 Agent 合作,延续它记录下的工作和相关上下文。
29
-
30
- AI 能接手的工作越来越多。复利帮你完成这段过渡,同时让你自己的判断始终居中。
31
-
32
- 复利是跨兼容 MCP 客户端的长期 Agent 协作层。让 AI 工具接入同一份可访问的 Fuli 数据,
33
- 选中同一位 Agent,就能延续它的身份、项目职责和相关工作脉络。运行 `fuli connect` 获取标准
34
- MCP 配置,有适配器的客户端还支持自动配置(Codex、Claude Code、Cursor,以及使用精简聊天工具集的 Claude
35
- 桌面版)。详见[客户端接入](docs/client-connections.md)。
36
-
37
- - **搭档留得住**:任务结束后,Agent 的职责、合作记录与工作记忆继续保留。
38
- - **上下文有边界**:按需取回项目知识、决定与偏好,保留来源、作用域和确认状态。
39
- - **需要时一起做**:协调不同专长的 Agent,通过可用且获授权的客户端或执行器开展任务,记录真实执行。
40
- - **每个任务都有负责人**:在项目目录里直接提需求,Fuli 自动登记项目并安排一位负责 Agent;回复最后一行写明谁负责、谁协助。
41
- - **三位专职随时在岗**:Jefa 管项目,Bole 做 AR(Agent Resources),负责招募与人员安排,Tonborg 帮你做判断;每个空间都自带这三位。
42
- - **按你的偏好判断**:[Tonborg](docs/judgment-and-autonomy.md) 在你设定的自主程度内协助审核、建议客户端与模型。每次判断都有记录,点赞、点踩或补一句理由,帮助它改进后续判断。
43
- - **Agent 之间直接对话**:通过[圆桌](#agent-圆桌),一个 Agent 可以直接去问另一段对话里的 Agent,往来全程留痕。
44
-
45
- 这里的“长期”指身份和上下文持续存在。Fuli 负责组织上下文与协调任务,接入的 AI 工具负责执行。
46
- 能采集、接续哪些对话取决于客户端适配器;换工具不会自动获得其他项目的私有记忆。
47
-
48
- 复利将私有对话记录、Agent 工作记忆和经过确认的知识分开管理,让持续协作形成可复用的理解。
49
- AI 负责检索、提醒、归纳和执行;人始终保留最终判断权。
50
-
51
- ## 先用起来
52
-
53
- 安装 Fuli、接入客户端,并通过一次实际工具调用完成验证。完整要求见[安装](#安装);配置格式、Hook 与排错见
54
- [客户端接入(英文)](docs/client-connections.md)。
55
-
56
- 登录、Hook 信任与人工审核仍由人确认。**“设置 → 客户端接入”显示 `已接入`(`connected`)仅代表客户端配置文件中已有当前版本的 Fuli 条目,不代表客户端进程已加载该 MCP、Hook 已送达上下文或工具已成功调用。**
57
-
58
- ### 1. 安装
59
-
60
- 两种方式,任选其一:
61
-
62
- - **下载客户端(推荐,Windows)**:到[最新版本](https://github.com/JevonsCode/fuli/releases)下载 `FULI-Setup-<版本>.exe`,双击安装,不需要终端。Node.js、Java 和图数据库都已内置,不用另装,也不需要管理员权限。第一次打开时,FULI 会找到这台电脑上的 AI 客户端,一键接入,也可以设置开机启动。已经装过 FULI 的,用它安装会直接更新,数据保留。安装包暂时没有代码签名,Windows 可能提示“已保护你的电脑”,点“更多信息 → 仍要运行”即可。
63
- - **下载客户端(macOS,Apple 芯片)**:在同一个版本里下载 `fuli-macos-arm64-<版本>.dmg`,打开后把 FULI.app 拖进「应用程序」。需要 macOS 13.5 以上;Intel 芯片的 Mac 请用终端安装。安装包暂时没有签名,第一次打开被拦下时,到「系统设置 › 隐私与安全性」点「仍要打开」。详见 [docs/macos-app.md](docs/macos-app.md)。
64
- - **用终端安装**:适合开发者和 macOS / Linux。
65
-
66
- 在具备 Node.js 24.12+ 和 Docker Compose v2 的环境下(默认容器模式;macOS / Linux 原生模式见[安装](#安装)),运行:
67
-
68
- ```bash
69
- npm install --global fuli-context
70
- fuli setup
71
- fuli open
72
- ```
73
-
74
- 设置向导会先展示计划,再修改环境。
75
-
76
- ### 2. 接入客户端
77
-
78
- - **已检测到 Codex、Claude Code、Cursor 或 Claude 桌面版:** `fuli setup` 会写入 MCP 配置及支持的
79
- Hook / Skills。只在启动时读取配置的应用须退出重开,重连后新建任务;Codex Hook 信任须在 Codex 的 `/hooks` 中人工审阅。
80
- - **其他 MCP 客户端:** 运行 `fuli connect`(或打开控制台 **设置 → 客户端接入**),将 `fuli` 条目合并到客户端 MCP 配置并保留其他服务器,再按该客户端要求重载或信任连接。`fuli connect` 只打印 JSON。
81
-
82
- ### 3. 首次实际工具调用与验证
83
-
84
- 1. 运行 `fuli status`,确认管理界面与个人图谱就绪(默认 `http://127.0.0.1:2727`)。
85
- 2. 在客户端中确认 Fuli 工具已出现,并在项目目录里**发起一次实际工具调用**(例如让 Agent 读取当前项目协作偏好或协调一个小任务),检查它是否找对项目(或登记项目并安排负责 Agent),且在缺少信息时如实询问而非编造。
86
- 3. 可选的跨工具接续:把这位 Agent 的接续指令带到连接同一份数据的另一客户端,验证它能否恢复同一位 Agent、项目和上次工作。支持范围见[Agent 对话与协作说明](docs/agent-conversations-and-collaboration.md)。
87
-
88
- 临时任务也能交给 Agent:本次源码支持在没有匹配到已登记项目时建立隔离的**临时项目**;单纯读取偏好不会创建项目,多个候选项目仍需明确选择。Fuli 会保留其任务历史,并遵循既有的 Agent 招募与执行器权限。Agent 目录提供首次任务入口,任务详情只有在收到真实执行报告后才展示完成汇总——仅分配了 Agent 或普通本机对话都不等于工作进程证据。
89
-
90
- ### 4. 排错与恢复
91
-
92
- 若安装、客户端检测或工具调用失败,见[常见失败与恢复(英文)](docs/client-connections.md#common-failure-recovery)。
93
- `fuli setup --yes --connected-only` 仅用于刷新仍保留 Fuli MCP 条目的客户端(“设置”页显示**已接入** / `connected` 或**配置有变化** / `changed`);显示**只剩技能文件**(`skills_left`)、**已移除**(`removed`)、**未接入**(`not_connected`)或新安装的客户端(无 Fuli MCP 条目)须运行完整的 `fuli setup`。
94
-
95
- [工作原理](#项目理念) · [安装](#安装) · [Agent 角色与团队](docs/employee-agents.md) ·
96
- [跨客户端验收](acceptance/cross-client-handoff.md) · [参与贡献](CONTRIBUTING.md) ·
97
- [反馈问题](https://github.com/JevonsCode/fuli/issues/new/choose)
98
-
99
- ## Agent 圆桌
100
-
101
- Agent 之间可以直接对话,就像负责人去问一位同事或子 Agent。比如 Codex 里的 Agent 可以问
102
- 某一段 Claude Code 对话里的 Agent,也可以问一位还没运行过的 FULI Agent。不需要人建房间或拉人:
103
- Agent 调用 `message_agent`,Fuli 在对方自己的客户端里以只读方式唤醒它并把回答带回来:
104
- Claude Code 会 fork 原会话;Codex 会在原对话里记下这次问答(对话正在 Codex 中打开时改用新会话)。
105
- 暂时唤不醒的消息会在对方下次开始任务时出现在它的收件箱里。
106
-
107
- Agent 之间还可以用 `agent_chat` 私聊和建群。消息是推送的:调用 `wait` 的 Agent 会立刻收到新消息,
108
- 私聊或 `@` 点名会唤醒不在等待的 Agent。聊天只负责通信,不会改变知识权重。
109
-
110
- 每一段往来都保存在本机,控制台的“圆桌”页能看到谁问了谁、通过哪个客户端、原文和回答。
111
- 工具与限制见[圆桌说明](docs/agent-roundtable.md)。
112
-
113
- ## npm 包
114
-
115
- | 包 | 状态 | 用途 |
116
- | --- | --- | --- |
117
- | [`fuli-context`](https://www.npmjs.com/package/fuli-context) | 已发布 | 个人版;个人知识、图数据库和管理界面都在本机运行 |
118
- | Fuli Server npm 包 | 开发中 | 面向团队共享场景的独立服务端;目前尚未发布 |
119
-
120
- 目前唯一可用的 npm 包是个人版 `fuli-context`。团队共享层不会包含个人品味、个性或判断偏好。
121
-
122
- ## 项目理念
123
-
124
- ### 1. 衡量复用价值,而不是知识数量
125
-
126
- 复利的核心问题是:
127
-
128
- > 如果没有 Fuli,Agent 是否需要重新学习一条已经确认、仍然有效且与当前任务相关的信息?
129
-
130
- 节点数、对话数和图谱规模不是成功指标。真正需要验证的是:历史资产能否在正确的项目、时间
131
- 和权威边界内被再次使用,并减少重复解释、修正和返工。
132
-
133
- ### 2. 每个任务都检查价值,但不强迫每个任务沉淀
134
-
135
- 一次任务可能产生:
136
-
137
- - 可复用知识:API 约定、Runbook、发布方式或项目约束;
138
- - 经验:为什么某个做法有效或失败;
139
- - 决策轨迹:候选方案、人的选择、理由和后续验证;
140
- - 判断辅助:偏好、原则、品味或个性倾向。
141
-
142
- 也可能只有临时输出、猜测或一次性选择。此时正确结果是 `retain_nothing`。复利要求每个任务
143
- 结束前做一次知识价值检查,并不是把每次聊天都变成长久记忆。
144
-
145
- ### 3. 人的权威高于 Agent 的重复判断
146
-
147
- AI 可以发现候选、指出冲突、建议公共化,也可以在得到授权后处理延迟冲突;它不能仅凭语义
148
- 相似、重复出现或自己的判断伪造人工确认。公共知识提升和有风险的项目写入必须先预览,再由
149
- 明确的人类选择触发一次性、原子执行。
150
-
151
- ### 4. 先组装上下文,再按需取证
152
-
153
- Fuli 不会在会话开始时把全部历史塞给模型。入口阶段始终加载当前任务实际生效的个人全局偏好、
154
- 精确项目偏好和显式允许传播的上级项目偏好;当任务信号表明可能需要稳定的历史事实、方法、
155
- 网址、决策、发布、部署或认证 Runbook 时,同一步骤还会在精确项目及其获授权知识来源中执行
156
- 一次小规模、有界的自动召回。
157
- 需要更多证据时,Agent 再使用聚焦查询按需检索。只有真正影响回答、实现或决策的知识才记录为
158
- 一次使用,单纯检索不会增加权重。
159
-
160
- ### 5. 保留知识演化,而不是覆盖历史
161
-
162
- 旧方案可能在当时正确,后来因条件变化被替代。Fuli 保存来源、确认权威、时间、理由、修订、
163
- 替代和负面证据,让 Agent 能解释“现在应该用什么”以及“为什么过去曾经不同”。负面反馈会
164
- 降低相关内容的排序或触发复核,但不会静默抹掉历史。
165
-
166
- ### 6. 公共知识归属上级,项目差异留在子项目
167
-
168
- 例如,酒店和机票项目可以只保存自己的 PRD、配置和领域规则,把共同的本地运行、Mock、测试
169
- 和发布方式收敛到活动平台项目:
170
-
171
- ```text
172
- 活动平台(父项目:共享 Runbook)
173
- ├── 酒店项目(子项目:酒店 PRD / 配置 / 覆盖项)
174
- └── 机票项目(子项目:机票 PRD / 配置 / 覆盖项)
175
- ```
176
-
177
- Agent 在酒店项目工作时先搜索酒店本地知识,再沿显式的 `PART_OF` 或
178
- `USES_KNOWLEDGE_FROM` 关系向上搜索允许继承的知识,最多两跳。同稳定键的子项目内容覆盖
179
- 父项目内容。项目级个人偏好默认只在精确项目生效;只有显式设置为 `descendants` 或
180
- `selected_projects` 的偏好才可沿同样的授权关系传播,并返回来源项目、路径和距离。多个同层
181
- 父项目冲突时必须交给人判断,不能靠权重选胜者。普通 `RELATED_TO` 不会自动扩大作用域;
182
- 搜索结果只返回一次性只读扩展建议,由 Agent 先询问用户。
183
-
184
- 多个子项目中相似的内容只会形成公共化候选。跨无共同父级项目出现的共同偏好也只能形成个人
185
- 全局候选,并完整保留每个项目的原文、限定词和来源。当前聚类是词法启发式信号,不是语义
186
- 等价证明;必须由人选择内容、作用域和理由后,才能生效。
187
-
188
- ### 7. 本地优先,公开层不包含个人模型
189
-
190
- 个人图谱默认留在本机。支持的客户端适配器可保存可见对话,用于私有 Agent 接续;对话记录与
191
- 结构化、可复用的确认知识分开存储,对话累积到一定量(默认 64 KB)后较早的消息折叠成摘要,召回有字节预算。凭据、临时日志
192
- 与原始命令输出不应写入知识图谱。团队共享层只承载经过确认、具有上下文和来源的项目或领域知识,不包含个人的
193
- 品味、个性和判断偏好。
194
-
195
- ## 实际怎么用:分类、作用域、项目识别与取回
196
-
197
- ### 先判断存什么,再判断存在哪里
198
-
199
- “内容类型”和“生效范围”是两个独立维度。前三类是个人协作偏好,会带有
200
- `profileAspect`;项目事实不带 `profileAspect`,也不会出现在“个人偏好”页中。
201
-
202
- | 类型 | 应该存什么 | 例子 |
203
- | --- | --- | --- |
204
- | 品味 `taste` | 用户明确喜欢或排斥的结果、风格与质量方向,适用于界面、文案、产品、架构和工程结果 | “页面少用大渐变,不要卡片套卡片” |
205
- | 个性 `personality` | 用户明确自我描述、并且预计长期稳定的工作或协作特点 | “我习惯直接沟通,希望 Agent 主动推进” |
206
- | 判断偏好 `judgment_preference` | 面对取舍时的决策条件、优先级、风险倾向和操作边界 | “方向性歧义先讨论;未明确时禁止 `git push`” |
207
- | 项目知识 | 可复用的客观项目事实、术语、需求、路由、API、架构、决策理由和 Runbook | “Fuli 的 npm 发布由 GitHub Release 触发” |
208
-
209
- 可以用四个问题快速分类:它描述的是“想要什么结果”时存品味;描述“我是怎样长期协作的”时
210
- 存个性;描述“遇到取舍时怎么决定”时存判断偏好;描述“这个系统客观上如何工作”时存项目
211
- 知识。一次性命令、临时输出、未经验证的猜测、原始聊天和凭据都不直接沉淀为确认知识。
212
-
213
- “个性”不是所有个人信息的兜底分类。只有用户明确给出的稳定自我描述可以直接带着人工依据
214
- 确认;Agent 仅从一次行为推断出的个性必须先保持 `pending`,不能伪装成人工确认。因此
215
- `/preferences` 的“个性”为空,通常表示当前范围内还没有符合这个标准的条目,而不是沉淀
216
- 失败。像“文案简洁”更可能是品味,“未授权不推送”更可能是判断偏好。需要明确沉淀时,可以
217
- 直接说:`这是我的长期协作个性,请作为个人全局偏好保存:我习惯直接沟通。` Agent 推断的
218
- 候选可在 `/preferences` 或 `/flreview` 中由用户确认、纠正或失效。
219
-
220
- ### 全局、项目级和公共层
221
-
222
- | 范围 | 何时使用 | 写入关键字段 | 取回规则 |
223
- | --- | --- | --- | --- |
224
- | 个人全局偏好 | 在无关项目中也应该保持不变 | `targetKind: "personal"`,不传 `personalProjectId`,设置 `profileAspect` | 每个任务都加载 |
225
- | 项目级个人偏好 | 协作方式属于一个项目或项目族 | 同上,同时传精确的 `personalProjectId`;默认 `local_only`,不向子项目继承;需传播时显式使用 `descendants` 或 `selected_projects` | 精确项目优先;仅按显式继承模式沿获授权关系传播,冲突不按分数自动裁决 |
226
- | 项目知识 | 事实只属于一个项目,或应由某个上级项目统一维护 | `targetKind: "personal"`,传 `personalProjectId`,不设置 `profileAspect` | 先查当前项目,再沿获授权的 `PART_OF` / `USES_KNOWLEDGE_FROM` 最多向上两跳 |
227
- | 团队公共知识 | 经人工确认、确实需要共享的项目或领域知识 | `targetKind: "project"`,并经过预览/审核 | 只有明确订阅或选择的公共项目可见;个人偏好永不进入这一层 |
228
-
229
- 判断作用域时问一句:**换到完全无关的项目,这条协作偏好还应该改变 Agent 的行为吗?**
230
- “是”就存个人全局;“否,只在 Fuli 项目或项目族”就存项目级偏好,并明确是否允许向子项目
231
- 传播。客观项目事实不要因为多个项目都可能用到就改存个人全局;应放在明确的上级或知识源
232
- 项目,再建立有方向的授权关系。全局和项目级存在同一 `attributes.preferenceKey` 时,
233
- 确认权威必须先裁决;权威相同时才由精确项目版本覆盖全局版本。
234
-
235
- ### Fuli 怎么识别当前项目
236
-
237
- Fuli 只匹配已经登记在“个人项目”中的稳定 `project_id`,不根据目录内容做模糊猜测。通常让
238
- `project_id` 与仓库目录名一致,例如仓库 `/workspace/fuli` 对应项目 `fuli`。标准调用只传
239
- 当前工作目录,解析顺序如下:
240
-
241
- 1. 向上找到最近的 Git 仓库根,从 `.git/config`(worktree 读其公共目录)读取 `origin`
242
- 远程地址,与某一个已登记项目记录的仓库来源 URL 完全相同时命中;同一仓库的 ssh 与 https
243
- 写法视为相同。因此任何目录名的克隆或 worktree 都解析到原项目(`git_remote`)。
244
- 2. 否则按仓库目录名与已登记 `project_id` 完全相同时命中;Codex worktree 用 `.git` 指向的
245
- 原始仓库名。记录了另一个仓库地址的项目不会因为同名被命中(`repository_remote_conflict`)。
246
- 3. 当前目录名与已登记项目 ID 完全相同时命中。
247
- 4. 如果当前目录是工作区根,并且正好只有一个已登记的直接子目录带 `.git`、`package.json`、
248
- `pyproject.toml`、`Cargo.toml` 或 `go.mod`,命中这个唯一子项目。
249
- 5. 多个候选返回 `ambiguous`,没有候选返回 `unmatched`(同一远程地址被多个项目记录也算多个候选);
250
- 两种情况都不会应用项目级偏好,也不会猜一个项目。
251
-
252
- 第一次进入尚未登记、但身份明确的仓库时,已安装的沉淀 Skill 可以在首次项目级写入前通过
253
- `upsert_personal_project` 创建最小的本机私有项目;它不会自动创建或订阅公共项目。若工作区
254
- 有多个候选,应进入精确项目目录运行 Agent,或先在“个人项目”中明确选择和登记。
255
-
256
- ### Agent 什么时候调用什么
257
-
258
- 正常使用时,不需要手工调用 MCP 工具:在项目目录中向 Agent 提任务即可。Fuli 已有 Claude
259
- Code、Codex 和 Cursor 生命周期适配器。已加载、获信任的入口 Hook 提供 `begin_task_context`
260
- 上下文时,直接使用,不重复 fallback。Cursor 的 Hook 建立持久任务,但偏好与角色上下文
261
- 仍由 Agent 取回。没有收到 Hook 上下文时,在每个任务开始调用一次:
262
-
263
- ```json
264
- {
265
- "tool": "get_collaboration_preferences",
266
- "arguments": {
267
- "projectPath": "/workspace/fuli",
268
- "taskPrompt": "修复 npm 发布流程,并沿用这个项目已有的发布约定"
269
- }
270
- }
271
- ```
272
-
273
- 命中后,返回值中的关键部分类似:
274
-
275
- ```json
276
- {
277
- "context": {
278
- "personal_project_id": "fuli",
279
- "project_resolution": {
280
- "status": "matched",
281
- "basis": "repository_root",
282
- "personal_project_id": "fuli"
283
- }
284
- },
285
- "effective_preferences": ["个人全局偏好 + fuli 的精确项目偏好"]
286
- }
287
- ```
288
-
289
- 入口返回的 `task_knowledge_recall` 没有回答稳定项目事实时,再用 1 至 4 条面向动作、产物、目标
290
- 系统或标识符的短查询检索;不要把整段用户请求原样当成唯一查询:
291
-
292
- ```json
293
- {
294
- "tool": "search_current_project_knowledge",
295
- "arguments": {
296
- "projectPath": "/workspace/fuli",
297
- "queries": ["npm 发布 Runbook", "GitHub Release 触发条件"],
298
- "includePending": false
299
- }
300
- }
301
- ```
302
-
303
- 任务结束时,Hook 模式调用 `checkpoint_task_knowledge`:只有少量、可复用且有证据的内容才用
304
- `capture_candidates`;否则使用 `retain_nothing`。Prompt fallback Agent 遵守相同判断标准,并
305
- 通过 `capture_session_knowledge` 写入。写个人偏好时设置正确的 `profileAspect` 和稳定的
306
- `attributes.preferenceKey`;写项目事实时不设置 `profileAspect`。如果“设置”中的自动沉淀已
307
- 关闭,自动写入会返回 `capture_disabled`,不会产生任何类别的条目:会话原文、checkpoint、知识和
308
- 偏好候选、知识使用记录、查看记录,以及经由 Agent 上报的反馈或纠正都会停止。记录设置读取失败时
309
- 自动写入同样停止(`reason: policy_unavailable`)。你在 FULI 控制台里明确提交的修改和显式的
310
- `新项目:` 仍会保存,查询已有知识不受影响。关闭期间写下的会话轮次只留一条不含内容的跳过标记,重新打开后
311
- 也不会补记。
312
-
313
- 记录范围还可以按项目选择。`projectMode` 为 `all`(默认)、`all_except`(配合
314
- `excludedProjectIds`)或 `selected`(配合 `selectedProjectIds`);`unregisteredDirectories`
315
- 决定没有登记为 FULI 项目的目录记不记(`selected` 下默认 `skip`,其余默认 `capture`)。目录按
316
- 任务入口相同的规则解析为项目,所以同一仓库的 worktree 就是同一个项目。未开启的项目返回
317
- `reason: project_off`,未登记目录返回 `project_unregistered`,每轮任务回执末尾都会写明原因以及
318
- 明确提交的修改仍会保存,例如「此项目未开启记忆;你明确提交的修改仍会保存」。关闭某个项目不会隐藏或删除它已有的记录,`projectsOffSince` 记下它从何时
319
- 停止记录。Agent 用 `get_capture_policy` 读取(传 `projectPath` 可得知当前项目是否记录),用
320
- `update_capture_policy` 修改前必须先复述改动并得到用户确认;设置页使用 `PATCH /api/capture-policy`。
321
- 在会话里说「这次别记」只暂停这一个会话、立即生效、无需确认:Agent 只带 `sessionPaused: true` 和当前
322
- `taskContextToken` 调用 `update_capture_policy`,此后本会话每轮回执都写「本会话已暂停记录(自 HH:mm 起)」
323
- (`reason: session_paused`)。之前的记录保留,该会话派出的 worker 一并暂停;说「继续记」(`sessionPaused: false`)
324
- 从此恢复,暂停期间的内容不会补记。暂停状态存在本地运行目录,会话结束即失效。
325
-
326
- 要让某个会话整体停用 FULI,由用户自己输入 `/fuli stop`(Claude Code 和 Cursor,setup 会安装 `fuli` 命令 Skill)
327
- 或 `fuli stop`(所有客户端;Codex 不支持自定义斜杠命令)。这一行由提示词 Hook 直接答复,模型看不到:此后该会话不再注入
328
- 记忆、偏好和召回,其 Agent 自己发起的 FULI 读取(搜索、Agent 记忆、对话)也被拒绝,不再自动记录,也不再自动发起协作(worker、借调、其他 Agent、角色任务);其他会话、本地服务和已有记忆不变。
329
- `fuli start` 在现有设置内重新启用(暂停或更严格的全局、客户端、项目设置照样生效),`fuli restart` 还会让下一轮重新拿到完整
330
- 上下文,`fuli status` 显示本会话和默认设置;停用期间的对话不会补录。已发给模型的上下文无法撤回,需要完全隔离请新开会话。
331
- 只有任务令牌能说明一次工具调用属于哪个会话(Claude Code 的工具连接跨 /clear 保留,Codex、Cursor 的连接不带会话),所以某个客户端有任一会话停用期间,它不带任务令牌的工具调用一律拒绝,不把记忆提供给可能正是已停用的那个会话。Agent 传入手上已有的 `taskContextToken`(入口、搜索和团队类读取都接受),其他窗口照常工作。
332
- 在客户端启动的 shell 里也可以运行同一开关(`!fuli session stop`),因此能运行 shell 的 Agent 也能改它(与能读写本地文件同等信任);控制台和 `fuli mcp --call` 仍可为你读取;`fuli session default off` 让新会话默认不启用、
333
- 需显式启用,已打开的会话保持原状。
334
-
335
- 本地可先运行下面两个契约测试,验证 README 说明和项目路径解析仍与实现一致:
336
-
337
- ```bash
338
- npm run test:node -- test/acceptance-docs.test.js test/project-path-context.test.js
339
- ```
340
-
341
- ## Agent 交互时序
342
-
343
- 下面是日常任务的简化时序。更完整的项目继承、使用计数、写入预览和来源标记流程见
344
- [智能体调用时序图](acceptance/智能体调用时序图.md)。
29
+ <h3 align="left">一切都是能自动则自动,一切执行就交给 FLAs 吧。你做好判断,做好领头羊,领着你的 FLAs 大军披荆斩棘,或者去喝杯咖啡休息休息~享受你自己经验带给你自己的复利吧。</h3>
30
+
31
+ <p align="left">项目的简历、FLAs 的招募,如果你不想关心,它们都是自动的,你唯一要做的就是把握方向。FLAs 可以自动带着上下文和各种工具穿梭在各个 Agent 客户端,无论是高等级模型还是低等级模型,在这里都可以发挥作用。</p>
32
+
33
+
34
+
35
+ 每次任务只取回用得上的那一小份。你的判断和经验一直在累积,FULI 越用越懂你,这就是复利。
36
+ 慢慢地,AI 做出来的东西也带上了你的品味。
37
+
38
+ ## 它能做什么
39
+
40
+ <table>
41
+ <tr>
42
+ <td width="50%" valign="top">
43
+ <img src="docs/readme/card-memory-zh.webp" alt="Claude Code、Codex 和 OpenCode 接入同一个 FULI" width="460" />
44
+ <h3 align="center">所有客户端共用一份记忆</h3>
45
+ 点一下就接入 Claude Code、Codex、OpenCode 或 Cursor。在一个客户端里说过的规矩,换到另一个也还在。
46
+ </td>
47
+ <td width="50%" valign="top">
48
+ <img src="docs/readme/card-team-zh.webp" alt="三位 FLA 在圆桌里一起评审一个修复" width="460" />
49
+ <h3 align="center">FLA 团队,在圆桌上对话</h3>
50
+ 每个项目有一位负责的 Agent(FLA),有名字、职业和自己的工作记忆;活儿需要时,几位 FLA 组成小组。它们在圆桌里互相评审、测试、交接,每一句你都看得到。
51
+ </td>
52
+ </tr>
53
+ <tr>
54
+ <td width="50%" valign="top">
55
+ <img src="docs/readme/card-tonborg-zh.webp" alt="等你确认的知识,以及交给 Tonborg 确认的开关" width="460" />
56
+ <h3 align="center"><img src="docs/readme/fla-tonborg-inline.webp" alt="" width="28" align="absmiddle" /> Tonborg 替你确认</h3>
57
+ 新知识要等一句确认。打开「交给 Tonborg 确认」,它按你的偏好确认日常的条目,拿不准的留给你,每次都写下理由,点赞或点踩它下次就改。
58
+ </td>
59
+ <td width="50%" valign="top">
60
+ <img src="docs/readme/card-tokens-zh.webp" alt="每个成功任务的 token:用 FULI 是 0.81 倍" width="460" />
61
+ <h3 align="center">越用越省 token</h3>
62
+ 即将发布的 0.25.0 实测:同样的任务,用 FULI 每个成功任务花的 token 是不用时的 0.81 倍,72 个任务通过 70 个。省下的来自代码里没有、只在你话里的事实。
63
+ </td>
64
+ </tr>
65
+ </table>
66
+
67
+ 自带四位 FLA:
68
+
69
+ <table>
70
+ <tr>
71
+ <td width="25%" align="center" valign="top">
72
+ <img src="docs/readme/fla-jefa.webp" alt="Jefa" width="96" /><br />
73
+ <b>Jefa</b> 是你的项目经理。
74
+ </td>
75
+ <td width="25%" align="center" valign="top">
76
+ <img src="docs/readme/fla-bole.webp" alt="Bole" width="96" /><br />
77
+ <b>Bole</b> 招人,给每个项目排人手。
78
+ </td>
79
+ <td width="25%" align="center" valign="top">
80
+ <img src="docs/readme/fla-tonborg.webp" alt="Tonborg" width="96" /><br />
81
+ <b>Tonborg</b> 替你确认,推荐客户端和模型。
82
+ </td>
83
+ <td width="25%" align="center" valign="top">
84
+ <img src="docs/readme/fla-astro.webp" alt="Astro" width="96" /><br />
85
+ <b>Astro</b> 接待还没归属项目的对话。
86
+ </td>
87
+ </tr>
88
+ </table>
89
+
90
+ ## 怎么工作
345
91
 
346
92
  ```mermaid
347
- sequenceDiagram
348
- autonumber
349
- actor U as 用户
350
- participant A as Agent
351
- participant L as 生命周期接入
352
- participant F as Fuli MCP
353
- participant G as 本地图谱
354
-
355
- U->>A: 在当前项目提交任务
356
- alt Claude Code / Codex(已提供 Hook 上下文)
357
- L->>F: begin_task_context(projectPath, taskPrompt)
358
- F-->>A: 生效偏好、精确项目、有界召回和任务令牌
359
- else 未提供上下文(Prompt fallback,含 Cursor)
360
- A->>F: get_collaboration_preferences(projectPath, taskPrompt)
361
- F-->>A: 生效偏好、精确项目和有界召回
362
- end
363
-
364
- A->>A: 检查 task_knowledge_recall
365
- opt 仍需历史上下文且自动召回未回答
366
- A->>F: 使用聚焦查询调用 search_current_project_knowledge
367
- F->>G: 先查子项目,再查获授权的上级
368
- G-->>A: 有界正文、状态、来源和历史
369
- opt 知识实际影响结果
370
- A->>F: record_knowledge_usage
371
- end
372
- end
373
-
374
- A->>A: 完成实现、验证或回答
375
- opt 产生决策、反证或失效证据
376
- A->>F: 记录理由或知识反馈
377
- end
378
- opt 有值得保留的内容(候选、决策、有意义的工作记录)
379
- A->>F: checkpoint_task_knowledge
380
- F->>G: capture_candidates
381
- end
382
-
383
- alt 已加载并获信任的 Claude Code / Codex Stop Hook
384
- L->>F: verify_task_checkpoint
385
- F-->>L: 日常任务如实收尾为 retain_nothing / reported,其余给出提醒
386
- else Cursor 或没有 Stop Hook 的 Agent
387
- Note over A,F: 遵循同一契约。日常兜底任务在下一次任务入口时收尾
388
- end
389
- A-->>U: 返回结果与实际使用的 Fuli 来源
93
+ flowchart LR
94
+ U[你] -->|在项目里提需求| A[Agent 客户端]
95
+ A -->|任务开始| F[你电脑上的 FULI]
96
+ F -->|生效偏好和一小份召回| A
97
+ A -->|还缺什么再查| F
98
+ A -->|值得留的才写回| F
390
99
  ```
391
100
 
392
- ## 外部知识库只读接入
393
-
394
- 一个第三方知识库连接可以同时绑定到一个或多个已经存在的个人项目,不需要授予 Fuli 对源系统
395
- 的写权限。每个目标项目独立保存检索模式、同步游标和错误状态;连接页支持多选绑定、连通性
396
- 检查、手动同步、解绑,以及按项目设置冲突处理开关。
397
-
398
- | 连接器 | 读取路径 | 当前边界 |
399
- | --- | --- | --- |
400
- | MCP | Resources `list/read`;可配置 `search` / `fetch` 工具 | 默认方式;HTTPS、回环 HTTP 或 stdio |
401
- | Notion | 页面 Markdown 与 Data Source 查询 | 当前 `2026-03-11` API;必须明确页面或数据源 ID |
402
- | 飞书 / Lark | Wiki 节点、搜索与 Docx 纯文本 | 当前只提取 Docx;搜索可能需要 user access token |
403
- | RAG Retrieval API | Dify 外部知识库兼容检索协议 | 仅实时;适合 Dify 兼容端点或适配后的 RAGFlow 等系统 |
404
- | 可信自定义代码 | 本地 ESM `sync` / `retrieve` 契约 | 用户显式安装的可信代码,不是沙箱 |
405
-
406
- <a id="connect-external-knowledge"></a>
407
-
408
- ### 给项目连接一个或多个知识库
409
-
410
- 同一个个人项目可以拥有多个独立知识库绑定,同一个知识库连接也可以绑定多个个人项目。每次
411
- 提交表单都会新增一个连接,不会覆盖已有连接;连接来源只保存一次,项目目标分别保存检索模式、
412
- 同步状态和错误。已有连接可用“绑定项目”继续增删目标。
413
-
414
- 1. 先在“个人项目”中创建或确认目标项目。
415
- 2. 如果来源需要令牌,在启动 Fuli 的环境中设置令牌,再启动或重启服务。连接配置只填写
416
- 环境变量名,例如先执行 `export PROJECT_KB_TOKEN='...'`,再执行 `fl restart`。
417
- 3. 打开 `http://127.0.0.1:2727/connections`,在“外部知识库”中填写连接名称、连接器、
418
- 绑定项目(可多选)和检索模式。
419
- 4. MCP HTTP 填写最终端点 URL(不跟随跨源重定向)和可选的令牌环境变量名;MCP stdio 填写命令与参数;Notion
420
- 填写令牌环境变量名以及 Page IDs 或 Data Source IDs;飞书 / Lark 填写令牌环境变量名、
421
- 区域和明确的 Space ID、根节点 Token 或 Node Tokens;RAG Retrieval API 填写 Dify 兼容
422
- 端点、知识库 ID 和可选令牌环境变量名;自定义连接器填写受信任本地 ESM 模块与来源 JSON。
423
- 5. 点击“添加连接”,再点击“检查”。`mirror` 或 `hybrid` 绑定检查成功后可点击“同步”;
424
- `live` 绑定直接在 Agent 查询时读取来源。
425
- 6. 连接建立后可点击“绑定项目”,多选增删项目并为每个项目设置检索模式。
426
-
427
- 绑定后,项目图谱会显示一个“外部知识源”节点以及“使用外部知识”关系。这个节点是连接配置的
428
- 只读投影;实时正文仍只在 Agent 调用 `search_connected_knowledge` 时按当前项目检索,不会因
429
- 显示在图谱里而被复制到本地。
430
-
431
- 三种检索模式的差异:
432
-
433
- - `live`(仅实时):查询时直接读取第三方,不在 Fuli 中保存正文镜像;依赖来源在线。
434
- - `mirror`(仅同步):手动把只读正文镜像到绑定的个人项目,Agent 查询本地图谱。
435
- - `hybrid`(同步 + 实时):同时使用本地镜像和来源实时结果;连接器同时具备两种能力时推荐。
436
-
437
- 绑定支持 `live`、`mirror` 和 `hybrid`。镜像正文只写入绑定的个人项目,并统一标记为
438
- `observed`、`pending`、`restricted`、`local_only`。配置只保存环境变量名称,不保存明文凭据;
439
- 连接器契约中不存在第三方源写入。疑似包含凭据的单个文档会被跳过并返回数量,不进入图谱或
440
- Agent 上下文。
441
-
442
- <a id="external-knowledge-conflict-policy"></a>
443
-
444
- ### 冲突策略
445
-
446
- 冲突策略有一个对所有个人项目生效的默认值;个别项目可以单独设置为例外(连接 → 冲突策略)。
447
- 它对该项目的个人图谱、全部外部绑定和明确选择的公共项目统一生效:
448
-
449
- - “在 Agent 对话中询问”是内置默认值。Agent 并列展示相互冲突的正文、来源和作用域,由用户选择。
450
- - “允许 AI 本次判断”允许 Agent 为当前回答选择更可信或更新的来源,但必须说明判断依据;它
451
- 不会确认、失效、覆盖或写回任何知识。
452
-
453
- 在项目目录中可以直接要求 Agent:`结合当前项目和已连接知识库查找支付回调规范;如果来源冲突,分别列出并让我决定。`
454
-
455
- `search_connected_knowledge` 分开返回个人图谱、每个外部绑定和调用方明确选择的公共项目,
456
- 不会先压成无来源正文。公共项目聚合目前是 **Beta**。Agent 发现实质冲突时,默认在对话中
457
- 展示并询问用户;可选的“Agent 判断”只对本次回答生效,不能确认、失效或改写任何来源。
458
- 外部知识直接绑定到公共空间或经审核提升到公共空间、后台定时同步、Webhook 和完整删除对账仍是 **TODO**。
459
-
460
- 完整边界见[外部知识库只读接入架构](docs/external-knowledge-architecture.md),公共空间与个人图谱的联动见[公共空间与个人图谱联动架构](docs/public-personal-architecture.md)。
461
-
462
- ## 当前能力与证据边界
463
-
464
- 已经由实现和自动化测试覆盖的核心机制包括:
465
-
466
- - 本地个人空间、精确项目作用域和选择性上级继承;
467
- - 偏好确认、延迟冲突处理、修订历史和来源标记;
468
- - 有界的任务提示自动召回、聚焦的按需检索和实际使用审计;
469
- - 任务入口、任务末尾知识检查,以及 Claude Code、Codex、Cursor 的客户端适配(Hook 覆盖范围见下文);
470
- - 决策选项、决策理由和首次记录时附带的验证结果;
471
- - 知识使用事件、负面反馈和内容代际隔离;
472
- - 支持暂停、恢复和水位线的持久化分范围知识复核;
473
- - 公共知识候选发现,以及预览令牌保护的原子提升;
474
- - MCP、Notion、飞书 / Lark、Dify 兼容 RAG Retrieval API 和可信自定义代码的只读多项目绑定与聚合检索。
475
-
476
- 0.20 新增(公开预览版 `0.20.0-beta`,详见[发布说明](docs/releases/0.20.0.md)):
477
-
478
- - **项目与人员**:没有归属的会话先交给 Astro,Jefa 负责分诊,同一话题反复出现(累计 3 个会话、跨至少 2 天)时,Astro 会问你要不要为它成立项目、招人维护。项目都有简介,Agent 都有职业,Bole 按职业招聘。
479
- - **任务**:可以只指派不开工(backlog);在任务详情里可以停止、重试、回看任何一次运行。临时故障只在确定没发出指令时才自动重试。
480
- - **待决策**:Agent 需要你时,先在当前会话里问你。需要等你稍后处理的请求进「待决策」页,你的回复会送回发起请求的 Agent。
481
- - **圆桌**:除了问答(`message_agent`),Agent 之间还能私聊和群聊(`agent_chat`),支持推送和 `wait` 等待;控制台实时显示。
482
- - **项目间记忆**:用权重(有关系 / 常往来 / 密切)表示一个项目能从另一个项目取多少记忆。权重不授予权限。
483
- - **更省 Token**:任务入口更小,共享规则按需读取,长偏好分页读完,Stop Hook 直接收尾日常任务,省掉一次模型往返。
484
- - **控制台**:六个入口(工作台、Agents、对话、项目、记忆、设置),适配手机;按住 Alt / Option 点任意状态或名词就能看到解释。
485
- - **Windows**:从发布页下载 `FULI-Setup-<版本>.exe` 双击即可为当前用户安装(不用终端、不要管理员;暂未签名,SmartScreen 会提示一次)。安装版自带 Update-Fuli、Rollback-Fuli、Uninstall-Fuli,数据都会保留;管理页的「更新到 vX」会下载并校验发布的 Windows 安装包,一键完成同样的更新。
486
-
487
- 仍需与“已经证明”区分的内容:
488
-
489
- - `FULI_ALIGNMENT_BENCHMARK.md` 中 A/B 阈值是验收约定;只有完成足量、同条件的真实配对任务
490
- 后,才能声称 Fuli 已降低重复解释或返工;
491
- - Benchmark 的测试项目和对话是明确标注的 **MOCK / 合成数据**,不是用户或生产数据;
492
- - 当前决策工具可在首次记录时附带验证,但还没有面向既有 `Decision` 单独追加不可变验证结果
493
- 的专用入口;
494
- - 安装文件不等于宿主已加载、信任或执行。Claude Code 和 Codex 适配器会生成入口/Stop Hook
495
- 配置,Codex 信任审阅仍由用户完成;Cursor 使用任务入口 Hook 和有限 Stop 提醒,不能表述为
496
- 同等的无条件 Stop Gate。三个真实客户端的普通输入触发仍需实际验收;
497
- - 聚合检索中的选定公共项目仍是 Beta;外部知识提升到公共空间和后台增量同步尚未实现。
101
+ 任务开始时只带上生效的偏好和几条相关事实。还缺什么,Agent 自己再查;做完以后,只写回下一个任务用得上的东西。
498
102
 
499
103
  ## 安装
500
104
 
501
- 准备:
105
+ FULI 在你的电脑上跑一个小服务和一个控制台。
502
106
 
503
- - Node.js 24.12 或更高版本;
504
- - 默认容器模式需要 Docker Compose v2,Docker Desktop 或 Rancher Desktop 均可;
505
- - macOS / Linux 可选择不使用虚拟机的原生模式;它需要 Java 21 和 `uv`(Python 3.12);
506
- - 内存紧张的 Mac 推荐
507
- `fuli setup --runtime-mode native --memory-profile low --adaptive-memory`。默认仍是兼容性更高的容器模式,不会自动强制切换。
107
+ **桌面客户端(推荐)。** 到[最新版本](https://github.com/JevonsCode/fuli/releases/latest)下载:
508
108
 
509
- 全局安装并初始化:
510
-
511
- ```bash
512
- npm install --global fuli-context
513
- fuli setup
514
- ```
515
-
516
- 也可以一行安装,会先检查 Node.js 版本:
517
-
518
- ```bash
519
- curl -fsSL https://xn--8ovp9s.xn--m8txu.com/fuli/install.sh | sh
520
- ```
521
-
522
- Windows PowerShell:`irm https://xn--8ovp9s.xn--m8txu.com/fuli/install.ps1 | iex`。
523
-
524
- `fuli setup` 会先展示操作计划并请求确认,然后检查容器运行时、初始化本机
525
- Graphiti / Neo4j、创建个人空间、安装配套 Agent Skills,并为检测到的 Agent 注册 `fuli`
526
- MCP。默认只连接个人 Provider,不会模拟团队共享服务。
527
-
528
- 初始化完成后:
529
-
530
- ```bash
531
- fuli open
532
- ```
533
-
534
- 管理界面默认位于 `http://127.0.0.1:2727`。Windows 上 Hyper-V、WSL 和 winnat 会保留一些端口段,且每次开机可能不同
535
- (`netsh interface ipv4 show excludedportrange protocol=tcp` 可查看)。首次设置会避开这些端口段;之后每次 `fuli start`、
536
- `restart` 和 `setup` 都会再查一遍:Fuli 的端口如果被保留了,或者管理界面的端口被 Windows 拒绝、被别的程序占用,就自动换到最近的
537
- 可用端口,先备份 `runtime-settings.json` 再保存新端口,照常启动,并只提示一次(命令输出、桌面客户端和管理界面里)。如果那个端口上
538
- 是另一个正在运行的 Fuli,它不会换走,也不会再启动一个。Windows 托盘的「换一个端口」仍可按需改用默认端口附近的可用端口。
539
- 已打开的 Agent 会话要重开后,Fuli 链接才会指向新地址。
540
-
541
- “设置”页集中管理 Fuli 使用的 7 个本机端口、图数据库运行方式、局域网访问、自动沉淀、
542
- Agent 使用、界面语言和资源刷新频率。端口、运行方式或局域网设置保存后执行 `fuli restart`
543
- 生效;资源刷新频率立即生效。
544
- 同页按设定间隔采集管理服务、Provider、Neo4j、应用文件和本机数据的真实内存/磁盘占用;
545
- 内存每次重采,磁盘最多每分钟重采一次,并分别显示采样时间。
546
- 无法取得运行进程数据时会明确显示为不完整,不使用模拟值。原生模式会计入 Provider 和
547
- Neo4j 进程;容器模式不把共享容器虚拟机开销计入 Fuli 合计。两种模式都不含浏览器标签页。
548
-
549
- ## CLI
550
-
551
- 全局安装提供两个等价命令:`fuli` 和短别名 `fl`。
552
- CLI 的帮助、交互提示、状态和错误信息固定使用英文,不跟随网页或系统语言;路径、空间名等
553
- 用户数据会按原值显示。
554
-
555
- | 命令 | 用途 |
109
+ | 系统 | 文件 |
556
110
  | --- | --- |
557
- | `fuli --help` / `fuli -h` | 显示所有公开命令及其可用参数 |
558
- | `fuli --version` / `fuli -v` | 显示当前安装的 Fuli CLI 版本 |
559
- | `fuli setup [选项]` | 初始化 Provider、管理界面、Agent 接入和 Skills;可重复执行 |
560
- | `fuli start [选项]` | 检查 Agent 接入后启动 Provider 和管理界面;可选择启动后打开浏览器、重建容器或启用 LAN 访问 |
561
- | `fuli stop [--data-dir DIR]` | 停止服务并保留数据 |
562
- | `fuli restart [选项]` | 使用与 `start` 相同的运行参数重启本机服务 |
563
- | `fuli status [--json] [--data-dir DIR] [--port PORT]` | 查看管理界面、个人图谱和公共服务状态;`--json` 输出机器可读结果 |
564
- | `fuli open [--data-dir DIR]` | 在默认浏览器中打开当前管理界面 |
565
- | `fuli graph export --output DIR [--mode container\|native]` | 把当前图数据导出为可校验、可复制的离线备份包 |
566
- | `fuli graph import --input DIR [--target-mode container\|native] [--yes]` | 校验备份并替换目标图数据;导入前自动保留回滚包 |
567
- | `fuli graph migrate --to native [--yes]` | 把容器图谱迁移到原生模式;节点和关系数量完全一致才算成功 |
568
- | `fuli update [setup 选项]` | 更新 npm 包并刷新本机接入 |
569
- | `fuli uninstall [--yes] [--data-dir DIR]` | 清理 Agent 接入和服务,保留知识数据和 Neo4j 数据卷 |
570
-
571
- 常用示例:
111
+ | Windows | `FULI-Setup-<版本>.exe`,不用终端,也不用管理员权限。 |
112
+ | macOS(Apple 芯片,13.5 以上) | `fuli-macos-arm64-<版本>.dmg`,把 FULI 拖进「应用程序」。 |
572
113
 
573
- ```bash
574
- fuli --version
575
- fuli status
576
- fuli restart --rebuild
577
- fuli start --lan
578
- fuli graph export --output "$HOME/Backups/fuli-graph"
579
- fuli stop
580
- ```
114
+ 第一次打开时,FULI 会找出这台电脑上的 AI 客户端,点一下就能接入。安装包还没签名,两个系统第一次都会拦一下,
115
+ 放行的两步见[安装与运行](docs/install.zh-CN.md)。
581
116
 
582
- 连接已部署的 `fuli-workspace` 服务:
117
+ **服务器、虚拟机和云端。** 没有桌面的环境,以及 Intel 芯片的 Mac 和 Linux,用 npm 安装(需要 Node.js 24.12 以上):
583
118
 
584
119
  ```bash
585
- fuli connect-workspace \
586
- --url http://127.0.0.1:8789 \
587
- --token-file /path/to/private-token
588
- fuli restart
120
+ npm install --global fuli-context
121
+ fuli setup
122
+ fuli open
589
123
  ```
590
124
 
591
- 连接命令会先验证服务发现、协议版本和令牌作用域,再以 `0600` 权限原子更新本机运行配置;
592
- 它不会在输出中显示令牌、令牌文件路径或远端 principal ID。非本机服务必须使用 HTTPS。
593
- 当前 `fuli-workspace-v1` 适配器开放发现、显式订阅和查询;发布、投稿、审核只会在相应协议映射
594
- 真正实现后才显示为可用。
595
-
596
- `start` 和 `restart` 支持 `--data-dir DIR`、`--personal-space NAME`、`--port PORT`、
597
- `--open`、`--rebuild`、`--lan` 和 `--no-lan`。未显式传入端口或局域网参数时会使用“设置”
598
- 页保存的值。其中 `--lan` 会让管理界面监听
599
- 私有 IPv4 局域网地址,并在终端输出可访问地址、用户名 `fuli` 和本次启动生成的临时访问
600
- 口令。默认启动仍只监听 `127.0.0.1`;内部 Provider、Neo4j Browser 和 Bolt 不会随
601
- `--lan` 开放。局域网模式使用 HTTP Basic Auth,只适合可信家庭或办公 Wi-Fi,不等同于
602
- HTTPS 公网部署。
603
- `fuli start` 启动前会只读检查已检测到的 Agent 的 MCP、Skill、Codex bootstrap 和 Claude
604
- 生命周期接入。如果有缺失或过期,它仍会启动本机服务,但会提示执行 `fuli setup`;不会在
605
- 后台隐式修改接入配置。
606
-
607
- `setup` 和 `update` 支持:
608
-
609
- | 选项 | 用途 |
610
- | --- | --- |
611
- | `--yes` | 跳过确认,适合无人值守执行 |
612
- | `--codex-only` | 只接入 Codex |
613
- | `--data-dir DIR` | 使用指定的数据与配置目录 |
614
- | `--personal-space NAME` | 设置个人空间名称;默认是 `Personal` |
615
- | `--port PORT` | 设置管理界面端口;默认是 `2727` |
616
- | `--runtime-mode container\|native` | 选择容器或原生进程;默认 `container`,原生模式当前支持 macOS / Linux |
617
- | `--memory-profile low\|balanced` | 选择 Neo4j 内存档位;首次安装默认使用 `balanced` |
618
- | `--adaptive-memory` | 启用按需唤醒和分阶段休眠;保存后由管理服务协调 |
619
- | `--no-adaptive-memory` | 关闭按需休眠,让图服务保持运行 |
620
- | `--skip-agents` | 不修改 Agent 配置或 Skills |
621
- | `--connected-only` | 仅刷新已有 Fuli MCP 配置的客户端;update 自动使用此选项 |
622
- | `--no-start` | 初始化 Provider,但不启动管理界面 |
623
- | `--allow-provider-downgrade` | 接受更低版本的原生 Provider,例如从本机 `rc` 版换到公开的 `beta` 版;先备份数据目录 |
624
- | `--personal-only` | 只使用个人 Provider;默认模式 |
625
- | `--with-dev-public` | 同时启动开发用公共 Provider,仅用于开发或联调 |
626
-
627
- `low` 档使用 128 MiB 初始堆、256 MiB 最大堆和 64 MiB 页缓存;`balanced` 档分别使用
628
- 256 MiB、512 MiB 和 256 MiB。低内存档不会设置容器硬内存上限,会在降低常驻内存的同时
629
- 为 Neo4j 原生内存留出余量。批量写入、大范围图遍历或高并发时,垃圾回收和磁盘读取可能
630
- 增多,但事务语义、存储格式和数据卷不变。如果这些负载变慢或因堆不足而失败,可执行
631
- `fuli setup --memory-profile balanced --yes` 回退。选择的档位会被保存,后续 setup、update、
632
- start 和 restart 会继续沿用。
633
-
634
- 自适应内存模式是独立于 Neo4j 内存档位的生命周期策略。启用后,管理服务保持轻量常驻:
635
- 实际 MCP 工具、MCP 资源或管理界面的图谱请求会先取得运行租约并按需唤醒服务;最后一个
636
- 租约释放后,个人 Provider 默认空闲 60 秒停止,Neo4j 默认空闲 180 秒停止。数据卷不会被
637
- 删除,下一次请求会自动恢复同一份数据。运行中的调用会持续续租,不会被空闲计时器中断;
638
- 客户端异常退出后,租约最多 180 秒自动过期,避免服务永久被占住。这些秒数是当前产品默认值,
639
- 不是硬件实测阈值。
640
-
641
- 这种模式把空闲内存换成首次请求的冷启动等待和更多磁盘读取。管理界面的健康、运行状态和资源
642
- 采样不会唤醒图服务;`fuli status` 会把主动休眠报告为正常状态。管理服务必须保持运行才能自动
643
- 唤醒,所以 `--no-start` 只会保存策略,不会在本次运行中提供按需唤醒。容器模式下,该策略只
644
- 停止 Fuli 的 Provider / Neo4j 容器,不会自行关闭 Rancher Desktop、Docker Desktop、
645
- Kubernetes 或整台容器虚拟机;原生模式会直接停止对应 Provider 和 Neo4j 进程,因此空闲时
646
- 不再保留共享虚拟机开销。
647
-
648
- Jefa(项目经理)、Bole(AR,Agent Resources)和 Tonborg(决策员)是每个空间自带的角色,
649
- 不需要招募。Bole 的工作台可查看人员安排、当前工作与招募历史;Tonborg 的工作台可查看判断与反馈。
650
- Jefa 的任务看板随 FULI 内置,无需安装;在角色卡片或工作台的“管理负责项目”里设置它负责哪些项目。
651
- 控制台不再有聘请步骤:自定义员工包通过 Agent 工具 `recruit_employee` 招募,招募复用持久身份,
652
- 按项目单独任职;安装员工包后,侧栏工作台与 API 共用 FULI 端口,已有 FULI MCP 可发现和调用员工工具。
653
- 招募不等于启动模型,也不改写已有客户端配置。详见[员工包安装与扩展协议](docs/employee-agents.md)。
654
- Agent 还可以自己做小的 [Agent 应用](docs/agent-apps.md);本版本没有沙箱,经你在终端用 `fl app approve` 确认后,应用以你的账户权限运行。
655
-
656
- Project Agent 身份仍是控制面记录,不会每个身份常驻一个进程。角色工作记忆按项目私有、
657
- 版本化地保存在同一个 Neo4j Provider 中;任务入口恢复唯一负责人,结束检查跨 MCP 进程持久化。
658
- 详见[角色记忆、宿主 hooks 与验收边界](docs/project-agent-memory.md)。受支持的 Codex 和
659
- Claude Code Hook 还会保存可见对话,累积到一定量后折叠成摘要,按预算恢复。跨项目借调与
660
- 产物验证沿用同一个 Provider;客户端覆盖及模型能力配置见
661
- [对话与协作](docs/agent-conversations-and-collaboration.md)。实际执行器按 ID 共用租约:
662
- 只有显式注入受管生命周期适配器的执行器才由 Fuli 启停;Codex 等宿主自己拥有的外部执行器
663
- 不会被 Fuli 擅自启动或终止。当前可用的最小内存组合是:
664
-
665
- ```bash
666
- fuli setup --yes --runtime-mode native --memory-profile low --adaptive-memory
667
- ```
125
+ `fuli setup` 先把计划给你看,确认后才动环境。
668
126
 
669
- 两种模式使用彼此独立的数据目录,切换不会删除原模式的数据,也不会在后台自动合并两边的
670
- 新增内容。需要迁移时,先在来源模式仍处于启用状态时导出,再安装或切换目标模式并导入:
127
+ ## 控制台
671
128
 
672
- ```bash
673
- # Rancher / Docker -> 原生
674
- fuli graph export --mode container --output "$HOME/Backups/fuli-container"
675
- fuli setup --yes --runtime-mode native --memory-profile low --adaptive-memory
676
- fuli graph import --target-mode native --input "$HOME/Backups/fuli-container" --yes
677
- ```
129
+ <p align="center">
130
+ <img src="docs/readme/console-zh.webp" alt="FULI 控制台:一个待审核的任务、一个等你回答的问题和正在干活的 FLA" width="800" />
131
+ </p>
678
132
 
679
- 也可以用一条命令完成同样的步骤(需要带原生运行时的安装包;Windows 上是已安装的 Fuli 桌面版):
133
+ 控制台一打开就是眼下要紧的事:等你回答的问题、正在干活的 FLA、刚做完的工作。全部跑在 `127.0.0.1` 上,
134
+ 没有账号,也不用登录。
680
135
 
681
- ```bash
682
- fuli graph migrate --to native
683
- ```
136
+ ## 常见问题
684
137
 
685
- 它会停止正在运行的控制台,统计并导出容器图谱,切到原生模式后导入;只有每种标签和关系类型的数量都一致,
686
- 才接受迁移结果。任何一步失败都会切回容器模式。容器卷只会被读取,之后保持停止,不会被删除;
687
- 客户端接入不受影响。
138
+ <details>
139
+ <summary><b>我的数据放在哪?</b></summary>
688
140
 
689
- 反向迁移只需交换 `container` 和 `native`。导出会短暂停止来源数据库,完成后只恢复导出前
690
- 确实在运行的服务;导入会先校验清单和每个 dump 的 SHA-256,再停止目标数据库。替换前的
691
- 目标数据会自动保存在数据目录下的 `backups/graph`,导入失败时会立即尝试回滚。执行前应让
692
- 正在写图数据的 Agent 请求结束。
141
+ 在你的电脑上。个人图谱和对话记录都留在本机。外部知识(Notion、飞书、MCP 或 RAG)只读接入,FULI 不往源系统写。
142
+ </details>
693
143
 
694
- 导入完成后会使用目标安装自己的 bootstrap token 重新签发本机 Provider 访问令牌,并原子
695
- 更新运行配置;明文访问令牌不会写入迁移包。同一台机器迁移时,非受管的外部 Workspace
696
- 连接配置会继续保留;换到另一台机器后,外部服务凭据需要单独重新连接。
144
+ <details>
145
+ <summary><b>支持哪些客户端?</b></summary>
697
146
 
698
- 备份是一个含 `manifest.json`、`personal.dump` 和可选 `workspace.dump` 的目录,可以复制到
699
- 其他磁盘或机器。容器模式通过 Docker API 复制文件,不要求 Rancher 共享备份所在目录。
700
- dump 使用项目固定的 Neo4j 5.26 格式,适合在 Fuli 两种运行模式或兼容的 Neo4j 5.26 环境间
701
- 迁移;它不是面向任意数据库的 CSV / JSON 通用交换格式。
147
+ Claude Code、Codex、OpenCode、Cursor 和 Claude 桌面版都能在控制台里一键接入。其他 MCP 客户端运行
148
+ `fuli connect` 拿一份标准配置。
149
+ </details>
702
150
 
703
- 更新:
151
+ <details>
152
+ <summary><b>怎么叫我的某位 FLA?</b></summary>
704
153
 
705
- ```bash
706
- fuli update
707
- ```
154
+ 消息开头写 `#FLA` 加名字。在 Claude Code、OpenCode、Cursor 里也可以输入 `/fla`,从菜单里选一位;Codex 桌面版输入 `/prompts:fla`。
155
+ 不想要这个菜单,在 设置 › 客户端 里关掉。
156
+ </details>
708
157
 
709
- 更新会显示当前 CLI、Node、PATH 中的启动入口和 npm 安装目标。已是最新版时直接结束,
710
- 不会重复安装或重启服务。需要升级时先确认不会降级,再停止旧服务、安装最新版本,
711
- 仅刷新已有 Fuli MCP 配置的客户端。
712
- 既有知识、配置备份和 Neo4j 数据卷会保留。使用过自定义 setup 选项时,更新时应继续传入
713
- 相同选项。
158
+ <details>
159
+ <summary><b>FULI 怎么省 token?</b></summary>
714
160
 
715
- 已打开的客户端需要重新连接 Fuli MCP,或重启客户端后新建任务,才能加载新进程。
716
- 只需修复仍保留 Fuli MCP 条目的已有接入时,运行 `fuli setup --yes --connected-only`;仅剩 Skills(`skills-only`)、已移除(`removed`)或新接入的客户端(无 Fuli MCP 条目)须运行完整的 `fuli setup`。
161
+ 会话开始时只带生效的偏好和几条相关事实,其余的 Agent 需要时再查。只有你知道的事实,比如你顺口提过一次的沙箱地址,
162
+ 之后会直接召回,不用在代码里翻找。数字见[基准文档](FULI_ALIGNMENT_BENCHMARK.md)第 8.9.4 节。
163
+ </details>
717
164
 
718
- 卸载:
165
+ <details>
166
+ <summary><b>内置 FLA 会多花钱吗?</b></summary>
719
167
 
720
- ```bash
721
- fuli uninstall
722
- npm uninstall --global fuli-context
723
- ```
168
+ 不会偷偷多花。内置 FLA 默认借你客户端的会话干活,你给它们接了模型,才用它们自己的模型。
169
+ </details>
724
170
 
725
- 自动卸载不会永久删除个人图谱,避免误删。重新安装后可以继续使用原数据。
171
+ <details>
172
+ <summary><b>怎么把 FULI 从客户端里拿掉?</b></summary>
726
173
 
727
- ## Agent 接入与主要工具
174
+ 在控制台的「设置 › 客户端接入」里,对那个客户端点「移除」。`fuli uninstall` 和 Windows 卸载程序会对每个接入过的
175
+ 客户端做同样的事。FULI 只拿掉自己加的那几项(MCP 服务、Hook、Skills 和它的权限条目),改之前先备份每个文件,
176
+ 你自己改过的 Skill 会留着。FULI 的数据会一直保留,你自己删才会删。在 macOS 上,先在控制台移除客户端,再把
177
+ FULI.app 移到废纸篓:只移到废纸篓的话,这些配置还留在客户端里。
178
+ </details>
728
179
 
729
- Fuli 为支持的 Agent 安装 `capturing-session-knowledge`、`grilling-project`、`operating-fuli` 和 `flreview`
730
- Skills。输入 `/flreview` 后可选择全部、个人偏好或个人项目(Codex 在 Hook 运行前就拒绝自定义斜杠命令,
731
- 请单独一行输入 `fuli review` 或 `flreview`:Codex 提示词 Hook 会把这一行连同已安装 Skill 的名称交给模型;本会话停用 FULI 时由 Hook 直接答复,不开始复核);若用户表示完全没耐心,流程会
732
- 跳过心情、时间和 token 询问,只处理少量最高优先级问题。Fuli setup 为 Claude Code 生成
733
- `UserPromptSubmit`/`Stop` MCP Hook,为 Codex 生成 `UserPromptSubmit` MCP Hook 和本地 `Stop`
734
- 命令,为 Cursor 生成 `sessionStart`/`beforeSubmitPrompt`/`stop` Hook。Codex bootstrap 和 Cursor
735
- 指令只在未收到生命周期上下文时使用 fallback,不重复已提供的偏好。Codex 的 Stop 命令首次
736
- 阻止未完成检查;若一次继续后仍未完成,只对同一 token 写入 `retain_nothing` 防止无限循环,
737
- 不生成知识或角色记忆。安装配置不会代替用户批准宿主信任。偏好正文始终以本机 Fuli 为唯一
738
- 来源,不复制到 Agent 配置中。`operating-fuli` 要求 Agent 在写数据前先检查结构化接口覆盖目录,
739
- 写后用对应读取工具验证;浏览器自动化只用于可选的视觉检查,不作为数据写入手段。详见
740
- [Agent 接口架构](docs/agent-interface-architecture.md)。
180
+ <details>
181
+ <summary><b>以前用 npm 装过,现在是不是装了两份?</b></summary>
741
182
 
742
- FULI MCP 还提供只读的 `fuli://` resources:每个本地个人项目和“全局品味”各有一个可选条目。
743
- 支持 MCP mention 的 Agent 可以在 `@` 选择器里选中它们;项目条目只代表一个精确项目,
744
- 不会因为选择而自动扩大到其他项目或 `RELATED_TO` 项目。
183
+ 程序是两份,数据只有一份:两者用同一个数据目录。桌面客户端启动后,由它运行唯一的 FULI 服务,并把已连接的客户端改指向自己。
184
+ 管理界面会提醒你一键卸载 npm 版;卸载之前,终端里直接敲 `fl` 仍是 npm 版。
185
+ [详细说明](docs/install.zh-CN.md#以前用-npm-装过)
186
+ </details>
745
187
 
746
- ### Claude 网页版 / Cowork 的远程上游
188
+ <details>
189
+ <summary><b>留下什么由谁决定?</b></summary>
747
190
 
748
- `fuli remote-mcp` 提供绑定单一个人项目、最小权限的 Streamable HTTP MCP 上游。它把来源
749
- 独立记录为 `claude`,要求仅 owner 可读的 bearer token 文件,拒绝跨站 Origin,并且只监听
750
- loopback:
191
+ 由你决定:AI 负责查找和执行,人始终保留最终判断权。每个任务结束前检查一次,只留能复用的知识。Agent 猜出来的偏好,
192
+ 要等你或者在你设定的自主程度内的 <img src="docs/readme/fla-tonborg-inline.webp" alt="" width="20" align="absmiddle" /> Tonborg 确认才算数。旧答案带着来源和理由留在历史里。
193
+ </details>
751
194
 
752
- ```bash
753
- umask 077
754
- openssl rand -hex 32 > ./fuli-remote.token
755
- fuli remote-mcp --personal-project-id YOUR_PROJECT_ID \
756
- --bearer-token-file ./fuli-remote.token --port 2728
757
- ```
195
+ ## 深入了解
758
196
 
759
- 在 POSIX 系统上,CLI 会以 nonblocking + no-follow 方式打开 token,并要求权限为 `0600`。
760
- Windows 无法通过 Node.js 获得同等的 `O_NOFOLLOW` 与 POSIX 权限保证,因此 token 必须放在
761
- 受 Windows ACL 保护的目录中,必须是普通文件且不能使用链接。
762
-
763
- 启动前会校验该项目确实属于当前个人空间;默认最多同时保留 8 个会话,并清理空闲超过
764
- 15 分钟的会话;需要时可用 `--max-sessions` 和 `--session-idle-ttl-seconds` 调整。“空闲”按
765
- 已完成的 MCP 应用请求计算,静默的独立 SSE 通知流不会永久占用会话槽;到达 TTL 后连接
766
- 可能被关闭,客户端须重新连接并初始化新会话。关闭服务时,正在处理的有界请求与会话清理
767
- 共享同一个宽限截止时间,超时后才强制关闭剩余 HTTP 连接。若反向代理
768
- 会转发浏览器 `Origin` 或保留公网 Host,用
769
- `--allowed-origin https://connector.example --allowed-host connector.example` 显式配置;否则让
770
- 代理把 Host 重写为 loopback 上游地址。任意未允许的 Origin 和 Host 都会被拒绝。每个 MCP
771
- 会话只能读取任务入口为它选中的 Agent 私有上下文与记忆。checkpoint token 还同时绑定上游
772
- 配置的项目和创建它的 MCP 会话,其他项目进程或同项目的其他会话都不能复用。
773
-
774
- 这只是内部上游,不是公网部署。Claude 自定义连接器从 Anthropic 云端发起请求,因此仍须在
775
- 监听器前配置公开 HTTPS 与 OAuth 2.1 代理;代理必须校验用户身份、token audience 和最小
776
- scope,再把外部 token 换成内部 bearer,绝不能开放 Fuli Provider 或 Neo4j 端口。
777
- claude.ai 不运行本机生命周期 hooks;MCP 初始化指令会要求每项任务先恢复角色、结束前
778
- checkpoint,但只有真实连接后的 Claude 会话才能证明该行为。
779
-
780
- 当任务需要品味或判断建议时,`get_user_taste_skill` 会根据当前生效的个人档案和历史任务
781
- 数据生成一份有界、只读的 `user-taste` Skill 结论。它会标注证据状态与作用域,返回与当前
782
- 任务匹配的推荐,并在偏好新增或修订后重新生成;不会覆盖用户自己编写的 taste Skill,持久
783
- 图谱仍是唯一来源。
784
-
785
- | 工具 | 用途 |
197
+ | 想知道 | 去读 |
786
198
  | --- | --- |
787
- | `begin_task_context` | Hook 入口:解析任务、在命中信号时执行有界召回并创建任务令牌 |
788
- | `get_collaboration_preferences` | Fallback 入口:读取生效偏好和有界任务召回 |
789
- | `get_user_taste_skill` | 生成当前带证据状态的 taste Skill 结论和任务推荐 |
790
- | `search_current_project_knowledge` | 子项目优先、按授权关系向上检索 |
791
- | `search_knowledge_graph` | 在明确的有界范围内执行更通用的查询 |
792
- | `search_connected_knowledge` | 分开检索图谱、项目绑定的只读来源和选定公共项目,保留来源边界 |
793
- | `record_knowledge_usage` | 记录真正影响结果的引用或应用 |
794
- | `record_knowledge_feedback` | 保存拒绝、验证失败、冲突或过时证据 |
795
- | `record_decision_trace` | 保存选择、被拒方案、理由和可选初始验证 |
796
- | `capture_session_knowledge` | 批量写入少量、结构化的候选知识 |
797
- | `checkpoint_task_knowledge` | 以 `capture_candidates` 或 `retain_nothing` 结束知识检查 |
798
- | `discover_common_knowledge_candidates` | 只读发现可能属于上级项目的公共候选 |
799
- | `preview_common_knowledge_promotion` | 预览人类确认的公共知识提升 |
800
- | `apply_common_knowledge_promotion` | 使用一次性令牌原子执行提升 |
801
- | `resolve_deferred_preference_conflict` | 在实际需要时处理已授权给 AI 的冲突 |
802
- | `start_knowledge_review` | 启动或恢复精确范围的个人知识回顾 |
803
- | `list_knowledge_review_candidates` | 按时间、冲突、权重和跨会话重复顺序列出候选 |
804
- | `record_knowledge_review_progress` | 保存确认、修改、失效、跳过或稍后处理结果 |
805
- | `finish_knowledge_review` | 暂停回顾,或完成并推进下次回顾水位线 |
806
-
807
- ## 隐私与安全边界
808
-
809
- - 个人知识写入本机 Provider;
810
- - Agent 归纳结构化知识,与私有、由适配器可见的对话日志分开管理;
811
- - Token、Cookie、私钥、凭据、私人联系信息、临时日志和原始命令输出不得进入图谱;
812
- - Graphiti 远程 LLM 路径被禁用,当前嵌入在本机计算;
813
- - 搜索按个人空间和项目范围限定,不默认混入所有项目;
814
- - 外部连接器从不写入第三方源,绑定配置拒绝保存明文凭据;
815
- - 公共提升需要可审计的人工确认,Agent 自己的使用证据最多晋级为
816
- `agent_confirmed`;
817
- - Fuli 不是实时监控或 Git 服务,实时状态应从对应系统重新读取。
818
-
819
- ## 本机服务
820
-
821
- | 服务 | 默认回环地址 | 启用条件 |
822
- | --- | --- | --- |
823
- | Fuli 管理界面 | `127.0.0.1:2727` | 始终启用 |
824
- | 个人 Provider | `127.0.0.1:8787` | 始终启用 |
825
- | 个人 Neo4j Browser / Bolt | `127.0.0.1:8060` / `127.0.0.1:7687` | 始终启用 |
826
- | 开发公共 Provider | `127.0.0.1:8788` | 仅 `--with-dev-public` |
827
- | 开发公共 Neo4j Browser / Bolt | `127.0.0.1:7475` / `127.0.0.1:7688` | 仅 `--with-dev-public` |
828
-
829
- 以上共 7 个端口均可在“设置”页修改。即使管理界面以 LAN 模式启动,Provider 和 Neo4j 仍只
830
- 绑定回环地址。
831
-
832
- 需要同一 Wi-Fi 下的其他设备访问时,执行 `fuli start --lan`。若当前已经以本机模式运行,
833
- 命令会安全重启管理界面并保持 Provider 与图谱数据不变。退出局域网模式可在设置页关闭后
834
- 执行 `fuli restart`,或直接执行 `fuli restart --no-lan`;再次进入局域网模式会更换临时访问
835
- 口令。
836
-
837
- 如果端口被占用、Docker Compose 不可用或容器引擎未启动,setup 会在修改 Agent 配置前停止
838
- 并报告原因。
839
-
840
- ## 验收与源码开发
841
-
842
- - [Alignment Benchmark](FULI_ALIGNMENT_BENCHMARK.md)
843
- - [中文验收索引](acceptance/README.md)
844
- - [知识检索与确认流程图](acceptance/知识检索与确认流程图.md)
845
- - [外部知识库只读接入架构](docs/external-knowledge-architecture.md)
846
-
847
- ```bash
848
- npm install
849
- npm test
850
- npm run test:package
851
- npm run test:external-knowledge:live
852
- ```
853
-
854
- 外部知识联网测试会临时下载两个公开官方文档仓库,验证只读同步和检索后删除整个临时目录。
855
- 该测试依赖网络,不属于默认测试套件。
856
-
857
- Provider 验证:
858
-
859
- ```bash
860
- python3.12 -m venv .venv
861
- . .venv/bin/activate
862
- python -m pip install "./graph-provider[dev]"
863
- python -m compileall -q graph-provider/fuli_graph
864
- python -m pytest -q graph-provider/tests
865
- docker compose -f compose.graphiti.yml config --quiet
866
- ```
867
-
868
- `npm run test:package` 会构建前端、生成真实 npm tarball、安装到隔离的全局前缀,并验证
869
- `fuli` / `fl`、版本号、帮助信息和 Web UI。测试源码、QA 截图和内部设计文档不会进入 npm
870
- 包。
871
-
872
- ## 品牌
873
-
874
- <picture>
875
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/JevonsCode/fuli/main/brand/svg/lockup/fuli-lockup-bilingual-horizontal-dark.svg" />
876
- <img src="https://raw.githubusercontent.com/JevonsCode/fuli/main/brand/svg/lockup/fuli-lockup-bilingual-horizontal.svg" alt="FULI 复利 组合标" width="280" />
877
- </picture>
878
-
879
- FULI 的图形标、字标和组合标来自 [Figma 上的 FULI 复利品牌系统](https://www.figma.com/community/file/1698659778015746085)。品牌文件和修改方法见 [`brand/README.md`](brand/README.md)。
880
-
881
- ## License
882
-
883
- [Apache-2.0](LICENSE)
199
+ | 安装细节、CLI 命令和端口 | [安装与运行](docs/install.zh-CN.md) |
200
+ | 理念,什么存在哪里 | [FULI 怎么工作](docs/how-it-works.zh-CN.md) |
201
+ | 各客户端怎么接 | [客户端接入(英文)](docs/client-connections.md) |
202
+ | Skills、Hook 和 MCP 工具 | [Agent 接入与 MCP 工具](docs/agent-tools.zh-CN.md) |
203
+ | Notion、飞书等知识库 | [外部知识库只读接入](docs/external-knowledge.zh-CN.md) |
204
+ | <img src="docs/readme/fla-tonborg-inline.webp" alt="" width="20" align="absmiddle" /> Tonborg 与自主程度 | [Tonborg 怎么判断(英文)](docs/judgment-and-autonomy.md) |
205
+ | 圆桌 | [圆桌](docs/agent-roundtable.md) |
206
+ | 已经证明了什么 | [能力与边界](docs/capabilities-and-limits.zh-CN.md) · [实测报告](https://有点.意思.com/fuli/report/) |
207
+ | 跑源码 | [开发与验收](docs/development.zh-CN.md) · [参与贡献](CONTRIBUTING.md) |
208
+
209
+ FULI 的图形标和字标来自 [FULI 复利品牌系统](https://www.figma.com/community/file/1698659778015746085),见 [`brand/README.md`](brand/README.md)。
210
+ 以 [Apache-2.0](LICENSE) 许可发布。