coding-proxy 0.6.0__tar.gz → 0.6.1__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 (233) hide show
  1. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/CHANGELOG.md +12 -0
  2. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/PKG-INFO +1 -1
  3. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/.agents/knowledge-map.md +1 -0
  4. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/arch/config-reference.md +22 -0
  5. coding_proxy-0.6.1/docs/arch/session-model-bind.md +84 -0
  6. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/arch/vendors.md +2 -0
  7. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/pyproject.toml +1 -1
  8. coding_proxy-0.6.1/scripts/backfill_session_titles.py +275 -0
  9. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/cli/__init__.py +29 -6
  10. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/config.default.yaml +15 -0
  11. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/session_policy.py +64 -0
  12. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/ui_registry.py +31 -0
  13. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/executor.py +294 -22
  14. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/model_mapper.py +14 -5
  15. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/router.py +6 -0
  16. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/session_policy.py +42 -11
  17. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/app.py +3 -0
  18. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/dashboard.py +26 -20
  19. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/generations.py +57 -13
  20. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/routes.py +52 -7
  21. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/static/config/config.js +14 -2
  22. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/antigravity.py +10 -0
  23. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/base.py +10 -0
  24. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/native_anthropic.py +4 -0
  25. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_antigravity.py +25 -0
  26. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_app_routes.py +225 -0
  27. coding_proxy-0.6.1/tests/test_backfill_session_titles.py +166 -0
  28. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_cli_usage.py +95 -0
  29. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_loader.py +16 -0
  30. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_dashboard_config_tab.py +17 -1
  31. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_generations.py +40 -0
  32. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_generations_app.py +39 -0
  33. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_router_executor.py +591 -0
  34. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_session_aware.py +171 -0
  35. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/.github/workflows/ci.yml +0 -0
  36. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/.github/workflows/coverage.yml +0 -0
  37. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/.github/workflows/release.yml +0 -0
  38. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/.gitignore +0 -0
  39. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/.pre-commit-config.yaml +0 -0
  40. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/LICENSE +0 -0
  41. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/README.md +0 -0
  42. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/assets/dashboard/config-tab.png +0 -0
  43. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/assets/dashboard-v0.4.0.png +0 -0
  44. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/assets/logo.svg +0 -0
  45. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/assets/model-calling-v0.5.0.png +0 -0
  46. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/assets/session-v0.4.0.png +0 -0
  47. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/.agents/issue.md +0 -0
  48. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/arch/convert.md +0 -0
  49. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/arch/design-patterns.md +0 -0
  50. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/arch/routing.md +0 -0
  51. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/arch/testing.md +0 -0
  52. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/diagrams/config-resolution-storage/config-resolution-storage.html +0 -0
  53. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/diagrams/config-resolution-storage/config-resolution-storage.json +0 -0
  54. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/diagrams/config-resolution-storage/config-resolution-storage.svg +0 -0
  55. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/diagrams/config-resolution-storage/config-resolution-storage.visual-check.json +0 -0
  56. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/framework.md +0 -0
  57. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/guide/api-reference.md +0 -0
  58. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/guide/cli-reference.md +0 -0
  59. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/guide/dashboard.md +0 -0
  60. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/guide/monitoring.md +0 -0
  61. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/guide/quickstart.md +0 -0
  62. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/guide/vendors.md +0 -0
  63. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/ops/ci-cd.md +0 -0
  64. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/user-guide.md +0 -0
  65. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/docs/zh-CN/README.md +0 -0
  66. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/__init__.py +0 -0
  67. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/__init__.py +0 -0
  68. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/__main__.py +0 -0
  69. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/auth/__init__.py +0 -0
  70. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/auth/providers/__init__.py +0 -0
  71. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/auth/providers/base.py +0 -0
  72. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/auth/providers/github.py +0 -0
  73. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/auth/providers/google.py +0 -0
  74. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/auth/runtime.py +0 -0
  75. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/auth/store.py +0 -0
  76. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/cli/auth_commands.py +0 -0
  77. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/cli/banner.py +0 -0
  78. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/cli/config_commands.py +0 -0
  79. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/compat/__init__.py +0 -0
  80. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/compat/canonical.py +0 -0
  81. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/compat/session_store.py +0 -0
  82. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/__init__.py +0 -0
  83. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/auth_schema.py +0 -0
  84. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/defaults.py +0 -0
  85. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/home.py +0 -0
  86. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/importer.py +0 -0
  87. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/loader.py +0 -0
  88. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/normalize.py +0 -0
  89. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/resiliency.py +0 -0
  90. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/resolver.py +0 -0
  91. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/routing.py +0 -0
  92. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/schema.py +0 -0
  93. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/secrets.py +0 -0
  94. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/server.py +0 -0
  95. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/service.py +0 -0
  96. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/store.py +0 -0
  97. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/config/vendors.py +0 -0
  98. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/convert/__init__.py +0 -0
  99. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/convert/anthropic_to_gemini.py +0 -0
  100. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/convert/anthropic_to_openai.py +0 -0
  101. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/convert/gemini_sse_adapter.py +0 -0
  102. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/convert/gemini_to_anthropic.py +0 -0
  103. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/convert/openai_to_anthropic.py +0 -0
  104. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/convert/vendor_channels.py +0 -0
  105. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/logging/__init__.py +0 -0
  106. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/logging/db.py +0 -0
  107. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/logging/formatters.py +0 -0
  108. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/logging/stats.py +0 -0
  109. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/model/__init__.py +0 -0
  110. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/model/auth.py +0 -0
  111. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/model/compat.py +0 -0
  112. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/model/constants.py +0 -0
  113. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/model/pricing.py +0 -0
  114. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/model/token.py +0 -0
  115. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/model/vendor.py +0 -0
  116. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/__init__.py +0 -0
  117. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/config.py +0 -0
  118. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/extractors/__init__.py +0 -0
  119. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/extractors/anthropic.py +0 -0
  120. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/extractors/gemini.py +0 -0
  121. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/extractors/openai.py +0 -0
  122. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/handler.py +0 -0
  123. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/operation.py +0 -0
  124. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/routes.py +0 -0
  125. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/native_api/usage_registry.py +0 -0
  126. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/pricing.py +0 -0
  127. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/__init__.py +0 -0
  128. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/circuit_breaker.py +0 -0
  129. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/error_classifier.py +0 -0
  130. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/quota_guard.py +0 -0
  131. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/rate_limit.py +0 -0
  132. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/retry.py +0 -0
  133. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/session_manager.py +0 -0
  134. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/tier.py +0 -0
  135. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/usage_parser.py +0 -0
  136. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/routing/usage_recorder.py +0 -0
  137. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/__init__.py +0 -0
  138. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/config_routes.py +0 -0
  139. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/factory.py +0 -0
  140. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/responses.py +0 -0
  141. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/security.py +0 -0
  142. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/server/static/config/config.css +0 -0
  143. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/streaming/__init__.py +0 -0
  144. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/streaming/anthropic_compat.py +0 -0
  145. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/__init__.py +0 -0
  146. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/alibaba.py +0 -0
  147. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/anthropic.py +0 -0
  148. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/concurrency.py +0 -0
  149. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/copilot.py +0 -0
  150. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/copilot_models.py +0 -0
  151. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/copilot_token_manager.py +0 -0
  152. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/copilot_urls.py +0 -0
  153. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/doubao.py +0 -0
  154. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/kimi.py +0 -0
  155. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/minimax.py +0 -0
  156. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/mixins.py +0 -0
  157. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/token_manager.py +0 -0
  158. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/xiaomi.py +0 -0
  159. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/src/coding/proxy/vendors/zhipu.py +0 -0
  160. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/__init__.py +0 -0
  161. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/conftest.py +0 -0
  162. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/e2e/__init__.py +0 -0
  163. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/e2e/conftest.py +0 -0
  164. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/e2e/test_e2e_http.py +0 -0
  165. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/e2e/test_e2e_token.py +0 -0
  166. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/e2e/test_e2e_vendor.py +0 -0
  167. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/fixtures/legacy_config_default_v052.yaml +0 -0
  168. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_auto_login.py +0 -0
  169. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_banner.py +0 -0
  170. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_circuit_breaker.py +0 -0
  171. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_compat.py +0 -0
  172. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_concurrency_monitor.py +0 -0
  173. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_api.py +0 -0
  174. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_cli.py +0 -0
  175. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_import.py +0 -0
  176. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_init.py +0 -0
  177. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_normalize.py +0 -0
  178. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_secrets.py +0 -0
  179. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_service.py +0 -0
  180. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_store.py +0 -0
  181. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_config_ui_registry.py +0 -0
  182. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_convert_request.py +0 -0
  183. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_convert_response.py +0 -0
  184. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_convert_sse.py +0 -0
  185. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_copilot.py +0 -0
  186. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_copilot_convert_request.py +0 -0
  187. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_copilot_convert_response.py +0 -0
  188. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_copilot_models.py +0 -0
  189. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_copilot_urls.py +0 -0
  190. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_currency.py +0 -0
  191. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_error_classifier.py +0 -0
  192. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_executor_in_flight_tracking.py +0 -0
  193. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_generations_cli.py +0 -0
  194. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_logging_dual_write.py +0 -0
  195. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_mixins.py +0 -0
  196. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_model_auth.py +0 -0
  197. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_model_compat.py +0 -0
  198. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_model_constants.py +0 -0
  199. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_model_mapper.py +0 -0
  200. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_model_pricing.py +0 -0
  201. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_model_token.py +0 -0
  202. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_model_vendor.py +0 -0
  203. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_native_api_base_url_override.py +0 -0
  204. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_native_api_extractors.py +0 -0
  205. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_native_api_handler.py +0 -0
  206. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_native_api_operation.py +0 -0
  207. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_native_api_routes.py +0 -0
  208. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_native_vendors.py +0 -0
  209. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_parse_usage.py +0 -0
  210. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_parse_usage_gemini.py +0 -0
  211. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_pricing.py +0 -0
  212. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_quota_guard.py +0 -0
  213. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_rate_limit.py +0 -0
  214. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_retry.py +0 -0
  215. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_router_chain.py +0 -0
  216. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_runtime_reauth.py +0 -0
  217. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_schema.py +0 -0
  218. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_security_middleware.py +0 -0
  219. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_streaming_anthropic_compat.py +0 -0
  220. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_tier.py +0 -0
  221. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_tiers_config.py +0 -0
  222. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_time_range.py +0 -0
  223. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_token_logger.py +0 -0
  224. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_token_logger_native_columns.py +0 -0
  225. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_token_manager.py +0 -0
  226. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_types.py +0 -0
  227. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_vendor_channels.py +0 -0
  228. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_vendor_helpers.py +0 -0
  229. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_vendor_streaming.py +0 -0
  230. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_vendors.py +0 -0
  231. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_zhipu.py +0 -0
  232. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/tests/test_zhipu_concurrency.py +0 -0
  233. {coding_proxy-0.6.0 → coding_proxy-0.6.1}/uv.lock +0 -0
