aisc-cli 0.1.10__tar.gz → 0.3.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 (126) hide show
  1. {aisc_cli-0.1.10/src/aisc_cli.egg-info → aisc_cli-0.3.0}/PKG-INFO +85 -50
  2. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/README.md +79 -44
  3. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/pyproject.toml +6 -5
  4. aisc_cli-0.3.0/src/aisc/VERSION +1 -0
  5. aisc_cli-0.3.0/src/aisc/_topic_skill/SKILL.md +111 -0
  6. aisc_cli-0.3.0/src/aisc/_topic_skill/__init__.py +1 -0
  7. aisc_cli-0.3.0/src/aisc/_topic_skill/agents/openai.yaml +3 -0
  8. aisc_cli-0.3.0/src/aisc/_topic_skill/assets/STATE.md +14 -0
  9. aisc_cli-0.3.0/src/aisc/_topic_skill/assets/TOPIC_GUIDE.md +31 -0
  10. aisc_cli-0.3.0/src/aisc/_topic_skill/references/aisc.md +57 -0
  11. aisc_cli-0.3.0/src/aisc/_topic_skill/references/evolution.md +30 -0
  12. aisc_cli-0.3.0/src/aisc/_topic_skill/references/practice.md +37 -0
  13. aisc_cli-0.3.0/src/aisc/_topic_skill/references/recording.md +97 -0
  14. aisc_cli-0.3.0/src/aisc/_topic_skill/scripts/__init__.py +1 -0
  15. aisc_cli-0.3.0/src/aisc/_topic_skill/scripts/workshop.py +411 -0
  16. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/conversation.py +70 -27
  17. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/docker_lifecycle.py +61 -7
  18. aisc_cli-0.3.0/src/aisc/application/extension_modules.py +353 -0
  19. aisc_cli-0.3.0/src/aisc/application/extension_operation_scope.py +28 -0
  20. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/extensions.py +38 -5
  21. aisc_cli-0.3.0/src/aisc/application/fs_rename.py +55 -0
  22. aisc_cli-0.3.0/src/aisc/application/image_rebuild.py +185 -0
  23. aisc_cli-0.3.0/src/aisc/application/image_reference.py +38 -0
  24. aisc_cli-0.3.0/src/aisc/application/personal_capabilities.py +164 -0
  25. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/runtime.py +19 -5
  26. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/session.py +17 -0
  27. aisc_cli-0.3.0/src/aisc/application/topic.py +412 -0
  28. aisc_cli-0.3.0/src/aisc/application/topic_conversation.py +527 -0
  29. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/work_collection.py +25 -6
  30. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/build.py +16 -11
  31. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/extensions.py +33 -0
  32. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/network.py +17 -0
  33. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/serve.py +2 -0
  34. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/serve_fs.py +21 -1
  35. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/session.py +3 -0
  36. aisc_cli-0.3.0/src/aisc/cli/commands/topic.py +27 -0
  37. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/main.py +111 -11
  38. {aisc_cli-0.1.10 → aisc_cli-0.3.0/src/aisc_cli.egg-info}/PKG-INFO +85 -50
  39. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc_cli.egg-info/SOURCES.txt +20 -0
  40. aisc_cli-0.1.10/src/aisc/VERSION +0 -1
  41. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/LICENSE +0 -0
  42. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/MANIFEST.in +0 -0
  43. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/setup.cfg +0 -0
  44. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/__init__.py +0 -0
  45. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/__main__.py +0 -0
  46. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/__init__.py +0 -0
  47. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/config_reader.py +0 -0
  48. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/container_registry.py +0 -0
  49. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/data_root_store.py +0 -0
  50. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/docker_.py +0 -0
  51. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/docker_gateway.py +0 -0
  52. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/docker_sdk_backed.py +0 -0
  53. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/maintenance_lock.py +0 -0
  54. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/state_file.py +0 -0
  55. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/system.py +0 -0
  56. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/windows_config_reader.py +0 -0
  57. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/adapters/workspace_lease_store.py +0 -0
  58. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/__init__.py +0 -0
  59. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/artifact.py +0 -0
  60. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/bundle_fetch.py +0 -0
  61. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/cc_switch_provider.py +0 -0
  62. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/cc_switch_resolver.py +0 -0
  63. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/config_service.py +0 -0
  64. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/data_migration.py +0 -0
  65. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/data_root.py +0 -0
  66. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/doctor.py +0 -0
  67. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/legacy_scan.py +0 -0
  68. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/network_subscription.py +0 -0
  69. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/profile_service.py +0 -0
  70. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/provider.py +0 -0
  71. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/repair.py +0 -0
  72. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/resources.py +0 -0
  73. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/tool_versions.py +0 -0
  74. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/toolchain.py +0 -0
  75. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/update.py +0 -0
  76. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/update_health.py +0 -0
  77. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/usage.py +0 -0
  78. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/version.py +0 -0
  79. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/web_gateway.py +0 -0
  80. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/worklog.py +0 -0
  81. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/application/workspace_reconcile.py +0 -0
  82. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/applog.py +0 -0
  83. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/__init__.py +0 -0
  84. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/build_progress_parser.py +0 -0
  85. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/__init__.py +0 -0
  86. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/agents.py +0 -0
  87. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/artifact.py +0 -0
  88. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/bundle.py +0 -0
  89. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/cc_switch.py +0 -0
  90. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/config.py +0 -0
  91. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/container.py +0 -0
  92. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/conversation.py +0 -0
  93. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/data_root.py +0 -0
  94. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/logs.py +0 -0
  95. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/profile.py +0 -0
  96. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/provider.py +0 -0
  97. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/run.py +0 -0
  98. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/runs.py +0 -0
  99. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/runtime.py +0 -0
  100. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/update.py +0 -0
  101. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/usage.py +0 -0
  102. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/wizard.py +0 -0
  103. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/work_record.py +0 -0
  104. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/worklog.py +0 -0
  105. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/commands/workspaces.py +0 -0
  106. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/help_i18n.py +0 -0
  107. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/output.py +0 -0
  108. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/cli/tutorial.py +0 -0
  109. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/__init__.py +0 -0
  110. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/artifacts.py +0 -0
  111. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/cc_switch_release.py +0 -0
  112. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/config.py +0 -0
  113. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/data_migration.py +0 -0
  114. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/data_root.py +0 -0
  115. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/docker_ownership.py +0 -0
  116. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/gateway.py +0 -0
  117. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/models.py +0 -0
  118. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/toolchain.py +0 -0
  119. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/web_services.py +0 -0
  120. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/domain/workspace_lease.py +0 -0
  121. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/schemas/__init__.py +0 -0
  122. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc/schemas/config_schema.py +0 -0
  123. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc_cli.egg-info/dependency_links.txt +0 -0
  124. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc_cli.egg-info/entry_points.txt +0 -0
  125. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc_cli.egg-info/requires.txt +0 -0
  126. {aisc_cli-0.1.10 → aisc_cli-0.3.0}/src/aisc_cli.egg-info/top_level.txt +0 -0
@@ -1,14 +1,14 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: aisc-cli
3
- Version: 0.1.10
3
+ Version: 0.3.0
4
4
  Summary: AISC CLI — Super Claude workstation management
5
5
  Author: AISC contributors
6
6
  License-Expression: MIT
7
- Project-URL: Homepage, https://github.com/wangyuncepu/AISC
8
- Project-URL: Source, https://github.com/wangyuncepu/AISC
9
- Project-URL: Releases, https://github.com/wangyuncepu/AISC/releases
10
- Project-URL: Bug Tracker, https://github.com/wangyuncepu/AISC/issues
11
- Project-URL: Security, https://github.com/wangyuncepu/AISC/security/advisories/new
7
+ Project-URL: Homepage, https://github.com/Wifabric/AISC
8
+ Project-URL: Source, https://github.com/Wifabric/AISC
9
+ Project-URL: Releases, https://github.com/Wifabric/AISC/releases
10
+ Project-URL: Bug Tracker, https://github.com/Wifabric/AISC/issues
11
+ Project-URL: Security, https://github.com/Wifabric/AISC/security/advisories/new
12
12
  Keywords: ai,claude,docker,workstation,cli,container
13
13
  Classifier: Development Status :: 3 - Alpha
14
14
  Classifier: Intended Audience :: Developers
@@ -31,6 +31,8 @@ Dynamic: license-file
31
31
 
32
32
  # AISC 使用手册
33
33
 
34
+ 本轮变化见 [2.1.19-preview.1 发布说明](docs/releases/v2.1.19-preview.1.md),操作步骤见[测试教程](docs/plans/2.1.19-dev-plans/HANDTEST.md),验收与发布状态见[交付记录](docs/plans/2.1.19-dev-plans/DELIVERY.md)。[2.1.19 正式版说明](docs/releases/v2.1.19.md)对应本分支定版,发布状态以交付记录为准。
35
+
34
36
  AISC 是一个在 Docker 容器中运行 Claude Code、OpenAI Codex 和 cc-switch 的个人开发工作站,提供两种使用方式:
35
37
 
