Dropstone Docs

விரைவு தொடக்கம்

Dropstone ஐ நிறுவி, உள்நுழைந்து, ஐந்து நிமிடங்களுக்குள் உங்கள் முதல் மாற்றத்தை வெளியிடுங்கள். இந்த வழிகாட்டி உங்களை பூஜ்ஜியத்திலிருந்து ஒரு செயல்படும் ஏஜென்ட லூப்பிற்கு கொண்டு செல்கிறது.

இந்த வழிகாட்டியின் முடிவில் Dropstone நிறுவப்பட்டு, உள்நுழைந்து, உங்கள் தேர்வின் ஒரு திட்டத்தில் உண்மையான திருத்தங்களை உற்பத்தி செய்யும்.

தொடங்குவதற்கு முன்

உங்களுக்கு தேவை:

  • ஒரு டெர்மினல் அல்லது கட்டளை உத்தரவு
  • Dropstone ஐ சுட்டிக்காட்ட வேண்டிய ஒரு திட்டம் (எந்த மொழி, எந்த அளவு)
  • ஒரு Dropstone கணக்கு, இதை dropstone.io இல் உருவாக்கலாம்

படி 1: Dropstone ஐ நிறுவுங்கள்

உங்கள் தளத்திற்கான நிறுவல் பாதையைத் தேர்ந்தெடுக்கவும்.

Homebrew (பரிந்துரைக்கப்பட்டது):

brew tap blankline-org/dropstone-cli
brew install dropstone

அல்லது நிறுவல் ஸ்கிரிப்ட்:

curl -fsSL https://dropstone.io/install | bash

இரண்டு முறைகளும் உங்கள் PATH இல் ஒரு dropstone பைனரி நிறுவுகின்றன. Node இல்லை, ரன்டைம் சார்பு இல்லை.

நிறுவலை சரிபார்க்கவும்:

dropstone --version

நீங்கள் ஒரு பதிப்பு எண் பார்க்க வேண்டும் (தற்போதைய வெளியீடு 1.0.8). பைனரி பின்னணியில் தன்னைத்தானே புதுப்பிக்கிறது, எனவே நீங்கள் நிறுவலை மீண்டும் இயக்காமல் தற்போதைய நிலையில் இருக்கிறீர்கள்.

படி 2: உள்நுழையவும்

எந்த திட்ட கோப்பகத்திற்கும் நகர்ந்து Dropstone ஐ தொடங்கவும்:

cd /path/to/your/project
dropstone

முதல் இயக்கத்தில் நீங்கள் உள்நுழைய கேட்கப்படுவீர்கள். இரண்டு விருப்பங்கள்:

  1. உலாவியில் தொடரவும் (பரிந்துரைக்கப்பட்டது). dropstone.io/login ஐ திறக்கிறது, உங்களை உள்நுழைக்கிறது, மற்றும் டோக்கனை CLI க்கு தானாக திருப்பி கொடுக்கிறது. PKCE ஐ பயன்படுத்துகிறது எனவே டோக்கன் உங்கள் உலாவி URL பட்டையில் தோன்றாது.
  2. ஒரு டோக்கனை ஒட்டவும். SSH அல்லது headless அமர்வுகளுக்கு. dropstone.io/account இல் ஒரு டோக்கன் பெறுங்கள் மற்றும் அதை ஒட்டவும்.

முதல் உள்நுழைவுக்குப் பிறகு உங்கள் நற்சான்றுகள் வட்டில் சேமிக்கப்படுகின்றன. பின்னர் கணக்குகளை மாற்ற, Dropstone க்குள் /login ஐ இயக்கவும்.

படி 3: உங்கள் முதல் அமர்வைத் தொடங்கவும்

நீங்கள் இப்போது Dropstone முகப்பு திரையைப் பார்க்கிறீர்கள். மூன்று விஷயங்களைக் கவனிக்க வேண்டும்:

  • உங்கள் தற்போதைய மாதிரி அடுக்கு மேல் வலதுபுறத்தில் காட்டப்பட்டுள்ளது (இயல்பு: Dropstone Fast)
  • கீழே உள்ள உள்ளீட்டு பெட்டி என்பது நீங்கள் தட்டச்சு செய்யும் இடம்
  • ஸ்ল்যாஷ் கட்டளைகள் / உடன் தொடங்குகின்றன. அவை அனைத்தைக் காண /help ஐ시도் செய்யவும்