@@ -2,6 +2,18 @@
2
2
 
3
3
  本文件基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/) 规范维护,版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
4
4
 
5
+ ## [v0.6.1](https://github.com/ThreeFish-AI/coding-proxy/releases/tag/v0.6.1) - 2026-11-16
6
+
7
+ > 本周期主轴:Dashboard Sessions 页「Vendor Bind」升级为「Model Bind」,支持对运行中的 Claude Code 会话在不打断任务执行的前提下切换实际所用模型(含跨系列)。经 7 轮独立 Review-Fix 循环收敛(16 项缺陷修复)。
8
+
9
+ - feat(session-model-bind): 新增**会话级模型绑定**——`SessionPolicy` 增可选 `model` 字段,绑定后该 Session 的后续请求体 `model` 统一改写(shadow copy,逐请求生效),在途请求按旧捕获值完成、下一请求即时按新值路由,任务执行零打断(隔离实例 + mock 上游实验 15/15 断言实证);Dashboard「Vendor Bind」列整体替换为「Model Bind」(选项来自新配置 `session_policies.bindable_models` 清单,默认 claude 三档零额外配置;Default = 清除整条绑定,vendor-only 绑定以 `Default (vendor: …)` 标注可见);跨系列原生模型名(如 `glm-5.3`)入清单需配套 identity `model_mapping` 规则,防 `ModelMapper` default 静默改写;CLI `session bind` 增 `--model`(与 `--vendor` 可组合);`PUT /api/session-vendor` 增可选 `model`(清单外 400,清单为空时报错指向根因配置项),`GET` 回显 model、`/api/status` 增返 `bindable_models`;
10
+ - fix(session-policy): 修复**标题前缀自动绑定覆盖手动绑定**的既有缺陷——`_apply_title_based_policy` 遇已有运行时绑定即跳过(compat TTL 24h 过期导致长会话被重新判定为新会话时同样受保护);仅绑模型(tiers 为空)时 resolver 继承链按「现有运行时绑定 > key 级配置备份 > category 配置」兑现「不改 vendor 顺序」承诺,PUT 响应回显继承后的生效 tiers/model;
11
+ - feat(model-mapper): `ModelMapper` 增 `map_with_reason`(exact / pattern / default),`BaseVendor` 新增 `map_model_with_reason` 扩展点(native 系与 antigravity 覆写真实命中原因)——会话模型漂移告警据此区分「配置内等价映射」(如 claude 档位名 → glm 档位名,不告警)与「default 回退改写 / 上游换名」(WARNING,缺规则场景附 identity 规则修复指引),默认配置主路径零告警噪声;
12
+ - fix(generations): **配置热切换(generation swap)迁移保留模型绑定**——`_migrate_bindings` 由只搬 vendors 扩为三元迁移(vendor 需仍在新链路、模型需仍在 `bindable_models` 清单,单侧失效降级保留另一侧),`reset_runtime` 对称提示整条移除 / vendor 侧降级 / 模型侧降级,文案不再预设绑定含模型;
13
+ - feat(config-ui): Config 页 Session Policies 分区交付 `bindable_models` 清单编辑(Label/Model/Tiers 三列 listBlock)与策略条目的 `Model` 覆盖字段(`policies.*.model` 空串清空归一为未设置,不再 422 卡死);config ui_registry 覆盖门同步登记 5 个新叶子;
14
+ - docs: 新增 `arch/session-model-bind.md` 设计与实现锚点(数据流、配置、API/CLI、UI、风险边界、测试锚点);`arch/config-reference.md` 补 §11 session_policies 节(含生命周期口径:重启回落配置态、热切换迁移保留);`arch/vendors.md` 补 `map_model_with_reason` 方法契约;
15
+ - test: 补齐 30+ 守护用例——resolver 继承链与 model 语义、在途请求隔离(流式 / 非流式)、漂移告警三分支与负向控制、路由级 PUT/DELETE/GET 全分支、默认清单加载守护、CLI payload、热切换迁移计数、Config 页渲染契约;
16
+
5
17
  ## [v0.6.0](https://github.com/ThreeFish-AI/coding-proxy/releases/tag/v0.6.0) - 2026-11-14
