abyss-cli 2.0.3__tar.gz → 2.4.0__tar.gz

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 (283) hide show
  1. abyss_cli-2.4.0/PKG-INFO +295 -0
  2. abyss_cli-2.4.0/README.md +259 -0
  3. abyss_cli-2.4.0/pyproject.toml +128 -0
  4. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/__init__.py +1 -1
  5. abyss_cli-2.4.0/src/abyss/__main__.py +8 -0
  6. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/_globals.py +65 -65
  7. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/agent_loop.py +662 -526
  8. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/ansi_menu.py +2694 -2180
  9. abyss_cli-2.4.0/src/abyss/api_client.py +1100 -0
  10. abyss_cli-2.4.0/src/abyss/cognition/__init__.py +39 -0
  11. abyss_cli-2.4.0/src/abyss/cognition/lock.py +47 -0
  12. abyss_cli-2.4.0/src/abyss/cognition/onboarding.py +418 -0
  13. abyss_cli-2.4.0/src/abyss/cognition/prompt.py +28 -0
  14. abyss_cli-2.4.0/src/abyss/cognition/store.py +654 -0
  15. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/ai_analysis.py +194 -194
  16. abyss_cli-2.4.0/src/abyss/commands/cognition.py +96 -0
  17. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/compact.py +59 -42
  18. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/cron.py +162 -162
  19. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/diff.py +134 -134
  20. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/git.py +185 -183
  21. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/info.py +246 -246
  22. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/knowledge.py +211 -211
  23. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/logs.py +272 -272
  24. abyss_cli-2.4.0/src/abyss/commands/plan.py +216 -0
  25. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/retry.py +82 -82
  26. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/undo.py +102 -102
  27. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/concurrency/__init__.py +15 -15
  28. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/concurrency/abort.py +225 -225
  29. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/config/__init__.py +37 -22
  30. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/config/legacy.py +245 -164
  31. abyss_cli-2.4.0/src/abyss/config/models.py +71 -0
  32. abyss_cli-2.4.0/src/abyss/constants.py +10 -0
  33. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/context/__init__.py +2 -2
  34. abyss_cli-2.4.0/src/abyss/context/attachment_ref_parser.py +93 -0
  35. abyss_cli-2.4.0/src/abyss/context/attachment_resolver.py +302 -0
  36. abyss_cli-2.4.0/src/abyss/context/attachment_tray.py +527 -0
  37. abyss_cli-2.4.0/src/abyss/context/attachment_ui.py +188 -0
  38. abyss_cli-2.4.0/src/abyss/context/image_input.py +199 -0
  39. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/context/project_context.py +439 -434
  40. abyss_cli-2.4.0/src/abyss/context/project_rules.py +178 -0
  41. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/context/snip.py +98 -98
  42. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/context_engine.py +193 -15
  43. abyss_cli-2.4.0/src/abyss/context_summarizer.py +143 -0
  44. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/curator.py +539 -497
  45. abyss_cli-2.4.0/src/abyss/desktop/__init__.py +5 -0
  46. abyss_cli-2.4.0/src/abyss/desktop/__main__.py +35 -0
  47. abyss_cli-2.4.0/src/abyss/desktop/actions/__init__.py +5 -0
  48. abyss_cli-2.4.0/src/abyss/desktop/actions/content.py +324 -0
  49. abyss_cli-2.4.0/src/abyss/desktop/actions/extensions.py +304 -0
  50. abyss_cli-2.4.0/src/abyss/desktop/catalog/__init__.py +5 -0
  51. abyss_cli-2.4.0/src/abyss/desktop/catalog/real.py +678 -0
  52. abyss_cli-2.4.0/src/abyss/desktop/catalog/sample.py +277 -0
  53. abyss_cli-2.4.0/src/abyss/desktop/chat/__init__.py +1 -0
  54. abyss_cli-2.4.0/src/abyss/desktop/chat/approval.py +168 -0
  55. abyss_cli-2.4.0/src/abyss/desktop/chat/backends.py +601 -0
  56. abyss_cli-2.4.0/src/abyss/desktop/chat/engine.py +780 -0
  57. abyss_cli-2.4.0/src/abyss/desktop/chat/stream.py +193 -0
  58. abyss_cli-2.4.0/src/abyss/desktop/control/__init__.py +4 -0
  59. abyss_cli-2.4.0/src/abyss/desktop/control/controller.py +433 -0
  60. abyss_cli-2.4.0/src/abyss/desktop/host/__init__.py +4 -0
  61. abyss_cli-2.4.0/src/abyss/desktop/host/host.py +421 -0
  62. abyss_cli-2.4.0/src/abyss/desktop/ipc/__init__.py +4 -0
  63. abyss_cli-2.4.0/src/abyss/desktop/ipc/bridge.py +388 -0
  64. abyss_cli-2.4.0/src/abyss/desktop/ipc/protocol.py +200 -0
  65. abyss_cli-2.4.0/src/abyss/desktop/settings/__init__.py +1 -0
  66. abyss_cli-2.4.0/src/abyss/desktop/settings/settings.py +162 -0
  67. abyss_cli-2.4.0/src/abyss/desktop/ui/abyss.ico +0 -0
  68. abyss_cli-2.4.0/src/abyss/desktop/ui/app.css +2563 -0
  69. abyss_cli-2.4.0/src/abyss/desktop/ui/app.js +4878 -0
  70. abyss_cli-2.4.0/src/abyss/desktop/ui/bridge.js +64 -0
  71. abyss_cli-2.4.0/src/abyss/desktop/ui/demo-catalog.js +2 -0
  72. abyss_cli-2.4.0/src/abyss/desktop/ui/index.html +649 -0
  73. abyss_cli-2.4.0/src/abyss/desktop/ui/parity.css +659 -0
  74. abyss_cli-2.4.0/src/abyss/desktop/ui/parity2.css +949 -0
  75. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/extension_context.py +89 -89
  76. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/history/__init__.py +31 -31
  77. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/history/file_history.py +600 -525
  78. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/hooks/runner.py +19 -1
  79. abyss_cli-2.4.0/src/abyss/indexing/__init__.py +36 -0
  80. abyss_cli-2.4.0/src/abyss/indexing/embedding.py +314 -0
  81. abyss_cli-2.4.0/src/abyss/indexing/ignore.py +291 -0
  82. abyss_cli-2.4.0/src/abyss/indexing/semantic.py +385 -0
  83. abyss_cli-2.4.0/src/abyss/indexing/service.py +233 -0
  84. abyss_cli-2.4.0/src/abyss/indexing/symbols.py +308 -0
  85. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/interrupt.py +25 -2
  86. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/knowledge/__init__.py +14 -14
  87. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/knowledge/curator.py +382 -338
  88. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/knowledge/loader.py +265 -257
  89. abyss_cli-2.4.0/src/abyss/launcher.py +51 -0
  90. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/llm/__init__.py +23 -17
  91. abyss_cli-2.4.0/src/abyss/llm/exceptions.py +46 -0
  92. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/llm/resilience.py +398 -399
  93. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/llm/thinking_budget.py +206 -188
  94. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/logger.py +626 -604
  95. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/main.py +4870 -3302
  96. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/mcp/manager.py +156 -47
  97. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/memory/__init__.py +28 -24
  98. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/memory/bm25.py +253 -256
  99. abyss_cli-2.4.0/src/abyss/memory/dedup.py +362 -0
  100. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/memory/reranker.py +173 -204
  101. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/memory/store.py +251 -199
  102. abyss_cli-2.4.0/src/abyss/prompts/__init__.py +222 -0
  103. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/prompts/methodologies.py +267 -200
  104. abyss_cli-2.4.0/src/abyss/prompts/system_prompt.md +49 -0
  105. abyss_cli-2.4.0/src/abyss/qa/__init__.py +6 -0
  106. abyss_cli-2.4.0/src/abyss/qa/__main__.py +90 -0
  107. abyss_cli-2.4.0/src/abyss/qa/assets/app.js +674 -0
  108. abyss_cli-2.4.0/src/abyss/qa/assets/index.html +180 -0
  109. abyss_cli-2.4.0/src/abyss/qa/assets/styles.css +689 -0
  110. abyss_cli-2.4.0/src/abyss/qa/features.py +298 -0
  111. abyss_cli-2.4.0/src/abyss/qa/runner.py +319 -0
  112. abyss_cli-2.4.0/src/abyss/qa/server.py +388 -0
  113. abyss_cli-2.4.0/src/abyss/qa/store.py +210 -0
  114. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/runtime/__init__.py +9 -9
  115. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/runtime/host.py +318 -242
  116. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/security/__init__.py +5 -5
  117. abyss_cli-2.4.0/src/abyss/security/constants.py +54 -0
  118. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/security/path_security.py +394 -376
  119. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/security/sensitive_filter.py +181 -181
  120. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/security/tool_safety_guard.py +411 -419
  121. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/session.py +222 -24
  122. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/skills/loader.py +4 -0
  123. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/subagent/__init__.py +8 -8
  124. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/subagent/protocol.py +198 -207
  125. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/subagent/runner.py +579 -422
  126. abyss_cli-2.4.0/src/abyss/telemetry.py +523 -0
  127. abyss_cli-2.4.0/src/abyss/tokenizer.py +195 -0
  128. abyss_cli-2.4.0/src/abyss/tokenizer_files/tokenizer.json +263174 -0
  129. abyss_cli-2.4.0/src/abyss/tokenizer_files/tokenizer_config.json +35 -0
  130. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/__init__.py +10 -0
  131. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/base.py +35 -30
  132. abyss_cli-2.4.0/src/abyss/tools/code_search.py +243 -0
  133. abyss_cli-2.4.0/src/abyss/tools/cognition_read.py +81 -0
  134. abyss_cli-2.4.0/src/abyss/tools/cognition_update.py +74 -0
  135. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/cron_service.py +290 -286
  136. abyss_cli-2.4.0/src/abyss/tools/document_read.py +696 -0
  137. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/file_cache.py +156 -150
  138. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/file_edit.py +90 -70
  139. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/file_io.py +297 -284
  140. abyss_cli-2.4.0/src/abyss/tools/file_read.py +249 -0
  141. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/file_write.py +64 -60
  142. abyss_cli-2.4.0/src/abyss/tools/find_symbols.py +202 -0
  143. abyss_cli-2.4.0/src/abyss/tools/glob_files.py +100 -0
  144. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/knowledge_fetch.py +73 -73
  145. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/knowledge_save.py +278 -250
  146. abyss_cli-2.4.0/src/abyss/tools/memory_save.py +161 -0
  147. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/memory_search.py +157 -135
  148. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/registry.py +74 -30
  149. abyss_cli-2.4.0/src/abyss/tools/run_tests.py +147 -0
  150. abyss_cli-2.4.0/src/abyss/tools/search_common.py +84 -0
  151. abyss_cli-2.4.0/src/abyss/tools/semantic_search.py +144 -0
  152. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/shell_exec.py +442 -399
  153. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/spawn_subagents.py +248 -165
  154. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/todo_write.py +226 -176
  155. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/tools/tracking.py +217 -215
  156. abyss_cli-2.4.0/src/abyss/tools/web_fetch.py +193 -0
  157. abyss_cli-2.4.0/src/abyss/tools/web_search.py +365 -0
  158. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/ui/__init__.py +78 -65
  159. abyss_cli-2.4.0/src/abyss/ui/calm.py +464 -0
  160. abyss_cli-2.4.0/src/abyss/ui/classic.py +310 -0
  161. abyss_cli-2.4.0/src/abyss/ui/deck.py +575 -0
  162. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/ui/renderer.py +1325 -863
  163. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/ui/themes.py +88 -75
  164. abyss_cli-2.4.0/src/abyss/ui/token_rate.py +144 -0
  165. abyss_cli-2.4.0/src/abyss/ui/tokens.py +139 -0
  166. abyss_cli-2.4.0/src/abyss/ui/typewriter.py +203 -0
  167. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/utils/__init__.py +1 -1
  168. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/utils/text.py +45 -35
  169. abyss_cli-2.4.0/src/abyss/utils/text_metrics.py +69 -0
  170. abyss_cli-2.4.0/src/abyss/validation/__init__.py +30 -0
  171. abyss_cli-2.4.0/src/abyss/validation/runner.py +457 -0
  172. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/vcs/__init__.py +17 -17
  173. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/vcs/commit_attribution.py +317 -317
  174. abyss_cli-2.4.0/src/abyss_cli.egg-info/PKG-INFO +295 -0
  175. abyss_cli-2.4.0/src/abyss_cli.egg-info/SOURCES.txt +267 -0
  176. abyss_cli-2.4.0/src/abyss_cli.egg-info/entry_points.txt +5 -0
  177. abyss_cli-2.4.0/src/abyss_cli.egg-info/requires.txt +36 -0
  178. abyss_cli-2.4.0/tests/test_ansi_prompt_wrap.py +423 -0
  179. abyss_cli-2.4.0/tests/test_api_client_compliance.py +141 -0
  180. abyss_cli-2.4.0/tests/test_attachment_main_integration.py +85 -0
  181. abyss_cli-2.4.0/tests/test_attachment_tray.py +340 -0
  182. abyss_cli-2.4.0/tests/test_calm_renderer.py +184 -0
  183. abyss_cli-2.4.0/tests/test_cognition.py +247 -0
  184. abyss_cli-2.4.0/tests/test_cognition_onboarding.py +206 -0
  185. abyss_cli-2.4.0/tests/test_consume_stream_ui.py +58 -0
  186. abyss_cli-2.4.0/tests/test_context_summarizer.py +150 -0
  187. abyss_cli-2.4.0/tests/test_curator_cron.py +69 -0
  188. abyss_cli-2.4.0/tests/test_effort_levels.py +104 -0
  189. abyss_cli-2.4.0/tests/test_file_history_redo.py +170 -0
  190. abyss_cli-2.4.0/tests/test_file_read_documents.py +300 -0
  191. abyss_cli-2.4.0/tests/test_file_read_streaming.py +176 -0
  192. abyss_cli-2.4.0/tests/test_image_input.py +363 -0
  193. abyss_cli-2.4.0/tests/test_indexing_embedding.py +167 -0
  194. abyss_cli-2.4.0/tests/test_indexing_ignore.py +167 -0
  195. abyss_cli-2.4.0/tests/test_indexing_service.py +165 -0
  196. abyss_cli-2.4.0/tests/test_indexing_symbols.py +258 -0
  197. abyss_cli-2.4.0/tests/test_inline_refs.py +388 -0
  198. abyss_cli-2.4.0/tests/test_interrupt.py +68 -0
  199. abyss_cli-2.4.0/tests/test_live_smoke.py +110 -0
  200. abyss_cli-2.4.0/tests/test_memory_dedup.py +603 -0
  201. abyss_cli-2.4.0/tests/test_model_config.py +130 -0
  202. abyss_cli-2.4.0/tests/test_native_client.py +272 -0
  203. abyss_cli-2.4.0/tests/test_paste_burst_completion.py +75 -0
  204. abyss_cli-2.4.0/tests/test_path_security_thread_local.py +67 -0
  205. abyss_cli-2.4.0/tests/test_plan_mode.py +257 -0
  206. abyss_cli-2.4.0/tests/test_pricing.py +165 -0
  207. abyss_cli-2.4.0/tests/test_project_rules.py +124 -0
  208. abyss_cli-2.4.0/tests/test_protected_paths_single_source.py +89 -0
  209. abyss_cli-2.4.0/tests/test_qa_console.py +242 -0
  210. abyss_cli-2.4.0/tests/test_registry_cleanup.py +50 -0
  211. abyss_cli-2.4.0/tests/test_reranker_llm.py +40 -0
  212. abyss_cli-2.4.0/tests/test_responses_client.py +556 -0
  213. abyss_cli-2.4.0/tests/test_running_summary_engine.py +168 -0
  214. abyss_cli-2.4.0/tests/test_search_hardening.py +125 -0
  215. abyss_cli-2.4.0/tests/test_self_correction.py +73 -0
  216. abyss_cli-2.4.0/tests/test_semantic_index.py +166 -0
  217. abyss_cli-2.4.0/tests/test_session_load_cwd_sync.py +194 -0
  218. abyss_cli-2.4.0/tests/test_session_protocol.py +97 -0
  219. abyss_cli-2.4.0/tests/test_shell_guards_pipeline.py +85 -0
  220. abyss_cli-2.4.0/tests/test_subagent_budget_pricing.py +137 -0
  221. abyss_cli-2.4.0/tests/test_subagent_runner_timeout.py +126 -0
  222. abyss_cli-2.4.0/tests/test_subagent_token_optimization.py +196 -0
  223. abyss_cli-2.4.0/tests/test_term_width_zero.py +80 -0
  224. abyss_cli-2.4.0/tests/test_text_metrics.py +193 -0
  225. abyss_cli-2.4.0/tests/test_token_counter.py +35 -0
  226. abyss_cli-2.4.0/tests/test_token_rate.py +183 -0
  227. abyss_cli-2.4.0/tests/test_token_saving.py +200 -0
  228. abyss_cli-2.4.0/tests/test_tokenizer.py +129 -0
  229. abyss_cli-2.4.0/tests/test_tool_execution_unified.py +113 -0
  230. abyss_cli-2.4.0/tests/test_tool_loop_reasoning.py +115 -0
  231. abyss_cli-2.4.0/tests/test_tool_preview_ui.py +342 -0
  232. abyss_cli-2.4.0/tests/test_tool_telemetry.py +197 -0
  233. abyss_cli-2.4.0/tests/test_tools_base_coerce.py +323 -0
  234. abyss_cli-2.4.0/tests/test_tools_code_search.py +129 -0
  235. abyss_cli-2.4.0/tests/test_tools_cron_service.py +435 -0
  236. abyss_cli-2.4.0/tests/test_tools_file_cache.py +311 -0
  237. abyss_cli-2.4.0/tests/test_tools_file_edit_write.py +307 -0
  238. abyss_cli-2.4.0/tests/test_tools_file_io.py +349 -0
  239. abyss_cli-2.4.0/tests/test_tools_find_symbols.py +181 -0
  240. abyss_cli-2.4.0/tests/test_tools_glob_files.py +63 -0
  241. abyss_cli-2.4.0/tests/test_tools_knowledge.py +501 -0
  242. abyss_cli-2.4.0/tests/test_tools_memory.py +473 -0
  243. abyss_cli-2.4.0/tests/test_tools_registry.py +472 -0
  244. abyss_cli-2.4.0/tests/test_tools_run_tests.py +107 -0
  245. abyss_cli-2.4.0/tests/test_tools_semantic_search.py +124 -0
  246. abyss_cli-2.4.0/tests/test_tools_shell_exec_guards.py +565 -0
  247. abyss_cli-2.4.0/tests/test_tools_spawn_subagents.py +493 -0
  248. abyss_cli-2.4.0/tests/test_tools_todo_write.py +396 -0
  249. abyss_cli-2.4.0/tests/test_tools_tracking.py +432 -0
  250. abyss_cli-2.4.0/tests/test_tools_web_fetch.py +407 -0
  251. abyss_cli-2.4.0/tests/test_tools_web_search_parsers.py +461 -0
  252. abyss_cli-2.4.0/tests/test_typewriter.py +208 -0
  253. abyss_cli-2.4.0/tests/test_ui_banner.py +65 -0
  254. abyss_cli-2.4.0/tests/test_ui_classic.py +134 -0
  255. abyss_cli-2.4.0/tests/test_ui_deck.py +173 -0
  256. abyss_cli-2.4.0/tests/test_ui_layout.py +187 -0
  257. abyss_cli-2.4.0/tests/test_ui_tokens.py +60 -0
  258. abyss_cli-2.4.0/tests/test_validation_runner.py +218 -0
  259. abyss_cli-2.4.0/tests/test_web_search_anysearch_http.py +50 -0
  260. abyss_cli-2.4.0/tests/test_web_search_fallback.py +104 -0
  261. abyss_cli-2.0.3/PKG-INFO +0 -13
  262. abyss_cli-2.0.3/pyproject.toml +0 -32
  263. abyss_cli-2.0.3/src/abyss/api_client.py +0 -283
  264. abyss_cli-2.0.3/src/abyss/context/attachment_resolver.py +0 -211
  265. abyss_cli-2.0.3/src/abyss/prompts/__init__.py +0 -165
  266. abyss_cli-2.0.3/src/abyss/prompts/system_prompt.md +0 -126
  267. abyss_cli-2.0.3/src/abyss/tools/file_read.py +0 -113
  268. abyss_cli-2.0.3/src/abyss/tools/memory_save.py +0 -97
  269. abyss_cli-2.0.3/src/abyss/tools/web_fetch.py +0 -102
  270. abyss_cli-2.0.3/src/abyss/tools/web_search.py +0 -126
  271. abyss_cli-2.0.3/src/abyss_cli.egg-info/PKG-INFO +0 -13
  272. abyss_cli-2.0.3/src/abyss_cli.egg-info/SOURCES.txt +0 -96
  273. abyss_cli-2.0.3/src/abyss_cli.egg-info/entry_points.txt +0 -2
  274. abyss_cli-2.0.3/src/abyss_cli.egg-info/requires.txt +0 -7
  275. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/MANIFEST.in +0 -0
  276. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/setup.cfg +0 -0
  277. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/__init__.py +0 -0
  278. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/commands/slash.py +0 -0
  279. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/hooks/__init__.py +0 -0
  280. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/mcp/__init__.py +0 -0
  281. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss/skills/__init__.py +0 -0
  282. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss_cli.egg-info/dependency_links.txt +0 -0
  283. {abyss_cli-2.0.3 → abyss_cli-2.4.0}/src/abyss_cli.egg-info/top_level.txt +0 -0