36
38
  - **AISC Workbench(推荐)**——桌面应用(Windows)。图形界面完成工作区选择、镜像构建、容器启动、终端、文件管理、Provider 配置与诊断;还可经 SSH 驱动装有 aisc 的远程机器(见[远程机器](#远程机器))。
@@ -38,7 +40,7 @@ AISC 是一个在 Docker 容器中运行 Claude Code、OpenAI Codex 和 cc-switc
38
40
 
39
41
  容器内的 AI CLI、Provider、凭据、路由和 Skills 均由 cc-switch 统一管理;宿主机不保存第二份凭据。
40
42
 
41
- > **状态:Alpha(0.x)。** 当前版本:Workbench **v2.1.14** / CLI **0.1.3**(`pip install -U aisc-cli`)。命令、配置和持久化契约仍可能变化,升级前请阅读 [Releases](https://github.com/Wifabric/AISC/releases) 的 Release Notes 并备份重要工作区。
43
+ > **状态:Alpha(0.x)。** Workbench **2.1.19-preview.1** 已发布为 [Preview Release](https://github.com/Wifabric/AISC/releases/tag/v2.1.19-preview.1),提供 Windows 安装包及校验文件,随包 CLI 为 **0.3.0.dev0**;本轮没有发布独立 CLI PyPI 包。Windows runner 已通过静默新装、2.1.18 升级、启动/CLI/PATH 与数据保留检查;2026-11-19 用户确认本轮功能及剩余安装、Docker 引导和交互卸载手测全部通过。本分支已定版为 **Workbench 2.1.19 / CLI 0.3.0**,用户已授权正式发布;正式渠道正在执行,已公开版本与实际产物见交付记录。命令、配置和持久化契约仍可能变化,升级前请阅读 Release Notes 并备份重要工作区。
42
44
 
43
45
  ## 目录
44
46
 
@@ -68,15 +70,15 @@ AISC 以开发便利为优先,不是生产级安全沙箱:
68
70
 
69
71
  ## 安装前提
70
72
 
71
- 运行 AISC 需要自行安装并启动 **Docker**(AISC 不代装,检测到缺失时会给出指引;Windows 安装器可一键引导安装 Docker/Python/WebView2):
73
+ 运行 AISC 需要自行安装并启动 **Docker**。Windows 安装器检测 Docker Desktop;缺失时可打开官方下载页,Workbench 首次引导提示自行安装后重新检测。安装完成页启动 Workbench 时,会尝试启动已安装但未运行的 Docker Desktop。WebView2 缺失时由安装器按运行时配置处理。
72
74
 
73
75
  | 平台 | 官方产物 | Docker |
74
76
  | --- | --- | --- |
75
77
  | Windows | x86_64(Workbench 安装器) | [Docker Desktop](https://www.docker.com/products/docker-desktop/) |
76
- | Linux | x86_64(CLI 便携包) | Docker Engine;当前用户需有 daemon 权限 |
77
- | macOS | Apple Silicon arm64(CLI 便携包/PKG) | Docker Desktop |
78
+ | Linux | x86_64(CLI:pip/pipx) | Docker Engine;当前用户需有 daemon 权限 |
79
+ | macOS | Apple Silicon arm64(CLI:pip/pipx) | Docker Desktop |
78
80
 
79
- 官方 Release **不提供** Linux arm64、Windows arm64 或 Intel macOS 产物。安装器/便携包渠道不需要 Python、uv 或 Git;pip/pipx 渠道需要 Python 3.11+;从源码构建需要 Python 3.11+ 和 Git,推荐使用 uv。
81
+ 官方 Release **不提供** Linux arm64、Windows arm64 或 Intel macOS 产物。Workbench 安装器自带冻结 CLI,不需要宿主 Python、uv 或 Git;pip/pipx 渠道需要 Python 3.11+;从源码构建需要 Python 3.11+ 和 Git,推荐使用 uv。
80
82
 
81
83
  `aisc doctor` 可在明确确认后协助安装 Docker(需要确认与相应权限),除此之外 AISC 不会代装系统软件。
82
84
 
@@ -90,9 +92,9 @@ docker version
90
92
 
91
93
  ### 安装
92
94
 
93
- 从 [GitHub Releases](https://github.com/Wifabric/AISC/releases) 下载 Windows 安装器(`AISC Workbench_<版本>_x64-setup.exe`)及 `.sha256`,校验后运行。安装器默认写入 `%LOCALAPPDATA%\Programs\AISC`,并添加用户 `PATH`。
95
+ 从 [GitHub Releases](https://github.com/Wifabric/AISC/releases) 下载 Windows 安装器(`AISC-Workbench-<版本>-setup.exe`)及 `.sha256`,校验后运行。安装器默认写入 `%LOCALAPPDATA%\AISC Workbench`,并添加用户 `PATH`。
94
96
 
95
- AISC 尚未代码签名。SmartScreen 提示时,请先确认文件来自项目 Release 且 SHA256 正确,再选择“更多信息 -> 仍要运行”。
97
+ AISC 当前候选尚未代码签名。本机 Windows Sandbox 曾阻止安装程序启动;后续已在一次性 Windows runner 验证静默新装、升级及安装后的 CLI/PATH。该结果不解决强制应用控制环境对未签名包的拦截。SHA256 一致只能确认文件内容一致,不等于系统会允许执行;遇到拦截请记录系统提示及安装包版本,勿将拦截当作安装完成。本地候选的功能测试入口见[测试教程](docs/plans/2.1.19-dev-plans/HANDTEST.md)。
96
98
 
97
99
  ### 首次使用流程
98
100
 
@@ -105,33 +107,71 @@ AISC 尚未代码签名。SmartScreen 提示时,请先确认文件来自项目
105
107
  ### 日常使用
106
108
 
107
109
  - **终端**:`bash` / `claude` / `codex` 多页签,支持分屏;首次进入有上手速查卡,容器内输入 `help` 查看常用操作。`Ctrl+Shift+V` 粘贴、`Ctrl+F` 终端内搜索、`Ctrl+Alt+hjkl`(或方向键)移动分屏焦点、`Ctrl+Shift+W` 关闭当前分屏。codex 中 `Ctrl+/` 可在 `/btw` 旁路与主线对话间往返切换。
108
- - **资源管理器(文件)**:目录树懒加载、右键新建/重命名/复制/粘贴、拖拽文件进终端(自动转容器路径)、顶部搜索(支持模糊与 `/正则/`)。
110
+ - **资源管理器(文件)**:目录树懒加载、右键新建/重命名/复制/粘贴/移动;单个文件或目录可拖到目标目录,同名目标不覆盖。本地和 SSH 工作区均支持移动。拖入终端只插入转义后的路径,不自动执行;顶部搜索支持模糊与 `/正则/`。
109
111
  - **变更面板**:Agent 产出与文件改动统一呈现——徽章区分类型(新增/修改/删除/移动)与来源(Agent 登记或系统检测),支持分类筛选与搜索。
110
112
  - **历史会话**:会话列表可查看聊天式只读对话记录(claude/codex 双侧)。
111
- - **工作记录**:把 provider 会话聚合成 Work Record / Collection。active Collection 自动收容新开的 Claude/Codex 会话;支持重命名、设为 Active、归档/恢复、手动加入/移出。删除 Collection 前会普通确认一次,然后级联删除成员 transcript;删除失败会列出成员、阶段和原因。`bash` / `cc-switch` 不进入工作记录。
113
+ - **工作记录**:把 provider 会话聚合成 Work Record / Collection。active Collection 自动收容新开的 Claude/Codex 会话;支持重命名、设为 Active、归档/恢复、手动加入/移出。记录按原生父子关系显示层级,移动或删除父记录包含后代;删除前显示影响数量,失败列出原因。缺少父级信息的记录保留未归档。`bash` / `cc-switch` 不进入工作记录。
112
114
  - **服务面板**:容器内通过 `aisc-web-expose <端口>` 注册的 Web 服务,可从面板一键在宿主浏览器打开。
113
115
  - **Provider 管理**:顶栏进入 Providers 页。基于内置模板清单添加(见下),填入 API Key 即可使用,切换即时生效、无需重启;添加时可直接「拉取模型」验证 Key 与端点(无效 Key 会明确报「API Key 无效或被上游拒绝」)。
114
- - **网络与用量**(设置页):代理模式可导入机场订阅(自动转换为容器 TUN 配置);用量面板聚合各工作区 token 消耗与余量。
115
- - **Docker 资源管理**(设置页):AISC 名下容器/镜像的扫描、清理与重建;破坏性操作仅限 AISC 自有资产,绝不触碰其它容器/镜像。
116
+ - **网络与用量**(设置页):可打开当前工作区的网络面板。代理模式可导入及刷新订阅,运行新版镜像后可查看手动选择组、切换节点和测延时;用量面板聚合各工作区 token 消耗与余量。
117
+ - **Docker 资源管理**(设置页):AISC 名下容器/镜像的扫描、清理与重建。“重置 Docker Desktop…”会打开官方 Dashboard,按页面指引进入 Troubleshoot → Reset to factory defaults;最终确认由 Docker 展示,其范围与 AISC 自有资源清理不同。
116
118
  - **多工作区**:最多同时打开 3 个工作区,页签条切换;关闭即自动停止并清理对应容器。顶栏「关闭工作区」可随时回到选择页重选(清理运行环境,窗口保留)。
117
119
  - **彻底忘记工作区**:工作区历史右键 -> 彻底忘记,单事务清理 AISC 数据根内该工作区的状态与记录(容器先停止删除,失败自动回滚);你磁盘上的原始文件永不被触碰。
118
120
  - **诊断**:任何页面可打开诊断对话框(环境检查、最近日志、导出诊断包)。
119
121
  - **应用自更新**:Windows 设置页「检查更新」→「下载更新」,校验完成后点击「退出更新」并确认,资源管理器选中安装包、正常打开安装向导后 Workbench 退出;可按向导完成更新。下载完成本身不会退出,取消或启动失败仍保留应用。其他平台按提示手动安装。
120
122
 
123
+ ### 标签、启动目录与工作记录定位
124
+
125
+ 拖动终端标签可调整当前工作区内的顺序,保持正在操作的会话。新建标签或分屏时先选启动目录,再选择 Bash、Claude 或 Codex;目录相对于工作区,例如 `frontend`、`backend`,各分屏独立使用所选目录。更深的子目录随目录树加载后可选。
126
+
127
+ 标签采用与工作记录对应的编号,并按引擎区分颜色;双击已关联会话的标签可定位记录,独立终端显示自己的编号。重新打开工作区仍从单个 Bash 开始,不恢复全部旧标签和进程。终端右侧滚动条可以拖动回看历史输出;新建和恢复 Codex 使用保留终端历史的内联模式,需要用本版 bundle 构建镜像;原反馈的偶发卡死尚未复现,不能将滚动条改善视作该问题已解决。
128
+
129
+ ### 代理节点与新版镜像
130
+
131
+ 1. 启动使用本版资源构建的测试工作区,在设置中打开“网络与用量”。
132
+ 2. 选择代理模式并导入可用订阅;需要更新订阅时使用刷新入口。
133
+ 3. 查看节点列表,在可手动选择的组中选节点并应用,然后刷新核对当前节点。
134
+ 4. 点击测速查看延时或错误;切换选项后重新测速,避免把上一个节点的结果当成当前结果。
135
+
136
+ 该操作控制当前工作区的代理,不修改宿主机的系统代理。节点列表依赖运行中的代理服务;没有订阅、使用旧镜像或容器未启动时,不代表节点功能已可用。技能适配器、官方直连刷新、节点控制及新增 `gh` 均依赖新版镜像,升级桌面文件后仍需用配套 bundle 构建并选择新镜像。
137
+
138
+ ### 个人能力与主题
139
+
140
+ 在终端标签栏「▾」选择「个人能力与主题」,或从「扩展 → 技能」顶部点击「使用这个技能」。首页有两个入口:
141
+
142
+ 1. **设置我的回答偏好**:从模板创建个人副本,或新建空白能力;填写名称和规则,选择是否启用,点击「保存新版本」。在「我的能力 · 已保存的回答偏好」查看、编辑或停用。修改原因、验证和历史在进阶区域;恢复旧版会生成新版本,原版本仍保留。
143
+ 2. **围绕一个主题持续做事**:新建主题,填写名称和目标,选择 Claude/Codex,点击「创建并开始主题对话」。检查并编辑开场草稿,点击「填入对话,由我发送」,再自行发送。未配置提供者时先按提示完成登录。
144
+
145
+ 普通「新建 Claude/Codex」对话不会自动关联最近主题;启用的回答偏好独立作用于之后的新对话。只有从主题入口开始的对话关联该主题;已有对话不会被后台强行替换上下文。主题页可查看目标、继续入口、相关对话、总结、手册及成果,原始记录、诊断和历史默认收起。
146
+
147
+ 主题对话顶部只显示当前主题的简短状态。「更多」可查看成果、处理同步提示或停止记录本次对话;停止后保留已保存内容,不再继续采集,也不会撤回模型已收到的上下文。源记录缺失或被截断时暂停同步,可查看详情、重试或停止,不把反复失败当作新增进展。
148
+
149
+ 主题保存在工作区 `topics/<主题ID>/`,`.skill/` 保存技能版本。仅同步明确关联会话的对外文本,不复制推理、工具输出和附件二进制。切换或关闭主题标签不等于停止采集;已保存对话不等于手册已整理或效果已验证。旧主题、个人能力版本、手册和成果保留,旧的工作区全局主题选择不再应用于普通新对话。
150
+
151
+ ### 基础技能与在线模块
152
+
153
+ 通用基础技能随离线资源提供;场景模块在「扩展 → 扩展市场 → 推荐」的模块入口管理。打开「科研基础」或「开发基础」,查看成员和来源后应用;技能可供已启用的目标引擎后续会话读取,必要时新建会话刷新技能列表。安装成功与模型实际使用成功分别验证。
154
+
155
+ 复制默认模块可编辑并保存自己的定义。保存或删除定义不执行安装/卸载;「应用」只补装缺少成员,「卸载模块」先显示计划,保留共享、预装、归属不明和已修改项。插件通路目前只支持 Claude;MCP 安装后还可能需要本人认证,保存认证、握手成功与实际访问仓库是三个不同结果。
156
+
157
+ 技能市场的仓库分组可“安装全部”,已安装分组可“更新全部”。本版修复嵌套子目录技能定位,保留已有启停状态;操作后刷新已安装列表核对结果,缺失、歧义或异常链接仍会报错。本轮实际通过 `mattpocock/skills` 的 20 项安装与更新,后续上游数量可能变化。
158
+
121
159
  ### Provider 模板清单
122
160
 
123
161
  「添加 provider」时镜像内置以下模板,用户只需填 API Key:
124
162
 
125
163
  | 供应商 | 说明 |
126
164
  | --- | --- |
127
- | **DeepSeek** | V4 系列(pro/flash);Codex 走官方 Responses 端点 |
128
- | **火山引擎 Ark** | 兼容 OpenAI 格式;需配置接入点 ID |
129
- | **智谱 GLM** | GLM-5.2 旗舰模型 |
130
- | **Kimi** | 月之暗面 Kimi K3 |
165
+ | **DeepSeek** | Codex 新建原生格式默认地址 `https://api.deepseek.com` |
166
+ | **火山引擎 Ark** | Claude 模板保留;本版 Codex 新建列表隐藏,已有配置不因此删除 |
167
+ | **智谱 GLM** | Codex 新建原生格式默认地址 `https://open.bigmodel.cn/api/v1` |
168
+ | **Kimi** | Codex 新建原生格式默认地址 `https://api.moonshot.cn/v1` |
131
169
  | **Codesome V3** | 月卡/按量中转(`sk-` Key,后台建 Key 选分组) |
132
170
  | **Codesome 二合一** | V5 月卡中转(`cr-` 卡密即 Key,Claude/GPT 双端通用) |
133
171
 
134
- 模板模式下模型映射/模型目录随首次保存生效;手动填写的端点不会被模板清单静默改写。模板的 Codex 上游走 S9a 形态(本地路由把 Responses 翻译为 Anthropic Messages,直连模板声明的 Anthropic 端点);Codesome 两模板的 Claude 侧不含模型键(官方要求,模型由 Key 的服务端分组路由),并预填官方推荐的自动压缩水位(claude 150k / codex 900k)。也支持自定义 Provider(OpenAI 兼容格式,端点/模型/上下文窗口全手填)。
172
+ 新建 Codex Provider 默认选择 OpenAI Responses;若改选 Anthropic 等格式,未手动改过的地址会随模板切换到对应端点。编辑已有 Provider 沿用其已保存格式和地址,不批量迁移。模板的模型映射/目录随首次保存生效,实际可用模型取决于服务商与账号权限;手动填写的端点不会被模板清单静默改写。
173
+
174
+ 选择 Anthropic 格式时,Codex 走本地 Responses → Anthropic Messages 转换;原生 Responses 格式使用相应原生端点。Codesome 两模板的 Claude 侧不含模型键,模型由 Key 的服务端分组路由,并预填模板配置的自动压缩水位(claude 150k / codex 900k)。也支持自定义 Provider。当前官方直连卡的刷新会重新应用官方配置;刷新成功与真实账号对话成功仍需分别确认。
135
175
 
136
176
  ## 远程机器
137
177
 
@@ -160,7 +200,7 @@ pipx install aisc-cli # 首选:自动隔离 + 独立 bin 目录(Windo
160
200
  # 或 uv tool install aisc-cli / 裸 pip(请在 venv 内)
161
201
  ```
162
202
 
163
- 三点须知:① 分发名是 `aisc-cli`,但命令仍是 `aisc`;② **需要自备 Docker**,装完先跑 `aisc doctor`;③ pip 安装**不含构建资源**——`aisc build` / `maintenance docker-rebuild` 前需先 `aisc bundle fetch`(从 GitHub Releases 拉同版本 bundle 到数据根);此时 `aisc version` 的 `bundle_version=null` 与 `doctor` 的 aisc-bundle WARN 属预期。
203
+ 三点须知:① 分发名是 `aisc-cli`,但命令仍是 `aisc`;② **需要自备 Docker**,装完先跑 `aisc doctor`;③ pip 安装**不含构建资源**。2.1.18 的正式 Release 不提供独立 CLI 归档,因此不能承诺 `aisc bundle fetch` 自动取得 CLI 0.2.0 的资源。需要构建镜像时,使用配套 Workbench 的完整 bundle,或按 [开发手册](DEVELOP_WIKI.md) 准备对应源码及资源,并通过 `--aisc-root` 指定;纯 pip 环境的 `bundle_version=null` 表示尚未配置资源根。
164
204
 
165
205
  安装陷阱 FAQ:
166
206
 
@@ -168,24 +208,9 @@ pipx install aisc-cli # 首选:自动隔离 + 独立 bin 目录(Windo
168
208
  - **Windows 裸 pip `--user`**:Scripts 目录(`%APPDATA%\Python\Scripts`)默认不在 PATH → 把它加入 PATH 或改用 pipx。
169
209
  - **`python -m aisc`**:永远可用,是 shim 失效时的诊断后门。
170
210
 
171
- **Linux x86_64**(便携):
172
-
173
- ```bash
174
- sha256sum -c AISC-<ver>-linux-x86_64.tar.gz.sha256
175
- tar -xzf AISC-<ver>-linux-x86_64.tar.gz
176
- cd AISC-<ver>-linux-x86_64
177
- ./aisc version
178
- ```
179
-
180
- 便携运行时,`aisc` 与 `aisc-bundle/` 必须保持相邻。也可用仓库中的脚本安装到用户目录:
211
+ **Linux x86_64 / macOS arm64**:使用上述 pip/pipx 渠道;本版不发布独立 CLI 便携安装包或 macOS PKG。已有历史便携安装仍可按原版本文档维护,但不要寻找本版不存在的下载。
181
212
 
182
- ```bash
183
- bash packaging/install.sh /path/to/AISC-<ver>-linux-x86_64.tar.gz
184
- ```
185
-
186
- **macOS arm64**:推荐 `.pkg`(需管理员密码,安装到 `/usr/local/lib/aisc/`);或使用便携 `.tar.gz` / `packaging/install.sh`。
187
-
188
- **Windows**:Workbench 安装器已含 CLI;便携 `.zip` 可配合 `packaging/install.ps1` 安装到 `%LOCALAPPDATA%\AISC`。
213
+ **Windows**:Workbench 安装器已包含 CLI 和完整构建资源,通常无需再安装一份 pip CLI。多渠道并存时用 `aisc doctor` 核对 PATH 和版本来源。
189
214
 
190
215
  **从源码**:
191
216
 
@@ -271,12 +296,15 @@ aisc run --non-interactive # 脚本/CI:无 TTY,项目作用域
271
296
  | `aisc status` | `--name`, `--label` | 查看目标容器状态 |
272
297
  | `aisc stop` / `aisc restart` | `--name`, `--label` | 停止(幂等)/ 重启目标容器 |
273
298
  | `aisc shell` | `--name`, `--label` | 执行 `docker exec -it <name> bash` |
274
- | `aisc session open` | — | 打开托管会话终端(Workbench 内部使用同一通道) |
299
+ | `aisc session open` | `--runtime-id`, `--session-id`, `--agent`, `--workspace`, `--working-directory` | 打开托管会话终端;启动目录为工作区相对子目录,前三项必填 |
275
300
  | `aisc serve` | — | 长驻远程通道(stdin/stdout JSON 帧协议;Workbench 经 SSH 调用,一般无需手动运行) |
276
301
  | `aisc switch` | `--name`, `--label`, `--quick PROVIDER` | 打开 cc-switch TUI,或快速切换 Claude Provider |
277
302
  | `aisc provider set-key` | `PROVIDER_ID`, `--name`, `--label`, `--agent` | 打开 cc-switch provider 安全交互编辑器;凭据不进命令行参数 |
278
303
  | `aisc conversation read` | 会话定位参数 | 聊天式只读对话查看器(历史会话阅读) |
279
304
  | `aisc work-record list/reconcile` | `--workspace` | 列出或重新对账 Work Record / Collection 与未归档会话 |
305
+ | `aisc topic list/show/check` | `--workspace`, `--id`(show/check) | 发现主题、查看手册/进度/过程、检查记录完整性 |
306
+ | `aisc topic create` | `--workspace`, `--title`, `--text`, `--sources-json`(可选) | 创建主题及内置 skill 副本,保存目标和资料引用 |
307
+ | `aisc topic prepare` | `--workspace`, `--id`, `--action continue/feedback/guide/improve`, `--text` | 保存实践/反馈任务并返回可填入 Agent 会话的读取指令,不调用模型 |
280
308
  | `aisc work-record create/rename/activate/deactivate/archive/restore` | `--workspace`, `--title`, `--collection-id` 等 | 管理 Work Record 元数据与生命周期 |
281
309
  | `aisc work-record add/remove/delete` | `--workspace`, `--collection-id`, `--agent`, `--conversation-id` 等 | 手动整理成员或级联删除 Collection(CLI 只删除 transcript;live PTY 由 Workbench 预先编排关闭) |
282
310
  | `aisc worklog list/rename/archive` | `--id` 等 | 工作区 PTY 会话账本(开关钩子自动记账,fail-open) |
@@ -285,9 +313,10 @@ aisc run --non-interactive # 脚本/CI:无 TTY,项目作用域
285
313
  | `aisc logs show/path` | `--source app\|cli\|ui\|all` | 查看统一 JSONL 日志时间线 |
286
314
  | `aisc usage overview` | 全局选项 | 跨工作区聚合用量 |
287
315
  | `aisc network subscription …` | `import/import-file/refresh/show/clear` | 代理订阅数据面(URL 与内容走 stdin) |
316
+ | `aisc network nodes list/select/delay` | `--workspace`, `--runtime-id`, `--group`, `--node` | 在运行中的新版代理镜像列节点、切换或测速;前两项必填,后两项用于 select/delay |
288
317
  | `aisc maintenance docker-scan/cleanup/rebuild` | `--context`, `--root`, `--tag` | Docker 资源归属扫描/清理/重建(owned-only,卸载与升级同一服务) |
289
318
  | `aisc maintenance container-action/image-rm/image-tag` | `--id` 等 | AISC 自有容器的启动/停止/删除、镜像删除与重命名(仅 owned 资源,执行前锁内重扫判权) |
290
- | `aisc bundle fetch/list/remove/path` | `--version`, `--from-file`, `--sha256`, `--allow-mismatch` | pip 安装的构建资源管理:从 GitHub Releases 拉取同版本 bundle 到数据根(API digest 校验、fail-closed、离线 --from-file) |
319
+ | `aisc bundle fetch/list/remove/path` | `--version`, `--from-file`, `--sha256`, `--allow-mismatch` | pip 安装的构建资源管理:管理已有/历史 CLI bundle(校验、离线导入);本版正式渠道不保证存在可自动获取的 CLI 归档 |
291
320
  | `aisc update` | `--check`, `--version`, `--from-file`, `--sha256`, `--rebuild` | CLI 自更新:`--check` 查看计划。**不再从网络下载 CLI 归档**——pip/pipx 形态走各自渠道(`pipx upgrade aisc-cli` 或 venv 内 `pip install -U aisc-cli`);便携/冻结形态可用 `--from-file <archive> --sha256 <hex>` 本地换装;Workbench 内置 CLI 随安装器自更新 |
292
321
 
293
322
  多容器寻址顺序:显式 `--name` -> 唯一匹配的 `--label` -> registry 默认目标 -> 唯一登记容器;无法消歧时列出候选并要求指定。
@@ -317,7 +346,11 @@ cc-switch proxy show
317
346
 
318
347
  启动时 AISC 会 detach 启动 cc-switch daemon。Claude 路由 best-effort 自动启用;Codex 默认官方直连,需要托管 Provider 时执行 `cc-switch proxy -a codex enable`。
319
348
 
320
- Skills 同步:镜像内置 `caveman`、`document-skills`、`grill-me`、`superpowers`,由 cc-switch 登记(`cc-switch skills list/sync`);容器入口按 `AISC_SKILLS_SYNC=auto|always|off` 控制同步策略。
349
+ Skills 同步:镜像离线预装 13 个 `caveman-*` 技能及 `grill-me`、`grilling`、`karpathy-guidelines`,由 cc-switch 登记到 Claude/Codex。容器入口按 `AISC_SKILLS_SYNC=auto|always|off` 控制补装策略,只补缺少文件,保留已有内容及启停选择。用户主动运行 cc-switch 的全量 `skills sync` 属于单独操作。
350
+
351
+ 扩展市场的「基础模块」提供科研基础(arXiv / OpenAlex)与开发基础(系统化调试 / 测试驱动开发)。模块定义可复制编辑,成员在线安装,不随离线包预装;「应用」只补缺项,「卸载」保留预装、共享、已修改或归属不明的内容。安装成功不代表外部服务认证或具体模型任务已验证。
352
+
353
+ 「个人能力与主题」中的模板市场提供通用协作、科研阅读、开发复盘初始模板。创建个人副本后,可编辑规则、粘贴自己的技能内容、记录修改原因与验证结果并保存新版本;历史版本可以恢复到草稿再次保存。勾选启用后,当前工作区新建的 Claude/Codex 会话会加载该版本,已有会话和其他工作区不变。个人能力可单独使用,也可与下方主题工作坊的对话记录、手册和实践过程一起使用。
321
354
 
322
355
  代理网络(CLI):
323
356
 
@@ -346,14 +379,16 @@ Workbench 与 CLI 共享统一数据根:
346
379
  - 工作区状态在数据根(不在工作区目录内),「彻底忘记」才会清除。
347
380
  - 持久工具链:Agent 安装的用户级 npm/pip/cargo 工具跨容器、跨会话保留(挂载 `/opt/aisc/toolchain`)。
348
381
  - AISC 用户配置:`aisc config`(JSON,用户层 + 工作区层 `<workspace>/.aisc/config.json`,未知键告警忽略)。
349
- - 资源根(`aisc-bundle/`)须包含 `VERSION`、`container/Dockerfile`、`config/versions.env`;查找顺序 `--aisc-root` -> `AISC_ROOT` -> 可执行文件旁 `aisc-bundle/` -> Git 仓库向上查找 -> **数据根 `bundles/<ver>/`(`aisc bundle fetch` 安装,0.1.0 起)** -> editable 源码祖先。pip 安装无前四项时落到 `bundles/`;都没有则 build 类命令报错并指引 `aisc bundle fetch`。
382
+ - 资源根(`aisc-bundle/`)须包含 `VERSION`、`container/Dockerfile`、`config/versions.env`;查找顺序 `--aisc-root` -> `AISC_ROOT` -> 可执行文件旁 `aisc-bundle/` -> Git 仓库向上查找 -> **数据根 `bundles/<ver>/`(`aisc bundle fetch` 安装,0.1.0 起)** -> editable 源码祖先。pip 安装无前四项时尝试已有 `bundles/`;都没有则 build 类命令无法工作。即使旧诊断建议 fetch,也须先确认该 CLI 版本有可获取资产;本版请准备配套资源根。
350
383
 
351
384
  ## 升级
352
385
 
353
- - **Windows Workbench**:推荐应用内「设置 -> 检查更新」直接升级——下载(带进度条)→ 确认 → 静默安装 → 自动重建镜像 → **自动重启新版**。也可手动运行新版安装器覆盖安装(效果相同)。升级会先停止并删除 AISC 管理的容器,替换文件后对默认镜像执行**无缓存重建**(可能需要几分钟到 30 分钟);Docker 不可用时文件照常更新,镜像重建转为待办并给出手动命令。用户配置、工作区状态与持久工具链全部保留。
354
- - **macOS PKG / 便携脚本**:覆盖安装或重新执行 `packaging/install.sh <new-archive>`。
386
+ 当前 2.1.19-preview.1 仅为本地候选。以下是产品升级方式说明,不代表本候选已通过 2.1.18 → 2.1.19 的安装升级验收。先测试新功能可使用对应源码构建或完整便携候选,见[验收教程](docs/plans/2.1.19-dev-plans/HANDTEST.md);公开渠道尚不能保证下载到本开发版。
387
+
388
+ - **Windows Workbench**:设置 → 检查更新 → 下载更新;校验后点击「退出更新」并确认,程序打开目标安装器交互向导后退出。按向导完成覆盖安装;下载本身不退出,取消或启动失败保留应用。升级前保存未提交工作并关闭占用,安装器可能处理 AISC 管理的运行资源;具体构建/清理结果以向导日志为准。用户配置和工作区数据默认保留。
389
+ - **历史 PKG / 便携脚本**:按该历史版本维护方式处理;本版独立 CLI 改用 pip/pipx,先核对 PATH,避免新旧渠道混用。
355
390
  - **uv tool**:`git pull` 后 `uv tool upgrade aisc` 或重装;镜像内容变化时需重新 `aisc build`。
356
- - **pipx/pip**:`pipx upgrade aisc-cli`(或 venv 内 `pip install -U aisc-cli`);新版 bundle 用 `aisc bundle fetch` 更新(更新镜像再 `aisc maintenance docker-rebuild`)。
391
+ - **pipx/pip**:`pipx upgrade aisc-cli`(或 venv 内 `pip install -U aisc-cli`);镜像构建前另外准备与 CLI 配对的资源根,不能把 pip 升级成功当成完整离线资源也已更新。
357
392
 
358
393
  注:Workbench 内置的 CLI 随安装器一同更新(无独立升级通道);远程机器上的 CLI 用 `pipx upgrade aisc-cli` / `pip install -U aisc-cli` 独立升级。
359
394
 
@@ -362,9 +397,9 @@ Workbench 与 CLI 共享统一数据根:
362
397
  | 安装方式 | 卸载方式 |
363
398
  | --- | --- |
364
399
  | Windows Workbench 安装器 | Windows“设置 -> 应用 -> 已安装的应用” |
365
- | Windows `packaging/install.ps1` | `powershell -File packaging/uninstall.ps1` |
366
- | macOS PKG | `sudo /usr/local/lib/aisc/uninstall.sh` |
367
- | Linux/macOS `packaging/install.sh` | `bash packaging/uninstall.sh` |
400
+ | 历史 Windows `packaging/install.ps1` | `powershell -File packaging/uninstall.ps1` |
401
+ | 历史 macOS PKG | `sudo /usr/local/lib/aisc/uninstall.sh` |
402
+ | 历史 Linux/macOS `packaging/install.sh` | `bash packaging/uninstall.sh` |
368
403
  | uv tool | `uv tool uninstall aisc` |
369
404
  | pipx/pip | `pipx uninstall aisc-cli`(或 venv 内 `pip uninstall aisc-cli`);**先**跑下面的 docker 清理,pip 卸载会把工具一起带走 |
370
405
 
@@ -1,5 +1,7 @@
1
1
  # AISC 使用手册
2
2
 
3
+ 本轮变化见 [2.1.19-preview.1 发布说明](docs/releases/v2.1.19-preview.1.md),操作步骤见[测试教程](docs/plans/2.1.19-dev-plans/HANDTEST.md),验收与发布状态见[交付记录](docs/plans/2.1.19-dev-plans/DELIVERY.md)。[2.1.19 正式版说明](docs/releases/v2.1.19.md)对应本分支定版,发布状态以交付记录为准。
4
+
3
5
  AISC 是一个在 Docker 容器中运行 Claude Code、OpenAI Codex 和 cc-switch 的个人开发工作站,提供两种使用方式:
4
6
 
5
7
  - **AISC Workbench(推荐)**——桌面应用(Windows)。图形界面完成工作区选择、镜像构建、容器启动、终端、文件管理、Provider 配置与诊断;还可经 SSH 驱动装有 aisc 的远程机器(见[远程机器](#远程机器))。
@@ -7,7 +9,7 @@ AISC 是一个在 Docker 容器中运行 Claude Code、OpenAI Codex 和 cc-switc
7
9
 
8
10
  容器内的 AI CLI、Provider、凭据、路由和 Skills 均由 cc-switch 统一管理;宿主机不保存第二份凭据。
9
11
 
10
- > **状态:Alpha(0.x)。** 当前版本:Workbench **v2.1.14** / CLI **0.1.3**(`pip install -U aisc-cli`)。命令、配置和持久化契约仍可能变化,升级前请阅读 [Releases](https://github.com/Wifabric/AISC/releases) 的 Release Notes 并备份重要工作区。
12
+ > **状态:Alpha(0.x)。** Workbench **2.1.19-preview.1** 已发布为 [Preview Release](https://github.com/Wifabric/AISC/releases/tag/v2.1.19-preview.1),提供 Windows 安装包及校验文件,随包 CLI 为 **0.3.0.dev0**;本轮没有发布独立 CLI PyPI 包。Windows runner 已通过静默新装、2.1.18 升级、启动/CLI/PATH 与数据保留检查;2026-11-19 用户确认本轮功能及剩余安装、Docker 引导和交互卸载手测全部通过。本分支已定版为 **Workbench 2.1.19 / CLI 0.3.0**,用户已授权正式发布;正式渠道正在执行,已公开版本与实际产物见交付记录。命令、配置和持久化契约仍可能变化,升级前请阅读 Release Notes 并备份重要工作区。
11
13
 
12
14
  ## 目录
13
15
 
@@ -37,15 +39,15 @@ AISC 以开发便利为优先,不是生产级安全沙箱:
37
39
 
38
40
  ## 安装前提
39
41
 
40
- 运行 AISC 需要自行安装并启动 **Docker**(AISC 不代装,检测到缺失时会给出指引;Windows 安装器可一键引导安装 Docker/Python/WebView2):
42
+ 运行 AISC 需要自行安装并启动 **Docker**。Windows 安装器检测 Docker Desktop;缺失时可打开官方下载页,Workbench 首次引导提示自行安装后重新检测。安装完成页启动 Workbench 时,会尝试启动已安装但未运行的 Docker Desktop。WebView2 缺失时由安装器按运行时配置处理。
41
43
 
42
44
  | 平台 | 官方产物 | Docker |
43
45
  | --- | --- | --- |
44
46
  | Windows | x86_64(Workbench 安装器) | [Docker Desktop](https://www.docker.com/products/docker-desktop/) |
45
- | Linux | x86_64(CLI 便携包) | Docker Engine;当前用户需有 daemon 权限 |
46
- | macOS | Apple Silicon arm64(CLI 便携包/PKG) | Docker Desktop |
47
+ | Linux | x86_64(CLI:pip/pipx) | Docker Engine;当前用户需有 daemon 权限 |
48
+ | macOS | Apple Silicon arm64(CLI:pip/pipx) | Docker Desktop |
47
49
 
48
- 官方 Release **不提供** Linux arm64、Windows arm64 或 Intel macOS 产物。安装器/便携包渠道不需要 Python、uv 或 Git;pip/pipx 渠道需要 Python 3.11+;从源码构建需要 Python 3.11+ 和 Git,推荐使用 uv。
50
+ 官方 Release **不提供** Linux arm64、Windows arm64 或 Intel macOS 产物。Workbench 安装器自带冻结 CLI,不需要宿主 Python、uv 或 Git;pip/pipx 渠道需要 Python 3.11+;从源码构建需要 Python 3.11+ 和 Git,推荐使用 uv。
49
51
 
50
52
  `aisc doctor` 可在明确确认后协助安装 Docker(需要确认与相应权限),除此之外 AISC 不会代装系统软件。
51
53
 
@@ -59,9 +61,9 @@ docker version
59
61
 
60
62
  ### 安装
61
63
 
62
- 从 [GitHub Releases](https://github.com/Wifabric/AISC/releases) 下载 Windows 安装器(`AISC Workbench_<版本>_x64-setup.exe`)及 `.sha256`,校验后运行。安装器默认写入 `%LOCALAPPDATA%\Programs\AISC`,并添加用户 `PATH`。
64
+ 从 [GitHub Releases](https://github.com/Wifabric/AISC/releases) 下载 Windows 安装器(`AISC-Workbench-<版本>-setup.exe`)及 `.sha256`,校验后运行。安装器默认写入 `%LOCALAPPDATA%\AISC Workbench`,并添加用户 `PATH`。
63
65
 
64
- AISC 尚未代码签名。SmartScreen 提示时,请先确认文件来自项目 Release 且 SHA256 正确,再选择“更多信息 -> 仍要运行”。
66
+ AISC 当前候选尚未代码签名。本机 Windows Sandbox 曾阻止安装程序启动;后续已在一次性 Windows runner 验证静默新装、升级及安装后的 CLI/PATH。该结果不解决强制应用控制环境对未签名包的拦截。SHA256 一致只能确认文件内容一致,不等于系统会允许执行;遇到拦截请记录系统提示及安装包版本,勿将拦截当作安装完成。本地候选的功能测试入口见[测试教程](docs/plans/2.1.19-dev-plans/HANDTEST.md)。
65
67
 
66
68
  ### 首次使用流程
67
69
 
@@ -74,33 +76,71 @@ AISC 尚未代码签名。SmartScreen 提示时,请先确认文件来自项目
74
76
  ### 日常使用
75
77
 
76
78
  - **终端**:`bash` / `claude` / `codex` 多页签,支持分屏;首次进入有上手速查卡,容器内输入 `help` 查看常用操作。`Ctrl+Shift+V` 粘贴、`Ctrl+F` 终端内搜索、`Ctrl+Alt+hjkl`(或方向键)移动分屏焦点、`Ctrl+Shift+W` 关闭当前分屏。codex 中 `Ctrl+/` 可在 `/btw` 旁路与主线对话间往返切换。
77
- - **资源管理器(文件)**:目录树懒加载、右键新建/重命名/复制/粘贴、拖拽文件进终端(自动转容器路径)、顶部搜索(支持模糊与 `/正则/`)。
79
+ - **资源管理器(文件)**:目录树懒加载、右键新建/重命名/复制/粘贴/移动;单个文件或目录可拖到目标目录,同名目标不覆盖。本地和 SSH 工作区均支持移动。拖入终端只插入转义后的路径,不自动执行;顶部搜索支持模糊与 `/正则/`。
78
80
  - **变更面板**:Agent 产出与文件改动统一呈现——徽章区分类型(新增/修改/删除/移动)与来源(Agent 登记或系统检测),支持分类筛选与搜索。
79
81
  - **历史会话**:会话列表可查看聊天式只读对话记录(claude/codex 双侧)。
80
- - **工作记录**:把 provider 会话聚合成 Work Record / Collection。active Collection 自动收容新开的 Claude/Codex 会话;支持重命名、设为 Active、归档/恢复、手动加入/移出。删除 Collection 前会普通确认一次,然后级联删除成员 transcript;删除失败会列出成员、阶段和原因。`bash` / `cc-switch` 不进入工作记录。
82
+ - **工作记录**:把 provider 会话聚合成 Work Record / Collection。active Collection 自动收容新开的 Claude/Codex 会话;支持重命名、设为 Active、归档/恢复、手动加入/移出。记录按原生父子关系显示层级,移动或删除父记录包含后代;删除前显示影响数量,失败列出原因。缺少父级信息的记录保留未归档。`bash` / `cc-switch` 不进入工作记录。
81
83
  - **服务面板**:容器内通过 `aisc-web-expose <端口>` 注册的 Web 服务,可从面板一键在宿主浏览器打开。
82
84
  - **Provider 管理**:顶栏进入 Providers 页。基于内置模板清单添加(见下),填入 API Key 即可使用,切换即时生效、无需重启;添加时可直接「拉取模型」验证 Key 与端点(无效 Key 会明确报「API Key 无效或被上游拒绝」)。
83
- - **网络与用量**(设置页):代理模式可导入机场订阅(自动转换为容器 TUN 配置);用量面板聚合各工作区 token 消耗与余量。
84
- - **Docker 资源管理**(设置页):AISC 名下容器/镜像的扫描、清理与重建;破坏性操作仅限 AISC 自有资产,绝不触碰其它容器/镜像。
85
+ - **网络与用量**(设置页):可打开当前工作区的网络面板。代理模式可导入及刷新订阅,运行新版镜像后可查看手动选择组、切换节点和测延时;用量面板聚合各工作区 token 消耗与余量。
86
+ - **Docker 资源管理**(设置页):AISC 名下容器/镜像的扫描、清理与重建。“重置 Docker Desktop…”会打开官方 Dashboard,按页面指引进入 Troubleshoot → Reset to factory defaults;最终确认由 Docker 展示,其范围与 AISC 自有资源清理不同。
85
87
  - **多工作区**:最多同时打开 3 个工作区,页签条切换;关闭即自动停止并清理对应容器。顶栏「关闭工作区」可随时回到选择页重选(清理运行环境,窗口保留)。
86
88
  - **彻底忘记工作区**:工作区历史右键 -> 彻底忘记,单事务清理 AISC 数据根内该工作区的状态与记录(容器先停止删除,失败自动回滚);你磁盘上的原始文件永不被触碰。
87
89
  - **诊断**:任何页面可打开诊断对话框(环境检查、最近日志、导出诊断包)。
88
90
  - **应用自更新**:Windows 设置页「检查更新」→「下载更新」,校验完成后点击「退出更新」并确认,资源管理器选中安装包、正常打开安装向导后 Workbench 退出;可按向导完成更新。下载完成本身不会退出,取消或启动失败仍保留应用。其他平台按提示手动安装。
89
91
 
92
+ ### 标签、启动目录与工作记录定位
93
+
94
+ 拖动终端标签可调整当前工作区内的顺序,保持正在操作的会话。新建标签或分屏时先选启动目录,再选择 Bash、Claude 或 Codex;目录相对于工作区,例如 `frontend`、`backend`,各分屏独立使用所选目录。更深的子目录随目录树加载后可选。
95
+
96
+ 标签采用与工作记录对应的编号,并按引擎区分颜色;双击已关联会话的标签可定位记录,独立终端显示自己的编号。重新打开工作区仍从单个 Bash 开始,不恢复全部旧标签和进程。终端右侧滚动条可以拖动回看历史输出;新建和恢复 Codex 使用保留终端历史的内联模式,需要用本版 bundle 构建镜像;原反馈的偶发卡死尚未复现,不能将滚动条改善视作该问题已解决。
97
+
98
+ ### 代理节点与新版镜像
99
+
100
+ 1. 启动使用本版资源构建的测试工作区,在设置中打开“网络与用量”。
101
+ 2. 选择代理模式并导入可用订阅;需要更新订阅时使用刷新入口。
102
+ 3. 查看节点列表,在可手动选择的组中选节点并应用,然后刷新核对当前节点。
103
+ 4. 点击测速查看延时或错误;切换选项后重新测速,避免把上一个节点的结果当成当前结果。
104
+
105
+ 该操作控制当前工作区的代理,不修改宿主机的系统代理。节点列表依赖运行中的代理服务;没有订阅、使用旧镜像或容器未启动时,不代表节点功能已可用。技能适配器、官方直连刷新、节点控制及新增 `gh` 均依赖新版镜像,升级桌面文件后仍需用配套 bundle 构建并选择新镜像。
106
+
107
+ ### 个人能力与主题
108
+
109
+ 在终端标签栏「▾」选择「个人能力与主题」,或从「扩展 → 技能」顶部点击「使用这个技能」。首页有两个入口:
110
+
111
+ 1. **设置我的回答偏好**:从模板创建个人副本,或新建空白能力;填写名称和规则,选择是否启用,点击「保存新版本」。在「我的能力 · 已保存的回答偏好」查看、编辑或停用。修改原因、验证和历史在进阶区域;恢复旧版会生成新版本,原版本仍保留。
112
+ 2. **围绕一个主题持续做事**:新建主题,填写名称和目标,选择 Claude/Codex,点击「创建并开始主题对话」。检查并编辑开场草稿,点击「填入对话,由我发送」,再自行发送。未配置提供者时先按提示完成登录。
113
+
114
+ 普通「新建 Claude/Codex」对话不会自动关联最近主题;启用的回答偏好独立作用于之后的新对话。只有从主题入口开始的对话关联该主题;已有对话不会被后台强行替换上下文。主题页可查看目标、继续入口、相关对话、总结、手册及成果,原始记录、诊断和历史默认收起。
115
+
116
+ 主题对话顶部只显示当前主题的简短状态。「更多」可查看成果、处理同步提示或停止记录本次对话;停止后保留已保存内容,不再继续采集,也不会撤回模型已收到的上下文。源记录缺失或被截断时暂停同步,可查看详情、重试或停止,不把反复失败当作新增进展。
117
+
118
+ 主题保存在工作区 `topics/<主题ID>/`,`.skill/` 保存技能版本。仅同步明确关联会话的对外文本,不复制推理、工具输出和附件二进制。切换或关闭主题标签不等于停止采集;已保存对话不等于手册已整理或效果已验证。旧主题、个人能力版本、手册和成果保留,旧的工作区全局主题选择不再应用于普通新对话。
119
+
120
+ ### 基础技能与在线模块
121
+
122
+ 通用基础技能随离线资源提供;场景模块在「扩展 → 扩展市场 → 推荐」的模块入口管理。打开「科研基础」或「开发基础」,查看成员和来源后应用;技能可供已启用的目标引擎后续会话读取,必要时新建会话刷新技能列表。安装成功与模型实际使用成功分别验证。
123
+
124
+ 复制默认模块可编辑并保存自己的定义。保存或删除定义不执行安装/卸载;「应用」只补装缺少成员,「卸载模块」先显示计划,保留共享、预装、归属不明和已修改项。插件通路目前只支持 Claude;MCP 安装后还可能需要本人认证,保存认证、握手成功与实际访问仓库是三个不同结果。
125
+
126
+ 技能市场的仓库分组可“安装全部”,已安装分组可“更新全部”。本版修复嵌套子目录技能定位,保留已有启停状态;操作后刷新已安装列表核对结果,缺失、歧义或异常链接仍会报错。本轮实际通过 `mattpocock/skills` 的 20 项安装与更新,后续上游数量可能变化。
127
+
90
128
  ### Provider 模板清单
91
129
 
92
130
  「添加 provider」时镜像内置以下模板,用户只需填 API Key:
93
131
 
94
132
  | 供应商 | 说明 |
95
133
  | --- | --- |
96
- | **DeepSeek** | V4 系列(pro/flash);Codex 走官方 Responses 端点 |
97
- | **火山引擎 Ark** | 兼容 OpenAI 格式;需配置接入点 ID |
98
- | **智谱 GLM** | GLM-5.2 旗舰模型 |
99
- | **Kimi** | 月之暗面 Kimi K3 |
134
+ | **DeepSeek** | Codex 新建原生格式默认地址 `https://api.deepseek.com` |
135
+ | **火山引擎 Ark** | Claude 模板保留;本版 Codex 新建列表隐藏,已有配置不因此删除 |
136
+ | **智谱 GLM** | Codex 新建原生格式默认地址 `https://open.bigmodel.cn/api/v1` |
137
+ | **Kimi** | Codex 新建原生格式默认地址 `https://api.moonshot.cn/v1` |
100
138
  | **Codesome V3** | 月卡/按量中转(`sk-` Key,后台建 Key 选分组) |
101
139
  | **Codesome 二合一** | V5 月卡中转(`cr-` 卡密即 Key,Claude/GPT 双端通用) |
102
140
 
103
- 模板模式下模型映射/模型目录随首次保存生效;手动填写的端点不会被模板清单静默改写。模板的 Codex 上游走 S9a 形态(本地路由把 Responses 翻译为 Anthropic Messages,直连模板声明的 Anthropic 端点);Codesome 两模板的 Claude 侧不含模型键(官方要求,模型由 Key 的服务端分组路由),并预填官方推荐的自动压缩水位(claude 150k / codex 900k)。也支持自定义 Provider(OpenAI 兼容格式,端点/模型/上下文窗口全手填)。
141
+ 新建 Codex Provider 默认选择 OpenAI Responses;若改选 Anthropic 等格式,未手动改过的地址会随模板切换到对应端点。编辑已有 Provider 沿用其已保存格式和地址,不批量迁移。模板的模型映射/目录随首次保存生效,实际可用模型取决于服务商与账号权限;手动填写的端点不会被模板清单静默改写。
142
+
143
+ 选择 Anthropic 格式时,Codex 走本地 Responses → Anthropic Messages 转换;原生 Responses 格式使用相应原生端点。Codesome 两模板的 Claude 侧不含模型键,模型由 Key 的服务端分组路由,并预填模板配置的自动压缩水位(claude 150k / codex 900k)。也支持自定义 Provider。当前官方直连卡的刷新会重新应用官方配置;刷新成功与真实账号对话成功仍需分别确认。
104
144
 
105
145
  ## 远程机器
106
146
 
@@ -129,7 +169,7 @@ pipx install aisc-cli # 首选:自动隔离 + 独立 bin 目录(Windo
129
169
  # 或 uv tool install aisc-cli / 裸 pip(请在 venv 内)
130
170
  ```
131
171
 
132
- 三点须知:① 分发名是 `aisc-cli`,但命令仍是 `aisc`;② **需要自备 Docker**,装完先跑 `aisc doctor`;③ pip 安装**不含构建资源**——`aisc build` / `maintenance docker-rebuild` 前需先 `aisc bundle fetch`(从 GitHub Releases 拉同版本 bundle 到数据根);此时 `aisc version` 的 `bundle_version=null` 与 `doctor` 的 aisc-bundle WARN 属预期。
172
+ 三点须知:① 分发名是 `aisc-cli`,但命令仍是 `aisc`;② **需要自备 Docker**,装完先跑 `aisc doctor`;③ pip 安装**不含构建资源**。2.1.18 的正式 Release 不提供独立 CLI 归档,因此不能承诺 `aisc bundle fetch` 自动取得 CLI 0.2.0 的资源。需要构建镜像时,使用配套 Workbench 的完整 bundle,或按 [开发手册](DEVELOP_WIKI.md) 准备对应源码及资源,并通过 `--aisc-root` 指定;纯 pip 环境的 `bundle_version=null` 表示尚未配置资源根。
133
173
 
134
174
  安装陷阱 FAQ:
135
175
 
@@ -137,24 +177,9 @@ pipx install aisc-cli # 首选:自动隔离 + 独立 bin 目录(Windo
137
177
  - **Windows 裸 pip `--user`**:Scripts 目录(`%APPDATA%\Python\Scripts`)默认不在 PATH → 把它加入 PATH 或改用 pipx。
138
178
  - **`python -m aisc`**:永远可用,是 shim 失效时的诊断后门。
139
179
 
140
- **Linux x86_64**(便携):
141
-
142
- ```bash
143
- sha256sum -c AISC-<ver>-linux-x86_64.tar.gz.sha256
144
- tar -xzf AISC-<ver>-linux-x86_64.tar.gz
145
- cd AISC-<ver>-linux-x86_64
146
- ./aisc version
147
- ```
148
-
149
- 便携运行时,`aisc` 与 `aisc-bundle/` 必须保持相邻。也可用仓库中的脚本安装到用户目录:
180
+ **Linux x86_64 / macOS arm64**:使用上述 pip/pipx 渠道;本版不发布独立 CLI 便携安装包或 macOS PKG。已有历史便携安装仍可按原版本文档维护,但不要寻找本版不存在的下载。
150
181
 
151
- ```bash
152
- bash packaging/install.sh /path/to/AISC-<ver>-linux-x86_64.tar.gz
153
- ```
154
-
155
- **macOS arm64**:推荐 `.pkg`(需管理员密码,安装到 `/usr/local/lib/aisc/`);或使用便携 `.tar.gz` / `packaging/install.sh`。
156
-
157
- **Windows**:Workbench 安装器已含 CLI;便携 `.zip` 可配合 `packaging/install.ps1` 安装到 `%LOCALAPPDATA%\AISC`。
182
+ **Windows**:Workbench 安装器已包含 CLI 和完整构建资源,通常无需再安装一份 pip CLI。多渠道并存时用 `aisc doctor` 核对 PATH 和版本来源。
158
183
 
159
184
  **从源码**:
160
185
 
@@ -240,12 +265,15 @@ aisc run --non-interactive # 脚本/CI:无 TTY,项目作用域
240
265
  | `aisc status` | `--name`, `--label` | 查看目标容器状态 |
241
266
  | `aisc stop` / `aisc restart` | `--name`, `--label` | 停止(幂等)/ 重启目标容器 |
242
267
  | `aisc shell` | `--name`, `--label` | 执行 `docker exec -it <name> bash` |
243
- | `aisc session open` | — | 打开托管会话终端(Workbench 内部使用同一通道) |
268
+ | `aisc session open` | `--runtime-id`, `--session-id`, `--agent`, `--workspace`, `--working-directory` | 打开托管会话终端;启动目录为工作区相对子目录,前三项必填 |
244
269
  | `aisc serve` | — | 长驻远程通道(stdin/stdout JSON 帧协议;Workbench 经 SSH 调用,一般无需手动运行) |
245
270
  | `aisc switch` | `--name`, `--label`, `--quick PROVIDER` | 打开 cc-switch TUI,或快速切换 Claude Provider |
246
271
  | `aisc provider set-key` | `PROVIDER_ID`, `--name`, `--label`, `--agent` | 打开 cc-switch provider 安全交互编辑器;凭据不进命令行参数 |
247
272
  | `aisc conversation read` | 会话定位参数 | 聊天式只读对话查看器(历史会话阅读) |
248
273
  | `aisc work-record list/reconcile` | `--workspace` | 列出或重新对账 Work Record / Collection 与未归档会话 |
274
+ | `aisc topic list/show/check` | `--workspace`, `--id`(show/check) | 发现主题、查看手册/进度/过程、检查记录完整性 |
275
+ | `aisc topic create` | `--workspace`, `--title`, `--text`, `--sources-json`(可选) | 创建主题及内置 skill 副本,保存目标和资料引用 |
276
+ | `aisc topic prepare` | `--workspace`, `--id`, `--action continue/feedback/guide/improve`, `--text` | 保存实践/反馈任务并返回可填入 Agent 会话的读取指令,不调用模型 |
249
277
  | `aisc work-record create/rename/activate/deactivate/archive/restore` | `--workspace`, `--title`, `--collection-id` 等 | 管理 Work Record 元数据与生命周期 |
250
278
  | `aisc work-record add/remove/delete` | `--workspace`, `--collection-id`, `--agent`, `--conversation-id` 等 | 手动整理成员或级联删除 Collection(CLI 只删除 transcript;live PTY 由 Workbench 预先编排关闭) |
251
279
  | `aisc worklog list/rename/archive` | `--id` 等 | 工作区 PTY 会话账本(开关钩子自动记账,fail-open) |
@@ -254,9 +282,10 @@ aisc run --non-interactive # 脚本/CI:无 TTY,项目作用域
254
282
  | `aisc logs show/path` | `--source app\|cli\|ui\|all` | 查看统一 JSONL 日志时间线 |
255
283
  | `aisc usage overview` | 全局选项 | 跨工作区聚合用量 |
256
284
  | `aisc network subscription …` | `import/import-file/refresh/show/clear` | 代理订阅数据面(URL 与内容走 stdin) |
285
+ | `aisc network nodes list/select/delay` | `--workspace`, `--runtime-id`, `--group`, `--node` | 在运行中的新版代理镜像列节点、切换或测速;前两项必填,后两项用于 select/delay |
257
286
  | `aisc maintenance docker-scan/cleanup/rebuild` | `--context`, `--root`, `--tag` | Docker 资源归属扫描/清理/重建(owned-only,卸载与升级同一服务) |
258
287
  | `aisc maintenance container-action/image-rm/image-tag` | `--id` 等 | AISC 自有容器的启动/停止/删除、镜像删除与重命名(仅 owned 资源,执行前锁内重扫判权) |
259
- | `aisc bundle fetch/list/remove/path` | `--version`, `--from-file`, `--sha256`, `--allow-mismatch` | pip 安装的构建资源管理:从 GitHub Releases 拉取同版本 bundle 到数据根(API digest 校验、fail-closed、离线 --from-file) |
288
+ | `aisc bundle fetch/list/remove/path` | `--version`, `--from-file`, `--sha256`, `--allow-mismatch` | pip 安装的构建资源管理:管理已有/历史 CLI bundle(校验、离线导入);本版正式渠道不保证存在可自动获取的 CLI 归档 |
260
289
  | `aisc update` | `--check`, `--version`, `--from-file`, `--sha256`, `--rebuild` | CLI 自更新:`--check` 查看计划。**不再从网络下载 CLI 归档**——pip/pipx 形态走各自渠道(`pipx upgrade aisc-cli` 或 venv 内 `pip install -U aisc-cli`);便携/冻结形态可用 `--from-file <archive> --sha256 <hex>` 本地换装;Workbench 内置 CLI 随安装器自更新 |
261
290
 
262
291
  多容器寻址顺序:显式 `--name` -> 唯一匹配的 `--label` -> registry 默认目标 -> 唯一登记容器;无法消歧时列出候选并要求指定。
@@ -286,7 +315,11 @@ cc-switch proxy show
286
315
 
287
316
  启动时 AISC 会 detach 启动 cc-switch daemon。Claude 路由 best-effort 自动启用;Codex 默认官方直连,需要托管 Provider 时执行 `cc-switch proxy -a codex enable`。
288
317
 
289
- Skills 同步:镜像内置 `caveman`、`document-skills`、`grill-me`、`superpowers`,由 cc-switch 登记(`cc-switch skills list/sync`);容器入口按 `AISC_SKILLS_SYNC=auto|always|off` 控制同步策略。
318
+ Skills 同步:镜像离线预装 13 个 `caveman-*` 技能及 `grill-me`、`grilling`、`karpathy-guidelines`,由 cc-switch 登记到 Claude/Codex。容器入口按 `AISC_SKILLS_SYNC=auto|always|off` 控制补装策略,只补缺少文件,保留已有内容及启停选择。用户主动运行 cc-switch 的全量 `skills sync` 属于单独操作。
319
+
320
+ 扩展市场的「基础模块」提供科研基础(arXiv / OpenAlex)与开发基础(系统化调试 / 测试驱动开发)。模块定义可复制编辑,成员在线安装,不随离线包预装;「应用」只补缺项,「卸载」保留预装、共享、已修改或归属不明的内容。安装成功不代表外部服务认证或具体模型任务已验证。
321
+
322
+ 「个人能力与主题」中的模板市场提供通用协作、科研阅读、开发复盘初始模板。创建个人副本后,可编辑规则、粘贴自己的技能内容、记录修改原因与验证结果并保存新版本;历史版本可以恢复到草稿再次保存。勾选启用后,当前工作区新建的 Claude/Codex 会话会加载该版本,已有会话和其他工作区不变。个人能力可单独使用,也可与下方主题工作坊的对话记录、手册和实践过程一起使用。
290
323
 
291
324
  代理网络(CLI):
292
325
 
@@ -315,14 +348,16 @@ Workbench 与 CLI 共享统一数据根:
315
348
  - 工作区状态在数据根(不在工作区目录内),「彻底忘记」才会清除。
316
349
  - 持久工具链:Agent 安装的用户级 npm/pip/cargo 工具跨容器、跨会话保留(挂载 `/opt/aisc/toolchain`)。
317
350
  - AISC 用户配置:`aisc config`(JSON,用户层 + 工作区层 `<workspace>/.aisc/config.json`,未知键告警忽略)。
318
- - 资源根(`aisc-bundle/`)须包含 `VERSION`、`container/Dockerfile`、`config/versions.env`;查找顺序 `--aisc-root` -> `AISC_ROOT` -> 可执行文件旁 `aisc-bundle/` -> Git 仓库向上查找 -> **数据根 `bundles/<ver>/`(`aisc bundle fetch` 安装,0.1.0 起)** -> editable 源码祖先。pip 安装无前四项时落到 `bundles/`;都没有则 build 类命令报错并指引 `aisc bundle fetch`。
351
+ - 资源根(`aisc-bundle/`)须包含 `VERSION`、`container/Dockerfile`、`config/versions.env`;查找顺序 `--aisc-root` -> `AISC_ROOT` -> 可执行文件旁 `aisc-bundle/` -> Git 仓库向上查找 -> **数据根 `bundles/<ver>/`(`aisc bundle fetch` 安装,0.1.0 起)** -> editable 源码祖先。pip 安装无前四项时尝试已有 `bundles/`;都没有则 build 类命令无法工作。即使旧诊断建议 fetch,也须先确认该 CLI 版本有可获取资产;本版请准备配套资源根。
319
352
 
320
353
  ## 升级
321
354
 
322
- - **Windows Workbench**:推荐应用内「设置 -> 检查更新」直接升级——下载(带进度条)→ 确认 → 静默安装 → 自动重建镜像 → **自动重启新版**。也可手动运行新版安装器覆盖安装(效果相同)。升级会先停止并删除 AISC 管理的容器,替换文件后对默认镜像执行**无缓存重建**(可能需要几分钟到 30 分钟);Docker 不可用时文件照常更新,镜像重建转为待办并给出手动命令。用户配置、工作区状态与持久工具链全部保留。
323
- - **macOS PKG / 便携脚本**:覆盖安装或重新执行 `packaging/install.sh <new-archive>`。
355
+ 当前 2.1.19-preview.1 仅为本地候选。以下是产品升级方式说明,不代表本候选已通过 2.1.18 → 2.1.19 的安装升级验收。先测试新功能可使用对应源码构建或完整便携候选,见[验收教程](docs/plans/2.1.19-dev-plans/HANDTEST.md);公开渠道尚不能保证下载到本开发版。
356
+
357
+ - **Windows Workbench**:设置 → 检查更新 → 下载更新;校验后点击「退出更新」并确认,程序打开目标安装器交互向导后退出。按向导完成覆盖安装;下载本身不退出,取消或启动失败保留应用。升级前保存未提交工作并关闭占用,安装器可能处理 AISC 管理的运行资源;具体构建/清理结果以向导日志为准。用户配置和工作区数据默认保留。
358
+ - **历史 PKG / 便携脚本**:按该历史版本维护方式处理;本版独立 CLI 改用 pip/pipx,先核对 PATH,避免新旧渠道混用。
324
359
  - **uv tool**:`git pull` 后 `uv tool upgrade aisc` 或重装;镜像内容变化时需重新 `aisc build`。
325
- - **pipx/pip**:`pipx upgrade aisc-cli`(或 venv 内 `pip install -U aisc-cli`);新版 bundle 用 `aisc bundle fetch` 更新(更新镜像再 `aisc maintenance docker-rebuild`)。
360
+ - **pipx/pip**:`pipx upgrade aisc-cli`(或 venv 内 `pip install -U aisc-cli`);镜像构建前另外准备与 CLI 配对的资源根,不能把 pip 升级成功当成完整离线资源也已更新。
326
361
 
327
362
  注:Workbench 内置的 CLI 随安装器一同更新(无独立升级通道);远程机器上的 CLI 用 `pipx upgrade aisc-cli` / `pip install -U aisc-cli` 独立升级。
328
363
 
@@ -331,9 +366,9 @@ Workbench 与 CLI 共享统一数据根:
331
366
  | 安装方式 | 卸载方式 |
332
367
  | --- | --- |
333
368
  | Windows Workbench 安装器 | Windows“设置 -> 应用 -> 已安装的应用” |
334
- | Windows `packaging/install.ps1` | `powershell -File packaging/uninstall.ps1` |
335
- | macOS PKG | `sudo /usr/local/lib/aisc/uninstall.sh` |
336
- | Linux/macOS `packaging/install.sh` | `bash packaging/uninstall.sh` |
369
+ | 历史 Windows `packaging/install.ps1` | `powershell -File packaging/uninstall.ps1` |
370
+ | 历史 macOS PKG | `sudo /usr/local/lib/aisc/uninstall.sh` |
371
+ | 历史 Linux/macOS `packaging/install.sh` | `bash packaging/uninstall.sh` |
337
372
  | uv tool | `uv tool uninstall aisc` |
338
373
  | pipx/pip | `pipx uninstall aisc-cli`(或 venv 内 `pip uninstall aisc-cli`);**先**跑下面的 docker 清理,pip 卸载会把工具一起带走 |
339
374
 
@@ -45,11 +45,11 @@ dependencies = [
45
45
  ]
46
46
 
47
47
  [project.urls]
48
- Homepage = "https://github.com/wangyuncepu/AISC"
49
- Source = "https://github.com/wangyuncepu/AISC"
50
- Releases = "https://github.com/wangyuncepu/AISC/releases"
51
- "Bug Tracker" = "https://github.com/wangyuncepu/AISC/issues"
52
- Security = "https://github.com/wangyuncepu/AISC/security/advisories/new"
48
+ Homepage = "https://github.com/Wifabric/AISC"
49
+ Source = "https://github.com/Wifabric/AISC"
50
+ Releases = "https://github.com/Wifabric/AISC/releases"
51
+ "Bug Tracker" = "https://github.com/Wifabric/AISC/issues"
52
+ Security = "https://github.com/Wifabric/AISC/security/advisories/new"
53
53
 
54
54
  [project.scripts]
55
55
  aisc = "aisc.cli.main:main"
@@ -75,6 +75,7 @@ include = ["aisc", "aisc.*"]
75
75
  # site-packages; --user installs missed it, the probe needed a fallback).
76
76
  [tool.setuptools.package-data]
77
77
  aisc = ["VERSION"]
78
+ "aisc._topic_skill" = ["SKILL.md", "agents/*.yaml", "assets/*.md", "references/*.md", "scripts/workshop.py"]
78
79
 
79
80
  [tool.setuptools.dynamic]
80
81
  # A2: file-based dynamic version — building must not import the package
@@ -0,0 +1 @@
1
+ 0.3.0