எந்த இயற்கை-மொழி உத்தரவையும் தட்டச்சு செய்து ஒரு அமர்வைத் தொடங்கவும். கற்க வேண்டிய சிறப்பு தொடரியல் இல்லை.

படி 4: உங்கள் முதல் கேள்வியைக் கேளுங்கள்

Dropstone திட்டத்தை உங்களுக்கு சுற்றிக் காட்ட விடுங்கள். இவற்றில் ஒன்றை முயற்சி செய்யவும்:

what does this project do?
what are the main entry points?
explain the folder structure

Dropstone தேவைக்கேற்ப கோப்புகளைப் படித்து உண்மையான குறியீட்டிற்கான மேற்கோள்களுடன் பதிலளிக்கும். நீங்கள் கோப்புகளை ஒட்ட அல்லது சூழல்களை கைமுறையாக எழுத வேண்டிய இல்லை.

நீங்கள் Dropstone பற்றி Dropstone ஐ கேட்கலாம்:

what can you do in this project?
what commands have you been given permission to run?

படி 5: உங்கள் முதல் குறியீடு மாற்றத்தை செய்யவும்

இப்போது ஒரு சிறிய மாற்றத்தை விவரிக்கவும். ஒரு புதிய திட்டத்திற்கு, குறைந்த ஆபத்தை முயற்சி செய்யவும்:

add a README with a one-paragraph project description

ஒரு বিদ்யமான திட்டத்திற்கு:

add input validation to the function that creates a user

Dropstone இருக்கும்:

  1. தொடர்புடைய கோப்பைக் கண்டுபிடிக்கவும்
  2. முன்மொழிந்த மாற்றத்தை ஒரு diff ஆக காட்டவும்
  3. எழுதுவதற்கு முன் உங்கள் ஒப்புதலைக் கேளுங்கள்
  4. முடிவை சரிபார்க்கவும் (வகை சரிபார்ப்புகள், சோதனைகள், கட்டளைகள் கிடைத்தால்)

அனுமதிகள்:

Dropstone முதல் முறையாக ஒரு கோப்பை திருத்த அல்லது ஒரு ஷெல் கட்டளையை இயக்க விரும்பும்போது ஒப்புதலைக் கேட்கிறது. ஒரு முறை ஒப்புதல் கொடுங்கள், மற்றும் அதே அமர்வில் அதே செயல்பாடு மீண்டும் கேட்காமல் இயங்குகிறது. /permissions ஐ பயன்படுத்தி நீங்கள் அனுமதித்த விஷயங்களைக் காணவும் அல்லது ரத்து செய்யவும்.

படி 6: git உடன் வேலை செய்யவும்

Dropstone git ஐ முதல் வகுப்பு கருவியாக கருதுகிறது:

what files have I changed?
commit my changes with a descriptive message
create a branch called feature/health-endpoint and switch to it
show the last five commits
help me resolve the merge conflict in src/auth.ts

PR-நிலை பணிப்பாய்வுகளுக்கு (pull requests திறக்கிறது, PR விளக்கங்களை உருவாக்குகிறது, மதிப்பாய்வு கருத்துக்களை இடுகிறது), GitHub integration ஐ பார்க்கவும்.

படி 7: ஒரு பிழையை சரிசெய்யவும் அல்லது ஒரு அம்சத்தைச் சேர்க்கவும்

நீங்கள் விரும்பும் விஷயத்தை சாதாரண மொழியில் விவரிக்கவும். Dropstone குறியீட்டைக் கண்டுபிடிக்கும், சூழலைப் புரிந்துகொள்ளும், மாற்றத்தை செயல்படுத்தும், மற்றும் அதை சரிபார்க்கும்.

there is a bug where empty search queries return all results - fix it
add a /healthz endpoint to the API server that returns build info
the login form crashes when the email is missing - figure out why and fix it

பணி பல கோப்புகளை பரவினால், Dropstone ஒரு சிறிய திட்டத்தை எழுதி அதை படிப்படியாக செயல்படுத்தும். நீங்கள் எந்த நேரத்திலும் Esc ஐ அழுத்தி குறுக்கிட்டு திசை மாற்றலாம்.

