autocoder-nano 0.1.6__tar.gz

autocoder_nano-0.1.6/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

autocoder_nano-0.1.6/PKG-INFO

@@ -0,0 +1,422 @@
+Metadata-Version: 2.2
+Name: autocoder_nano
+Version: 0.1.6
+Summary: AutoCoder Nano
+Author: moofs
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: loguru
+Requires-Dist: tabulate
+Requires-Dist: GitPython
+Requires-Dist: jinja2
+Requires-Dist: openai>=1.14.3
+Requires-Dist: prompt_toolkit
+Requires-Dist: pydantic
+Requires-Dist: rich
+Requires-Dist: pylint
+Requires-Dist: PyYAML
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# autocoder-nano
+
+AutoCoder 社区是一个致力于简化开发者代码开发流程，提升开发效率的社区，开发有 auto-coder.chat (lite/pro), byzerllm 等项目，
+autocoder-nano 是 AutoCoder 社区的全新成员，基于 auto-coder.chat 功能简化，可以理解成 auto-coder.chat 的轻量级版本。
+
+#### nano/lite/pro 有什么区别？
+
+- Pro：分布式架构，支持分布式部署模型，支持开源/SaaS模型管理，独特的 `human_as_model` 模式，RAG 支持，Design 设计支持，MCP支持，联网搜索支持，全局记忆支持，适合深度使用各种大模型的用户。
+- Lite：放弃分布式架构，部分功能无法使用，主要针对 Windows 用户（第三方库兼容问题），以及需要快速启动并使用 auto-coder.chat 的用户。
+- Nano：同样放弃分布式架构，为 auto-coder.chat 的移植版本，支持 `/chat`，`/coding`， `/文件管理`，`/索引管理` 等功能，依赖及代码极致精简，适合想要了解大模型辅助编程原理，以及想要实现自己辅助编程框架的用户
+
+#### 为何选择 autocoder-nano？
+
+- 轻量高效：无需复杂部署，极致精简，即装即用，使用 auto-coder 前可以先通过 autocoder-nano 熟悉相关功能。
+- 灵活扩展：第三方依赖及代码精简，非常适合学习及魔改，同时兼容主流大模型，开发者可定制私有化模型链路。
+- 场景全覆盖：从代码生成到运维脚本，一站式解决开发需求。
+- 开源友好：持续迭代中，欢迎贡献代码与反馈！
+
+#### autocoder-nano 的迭代方向
+
+- 代码结构优化，便于后续维护及其他开发者魔改
+- 并发支持，开发更大的项目
+- 多语言优化，深度优化 Python 外的其他语言
+- 候选模型支持，首选模型异常时进行切换
+- RAG能力，支持一个简化的知识库，增强代码能力
+
+---
+
+## 核心功能
+
+#### 配置即服务
+
+- 开箱即用：项目初始化向导引导配置，5 分钟即可上手。
+- 动态配置：通过 `/conf` 命令实时调整项目类型，模型选择，索引策略等参数。
+
+#### 智能代码生成
+
+- 精准控制：通过 `/coding` 命令结合 `@文件` 或 `@@符号`，实现函数级代码生成与修改。
+- 多语言支持：原生支持 Python、TypeScript/JavaScript 等语言，灵活适配混合语言项目。
+- 历史上下文：使用 `/coding /apply` 将对话历史融入代码生成，确保逻辑连贯性。
+
+#### 大模型交互与配置
+
+- 灵活模型管理：支持 OpenAI 格式的模型接入，一键添加、删除、检测模型状态。
+- 双模型策略：独立配置对话/索引模型（current_chat_model）与代码生成模型（current_code_model），满足不同场景需求。
+
+#### 智能文件管理
+
+- 自动/手动模式：支持自动索引构建或手动管理活动文件。
+- 文件组管理：通过分组快速切换上下文，提升多模块协作效率，轻松实现前后端配合开发。
+
+#### 自然语言编程
+
+- 指令即代码：直接输入自然语言，自动生成并执行 Shell/Python 脚本。
+- 模式切换：快捷键 Ctrl+K 快速进入自然语言模式，无缝衔接开发与运维任务。
+
+---
+
+## 使用场景
+
+1. 代码维护：快速理解项目结构，生成函数级注释或单元测试。
+2. 效率提升：通过自然语言指令完成文件清理、批量重命名等重复任务。
+3. 混合开发：管理多语言项目，智能分析文件依赖关系。
+4. 模型实验：灵活切换不同大模型，对比生成效果，找到最优配置。
+
+---
+
+* [安装](#安装)
+* [快速开始](#快速开始)
+* [模型管理](#模型管理)
+* [配置管理](#配置管理)
+* [文件管理](#文件管理)
+* [索引管理](#索引管理)
+* [Chat和Coding](#Chat和Coding)
+* [自然语言模式](#自然语言模式)
+
+---
+
+## 安装
+
+```shell
+$ conda create --name autocoder python=3.11.9
+$ conda activate autocoder
+$ pip install -U autocoder_nano
+```
+
+## 快速开始
+
+```shell
+$ cd your-project
+$ auto-coder.nano
+```
+
+#### step 1: 项目初始化
+
+```
+! 正在初始化系统...
+! 当前目录未初始化为auto-coder项目。
+  是否现在初始化项目？(y/n): y
+✓ 项目初始化成功。
+✓ 创建目录：/user/x/code/you-project/.auto-coder/plugins/chat-auto-coder
+```
+
+#### step 2: 配置项目语言类型
+
+```
+=== 项目类型配置 ===
+
+项目类型支持：
+  - 语言后缀（例如：.py, .java, .ts）
+  - 预定义类型：py（Python）, ts（TypeScript/JavaScript）
+对于混合语言项目，使用逗号分隔的值。
+示例：'.java,.scala' 或 '.py,.ts'
+如果留空，默认为 'py'。
+
+请输入项目类型：py
+
+项目类型设置为： py
+
+您可以稍后使用以下命令更改此设置:
+/conf project_type:<new_type>
+```
+
+#### step 3: 配置大模型
+
+```
+! 正在配置模型...
+  设置你的首选模型名称(例如: deepseek-v3/r1, ark-deepseek-v3/r1): your-user-first-llm-custom-name
+  请输入你使用模型的 Model Name: your-llm-model_name
+  请输入你使用模型的 Base URL: your-llm-base-url
+  请输入您的API密钥: your-llm-api-key
+! 正在更新缓存...
+! 正在部署 your-user-first-llm 模型...
+```
+
+#### step 4: 初始化完成, 开始与大模型交流
+
+```
+✓ 初始化完成。
+AutoCoder Nano   v0.1.5
+输入 /help 可以查看可用的命令.
+
+coding@auto-coder.nano:~$ /chat 描述一下这个项目的主要功能
+```
+
+
+## 模型管理
+
+#### 列出模型
+
+```
+coding@auto-coder.nano:~$ /models /list
+                                  模型                                                               
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ Name                         ┃ Model Name          ┃ Base URL                   ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ xxx-deepseek-v3              │ xxxxxxxxxxxx        │ https://xxxxx.com/api/v3   │
+└──────────────────────────────┴─────────────────────┴────────────────────────────┘
+```
+
+#### 新增模型
+
+兼容所有 OpenAI 格式的模型
+
+- name=deepseek-r1，为新增的模型取的一个别名，可以精简，便于后续使用
+- base_url=https://api.deepseek.com， 模型厂商提供的 saas api 接口
+- api_key=sk-xx， 访问模型所需的key
+- model=deepseek-reasoner， 模型厂商内部可能会提供多种可选的能力模型，比如 r1 / v3
+
+```
+coding@auto-coder.nano:~$ /models /add_model name=deepseek-r1 base_url=https://api.deepseek.com api_key=sk-xx model=deepseek-reasoner
+2025-02-11 10:11:22.124 | INFO     | autocoder_nano.auto_coder_nano:manage_models:3788 - 正在为 deepseek-r1 更新缓存信息
+2025-02-11 10:11:22.125 | INFO     | autocoder_nano.auto_coder_nano:manage_models:3797 - 正在部署 deepseek-r1 模型
+coding@auto-coder.nano:~$ /models /list
+                                  模型                                                               
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ Name                         ┃ Model Name          ┃ Base URL                   ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ xxx-deepseek-v3              │ xxxxxxxxxxxx        │ https://xxxxx.com/api/v3   │
+├──────────────────────────────┼─────────────────────┼────────────────────────────┤
+│ deepseek-r1                  │ deepseek-reasoner   │ https://api.deepseek.com   │
+└──────────────────────────────┴─────────────────────┴────────────────────────────┘
+```
+
+#### 删除模型
+
+```
+coding@auto-coder.nano:~$ /models /remove deepseek-r1
+2025-02-11 10:17:59.930 | INFO     | autocoder_nano.auto_coder_nano:manage_models:3801 - 正在清理 deepseek-r1 缓存信息
+2025-02-11 10:17:59.930 | INFO     | autocoder_nano.auto_coder_nano:manage_models:3804 - 正在卸载 deepseek-r1 模型
+```
+
+#### 模型状态检测
+
+```
+coding@auto-coder.nano:~$ /models /check
+2025-02-11 10:19:23.494 | INFO     | autocoder_nano.auto_coder_nano:check_models:3757 - 正在测试 xxx-deepseek-v3 模型
+2025-02-11 10:19:23.495 | INFO     | autocoder_nano.auto_coder_nano:stream_chat_ai:1037 - 正在使用 xxx-deepseek-v3 模型, 模型名称 xxxxxxxxxxxx
+           模型状态检测           
+┏━━━━━━━━━━━━━━━━━┳━━━━━━┳━━━━━━━┓
+┃ 模型             ┃ 状态  ┃  延迟 ┃
+┡━━━━━━━━━━━━━━━━━╇━━━━━━╇━━━━━━━┩
+│ xxx-deepseek-v3 │  ✓   │ 1.36s │
+└─────────────────┴──────┴───────┘
+```
+
+## 配置管理
+
+#### 列出配置
+
+```
+coding@auto-coder.nano:~$ /conf
+             使用 /conf <key>:<value> 修改这些设置                                              
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃                            键 ┃ 值                            ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│                    auto_merge │ editblock                    │
+├───────────────────────────────┼──────────────────────────────┤
+│            current_chat_model │ xxx-deepseek-v3              │
+├───────────────────────────────┼──────────────────────────────┤
+│            current_code_model │ xxx-deepseek-v3              │
+├───────────────────────────────┼──────────────────────────────┤
+│                  project_type │ py                           │
+├───────────────────────────────┼──────────────────────────────┤
+│              skip_build_index │ false                        │
+└───────────────────────────────┴──────────────────────────────┘
+```
+
+#### 更改配置
+
+```
+coding@auto-coder.nano:~$ /conf skip_filter_index:false
+Set skip_filter_index to false
+coding@auto-coder.nano:~$ /conf index_filter_level:2
+Set index_filter_level to 2
+```
+
+#### 配置当前使用模型
+
+当你新增某个模型后，想要进行替换使用，假设你的模型别名为 _t-deepseek-r1_ ， 使用以下命令进行模型配置更改：
+
+```shell
+coding@auto-coder.nano:~$ /conf current_chat_model:t-deepseek-r1
+Set current_chat_model to t-deepseek-r1
+coding@auto-coder.nano:~$ /conf current_code_model:t-deepseek-r1
+Set current_code_model to t-deepseek-r1
+```
+
+- current_chat_model ：配置与大模型聊天以及索引生成所使用的模型
+- current_code_model ：配置代码生成使用的模型
+
+
+## 文件管理
+
+Auto-coder 里有两种方式管理你的项目上下文：
+
+1. 设置 `/conf skip_index_build:false` 后，系统会自动根据你的需求自动查找相关文件。即自动管理模式。
+2. 当你设置 `/conf skip_index_build:true` 后，则通过活动文件来管理，我们提供了 `/add_files /remove_files /list_files` 来组合。即手动管理模式。
+
+Auto-coder 文件组概念：
+
+1. Auto-coder 系列提供了一个活动文件组的概念。 你可以通过 `/add_files /group /add app`  来添加一个叫 app的组，这个组会复制当前的所有活动文件。
+2. 通过手动切换文件组来完成上下文的管理，是手动管理文件的高级方法
+
+
+#### /list_files 命令
+
+```shell
+# 列出当前活跃文件
+coding@auto-coder.nano:~$ /list_files
+```
+
+#### /add_files 命令
+
+```shell
+# 添加单个/多个文件为活跃文件
+coding@auto-coder.nano:~$ /add_files file1 file2 file3
+coding@auto-coder.nano:~$ /add_files /path/abc/file4 /path/abc/file5
+
+# 查看当前所有的文件组
+coding@auto-coder.nano:~$ /add_files /group
+
+# 将当前活跃文件添加进 app 文件组
+coding@auto-coder.nano:~$ /add_files /group /add app
+
+# 设置活跃文件组
+coding@auto-coder.nano:~$ /add_files /group app
+
+# 删除文件组
+coding@auto-coder.nano:~$ /add_files /group /drop app
+
+# 合并两个文件组的文件为当前活跃文件
+coding@auto-coder.nano:~$ /add_files /group <groupname>,<groupname>
+
+# 当目录中新增一个文件后，自动补全无法获取该文件，可执行一次刷新
+coding@auto-coder.nano:~$ /add_files /refresh
+```
+
+- `/add_files` 支持文件匹配符，比如可以通过 `/add_files ./**/*.py` 把当前目录下所有的python文件加到活动文件里去(如果你项目很大，不能这么做，会超出大模型上线文限制)。
+
+
+#### /remove_files 命令
+
+```shell
+# 将 file1 移出当前活跃文件
+coding@auto-coder.nano:~$ /remove_files file1
+
+# 清空当前所有活跃文件
+coding@auto-coder.nano:~$ /remove_files /all
+```
+
+
+## 索引管理
+
+
+## Chat和Coding
+
+Chat与大模型沟通
+
+- 当你设置了活跃文件和 `/conf skip_index_build:true` ， `/chat` 可以方便的针对当前活跃文件进行提问
+- 当你设置了 `/conf skip_index_build:false` ， `/chat` 会根据所有代码文件来回答问题
+
+```shell
+coding@auto-coder.nano:~$ /add_files ./**/*.py
+
+coding@auto-coder.nano:~$ /list_files
+
+coding@auto-coder.nano:~$ /chat 请问这些文件之间的关系是什么
+coding@auto-coder.nano:~$ /chat 给我描述一下这个项目的用途
+```
+
+
+Coding使用大模型进行编码
+
+- `/coding` 可以根据需求，对当前活跃文件，或者自行匹配候选文件，进行修改
+- `/coding /apply` 此时 Autocoder 会把我们与大模型之间的历史对话记录加入到代码生成的 Prompt 里
+
+```shell
+coding@auto-coder.nano:~$ /coding /apply 新增一个命令行参数 --chat_model
+```
+
+#### 精准控制代码生成
+
+Autocoder 提供了两个机制：
+1. 使用 `@` 自动补全文件
+2. 使用 `@@` 自动补全符号（类或者函数）
+
+在 `/coding` 或者 `/chat` 的时候，用户可以通过上述两个语法快速定位到某个文件，类或者函数，然后最小粒度是函数级别，
+让 Autocoder 帮你做修改。比如你 @@函数A， 然后让大模型自动实现该函数或者让大模型给该函数生成测试
+
+
+## 自然语言模式
+
+场景：实际编程的过程中，程序员会大量使用命令行来完成一些工作
+
+- 比如启动一个服务，发现服务端口被占用，这个时候你可能想查看这个端口到底被哪个其他服务占用
+- 想要对目录中的 .jpg 文件进行批量改名
+- 再或者突然忘记某个命令的参数
+
+切换自然语言模式
+
+使用 Ctrl + k 快捷键，或者以下方式可切换模式
+
+```shell
+coding@auto-coder.nano:~$ /mode auto_detect
+```
+
+放终端最下方显示 `当前模式: 自然语言模式 (ctl+k 切换模式)` 即切换成功
+
+```
+coding@auto-coder.nano:~$ 递归删除当前项目所有 __pycache__ 目录
+╭────────────────────────────────────────────────────────── 命令生成 ─────────╮
+│ 正在根据用户输入 递归删除当前项目所有 __pycache__ 目录 生成 Shell 脚本...          │
+╰────────────────────────────────────────────────────────────────────────────╯
+2025-02-11 15:02:31.305 | INFO     | autocoder_nano.auto_coder_nano:chat_ai:1057 - 正在使用 ark-deepseek-v3 模型, 模型名称 ep-20250205104003-d8hqb
+╭───────────────────────────────────────────────────────── Shell 脚本 ──────────────────────╮
+│ #!/bin/bash                                                                              │
+│                                                                                          │
+│ # 递归删除当前项目所有 __pycache__ 目录的脚本                                                 │
+│                                                                                          │
+│ # 使用 find 命令查找当前目录及其子目录中的所有 __pycache__ 目录                                  │
+│ # -type d: 只查找目录                                                                      │
+│ # -name "__pycache__": 匹配名为 __pycache__ 的目录                                          │
+│ # -exec rm -rf {} +: 对找到的每个目录执行 rm -rf 命令，递归删除目录及其内容                      │
+│ # 使用 {} + 而不是 {} \; 是为了将多个结果一次性传递给 rm 命令，提高效率                           │
+│                                                                                          │
+│ find . -type d -name "__pycache__" -exec rm -rf {} +                                      │
+│                                                                                          │
+│ # 提示用户操作完成                                                                          │
+│ echo "所有 __pycache__ 目录已成功删除。"                                                     │
+╰───────────────────────────────────────────────────────────────────────────────────────────╯
+是否要执行此脚本? (y/n) n
+```