6
18
 
7
19
  > 本周期主轴:配置系统由 YAML 迁移至 `config.db` + Dashboard Config 页(含管理面安全加固)。以下条目按重要程度排列。
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: coding-proxy
3
- Version: 0.6.0
3
+ Version: 0.6.1
4
4
  Summary: A High-Availability, Transparent, and Smart Multi-Vendor Proxy for Claude Code. Support Claude Plans, GitHub Copilot, Google Antigravity, ZAI/GLM, MiniMax, Qwen, Xiaomi, Kimi, Doubao...
5
5
  Project-URL: Source Code, https://github.com/ThreeFish-AI/coding-proxy
6
6
  Project-URL: User Guide, https://github.com/ThreeFish-AI/coding-proxy/blob/master/docs/user-guide.md
@@ -43,6 +43,7 @@
43
43
  | [arch/config-reference.md](../arch/config-reference.md) | 配置参数权威定义(Single Source of Truth) |
44
44
  | [arch/design-patterns.md](../arch/design-patterns.md) | 13 种设计模式详解(熔断器、状态机、Composite 等) |
45
45
  | [arch/routing.md](../arch/routing.md) | 路由引擎 12 个子模块职责 |
46
+ | [arch/session-model-bind.md](../arch/session-model-bind.md) | 会话级模型绑定(Model Bind)设计与实现锚点 |
46
47
  | [arch/vendors.md](../arch/vendors.md) | Vendor 类层次结构与 9 种实现 |
47
48
  | [arch/convert.md](../arch/convert.md) | Anthropic ↔ Gemini ↔ OpenAI 三向格式转换 |
48
49
  | [arch/testing.md](../arch/testing.md) | 测试覆盖矩阵与工具链 |
@@ -365,3 +365,25 @@ env var(运行时) > 存储的显式字段(Dashboard / CLI 配置) > Pyd
365
365
  空串或纯空白视作未设置,保留上一层值(避免"未设置 env → 空串覆盖内置默认"陷阱)。
366
366
 
