@@ -102,6 +102,40 @@ const USAGE = `${CLI_NAME} —— DSH 记忆插件(@modusensus/dsh-mneme)外
102102
103103/* ---------------------------------- 参数解析 ---------------------------------- */
104104
105+ // `--flag value` 形态下,「下一个词以 -- 开头就别当值」这条规则有一个致命反例:
106+ // 值本身就可能是 `--` 开头的字符串。外部 API 的 token 由
107+ // `crypto.randomBytes(24).toString("base64url")` 生成(src/api-standalone.js),
108+ // base64url 的字母表含 `-`,所以约 1/4096 的 token 头两位恰好都是 `-`:
109+ //
110+ // dsh-mneme reclaim --url http://127.0.0.1:55423 --token --UYoOHxr6PtE2-bfqW...
111+ //
112+ // 旧规则把 `--UYoOHxr6PtE2-bfqW...` 当成一个新旗标(键名 `uyoohxr6pte2-bfqw...`),
113+ // 于是 token 解析成 `true`,flagValue 视作「没给」→ 退回环境变量/配置文件 → 全空
114+ // → 报「未配置访问 token」。而 CLI 生成 token 的另一半同样会撞:`--token=--abc`
115+ // 走等号分支没事,`--token --abc` 就废。这不是测试的随机性,是真实用户的随机性。
116+ //
117+ // 修法:区分「已知旗标」与「未知词」。下一个词以 `--` 开头时,只有它确实是一个
118+ // 已注册的旗标才当作旗标,否则当作当前 flag 的值。于是 `--limit --json` 仍按
119+ // 旧语义把 --json 当旗标,而 `--token --UYo...` 正确取到 token。
120+ // 已知旗标表必须与下面 flagValue/flagBool 的实际用法保持同步;漏登记的代价是
121+ // 该旗标被当成值吞掉,所以 test/cli-flag-value.test.js 用文本锁对齐两者。
122+ const KNOWN_FLAGS = new Set ( [
123+ // 取值的旗标
124+ 'url' , 'token' , 'type' , 'title' , 'content' , 'importance' , 'tags' , 'source' ,
125+ 'limit' , 'offset' , 'mode' , 'topk' , 'top-k' , 'min-importance' , 'minimportance' ,
126+ 'older-than' , 'olderthandays' ,
127+ // 布尔旗标
128+ 'apply' , 'vacuum' , 'json' , 'help' , 'version'
129+ ] ) ;
130+
131+ /** `--foo=bar` / `--foo` 取出小写键名;非旗标词返回 null。 */
132+ function flagKeyOf ( word ) {
133+ if ( typeof word !== 'string' || ! word . startsWith ( '--' ) || word === '--' ) return null ;
134+ const key = word . slice ( 2 ) ;
135+ const eq = key . indexOf ( '=' ) ;
136+ return ( eq >= 0 ? key . slice ( 0 , eq ) : key ) . toLowerCase ( ) ;
137+ }
138+
105139function parseArgv ( argv ) {
106140 const positionals = [ ] ;
107141 const flags = { } ;
@@ -118,10 +152,14 @@ function parseArgv(argv) {
118152 if ( eq >= 0 ) {
119153 value = key . slice ( eq + 1 ) ;
120154 key = key . slice ( 0 , eq ) ;
121- } else if ( i + 1 < argv . length && ! argv [ i + 1 ] . startsWith ( '--' ) && argv [ i + 1 ] !== '--' ) {
122- value = argv [ ++ i ] ;
123155 } else {
124- value = true ;
156+ const next = argv [ i + 1 ] ;
157+ const nextIsFlag = next !== undefined && flagKeyOf ( next ) !== null && KNOWN_FLAGS . has ( flagKeyOf ( next ) ) ;
158+ if ( next !== undefined && next !== '--' && ! nextIsFlag ) {
159+ value = argv [ ++ i ] ;
160+ } else {
161+ value = true ;
162+ }
125163 }
126164 flags [ key . toLowerCase ( ) ] = value ;
127165 } else {
@@ -691,7 +729,23 @@ async function main(argv) {
691729 }
692730}
693731
694- main ( process . argv . slice ( 2 ) ) . catch ( ( err ) => {
695- console . error ( err ?. stack ?? String ( err ) ) ;
696- process . exit ( 1 ) ;
697- } ) ;
732+ // 直接运行才进 main(import 只取 parseArgv 做单测时必须安静):npm 全局安装走
733+ // node_modules/.bin 的符号链接,argv[1] 是链接路径而非真身,所以要 realpath 两侧
734+ // 再比,不能用字符串相等。
735+ const invokedDirectly = ( ( ) => {
736+ if ( process . argv [ 1 ] == null ) return false ;
737+ try {
738+ return fs . realpathSync ( process . argv [ 1 ] ) === fs . realpathSync ( fileURLToPath ( import . meta. url ) ) ;
739+ } catch {
740+ return false ;
741+ }
742+ } ) ( ) ;
743+
744+ if ( invokedDirectly ) {
745+ main ( process . argv . slice ( 2 ) ) . catch ( ( err ) => {
746+ console . error ( err ?. stack ?? String ( err ) ) ;
747+ process . exit ( 1 ) ;
748+ } ) ;
749+ }
750+
751+ export { parseArgv , KNOWN_FLAGS , flagValue , flagBool , flagKeyOf } ;
0 commit comments