@@ -0,0 +1,295 @@
1
+ Metadata-Version: 2.4
2
+ Name: abyss-cli
3
+ Version: 2.4.0
4
+ Summary: 终端AI开发助手
5
+ Author: Abyss Team
6
+ Requires-Python: >=3.9
7
+ Description-Content-Type: text/markdown
8
+ Requires-Dist: click>=8.0.0
9
+ Requires-Dist: prompt-toolkit>=3.0.0
10
+ Requires-Dist: ddgs>=9.0.0
11
+ Requires-Dist: httpx>=0.20.0
12
+ Requires-Dist: mcp>=1.0.0
13
+ Requires-Dist: tiktoken>=0.5.0
14
+ Requires-Dist: tokenizers>=0.15.0
15
+ Requires-Dist: jinja2>=3.0.0
16
+ Provides-Extra: openai
17
+ Requires-Dist: openai>=1.0.0; extra == "openai"
18
+ Provides-Extra: indexing
19
+ Requires-Dist: onnxruntime>=1.17; extra == "indexing"
20
+ Requires-Dist: numpy>=1.24; extra == "indexing"
21
+ Provides-Extra: documents
22
+ Requires-Dist: openpyxl>=3.1.0; extra == "documents"
23
+ Requires-Dist: xlrd>=2.0.1; extra == "documents"
24
+ Requires-Dist: python-docx>=1.1.0; extra == "documents"
25
+ Requires-Dist: python-pptx>=0.6.23; extra == "documents"
26
+ Requires-Dist: pypdf>=4.0.0; extra == "documents"
27
+ Provides-Extra: desktop
28
+ Requires-Dist: pywebview>=6.0; extra == "desktop"
29
+ Provides-Extra: web
30
+ Requires-Dist: fastapi>=0.110; extra == "web"
31
+ Requires-Dist: uvicorn>=0.23; extra == "web"
32
+ Provides-Extra: dev
33
+ Requires-Dist: pytest>=7.0; extra == "dev"
34
+ Requires-Dist: pytest-cov>=4.0; extra == "dev"
35
+ Requires-Dist: pre-commit>=3.0; python_version < "3.15" and extra == "dev"
36
+
37
+ # Abyss CLI
38
+
39
+ > 终端 AI 开发助手 · 类似 Claude Code,一个命令启动,一切在工具内完成。
40
+
41
+ ![Python](https://img.shields.io/badge/Python-3.9%2B-blue)
42
+ ![Version](https://img.shields.io/badge/version-2.3.0-green)
43
+
44
+ Abyss 是一个运行在终端里的 AI 开发助手:启动后通过自然语言驱动文件读写、Shell 执行、网页搜索等内置工具完成开发任务,并内置**长期记忆**、**知识库**、**子代理**、**Skill**、**MCP**、**Hook** 等扩展能力。默认采用 Ink 石墨深色 UI(磷光薄荷强调色 + 紧凑工作台横幅),并保留 `paper` / `ocean` / `hacker` 主题。
45
+
46
+ ## ✨ 功能特性
47
+
48
+ - **对话式开发**:多轮对话驱动工具调用,支持流式输出、思考过程显示(可开关)
49
+ - **Classic 精修布局**:区块头、经典 `TOOL BATCH` 工具批次、上下文构成、prompt 常驻状态
50
+ - **内置工具**:`file_read` / `file_write` / `file_edit` / `shell_exec` / `web_search` / `web_fetch` / `todo_write`
51
+ - **子代理(Subagent)**:并行拆分复杂任务,内置 Token 预算与费用核算
52
+ - **长期记忆**:跨会话记忆,BM25 检索 + LLM 重排(`/memory`)
53
+ - **知识库**:沉淀与归档经验知识,支持搜索、固定、统计(`/knowledge`)
54
+ - **Skill 系统**:可加载方法论(TDD、调试纪律、架构扫描等),自带 Curator 生命周期管理(`/skills`、`/curator`)
55
+ - **MCP 支持**:接入外部 MCP Server 与工具(`/mcp`)
56
+ - **Hook 机制**:PreToolUse 拦截、PostToolUse 审计,可安装扩展包(如 `security-hooks` 安全加固)
57
+ - **上下文管理**:自动/手动上下文压缩(`/compact`)、会话统计(`/stats`)
58
+ - **项目规则**:自动读取 `AGENTS.md`,兼容 `CLAUDE.md` / `.cursorrules`,规则修改后下一轮自动生效
59
+ - **Token 计费面板**:累计/逐轮明细与费用(`/token`),集成 DeepSeek 官方定价
60
+ - **Git 集成**:`/git` 归因命令族、`/diff` 查看差异、`/undo` / `/redo` 文件编辑回滚
61
+ - **AI 分析命令**:`/bug-hunter`、`/pr-review`、`/security-scan`、`/explain`、`/advisor`
62
+ - **Plan Mode**:只读规划模式,写/执行工具被门控(`/plan-mode`)
63
+ - **自适应思考预算**:根据上下文动态调节 `reasoning_effort`,省 token
64
+ - **自纠错循环**:工具调用失败自动重试修正(SelfCorrectionLoop)
65
+ - **附件托盘**:拖拽文件、`/attach`、`/pick`、`-a/--attach`;外部文件安全导入,界面只显示文件名
66
+ - **更强的 @ 引用**:支持 `@A1`、`@文件名`、带空格/中文的引号路径与行范围
67
+ - **安全防护**:路径安全校验、敏感信息过滤、危险命令黑名单、工具安全门卫
68
+
69
+ ## 🚀 安装
70
+
71
+ 要求 Python ≥ 3.9(CI 验证 3.11 / 3.13)。
72
+
73
+ > Python 3.15:核心依赖均有可用轮子,可直接安装;但 `pre-commit` 依赖的 PyYAML
74
+ > 尚无 cp315 轮子,`.[dev]` 会自动跳过 `pre-commit`。需要提交钩子时先免编译装 PyYAML:
75
+ > `pip install pyyaml --no-binary pyyaml --config-settings 'pyyaml_build_config={"with_cython": false}'`,
76
+ > 再 `pip install pre-commit` 并 `pre-commit install`。
77
+
78
+ ```bash
79
+ # 从源码安装(推荐开发模式)
80
+ pip install -e .
81
+
82
+ # 或仅安装
83
+ pip install .
84
+ ```
85
+
86
+ 安装完成后即可使用 `abyss` 命令:
87
+
88
+ ```bash
89
+ abyss
90
+ ```
91
+
92
+ ## 🖥️ 桌面版
93
+
94
+ 桌面版已经接通「会话 + 流式输出 + 工具事件 + 取消 + 设置 + 工具审批 + 四页真实数据」,
95
+ UI 以 [demos/abyss-desktop-demo.html](demos/abyss-desktop-demo.html) 为视觉基准。
96
+
97
+ ```powershell
98
+ # 安装桌面依赖(pywebview + WebView2,不引入 Node)
99
+ pip install -e ".[desktop]"
100
+
101
+ # PowerShell 不会从当前目录加载命令,必须加 .\abyss-desktop.cmd
102
+ .\abyss-desktop.cmd --fake # 不联网,使用演示引擎
103
+ .\abyss-desktop.cmd --smoke # 自动冒烟后关闭
104
+
105
+ # 或者把 .venv\Scripts 加入 PATH 后直接用
106
+ abyss-desktop
107
+ ```
108
+
109
+ > `cmd.exe` 和双击不需要 `.\` 前缀;只有 PowerShell 需要。
110
+ > 直接输入 `abyss-desktop.cmd` 会报 `CommandNotFoundException`,这是 PowerShell 的命令查找规则,不是文件缺失。
111
+
112
+ - 外壳:pywebview + Edge WebView2,单 Python 进程;引擎跑在 worker 线程;
113
+ 无原生标题栏,appbar 作为拖拽区并提供最小化 / 最大化 / 关闭;四边可缩放。
114
+ - 对话:会话、流式正文、TURN 轮次头、工具事件、取消、附件托盘、Plan 模式、
115
+ 子代理并行卡、工具详情抽屉(输入/输出/差异)。
116
+ - 侧栏:workspace 头、会话/文件 tab、会话重命名/导出/删除、改动文件列表、知识库/记忆入口。
117
+ - 页面:改动审查、知识与记忆、技能与方法论、扩展(MCP/Hooks/扩展包/定时任务)。
118
+ - 设置:模型 / 外观 / 工具与权限 / 数据 / 关于五组;主题、字号、密度、动效、fallback 模型。
119
+ - 命令面板:`Ctrl+K` 搜索结果 + 预览面板;slash 命令、文件引用、AI 分析、扩展命令。
120
+ - 审批:`shell_exec`、`file_write`、`file_edit`、`run_tests` 执行前确认,支持允许一次、本会话允许、拒绝。
121
+ - 本地写操作:添加/移除 MCP、Hook 启停、Cron 创建/删除、扩展安装/启停/回收、
122
+ 知识/记忆/技能编辑、会话 Markdown 导出、图片缩略图、实时 tok/s。
123
+ - 真实数据:改动审查读 `git status` / `git diff`;知识/记忆、技能/命令、Hook、MCP 配置与连接、
124
+ Cron 分别读 `KnowledgeLoader` / `MemoryStore` / `SkillLoader` / `SlashCommandRegistry` /
125
+ `HookRunner` / `MCPClientManager` / `CronTaskService`。没有 API Key 也能浏览这些页面。
126
+ - 代码:`src/abyss/desktop/`,按 `ipc/ chat/ control/ settings/ catalog/ actions/ host/ ui/`
127
+ 分模块,每个目录一个 `README.md`;详细设计在 `src/abyss/desktop/docs/`;实施计划:`docs/DESKTOP_SKELETON_PLAN.md`。
128
+ - 测试:`pytest tests/desktop -q`;窗口冒烟:`ABYSS_GUI_SMOKE=1 pytest tests/desktop -q`。
129
+
130
+ ## ⚙️ 配置
131
+
132
+ 首次启动需要配置 API Key(默认使用 DeepSeek):
133
+
134
+ ```bash
135
+ # 启动后在交互界面中设置
136
+ /config set api-key sk-xxxx
137
+
138
+ # 或直接编辑配置文件 ~/.abyss/config.json
139
+ ```
140
+
141
+ | 配置项 | 默认值 | 说明 |
142
+ | --- | --- | --- |
143
+ | `api_key` | 空 | API Key |
144
+ | `base_url` | `https://api.deepseek.com` | API 地址 |
145
+ | `api_format` | `responses` | LLM 接口格式(Responses / Chat Completions) |
146
+ | `model` | `deepseek-v4-pro` | 默认模型(`deepseek-v4-pro` / `deepseek-flash`) |
147
+ | `model_fallbacks` | `["deepseek-flash"]` | 模型自动降级链 |
148
+ | `thinking` | `true` | 是否开启思考模式 |
149
+ | `reasoning_effort` | `medium` | 思考强度 |
150
+ | `ui.theme` | `ink` | 界面主题:`ink` 石墨深色 / `paper` 浅色终端 / `ocean` 深海蓝 / `hacker` CRT 绿屏 |
151
+ | `ui.layout` | `calm` | 界面布局:`calm` 结果优先 / `classic` 精修日志;切换后重启生效 |
152
+ | `ui.banner` | `workbench` | 启动横幅:`workbench` 紧凑工作台 / `logo` 旧版 ASCII LOGO;切换后重启生效 |
153
+ | `ui.show_tps` | `true` | 输出速率(tok/s)展示:实时状态行 + 轮末 STREAM 汇总 + `/token` 速率列 |
154
+ | `show_reasoning` | `false` | 是否展开完整思考过程;`false` 时只保留思考摘要 |
155
+ | `tools_profile` | `core` | 工具 schema 档位:`core` 只暴露编码必需工具,`full` 暴露全部内置工具 |
156
+ | `plan_mode` | `false` | 只读规划模式 |
157
+
158
+ > 模型名以 DeepSeek V4.1 为准:`deepseek-flash`(V4.1-Flash,支持图片输入)与
159
+ > `deepseek-v4-pro`。旧名 `deepseek-v4-flash` / `deepseek-v4-flash-vision-exp`
160
+ > 已下线,abyss 读取配置或指定 `-m` 时会自动迁移到 `deepseek-flash`。
161
+ > `/token` 面板按 V4.1 高峰/空闲时段分别计价。
162
+
163
+ > 联网检索(`web_search`)默认链路为 Bing → DuckDuckGo;如需启用 AnySearch
164
+ > 主源(准确率优先),在 `~/.abyss/config.json` 配置 `anysearch_api_key`
165
+ > (可选 `anysearch_base_url`),或设置环境变量 `ANYSEARCH_API_KEY`
166
+ > / `ANYSEARCH_BASE_URL`。未配置时自动跳过,不影响原有行为。
167
+
168
+ ### 命令行参数
169
+
170
+ ```bash
171
+ abyss # 启动
172
+ abyss -m deepseek-flash # 指定模型(V4.1-Flash)
173
+ abyss -r # 恢复上次会话
174
+ abyss -r 会话名 # 恢复指定会话
175
+ abyss --show-reasoning # 展开思考过程(覆盖配置)
176
+ abyss --hide-reasoning # 只显示思考摘要(覆盖配置)
177
+ abyss -a report.docx # 启动时附加文件(可重复)
178
+ abyss -v # 显示版本
179
+ ```
180
+
181
+ ### 全屏 UI
182
+
183
+ | 操作 | 说明 |
184
+ | --- | --- |
185
+ | `Ctrl+K` | 全屏命令面板:搜索命令、最近使用、↑↓ 选择、Enter 执行、Tab 填入 |
186
+ | `/deck` | 只读会话仪表盘:任务、上下文、花费、最近消息;`q` / `Esc` 退出 |
187
+
188
+ 两者都使用独立 alternate screen,退出后恢复原终端内容,不影响 scrollback 和历史输出。
189
+
190
+ ## 📎 附件与 @ 引用
191
+
192
+ ### 添加附件
193
+
194
+ - 直接把文件拖进终端并回车。
195
+ - `/attach "C:\path\报告.docx" "C:\path\数据.xlsx"`。
196
+ - `/attach` 无参数或 `/pick` 打开系统文件选择器。
197
+ - `abyss -a report.docx -a data.xlsx` 启动时预加载附件。
198
+
199
+ 外部文件会由用户操作显式复制到当前 workspace 的 `.abyss/attachments/<session>/`,原文件不变。
200
+ Agent 只能看到工作区内的副本路径。终端只显示文件名、类型、大小和来源,不打印完整绝对路径。
201
+
202
+ 附件管理:
203
+
204
+ ```text
205
+ /attachments 查看当前附件
206
+ /detach A1 移除指定附件
207
+ /detach all 移除全部附件
208
+ ```
209
+
210
+ ### @ 引用
211
+
212
+ ```text
213
+ @src/main.py 引用整个文本文件
214
+ @src/main.py:L10-L20 引用行范围
215
+ @A1 引用当前附件
216
+ @报告.docx 引用唯一同名附件
217
+ @"路径 含空格.py":L10-L20 引号路径支持空格和中文
218
+ ```
219
+
220
+ 输入 `@` 会优先列出当前附件文件名,然后递归列出工作区文件;菜单只显示文件名。选择附件后插入 `@文件名` 或 `@A1`,不再展示完整路径。
221
+
222
+ ## 📖 Slash 命令
223
+
224
+ | 分类 | 命令 |
225
+ | --- | --- |
226
+ | 基础 | `/help` `/clear` `/exit` `/session` |
227
+ | 附件 | `/attach` `/attachments` `/detach` `/pick` |
228
+ | 会话 | `/retry` `/compact` `/undo` `/redo` `/stats` `/deck` `/token` `/logs` |
229
+ | Git | `/diff` `/git` |
230
+ | AI 分析 | `/bug-hunter` `/pr-review` `/security-scan` `/explain` `/advisor` |
231
+ | 扩展 | `/skills` `/mcp` `/hooks` `/curator` `/knowledge` |
232
+ | 记忆 | `/memory` |
233
+ | 方法论 | `/diagnose` `/tdd` `/review` `/audit` `/architecture` `/prototype` `/domain` |
234
+ | 配置 | `/model` `/effort` `/thinking` `/show-reasoning` `/plan-mode` `/config` `/version` |
235
+
236
+ 自定义命令:在 `~/.abyss/commands/` 下放置 `.md` 文件即可注册新的 slash 命令。
237
+
238
+ ## 🔌 Hook 扩展包
239
+
240
+ `security-hooks` 是通过 Hook 机制实现的安全加固包,**不修改核心代码**:
241
+
242
+ - **PreToolUse**:拦截危险 `shell_exec` 调用、禁止写入敏感目录、防知识库路径遍历
243
+ - **PostToolUse**:记录全部工具调用到 `~/.abyss/logs/tool-audit.log`
244
+
245
+ ```bash
246
+ # 安装
247
+ abyss extension install file://./security-hooks --id security-hooks --type hook
248
+
249
+ # 卸载
250
+ abyss extension remove security-hooks
251
+ ```
252
+
253
+ ## 🧪 测试
254
+
255
+ ```bash
256
+ pip install -e ".[dev]"
257
+
258
+ pytest -q # 全量(约 30s)
259
+ pytest -q -m "not slow" # 跳过慢测
260
+ pytest -q -m unit # 只跑纯单元
261
+ pytest -q -m live # 真机冒烟(需 ABYSS_LIVE=1 + ABYSS_API_KEY)
262
+ ```
263
+
264
+ 分层策略、CI 门禁与覆盖率门槛见 [docs/CI.md](docs/CI.md);分支与发布规范见 [docs/BRANCHING.md](docs/BRANCHING.md);后续方向见 [docs/OPTIMIZATION_ROADMAP.md](docs/OPTIMIZATION_ROADMAP.md)。
265
+
266
+ ## 📂 项目结构
267
+
268
+ ```
269
+ src/abyss/
270
+ ├── main.py # CLI 主入口
271
+ ├── agent_loop.py # 工具执行循环 / 自纠错
272
+ ├── ansi_menu.py # ANSI 补全菜单
273
+ ├── api_client.py # 原生 httpx LLM 客户端
274
+ ├── session.py # 会话管理
275
+ ├── context_engine.py # 上下文压缩
276
+ ├── commands/ # slash 命令实现
277
+ ├── tools/ # 内置工具
278
+ ├── subagent/ # 子代理
279
+ ├── memory/ # 长期记忆(BM25 + 重排)
280
+ ├── knowledge/ # 知识库
281
+ ├── skills/ # Skill 加载
282
+ ├── mcp/ # MCP 管理
283
+ ├── hooks/ # Hook 运行器
284
+ ├── security/ # 安全防护
285
+ ├── indexing/ # 符号索引 / 语义检索
286
+ ├── history/ # 文件事务与 undo/redo 快照
287
+ ├── validation/ # 测试运行与结构化失败
288
+ ├── desktop/ # pywebview 桌面工作台(IPC/引擎/控制/UI)
289
+ ├── ui/ # CLI 主题与渲染器
290
+ └── llm/ # LLM 弹性重试
291
+ ```
292
+
293
+ ## 📄 License
294
+
295
+ 本项目尚未指定开源许可证。上传到 GitHub 前请自行选择(如 MIT / Apache-2.0)并添加 LICENSE 文件。
@@ -0,0 +1,259 @@
1
+ # Abyss CLI
2
+
3
+ > 终端 AI 开发助手 · 类似 Claude Code,一个命令启动,一切在工具内完成。
4
+
5
+ ![Python](https://img.shields.io/badge/Python-3.9%2B-blue)
6
+ ![Version](https://img.shields.io/badge/version-2.3.0-green)
7
+
8
+ Abyss 是一个运行在终端里的 AI 开发助手:启动后通过自然语言驱动文件读写、Shell 执行、网页搜索等内置工具完成开发任务,并内置**长期记忆**、**知识库**、**子代理**、**Skill**、**MCP**、**Hook** 等扩展能力。默认采用 Ink 石墨深色 UI(磷光薄荷强调色 + 紧凑工作台横幅),并保留 `paper` / `ocean` / `hacker` 主题。
9
+
10
+ ## ✨ 功能特性
11
+
12
+ - **对话式开发**:多轮对话驱动工具调用,支持流式输出、思考过程显示(可开关)
13
+ - **Classic 精修布局**:区块头、经典 `TOOL BATCH` 工具批次、上下文构成、prompt 常驻状态
14
+ - **内置工具**:`file_read` / `file_write` / `file_edit` / `shell_exec` / `web_search` / `web_fetch` / `todo_write`
15
+ - **子代理(Subagent)**:并行拆分复杂任务,内置 Token 预算与费用核算
16
+ - **长期记忆**:跨会话记忆,BM25 检索 + LLM 重排(`/memory`)
17
+ - **知识库**:沉淀与归档经验知识,支持搜索、固定、统计(`/knowledge`)
18
+ - **Skill 系统**:可加载方法论(TDD、调试纪律、架构扫描等),自带 Curator 生命周期管理(`/skills`、`/curator`)
19
+ - **MCP 支持**:接入外部 MCP Server 与工具(`/mcp`)
20
+ - **Hook 机制**:PreToolUse 拦截、PostToolUse 审计,可安装扩展包(如 `security-hooks` 安全加固)
21
+ - **上下文管理**:自动/手动上下文压缩(`/compact`)、会话统计(`/stats`)
22
+ - **项目规则**:自动读取 `AGENTS.md`,兼容 `CLAUDE.md` / `.cursorrules`,规则修改后下一轮自动生效
23
+ - **Token 计费面板**:累计/逐轮明细与费用(`/token`),集成 DeepSeek 官方定价
24
+ - **Git 集成**:`/git` 归因命令族、`/diff` 查看差异、`/undo` / `/redo` 文件编辑回滚
25
+ - **AI 分析命令**:`/bug-hunter`、`/pr-review`、`/security-scan`、`/explain`、`/advisor`
26
+ - **Plan Mode**:只读规划模式,写/执行工具被门控(`/plan-mode`)
27
+ - **自适应思考预算**:根据上下文动态调节 `reasoning_effort`,省 token
28
+ - **自纠错循环**:工具调用失败自动重试修正(SelfCorrectionLoop)
29
+ - **附件托盘**:拖拽文件、`/attach`、`/pick`、`-a/--attach`;外部文件安全导入,界面只显示文件名
30
+ - **更强的 @ 引用**:支持 `@A1`、`@文件名`、带空格/中文的引号路径与行范围
31
+ - **安全防护**:路径安全校验、敏感信息过滤、危险命令黑名单、工具安全门卫
32
+
33
+ ## 🚀 安装
34
+
35
+ 要求 Python ≥ 3.9(CI 验证 3.11 / 3.13)。
36
+
37
+ > Python 3.15:核心依赖均有可用轮子,可直接安装;但 `pre-commit` 依赖的 PyYAML
38
+ > 尚无 cp315 轮子,`.[dev]` 会自动跳过 `pre-commit`。需要提交钩子时先免编译装 PyYAML:
39
+ > `pip install pyyaml --no-binary pyyaml --config-settings 'pyyaml_build_config={"with_cython": false}'`,
40
+ > 再 `pip install pre-commit` 并 `pre-commit install`。
41
+
42
+ ```bash
43
+ # 从源码安装(推荐开发模式)
44
+ pip install -e .
45
+
46
+ # 或仅安装
47
+ pip install .
48
+ ```
49
+
50
+ 安装完成后即可使用 `abyss` 命令:
51
+
52
+ ```bash
53
+ abyss
54
+ ```
55
+
56
+ ## 🖥️ 桌面版
57
+
58
+ 桌面版已经接通「会话 + 流式输出 + 工具事件 + 取消 + 设置 + 工具审批 + 四页真实数据」,
59
+ UI 以 [demos/abyss-desktop-demo.html](demos/abyss-desktop-demo.html) 为视觉基准。
60
+
61
+ ```powershell
62
+ # 安装桌面依赖(pywebview + WebView2,不引入 Node)
63
+ pip install -e ".[desktop]"
64
+
65
+ # PowerShell 不会从当前目录加载命令,必须加 .\abyss-desktop.cmd
66
+ .\abyss-desktop.cmd --fake # 不联网,使用演示引擎
67
+ .\abyss-desktop.cmd --smoke # 自动冒烟后关闭
68
+
69
+ # 或者把 .venv\Scripts 加入 PATH 后直接用
70
+ abyss-desktop
71
+ ```
72
+
73
+ > `cmd.exe` 和双击不需要 `.\` 前缀;只有 PowerShell 需要。
74
+ > 直接输入 `abyss-desktop.cmd` 会报 `CommandNotFoundException`,这是 PowerShell 的命令查找规则,不是文件缺失。
75
+
76
+ - 外壳:pywebview + Edge WebView2,单 Python 进程;引擎跑在 worker 线程;
77
+ 无原生标题栏,appbar 作为拖拽区并提供最小化 / 最大化 / 关闭;四边可缩放。
78
+ - 对话:会话、流式正文、TURN 轮次头、工具事件、取消、附件托盘、Plan 模式、
79
+ 子代理并行卡、工具详情抽屉(输入/输出/差异)。
80
+ - 侧栏:workspace 头、会话/文件 tab、会话重命名/导出/删除、改动文件列表、知识库/记忆入口。
81
+ - 页面:改动审查、知识与记忆、技能与方法论、扩展(MCP/Hooks/扩展包/定时任务)。
82
+ - 设置:模型 / 外观 / 工具与权限 / 数据 / 关于五组;主题、字号、密度、动效、fallback 模型。
83
+ - 命令面板:`Ctrl+K` 搜索结果 + 预览面板;slash 命令、文件引用、AI 分析、扩展命令。
84
+ - 审批:`shell_exec`、`file_write`、`file_edit`、`run_tests` 执行前确认,支持允许一次、本会话允许、拒绝。
85
+ - 本地写操作:添加/移除 MCP、Hook 启停、Cron 创建/删除、扩展安装/启停/回收、
86
+ 知识/记忆/技能编辑、会话 Markdown 导出、图片缩略图、实时 tok/s。
87
+ - 真实数据:改动审查读 `git status` / `git diff`;知识/记忆、技能/命令、Hook、MCP 配置与连接、
88
+ Cron 分别读 `KnowledgeLoader` / `MemoryStore` / `SkillLoader` / `SlashCommandRegistry` /
89
+ `HookRunner` / `MCPClientManager` / `CronTaskService`。没有 API Key 也能浏览这些页面。
90
+ - 代码:`src/abyss/desktop/`,按 `ipc/ chat/ control/ settings/ catalog/ actions/ host/ ui/`
91
+ 分模块,每个目录一个 `README.md`;详细设计在 `src/abyss/desktop/docs/`;实施计划:`docs/DESKTOP_SKELETON_PLAN.md`。
92
+ - 测试:`pytest tests/desktop -q`;窗口冒烟:`ABYSS_GUI_SMOKE=1 pytest tests/desktop -q`。
93
+
94
+ ## ⚙️ 配置
95
+
96
+ 首次启动需要配置 API Key(默认使用 DeepSeek):
97
+
98
+ ```bash
99
+ # 启动后在交互界面中设置
100
+ /config set api-key sk-xxxx
101
+
102
+ # 或直接编辑配置文件 ~/.abyss/config.json
103
+ ```
104
+
105
+ | 配置项 | 默认值 | 说明 |
106
+ | --- | --- | --- |
107
+ | `api_key` | 空 | API Key |
108
+ | `base_url` | `https://api.deepseek.com` | API 地址 |
109
+ | `api_format` | `responses` | LLM 接口格式(Responses / Chat Completions) |
110
+ | `model` | `deepseek-v4-pro` | 默认模型(`deepseek-v4-pro` / `deepseek-flash`) |
111
+ | `model_fallbacks` | `["deepseek-flash"]` | 模型自动降级链 |
112
+ | `thinking` | `true` | 是否开启思考模式 |
113
+ | `reasoning_effort` | `medium` | 思考强度 |
114
+ | `ui.theme` | `ink` | 界面主题:`ink` 石墨深色 / `paper` 浅色终端 / `ocean` 深海蓝 / `hacker` CRT 绿屏 |
115
+ | `ui.layout` | `calm` | 界面布局:`calm` 结果优先 / `classic` 精修日志;切换后重启生效 |
116
+ | `ui.banner` | `workbench` | 启动横幅:`workbench` 紧凑工作台 / `logo` 旧版 ASCII LOGO;切换后重启生效 |
117
+ | `ui.show_tps` | `true` | 输出速率(tok/s)展示:实时状态行 + 轮末 STREAM 汇总 + `/token` 速率列 |
118
+ | `show_reasoning` | `false` | 是否展开完整思考过程;`false` 时只保留思考摘要 |
119
+ | `tools_profile` | `core` | 工具 schema 档位:`core` 只暴露编码必需工具,`full` 暴露全部内置工具 |
120
+ | `plan_mode` | `false` | 只读规划模式 |
121
+
122
+ > 模型名以 DeepSeek V4.1 为准:`deepseek-flash`(V4.1-Flash,支持图片输入)与
123
+ > `deepseek-v4-pro`。旧名 `deepseek-v4-flash` / `deepseek-v4-flash-vision-exp`
124
+ > 已下线,abyss 读取配置或指定 `-m` 时会自动迁移到 `deepseek-flash`。
125
+ > `/token` 面板按 V4.1 高峰/空闲时段分别计价。
126
+
127
+ > 联网检索(`web_search`)默认链路为 Bing → DuckDuckGo;如需启用 AnySearch
128
+ > 主源(准确率优先),在 `~/.abyss/config.json` 配置 `anysearch_api_key`
129
+ > (可选 `anysearch_base_url`),或设置环境变量 `ANYSEARCH_API_KEY`
130
+ > / `ANYSEARCH_BASE_URL`。未配置时自动跳过,不影响原有行为。
131
+
132
+ ### 命令行参数
133
+
134
+ ```bash
135
+ abyss # 启动
136
+ abyss -m deepseek-flash # 指定模型(V4.1-Flash)
137
+ abyss -r # 恢复上次会话
138
+ abyss -r 会话名 # 恢复指定会话
139
+ abyss --show-reasoning # 展开思考过程(覆盖配置)
140
+ abyss --hide-reasoning # 只显示思考摘要(覆盖配置)
141
+ abyss -a report.docx # 启动时附加文件(可重复)
142
+ abyss -v # 显示版本
143
+ ```
144
+
145
+ ### 全屏 UI
146
+
147
+ | 操作 | 说明 |
148
+ | --- | --- |
149
+ | `Ctrl+K` | 全屏命令面板:搜索命令、最近使用、↑↓ 选择、Enter 执行、Tab 填入 |
150
+ | `/deck` | 只读会话仪表盘:任务、上下文、花费、最近消息;`q` / `Esc` 退出 |
151
+
152
+ 两者都使用独立 alternate screen,退出后恢复原终端内容,不影响 scrollback 和历史输出。
153
+
154
+ ## 📎 附件与 @ 引用
155
+
156
+ ### 添加附件
157
+
158
+ - 直接把文件拖进终端并回车。
159
+ - `/attach "C:\path\报告.docx" "C:\path\数据.xlsx"`。
160
+ - `/attach` 无参数或 `/pick` 打开系统文件选择器。
161
+ - `abyss -a report.docx -a data.xlsx` 启动时预加载附件。
162
+
163
+ 外部文件会由用户操作显式复制到当前 workspace 的 `.abyss/attachments/<session>/`,原文件不变。
164
+ Agent 只能看到工作区内的副本路径。终端只显示文件名、类型、大小和来源,不打印完整绝对路径。
165
+
166
+ 附件管理:
167
+
168
+ ```text
169
+ /attachments 查看当前附件
170
+ /detach A1 移除指定附件
171
+ /detach all 移除全部附件
172
+ ```
173
+
174
+ ### @ 引用
175
+
176
+ ```text
177
+ @src/main.py 引用整个文本文件
178
+ @src/main.py:L10-L20 引用行范围
179
+ @A1 引用当前附件
180
+ @报告.docx 引用唯一同名附件
181
+ @"路径 含空格.py":L10-L20 引号路径支持空格和中文
182
+ ```
183
+
184
+ 输入 `@` 会优先列出当前附件文件名,然后递归列出工作区文件;菜单只显示文件名。选择附件后插入 `@文件名` 或 `@A1`,不再展示完整路径。
185
+
186
+ ## 📖 Slash 命令
187
+
188
+ | 分类 | 命令 |
189
+ | --- | --- |
190
+ | 基础 | `/help` `/clear` `/exit` `/session` |
191
+ | 附件 | `/attach` `/attachments` `/detach` `/pick` |
192
+ | 会话 | `/retry` `/compact` `/undo` `/redo` `/stats` `/deck` `/token` `/logs` |
193
+ | Git | `/diff` `/git` |
194
+ | AI 分析 | `/bug-hunter` `/pr-review` `/security-scan` `/explain` `/advisor` |
195
+ | 扩展 | `/skills` `/mcp` `/hooks` `/curator` `/knowledge` |
196
+ | 记忆 | `/memory` |
197
+ | 方法论 | `/diagnose` `/tdd` `/review` `/audit` `/architecture` `/prototype` `/domain` |
198
+ | 配置 | `/model` `/effort` `/thinking` `/show-reasoning` `/plan-mode` `/config` `/version` |
199
+
200
+ 自定义命令:在 `~/.abyss/commands/` 下放置 `.md` 文件即可注册新的 slash 命令。
201
+
202
+ ## 🔌 Hook 扩展包
203
+
204
+ `security-hooks` 是通过 Hook 机制实现的安全加固包,**不修改核心代码**:
205
+
206
+ - **PreToolUse**:拦截危险 `shell_exec` 调用、禁止写入敏感目录、防知识库路径遍历
207
+ - **PostToolUse**:记录全部工具调用到 `~/.abyss/logs/tool-audit.log`
208
+
209
+ ```bash
210
+ # 安装
211
+ abyss extension install file://./security-hooks --id security-hooks --type hook
212
+
213
+ # 卸载
214
+ abyss extension remove security-hooks
215
+ ```
216
+
217
+ ## 🧪 测试
218
+
219
+ ```bash
220
+ pip install -e ".[dev]"
221
+
222
+ pytest -q # 全量(约 30s)
223
+ pytest -q -m "not slow" # 跳过慢测
224
+ pytest -q -m unit # 只跑纯单元
225
+ pytest -q -m live # 真机冒烟(需 ABYSS_LIVE=1 + ABYSS_API_KEY)
226
+ ```
227
+
228
+ 分层策略、CI 门禁与覆盖率门槛见 [docs/CI.md](docs/CI.md);分支与发布规范见 [docs/BRANCHING.md](docs/BRANCHING.md);后续方向见 [docs/OPTIMIZATION_ROADMAP.md](docs/OPTIMIZATION_ROADMAP.md)。
229
+
230
+ ## 📂 项目结构
231
+
232
+ ```
233
+ src/abyss/
234
+ ├── main.py # CLI 主入口
235
+ ├── agent_loop.py # 工具执行循环 / 自纠错
236
+ ├── ansi_menu.py # ANSI 补全菜单
237
+ ├── api_client.py # 原生 httpx LLM 客户端
238
+ ├── session.py # 会话管理
239
+ ├── context_engine.py # 上下文压缩
240
+ ├── commands/ # slash 命令实现
241
+ ├── tools/ # 内置工具
242
+ ├── subagent/ # 子代理
243
+ ├── memory/ # 长期记忆(BM25 + 重排)
244
+ ├── knowledge/ # 知识库
245
+ ├── skills/ # Skill 加载
246
+ ├── mcp/ # MCP 管理
247
+ ├── hooks/ # Hook 运行器
248
+ ├── security/ # 安全防护
249
+ ├── indexing/ # 符号索引 / 语义检索
250
+ ├── history/ # 文件事务与 undo/redo 快照
251
+ ├── validation/ # 测试运行与结构化失败
252
+ ├── desktop/ # pywebview 桌面工作台(IPC/引擎/控制/UI)
253
+ ├── ui/ # CLI 主题与渲染器
254
+ └── llm/ # LLM 弹性重试
255
+ ```
256
+
257
+ ## 📄 License
258
+
259
+ 本项目尚未指定开源许可证。上传到 GitHub 前请自行选择(如 MIT / Apache-2.0)并添加 LICENSE 文件。
@@ -0,0 +1,128 @@
1
+ [build-system]
2
+ requires = ["setuptools>=45", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "abyss-cli"
7
+ version = "2.4.0"
8
+ description = "终端AI开发助手"
9
+ readme = "README.md"
10
+ authors = [{name = "Abyss Team"}]
11
+ requires-python = ">=3.9"
12
+ dependencies = [
13
+ "click>=8.0.0",
14
+ "prompt-toolkit>=3.0.0",
15
+ "ddgs>=9.0.0",
16
+ "httpx>=0.20.0",
17
+ "mcp>=1.0.0",
18
+ "tiktoken>=0.5.0",
19
+ "tokenizers>=0.15.0",
20
+ "jinja2>=3.0.0",
21
+ ]
22
+
23
+ [project.optional-dependencies]
24
+ # openai SDK 已由原生 httpx 客户端替代(src/abyss/api_client.py),
25
+ # 保留为可选 extras 仅供需要旧 SDK 的场景手动安装,代码零运行时引用。
26
+ openai = ["openai>=1.0.0"]
27
+ # 语义检索(A3):本地 ONNX embedding + 向量运算。核心功能不依赖此 extra。
28
+ indexing = ["onnxruntime>=1.17", "numpy>=1.24"]
29
+ # 文档读取:file_read 解析 XLSX/XLS/DOCX/PPTX/PDF。
30
+ documents = [
31
+ "openpyxl>=3.1.0",
32
+ "xlrd>=2.0.1",
33
+ "python-docx>=1.1.0",
34
+ "python-pptx>=0.6.23",
35
+ "pypdf>=4.0.0",
36
+ ]
37
+ # 桌面版外壳:pywebview + Edge WebView2(Windows 10/11 自带运行时)
38
+ desktop = ["pywebview>=6.0"]
39
+ # 浏览器版:FastAPI 端口 + React 前端(前端依赖见 web/package.json)
40
+ web = ["fastapi>=0.110", "uvicorn>=0.23"]
41
+ # 开发/CI 依赖:pip install -e ".[dev]"
42
+ dev = [
43
+ "pytest>=7.0",
44
+ "pytest-cov>=4.0",
45
+ # PyYAML 最新 6.0.3 只提供到 cp314 的 Windows 轮子,3.15 上装 pre-commit
46
+ # 会回落到源码编译并要求 MSVC;这里跳过,避免 `.[dev]` 整体安装失败。
47
+ "pre-commit>=3.0; python_version < '3.15'",
48
+ ]
49
+
50
+ [project.scripts]
51
+ # 【启动关键】必须指向 launcher(先打印 loading 行再触发 abyss.main 重导入,
52
+ # 冷启动即时反馈)。勿改回 "abyss.main:cli"——会退回黑屏数秒且绕过 VT 启用
53
+ abyss = "abyss.launcher:main"
54
+ abyss-desktop = "abyss.desktop.__main__:main"
55
+ abyss-web = "abyss.web.__main__:main"
56
+ abyss-qa = "abyss.qa.__main__:main"
57
+
58
+ [tool.setuptools]
59
+ package-dir = {"" = "src"}
60
+ include-package-data = true
61
+
62
+ [tool.setuptools.packages.find]
63
+ where = ["src"]
64
+
65
+ [tool.setuptools.package-data]
66
+ abyss = [
67
+ "prompts/system_prompt.md",
68
+ "tokenizer_files/*.json",
69
+ "desktop/ui/*.html",
70
+ "desktop/ui/*.css",
71
+ "desktop/ui/*.js",
72
+ "desktop/ui/*.ico",
73
+ "qa/assets/*.html",
74
+ "qa/assets/*.css",
75
+ "qa/assets/*.js",
76
+ ]
77
+
78
+ # ---------------------------------------------------------------------------
79
+ # 测试配置(pytest + coverage)
80
+ # 大型项目测试规范:
81
+ # - pytest 收集 tests/ 下所有 test_*.py
82
+ # - 严格标记:markers 区分 unit / integration / slow
83
+ # - 覆盖率:tools 包目标 90%+,整体逐步提升
84
+ # ---------------------------------------------------------------------------
85
+ [tool.pytest.ini_options]
86
+ minversion = "7.0"
87
+ testpaths = ["tests"]
88
+ python_files = ["test_*.py"]
89
+ python_classes = ["Test*"]
90
+ python_functions = ["test_*"]
91
+ addopts = [
92
+ "-ra",
93
+ "--strict-markers",
94
+ "--strict-config",
95
+ "-W error::DeprecationWarning",
96
+ ]
97
+ markers = [
98
+ "unit: 纯函数/单类单元测试,无外部依赖(默认全部运行)",
99
+ "integration: 集成测试,涉及真实文件系统或多组件协作",
100
+ "concurrency: 并发安全测试,多线程压测",
101
+ "slow: 较慢的测试(重试退避、网络模拟),可用 -m 'not slow' 跳过",
102
+ "live: 真实 API 冒烟(需要 ABYSS_LIVE=1 + ABYSS_API_KEY),CI 只在夜间/手动跑",
103
+ "gui: 需要打开原生窗口的桌面冒烟(需要 ABYSS_GUI_SMOKE=1),默认跳过",
104
+ ]
105
+
106
+ [tool.coverage.run]
107
+ source = ["src/abyss"]
108
+ branch = true
109
+ omit = [
110
+ "*/tokenizer_files/*",
111
+ "*/__pycache__/*",
112
+ "*/setup.py",
113
+ ]
114
+
115
+ [tool.coverage.report]
116
+ precision = 1
117
+ show_missing = true
118
+ skip_covered = false
119
+ exclude_lines = [
120
+ "pragma: no cover",
121
+ "raise NotImplementedError",
122
+ "if __name__ == .__main__.:",
123
+ "if TYPE_CHECKING:",
124
+ "@abstractmethod",
125
+ ]
126
+
127
+ [tool.coverage.html]
128
+ directory = "htmlcov"