படி 8: பிற பொதுவான பணிப்பாய்வுகளை முயற்சி செய்யவும்

Dropstone நன்றாக இருக்கும் சில முறைகள்:

மறுசீரமைப்பு

refactor the auth module to use async/await instead of callbacks

சோதனைகளை எழுதவும்

write unit tests for the calculator functions

குறியீடு மதிப்பாய்வு

review my staged changes and flag anything risky

ஆவணப்படுத்தல்

update the README install instructions to include the WSL path

குறிப்பு:

Dropstone உடன் ஒரு சக வேலை செய்பவர் போல் பேசவும். நீங்கள் அங்கு செல்ல விரும்பும் விஷயத்தை விவரிக்கவும், சரியான படிகளை விவரிக்க வேண்டாம். ஏஜென்ட செயல்பாட்டு தேர்வுகளை அதற்கு விட்டுவிடும்போது திட்டமிடுவதில் சிறந்தது.

அத்தியாவசிய கட்டளைகள்

நீங்கள் உண்மையில் பயன்படுத்தும் கட்டளைகளின் சிலவற்றை:

கட்டளைஇது என்ன செய்கிறதுஉதாரணம்
dropstoneதற்போதைய கோப்பகத்தில் ஒரு ஊடாடும் அமர்வைத் தொடங்கவும்dropstone
dropstone run "task"ஒரு ஒரு-முறை பணியை இயக்கி வெளியேறவும்dropstone run "explain auth.ts"
dropstone -cஇந்த கோப்பகத்தில் கடைசி அமர்வைத் தொடரவும்dropstone -c
dropstone --session IDID மூலம் ஒரு குறிப்பிட்ட அமர்வை மீண்டும் தொடங்கவும்dropstone --session 7f3a...
/helpஅனைத்து ஸ்ல்யாஷ் கட்டளைகளைக் காட்டவும்ஒரு அமர்வுக்குள்
/effortஇந்த அமர்வுக்கான மாதிரி அடுக்கை மாற்றவும்/effort high
/clearதற்போதைய உரையாடலை அழிக்கவும்ஒரு அமர்வுக்குள்
/loginகணக்குகளை மாற்றவும்ஒரு அமர்வுக்குள்
exit அல்லது Ctrl+DDropstone ஐ வெளியேறவும்

முழு குறிப்பு CLI மற்றும் ஸ்ல்யாஷ் கட்டளைகள் பக்கங்களில் உள்ளது.

புதிய பயனர்களுக்கான Pro குறிப்புகள்

அடுத்து என்ன

CLI குறிப்பு
ஒவ்வொரு flag, ஒவ்வொரு subcommand, ஒவ்வொரு விருப்பம். நீங்கள் புத்தகக்குறி செய்யும் பக்கம்.
ஸ்ல்யாஷ் கட்டளைகள்
ஒரு இடத்தில் ஒவ்வொரு ஸ்ல்யாஷ் கட்டளை. ஒரு வாரத்தின் பயன்பாட்டிற்குப் பிறகு கைக்குள் வருகிறது.
Dropstone ஐ உங்கள் repo ஐ கற்பிக்கவும் (AGENTS.md)
repo root இல் ஒரு கோப்பை வைக்கவும் இது Dropstone ஐ உங்கள் மரபுகள், build கட்டளைகள், மற்றும் gotchas ஐ சொல்கிறது.
உங்கள் சொந்த கருவிகளை இணைக்கவும் (MCP)
தரவுத்தளங்கள், உள் APIs, ticketing systems, அல்லது Model Context Protocol பேசும் எதையும் வயர் செய்யவும்.
மாதிரிகள் & வழங்குநர்கள்
Fast 1.5, Pro 1.5, மற்றும் Heavy 1.5 பற்றி மேலும், மற்றும் உங்கள் config இல் ஒரு இயல்பை எவ்வாறு அமைப்பது.
அனுமதிகள்
Dropstone உங்கள் திட்டங்களில் என்ன படிக்க, எழுத, மற்றும் செயல்படுத்த முடியும் என்பதை சரியாக கட்டுப்படுத்தவும்.

உதவி பெறுதல்

  • Dropstone க்குள், /help ஐ தட்டச்சு செய்யவும் அல்லது சாதா
Ctrl+I