dsh-at-fileA77
@omdsh-devDSH 입력창에서 @를 입력하면 현재 워크스페이스를 검색해 파일이나 디렉터리 경로를 삽입한다. 플러그인은 경로만 전달하고 내용은 읽지 않으며, 열지 여부는 agent가 정한다.
dsh plugin --profile web add github:omdsh-dev/dsh-at-file
작성자가 npm에 배포하지 않아 이 명령은 git 소스를 받아옵니다. pnpm ≥ 10은 명시적 허용 전까지 git 의존성의 prepare 스크립트 실행을 거부하므로, 첫 설치에는 해당 profile의 pnpm-workspace.yaml에 allowBuilds 항목이 필요합니다——이는 이 패키지의 코드가 내 컴퓨터에서 실행되도록 허용한다는 뜻입니다. 함께 #commit으로 버전을 고정하길 권합니다.
--profile 뒤는 직접 정하는 profile 이름입니다. 쓰고 있는 이름으로 바꾸세요.
입력창에서 @를 치면 선택기가 열리고, 검색된 파일 또는 디렉터리 경로가 초안에 바로 들어갑니다. 선택한 경로는 참조 바에 남아 열거나 제거할 수 있습니다. 핵심 설계 결정은 0.3.0에서 들어왔습니다: agent가 다음 단계를 시작하기 전에 그 경로가 현재 워크스페이스 안에 실제로 존재하는지 확인한 뒤, 짧은 참조 메시지(워크스페이스 상대 경로와 종류를 담은 workspace-reference)만 덧붙입니다. 참조된 파일을 열지도, 참조된 디렉터리의 내용을 나열하지도 않습니다——볼지 말지, 어떤 도구로 볼지는 작업에 따라 agent가 결정합니다. 따라서 파일 형식과 크기는 이 경로에 영향을 주지 않으며, PDF도 다른 워크스페이스 파일과 똑같은 경로 참조 흐름을 탑니다. 제출 시점에 내용을 읽고 크기 제한을 두던 것은 초기 릴리스뿐입니다.
- ▸내용이 아니라 경로를 전달: 0.3.0부터 workspace-reference 메시지를 덧붙이고 읽을지는 agent가 판단
- ▸그래서 형식과 크기가 무관 — PDF도 다른 파일과 같은 흐름
- ▸정확한 이름·접두사·압축 일치를 상위로, / 가 들어간 질의는 경로 세그먼트 순으로 일치. → 키로 디렉터리 진입, 기본 색인은 VCS·IDE 메타데이터·의존성 트리·캐시·빌드 산출물 제외
Codex 风格 @ 文件引用,行为边界写得清楚(只传路径不读内容),工程干净
README에 붙여 넣으면 이 페이지로 연결됩니다.