367
367
  > `ANTHROPIC_BASE_URL`(client → proxy,Claude Code 使用)与 `NATIVE_ANTHROPIC_BASE_URL`(proxy → upstream,原生透传使用)方向正交,勿混用。参见 [用户指引 § 4.7 native_api](../user-guide.md#47-native_api--原生-api-透传)。
368
+
369
+ ## 11. session_policies — Session 路由策略与会话级模型绑定
370
+
371
+ > **定义位置**:[`config/session_policy.py`](../../src/coding/proxy/config/session_policy.py)
372
+ >
373
+ > **生效链路**:`SessionPolicyResolver` 逐请求按 session_key 解析。运行时绑定(Dashboard/CLI/API)纯内存态:重启后回落配置态;配置热切换(generation swap)经 `_migrate_bindings` 迁移保留——vendor 需仍在新链路、模型需仍在 `bindable_models` 清单,失效部分移除并在 `reset_runtime` 提示。设计详见 [session-model-bind.md](session-model-bind.md)。
374
+
375
+ ### 11.1 本节字段
376
+
377
+ | 字段 | 类型 | 默认值 | 说明 |
378
+ | --- | --- | --- | --- |
379
+ | `policies` | `list[SessionPolicy]` | `[]` | 配置态 Session 路由策略,按序求值首次命中生效(存量键:`name`/`match.session_keys`/`tiers`,注释见 `config.default.yaml`) |
380
+ | `policies.*.model` | `str \| null` | `null` | 会话级模型覆盖:非空时该 Session 的后续请求体 `model` 统一改写为此值(逐请求生效,在途请求不受影响) |
381
+ | `bindable_models` | `list[BindableModel]` | claude 三档 | 可绑定模型清单,Dashboard Model Bind 下拉选项与 API 校验的唯一来源 |
382
+ | `bindable_models.*.label` | `str` | — | UI 显示名,清单内唯一,非空 |
383
+ | `bindable_models.*.model` | `str` | — | 覆盖目标模型名,清单内唯一,非空 |
384
+ | `bindable_models.*.tiers` | `list[str]` | `[]` | 随绑定重排的 vendor 优先级;空 = 不改当前 tier 顺序(已有运行时 vendor 绑定 > 配置态策略 > 全局默认) |
385
+ | `title_vendor_bindings` / `title_exempt_prefixes` | — | — | 标题前缀自动绑定与豁免(存量键,语义见 `config.default.yaml` 注释) |
386
+
387
+ ### 11.2 跨系列约束
388
+
389
+ 原生模型名(如 `glm-5.3`)入清单须配套 identity `model_mapping` 规则(pattern = target),防 `ModelMapper` default 静默改写;详见 [session-model-bind.md §6](session-model-bind.md#6-已知边界与风险)。
@@ -0,0 +1,84 @@
1
+ # Session Model Bind(会话级模型绑定)
2
+
3
+ > Dashboard Sessions 页「Model Bind」的设计与实现锚点:对运行中的 Claude Code 会话,在不打断任务执行的前提下切换实际所用模型。
4
+
5
+ ## 1. 动机与可行性结论
6
+
7
+ 原「Vendor Bind」只能把会话钉在某个供应商上,模型仍由客户端请求体决定。Model Bind 在此之上增加**会话级模型覆盖**:同一会话的后续请求统一改写为目标模型,跨系列切换(如 `claude-sonnet-4.6` → `glm-5.3`)亦支持。
8
+
9
+ 可行性依据(隔离实例 + mock 上游实验,15/15 断言通过):
10
+
11
+ - **绑定逐请求生效**:每个请求开始时 resolve 一次会话策略([executor.py](../../src/coding/proxy/routing/executor.py) `execute_stream` / `execute_message` 入口),请求内 failover 沿用捕获值 → 改绑定对在途请求零影响、下一请求即时生效。
12
+ - **模型逐请求声明**:客户端每次请求携带 `model` 字段,各 vendor 的 `map_model` 逐请求解析 → 改写 `body.model` 即换 served model,无需会话重建。
13
+ - **响应透传无纠偏**:响应 `model` 字段原样回传,客户端不因「响应模型 ≠ 请求模型」中断会话。
14
+
15
+ ## 2. 数据流(单请求)
16
+
17
+ ```
18
+ /v1/messages
19
+ → build_canonical_request(session_key 派生,compat/canonical.py)
20
+ → resolve 会话策略(SessionPolicyResolver,锁内读内存索引)
21
+ → [Model Bind] policy.model 非空 → body = {**body, "model": policy.model}(shadow copy)
22
+ → [Vendor Bind] policy.tiers 重排 tier 顺序(未提及的 vendor 保尾追加)
23
+ → tier 循环:能力门控(model 无关)→ VENDOR_TRANSITIONS 转换通道 → vendor.map_model → 上游
24
+ ```
25
+
26
+ 关键语义:
27
+
28
+ - **failover 为 best-effort**:绑定的 tier 被熔断 / quota / 能力门控跳过时,后续 tier 按自身映射接单,实际 served 模型可能偏离绑定模型。`_log_model_drift` 在两种情形打 WARNING:served 既非绑定名、也非接单 vendor 映射预期(failover 接单 / 上游换名),或绑定名命中映射 default 回退被改写(缺显式规则);配置内等价映射(如 claude 档位名 → glm 档位名)属预期行为不告警。dashboard Models 列展示真实 served 模型。
29
+ - **运行时绑定纯内存态**:重启后回落默认路由(与 Vendor Bind 现状一致);配置热切换(generation swap)时绑定经迁移保留——vendor 需仍在新链路、模型需仍在 `bindable_models` 清单,失效部分移除并在 `reset_runtime` 提示。标题前缀自动绑定(`title_vendor_bindings`)与手动绑定共用同一存储。
30
+ - **`count_tokens` 不同步覆盖**:透传路径非会话感知,token 估算可能与实际对话模型存在偏差(Claude Code 对其精度不敏感)。
31
+
32
+ ## 3. 配置([config-reference.md](config-reference.md) 为参数权威)
33
+
34
+ ```yaml
35
+ session_policies:
36
+ # 可绑定模型清单 —— Model Bind 下拉选项的唯一来源
37
+ bindable_models:
38
+ - label: "Opus 4.6" # UI 显示名(唯一)
39
+ model: "claude-opus-4.6" # 覆盖目标模型名(唯一)
40
+ tiers: [] # 可选:随绑定重排的 vendor 优先级(空 = 不改顺序)
41
+ ```
42
+
43
+ - 清单外的模型无法通过 API 绑定(PUT 校验返回 400)。
44
+ - **跨系列原生模型名(如 `glm-5.3`)必须配套 identity `model_mapping` 规则**(pattern = target = `glm-5.3`),否则 `ModelMapper` 对未匹配名回退 default 目标(如 `glm-5.1`),绑定会被静默改写。
45
+ - 默认清单为 claude 家族三档,已有映射规则全覆盖,零额外配置。
46
+
47
+ ## 4. API 与 CLI
48
+
49
+ - `PUT /api/session-vendor`:body `{session_key, vendors?: [..], model?: "..."}`,至少一项;`model` 必须在 `bindable_models` 清单内;`vendors` 省略时沿用清单 entry 的 `tiers`。
50
+ - `GET /api/session-vendor`:bindings 增返 `model` 字段(无模型覆盖时为 `null`)。
51
+ - `DELETE /api/session-vendor/{session_key}`:清除整条运行时绑定(model + tiers 一并移除,恢复配置态策略备份)。
52
+ - `GET /api/status`:增返 `bindable_models` 数组(UI 选项源)。
53
+ - CLI:`coding-proxy session bind --key <k> --model <m>`(`--vendor` 语义不变,二者可组合)。
54
+
55
+ ## 5. 实现锚点
56
+
57
+ | 模块 | 位置 | 变更 |
58
+ | --- | --- | --- |
59
+ | 配置模型 | `config/session_policy.py` | `SessionPolicy.model` 可选字段;`BindableModel` 与 `bindable_models` 校验(label/model 唯一) |
60
+ | 解析引擎 | `routing/session_policy.py` | `upsert(..., model=None)`、`get_runtime_binding()`、`list_runtime_bindings()` 增返 model |
61
+ | 执行器 | `routing/executor.py` | 两入口注入模型覆盖(shadow copy);failover / map 漂移 WARNING;`_apply_title_based_policy` 遇已有运行时绑定即跳过 |
62
+ | 路由 | `server/routes.py` | PUT 增 `model` 校验;GET/status 增返字段 |
63
+ | Vendor 契约 | `vendors/base.py` + `antigravity.py`、`native_anthropic.py` | `BaseVendor.map_model_with_reason` 扩展点(默认恒等 + "vendor"),经 ModelMapper 解析的 vendor 覆写为真实 exact/pattern/default,供漂移告警区分等价映射与缺规则改写 |
64
+ | UI | `server/dashboard.py` | Vendor Bind 列 → Model Bind;选项来自 `bindable_models`;Default = 清除整条绑定;vendor-only 绑定(CLI/旧 API 建立)以 `Default (vendor: …)` 标注可见 |
65
+ | CLI | `cli/__init__.py` | `session bind --model`、`session list` 显示 model |
66
+
67
+ ## 6. 已知边界与风险
68
+
69
+ | 风险 | 处置 |
70
+ | --- | --- |
71
+ | ModelMapper default 静默改写原生模型名 | 清单配套 identity 规则(文档约束)+ executor map 漂移 WARNING |
72
+ | 标题自动绑定覆盖手动绑定(compat TTL 24h 过期重触发) | `_apply_title_based_policy` 先查 `get_runtime_binding`,存在即跳过 |
73
+ | 跨供应商 thinking signature / cache_control 残留 | `VENDOR_TRANSITIONS` 通道按方向注册;无通道方向原样透传,可能上游 400 → 走 semantic failover;跨系列放开前需补通道并实测 |
74
+ | 跨模型切换 prompt cache 失效(成本跳变) | 预期行为:切换即重建缓存,dashboard 成本列天然反映 |
75
+ | context window 差异无预检 | 上游报错走 failover 链,全部失败则该轮报错(会话不丢,可重试) |
76
+ | 绑定重启丢失 | 内存态现状(热切换经迁移保留,见 §2);持久化属独立增强 |
77
+
78
+ ## 7. 测试锚点
79
+
80
+ - `tests/test_session_aware.py`:resolver model 语义(upsert / get_runtime_binding / list)、空 tiers 继承配置策略顺序、`bindable_models` 配置校验(唯一性 / 非空)。
81
+ - `tests/test_router_executor.py`:模型覆盖注入(shadow copy、绑定按原 session_key 命中、客户端原始模型名留存于 INFO 日志)、在途请求不受绑定变更影响(流式 / 非流式)、failover 接单与映射改写的漂移告警、配置策略携带 model、标题自动绑定避让。
82
+ - `tests/test_app_routes.py`:`PUT/DELETE/GET /api/session-vendor` 路由级校验(含 model 分支、清单为空、vendors 非列表)与 `/api/status` 的 `bindable_models`。
83
+ - `tests/test_config_loader.py`:默认清单来自 `config.default.yaml` 的加载守护。
84
+ - `tests/test_cli_usage.py`:`session bind --model/--vendor` payload 与缺参退出码。
@@ -46,6 +46,7 @@ classDiagram
46
46
  +supports_request(caps) tuple
47
47
  +make_compatibility_decision(req) CompatibilityDecision
48
48
  +map_model(model) str
49
+ +map_model_with_reason(model) tuple
49
50
  +check_health() bool
50
51
  +close()
51
52
  }
@@ -140,6 +141,7 @@ class BaseVendor(ABC):
140
141
  def supports_request(self, caps: RequestCapabilities) -> tuple[bool, list[CapabilityLossReason]]
141
142
  def make_compatibility_decision(self, request: CanonicalRequest) -> CompatibilityDecision
142
143
  def map_model(self, model: str) -> str # 默认恒等映射
144
+ def map_model_with_reason(self, model: str) -> tuple[str, str] # 默认 (恒等, "vendor");经共享 ModelMapper 解析的 vendor 覆写为 ("exact"|"pattern"|"default"),供会话模型漂移告警消费
143
145
 
144
146
  # ── 钩子方法(子类可选覆写) ──────────────────────────
145
147
  def _get_endpoint(self) -> str # 默认 /v1/messages
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "coding-proxy"
3
- version = "0.6.0"
3
+ version = "0.6.1"
4
4
  description = "A High-Availability, Transparent, and Smart Multi-Vendor Proxy for Claude Code. Support Claude Plans, GitHub Copilot, Google Antigravity, ZAI/GLM, MiniMax, Qwen, Xiaomi, Kimi, Doubao..."
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.12"
@@ -0,0 +1,275 @@
1
+ #!/usr/bin/env python3
2
+ """历史 Session 标题回填 — 基于 Claude Code 转录重算 session_meta.title.
3
+
4
+ 代理不存储请求体,历史会话的真实用户输入位于 Claude Code 本地转录
5
+ ``~/.claude/projects/*/<session_id>.jsonl``。本脚本将转录中的 user 消息
6
+ 喂给与请求路径共用的 ``_derive_title_from_user_texts``(同一提取逻辑,
7
+ 含注入式模板载荷剥离),重算标题并回写 ``session_meta``。
8
+
9
+ 用法::
10
+
11
+ # 干跑(默认):仅输出统计与抽样 diff,不写库
12
+ uv run python scripts/backfill_session_titles.py --db ~/.coding-proxy/usage.db
13
+
14
+ # 落库:先经 sqlite3 backup API 生成带时间戳的备份,再执行更新
15
+ uv run python scripts/backfill_session_titles.py --db ~/.coding-proxy/usage.db --apply
16
+
17
+ 安全边界:只 UPDATE / INSERT ``session_meta`` 一张表,不触碰 ``usage_log``;
18
+ 无转录的会话(无数据源)与命中保护前缀的会话(标题参与供应商绑定)跳过。
19
+ """
20
+
21
+ from __future__ import annotations
22
+
23
+ import argparse
24
+ import json
25
+ import os
26
+ import sqlite3
27
+ import sys
28
+ from datetime import UTC, datetime
29
+ from pathlib import Path
30
+
31
+ # 复用请求路径的标题推导逻辑(单一事实源)
32
+ from coding.proxy.config.importer import load_offline_config
33
+ from coding.proxy.config.loader import load_config
34
+ from coding.proxy.routing.executor import _derive_title_from_user_texts
35
+
36
+ PROJECTS_DIR = Path(
37
+ os.path.expanduser(os.environ.get("BACKFILL_CC_PROJECTS", "~/.claude/projects"))
38
+ )
39
+ MAX_USER_TEXTS_PER_SESSION = 30
40
+
41
+
42
+ def build_transcript_index(projects_dir: Path) -> dict[str, Path]:
43
+ """session_id → 转录路径索引;同一 id 多文件时取最新修改者."""
44
+ index: dict[str, Path] = {}
45
+ for path in projects_dir.glob("*/*.jsonl"):
46
+ sid = path.stem
47
+ existing = index.get(sid)
48
+ if existing is None or path.stat().st_mtime > existing.stat().st_mtime:
49
+ index[sid] = path
50
+ return index
51
+
52
+
53
+ def _is_local_command_record(text: str, *, prev_is_meta_caveat: bool) -> bool:
54
+ """识别 CC 本地 slash 命令记录(运行时请求路径不可见的行)。
55
+
56
+ 本地三行记录(caveat / command-name / stdout)中只有 caveat 行带 isMeta
57
+ 标记;实测转录中所有本地 command-name/command-message 行的前驱条目均为
58
+ isMeta 的 caveat 行,以此作判别特征。API-sent 的 slash 命令展开无此前驱,
59
+ 须放行给 ``_sanitize_user_text`` 合成「命令 + 参数」标题,不能误丢。"""
60
+ stripped = text.lstrip()
61
+ if stripped.startswith("<local-command"):
62
+ return True
63
+ return prev_is_meta_caveat and (
64
+ stripped.startswith("<command-name>")
65
+ or stripped.startswith("<command-message>")
66
+ )
67
+
68
+
69
+ def load_user_texts(path: Path) -> list[str]:
70
+ """依时间序抽取真实用户输入(排除 isMeta / sidechain / 本地命令记录 /
71
+ 非 text 块);上限按有效候选计数而非原始行数。"""
72
+ texts: list[str] = []
73
+ prev_is_meta_caveat = False
74
+ try:
75
+ with open(path, encoding="utf-8", errors="replace") as fh:
76
+ for line in fh:
77
+ if len(texts) >= MAX_USER_TEXTS_PER_SESSION:
78
+ break
79
+ try:
80
+ entry = json.loads(line)
81
+ except (json.JSONDecodeError, ValueError):
82
+ continue
83
+ if entry.get("type") == "user":
84
+ content = (entry.get("message") or {}).get("content")
85
+ if entry.get("isMeta"):
86
+ serialized = (
87
+ content
88
+ if isinstance(content, str)
89
+ else json.dumps(content, ensure_ascii=False)
90
+ )
91
+ prev_is_meta_caveat = "local-command-caveat" in serialized
92
+ continue
93
+ if entry.get("isSidechain"):
94
+ prev_is_meta_caveat = False
95
+ continue
96
+ candidates: list[str] = []
97
+ if isinstance(content, str):
98
+ candidates = [content]
99
+ elif isinstance(content, list):
100
+ candidates = [
101
+ block.get("text", "")
102
+ for block in content
103
+ if isinstance(block, dict) and block.get("type") == "text"
104
+ ]
105
+ texts.extend(
106
+ t
107
+ for t in candidates
108
+ if t.strip()
109
+ and not _is_local_command_record(
110
+ t, prev_is_meta_caveat=prev_is_meta_caveat
111
+ )
112
+ )
113
+ prev_is_meta_caveat = False
114
+ except OSError as exc:
115
+ print(f" ! 读取转录失败 {path}: {exc}", file=sys.stderr)
116
+ return texts
117
+
118
+
119
+ def parse_session_id(session_key: str) -> str:
120
+ """从 session_key 解析 CC session_id。
121
+
122
+ JSON dict 形态取 ``session_id`` 字段;JSON 标量(如纯数字 user_id)与
123
+ 非 JSON 裸 UUID 形态原样返回——裸 UUID 本身即转录文件 stem,可直接命中
124
+ 索引(对齐 dashboard 前端 parseSessionKey 的 catch 回退契约)。"""
125
+ try:
126
+ obj = json.loads(session_key)
127
+ except (json.JSONDecodeError, ValueError):
128
+ return session_key
129
+ if isinstance(obj, dict):
130
+ return obj.get("session_id") or ""
131
+ return session_key
132
+
133
+
134
+ def backup_database(db_path: Path) -> Path:
135
+ """经 sqlite3 backup API 生成一致性备份(对运行中的代理写入安全)."""
136
+ stamp = datetime.now(UTC).strftime("%Y%m%dT%H%M%SZ")
137
+ backup_path = db_path.with_name(f"{db_path.name}.backup-{stamp}")
138
+ src = sqlite3.connect(f"file:{db_path}?mode=ro", uri=True)
139
+ try:
140
+ dst = sqlite3.connect(str(backup_path))
141
+ try:
142
+ src.backup(dst)
143
+ finally:
144
+ dst.close()
145
+ finally:
146
+ src.close()
147
+ return backup_path
148
+
149
+
150
+ def main() -> int:
151
+ parser = argparse.ArgumentParser(description="基于 CC 转录回填 session_meta.title")
152
+ parser.add_argument("--db", required=True, help="usage.db 路径")
153
+ parser.add_argument("--projects", default=str(PROJECTS_DIR), help="CC 转录根目录")
154
+ parser.add_argument(
155
+ "--config",
156
+ default=None,
157
+ help="显式指定 legacy YAML 配置覆盖(默认与运行时代理同源:config.db 优先,"
158
+ "未迁移实例回退 YAML,即 load_offline_config 语义)",
159
+ )
160
+ parser.add_argument("--apply", action="store_true", help="落库(默认干跑)")
161
+ parser.add_argument(
162
+ "--protect-prefix",
163
+ action="append",
164
+ default=[],
165
+ help="额外保护前缀(现有标题以此开头则跳过;配置的绑定前缀已默认并入)",
166
+ )
167
+ parser.add_argument("--sample", type=int, default=15, help="抽样 diff 展示条数")
168
+ args = parser.parse_args()
169
+
170
+ db_path = Path(args.db).expanduser()
171
+ if not db_path.exists():
172
+ print(f"数据库不存在: {db_path}", file=sys.stderr)
173
+ return 2
174
+
175
+ # 与请求路径同一配置语义:豁免前缀透传给推导器;绑定前缀默认并入保护集,
176
+ # 防止改写参与 title_vendor_bindings 的现有标题(仪表盘「前缀=绑定意图」语义)。
177
+ # 配置源与离线命令(usage / auth)同源:load_offline_config 读 config.db
178
+ # (运行时权威源,Dashboard 热编辑即时生效),未迁移实例回退 legacy YAML。
179
+ exempt_prefixes: list[str] = []
180
+ if args.config:
181
+ cfg = load_config(Path(args.config).expanduser())
182
+ hint = None
183
+ else:
184
+ cfg, hint = load_offline_config(decrypt=False)
185
+ if hint:
186
+ print(f"配置提示: {hint}")
187
+ exempt_prefixes = list(cfg.session_policies.title_exempt_prefixes)
188
+ protect = list(args.protect_prefix)
189
+ protect.extend(b.prefix for b in cfg.session_policies.title_vendor_bindings)
190
+ args.protect_prefix = protect
191
+ print(
192
+ f"配置源: {'--config ' + args.config if args.config else 'config.db/YAML 离线解析'}"
193
+ )
194
+ print(f"豁免前缀 {exempt_prefixes},保护前缀 {args.protect_prefix}")
195
+
196
+ index = build_transcript_index(Path(args.projects).expanduser())
197
+ print(f"转录索引: {len(index)} 个 session_id({args.projects})")
198
+
199
+ con = sqlite3.connect(
200
+ f"file:{db_path}?mode=ro" if not args.apply else str(db_path),
201
+ uri=not args.apply,
202
+ )
203
+ con.row_factory = sqlite3.Row
204
+
205
+ rows = con.execute(
206
+ """SELECT s.session_key, m.title AS title
207
+ FROM (SELECT DISTINCT session_key FROM usage_log WHERE session_key != '') s
208
+ LEFT JOIN session_meta m ON m.session_key = s.session_key"""
209
+ ).fetchall()
210
+
211
+ stats = {
212
+ "updated": 0,
213
+ "inserted": 0,
214
+ "kept": 0,
215
+ "no_transcript": 0,
216
+ "protected": 0,
217
+ "no_candidate": 0,
218
+ }
219
+ changes: list[tuple[str, str, str]] = []
220
+ for row in rows:
221
+ key, old = row["session_key"], row["title"] or ""
222
+ if any(old.startswith(p) for p in args.protect_prefix):
223
+ stats["protected"] += 1
224
+ continue
225
+ sid = parse_session_id(key)
226
+ path = index.get(sid)
227
+ if path is None:
228
+ stats["no_transcript"] += 1
229
+ continue
230
+ derived = _derive_title_from_user_texts(
231
+ load_user_texts(path), exempt_prefixes=exempt_prefixes
232
+ )
233
+ if not derived:
234
+ stats["no_candidate"] += 1
235
+ continue
236
+ if derived == old:
237
+ stats["kept"] += 1
238
+ continue
239
+ changes.append((key, old, derived))
240
+ if old:
241
+ stats["updated"] += 1
242
+ else:
243
+ stats["inserted"] += 1
244
+
245
+ print("\n统计:", json.dumps(stats, ensure_ascii=False))
246
+ print(f"\n抽样变更(前 {args.sample} 条):")
247
+ for key, old, new in changes[: args.sample]:
248
+ print(f" session={parse_session_id(key)[:8]}…")
249
+ print(f" 旧: {old[:110] or '(空)'}")
250
+ print(f" 新: {new[:110]}")
251
+
252
+ if not args.apply:
253
+ print("\n干跑结束,未写库。确认后加 --apply 执行。")
254
+ return 0
255
+
256
+ if not changes:
257
+ print("\n无变更,未写库。")
258
+ return 0
259
+
260
+ backup_path = backup_database(db_path)
261
+ print(f"\n已备份: {backup_path}")
262
+ con.execute("BEGIN")
263
+ con.executemany(
264
+ """INSERT INTO session_meta (session_key, title, created_at)
265
+ VALUES (?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
266
+ ON CONFLICT(session_key) DO UPDATE SET title = excluded.title""",
267
+ [(key, new) for key, _, new in changes],
268
+ )
269
+ con.commit()
270
+ print(f"已回写 {len(changes)} 条标题到 session_meta。")
271
+ return 0
272
+
273
+
274
+ if __name__ == "__main__":
275
+ raise SystemExit(main())
@@ -379,25 +379,44 @@ def reset(
379
379
  def session_bind(
380
380
  key: str = typer.Option(..., "--key", "-k", help="Session key"),
381
381
  vendor: str = typer.Option(
382
- ..., "--vendor", "-v", help="绑定 vendor(逗号分隔多个)"
382
+ None, "--vendor", "-v", help="绑定 vendor(逗号分隔多个,与 --model 可组合)"
383
+ ),
384
+ model: str = typer.Option(
385
+ None,
386
+ "--model",
387
+ "-m",
388
+ help="绑定模型(须在 config 的 bindable_models 清单内,与 --vendor 可组合)",
383
389
  ),
384
390
  port: int = typer.Option(3392, "--port", "-p", help="代理服务端口"),
385
391
  ) -> None:
386
- """为指定 Session 绑定 vendor 优先级."""
392
+ """为指定 Session 绑定 vendor 优先级与可选的会话级模型覆盖."""
387
393
  import httpx as _httpx
388
394
 
389
- vendors = [v.strip() for v in vendor.split(",") if v.strip()]
395
+ if not vendor and not model:
396
+ console.print("[red]至少提供 --vendor 或 --model 之一[/red]")
397
+ raise typer.Exit(1)
398
+
399
+ payload: dict = {"session_key": key}
400
+ if vendor:
401
+ payload["vendors"] = [v.strip() for v in vendor.split(",") if v.strip()]
402
+ if model:
403
+ payload["model"] = model
390
404
  try:
391
405
  resp = _httpx.put(
392
406
  f"http://127.0.0.1:{port}/api/session-vendor",
393
- json={"session_key": key, "vendors": vendors},
407
+ json=payload,
394
408
  timeout=5,
395
409
  )
396
410
  if resp.status_code == 200:
397
411
  data = resp.json()
412
+ parts = []
413
+ if data.get("model"):
414
+ parts.append(f"model={data['model']}")
415
+ if data.get("vendors"):
416
+ parts.append(" → ".join(data["vendors"]))
398
417
  console.print(
399
418
  f"[green]绑定成功:[/] session [cyan]{key[:16]}…[/cyan] → "
400
- + " → ".join(data.get("vendors", vendors))
419
+ + " ".join(parts)
401
420
  )
402
421
  else:
403
422
  try:
@@ -456,7 +475,11 @@ def session_list(
456
475
  for b in bindings:
457
476
  key = b.get("session_key", "?")
458
477
  vendors = b.get("vendors", [])
459
- console.print(f" [cyan]{key[:24]}…[/cyan] → " + " → ".join(vendors))
478
+ model = b.get("model")
479
+ model_part = f"model={model} " if model else ""
480
+ console.print(
481
+ f" [cyan]{key[:24]}…[/cyan] → {model_part}" + " → ".join(vendors)
482
+ )
460
483
  else:
461
484
  console.print(f"[red]查询失败: {resp.status_code} {resp.text}[/red]")
462
485
  except _httpx.ConnectError:
@@ -719,6 +719,21 @@ native_api:
719
719
  # 未配置时(默认),所有 Session 使用全局 tiers 顺序。
720
720
  session_policies:
721
721
  policies: []
722
+ # 可绑定模型清单 —— Dashboard「Model Bind」下拉选项与 API 校验的唯一来源。
723
+ # label / model 清单内唯一;tiers 为随绑定重排的 vendor 优先级(空 = 不改顺序)。
724
+ # 跨系列原生模型名(如 glm-5.3)需配套 identity model_mapping 规则
725
+ # (pattern 与 target 同名),防 ModelMapper default 静默改写。
726
+ bindable_models:
727
+ - label: "Opus 4.6"
728
+ model: "claude-opus-4.6"
729
+ - label: "Sonnet 4.6"
730
+ model: "claude-sonnet-4.6"
731
+ - label: "Haiku 4.5"
732
+ model: "claude-haiku-4.5"
733
+ # 跨系列示例:
734
+ # - label: "GLM 5.3"
735
+ # model: "glm-5.3"
736
+ # tiers: ["zhipu"]
722
737
  # 标题前缀 → 供应商自动绑定。
723
738
  # 当 Session 标题以指定前缀开头时,自动将该 Session 绑定到对应供应商。
724
739
  # 匹配规则按列表顺序求值,首次匹配生效。
@@ -44,12 +44,50 @@ class SessionPolicy(BaseModel):
44
44
  default_factory=list,
45
45
  description="覆盖全局 tier 顺序的供应商优先级列表",
46
46
  )
47
+ model: str | None = Field(
48
+ default=None,
49
+ min_length=1,
50
+ description=(
51
+ "会话级模型覆盖:非空时该 Session 的后续请求体 model 字段"
52
+ "统一改写为此值(shadow copy,逐请求生效,在途请求不受影响)。"
53
+ ),
54
+ )
55
+
56
+ @field_validator("model", mode="before")
57
+ @classmethod
58
+ def _empty_model_to_none(cls, value: object) -> object:
59
+ """空串/纯空白归一为未设置(Config 页 text 控件清空后保存 '' 的恢复路径)."""
60
+ if isinstance(value, str) and not value.strip():
61
+ return None
62
+ return value
63
+
47
64
  quota: SessionQuotaConfig | None = Field(
48
65
  default=None,
49
66
  description="Per-session 资源配额(预留)",
50
67
  )
51
68
 
52
69
 
70
+ class BindableModel(BaseModel):
71
+ """可绑定模型清单条目 — Dashboard Model Bind 下拉选项的唯一来源."""
72
+
73
+ label: str = Field(
74
+ min_length=1,
75
+ description="UI 显示名(清单内唯一)",
76
+ )
77
+ model: str = Field(
78
+ min_length=1,
79
+ description="覆盖目标模型名(清单内唯一)",
80
+ )
81
+ tiers: list[str] = Field(
82
+ default_factory=list,
83
+ description=(
84
+ "随绑定重排的 vendor 优先级列表(空 = 仅覆盖模型、不改 vendor 顺序)。"
85
+ "跨系列原生模型名(如 glm-5.3)需配套 identity model_mapping 规则,"
86
+ "防 ModelMapper default 静默改写。"
87
+ ),
88
+ )
89
+
90
+
53
91
  class TitleVendorBinding(BaseModel):
54
92
  """标题前缀 → 供应商自动绑定规则."""
55
93
 
@@ -73,6 +111,32 @@ class SessionPoliciesConfig(BaseModel):
73
111
  default_factory=list,
74
112
  description="Session 路由策略列表,按定义顺序求值,首次匹配生效",
75
113
  )
114
+ bindable_models: list[BindableModel] = Field(
115
+ default_factory=list,
116
+ description=(
117
+ "可绑定模型清单(Model Bind 下拉选项的唯一来源)。"
118
+ "API 只允许绑定清单内的模型;跨系列原生模型名需配套 identity "
119
+ "model_mapping 规则。label 与 model 在清单内必须唯一。"
120
+ ),
121
+ )
122
+
123
+ @field_validator("bindable_models", mode="after")
124
+ @classmethod
125
+ def _validate_bindable_models(
126
+ cls, value: list[BindableModel]
127
+ ) -> list[BindableModel]:
128
+ """校验 label / model 清单内唯一,防 UI 选项与 API 校验歧义."""
129
+ seen_labels: set[str] = set()
130
+ seen_models: set[str] = set()
131
+ for item in value:
132
+ if item.label in seen_labels:
133
+ raise ValueError(f"duplicate bindable_models label: {item.label}")
134
+ if item.model in seen_models:
135
+ raise ValueError(f"duplicate bindable_models model: {item.model}")
136
+ seen_labels.add(item.label)
137
+ seen_models.add(item.model)
138
+ return value
139
+
76
140
  title_vendor_bindings: list[TitleVendorBinding] = Field(
77
141
  default_factory=list,
78
142
  description=(